Solar Irradiance
Simulating horizontal irradianceยถ
We can simulate solar irradiance components using PVGIS!
To start with, let us check the interface of the irradiance commands :
Usage: pvgis-prototype irradiance [OPTIONS] COMMAND [ARGS]...
โธพ Calculate the solar irradiance incident on a solar surface
โญโ Options โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --help Show this message and exit. โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Introduction โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ introduction Primer on solar irradiance โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Solar irradiance time series โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ global โค Calculate the global irradiance โ
โ direct โฃ Calculate the direct irradiance โ
โ diffuse ๐ค Calculate the diffuse sky-reflected irradiance โ
โ extraterrestrial โ Estimate the extraterrestrial irradiance โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Toolbox โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ kato-bands [โธพ] Kato spectral bands limits and center wavelengths โ
โ reflectivity โญโ
Calculate the reflectivity effect factor Yet not complete! โ
โ limits [โธพ] Calculate physically possible irradiance limits โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
We can simulate all components of solar radiation : direct, diffuse, reflected and global. Let us begin, however, with the global and direct components. These are, after all, the ones we will compare against the SARAH3 satellite-based observations.
Global horizontal irradianceยถ
As a first step, we can simulate the global horizontal irradiance over our location of interest and moment in time :
Consult the help text!
It's always a good idea to consult the help for a command. While effort has been given to keep the same order for the input parameters, not all commands share the exact same required positional parameters!
For the above command, we can get the help via
Usage: pvgis-prototype irradiance global horizontal [OPTIONS] LONGITUDE
LATITUDE ELEVATION
[TIMESTAMPS]
Calculate the broadband global horizontal irradiance over a time series
โญโ Arguments โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ * longitude FLOAT RANGE Longitude in decimal degrees ranging in [-180, 360]. If ranging in [0, 360], consider the `--convert-longitude-360` option. [required] โ
โ * latitude FLOAT RANGE Latitude in decimal degrees ranging in [-90, 90] [required] โ
โ * elevation FLOAT RANGE Topographical elevation [required] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Timestamps โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ timestamps [TIMESTAMPS] Quoted date-time strings of data to extract from series, example: '2112-12-21, 2112-12-21 12:21:21, 2112-12-21 21:12:12'' โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Options โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --resample-large-series --no-resample-large-series [default: no-resample-large-series] โ
โ --log -l INTEGER Enable logging [default: 0] โ
โ --help Show this message and exit. โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Timestamps โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --start-time,--st PARSE_TIMESTAMP Start timestamp of the period. Overrides the `timestamps` parameter! [default: None] โ
โ --periods INTEGER Number of timestamps to generate [default: None] โ
โ --frequency TEXT A common date/time frequency unit optionally with a multiples number, such as H(hourly), min(utely), S(econdly), D(aily), W(eekly), M(onth end), Y(early) or 30min. โ
โ See Pandas time series offset aliases. โ
โ [default: None] โ
โ --end-time,--et PARSE_TIMESTAMP End timestamp of the period. Overrides the `timestamps` parameter! [default: None] โ
โ --timezone,--tz,--zone PARSE_TIMEZONE Timezone (e.g., 'Europe/Athens'). Use the system's time zone via the `--local` option. [default: None] โ
โ --random-timestamps --no-random-timestamps Generate a random date, time and timezone to demonstrate calculation [default: no-random-timestamps] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Atmospheric properties โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --linke-turbidity-factor-series PARSE_LINKE_TURBIDITY_FACTOR_SERIES Ratio of total to Rayleigh optical depth measuring atmospheric turbidity โ
โ [default: name=None title='Linke Turbidity' description='The Linke Turbidity Factor describes the attenuation of the โ
โ extraterrestrial solar radiation by solid and liquid particles under cloudless sky conditions. It indicates the โ
โ optical density of hazy and humid atmosphere in relation to a clean and dry atmosphere. In other words TLK is the โ
โ number of clean dry air masses that would result in the same extinction then real hazy and humid air. Due to a โ
โ dynamic nature of the turbidity factor, its calculation and subsequent averaging leads to a certain degree of โ
โ generalisation. There are clear seasonal changes of the turbidity (lowest values in winter, highest in summer), the โ
โ values of turbidity factor always differ from place to place in a similar degree of magnitude and these differences โ
โ are also correlated with the terrain elevation. It increases with an intensity of industrialisation and urbanisation. โ
โ The values of Linke turbidity for different landscapes or world regions can be found in literature [e.g. 16, 19, 30] โ
โ or in http://www.soda-is.com/ [20]).' symbol='โ
' value=2 unit='unitless' minimum=0 maximum=8] โ
โ --adjust-for-atmospheric-refraction --no-adjust-for-atmospheric-refraction Correct solar azimuth and altitude angles for atmospheric refraction [default: adjust-for-atmospheric-refraction] โ
โ --refracted-solar-zenith FLOAT Refracted solar zenith angle (in radians) for sun -rise and -set events [default: 1.5853349194640094] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Advanced โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --apply-reflectivity-factor --no-apply-reflectivity-factor Apply angular loss function [default: apply-reflectivity-factor] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Solar position โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --solar-position-model,--position-model,--positioning-model [all|NOAA|Hofierka|Jenco|pvlib|Skyfield|suncalc] Model to calculate solar position [default: NOAA] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Solar time โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --solar-time-model [all|Milne1921|NOAA|PVGIS|pvlib|Skyfield] Model to calculate solar time [default: NOAA] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Earth orbit โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --solar-constant FLOAT RANGE [x>=1360] Top-of-Atmosphere mean solar electromagnetic radiation (W/m-2) 1 au (astronomical unit) away from the Sun. [default: 1360.8] โ
โ --eccentricity-phase-offset FLOAT Eccentricity phase offset (in radians) aligning the eccentricity correction with Earth's perihelion position in its orbit, part of calculation of the solar declination angle. โ
โ [default: 0.048869] โ
โ --eccentricity-amplitude FLOAT Amplitude of the Earth's orbital eccentricity effect on solar irradiance variation throughout the year, part of the calculation of the solar declination angle. โ
โ [default: 0.03344] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ > Input : < Output โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --angle-output-units -aou TEXT Angular units for solar geometry calculations (degrees or radians) [default: radians] โ
โ --rounding-places -r INTEGER Number of digits to round results to [default: 3] โ
โ --csv PATH CSV output filename [default: None] โ
โ --verbose -v INTEGER Show details while executing commands [default: 0] โ
โ --index,--idx -i Index rows in output table (meaningful with at least 1x -v) โ
โ --quiet Do not print out the output โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Data processing โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --dtype TEXT Data type [default: float32] โ
โ --array-backend TEXT Array backend [default: numpy] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Statistics โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --statistics --no-statistics Calculate and display summary statistics [default: no-statistics] โ
โ --groupby TEXT Group statistics, ex. M or 3h. A number and date/time unit : (Y)ear, (S)eason, (M)onth, (D)ay, (W)eek, (h)our. See Xarray's group-by operations. [default: None] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Plotting โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --uniplot --no-uniplot Plot the PV power output time series in the terminal [default: no-uniplot] โ
โ --terminal-width-fraction FLOAT Fraction of number of columns of the current terminal, ex. 0.9 [default: 0.9] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
โญโ Metadata โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ --fingerprint,--fp Fingerprint the output time series โ
โ --metadata --no-metadata Print command metadata [default: no-metadata] โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
We can see how this simulated quantity breaks down in its sub-components too by using a few -vs :
Global Horizontal Irradiance in-plane irradiance series W/mยฒ
Time Altitude โฆฉ Unrefracted โฆง Linke Turbidity โ
Extra Normal โฆ Direct Horizontal โฃ โญณ Diffuse Horizontal ๐คโญณ Global Horizontal โค โญณ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
2010-01-27 12:00:00 0.442 True 2.0 1402.426 406.281 52.892 459.173
โ
/ ฮผ 406.281
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Location Longitude ฯ, Latitude ฯ = 0.151, 0.8 Angular units Unitless โ โ โธพ Irradiance ๐ค Diffuse โ
Factor โ
โ Algorithms Timing : NOAA, Positioning : NOAA, Adjusted for refraction : True, โ โ โฃ Direct โฒ Timing โ
N-ary Summation โ
โ Radiation model โธพ : Hofierka 2002, Irradiance units W/mยฒ โ โ โญณ Horizontal โฆฉ Altitude ฮผ Mean โ
โ Constants Solar constant : 1367.0 โ โ โฆ Normal โฏ Positioning โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Reference โโฏ โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Legend โโฏ
Direct horizontal irradianceยถ
We will get the same simulated direct horizontal estimation by using the direct horizontal commands :
Diffuse horizontal irradianceยถ
The diffuse component is the difference between global and direct. As with the previous command examples, we can derive the diffuse horizontal component via :
Note
The diffuse horizontal irradiance component does not need to know of an elevation value, hence compared to the command for the direct irradiance, the number 214 was removed in this example command.
Satellite observations of solar irradianceยถ
Instead of relying on the model, let's read-in observations of solar irradiance from the SARAH3 data collection :
SARAH3 SISยถ
- Read the
SIScomponent from SARAH3 :
pvgis-prototype series select \
sarah2_sis_over_esti_jrc.nc \
8.628 45.812 \
'2010-01-27 12:00:00' \
--neighbor-lookup nearest \
--mask-and-scale \
-v
Selected
data
โโโโโโโโโ
388.000
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Location Longitude ฯ, Latitude ฯ = 8.628, 45.812 โ
โ Legend: Center Wavelengths (nm) โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
SARAH3 SIDยถ
- Read the
SIDcomponent from SARAH3 :
pvgis-prototype series select \
sarah2_sid_over_esti_jrc.nc \
8.628 45.812 \
--neighbor-lookup nearest \
-v \
--mask-and-scale \
'2010-01-27 12:00:00'
Selected
data
โโโโโโโโโ
242.000
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Location Longitude ฯ, Latitude ฯ = 8.628, 45.812 โ
โ Legend: Center Wavelengths (nm) โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Optional and required parameters
The latter command differs from the one before in that the order of the optional and required input parameters is not the same. The message here is that : indeed, we can mix the order of optional parameters in-between as long as we keep strictly the order of the required ones, as indicated in the help section of a command.
Just run pvgis-prototype series select and read the help text !
Indeed, the simulated values differ from the satellite-based observations retrieved from the SARAH3 datasets. Aren't they close enough ? We need to keep in mind that a series of assumptions and simplifications are part of the solar radiation model.
Direct normal irradianceยถ
In estimating the photovoltaic power output, the solar radiation component with the greatest impact, is the direct normal irradiance.
From the theory, we know that
or using acronyms frequently used in solar science
Note
Equation 3-6 from https://www.cmsaf.eu/SharedDocs/Literatur/document/2023/saf_cm_dwd_pum_meteosat_hel_sarah_3_3_pdf.pdf?__blob=publicationFile.
- First, let's get the zenith angle in radians
Solar Zenith Series
Time Zenith โฆญ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
2010-01-17 12:00:00 1.168
โ
/ ฮผ
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โญโโโโโโโโโโโโโโฎ
โ Start Every End Zone โ โ Location Longitude ฯ, Latitude ฯ = 0.151, 0.8 Angular units Unitless โ โ โฆญ Zenith โ
โ 2010-01-17 12:00 - 2010-01-17 12:00 UTC โ โ Definitions Unrefracted zenith: True โ โ โ
โ โ โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Reference โโฏ โฐโโโโ Legend โโฏ
โ โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฏ
Bug
There is likely a bug in the position zenithcommand currently!
-
Next, open a Python interpreter
-
Set the direct horizontal irradiance reported in SARAH3 and the zenith angle calculated previously
-
Calculate the
DNIusing simple PyhonDNI = 1062.5725738840667
Let's compare with PVGIS' model :
We can assume the model in the new software is close and not wildly out of range !
Horizontal irradianceยถ
If we simulate also the Direct Horizontal Component, it should be close to the SARAH3 observation.
Is it ? Let's find out ...
Note
Isn't this close enough to 431 ?
Inclined irradianceยถ
Next, the simulated direct inclined component :
And the simulated global inclined component is :
Analytically, the above figure is broken down to its inclined components as :
Global Inclined Irradiance in-plane irradiance series W/mยฒ
Linke Sky-Diffโฆ Direct Extra Extra
Direct โฃ Sky-Difโฆ Ground-โฆ Global โค Refractโฆ Turbidiโฆ Inclined Direct โฃ Sky-Diffโฆ Ground-โฆ Horizontโฆ Horizonโฆ Horizontโฆ Normal โ Altitude Incidenโฆ Sun-Horiโฆ Shading In-shade
Time โก ๐ค โก โญ โก โก alt. โฆง โฆฉ โ
Irradianโฆ โก โ ๐ค โก โ โญ โก โ ๐คโญณ โฃ โญณ โ โญณ โฆ โฆฉ โญธ โฐ state ๐ฎ ๐ฎ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
2010-01-27 12:00:00 887.405 96.258 12.503 996.166 25.351 2.0 1001.605 890.891 97.266 13.447 52.892 406.227 600.474 1402.426 0.442 1.22 Above Sunlit False
โ
/ ฮผ 887.405 96.258 12.503 996.166 890.891 97.266 13.447 52.892 406.227 600.474 1402.426
โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ โญโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโฎ
โ Location Longitude ฯ, Latitude ฯ = 0.151, 0.8, Elevation: 210.0 m โ โ โธพ Irradiance ๐ค Diffuse โป Orientation โ
โ Position Surface Orientation โป: 3.142, Surface Tilt โฆฅ: 0.785 Angular units None โ โ - Loss โญ Reflected โฆฅ Tilt โ
โ Definitions Incidence angle: Sun-Vector-to-Surface-Plane, Sun-to-Horizon: ['Low angle', 'Below', 'Above'] โ โ โก Inclined โฒ Timing โญธ Incidence โ
โ Algorithms Timing : NOAA, Positioning : NOAA, Incidence : Iqbal, Shading : PVGIS, Shading states : ['Potentially-sunlit', 'In-shade', 'Sunlit'] โ โ โฃ Direct โฆฉ Altitude ๐ฎ Shading โ
โ Radiation model โธพ : Hofierka 2002, Irradiance units W/mยฒ โ โ โญณ Horizontal ๓ฑฆฅ Azimuth โ
Factor โ
โ Equation : Direct โฃโก + Sky-Diffuse ๐คโก + Ground-Diffuse โญโก โ โ โ Extra Normal โฏ Positioning โ
N-ary Summation โ
โ Constants Solar constant : 1367.0 โ โ โฆ Normal โฐ Horizon ฮผ Mean โ
โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Reference โโฏ โฐโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Legend โโฏ
Default orientation and tilt angles
The default values for the orientation and tilt angles of a solar surface are (currently) set to 180 and 45 degrees respectively. Hence, we'd get the same result if we
EXTRA
If we read the SIS and SID SARAH3 components to get the Global Inclined Irradiance :
- The diffuse inclined component here uses, of course, SARAH3 SIS and SID and goes through the math to derive to
69.08706.