1idSrSSKJrJr SSKJr SSKJrJr SSKJ r Sr Sr S r S r S r\ "S 5S 5r\ "S 5S5r\ "S 5S5r\ "S 5S5r\ "S 5S5r\ "S 5S5r\ "S 5\ 4Sj5r\ "S 5\ 4Sj5r\ "S 5\R.\R0\4Sj5r\ "S 5\\R.\R04Sj5r\ 4Sjr\ "S 5\\R.\R0\ 4Sj5r\ "S 5\\R.\R0\ 4Sj5r\ "S 5\ \ \ \\R.\R04Sj5r\ "S 5\ \ \ \\R.\R04Sj5r\ "S 5\\R.\R04Sj5r Sr!\ "S 5S5r"g) aAdditional support functions for solar geometry, astronomy, radiation correlation :Original author: Simeon Nwaogaidu :Contact: SimeonObinna.Nwaogaidu AT lahmeyer DOT de :Additional author: Holger Zebner :Contact: holger.zebner AT lahmeyer DOT de :Additional author: Brandon Stafford )datetime timedelta)numeric)solar constants)check_aware_dtg@?g\@mwhenc UR5nUS:waUR5nOSnUR5RnUS- S-U- nS[R -U-S- nSS[R "U5-- S [R "SU-5-- S [R "S U-5-- S [R"U5--S [R"SU-5--S[R"S U-5--n[R"SSU--5nSS[R"U5-- S[R"SU-5--S[R"S U-5--S[R"SU-5-- S[R "U5-- S[R "SU-5--S[R "S U-5--S- nSUS- -U- n [R"[R "[R"S55[R "[R"U55[R "[R"U55-- [R"[R"U55[R"[R"U55-- 5S[R - -n [URURURURS9n U [!X- S9-n U [!X-S9-n U [!U S9-nXU4$)aqThis function calculates the astronomical sunrise, sunset and sun transit times in local time. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date and time in any valid timezone, answers will be for same day in same timezone. Returns ------- sunrise_time_dt : datetime.datetime Sunrise time in local time. sunset_time_dt : datetime.datetime Sunset time in local time. transit_time_dt: Sun transit time in local time. References ---------- .. [1] http://www.skypowerinternational.com/uploads/documents/7.1415.01.121_cm121_bed-anleitung_engl.pdf .. [2] http://pysolar.org/ .. [3] https://www.esrl.noaa.gov/gmd/grad/solcalc/solareqns.PDF .. [4] https://www.sciencedirect.com/science/article/pii/S0038092X11004592 .. [5] https://iris.unipa.it/retrieve/handle/10447/55143/28818/Articolo.pdf Examples -------- >>> lat = 50.111512 >>> lon = 8.680506 >>> timezone_local = dateutil.tz.gettz('Europe/Berlin') >>> now = datetime.now(timezone_local) >>> sr, ss, tr = sb.get_sunrise_sunset_transit(lat, lon, now) >>> print('sunrise: ', sr) >>> print('sunset:', ss) >>> print('transit:', tr) Nrig.@ingWx?gjt6@gqS?g m?g5l/@gKJ̓?g`Y?g/$rq@g̓k?gN@!@gX9v>Y@g33333@g?ܵ| @gq= ף(@gd;Oz@gS:)@g@2@ gZd;OV@)yearmonthdaytzinfo)hours) utcoffset total_seconds timetupletm_ydaymathpicossinradiansacostanrrrrrr) latitude_deg longitude_degr utc_offsetrSHATTdecl time_adstTONhasame_day sunrise_time sunset_time transit_times O/var/www/html/motor_solar_iot/venv/lib/python3.13/site-packages/pysolar/util.pyget_sunrise_sunset_transitr1/sZ!JT--/  ..  " "C t d "] 2C TWWs S B  TXXb\ ! " txxB' '  ( dhhq2v& &  ' dhhrl " # txxB' ' ( dhhq2v& & ' g3. /Bdhhrl*+dhhq2v.. / TXXa"f-- .DHHQV,,-dhhrl* +dhhq2v.. /DHHQV,,-"%, sTz/I %C IIf-.HHT\\,78HHT\\$/01l34d+,- - $''\ $tyy$**DHHW[WbWbcHi99LYsx88Ki44L l 22c [XU5SS$)zYWrapper for get_sunrise_sunset_transit that returns just the sunrise and the sunset time.rrr1r#r$r s r0get_sunrise_sunsetr6s #<EaJKr2c [XU5S$)zJWrapper for get_sunrise_sunset_transit that returns just the sunrise time.rr4r5s r0get_sunrise_timer8 #<EaHIr2c [XU5S$)zIWrapper for get_sunrise_sunset_transit that returns just the sunset time.rr4r5s r0get_sunset_timer;r9r2c [XU5S$)zJWrapper for get_sunrise_sunset_transit that returns just the transit time.rr4r5s r0get_transit_timer=r9r2cSS[R"S[R-UR5RS- -5-S- - $)aoMean Earth-Sun distance is the arithmetical mean of the maximum and minimum distances between a planet (Earth) and the object about which it revolves (Sun). However, the function is used to calculate the Mean earth sun distance. Parameters ---------- when : datetime.datetime date/time for which to do the calculation Returns ------- KD : float Mean earth sun distance References ---------- .. [1] http://sunbird.jrc.it/pvgis/solres/solmod3.htm#clear-sky%20radiation .. [2] R. aguiar and et al, "The ESRA user guidebook, vol. 2. database", models and exploitation software-Solar radiation models, p.113 rgx&?r^r )rrr utctimetupler)r s r0mean_earth_sun_distancerAsD. vTWW0A0A0C0K0Kb0P!QRRUXX XXr2cUR5Rn[R"S[R-US- -S- 5n[R "S[R-US- -S- 5n[R"SS[R-US- -S- -5n[R "SS[R-US- -S- -5n[R "[R"U55n [R "[R"X!55n [R "[R "U55[R "U 5-[R"[R "U55[R"U 5-[R"U 5--n U S:aX;-SSU--SU--SU--S U---$S $) a+Equation calculates Extratrestrial radiation. Solar radiation incident outside the earth's atmosphere is called extraterrestrial radiation. On average the extraterrestrial irradiance is 1367 Watts/meter2 (W/m2). This value varies by + or - 3 percent as the earth orbits the sun. The earth's closest approach to the sun occurs around January 4th and it is furthest from the sun around July 5th. Parameters ---------- when : datetime.datetime date/time for which to do the calculation latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. SC : float The solar constant is the amount of incoming solar electromagnetic radiation per unit area, measured on the outer surface of Earth's atmosphere in a plane perpendicular to the rays.It is measured by satellite to be roughly 1366 watts per square meter (W/m^2) Returns ------- EXTR1 : float Extraterrestrial irradiation References ---------- .. [1] http://solardat.uoregon.edu/SolarRadiationBasics.html .. [2] Dr. J. Schumacher and et al,"INSEL LE(Integrated Simulation Environment Language)Block reference",p.68 rr gv@rgqh?g>7j?gh㈵T?g{/hG?gZa/?r ) r@rrrrrr rget_declinationget_hour_angle) r#r$r SCrabbccddfr(r+ZAs r0extraterrestrial_irradrKsD     % %C !dgg+s+U3 4B !dgg+s+U3 4B !q477{cCi0%89 :B !q477{cCi0%89 :B <<--c2 3D e**4? @B $,,|, - >$,,WcJdAehlhphpquhvAvy}zBzBCEzFBF FBbdghbh27g2 -2 =2 MPX[]P]] ^qnqqr2c[R[R"S[R-U- UR 5R S- -5-$)aThe declination of the sun is the angle between Earth's equatorial plane and a line between the Earth and the sun. It varies between 23.45 degrees and -23.45 degrees, hitting zero on the equinoxes and peaking on the solstices. Parameters ---------- when : datetime.datetime date/time for which to do the calculation TY : float Total number of days in a year. eg. 365 days per year,(no leap days) Returns ------- DEC : float The declination of the Sun References ---------- .. [1] http://pysolar.org/ rQ)rearth_axis_inclinationrrrr@r)r TYs r0declination_degreerPsF.  + +dhhDGG r8JPTPaPaPcPkPkoqOq7r.s ssr2c[R"XX%X45nSS[R"U5--SSS[R"SU-5- ---$)aEquation calculates Solar elevation function for clear sky type. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. Returns ------- SOLALTC : float Solar elevation function clear sky References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. g q?gAǘ?goŏ1?rrr get_altituderrr)r#r$r temperaturepressure elevationaltitudes r0solarelevation_function_clearrYsYD!!,d{dH $((8"45 68qSWS[S[\]ai\jSkOkHl:m nor2c[R"XX#XE5nSS[R"U5--SSS[R"SU-5- ---$)a7The function calculates solar elevation function for overcast sky type. This associated hourly overcast radiation model is based on the estimation of the overcast sky transmittance with the sun directly overhead combined with the application of an over sky elavation function to estimate the overcast day global irradiation value at any solar elevation. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals Returns ------- SOLALTO : float Solar elevation function overcast References ---------- .. [1] Prof. Peter Tregenza,"Solar radiation and daylight models", p.89. .. [2] Also accessible through Google Books: http://tinyurl.com/5kdbwu Tariq Muneer, "Solar Radiation and Daylight Models, Second Edition: For the Energy Efficient Design of Buildings" gZ+g{gx&?g \?rRrrrS)r#r$r rWrUrVrXs r0 solarelevation_function_overcastr[CsZR!!,d{dH Gtxx'9: ;3RSVZV^V^_`ck_kVlRlKm@n oor2c$SSU--SU-U--$)aEquation calculates the Diffuse_transmittance and the is the Theoretical Diffuse Irradiance on a horizontal surface when the sun is at the zenith. Parameters ---------- TL : float Linke turbidity factor Returns ------- DT : float diffuse_transmittance References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. x&15K7AD@@߾?)TLs r0diffuse_transmittancerbps!(2 '7b>R+@ ABr2cvSSU--SU-U--n[R"XX#XE5n[U5U-U-$)aEquation calculates diffuse radiation under clear sky conditions. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals TL : float Linke turbidity factor Returns ------- DIFFC : float Diffuse Irradiation under clear sky References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. r]r^r_)rrTrA) r#r$r rWrUrVraDTrXs r0diffuse_underclearresJF v} %B2)> ?B!!,d{dH "4 (2 - 88r2c vSSU--SU-U--n[U5U-[R"XX#XE5-nU$)aFunction calculates the diffuse radiation under overcast conditions. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals TL : float Linke turbidity factor Returns ------- DIFOC : float Diffuse Irradiation under overcast References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. r]r^r_)rArrT) r#r$r rWrUrVrardDIFOCs r0diffuse_underovercastrhsUF v} %B2)> ?B%d+((T(3?@E Lr2c [U5n [X#5n SU -[R"SU-U-U -5-[R"[ R "XX&Xx55-n U $)avEquation calculates direct radiation under clear sky conditions. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation TY : float Total number of days in a year. eg. 365 days per year,(no leap days) AM : float Air mass. An Air Mass is a measure of how far light travels through the Earth's atmosphere. One air mass, or AM1, is the thickness of the Earth's atmosphere. Air mass zero (AM0) describes solar irradiance in space, where it is unaffected by the atmosphere. The power density of AM1 light is about 1,000 W/m^2 TL : float Linke turbidity factor elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals Returns ------- DIRC : float Direct Irradiation under clear References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. iWgGr)rArPrexprrrT) r#r$r rOAMrarWrUrVKDDECDIRCs r0direct_underclearrosrV ! &B T %C 2IB2!6#!> !%%*<*<\:>:E+S"T TD Kr2c [XUX4XV[R[RS9 n [ XUU[R[RS9n X-n U $)aEquation calculates global irradiance under clear sky conditions. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. TY : float Total number of days in a year. eg. 365 days per year,(no leap days) AM : float Air mass. An Air Mass is a measure of how far light travels through the Earth's atmosphere. One air mass, or AM1, is the thickness of the Earth's atmosphere. Air mass zero (AM0) describes solar irradiance in space, where it is unaffected by the atmosphere. The power density of AM1 light is about 1,000 W/m. TL : float Linke turbidity factor elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. Returns ------- ghic : float Global Irradiation under clear sky References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. )rUrV)rorstandard_temperaturestandard_pressurere) r#r$r rOrkrarWrUrVrnDIFFCghics r0global_irradiance_clearrus]` l4 b9CaCa)2)D)D FD |D( 8V8V)2)D)D FE LD Kr2c >S[R"XUX4U5-nU$)aDCalculated Global is used to compare to the Diffuse under overcast conditions. Under overcast skies, global and diffuse are expected to be equal due to the absence of the beam component. Parameters ---------- latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. when : datetime.datetime date/time for which to do the calculation elevation : float The elevation of a geographic location is its height above a fixed reference point, often the mean sea level. temperature : float atmospheric temperature in kelvin pressure : float pressure in pascals Returns ------- ghioc : float Global Irradiation under overcast sky References ---------- .. [1] S. Younes, R.Claywell and el al, "Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. i<)rrT)r#r$r rWrUrVghiocs r0global_irradiance_overcastrxLs.NE&&|D$-hIJE Lr2cX- nU$)aFunction calculates the Diffuse ratio. Parameters ---------- DIFF_data : array_like Diffuse horizontal irradiation data ghi_data : array_like global horizontal irradiation data array Returns ------- K : float diffuse_ratio References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. r`) DIFF_dataghi_dataKs r0 diffuse_ratior}ys* A Hr2c&[XU5nX- nU$)aThis calculates the clear index ratio. Parameters ---------- ghi_data : array_like global horizontal irradiation data array when : datetime.datetime date/time for which to do the calculation latitude_deg : float latitude in decimal degree. A geographical term denoting the north/south angular location of a place on a sphere. longitude_deg : float longitude in decimal degree. Longitude shows your location in an east-west direction,relative to the Greenwich meridian. Returns ------- KT : float Clear index ratio References ---------- .. [1] S. Younes, R.Claywell and el al,"Quality control of solar radiation data: present status and proposed new approaches", energy 30 (2005), pp 1533 - 1549. )rK)r{r#r$r EXTR1KTs r0 clear_indexrs: #< EE  B Ir2N)#__doc__rrrrrr tzinfo_checkr AM_default TL_default SC_default TY_defaultelevation_defaultr1r6r8r;r=rArKrPrqrrrYr[rbrerhrorurxr}rr`r2r0rs& (    s3s3jKK II II II YY0AK*r*rZ",tt2S\SqSq-6-H-HWh"p"pH1BR[RpRp090K0K)p)pX *C.FW%.%C%CPYPkPkpz%9%9NIZ(1(F(FS\SnSnr|''R%JZUf$-$B$ByOjOj33j!+*:[l*3*H*HU^UpUp99x+