nrel-spa/.github/wiki/api/functions/getSpa.md

2.3 KiB

nrel-spa v2.0.2


nrel-spa / getSpa

Function: getSpa()

Call Signature

getSpa(date, latitude, longitude, timezone?, options?): SpaResult

Defined in: index.ts:145

Compute solar position for the given parameters.

Parameters

date

Date

JavaScript Date object (uses UTC components)

latitude

number

Observer latitude in degrees (-90 to 90, negative = south)

longitude

number

Observer longitude in degrees (-180 to 180, negative = west)

timezone?

number | null

Hours from UTC (e.g., -4 for EDT). Default: 0

options?

SpaOptions | null

Optional atmospheric and calculation parameters

Returns

SpaResult

Solar position result with raw numerical values

Throws

If date, latitude, longitude, timezone, or options numeric fields are not finite numbers

Throws

If latitude, longitude, timezone, function code, or angle values are out of range

See

Wiki: getSpa

Call Signature

getSpa(date, latitude, longitude, timezone, options, angles): SpaResultWithAngles

Defined in: index.ts:163

Compute solar position and resolve custom zenith angles (e.g., twilight).

Parameters

date

Date

JavaScript Date object (uses UTC components)

latitude

number

Observer latitude in degrees (-90 to 90, negative = south)

longitude

number

Observer longitude in degrees (-180 to 180, negative = west)

timezone

number | null | undefined

Hours from UTC (e.g., -4 for EDT). Default: 0

options

SpaOptions | null | undefined

Atmospheric and calculation parameters (pass null for defaults)

angles

`number`, `...number[]`

Custom zenith angles in degrees. Common: 96 civil, 102 nautical, 108 astronomical

Returns

SpaResultWithAngles

Solar position result including an angles array