Skip to content

Other solar position tools

Below is a collection of tools for solar positioning.

Solar declination

To retrieve the solar declination for one day:

pvgis position declination \
--start-time '2020-01-01' \
--end-time '2020-01-02'
           Solar Declination Angle           

  Time                        ∢ Declination  
 ─────────────────────────────────────────── 
  2020-01-01 00:00:00+00:00   -0.402         
  2020-01-01 01:00:00+00:00   -0.402         
  2020-01-01 02:00:00+00:00   -0.402         
  2020-01-01 03:00:00+00:00   -0.402         
  2020-01-01 04:00:00+00:00   -0.402         
  2020-01-01 05:00:00+00:00   -0.402         
  2020-01-01 06:00:00+00:00   -0.402         
  2020-01-01 07:00:00+00:00   -0.402         
  2020-01-01 08:00:00+00:00   -0.402         
  2020-01-01 09:00:00+00:00   -0.402         
  2020-01-01 10:00:00+00:00   -0.402         
  2020-01-01 11:00:00+00:00   -0.402         
  2020-01-01 12:00:00+00:00   -0.402         
  2020-01-01 13:00:00+00:00   -0.402         
  2020-01-01 14:00:00+00:00   -0.402         
  2020-01-01 15:00:00+00:00   -0.402         
  2020-01-01 16:00:00+00:00   -0.402         
  2020-01-01 17:00:00+00:00   -0.402         
  2020-01-01 18:00:00+00:00   -0.402         
  2020-01-01 19:00:00+00:00   -0.402         
  2020-01-01 20:00:00+00:00   -0.402         
  2020-01-01 21:00:00+00:00   -0.402         
  2020-01-01 22:00:00+00:00   -0.402         
  2020-01-01 23:00:00+00:00   -0.402         
  2020-01-02 00:00:00+00:00   -0.4           

╭───────────────────────────────────────────────────────────╮
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │
│ 2020-01-01 00:00  Hourly       2020-01-02 00:00  UTC      │
╰───────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────╮                 
│ Algorithms  Zone : UTC, Positioning : NA │                 
╰────────────────────────────── Reference ─╯                 
╭──────────────────╮                                         
│  ∢  Declination  │                                         
╰───────── Legend ─╯                                         

Solar hour angle

To retrieve the solar hour angle for a few hours:

pvgis position hour-angle \
8.628 \
--start-time '2020-01-01 11:00:00' \
--end-time '2020-01-02 19:00:00'
           Solar Position Overview           

  Time                        🕛 Hour Angle  
 ─────────────────────────────────────────── 
  2020-01-01 11:00:00+00:00   -0.124         
  2020-01-01 12:00:00+00:00   0.138          
  2020-01-01 13:00:00+00:00   0.4            
  2020-01-01 14:00:00+00:00   0.661          
  2020-01-01 15:00:00+00:00   0.923          
  2020-01-01 16:00:00+00:00   1.185          
  2020-01-01 17:00:00+00:00   1.447          
  2020-01-01 18:00:00+00:00   1.708          
  2020-01-01 19:00:00+00:00   1.97           
  2020-01-01 20:00:00+00:00   2.232          
  2020-01-01 21:00:00+00:00   2.493          
  2020-01-01 22:00:00+00:00   2.755          
  2020-01-01 23:00:00+00:00   3.017          
  2020-01-02 00:00:00+00:00   -3.005         
  2020-01-02 01:00:00+00:00   -2.743         
  2020-01-02 02:00:00+00:00   -2.481         
  2020-01-02 03:00:00+00:00   -2.219         
  2020-01-02 04:00:00+00:00   -1.958         
  2020-01-02 05:00:00+00:00   -1.696         
  2020-01-02 06:00:00+00:00   -1.434         
  2020-01-02 07:00:00+00:00   -1.173         
  2020-01-02 08:00:00+00:00   -0.911         
  2020-01-02 09:00:00+00:00   -0.649         
  2020-01-02 10:00:00+00:00   -0.387         
  2020-01-02 11:00:00+00:00   -0.126         
  2020-01-02 12:00:00+00:00   0.136          
  2020-01-02 13:00:00+00:00   0.398          
  2020-01-02 14:00:00+00:00   0.659          
  2020-01-02 15:00:00+00:00   0.921          
  2020-01-02 16:00:00+00:00   1.183          
  2020-01-02 17:00:00+00:00   1.445          
  2020-01-02 18:00:00+00:00   1.706          
  2020-01-02 19:00:00+00:00   1.968          

╭───────────────────────────────────────────────────────────╮              
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │              
│ 2020-01-01 11:00  Hourly       2020-01-02 19:00  UTC      │              
╰───────────────────────────────────────────────────────────╯              
╭─────────────────────────────────────────────────────────────────────────╮
│ Algorithms  Timing : NOAA, Zone : UTC, Positioning : NA, Incidence : NA │
╰───────────────────────────────────────────────────────────── Reference ─╯
╭──────────────────╮                                                       
│  🕛  Hour angle  │                                                       
╰───────── Legend ─╯                                                       

Solar event

Get important solar events by passing the --event option:

pvgis position event \
8.628 45.812 \
--start-time '2021-06-20' \
--end-time '2021-06-22' \
--event all
                          Solar Event Time                          

  Time                        🌅 Event                ⏲ Event Time  
 ────────────────────────────────────────────────────────────────── 
  2021-06-20 00:00:00+00:00                                         
  2021-06-20 01:00:00+00:00                                         
  2021-06-20 02:00:00+00:00   astronomical_twilight   02:22:42      
  2021-06-20 03:00:00+00:00   civil_twilight          03:10:42      
  2021-06-20 04:00:00+00:00   sunrise                 03:34:42      
  2021-06-20 05:00:00+00:00                                         
  2021-06-20 06:00:00+00:00                                         
  2021-06-20 07:00:00+00:00                                         
  2021-06-20 08:00:00+00:00                                         
  2021-06-20 09:00:00+00:00                                         
  2021-06-20 10:00:00+00:00                                         
  2021-06-20 11:00:00+00:00   noon                    11:26:29      
  2021-06-20 12:00:00+00:00                                         
  2021-06-20 13:00:00+00:00                                         
  2021-06-20 14:00:00+00:00                                         
  2021-06-20 15:00:00+00:00                                         
  2021-06-20 16:00:00+00:00   daylength               15:43:33      
  2021-06-20 17:00:00+00:00                                         
  2021-06-20 18:00:00+00:00                                         
  2021-06-20 19:00:00+00:00   sunset                  19:18:16      
  2021-06-20 20:00:00+00:00                                         
  2021-06-20 21:00:00+00:00                                         
  2021-06-20 22:00:00+00:00                                         
  2021-06-20 23:00:00+00:00                                         
  2021-06-21 00:00:00+00:00                                         
  2021-06-21 01:00:00+00:00                                         
  2021-06-21 02:00:00+00:00   astronomical_twilight   02:22:50      
  2021-06-21 03:00:00+00:00   civil_twilight          03:10:50      
  2021-06-21 04:00:00+00:00   sunrise                 03:34:50      
  2021-06-21 05:00:00+00:00                                         
  2021-06-21 06:00:00+00:00                                         
  2021-06-21 07:00:00+00:00                                         
  2021-06-21 08:00:00+00:00                                         
  2021-06-21 09:00:00+00:00                                         
  2021-06-21 10:00:00+00:00                                         
  2021-06-21 11:00:00+00:00   noon                    11:26:42      
  2021-06-21 12:00:00+00:00                                         
  2021-06-21 13:00:00+00:00                                         
  2021-06-21 14:00:00+00:00                                         
  2021-06-21 15:00:00+00:00                                         
  2021-06-21 16:00:00+00:00   daylength               15:43:43      
  2021-06-21 17:00:00+00:00                                         
  2021-06-21 18:00:00+00:00                                         
  2021-06-21 19:00:00+00:00   sunset                  19:18:34      
  2021-06-21 20:00:00+00:00                                         
  2021-06-21 21:00:00+00:00                                         
  2021-06-21 22:00:00+00:00                                         
  2021-06-21 23:00:00+00:00                                         
  2021-06-22 00:00:00+00:00   daylength               15:43:47      

╭───────────────────────────────────────────────────────────╮
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │
│ 2021-06-20 00:00  Hourly       2021-06-22 00:00  UTC      │
╰───────────────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────╮ 
│ Algorithms  Zone : UTC, Positioning : NA, Incidence : NA │ 
╰────────────────────────────────────────────── Reference ─╯ 
╭──────────────────────────╮                                 
│  🌅  Sunrise  ⏲  Timing  │                                 
╰───────────────── Legend ─╯                                 

Solar zenith

Compute the solar zenith over a period of time:

pvgis position zenith \
8.628 45.812 \
--start-time '2021-06-20' \
--end-time '2021-06-22'
          Solar Zenith Series           

  Time                        ⦭ Zenith  
 ────────────────────────────────────── 
  2021-06-20 00:00:00+00:00   1.925     
  2021-06-20 01:00:00+00:00   1.877     
  2021-06-20 02:00:00+00:00   1.788     
  2021-06-20 03:00:00+00:00   1.666     
  2021-06-20 04:00:00+00:00   1.517     
  2021-06-20 05:00:00+00:00   1.357     
  2021-06-20 06:00:00+00:00   1.182     
  2021-06-20 07:00:00+00:00   1.001     
  2021-06-20 08:00:00+00:00   0.82      
  2021-06-20 09:00:00+00:00   0.646     
  2021-06-20 10:00:00+00:00   0.496     
  2021-06-20 11:00:00+00:00   0.401     
  2021-06-20 12:00:00+00:00   0.408     
  2021-06-20 13:00:00+00:00   0.511     
  2021-06-20 14:00:00+00:00   0.665     
  2021-06-20 15:00:00+00:00   0.84      
  2021-06-20 16:00:00+00:00   1.022     
  2021-06-20 17:00:00+00:00   1.202     
  2021-06-20 18:00:00+00:00   1.376     
  2021-06-20 19:00:00+00:00   1.534     
  2021-06-20 20:00:00+00:00   1.681     
  2021-06-20 21:00:00+00:00   1.8       
  2021-06-20 22:00:00+00:00   1.885     
  2021-06-20 23:00:00+00:00   1.928     
  2021-06-21 00:00:00+00:00   1.925     
  2021-06-21 01:00:00+00:00   1.877     
  2021-06-21 02:00:00+00:00   1.788     
  2021-06-21 03:00:00+00:00   1.667     
  2021-06-21 04:00:00+00:00   1.518     
  2021-06-21 05:00:00+00:00   1.357     
  2021-06-21 06:00:00+00:00   1.183     
  2021-06-21 07:00:00+00:00   1.002     
  2021-06-21 08:00:00+00:00   0.82      
  2021-06-21 09:00:00+00:00   0.646     
  2021-06-21 10:00:00+00:00   0.496     
  2021-06-21 11:00:00+00:00   0.401     
  2021-06-21 12:00:00+00:00   0.407     
  2021-06-21 13:00:00+00:00   0.51      
  2021-06-21 14:00:00+00:00   0.664     
  2021-06-21 15:00:00+00:00   0.839     
  2021-06-21 16:00:00+00:00   1.021     
  2021-06-21 17:00:00+00:00   1.202     
  2021-06-21 18:00:00+00:00   1.375     
  2021-06-21 19:00:00+00:00   1.533     
  2021-06-21 20:00:00+00:00   1.681     
  2021-06-21 21:00:00+00:00   1.799     
  2021-06-21 22:00:00+00:00   1.884     
  2021-06-21 23:00:00+00:00   1.928     
  2021-06-22 00:00:00+00:00   1.925     

╭───────────────────────────────────────────────────────────╮
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │
│ 2021-06-20 00:00  Hourly       2021-06-22 00:00  UTC      │
╰───────────────────────────────────────────────────────────╯
╭─────────────────────────────────────────────────────────╮  
│ Position  longitude, latitude = 0.151, 0.8, Unitless    │  
│ Algorithms  Timing : NOAA, Zone : UTC, Positioning : NA │  
╰───────────────────────────────────────────── Reference ─╯  
╭─────────────╮                                              
│  ⦭  Zenith  │                                              
│             │                                              
╰──── Legend ─╯                                              

Solar altitude

Compute the solar altitude over a period of time:

pvgis position altitude \
8.628 45.812 \
--start-time '2021-06-20' \
--end-time '2021-06-22'
          Solar Altitude Series           

  Time                        ⦩ Altitude  
 ──────────────────────────────────────── 
  2021-06-20 00:00:00+00:00   -0.355      
  2021-06-20 01:00:00+00:00   -0.306      
  2021-06-20 02:00:00+00:00   -0.217      
  2021-06-20 03:00:00+00:00   -0.095      
  2021-06-20 04:00:00+00:00   0.054       
  2021-06-20 05:00:00+00:00   0.214       
  2021-06-20 06:00:00+00:00   0.389       
  2021-06-20 07:00:00+00:00   0.569       
  2021-06-20 08:00:00+00:00   0.751       
  2021-06-20 09:00:00+00:00   0.925       
  2021-06-20 10:00:00+00:00   1.075       
  2021-06-20 11:00:00+00:00   1.169       
  2021-06-20 12:00:00+00:00   1.163       
  2021-06-20 13:00:00+00:00   1.06        
  2021-06-20 14:00:00+00:00   0.906       
  2021-06-20 15:00:00+00:00   0.731       
  2021-06-20 16:00:00+00:00   0.549       
  2021-06-20 17:00:00+00:00   0.368       
  2021-06-20 18:00:00+00:00   0.195       
  2021-06-20 19:00:00+00:00   0.037       
  2021-06-20 20:00:00+00:00   -0.111      
  2021-06-20 21:00:00+00:00   -0.229      
  2021-06-20 22:00:00+00:00   -0.314      
  2021-06-20 23:00:00+00:00   -0.357      
  2021-06-21 00:00:00+00:00   -0.355      
  2021-06-21 01:00:00+00:00   -0.306      
  2021-06-21 02:00:00+00:00   -0.218      
  2021-06-21 03:00:00+00:00   -0.096      
  2021-06-21 04:00:00+00:00   0.053       
  2021-06-21 05:00:00+00:00   0.214       
  2021-06-21 06:00:00+00:00   0.388       
  2021-06-21 07:00:00+00:00   0.569       
  2021-06-21 08:00:00+00:00   0.75        
  2021-06-21 09:00:00+00:00   0.924       
  2021-06-21 10:00:00+00:00   1.075       
  2021-06-21 11:00:00+00:00   1.169       
  2021-06-21 12:00:00+00:00   1.163       
  2021-06-21 13:00:00+00:00   1.061       
  2021-06-21 14:00:00+00:00   0.907       
  2021-06-21 15:00:00+00:00   0.731       
  2021-06-21 16:00:00+00:00   0.55        
  2021-06-21 17:00:00+00:00   0.369       
  2021-06-21 18:00:00+00:00   0.196       
  2021-06-21 19:00:00+00:00   0.038       
  2021-06-21 20:00:00+00:00   -0.11       
  2021-06-21 21:00:00+00:00   -0.229      
  2021-06-21 22:00:00+00:00   -0.313      
  2021-06-21 23:00:00+00:00   -0.357      
  2021-06-22 00:00:00+00:00   -0.354      

╭───────────────────────────────────────────────────────────╮
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │
│ 2021-06-20 00:00  Hourly       2021-06-22 00:00  UTC      │
╰───────────────────────────────────────────────────────────╯
╭─────────────────────────────────────────────────────────╮  
│ Position  longitude, latitude = 0.151, 0.8, Unitless    │  
│ Algorithms  Timing : NOAA, Zone : UTC, Positioning : NA │  
╰───────────────────────────────────────────── Reference ─╯  
╭───────────────╮                                            
│  ⦩  Altitude  │                                            
│               │                                            
╰────── Legend ─╯                                            

Solar azimuth

Compute the solar azimuth over a period of time:

pvgis position azimuth \
8.628 45.812 \
--start-time '2021-06-20' \
--end-time '2021-06-22'
          Solar Azimuth Series           

  Time                        ⭮ Azimuth  
 ─────────────────────────────────────── 
  2021-06-20 00:00:00+00:00   0.146      
  2021-06-20 01:00:00+00:00   0.393      
  2021-06-20 02:00:00+00:00   0.624      
  2021-06-20 03:00:00+00:00   0.834      
  2021-06-20 04:00:00+00:00   1.028      
  2021-06-20 05:00:00+00:00   1.202      
  2021-06-20 06:00:00+00:00   1.374      
  2021-06-20 07:00:00+00:00   1.552      
  2021-06-20 08:00:00+00:00   1.751      
  2021-06-20 09:00:00+00:00   2.0        
  2021-06-20 10:00:00+00:00   2.35       
  2021-06-20 11:00:00+00:00   2.868      
  2021-06-20 12:00:00+00:00   3.483      
  2021-06-20 13:00:00+00:00   3.98       
  2021-06-20 14:00:00+00:00   4.315      
  2021-06-20 15:00:00+00:00   4.556      
  2021-06-20 16:00:00+00:00   4.752      
  2021-06-20 17:00:00+00:00   4.929      
  2021-06-20 18:00:00+00:00   5.101      
  2021-06-20 19:00:00+00:00   5.275      
  2021-06-20 20:00:00+00:00   5.472      
  2021-06-20 21:00:00+00:00   5.685      
  2021-06-20 22:00:00+00:00   5.918      
  2021-06-20 23:00:00+00:00   6.166      
  2021-06-21 00:00:00+00:00   0.145      
  2021-06-21 01:00:00+00:00   0.392      
  2021-06-21 02:00:00+00:00   0.623      
  2021-06-21 03:00:00+00:00   0.833      
  2021-06-21 04:00:00+00:00   1.028      
  2021-06-21 05:00:00+00:00   1.202      
  2021-06-21 06:00:00+00:00   1.373      
  2021-06-21 07:00:00+00:00   1.551      
  2021-06-21 08:00:00+00:00   1.75       
  2021-06-21 09:00:00+00:00   1.999      
  2021-06-21 10:00:00+00:00   2.349      
  2021-06-21 11:00:00+00:00   2.866      
  2021-06-21 12:00:00+00:00   3.481      
  2021-06-21 13:00:00+00:00   3.979      
  2021-06-21 14:00:00+00:00   4.314      
  2021-06-21 15:00:00+00:00   4.556      
  2021-06-21 16:00:00+00:00   4.752      
  2021-06-21 17:00:00+00:00   4.928      
  2021-06-21 18:00:00+00:00   5.1        
  2021-06-21 19:00:00+00:00   5.274      
  2021-06-21 20:00:00+00:00   5.471      
  2021-06-21 21:00:00+00:00   5.684      
  2021-06-21 22:00:00+00:00   5.917      
  2021-06-21 23:00:00+00:00   6.165      
  2021-06-22 00:00:00+00:00   0.144      

╭───────────────────────────────────────────────────────────╮
│ ⏳ Start Time     ⏱ Frequency  ⌛ End Time       Timezone │
│ 2021-06-20 00:00  Hourly       2021-06-22 00:00  UTC      │
╰───────────────────────────────────────────────────────────╯
╭─────────────────────────────────────────────────────────╮  
│ Position  longitude, latitude = 0.151, 0.8, Unitless    │  
│ Algorithms  Timing : NOAA, Zone : UTC, Positioning : NA │  
│ Definitions  Azimuth origin : North                     │  
╰───────────────────────────────────────────── Reference ─╯  
╭──────────────╮                                             
│  ⭮  Azimuth  │                                             
│              │                                             
│              │                                             
╰───── Legend ─╯