Efficiency
Use power efficiency to estimate the photovoltaic conversion efficiency
series from irradiance and spectral-factor inputs, with optional temperature
and wind-speed series.
To inspect the command and all available arguments:
Usage: pvgis power efficiency [OPTIONS] {irradiance_series}...
Calculate the efficiency of a photovoltaic system
╭─ External solar irradiance time series ──────────────────────────────────────────────────────────────────────────────╮
│ * irradiance_series <float> Irradiance series [required] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --standard-test-temperature <float> [default: 14] │
│ --resample-large-series --no-resample-large-series [default: no-resample-large-series] │
│ --log -l <int> Enable logging [default: 0] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Solar irradiance spectrum ──────────────────────────────────────────────────────────────────────────────────────────╮
│ --spectral-factor-series <parse_spectral_factor_series> Spectral factor time series │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ External meteorological time series ────────────────────────────────────────────────────────────────────────────────╮
│ --temperature-series <parse_temperature_series> Ambient temperature time series [default: 14] │
│ --wind-speed-series <parse_wind_speed_series> Ambient wind_speed time series [default: 0] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Photovoltaic efficiency ────────────────────────────────────────────────────────────────────────────────────────────╮
│ --photovoltaic-module <csi:free standing 2025|csi:integrated Technology and type of the photovoltaic │
│ 2025|csi:free module │
│ standing|csi:integrated|cis:free [default: cSi:Free standing 2025] │
│ standing|cis:integrated|cdte:free │
│ standing|cdte:integrated> │
│ --power-model -pm <none|iv|huld 2011> Algorithms for calculation of the PV power │
│ output of a photovoltaic system as a │
│ function of total irradiance and │
│ temperature │
│ [default: Huld 2011] │
│ --temperature-model -tm <none|faiman> Algorithms for calculation of the effect │
│ of temperature on the power output of a │
│ photovoltaic system as a function of │
│ temperature and optionally wind speed │
│ [default: Faiman] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ > Input : < Output ─────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --rounding-places -r <int> Number of digits to round results to [default: 3] │
│ --csv <path> CSV output filename │
│ --verbose -v <int> Show details while executing commands [default: 0] │
│ --index,--idx -i Index rows in output table (meaningful with at least 1x -v) │
│ --quiet Do not print out the output │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Statistics ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --statistics --no-statistics Calculate and display summary statistics [default: no-statistics] │
│ --groupby <str> Group statistics, ex. M or 3h. A number and date/time unit : (Y)ear, │
│ (S)eason, (M)onth, (D)ay, (W)eek, (h)our. See Xarray's group-by │
│ operations. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Plotting ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --uniplot --no-uniplot Plot the PV power output time series in the terminal │
│ [default: no-uniplot] │
│ --terminal-width-fraction <float> Fraction of number of columns of the current terminal, ex. 0.9 │
│ [default: 0.9] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Metadata ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --fingerprint,--fp Fingerprint the output time series │
│ --metadata --no-metadata Print command metadata [default: no-metadata] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Minimal usage pattern¶
This command expects irradiance values as positional inputs. You can also provide optional series and model-selection options.
Verbose output example¶
Usage: pvgis power efficiency [OPTIONS] {irradiance_series}...
Calculate the efficiency of a photovoltaic system
╭─ External solar irradiance time series ──────────────────────────────────────────────────────────────────────────────╮
│ * irradiance_series <float> Irradiance series [required] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --standard-test-temperature <float> [default: 14] │
│ --resample-large-series --no-resample-large-series [default: no-resample-large-series] │
│ --log -l <int> Enable logging [default: 0] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Solar irradiance spectrum ──────────────────────────────────────────────────────────────────────────────────────────╮
│ --spectral-factor-series <parse_spectral_factor_series> Spectral factor time series │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ External meteorological time series ────────────────────────────────────────────────────────────────────────────────╮
│ --temperature-series <parse_temperature_series> Ambient temperature time series [default: 14] │
│ --wind-speed-series <parse_wind_speed_series> Ambient wind_speed time series [default: 0] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Photovoltaic efficiency ────────────────────────────────────────────────────────────────────────────────────────────╮
│ --photovoltaic-module <csi:free standing 2025|csi:integrated Technology and type of the photovoltaic │
│ 2025|csi:free module │
│ standing|csi:integrated|cis:free [default: cSi:Free standing 2025] │
│ standing|cis:integrated|cdte:free │
│ standing|cdte:integrated> │
│ --power-model -pm <none|iv|huld 2011> Algorithms for calculation of the PV power │
│ output of a photovoltaic system as a │
│ function of total irradiance and │
│ temperature │
│ [default: Huld 2011] │
│ --temperature-model -tm <none|faiman> Algorithms for calculation of the effect │
│ of temperature on the power output of a │
│ photovoltaic system as a function of │
│ temperature and optionally wind speed │
│ [default: Faiman] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ > Input : < Output ─────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --rounding-places -r <int> Number of digits to round results to [default: 3] │
│ --csv <path> CSV output filename │
│ --verbose -v <int> Show details while executing commands [default: 0] │
│ --index,--idx -i Index rows in output table (meaningful with at least 1x -v) │
│ --quiet Do not print out the output │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Statistics ─────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --statistics --no-statistics Calculate and display summary statistics [default: no-statistics] │
│ --groupby <str> Group statistics, ex. M or 3h. A number and date/time unit : (Y)ear, │
│ (S)eason, (M)onth, (D)ay, (W)eek, (h)our. See Xarray's group-by │
│ operations. │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Plotting ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --uniplot --no-uniplot Plot the PV power output time series in the terminal │
│ [default: no-uniplot] │
│ --terminal-width-fraction <float> Fraction of number of columns of the current terminal, ex. 0.9 │
│ [default: 0.9] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Metadata ───────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --fingerprint,--fp Fingerprint the output time series │
│ --metadata --no-metadata Print command metadata [default: no-metadata] │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Use -v (or more vs) when running real inputs to print a detailed table,
and add --fingerprint when you want reproducible output checks.