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: