AstroUtilitiesAlmanac Method

Create a one year almanac for the given event, year and location.

Definition

Namespace: ASCOM.Tools
Assembly: ASCOM.AstrometryTools (in ASCOM.AstrometryTools.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea
C#
public static void Almanac(
	EventType typeOfEvent,
	int year,
	double siteLatitude,
	double siteLongitude,
	double siteTimeZone,
	ILogger almanacLogger
)

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.

Remarks

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.

Version Information

.NET Standard

Supported in: 2.0

See Also