PV modelling#

class space_pv_pvmodel.DeSotoParameters(alpha_sc: 'float', a_ref: 'float', i_l_ref: 'float', i_o_ref: 'float', r_sh_ref: 'float', r_s: 'float', eg_ref: 'float' = 1.121, degdt: 'float' = -0.0002677)[source]#
Parameters:
alpha_sc: float#
a_ref: float#
i_l_ref: float#
i_o_ref: float#
r_sh_ref: float#
r_s: float#
eg_ref: float#
degdt: float#
class space_pv_pvmodel.PvwattsReference(pdc0_w, gamma_pdc_per_c, reference_irradiance_w_m2=1361.0, reference_temperature_c=25.0)[source]#

Calibrated BOL DC reference for a spacecraft panel/array.

pdc0_w is defined at reference_irradiance_w_m2 and reference_temperature_c. For space PV, this is intentionally a calibration contract instead of assuming a terrestrial STC reference is physically meaningful for every cell technology.

Parameters:
  • pdc0_w (float)

  • gamma_pdc_per_c (float)

  • reference_irradiance_w_m2 (float)

  • reference_temperature_c (float)

pdc0_w: float#
gamma_pdc_per_c: float#
reference_irradiance_w_m2: float#
reference_temperature_c: float#
space_pv_pvmodel.effective_irradiance_w_m2(am0_irradiance_w_m2, illumination_fraction, cosine_aoi, *, spectral_factor=1.0, optical_factor=1.0)[source]#

Convert space environment/geometry state into cell-effective irradiance.

Parameters:
Return type:

ndarray

space_pv_pvmodel.pvwatts_dc_space(effective_irradiance, cell_temperature_c, reference)[source]#

Use pvlib’s PVWatts DC equation with an explicit space reference irradiance.

This is a calibrated engineering baseline, not a multi-junction radiation model.

Parameters:
Return type:

ndarray

space_pv_pvmodel.pvwatts_loss_chain(reference, *, am0_irradiance_w_m2=1361.0, illumination_fraction=1.0, cosine_aoi=1.0, spectral_factor=1.0, optical_factor=1.0, cell_temperature_c=25.0, degradation_factor=1.0, mismatch_factor=1.0, wiring_efficiency=1.0, conversion_efficiency=1.0, power_limit_w=None, availability_factor=1.0, curtailment_factor=1.0)[source]#

Return a transparent sequence of modeled PV power stages, in watts.

reference specifies beginning-of-life (BOL) array DC power at its reference irradiance and cell temperature. That calibration already includes inherent cell and coverglass efficiencies: optical_factor represents an additional transmission factor relative to that reference, not another multiplication by the cell efficiency or BOL coverglass loss.

Inputs are finite scalars or nonempty one-dimensional arrays. Scalars and length-one arrays broadcast to the common sample count. Pandas Series must have identical indexes; their shared index is preserved, without sorting or label alignment. An indexed length-one Series cannot be broadcast onto a larger positional array. With no Series inputs, use a RangeIndex.

AM0 irradiance and reference.pdc0_w must be nonnegative; reference irradiance must be positive. All fractional inputs are in [0, 1], except spectral_factor, which must be positive and may exceed one. The temperature multiplier 1 + gamma * (Tcell - Tref) may produce a gain but cannot be negative. Values outside these domains are rejected rather than clipped. Zero irradiance, full eclipse and zero available power are valid. power_limit_w=None disables clipping; a finite nonnegative scalar or per-sample limit caps power after electrical conversion.

The returned columns, in sequence, are reference_power_w, after_irradiance_w, after_eclipse_w, after_pointing_w, after_spectral_w, after_optical_w, after_temperature_w, after_degradation_w, after_mismatch_w, after_wiring_w, after_conversion_w, after_clipping_w, after_availability_w, and modeled_power_w (after curtailment). The temperature stage calls pvwatts_dc_space() with the accumulated effective irradiance.

Through after_wiring_w, power is on the array DC side. Conversion is a generic DC/DC or other chosen electronics boundary; it does not imply a terrestrial AC inverter. The cap, availability and curtailment apply on that output side. Compare measurements at the same electrical boundary. Battery storage, spacecraft loads and converter standby consumption are not modeled. Set post-array factors to one and omit the cap for an array DC-only comparison.

Factors are supplied assumptions or independently established states, not inferred diagnoses. Differences between consecutive stages provide an order-dependent accounting, not unique causal attribution. Irradiance, spectral and temperature changes can create signed gains relative to the reference. This is the existing calibrated PVWatts engineering baseline, not a multi-junction spectral or radiation-damage model.

See also

pvwatts_dc_space

PVWatts DC equation with a space irradiance reference.

References

Parameters:
  • reference (PvwattsReference)

  • am0_irradiance_w_m2 (NumericInput)

  • illumination_fraction (NumericInput)

  • cosine_aoi (NumericInput)

  • spectral_factor (NumericInput)

  • optical_factor (NumericInput)

  • cell_temperature_c (NumericInput)

  • degradation_factor (NumericInput)

  • mismatch_factor (NumericInput)

  • wiring_efficiency (NumericInput)

  • conversion_efficiency (NumericInput)

  • power_limit_w (NumericInput | None)

  • availability_factor (NumericInput)

  • curtailment_factor (NumericInput)

Return type:

DataFrame

space_pv_pvmodel.single_diode_points(effective_irradiance_w_m2, cell_temperature_c, params)[source]#

pvlib De Soto + single-diode reference path for single-junction cells.

This is deliberately separated from multi-junction space-cell modeling. It is useful for silicon/single-junction experiments, model validation, and as a familiar pvlib baseline, but it should not be presented as a native III-V multi-junction model.

Parameters:
Return type:

dict[str, ndarray]

Reference model#

class space_pv_pvmodel.model.PvwattsReference(pdc0_w, gamma_pdc_per_c, reference_irradiance_w_m2=1361.0, reference_temperature_c=25.0)[source]#

Calibrated BOL DC reference for a spacecraft panel/array.

pdc0_w is defined at reference_irradiance_w_m2 and reference_temperature_c. For space PV, this is intentionally a calibration contract instead of assuming a terrestrial STC reference is physically meaningful for every cell technology.

Parameters:
  • pdc0_w (float)

  • gamma_pdc_per_c (float)

  • reference_irradiance_w_m2 (float)

  • reference_temperature_c (float)

space_pv_pvmodel.model.effective_irradiance_w_m2(am0_irradiance_w_m2, illumination_fraction, cosine_aoi, *, spectral_factor=1.0, optical_factor=1.0)[source]#

Convert space environment/geometry state into cell-effective irradiance.

Parameters:
Return type:

ndarray

space_pv_pvmodel.model.pvwatts_dc_space(effective_irradiance, cell_temperature_c, reference)[source]#

Use pvlib’s PVWatts DC equation with an explicit space reference irradiance.

This is a calibrated engineering baseline, not a multi-junction radiation model.

Parameters:
Return type:

ndarray

Sequential power model#

Explicit sequential power stages for a calibrated spacecraft PV baseline.

space_pv_pvmodel.losses.pvwatts_loss_chain(reference, *, am0_irradiance_w_m2=1361.0, illumination_fraction=1.0, cosine_aoi=1.0, spectral_factor=1.0, optical_factor=1.0, cell_temperature_c=25.0, degradation_factor=1.0, mismatch_factor=1.0, wiring_efficiency=1.0, conversion_efficiency=1.0, power_limit_w=None, availability_factor=1.0, curtailment_factor=1.0)[source]#

Return a transparent sequence of modeled PV power stages, in watts.

reference specifies beginning-of-life (BOL) array DC power at its reference irradiance and cell temperature. That calibration already includes inherent cell and coverglass efficiencies: optical_factor represents an additional transmission factor relative to that reference, not another multiplication by the cell efficiency or BOL coverglass loss.

Inputs are finite scalars or nonempty one-dimensional arrays. Scalars and length-one arrays broadcast to the common sample count. Pandas Series must have identical indexes; their shared index is preserved, without sorting or label alignment. An indexed length-one Series cannot be broadcast onto a larger positional array. With no Series inputs, use a RangeIndex.

AM0 irradiance and reference.pdc0_w must be nonnegative; reference irradiance must be positive. All fractional inputs are in [0, 1], except spectral_factor, which must be positive and may exceed one. The temperature multiplier 1 + gamma * (Tcell - Tref) may produce a gain but cannot be negative. Values outside these domains are rejected rather than clipped. Zero irradiance, full eclipse and zero available power are valid. power_limit_w=None disables clipping; a finite nonnegative scalar or per-sample limit caps power after electrical conversion.

The returned columns, in sequence, are reference_power_w, after_irradiance_w, after_eclipse_w, after_pointing_w, after_spectral_w, after_optical_w, after_temperature_w, after_degradation_w, after_mismatch_w, after_wiring_w, after_conversion_w, after_clipping_w, after_availability_w, and modeled_power_w (after curtailment). The temperature stage calls pvwatts_dc_space() with the accumulated effective irradiance.

Through after_wiring_w, power is on the array DC side. Conversion is a generic DC/DC or other chosen electronics boundary; it does not imply a terrestrial AC inverter. The cap, availability and curtailment apply on that output side. Compare measurements at the same electrical boundary. Battery storage, spacecraft loads and converter standby consumption are not modeled. Set post-array factors to one and omit the cap for an array DC-only comparison.

Factors are supplied assumptions or independently established states, not inferred diagnoses. Differences between consecutive stages provide an order-dependent accounting, not unique causal attribution. Irradiance, spectral and temperature changes can create signed gains relative to the reference. This is the existing calibrated PVWatts engineering baseline, not a multi-junction spectral or radiation-damage model.

See also

pvwatts_dc_space

PVWatts DC equation with a space irradiance reference.

References

Parameters:
  • reference (PvwattsReference)

  • am0_irradiance_w_m2 (NumericInput)

  • illumination_fraction (NumericInput)

  • cosine_aoi (NumericInput)

  • spectral_factor (NumericInput)

  • optical_factor (NumericInput)

  • cell_temperature_c (NumericInput)

  • degradation_factor (NumericInput)

  • mismatch_factor (NumericInput)

  • wiring_efficiency (NumericInput)

  • conversion_efficiency (NumericInput)

  • power_limit_w (NumericInput | None)

  • availability_factor (NumericInput)

  • curtailment_factor (NumericInput)

Return type:

DataFrame

Single-diode / De Soto adapter#

class space_pv_pvmodel.desoto.DeSotoParameters(alpha_sc: 'float', a_ref: 'float', i_l_ref: 'float', i_o_ref: 'float', r_sh_ref: 'float', r_s: 'float', eg_ref: 'float' = 1.121, degdt: 'float' = -0.0002677)[source]#
Parameters:
space_pv_pvmodel.desoto.single_diode_points(effective_irradiance_w_m2, cell_temperature_c, params)[source]#

pvlib De Soto + single-diode reference path for single-junction cells.

This is deliberately separated from multi-junction space-cell modeling. It is useful for silicon/single-junction experiments, model validation, and as a familiar pvlib baseline, but it should not be presented as a native III-V multi-junction model.

Parameters:
Return type:

dict[str, ndarray]