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²                                                   

                                                                                               S…                    E…                                         
                                                Re…   Li…         Di…   Sk…   Gr…        Di…   🗤    Gr…   S…   Di…   H…   Ex…              E…         S…        
                        Di…   Sk…   Gr…   Gl…   al…   Tu…   Re…   ⇣     🗤     ⭞     I…   ⇣ ∡   ∡    ⭞ ∡   H…   Ho…   ⍖    No…   A…   In…   P…   Su…   s…   In…  
  Time                  ⇣ ∡   🗤 ∡   ⭞ ∡   ⤋ ∡   ⦧ ⦩   ⋅     -⭜    -⭜    -⭜    -⭜    I…   ☉     ☉    ☉     🗤⭳   ⇣ ⭳   ⭳    ⍖ ⦜   ⦩    ⭸     O…   ⛰     🮞    🮞    
 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 
  2010-01-01 12:00:00   73…   88…   5.…   83…   20…   2.0   -6…   -4…   -0…   -0…   8…   74…   8…   6.…   4…   32…   4…   14…   0…   0.…   0…   Ab…   S…   Fa…  

  ⅀ / μ                 73…   88…   5.…   83…                     -4…   -0…   -0…        74…   8…   6.…   4…   32…   4…   14…                                   

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

                                                                                                                                          Global Horizontal ⤋   
  Time                  Altitude ⦩   Unrefracted ⦧   Linke Turbidity ⋅   Extra Normal ⦜   Direct Horizontal ⇣ ⭳   Diffuse 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.