Overview
Time series¶
To get a time series of solar position parameters over a location, you can use the pvgis-prototype position overview command.
pvgis-prototype position overview \
8.627626 45.812233 \
--start-time '2020-01-01' \
--end-time '2020-01-02' \
-r2 \
-aou degrees
Solar Position Overview
Declinati… Hour Angle Incidence Sun-Horizon Event Time
Time ∢ Zenith ⦭ Altitude ⦩ Azimuth ⭸ Horizon ⛰ ⛰ Visible 👁 Event 🌅 ⏲
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
2020-01-01 00:00:00 -23.06 -172.1 156.36 -66.36 18.41 0.0 0.0 Below False
2020-01-01 01:00:00 -23.06 -157.1 150.64 -60.64 46.94 0.0 0.0 Below False
2020-01-01 02:00:00 -23.06 -142.1 141.89 -51.89 66.35 0.0 0.0 Below False
2020-01-01 03:00:00 -23.06 -127.1 131.88 -41.88 80.34 0.0 0.0 Below False
2020-01-01 04:00:00 -23.06 -112.1 121.46 -31.46 91.68 0.0 0.0 Below False
2020-01-01 05:00:00 -23.06 -97.1 111.09 -21.09 101.86 0.0 0.0 Below False
2020-01-01 06:00:00 -23.06 -82.1 101.08 -11.08 111.79 0.0 0.0 Below False
2020-01-01 07:00:00 -23.06 -67.1 91.61 -1.61 122.23 0.0 0.0 Below False Sunrise 07:06:32
2020-01-01 08:00:00 -23.06 -52.1 83.38 6.62 133.25 55.75 0.0 Above True
2020-01-01 09:00:00 -23.06 -37.1 76.6 13.4 145.37 43.12 0.0 Above True
2020-01-01 10:00:00 -23.06 -22.1 71.69 18.31 158.8 32.0 0.0 Above True
2020-01-01 11:00:00 -23.06 -7.1 69.13 20.87 173.52 24.72 0.0 Above True
2020-01-01 12:00:00 -23.06 7.9 69.2 20.8 187.32 24.94 0.0 Above True
2020-01-01 13:00:00 -23.06 22.9 71.89 18.11 201.95 32.53 0.0 Above True
2020-01-01 14:00:00 -23.05 37.89 76.91 13.09 215.31 43.76 0.0 Above True
2020-01-01 15:00:00 -23.05 52.89 83.76 6.24 227.35 56.43 0.0 Above True
2020-01-01 16:00:00 -23.05 67.88 92.1 -2.1 238.38 0.0 0.0 Below False Sunset 15:50:15
2020-01-01 17:00:00 -23.04 82.88 101.58 -11.58 248.75 0.0 0.0 Below False
2020-01-01 18:00:00 -23.04 97.87 111.61 -21.61 258.67 0.0 0.0 Below False
2020-01-01 19:00:00 -23.04 112.87 121.99 -31.99 268.89 0.0 0.0 Below False
2020-01-01 20:00:00 -23.03 127.86 132.39 -42.39 280.31 0.0 0.0 Below False
2020-01-01 21:00:00 -23.03 142.86 142.36 -52.36 294.51 0.0 0.0 Below False
2020-01-01 22:00:00 -23.03 157.86 151.0 -61.0 314.29 0.0 0.0 Below False
2020-01-01 23:00:00 -23.02 172.85 156.48 -66.48 343.29 0.0 0.0 Below False
2020-01-02 00:00:00 -23.02 -172.15 156.33 -66.33 18.27 0.0 0.0 Below False
⅀ / μ
╭─────────────────────────────────────────────────╮
│ Start Every End Zone │
│ 2020-01-01 00:00 h 2020-01-02 00:00 UTC │
│ │
│ │
╰─────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Location Longitude ϑ, Latitude ϕ = 8.63, 45.81 Angular units radians │
│ Position Surface Orientation ↻: 3.14, Surface Tilt ⦥: 0.79 │
│ Definitions Azimuth origin : North, Incidence angle: Sun-Vector-to-Surface-Normal │
│ Algorithms Timing: Milne1921, Positioning: NOAA, Unrefracted zenith: True, Incidence: Iqbal, Shading: PVGIS │
╰────────────────────────────────────────────────────────────────────────────────────────────────── Reference ─╯
╭───────────────────────────────────────────────────────────────╮
│ - Loss ⦭ Zenith ⛰ Horizon 👁 Visible │
│ ⏲ Timing ⦩ Altitude ↻ Orientation 🌅 Sunrise │
│ ∢ Declination Azimuth ⦥ Tilt 🮞 Shading │
│ Hour angle ⯐ Positioning ⭸ Incidence │
╰────────────────────────────────────────────────────── Legend ─╯
What does this command do ?
The command
pvgis-prototype position overview \
8.627626 45.812233 \
--start-time '2020-01-01' \
--end-time '2020-01-02' \
-r2 \
-aou degrees
does :
- execute
pvgis-prototypecommandpositionand sub-commandoverview -
set
- the longitude to
8.627626and the latitude to45.812233 - the surface (panel) orientation is set by default to
180and the tilt to45degrees - the start time of the period for which to run calculations is
2020-01-01 00:00 - the end time of the period in question is
2020-01-02 00:00
- the longitude to
-
output
- the numerical output values will be rounded to the 2nd digit
- the angle quantities in
degrees
CSV¶
We can export the results in the widely known and machine readable CSV format
pvgis-prototype position overview \
8.627626 45.812233 \
--start-time '2020-01-01' \
--end-time '2020-01-02' \
-r2 \
-aou degrees \
--csv solar_incidence_angle_sample.csv
Solar Position Overview
Declinati… Hour Angle Incidence Sun-Horizon Event Time
Time ∢ Zenith ⦭ Altitude ⦩ Azimuth ⭸ Horizon ⛰ ⛰ Visible 👁 Event 🌅 ⏲
──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
2020-01-01 00:00:00 -23.06 -172.1 156.36 -66.36 18.41 0.0 0.0 Below False
2020-01-01 01:00:00 -23.06 -157.1 150.64 -60.64 46.94 0.0 0.0 Below False
2020-01-01 02:00:00 -23.06 -142.1 141.89 -51.89 66.35 0.0 0.0 Below False
2020-01-01 03:00:00 -23.06 -127.1 131.88 -41.88 80.34 0.0 0.0 Below False
2020-01-01 04:00:00 -23.06 -112.1 121.46 -31.46 91.68 0.0 0.0 Below False
2020-01-01 05:00:00 -23.06 -97.1 111.09 -21.09 101.86 0.0 0.0 Below False
2020-01-01 06:00:00 -23.06 -82.1 101.08 -11.08 111.79 0.0 0.0 Below False
2020-01-01 07:00:00 -23.06 -67.1 91.61 -1.61 122.23 0.0 0.0 Below False Sunrise 07:06:32
2020-01-01 08:00:00 -23.06 -52.1 83.38 6.62 133.25 55.75 0.0 Above True
2020-01-01 09:00:00 -23.06 -37.1 76.6 13.4 145.37 43.12 0.0 Above True
2020-01-01 10:00:00 -23.06 -22.1 71.69 18.31 158.8 32.0 0.0 Above True
2020-01-01 11:00:00 -23.06 -7.1 69.13 20.87 173.52 24.72 0.0 Above True
2020-01-01 12:00:00 -23.06 7.9 69.2 20.8 187.32 24.94 0.0 Above True
2020-01-01 13:00:00 -23.06 22.9 71.89 18.11 201.95 32.53 0.0 Above True
2020-01-01 14:00:00 -23.05 37.89 76.91 13.09 215.31 43.76 0.0 Above True
2020-01-01 15:00:00 -23.05 52.89 83.76 6.24 227.35 56.43 0.0 Above True
2020-01-01 16:00:00 -23.05 67.88 92.1 -2.1 238.38 0.0 0.0 Below False Sunset 15:50:15
2020-01-01 17:00:00 -23.04 82.88 101.58 -11.58 248.75 0.0 0.0 Below False
2020-01-01 18:00:00 -23.04 97.87 111.61 -21.61 258.67 0.0 0.0 Below False
2020-01-01 19:00:00 -23.04 112.87 121.99 -31.99 268.89 0.0 0.0 Below False
2020-01-01 20:00:00 -23.03 127.86 132.39 -42.39 280.31 0.0 0.0 Below False
2020-01-01 21:00:00 -23.03 142.86 142.36 -52.36 294.51 0.0 0.0 Below False
2020-01-01 22:00:00 -23.03 157.86 151.0 -61.0 314.29 0.0 0.0 Below False
2020-01-01 23:00:00 -23.02 172.85 156.48 -66.48 343.29 0.0 0.0 Below False
2020-01-02 00:00:00 -23.02 -172.15 156.33 -66.33 18.27 0.0 0.0 Below False
⅀ / μ
╭─────────────────────────────────────────────────╮
│ Start Every End Zone │
│ 2020-01-01 00:00 h 2020-01-02 00:00 UTC │
│ │
│ │
╰─────────────────────────────────────────────────╯
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Location Longitude ϑ, Latitude ϕ = 8.63, 45.81 Angular units radians │
│ Position Surface Orientation ↻: 3.14, Surface Tilt ⦥: 0.79 │
│ Definitions Azimuth origin : North, Incidence angle: Sun-Vector-to-Surface-Normal │
│ Algorithms Timing: Milne1921, Positioning: NOAA, Unrefracted zenith: True, Incidence: Iqbal, Shading: PVGIS │
╰────────────────────────────────────────────────────────────────────────────────────────────────── Reference ─╯
╭───────────────────────────────────────────────────────────────╮
│ - Loss ⦭ Zenith ⛰ Horizon 👁 Visible │
│ ⏲ Timing ⦩ Altitude ↻ Orientation 🌅 Sunrise │
│ ∢ Declination Azimuth ⦥ Tilt 🮞 Shading │
│ Hour angle ⯐ Positioning ⭸ Incidence │
╰────────────────────────────────────────────────────── Legend ─╯
╭─ CSV output ───────────────────────────────────────────────╮
│ │
│ 📁 File solar_incidence_angle_sample.csv │
│ _ Rows 25 │
│ | Columns 17 │
│ │
╰────────────────────────────────────────────────────────────╯
Let's verify it worked well
solar_incidence_angle_sample.csv
| Longitude | Latitude | Time | Zone | Local Time | Local Zone | Timing | Declination | Hour Angle | Positioning | Zenith | Altitude | Azimuth | Incidence | Units |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 8.62763 | 45.8122 | 2020-01-01 00:00:00 | UTC | 0 | UTC | NOAA | -23.0586 | -172.1 | NOAA | 156.358 | -66.3585 | 18.41 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 01:00:00 | UTC | 1 | UTC | NOAA | -23.0586 | -157.1 | NOAA | 150.645 | -60.6455 | 46.9333 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 02:00:00 | UTC | 2 | UTC | NOAA | -23.0586 | -142.1 | NOAA | 141.893 | -51.8933 | 66.3497 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 03:00:00 | UTC | 3 | UTC | NOAA | -23.0586 | -127.1 | NOAA | 131.884 | -41.8837 | 80.3429 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 04:00:00 | UTC | 4 | UTC | NOAA | -23.0586 | -112.1 | NOAA | 121.466 | -31.4661 | 91.6745 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 05:00:00 | UTC | 5 | UTC | NOAA | -23.0586 | -97.1 | NOAA | 111.093 | -21.0927 | 101.857 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 06:00:00 | UTC | 6 | UTC | NOAA | -23.0586 | -82.1 | NOAA | 101.081 | -11.0814 | 111.785 | 7.58535 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 07:00:00 | UTC | 7 | UTC | NOAA | -23.0586 | -67.1 | NOAA | 91.6093 | -1.60927 | 122.225 | 21.3184 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 08:00:00 | UTC | 8 | UTC | NOAA | -23.0586 | -52.1 | NOAA | 83.3759 | 6.62407 | 133.25 | 34.7992 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 09:00:00 | UTC | 9 | UTC | NOAA | -23.0586 | -37.1 | NOAA | 76.5976 | 13.4024 | 145.366 | 47.6751 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 10:00:00 | UTC | 10 | UTC | NOAA | -23.0586 | -22.1 | NOAA | 71.6903 | 18.3097 | 158.8 | 59.0894 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 11:00:00 | UTC | 11 | UTC | NOAA | -23.0586 | -7.1 | NOAA | 69.1306 | 20.8694 | 173.516 | 66.7092 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 12:00:00 | UTC | 12 | UTC | NOAA | -23.0586 | 7.9 | NOAA | 69.202 | 20.798 | 172.679 | 66.4674 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 13:00:00 | UTC | 13 | UTC | NOAA | -23.0555 | 22.8958 | NOAA | 71.8922 | 18.1078 | 158.055 | 58.5504 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 14:00:00 | UTC | 14 | UTC | NOAA | -23.0523 | 37.8917 | NOAA | 76.9078 | 13.0922 | 144.69 | 47.0235 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 15:00:00 | UTC | 15 | UTC | NOAA | -23.0492 | 52.8875 | NOAA | 83.7642 | 6.23582 | 132.646 | 34.1048 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 16:00:00 | UTC | 16 | UTC | NOAA | -23.046 | 67.8792 | NOAA | 92.0987 | -2.09866 | 121.622 | 20.6111 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 17:00:00 | UTC | 17 | UTC | NOAA | -23.0428 | 82.875 | NOAA | 101.574 | -11.574 | 111.256 | 6.87336 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 18:00:00 | UTC | 18 | UTC | NOAA | -23.0396 | 97.8708 | NOAA | 111.607 | -21.6067 | 101.331 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 19:00:00 | UTC | 19 | UTC | NOAA | -23.0364 | 112.867 | NOAA | 121.986 | -31.986 | 91.1127 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 20:00:00 | UTC | 20 | UTC | NOAA | -23.0331 | 127.863 | NOAA | 132.39 | -42.3902 | 79.6869 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 21:00:00 | UTC | 21 | UTC | NOAA | -23.0299 | 142.858 | NOAA | 142.355 | -52.3551 | 65.4962 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 22:00:00 | UTC | 22 | UTC | NOAA | -23.0266 | 157.854 | NOAA | 150.999 | -60.9988 | 45.7064 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-01 23:00:00 | UTC | 23 | UTC | NOAA | -23.0233 | 172.85 | NOAA | 156.482 | -66.4816 | 16.7125 | 0 | degrees |
| 8.62763 | 45.8122 | 2020-01-02 00:00:00 | UTC | 24 | UTC | NOAA | -23.02 | -172.158 | NOAA | 156.334 | -66.3338 | 18.2574 | 0 | degrees |