energy_methods.pv_lifetime#

Long-horizon PV power retention, following selected MAPLE equations (2026).

These deterministic power fractions are not survival probabilities. Equations 8, 10 and 13 are implemented independently; this is not the full MAPLE package. Rates and time steps must use reciprocal units (here years and 1/year).

energy_methods.pv_lifetime.sigmoid_power(exposure, *, shape)[source]#

Eq. 10: (1+exp(-B))/(1+exp(exposure-B)), with dimensionless B=shape.

For constant stress, exposure = rate * age. For varying rates and constant B, exposure is the accumulated rate*time, not the latest rate*total age. The log-domain evaluation avoids exponential overflow and gives P(0)=1.

Parameters:
  • exposure (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • shape (float)

Return type:

ndarray[tuple[Any, …], dtype[float64]]

energy_methods.pv_lifetime.sigmoid_exposure(retained_power, *, shape)[source]#

Inverse of Eq. 10; exposure required to reach a given power fraction.

Parameters:
  • retained_power (float)

  • shape (float)

Return type:

float

energy_methods.pv_lifetime.equivalent_time_power(step_years, rate_per_year, *, shape)[source]#

Eqs. 10/13: preserve prior damage across piecewise-constant stresses.

Return initial power 1 followed by the power at every interval end. Time steps are a positive 1-D array; rate and B are scalars or arrays of exactly that shape. At each step, invert the CURRENT sigmoid at the PREVIOUS power, then advance by rate*step. This permits B to change as well as the rate. A zero rate pauses damage. No healing, replacement or interaction is assumed. Log power is carried internally to avoid losing history to underflow.

Parameters:
  • step_years (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • rate_per_year (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • shape (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[float64]]

energy_methods.pv_lifetime.independent_mode_power(mode_power)[source]#

Eq. 8: product across rows of a (modes, times) power-fraction matrix.

Assumes independent mode effects. Do not multiply a system-level total loss curve by its constituent modes: that would count the same damage twice.

Parameters:

mode_power (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

Return type:

ndarray[tuple[Any, …], dtype[float64]]

energy_methods.pv_lifetime.threshold_crossing(age_years, power, *, threshold=0.8)[source]#

First threshold crossing by linear interpolation of monotone samples.

Return None when the threshold is not reached inside the supplied horizon. That is a censored projection, not an infinite lifetime. A first point at or below threshold returns its age; the actual earlier crossing is unknown.

Parameters:
  • age_years (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • power (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])

  • threshold (float)

Return type:

float | None