varwg.meteo.meteox2y.pot_s_rad

varwg.meteo.meteox2y.pot_s_rad(date, lat=48.738, longt=9.099, in_format='%Y-%m-%dT%H:%M', tz_mer=15.0, wog=-1)

theoretical maximal potential solar radiation outside of atmosphere

Parameters:

datenumpy.array of time strings (format: in_format) or datetime objects

or floats (doys)

latfloat, optional

latitude of station in decimal degrees, default: Stuttgart Lauchaecker

longtfloat, optional

longitude of station in decimal degrees, default: Stuttgart Lauchaecker

in_formattime format string, optional

format of date if date is string, default ‘%Y-%m-%dT%H:%M’

tz_merint, optional

central meridian of time zone, default: 15 (CET)

wog{-1, 1}, optional

west of greenwich, 1 if west, -1 if east, default = -1

Returns:

smaxnumpy.array of floats

maximal potential solar radiation in W/m^2

Notes

from campbell technical note 18 [1], except declination of sun (d): formula of Spencer (1971) [2]

WARNING: Campbell Scientific recommends the use of a high quality sun screen lotion when exposing your skin to solar radiation for large values of sunshine hours!

References

[1]

Campbell Scientific (2005) technical note 18: CALCULATING SUNSHINE HOURS FROM PYRANOMETER / SOLARIMETER DATA

[2]

Spencer JW (1971) Fourier series representation of the position of the Sun. Search 2: 172.

Examples

>>> date_str = np.array(["2011-09-28T11:27"])
>>> pot_s_rad(date_str)
array([855.35624182])
>>> from varwg import times
>>> dt = times.str2datetime(date_str, "%Y-%m-%dT%H:%M")
>>> pot_s_rad(dt)
array([855.35624182])
>>> pot_s_rad(times.datetime2doy(dt))
array([855.35624182])