Skip to content

Global

This page overviews how-to work with the irradiance global sub-commands

irradiance global

pvgis-prototype irradiance global
 Usage: pvgis-prototype irradiance global [OPTIONS] COMMAND [ARGS]...                                                                                                                                                                          

 ⤋ Calculate the global irradiance over a time series                                                                                                                                                                                          

╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --help          Show this message and exit.                                                                                                                                                                                                 │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Solar irradiance time series ───────────────────────────────────────────────────────────────╮
│ horizontal   Calculate the broadband global horizontal irradiance over a time series         │
│ inclined     Calculate the broadband global inclined irradiance over a time series           │
│ spectral     Calculate the spectrally resolved global inclined irradiance over a time series │
╰──────────────────────────────────────────────────────────────────────────────────────────────╯

Global inclined

pvgis-prototype irradiance global inclined \
    8.628 45.812 214 180 35 \
    '2010-01-01 12:00:00' \
    -vvvv
                                                                                          Global Inclined Irradiance in-plane irradiance series W/m²                                                                                           

                                                            Refra…   Linke                                                                            Sky-D…   Direct   Extra    Extra                      Eccen…            Shadi…           
                        Direct   Sky-D…   Groun…   Global   alt. ⦧   Turbi…   Refle…   Direct   Sky-D…   Groun…   Incli…   Direct   Sky-D…   Groun…   Horiz…   Horiz…   Horiz…   Normal   Altit…   Incid…   Phase    Sun-H…   state    In-sh…  
  Time                  ⇣ ∡      🗤 ∡      ⭞ ∡      ⤋ ∡      ⦩        ⋅        -⭜       ⇣ -⭜     🗤 -⭜     ⭞ -⭜     Irrad…   ⇣ ∡ ☉    🗤 ∡ ☉    ⭞ ∡ ☉    🗤⭳       ⇣ ⭳      ⍖ ⭳      ⍖ ⦜      ⦩        ⭸        Offset   ⛰        🮞        🮞       
 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 
  2010-01-01 12:00:00   737.0…   88.192   5.858    831.1…   20.798   2.0      -6.622   -4.84    -0.986   -0.796   837.76   741.9…   89.178   6.655    47.743   320.2…   499.3…   1406.…   0.363    0.966    0.049    Above    Sunlit   False   

  ⅀ / μ                 737.0…   88.192   5.858    831.1…                              -4.84    -0.986   -0.796            741.9…   89.178   6.655    47.743   320.2…   499.3…   1406.…                                                        

╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ ╭────────────────────────────────────────────────────────────────╮
│ Location  Longitude ϑ, Latitude ϕ = 0.151, 0.8, Elevation: 214.0 m                                                                               │ │  ⸾  Irradiance    ⦜  Normal       ⛰  Horizon          μ  Mean  │
│ Position  Surface Orientation ↻: 3.142, Surface Tilt ⦥: 0.611   Angular units None                                                               │ │  -  Loss          🗤  Diffuse      ↻  Orientation               │
│ Definitions  Incidence angle: Sun-Vector-to-Surface-Plane, Sun-to-Horizon: ['Below', 'Low angle', 'Above']                                       │ │  ∡  Inclined      ⭞  Reflected    ⦥  Tilt                      │
│ Algorithms  Timing : NOAA, Positioning : NOAA, Incidence : Iqbal, Shading : PVGIS, Shading states : ['Potentially-sunlit', 'In-shade', 'Sunlit'] │ │  ⇣  Direct        ⏲  Timing       ⭸  Incidence                 │
│ Radiation model ⸾ : Hofierka 2002, Irradiance units W/m²                                                                                         │ │  ⭜  Reflectivity  ⦩  Altitude     🮞  Shading                   │
│ Equation : Direct ⇣∡ + Sky-Diffuse 🗤∡ + Ground-Diffuse ⭞∡                                                                                        │ │  ⭳  Horizontal    󱦥  Azimuth      ⋅  Factor                    │
│ Constants Solar constant : 1367.0, Eccentricity Offset : 0.048869, Eccentricity Amplitude ⋅⬭ : 0.03344                                           │ │  ⍖  Extra Normal  ⯐  Positioning  ⅀  N-ary Summation           │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Reference ─╯ ╰─────────────────────────────────────────────────────── Legend ─╯

Global horizontal

Horizontal components

Horizontal components are independent of the positional setup of a solar surface. Hence, we only need to provide a location and define a series of timestamps.

pvgis-prototype irradiance global horizontal \
    8.628 45.812 214 \
    '2010-01-01 12:00:00' \
    -vvv
                                                  Global Horizontal Irradiance in-plane irradiance series W/m²                                                   

  Time                  Altitude ⦩   Unrefracted ⦧   Linke Turbidity ⋅   Extra Normal ⦜   Direct Horizontal ⇣ ⭳   Diffuse Horizontal 🗤⭳   Global Horizontal ⤋ ⭳  
 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 
  2010-01-01 12:00:00   0.363        True            2.0                 1406.282         320.218                 47.743                  367.962                

  ⅀ / μ                                                                                   320.218                                                                

╭─────────────────────────────────────────────────────────────────────────────────╮ ╭─────────────────────────────────────────────────────╮
│ 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 ─╯

Global spectral

Incomplete

This section is yet to be completed.