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#
predict(speed_ms)[source]#
Parameters:

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

Return type:

FloatArray

to_dict()[source]#
Return type:

dict[str, object]

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:

WindPhysicsModel