Source code for space_pv_pvmodel.model

from __future__ import annotations

from dataclasses import dataclass

import numpy as np

from space_pv_core.constants import SOLAR_CONSTANT_W_M2


[docs] @dataclass(frozen=True, slots=True) class PvwattsReference: """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. """ pdc0_w: float gamma_pdc_per_c: float reference_irradiance_w_m2: float = SOLAR_CONSTANT_W_M2 reference_temperature_c: float = 25.0
[docs] def effective_irradiance_w_m2( am0_irradiance_w_m2: float | np.ndarray, illumination_fraction: float | np.ndarray, cosine_aoi: float | np.ndarray, *, spectral_factor: float | np.ndarray = 1.0, optical_factor: float | np.ndarray = 1.0, ) -> np.ndarray: """Convert space environment/geometry state into cell-effective irradiance.""" return ( np.asarray(am0_irradiance_w_m2, dtype=float) * np.clip(np.asarray(illumination_fraction, dtype=float), 0.0, 1.0) * np.clip(np.asarray(cosine_aoi, dtype=float), 0.0, 1.0) * np.asarray(spectral_factor, dtype=float) * np.asarray(optical_factor, dtype=float) )
[docs] def pvwatts_dc_space( effective_irradiance: float | np.ndarray, cell_temperature_c: float | np.ndarray, reference: PvwattsReference, ) -> np.ndarray: """Use pvlib's PVWatts DC equation with an explicit space reference irradiance. This is a calibrated engineering baseline, not a multi-junction radiation model. """ import pvlib irradiance = np.asarray(effective_irradiance, dtype=float) temperature = np.asarray(cell_temperature_c, dtype=float) equivalent_stc = irradiance / reference.reference_irradiance_w_m2 * 1000.0 return np.asarray( pvlib.pvsystem.pvwatts_dc( equivalent_stc, temperature, reference.pdc0_w, reference.gamma_pdc_per_c, temp_ref=reference.reference_temperature_c, ), dtype=float, )