Spec-Zone.ru › pandas 0.24

pandas.Panel.reindex

Panel.reindex(*args, **kwargs) [source]

Приведение панели к новому индексу с опциональной логикой заполнения, размещая NA/NaN в местах, не имеющих значения в предыдущем индексе. Новый объект создается, если новый индекс эквивалентен текущему и copy=False.

Параметры:
items, major_axis, minor_axis : array-like, optional

Новые метки/индекс для приведения к виду, должны быть указаны с использованием ключевых слов. Желательно использовать объект Index для избежания дублирования данных

method : {None, ‘backfill’/’bfill’, ‘pad’/’ffill’, ‘nearest’}

Метод, используемый для заполнения пропусков в переиндексированной таблице DataFrame. Обратите внимание: это применимо только к DataFrame/Series с монотонно возрастающим/убывающим индексом.

  • None (по умолчанию): не заполнять пробелы
  • pad / ffill: распространять последнее действительное наблюдение вперед до следующего действительного
  • backfill / bfill: использовать следующее действительное наблюдение для заполнения пропусков
  • nearest: использовать ближайшие действительные наблюдения для заполнения пропусков
copy : bool, default True

Возвратить новый объект, даже если переданные индексы одинаковы.

level : int or name

Трансляция по уровню, сопоставляющая значения Index в переданном MultiIndex уровне.

fill_value : scalar, default np.NaN

Значение, используемое для пропущенных значений. По умолчанию NaN, но может быть любое «совместимое» значение.

limit : int, default None

Максимальное количество последовательных элементов для заполнения вперед или назад.

tolerance : optional

Максимальное расстояние между исходными и новыми метками для неточных совпадений. Значения индекса в совпадающих местах в наибольшей степени удовлетворяют уравнению abs(index[indexer] - target) <= tolerance.

Допуск может быть скалярным значением, которое применяется одинаковый допуск ко всем значениям, или списком, который применяет переменный допуск к каждому элементу. Список включает список, кортеж, массив, Series и должен иметь такой же размер, как и индекс, и его тип данных должен точно соответствовать типу индекса.

В версии 0.21.0: (допуск в виде списка)

Возвращаемое значение:
Панель с изменённым индексом.

См. также

DataFrame.set_index
Установить метки строк.
DataFrame.reset_index
Удалить метки строк или перенести их в новые столбцы.
DataFrame.reindex_like
Изменение на те же индексы, что и у другого DataFrame.

Примеры

DataFrame.reindex поддерживает два способа вызова

  • (index=index_labels, columns=column_labels, ...)
  • (labels, axis={'index', 'columns'}, ...)

Мы настоятельно рекомендуем использовать ключевые аргументы для ясности ваших намерений.

Создайте таблицу DataFrame с некоторыми фиктивными данными.

>>> index = ['Firefox', 'Chrome', 'Safari', 'IE10', 'Konqueror']
>>> df = pd.DataFrame({
...      'http_status': [200,200,404,404,301],
...      'response_time': [0.04, 0.02, 0.07, 0.08, 1.0]},
...       index=index)
>>> df
           http_status  response_time
Firefox            200           0.04
Chrome             200           0.02
Safari             404           0.07
IE10               404           0.08
Konqueror          301           1.00

Создайте новый индекс и переиндексируйте таблицу DataFrame. По умолчанию значения в новом индексе, которые не имеют соответствующих записей в таблице DataFrame, присваиваются NaN.

>>> new_index= ['Safari', 'Iceweasel', 'Comodo Dragon', 'IE10',
...             'Chrome']
>>> df.reindex(new_index)
               http_status  response_time
Safari               404.0           0.07
Iceweasel              NaN            NaN
Comodo Dragon          NaN            NaN
IE10                 404.0           0.08
Chrome               200.0           0.02

Мы можем заполнить пропущенные значения, передав значение ключевому слову fill_value. Поскольку индекс не является монотонно возрастающим или убывающим, мы не можем использовать аргументы к ключевому слову method для заполнения NaN значений.

>>> df.reindex(new_index, fill_value=0)
               http_status  response_time
Safari                 404           0.07
Iceweasel                0           0.00
Comodo Dragon            0           0.00
IE10                   404           0.08
Chrome                 200           0.02
>>> df.reindex(new_index, fill_value='missing')
              http_status response_time
Safari                404          0.07
Iceweasel         missing       missing
Comodo Dragon     missing       missing
IE10                  404          0.08
Chrome                200          0.02

Мы также можем переиндексировать столбцы.

>>> df.reindex(columns=['http_status', 'user_agent'])
           http_status  user_agent
Firefox            200         NaN
Chrome             200         NaN
Safari             404         NaN
IE10               404         NaN
Konqueror          301         NaN

Или мы можем использовать ключевые аргументы в стиле «оси»

>>> df.reindex(['http_status', 'user_agent'], axis="columns")
           http_status  user_agent
Firefox            200         NaN
Chrome             200         NaN
Safari             404         NaN
IE10               404         NaN
Konqueror          301         NaN

Для дальнейшей иллюстрации функциональности заполнения в reindex, мы создадим таблицу DataFrame с монотонно возрастающим индексом (например, последовательность дат).

>>> date_index = pd.date_range('1/1/2010', periods=6, freq='D')
>>> df2 = pd.DataFrame({"prices": [100, 101, np.nan, 100, 89, 88]},
...                    index=date_index)
>>> df2
            prices
2010-01-01   100.0
2010-01-02   101.0
2010-01-03     NaN
2010-01-04   100.0
2010-01-05    89.0
2010-01-06    88.0

Предположим, мы решили расширить таблицу DataFrame, чтобы охватить более широкий диапазон дат.

>>> date_index2 = pd.date_range('12/29/2009', periods=10, freq='D')
>>> df2.reindex(date_index2)
            prices
2009-12-29     NaN
2009-12-30     NaN
2009-12-31     NaN
2010-01-01   100.0
2010-01-02   101.0
2010-01-03     NaN
2010-01-04   100.0
2010-01-05    89.0
2010-01-06    88.0
2010-01-07     NaN

Записи индекса, которые не имели значения в исходных данных (например, «2009-12-29»), по умолчанию заполняются NaN. При необходимости мы можем заполнить пропущенные значения с помощью одного из нескольких вариантов.

Например, чтобы обратное распространение последнего действительного значения для заполнения NaN значений, передайте bfill в качестве аргумента ключевому слову method.

>>> df2.reindex(date_index2, method='bfill')
            prices
2009-12-29   100.0
2009-12-30   100.0
2009-12-31   100.0
2010-01-01   100.0
2010-01-02   101.0
2010-01-03     NaN
2010-01-04   100.0
2010-01-05    89.0
2010-01-06    88.0
2010-01-07     NaN

Обратите внимание, что значение NaN , присутствующее в исходной таблице DataFrame (в индексе 2010-01-03), не будет заполнено ни одной из схем распространения значений. Это происходит потому, что заполнение при переиндексации не анализирует значения таблицы DataFrame, а только сравнивает исходные и требуемые индексы. Если вы хотите заполнить NaN значения, присутствующие в исходной таблице DataFrame, используйте метод fillna().

См. руководство пользователя для получения дополнительной информации.

© 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.24.2/reference/api/pandas.Panel.reindex.html

Spec-Zone.ru

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