solar_setting#

caput.astro.observer.Observer.solar_setting(t0, t1=None, step=None)[source]#

Find the Solar settings between two times.

This method calculates the conventional astronomical sunset, which occurs when the centre of the sun is 50 arcminutes below the horizon. This accounts for a solar diameter of 32 arcminutes, plus 34 arcminutes of atmospheric refraction at the horizon.

Parameters:
t0ctime.TimeLike

The start time to search for. Any type that be converted to a UNIX time by caput.

t1ctime.TimeLike | None, optional

The end time of the search interval. If not set, this is 1 day after the start time t0.

stepfloat | None, optional

The initial search step in days. This is used to find the approximate times of setting, and should be set to something less than the spacing between events. If None is passed, an initial search step of 0.2 days, or else one fifth of the specified interval, is used, whichever is smaller.

Returns:
unix_timesndarray

Solar setting times as UNIX epoch times.