weather-SunPosition

SunPosition provides a variety of solar calculations, and is found on the weather palette along with a similar MoonPosition component. From the palette, copy (drag and drop) the SunPosition component into any station location.

NOTE: Like the MoonPosition component, but unlike other weather components, SunPosition does not require the station host to have the WeatherService, nor to have Internet connectivity. Output calculations are mathematically derived and executed solely within the station. Usage applies to any geographic location, and not just the U.S. or North America.

Figure 28. Example SunPosition copied into station

To use, enter Longitude and Latitude values in decimal degrees (that is, both minutes and seconds in decimal format) into the SunPosition component, and Save.

NOTE: At the time of this document, an online converter for going from degrees, minutes, seconds, to decimal degrees can be found at: http://www.fcc.gov/mb/audio/bickel/DDDMMSS-decimal.html

Based on these values, along with the station’s date and time, solar calculations are available in SunPosition properties. Unlike the MoonPosition component, there is no special (iconic) view for SunPosition.

NOTE: If using the WeatherService and NwsWeatherProvider, to simplify setup, copy it under the Provider of a WeatherReport. This lets you easily copy its longitude and latitude values, or you can enter the values manually.

In addition to properties below, SunPosition has an available Recalculate action, to immediately recalculate all read-only properties.

Figure 29. SunPosition property sheet

A SunPosition component has the following properties:

Name	Value	Description
Enabled	`true` (default), `false`	`True`, by default, enables use of the component. If set to `false` (disabled), calculations stop and other properties remain unchanged.
Update Period	`00000h 01m 00s`, (default)	Interval at which ongoing calculations are made, reflected in properties below.
Longitude	degrees	Geographical longitude of target location in decimal degrees (both minutes and seconds in decimal format). NOTE: Values for latitude and longitude are useful if using a “SunPosition” component for this location—you must enter them in corresponding properties of that component.
Latitude	degrees	Geographical latitude of target location in decimal degrees (both minutes and seconds in decimal format). NOTE: An online converter for going from degrees, minutes, seconds, to decimal degrees can be found at: http://www.fcc.gov/mb/audio/bickel/DDDMMSS-decimal.html (at this document time).
Day Length	hours	Read-only. The decimal hours between sunrise and sunset.
Sunrise	date/time	Timestamp for calculated sunrise, in Baja Time format.
Sunset	date/time	Timestamp for calculated sunset, in Baja Time format.
Noon	date/time	Timestamp for calculated astronomical noon (sun at highest point for the day), in Baja Time format.
Midnight	date/time	Timestamp for calculated astronomical midnight for the current day at the specified location, at this time the sun's elevation is at it's minimum, in Baja Time format.
Max Elevation	degrees	Maximum sun elevation for the specified day, the maximum occurs at astronomical noon.
Min Elevation	degrees	Minimum sun elevation for the specified day, the minimum occurs at astronomical midnight.
Current Elevation	degrees	The angle in degrees between current position of the sun and the true horizon.
Current Azimuth	degrees	The direction of the sun in degrees relative to true north.
Current Declination	degrees	The angle between the sun and the earth's equator. The Sun has zero declination during the equinoxes while crossing the equator. At winter solstice the declination is at it's minimum of -23.5 and at the summer solstice it is at it's maximum of +23.5.
Current Right Ascension	degrees	The position of the sun along the celestial equator, with zero being at the 'first point of Aries'.