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: object

Annual 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_survive concerns the original set, while replacement permits subsequent operation. Cumulative quantities are computed independently for each trial. Zero energy is valid.

Parameters:
Return type:

DataFrame