soltrack.riseset module

class soltrack.riseset.RiseSet[source]

Bases: Parameters

Class concerning the rise, transit and set times and positions of the Sun and related attributes and methods.

computeRiseSet(rs_alt=0.0, accur=1e-05, return_datetimes=True)[source]

This function is obsolescent and will be removed in a future version. Use compute_rise_set() instead.

compute_rise_set(rs_alt=0.0, accur=1e-05, return_datetimes=True)[source]

Compute rise, transit and set times for the Sun, as well as their azimuths/altitude.

Parameters:

  • rs_alt (float) – Altitude to return rise/set data for (radians; optional, default=0.0 meaning actual rise/set). Set rs_alt>pi/2 to compute transit only.

  • accur – (float): Accuracy (rad). Default: 1e-5 rad ~ 0.14s. Don’t make this smaller than 1e-16.

  • return_datetimes (bool) – Return times as datetimes rather than decimal hours. Defaults to True.

Note

  • rise/set/transit times are in the LOCAL timezone used for the input (hence UTC if UTC was used).

  • if rs_alt == 0.0, actual rise and set times are computed

  • if rs_alt != 0.0, the routine calculates when alt = rs_alt is reached

  • returns times, rise/set azimuth and transit altitude in the class riseSet

See:

  • subroutine riset() in riset.f90 from libTheSky (libthesky.sf.net) for more info

rise_azimuth: float

Rise azimuth of the Sun (radians)

rise_time: float

Rise time of the Sun (hours LT or UTC)

set_azimuth: float

Set azimuth of the Sun (radians)

set_time: float

Set time of the Sun (hours LT or UTC)

transit_altitude: float

Transit altitude of the Sun (radians)

transit_time: float

Transit time of the Sun (hours LT or UTC)