API Reference¶

class daylight.Sunclock(self: daylight.Sunclock, latitude: float, longitude: float, tz_offset: float = 0) → None ¶

Constructs a Sunclock object

Parameters

latitude (float) – latitude of the location
longitude (float) – longitude of the location
tz_offset (float) – in hours, east is positive. i.e. IST is +5.5

irradiance(self: daylight.Sunclock, datetime: numpy.ndarray[int64]) → object ¶

Calculates the irradiance level for given datetime.

This is a vectorized function.

Parameters: datetime (int or array_like) – unix timestamp (in UTC, seconds)

Examples

>>> import daylight
>>> sun = daylight.Sunclock(17.3859, 78.4867, 5.5)
>>> sun.irradiance(1590050435)
0.882753920406182
>>> sun.irradiance([1590010200, 1590024600])
array([-0.56570521,  0.28650605])

solar_noon(self: daylight.Sunclock, date: numpy.ndarray[int64]) → object ¶

Calculates the solar noon time for given date.

This is a vectorized function.

Parameters: date (int or array_like) – unix timestamp (in UTC, seconds)

Examples

>>> import daylight
>>> sun = daylight.Sunclock(17.3859, 78.4867, 5.5)
>>> sun.solar_noon(1589999400)
1590043354
>>> sun.solar_noon([1590010200, 1590024600])
array([1590043355, 1590043355])

sunrise(self: daylight.Sunclock, date: numpy.ndarray[int64]) → object ¶

Calculates the sunrise time for given date.

This is a vectorized function.

Parameters: date (int or array_like) – unix timestamp (in UTC, seconds)

Examples

>>> import daylight
>>> sun = daylight.Sunclock(17.3859, 78.4867, 5.5)
>>> sun.sunrise(1589999400)
1590019961
>>> sun.sunrise([1590010200, 1590024600])
array([1590019959, 1590019957])

sunset(self: daylight.Sunclock, date: numpy.ndarray[int64]) → object ¶

Calculates the sunset time for given date.

This is a vectorized function.

Parameters: date (int or array_like) – unix timestamp (in UTC, seconds)

Examples

>>> import daylight
>>> sun = daylight.Sunclock(17.3859, 78.4867, 5.5)
>>> sun.sunset(1589999400)
1590066748
>>> sun.sunset([1590010200, 1590024600])
array([1590066751, 1590066754])