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#
- 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.