energy_methods.tdp#

Typical Daily Profiles, DOI 10.1016/j.solener.2021.07.007.

AVG pools original observations by month/hour across eligible year-months; Y2Y preserves year/month/hour. P90 is the empirical 90th percentile of hourly observations, not an annual-energy 90% exceedance estimate.

Method source: ascencio_vasquez_2021_tdp; related thesis context: ascencio_vasquez_2021_thesis in energy_methods.references.

class energy_methods.tdp.TDPConfig(value_column: 'str' = 'actual_mwh', utc_offset_hours: 'float' = 0.0, min_useful_days: 'int' = 15, min_hours_per_day: 'int' = 24, min_bin_observations: 'int' = 10, nonnegative: 'bool' = True, screen_positive_flat: 'bool' = True, flat_tolerance: 'float' = 1e-09)[source]#

Bases: object

Parameters:
  • value_column (str)

  • utc_offset_hours (float)

  • min_useful_days (int)

  • min_hours_per_day (int)

  • min_bin_observations (int)

  • nonnegative (bool)

  • screen_positive_flat (bool)

  • flat_tolerance (float)

value_column: str#
utc_offset_hours: float#
min_useful_days: int#
min_hours_per_day: int#
min_bin_observations: int#
nonnegative: bool#
screen_positive_flat: bool#
flat_tolerance: float#
class energy_methods.tdp.TDPResult(avg: 'pd.DataFrame', y2y: 'pd.DataFrame', coverage: 'pd.DataFrame', config: 'TDPConfig')[source]#

Bases: object

Parameters:
  • avg (DataFrame)

  • y2y (DataFrame)

  • coverage (DataFrame)

  • config (TDPConfig)

avg: DataFrame#
y2y: DataFrame#
coverage: DataFrame#
config: TDPConfig#
energy_methods.tdp.analyze_tdp(hourly, config=TDPConfig(value_column='actual_mwh', utc_offset_hours=0.0, min_useful_days=15, min_hours_per_day=24, min_bin_observations=10, nonnegative=True, screen_positive_flat=True, flat_tolerance=1e-09))[source]#

Compute full-precision TDPs independently per site without imputing energy.

Input requires site_id, timezone-aware timestamp and config.value_column. Each observation is one elapsed-hour mean or energy interval. Positive-flat screening additionally requires solar_elevation_deg for all 24 day slots; without it the screen is explicitly unavailable. Historical net-capacity and PR gates are not inferred from undated present-day capacity.

Parameters:
Return type:

TDPResult