Plots
Overview¶
With pvgis we can generate plots : images that we can re-use or
plot directly in the terminal for uninterrupted interactive work.
-
Plot
-
use the command
series+ subcommandplot -
arbitrary single or multiple time series
-
user defined output filename
-
support for Tufte styled output
-
-
Uniplot in the terminal !
- Use the
--uniplotflag - Support for single and multiple series
- Adjust output width via the
--terminal-width-fractionflag
- Use the
Time series¶
pvgis series plot \
data/sample_era5landplus_t2m_over_esti.nc \
8.628 45.812 \
--neighbor-lookup nearest \
--start-time '2014-01-01' \
--end-time '2024-12-31' \
--tufte-style \
--output-filename './docs/images/example_series_plot' \
--no-variable-name-as-suffix
You can find the newly generated plot in your current working directory.
Uniplot¶
A day of power output¶
We can plot in the terminal the photovoltaic power for a single day
pvgis power broadband \
8.628 45.812 214 \
--start-time '2010-01-27' \
--end-time '2010-01-28' \
--uniplot
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,355.824,567.679,708.142,781.262,789.574,733.395,610.732,417.878,146.652,0.0,0.0,0.0,0.0,
0.0,0.0,0.0,0.0
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▄▞▀▀▀▀▀▄▄ │
│ ▄▞▀ ▀▚▖ │
│ ▗▀ ▝▚ │
│ ▞▘ ▀▄ │
│ ▗▀ ▚ │ 600 W
│ ▗▘ ▚ │
│ ▗▘ ▚▖ │
│ ▗▘ ▝▖ │
│ ▗▘ ▜ │ 400 W
│ ▗▘ ▚ │
│ ▞ ▚ │
│ ▐ ▝▖ │
│ ▌ ▝▖ │ 200 W
│ ▞ ▐▖ │
│ ▗▘ ▝▄ │
│ ▞ ▚▖ │
│▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▟▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▝▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2010-01-27 2010-01-27T06:00 2010-01-27T12:00 2010-01-27T18:00 2010-01-28
██ Photovoltaic Power
A year of power output¶
For a horizontally flat panel, we get
pvgis power broadband \
8.628 45.812 214 180 0.000001 \
--start-time '2010-01-01' \
--end-time '2010-12-31' \
--quiet \
--uniplot
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▄▄▄▄▄▟███████████████▄▄▄▄▄▄ │
│ ▄▄▄█████████████████████████████████▙▄▄▖ │ 750 W
│ ▄▄████████████████████████████████████████████▄▄ │
│ ▗▄▟███████████████████████████████████████████████████▄▄ │
│ ▗▄██████████████████████████████████████████████████████████▙▄ │
│ ▗▄████████████████████████████████████████████████████████████████▙▖ │
│ ▄██████████████████████████████████████████████████████████████████████▄▖ │ 500 W
│ ▄▟███████████████████████████████████████████████████████████████████████████▄▖ │
│ ▄▄█████████████████████████████████████████████████████████████████████████████████▄▖ │
│ ▄▟███████████████████████████████████████████████████████████████████████████████████████▙▄ │
│▄▄▄▄███████████████████████████████████████████████████████████████████████████████████████████████▙▄▄▄▖ │
│███████████████████████████████████████████████████████████████████████████████████████████████████████████▙│ 250 W
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2010-01 2010-03 2010-05 2010-07 2010-09 2010-11
██ Photovoltaic Power
Use the --quiet option
Large time series will take some time to print in the command line. It's
really useful to use the --quiet flag.
Let's change the tilt to 30 degrees
pvgis power broadband \
8.628 45.812 214 180 30 \
--start-time '2010-01-01' \
--end-time '2010-12-31' \
--quiet \
--uniplot
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▄▄▄▄▄▄████████████████████▄▄▄▄▄▄▄▄▄▄██████████▄▄▄▄▄▄▄▄▄▖ │
│ ▄▄▟██████████████████████████████████████████████████████████████▙▄▄▖ │
│ ▗▄▄██████████████████████████████████████████████████████████████████████████▙▄▖ │
│ ▗▄▄▟███████████████████████████████████████████████████████████████████████████████████▙▄▄ │
│▄▄▄▄███████████████████████████████████████████████████████████████████████████████████████████████▄▄▄▄▄▄▄▄▖│
│███████████████████████████████████████████████████████████████████████████████████████████████████████████▙│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│ 500 W
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2010-01 2010-03 2010-05 2010-07 2010-09 2010-11
██ Photovoltaic Power
and then to 45 -- at the same time, we can ask for a simplification of the plot
via the --resample-large-series option
pvgis power broadband \
8.628 45.812 214 180 45 \
--start-time '2010-01-01' \
--end-time '2010-12-31' \
--quiet \
--uniplot \
--resample-large-series
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▄▄▞▀▀▀▚▄▄▄▄▄ ▄ │
│ ▗▄▄▀▀▀ ▀▀▀▀▀▄▄▄▄ ▄▄▄▄▄▞▀▀▀▀ ▀▀▀▀▀▀▀▀▀▚▄ │
│ ▗▞▘ ▀▀▀▀▀▀▀▀▀▀▀▀▘ ▀▄▖ │
│ ▗▞▘ ▝▚▄ │
│ ▄▘ ▀▄▖ │
│ ▄▀ ▝▚ │ 250 W
│ ▄▀ ▀▖ │
│ ▗▛ ▝▚ │
│ ▗▘ ▚▖ │
│ ▄▘ ▝▄ │
│ ▞ ▚ │
│ ▗▀ ▀▖ │
│ ▗▘ ▝▚▄ │
│ ▞▘ ▀▄ │
│▞ ▀▄ │ 200 W
│ ▀▄ │
│ ▀▄│
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2010-03 2010-05 2010-07 2010-09 2010-11
██ Photovoltaic Power
A day of solar incidence angles¶
pvgis position overview \
8.628 45.812 \
--start-time '2010-01-17' \
--end-time '2010-01-18' \
-aou degrees \
--quiet \
--uniplot
Uniplot
Solar Position observed from (longitude, latitude) 8.628, 45.812000000000005
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▄▄▀▌ │
│ ▄▄▄▀▀ ▐ │
│ ▄▄▄▄▞▀▀▀ ▝▖ │
│ ▄▄▄▄▄▞▀▀▀▀▀ ▌ │ 250 Unitless
│ ▗▄▄▄▄▞▀▀▀▀▘ ▐ │
│ ▄▄▄▄▀▀▀▀▘ ▝▖ │
│ ▗▄▄▄▞▀▀▀ ▌ │
│ ▄▄▄▄▀▀▀▘ ▐ │
│ ▄▄▄▄▄▀▀▀▀ ▝▖ │
│ ▗▄▄▄▄▄▀▀▀▀▀ ▌ │
│ ▗▄▄▄▄▞▀▀▀▀▘ ▐ │
│ ▄▄▄▀▀▀▘ ▄▖ ▗▄▄▄▄▀▄ ▝▖│
│ ▗▄▞▀▀ ▄▀ ▝▀▀▀▀▄▄▄▄▄▖ ▄▄▄▄▄▀▀▀▀▘ ▚▖ ▌│
│▞▀▘ ▄▗▄▄▄▄▄▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▚▄▄▄▄▄▄▄ ▝▚ ▐│
│▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▄▄▄▄▄▞▀▀▀▀▀▘▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▀▀▀▀▀▚▄▄▄▄▄▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀│ 0 Unitless
│ ▗▄▄▄▄▄▀▀▀▀▀ ▀▀▀▀▀▚▄▄▄▄▄ │
│▄▄▄▄▄▀▀▀▀▀▀▘ ▀▀▀▀▀▀▄▄▄▄▄▄▄▄▄│
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2010-01-17 2010-01-17T06:00 2010-01-17T12:00 2010-01-17T18:00 2010-01-18
██ Sun-Vector-to-Surface-Normal Incidence (Iqbal) ██ altitude ██ azimuth North
Reading external time series data¶
We can repeat the same task by using SARAH-3 products for the global and direct horizontal irradiance components
pvgis power broadband \
8.628 45.812 214 180 35 \
--start-time '2014-01-27' \
--end-time '2014-01-28' \
--global-horizontal-irradiance data/sample_sarah3_sis_over_esti.nc \
--direct-horizontal-irradiance data/sample_sarah3_sid_over_esti.nc \
--neighbor-lookup nearest \
--uniplot
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,49.14,94.372,143.39,130.623,185.11,101.104,156.01,300.481,0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.
0,0.0
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▙ │
│ ▐▐ │
│ ▌▝▖ │ 250 W
│ ▞ ▌ │
│ ▗▘ ▚ │
│ ▞ ▐ │
│ ▗▖ ▗▘ ▌ │
│ ▞▘▝▖ ▌ ▌ │
│ ▄ ▗▀ ▝▖ ▗▞ ▐ │
│ ▄▀ ▀▀▀▟▘ ▝▖ ▄▘ ▐ │
│ ▗▞ ▝▖▞ ▌ │
│ ▟▘ ▀ ▚ │
│ ▄▀ ▐ │
│ ▄▀ ▝▖ │
│ ▗▞▘ ▌ │
│ ▞▘ ▚ │
│▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▀▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▐▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2014-01-27 2014-01-27T06:00 2014-01-27T12:00 2014-01-27T18:00 2014-01-28
██ Photovoltaic Power
or indeed use also ERA5 time series data for ambient temperature and wind speed
pvgis power broadband \
8.628 45.812 214 180 35 \
--start-time '2014-01-27' \
--end-time '2014-01-28' \
--global-horizontal-irradiance data/sample_sarah3_sis_over_esti.nc \
--direct-horizontal-irradiance data/sample_sarah3_sid_over_esti.nc \
--temperature-series data/sample_era5landplus_t2m_over_esti.nc \
--wind-speed-series data/sample_era5landplus_wind_speed_2m_over_esti.nc \
--neighbor-lookup nearest \
--uniplot
0.0,0.0,0.0,0.0,0.0,0.0,0.0,0.0,50.942,97.617,147.32,133.829,189.09,103.334,159.525,308.753,0.0,0.0,0.0,0.0,0.0,0.0,0.0,
0.0,0.0
Uniplot
PV Power observed from (longitude, latitude) 0.15058700786207074, 0.7995702369236423
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ ▙ │
│ ▐▐ │
│ ▌▝▖ │
│ ▞ ▌ │ 250 W
│ ▗▘ ▚ │
│ ▞ ▐ │
│ ▗▖ ▗▘ ▌ │
│ ▞▘▝▖ ▌ ▌ │
│ ▄ ▗▀ ▝▖ ▞ ▐ │
│ ▄▀ ▀▀▀▟▘ ▝▖ ▗▀ ▐ │
│ ▗▞ ▝▖▞▘ ▌ │
│ ▗▟▘ ▀ ▚ │
│ ▄▘ ▐ │
│ ▄▀ ▝▖ │
│ ▗▞▘ ▌ │
│ ▞▘ ▚ │
│▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▀▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▐▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2014-01-27 2014-01-27T06:00 2014-01-27T12:00 2014-01-27T18:00 2014-01-28
██ Photovoltaic Power
Neighbor lookup?
When reading data from external time series data,
it is rather rare that the requested location coordinates truely exist as a
data record. Most likely, we need to ask for the location in the data that
is nearest to the coordinates of our interest. There are also other methods
for inexact location lookups available through the --neighbor-lookup
option.
Multi-year series¶
Or for 20 years
pvgis power broadband \
8 45 214 \
--start-time '2000-01-01' \
--end-time '2020-12-31' \
--quiet \
--uniplot
Uniplot
PV Power observed from (longitude, latitude) 0.13962634015954636, 0.7853981633974483
┌────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ █▖▟▌ █▌▟▙ █▙▗▙ ▟▙▗▙ ▟▙▗█ ▐▙▗█▖▐█ █▖▗█▖▟▖▗█▖▟▌ █▖▟▌ █▌▟▙ █▌▗▙ ▟▙▗▙ ▟▙▗█ ▐▙▗█ ▐█▗█▖▗█▖▟▖▗█▖▟▌ █▖▟▌ █▌▟▙ █▌▐▙ │
│▐████▗████▗████▖████▖████▌████▌▟███▌▟███▙▐████▐████▐████▗████▖████▖████▌████▌▟███▌▟███▙▐████▐████▐████▗████▖│
│▟████████████████████████▙████████████████████▟████▟███████████████████▙████████████████████▟████▟█████████▙│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│ 500 W
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│
│████████████████████████████████████████████████████████████████████████████████████████████████████████████│ 0 W
└────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
2004 2008 2012 2016 2020
██ Photovoltaic Power
20 years of hourly time series!
Since we ask for 20 years of hourly time series,
it is a good idea to use the --quiet flag!
Else, it is going to take quite some time to print such a large times
series in the terminal.
The --uniplot will still work and this is the idea behind the --quiet
flag.
Multiple series¶
uniplot will also handle multiple series. This is useful for example in the
context of the broadband-multi command.