Skip to main content

ModelChain

pvlib::modelchain

Struct ModelChain 

Source 
pub struct ModelChain {
    pub system: PVSystem,
    pub location: Location,
    pub surface_tilt: f64,
    pub surface_azimuth: f64,
    pub inverter_pac0: f64,
    pub inverter_eta: f64,
    pub config: ModelChainConfig,
}
Expand description

Orchestrates the full PV system performance simulation pipeline.

Fields§

§system: PVSystem§location: Location§surface_tilt: f64§surface_azimuth: f64§inverter_pac0: f64§inverter_eta: f64§config: ModelChainConfig

Implementations§

Source§

impl ModelChain

Source

pub fn new( system: PVSystem, location: Location, surface_tilt: f64, surface_azimuth: f64, inverter_pac0: f64, inverter_eta: f64, ) -> Self

Create a new ModelChain with explicit parameters (legacy constructor).

Source

pub fn with_config( system: PVSystem, location: Location, surface_tilt: f64, surface_azimuth: f64, inverter_pac0: f64, inverter_eta: f64, config: ModelChainConfig, ) -> Self

Create a ModelChain with a custom configuration.

Source

pub fn with_pvwatts( system: PVSystem, location: Location, surface_tilt: f64, surface_azimuth: f64, inverter_pac0: f64, inverter_eta: f64, ) -> Self

Factory: PVWatts-style configuration.

Uses PVWatts DC/AC, Physical AOI, PVWatts temperature, Perez transposition.

Source

pub fn with_sapm( system: PVSystem, location: Location, surface_tilt: f64, surface_azimuth: f64, inverter_pac0: f64, inverter_eta: f64, ) -> Self

Factory: SAPM-style configuration.

Uses PVWatts DC, PVWatts AC, ASHRAE AOI, SAPM temperature, HayDavies transposition.

Source

pub fn run_model( &self, time: DateTime<Tz>, _ghi: f64, dni: f64, dhi: f64, temp_air: f64, _wind_speed: f64, ) -> Result<SimulationResult, SpaError>

Run the model for a single timestep with given weather data (legacy API).

Source

pub fn run_model_from_weather( &self, weather: &WeatherInput, ) -> Result<ModelChainResult, SpaError>

Run the full simulation pipeline from weather data.

Steps: solar position -> airmass -> AOI -> transposition -> AOI modifier -> spectral modifier -> effective irradiance -> cell temperature -> DC power -> AC power.

Source

pub fn run_model_from_poa( &self, input: &POAInput, ) -> Result<ModelChainResult, SpaError>

Run the simulation starting from plane-of-array irradiance data.

Skips transposition step but still computes solar position for airmass.

Source

pub fn run_model_from_effective_irradiance( &self, input: &EffectiveIrradianceInput, ) -> Result<ModelChainResult, SpaError>

Run the simulation starting from effective irradiance.

Skips solar position, transposition, AOI, and spectral steps.

Source

pub fn complete_irradiance( &self, weather: &WeatherInput, ) -> Result<(f64, f64, f64), SpaError>

Fill missing GHI, DNI, or DHI using the Erbs decomposition model.

If all three are provided, returns them as-is. If GHI is provided but DNI or DHI are missing, uses Erbs to decompose. If GHI is missing but DNI and DHI are provided, computes GHI = DNI * cos(zenith) + DHI.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more