pandas.Panel4D.resample

Panel4D.resample(rule, how=None, axis=0, fill_method=None, closed=None, label=None, convention='start', kind=None, loffset=None, limit=None, base=0, on=None, level=None) [source]

Удобный метод для преобразования частоты и ресемплирования временных рядов. Объект должен иметь индекс типа datetime (DatetimeIndex, PeriodIndex или TimedeltaIndex), или передать значения типа datetime в ключевое слово on или level.

Параметры:

rule : строка строка или объект смещения, представляющий целевое преобразование axis : int, необязательно, по умолчанию 0 closed : {‘right’, ‘left’} Какая сторона интервала бина закрыта label : {‘right’, ‘left’} Какой край бина использовать в качестве метки для корзины convention : {‘start’, ‘end’, ‘s’, ‘e’} loffset : timedelta Корректировка меток ресемплированных временных рядов base : int, по умолчанию 0 Для частот, которые равномерно делят 1 день, «начало» агрегированных интервалов. Например, для частоты ‘5min’, base может принимать значения от 0 до 4. По умолчанию 0 on : строка, необязательно Для DataFrame, столбец для использования вместо индекса для ресемплирования. Столбец должен быть типа datetime. Новая функция в версии 0.19.0. level : строка или целое число, необязательно Для MultiIndex, уровень (имя или номер) для использования в ресемплировании. Уровень должен быть типа datetime. Новая функция в версии 0.19.0. Для получения дополнительной информации об именах смещения, пожалуйста, обратитесь к этой ссылке <http://pandas.pydata.org/pandas-docs/stable/timeseries.html#offset-aliases>`__.

Примеры

Начните с создания ряда с 9 временными отметками с интервалом в одну минуту.

>>> index = pd.date_range('1/1/2000', periods=9, freq='T')
>>> series = pd.Series(range(9), index=index)
>>> series
2000-01-01 00:00:00    0
2000-01-01 00:01:00    1
2000-01-01 00:02:00    2
2000-01-01 00:03:00    3
2000-01-01 00:04:00    4
2000-01-01 00:05:00    5
2000-01-01 00:06:00    6
2000-01-01 00:07:00    7
2000-01-01 00:08:00    8
Freq: T, dtype: int64

Ресемплирование ряда в корзины по 3 минуты и суммирование значений временных меток, попадающих в корзину.

>>> series.resample('3T').sum()
2000-01-01 00:00:00     3
2000-01-01 00:03:00    12
2000-01-01 00:06:00    21
Freq: 3T, dtype: int64

Ресемплирование ряда в корзины по 3 минуты, как выше, но метки каждой корзины будут использоваться по правому краю вместо левого. Обратите внимание, что значение в корзине, используемое в качестве метки, не включено в саму корзину. Например, в исходном ряде корзина 2000-01-01 00:03:00 содержит значение 3, но суммарное значение в ресемплированной корзине с меткой ``2000-01-01 00:03:00`` не включает 3 (если бы оно включалось, суммарное значение было бы 6, а не 3). Чтобы включить это значение, необходимо закрыть правый край интервала корзины, как показано в примере ниже.

>>> series.resample('3T', label='right').sum()
2000-01-01 00:03:00     3
2000-01-01 00:06:00    12
2000-01-01 00:09:00    21
Freq: 3T, dtype: int64

Ресемплирование ряда в корзины по 3 минуты, как выше, но с закрытым правым краем интервала корзины.

>>> series.resample('3T', label='right', closed='right').sum()
2000-01-01 00:00:00     0
2000-01-01 00:03:00     6
2000-01-01 00:06:00    15
2000-01-01 00:09:00    15
Freq: 3T, dtype: int64

Ресемплирование ряда в корзины по 30 секунд.

>>> series.resample('30S').asfreq()[0:5] #select first 5 rows
2000-01-01 00:00:00     0
2000-01-01 00:00:30   NaN
2000-01-01 00:01:00     1
2000-01-01 00:01:30   NaN
2000-01-01 00:02:00     2
Freq: 30S, dtype: float64

Ресемплирование ряда в корзины по 30 секунд и заполнение NaN значений с помощью pad метода.

>>> series.resample('30S').pad()[0:5]
2000-01-01 00:00:00    0
2000-01-01 00:00:30    0
2000-01-01 00:01:00    1
2000-01-01 00:01:30    1
2000-01-01 00:02:00    2
Freq: 30S, dtype: int64

Ресемплирование ряда в корзины по 30 секунд и заполнение NaN значений с помощью bfill метода.

>>> series.resample('30S').bfill()[0:5]
2000-01-01 00:00:00    0
2000-01-01 00:00:30    1
2000-01-01 00:01:00    1
2000-01-01 00:01:30    2
2000-01-01 00:02:00    2
Freq: 30S, dtype: int64

Передача пользовательской функции через apply

>>> def custom_resampler(array_like):
...     return np.sum(array_like)+5

>>> series.resample('3T').apply(custom_resampler)
2000-01-01 00:00:00     8
2000-01-01 00:03:00    17
2000-01-01 00:06:00    26
Freq: 3T, dtype: int64