rdtools.normalization.energy_from_power

rdtools.normalization.energy_from_power(power, target_frequency=None, max_timedelta=None, power_type='right_labeled')

Returns a regular right-labeled energy time series in units of Wh per interval from a power time series. For instantaneous timeseries, a trapezoidal sum is used. For right labeled time series, a rectangular sum is used. NaN is filled where the gap between input data points exceeds max_timedelta. Power_series should be given in Watts.

Parameters:

• power (pd.Series) -- Time series of power in Watts
• target_frequency (DatetimeOffset or frequency string, default None) -- The frequency of the energy time series to be returned. If omitted, use the median timestep of power, or if power has fewer than two elements, use ``power.index.freq`.
• max_timedelta (pd.Timedelta, default None) -- The maximum allowed gap between power measurements. If the gap between consecutive power measurements exceeds max_timedelta, NaN will be returned for that interval. If omitted, max_timedelta is set internally to the median time delta in power. Ignored when power has fewer than two elements.
• power_type ({'right_labeled', 'instantaneous'}) -- The labeling convention used in power. Default: 'right_labeled'

Returns:

right-labeled energy in Wh per interval

Return type:

pd.Series