energy_methods.pv_operation#
Annual PV operation scenarios with independent, repairable component failures.
A Bernoulli event per component and year represents at most one replacement. Failure timing is represented by a caller-supplied fractional annual outage. These are explicit engineering scenarios, not calibrated field failure models.
- class energy_methods.pv_operation.ComponentScenario(name, annual_failure_probability, outage_fraction, replacement_cost)[source]#
Bases:
objectAnnual failure probability, outage fraction and constant-real replacement cost.
Replacements restore service but do not reset module degradation. Cost is in the caller’s declared currency. Failures are independent across years, components and simulated plants. Multiple same-year failures are excluded.
- Parameters:
name (str)
annual_failure_probability (float)
outage_fraction (float)
replacement_cost (float)
- name: str#
- annual_failure_probability: float#
- outage_fraction: float#
- replacement_cost: float#
- energy_methods.pv_operation.simulate_operation(*, curve, initial_annual_energy_mwh, components, years=50, trials=1000, seed=0)[source]#
Return one row per trial/year, using midpoint annual power retention.
Concurrent component outages are conservatively added and capped at one year. No repair queue, seasonality, weather variability or cost discounting is modeled.
original_components_surviveconcerns the original set, while replacement permits subsequent operation. Cumulative quantities are computed independently for each trial. Zero energy is valid.- Parameters:
curve (ReliabilityCurve)
initial_annual_energy_mwh (float)
components (tuple[ComponentScenario, ...])
years (int)
trials (int)
seed (int)
- Return type:
DataFrame