energy_methods.pvcz#

Karin, Jones and Jain (2019) PVCZ thresholds and Arrhenius stress.

Table I: ten temperature zones by five specific-humidity zones. This is a stressor classification, not a predicted degradation rate or lifetime.

energy_methods.pvcz.equivalent_temperature(temperature_c, *, activation_energy_ev=1.1, duration_hours=1.0)[source]#

Arrhenius-equivalent °C over the last axis, weighted by interval duration.

Supply module temperatures including nights. Any missing interval makes its result missing; there is no gap filling. A time series with explicit missing rows is required to represent gaps. Duration cannot reveal omitted rows.

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

  • activation_energy_ev (float)

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

Return type:

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

energy_methods.pvcz.classify_pvcz(equivalent_temperature_c, specific_humidity_g_kg, *, provenance)[source]#

Apply fixed published boundaries; equality enters the warmer/wetter class.

Humidity is specific humidity (g/kg), never relative humidity (%). Positive IDs are the upstream zero-based PVCZ ID + 1, leaving zero for missing inputs. Use the reference 1.1 eV equivalent temperature for the published scheme.

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

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

  • provenance (ClimateProvenance)

Return type:

ClimateZones