energy_methods.poa#

Replayable interval-mean GHI transposition and training-only effective geometry.

Twelve solar-position substeps distribute hourly GHI proportional to positive cos(true zenith), conserving its mean. Erbs at these synthetic substeps is an explicit approximation; it does not reconstruct subhourly cloud variability.

Citations are collected in energy_methods.references: the main thesis, Reda-Andreas solar position, Erbs, Hay-Davies, Spencer, tracker backtracking, and pvlib. Effective geometry search and interval disaggregation are project adaptations, not reconstructed as-built geometry.

class energy_methods.poa.Geometry(kind: "Literal['fixed', 'single_axis']" = 'fixed', tilt_deg: 'float' = 20.0, azimuth_deg: 'float' = 0.0, axis_tilt_deg: 'float' = 0.0, axis_azimuth_deg: 'float' = 0.0, max_angle_deg: 'float' = 60.0, backtrack: 'bool' = True, gcr: 'float' = 0.35)[source]#

Bases: object

Parameters:
  • kind (Literal['fixed', 'single_axis'])

  • tilt_deg (float)

  • azimuth_deg (float)

  • axis_tilt_deg (float)

  • axis_azimuth_deg (float)

  • max_angle_deg (float)

  • backtrack (bool)

  • gcr (float)

kind: Literal['fixed', 'single_axis']#
tilt_deg: float#
azimuth_deg: float#
axis_tilt_deg: float#
axis_azimuth_deg: float#
max_angle_deg: float#
backtrack: bool#
gcr: float#
class energy_methods.poa.POAResult(poa_wm2: 'FloatArray', solar_elevation_deg: 'FloatArray')[source]#

Bases: object

Parameters:
  • poa_wm2 (FloatArray)

  • solar_elevation_deg (FloatArray)

poa_wm2: FloatArray#
solar_elevation_deg: FloatArray#
class energy_methods.poa.EffectivePOAFit(geometry: 'Geometry', lag_hours: 'int', training_correlation: 'float', training_rows: 'int', poa_wm2: 'FloatArray', solar_elevation_deg: 'FloatArray', training_end_utc: 'str')[source]#

Bases: object

Parameters:
  • geometry (Geometry)

  • lag_hours (int)

  • training_correlation (float)

  • training_rows (int)

  • poa_wm2 (FloatArray)

  • solar_elevation_deg (FloatArray)

  • training_end_utc (str)

geometry: Geometry#
lag_hours: int#
training_correlation: float#
training_rows: int#
poa_wm2: FloatArray#
solar_elevation_deg: FloatArray#
training_end_utc: str#
to_dict()[source]#

Small replay specification; arrays remain in the analysis table.

Return type:

dict[str, object]

energy_methods.poa.solar_elevation_midpoint(timestamps, latitude, longitude)[source]#

Original resource evidence independent of fitting or available generation.

Parameters:
  • timestamps (DatetimeIndex)

  • latitude (float)

  • longitude (float)

Return type:

FloatArray

energy_methods.poa.transpose_ghi(timestamps, ghi_wm2, latitude, longitude, geometry=Geometry(kind='fixed', tilt_deg=20.0, azimuth_deg=0.0, axis_tilt_deg=0.0, axis_azimuth_deg=0.0, max_angle_deg=60.0, backtrack=True, gcr=0.35), *, substeps=12)[source]#

Transpose one-hour mean GHI without consulting any generation observations.

Parameters:
  • timestamps (DatetimeIndex)

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

  • latitude (float)

  • longitude (float)

  • geometry (Geometry)

  • substeps (int)

Return type:

POAResult

energy_methods.poa.shift_weather(values, lag_hours)[source]#

Shift a regular hourly feature array without circular wrap or gap filling.

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

  • lag_hours (int)

Return type:

FloatArray

energy_methods.poa.fit_effective_poa(timestamps, ghi_wm2, actual_mwh, latitude, longitude, *, training_end, candidates, lag_hours=(-2, -1, 0, 1, 2), min_samples=48)[source]#

Choose a bounded geometry/lag bank using training-only Pearson correlation.

Holdout labels are never read by the objective. Shifted training weather is also restricted to source timestamps within the training interval. Correlation does not establish true racking geometry or causal time alignment.

Parameters:
  • timestamps (DatetimeIndex)

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

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

  • latitude (float)

  • longitude (float)

  • training_end (Timestamp)

  • candidates (Sequence[Geometry])

  • lag_hours (Sequence[int])

  • min_samples (int)

Return type:

EffectivePOAFit