pvlib.solarposition.calc_time#

pvlib.solarposition.calc_time(lower_bound, upper_bound, latitude, longitude, attribute, value, altitude=0, pressure=101325, temperature=12, horizon='+0:00', xtol=1e-12)[source]#

Calculate the time between lower_bound and upper_bound where the attribute is equal to value. Uses PyEphem for solar position calculations.

Parameters

  • lower_bound (datetime.datetime) –

  • upper_bound (datetime.datetime) –

  • latitude (float) – Latitude in decimal degrees. Positive north of equator, negative to south.

  • longitude (float) – Longitude in decimal degrees. Positive east of prime meridian, negative to west.

  • attribute (str) – The attribute of a pyephem.Sun object that you want to solve for. Likely options are ‘alt’ and ‘az’ (which must be given in radians).

  • value (int or float) – The value of the attribute to solve for

  • altitude (float, default 0) – Distance above sea level.

  • pressure (int or float, optional, default 101325) – Air pressure in Pascals. Set to 0 for no atmospheric correction.

  • temperature (int or float, optional, default 12) – Air temperature in degrees C.

  • horizon (string, optional, default '+0:00') – arc degrees:arc minutes from geometrical horizon for sunrise and sunset, e.g., horizon=’+0:00’ to use sun center crossing the geometrical horizon to define sunrise and sunset, horizon=’-0:34’ for when the sun’s upper edge crosses the geometrical horizon

  • xtol (float, optional, default 1.0e-12) – The allowed error in the result from value

Returns

datetime.datetime

Raises

  • ValueError – If the value is not contained between the bounds.

  • AttributeError – If the given attribute is not an attribute of a PyEphem.Sun object.

previous

pvlib.solarposition.spa_c

next

pvlib.solarposition.pyephem_earthsun_distance