energy_methods.wind_physics#
Transparent cubic wind-power surrogate with training-only scale calibration.
The default cut-in/rated/cut-out speeds follow the NREL 5-MW reference turbine. The interpolating cubic and fitted farm scale are repository approximations, not that turbine’s aerodynamic power curve or evidence of installed equipment. Air density, wakes, availability and curtailment are not modelled.
- class energy_methods.wind_physics.WindPhysicsConfig(cut_in_ms: 'float' = 3.0, rated_ms: 'float' = 11.4, cut_out_ms: 'float' = 25.0, min_samples: 'int' = 48)[source]#
Bases:
object- Parameters:
cut_in_ms (float)
rated_ms (float)
cut_out_ms (float)
min_samples (int)
- cut_in_ms: float#
- rated_ms: float#
- cut_out_ms: float#
- min_samples: int#
- energy_methods.wind_physics.wind_power_fraction(speed_ms, *, config=WindPhysicsConfig(cut_in_ms=3.0, rated_ms=11.4, cut_out_ms=25.0, min_samples=48))[source]#
Piecewise zero / cubic ramp / rated plateau / cut-out, with NaN for bad speeds.
- Parameters:
speed_ms (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
config (WindPhysicsConfig)
- Return type:
FloatArray
- class energy_methods.wind_physics.WindPhysicsModel(config: 'WindPhysicsConfig', scale_mw: 'float', training_rows: 'int')[source]#
Bases:
object- Parameters:
config (WindPhysicsConfig)
scale_mw (float)
training_rows (int)
- config: WindPhysicsConfig#
- scale_mw: float#
- training_rows: int#
- energy_methods.wind_physics.fit_wind_physics(speed_ms, power_mw, *, config=WindPhysicsConfig(cut_in_ms=3.0, rated_ms=11.4, cut_out_ms=25.0, min_samples=48))[source]#
Calibrate a nonnegative response scale on supplied historical observations.
- Parameters:
speed_ms (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
power_mw (Buffer | _SupportsArray[dtype[Any]] | _NestedSequence[_SupportsArray[dtype[Any]]] | complex | bytes | str | _NestedSequence[complex | bytes | str])
config (WindPhysicsConfig)
- Return type: