energy_methods.status#

IEC-informed observable operating screens; all operating causes unconfirmed.

Implements the recovered ASVA 2.0 decision order. Numerical thresholds are ASVA engineering rules, not IEC requirements. IEC TS 63019:2019 information categories must not be confused with confirmed plant availability or fault attribution.

The main thesis and IEC standard are credited in energy_methods.references. The IEC citation is context and does not imply conformity.

class energy_methods.status.OperatingState(*values)[source]#

Bases: IntEnum

MISSING_GENERATION = 0#
INVALID_GENERATION = 1#
NIGHT_NO_GENERATION = 2#
LOW_RESOURCE_NO_GENERATION = 3#
GENERATION_AT_LOW_RESOURCE = 4#
NO_GENERATION_WITH_RESOURCE = 5#
REFERENCE_UNAVAILABLE = 6#
GENERATION_BELOW_EXPECTED = 7#
GENERATION_MODEL_CONSISTENT = 8#
GENERATION_ABOVE_EXPECTED = 9#
class energy_methods.status.StatusConfig(generation_epsilon_mwh: 'float' = 1e-05, minimum_solar_elevation_deg: 'float' = 5.0, minimum_ghi_wm2: 'float' = 100.0, minimum_effective_poa_wm2: 'float' = 100.0, night_maximum_solar_elevation_deg: 'float' = 0.0, night_maximum_ghi_wm2: 'float' = 1.0, model_relative_tolerance: 'float' = 0.2, model_absolute_tolerance_fraction_of_training_scale: 'float' = 0.05, minimum_expected_fraction_of_training_scale: 'float' = 0.05, near_zero_ratio: 'float' = 0.05, persistent_screening_run_minimum_hours: 'int' = 2)[source]#

Bases: object

Parameters:
  • generation_epsilon_mwh (float)

  • minimum_solar_elevation_deg (float)

  • minimum_ghi_wm2 (float)

  • minimum_effective_poa_wm2 (float)

  • night_maximum_solar_elevation_deg (float)

  • night_maximum_ghi_wm2 (float)

  • model_relative_tolerance (float)

  • model_absolute_tolerance_fraction_of_training_scale (float)

  • minimum_expected_fraction_of_training_scale (float)

  • near_zero_ratio (float)

  • persistent_screening_run_minimum_hours (int)

generation_epsilon_mwh: float#
minimum_solar_elevation_deg: float#
minimum_ghi_wm2: float#
minimum_effective_poa_wm2: float#
night_maximum_solar_elevation_deg: float#
night_maximum_ghi_wm2: float#
model_relative_tolerance: float#
model_absolute_tolerance_fraction_of_training_scale: float#
minimum_expected_fraction_of_training_scale: float#
near_zero_ratio: float#
persistent_screening_run_minimum_hours: int#
class energy_methods.status.StatusResult(codes: 'NDArray[np.uint8]', labels: 'NDArray[np.str_]', envelope_lower_mwh: 'FloatArray', envelope_upper_mwh: 'FloatArray', band_state: 'NDArray[np.uint8]', model_band_disagree: 'BoolArray', near_zero: 'BoolArray', persistent: 'BoolArray', run_hours: 'IntArray', assigned_iec_category: 'str' = 'INFORMATION UNAVAILABLE', confirmed_cause: 'bool' = False)[source]#

Bases: object

Parameters:
  • codes (ndarray[tuple[Any, ...], dtype[uint8]])

  • labels (ndarray[tuple[Any, ...], dtype[str_]])

  • envelope_lower_mwh (FloatArray)

  • envelope_upper_mwh (FloatArray)

  • band_state (ndarray[tuple[Any, ...], dtype[uint8]])

  • model_band_disagree (BoolArray)

  • near_zero (BoolArray)

  • persistent (BoolArray)

  • run_hours (IntArray)

  • assigned_iec_category (str)

  • confirmed_cause (bool)

codes: ndarray[tuple[Any, ...], dtype[uint8]]#
labels: ndarray[tuple[Any, ...], dtype[str_]]#
envelope_lower_mwh: FloatArray#
envelope_upper_mwh: FloatArray#
band_state: ndarray[tuple[Any, ...], dtype[uint8]]#
model_band_disagree: BoolArray#
near_zero: BoolArray#
persistent: BoolArray#
run_hours: IntArray#
assigned_iec_category: str#
confirmed_cause: bool#
energy_methods.status.classify_status(actual_mwh, expected_mwh, ghi_wm2, solar_elevation_deg, *, poa_wm2=None, training_scale_mwh=None, weather_supported=None, band_lower_mwh=None, band_upper_mwh=None, timestamps=None, config=StatusConfig(generation_epsilon_mwh=1e-05, minimum_solar_elevation_deg=5.0, minimum_ghi_wm2=100.0, minimum_effective_poa_wm2=100.0, night_maximum_solar_elevation_deg=0.0, night_maximum_ghi_wm2=1.0, model_relative_tolerance=0.2, model_absolute_tolerance_fraction_of_training_scale=0.05, minimum_expected_fraction_of_training_scale=0.05, near_zero_ratio=0.05, persistent_screening_run_minimum_hours=2))[source]#

Screen one site/reference in chronological order without filtering its energy.

Pass timestamps to break persistence at missing elapsed hours. If omitted, rows are explicitly assumed to be consecutive one-hour intervals. Training scale is accepted-training Q95 (including zeros), not nameplate capacity.

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

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

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

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

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

  • training_scale_mwh (float | None)

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

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

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

  • timestamps (DatetimeIndex | None)

  • config (StatusConfig)

Return type:

StatusResult