AstroUtilitiesAlmanac Method
Create a one year almanac for the given event, year and location.
Namespace: ASCOM.ToolsAssembly: ASCOM.AstrometryTools (in ASCOM.AstrometryTools.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea
public static void Almanac(
EventType typeOfEvent,
int year,
double siteLatitude,
double siteLongitude,
double siteTimeZone,
ILogger almanacLogger
)
Public Shared Sub Almanac (
typeOfEvent As EventType,
year As Integer,
siteLatitude As Double,
siteLongitude As Double,
siteTimeZone As Double,
almanacLogger As ILogger
)
Parameters
- typeOfEvent EventType
- The rise-set or twilight times event that the almanac will describe.
- year Int32
- Year of the almanac.
- siteLatitude Double
- Latitude of the site for which the almanac is required (-90.0 to +90.0). North positive, south negative.
- siteLongitude Double
- Longitude of the site for which the almanac is required (-180.0 to +180.0 ). East positive, west negative
- siteTimeZone Double
- Time zone of the site for which the almanac is required (-12.0 to +14.0). East positive, west negative
- almanacLogger ILogger
- An ILogger component to which the almanac will be written.
At latitudes greater than 60N or 60S it is possible for there to be two rises or sets in a given 24 hour day,
hence results are aggregated into two EventTime lines. If, for a given day, all months have only 0 or 1 event
only the first event times line is included. If any day has two events then the second event times line
is included with the same day number as the first event times line.
The following symbols are used in the almanac:
- **** - Visible at all times - risen all day.
- ---- - Never visible - set all day.
- //// - Lighter than the twilight threshold all day long.
- ==== - Darker than the twilight threshold all day long.
- Blank space indicates no events on this day.
For some event types it is possible that no event of that type occurs, in which case the event time is represented
as a blank space. At times of year when no events occur, because a body is "always risen" or "always set", rise and set times
are shown as "****" and "----" respectively.
The expected output for Moon rising / setting using the parameters: Year=2012, Latitude=75N, Longitude=75W, TimeZone=-5h is given at
the end of this example.
Supported in: 2.0