Spec-Zone.ru › pandas 0.25

pandas.Series.interpolate

Series.interpolate(self, method='linear', axis=0, limit=None, inplace=False, limit_direction='forward', limit_area=None, downcast=None, **kwargs) [source]

Интерполировать значения по различным методам.

Обратите внимание, что только method='linear' поддерживаются для DataFrame/Series с MultiIndex.

Параметры:
method : str, default ‘linear’

Метод интерполяции. Один из:

  • ‘linear’: Игнорировать индекс и обрабатывать значения как равномерно распределенные. Это единственный метод, поддерживаемый для MultiIndexes.
  • ‘time’: Работает с данными с дневной и более высокой разрешающей способностью для интерполяции заданной длины интервала.
  • ‘index’, ‘values’: использовать фактические числовые значения индекса.
  • ‘pad’: Заполнить пропуски (NaN) с помощью имеющихся значений.
  • ‘nearest’, ‘zero’, ‘slinear’, ‘quadratic’, ‘cubic’, ‘spline’, ‘barycentric’, ‘polynomial’: Передаются в scipy.interpolate.interp1d. Эти методы используют числовые значения индекса. Оба метода ‘polynomial’ и ‘spline’ требуют, чтобы вы также указали order (целое число), например, df.interpolate(method='polynomial', order=5).
  • ‘krogh’, ‘piecewise_polynomial’, ‘spline’, ‘pchip’, ‘akima’: Обертки над методами интерполяции SciPy с аналогичными именами. См. Notes.
  • ‘from_derivatives’: Относится к scipy.interpolate.BPoly.from_derivatives, который заменяет метод интерполяции ‘piecewise_polynomial’ в scipy 0.18.

Добавлено в версии 0.18.1: Добавлена поддержка метода ‘akima’. Добавлен метод интерполяции ‘from_derivatives’, который заменяет ‘piecewise_polynomial’ в SciPy 0.18; обратная совместимость со SciPy < 0.18

axis : {0 or ‘index’, 1 or ‘columns’, None}, default None

Ось для интерполяции.

limit : int, optional

Максимальное количество последовательных пропусков (NaN) для заполнения. Должно быть больше 0.

inplace : bool, default False

Обновить данные на месте, если это возможно.

limit_direction : {‘forward’, ‘backward’, ‘both’}, default ‘forward’

Если задан предел, последовательные пропуски будут заполнены в этом направлении.

limit_area : {None, ‘inside’, ‘outside’}, default None

Если задан предел, последовательные пропуски будут заполнены с этим ограничением.

  • None: Ограничений на заполнение нет.
  • ‘inside’: Заполнять только пропуски (NaN), окружённые допустимыми значениями (интерполяция).
  • ‘outside’: Заполнять только пропуски (NaN), находящиеся за пределами допустимых значений (экстраполяция).

Добавлено в версии 0.23.0.

downcast : optional, ‘infer’ or None, defaults to None

Снизить тип данных (dtypes), если это возможно.

**kwargs

Ключевые аргументы для передачи функции интерполяции.

Возвращает:
Series или DataFrame

Возвращает тот же тип объекта, что и вызывающий объект, интерполированный в некоторых или во всех NaN значениях.

См. также

fillna
Заполнить пропущенные значения различными методами.
scipy.interpolate.Akima1DInterpolator
Кубические полиномы (интерполятор Акимы).
scipy.interpolate.BPoly.from_derivatives
Кусочно-полиномиальная функция в базисе Бернштейна.
scipy.interpolate.interp1d
Интерполировать функцию 1-D.
scipy.interpolate.KroghInterpolator
Интерполировать полином (интерполятор Крогга).
scipy.interpolate.PchipInterpolator
Монотонная кубическая интерполяция PCHIP 1-D.
scipy.interpolate.CubicSpline
Интерполятор кубических сплайнов.

Примечания

Методы ‘krogh’, ‘piecewise_polynomial’, ‘spline’, ‘pchip’ и ‘akima’ являются обёртками над соответствующими реализациями SciPy с аналогичными именами. Они используют фактические числовые значения индекса. Для получения дополнительной информации об их поведении, см. документацию SciPy и учебное пособие SciPy.

Примеры

Заполнение пропусков (NaN) в Series с помощью линейной интерполяции.

>>> s = pd.Series([0, 1, np.nan, 3])
>>> s
0    0.0
1    1.0
2    NaN
3    3.0
dtype: float64
>>> s.interpolate()
0    0.0
1    1.0
2    2.0
3    3.0
dtype: float64

Заполнение пропусков (NaN) в Series с помощью метода заполнения, но заполнение не более двух последовательных NaN за раз.

>>> s = pd.Series([np.nan, "single_one", np.nan,
...                "fill_two_more", np.nan, np.nan, np.nan,
...                4.71, np.nan])
>>> s
0              NaN
1       single_one
2              NaN
3    fill_two_more
4              NaN
5              NaN
6              NaN
7             4.71
8              NaN
dtype: object
>>> s.interpolate(method='pad', limit=2)
0              NaN
1       single_one
2       single_one
3    fill_two_more
4    fill_two_more
5    fill_two_more
6              NaN
7             4.71
8             4.71
dtype: object

Заполнение пропусков (NaN) в Series с помощью полиномиальной интерполяции или сплайнов: методы ‘polynomial’ и ‘spline’ требуют, чтобы вы также указали order (целое число).

>>> s = pd.Series([0, 2, np.nan, 8])
>>> s.interpolate(method='polynomial', order=2)
0    0.000000
1    2.000000
2    4.666667
3    8.000000
dtype: float64

Заполнить DataFrame вперед (то есть вниз) по каждой колонке с помощью линейной интерполяции.

Обратите внимание, как последний элемент в столбце ‘a’ интерполируется по-другому, потому что нет элемента после него для использования в интерполяции. Обратите внимание, как первый элемент в столбце ‘b’ остается NaN, потому что нет элемента перед ним для использования в интерполяции.

>>> df = pd.DataFrame([(0.0, np.nan, -1.0, 1.0),
...                    (np.nan, 2.0, np.nan, np.nan),
...                    (2.0, 3.0, np.nan, 9.0),
...                    (np.nan, 4.0, -4.0, 16.0)],
...                   columns=list('abcd'))
>>> df
     a    b    c     d
0  0.0  NaN -1.0   1.0
1  NaN  2.0  NaN   NaN
2  2.0  3.0  NaN   9.0
3  NaN  4.0 -4.0  16.0
>>> df.interpolate(method='linear', limit_direction='forward', axis=0)
     a    b    c     d
0  0.0  NaN -1.0   1.0
1  1.0  2.0 -2.0   5.0
2  2.0  3.0 -3.0   9.0
3  2.0  4.0 -4.0  16.0

Использование полиномиальной интерполяции.

>>> df['d'].interpolate(method='polynomial', order=2)
0     1.0
1     4.0
2     9.0
3    16.0
Name: d, dtype: float64

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.Series.interpolate.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API