pandas.DataFrame.rename

DataFrame.rename(mapper=None, *, index=None, columns=None, axis=None, copy=None, inplace=False, level=None, errors='ignore')[source]

Изменение меток осей.

Значения функции/словаря должны быть уникальными (1-к-1). Метки, не содержащиеся в словаре/Series, останутся без изменений. Дополнительные перечисленные метки не приводят к ошибке.

Дополнительные сведения см. в руководстве пользователя.

Параметры

mapper:dict-like или функция

Преобразования типа dict-like или функции, применяемые к значениям оси. Используйте либо mapper и axis для указания оси, к которой применяется mapper, или index и columns.

index:dict-like или функция

Альтернатива указанию оси (mapper, axis=0 эквивалентно index=mapper).

columns:dict-like или функция

Альтернатива указанию оси (mapper, axis=1 эквивалентно columns=mapper).

axis:{0 или ‘индекс’, 1 или ‘колонки’}, по умолчанию 0

Ось, к которой применяется mapper. Может быть именем оси (‘индекс’, ‘колонки’) или числом (0, 1). По умолчанию — ‘индекс’.

copy:bool, по умолчанию True

Также копировать исходные данные.

inplace:bool, по умолчанию False

Изменять DataFrame вместо создания нового. Если True, значение copy игнорируется.

level:int или имя уровня, по умолчанию None

В случае MultiIndex переименовывать только метки в указанном уровне.

errors:{‘ignore’, ‘raise’}, по умолчанию ‘ignore’

Если ‘raise’, генерировать KeyError, когда dict-like mapper, index или columns содержит метки, отсутствующие в преобразуемом индексе. Если ‘ignore’, существующие ключи будут переименованы, а дополнительные ключи будут проигнорированы.

Возвращает

DataFrame или None

DataFrame с переименованными метками осей или None, если inplace=True.

Возбуждает

KeyError

Если какая-либо метка не найдена на выбранной оси и «errors=’raise’».

См. также

DataFrame.rename_axis

Установить имя оси.

Примеры

DataFrame.rename поддерживает два варианта вызова

• (index=index_mapper, columns=columns_mapper, ...)

• (mapper, axis={'index', 'columns'}, ...)

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

Переименование столбцов с помощью сопоставления:

>>> df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> df.rename(columns={"A": "a", "B": "c"})
   a  c
0  1  4
1  2  5
2  3  6

Переименование индекса с помощью сопоставления:

>>> df.rename(index={0: "x", 1: "y", 2: "z"})
   A  B
x  1  4
y  2  5
z  3  6

Преобразование меток индекса в другой тип:

>>> df.index
RangeIndex(start=0, stop=3, step=1)
>>> df.rename(index=str).index
Index(['0', '1', '2'], dtype='object')

>>> df.rename(columns={"A": "a", "B": "b", "C": "c"}, errors="raise")
Traceback (most recent call last):
KeyError: ['C'] not found in axis

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

>>> df.rename(str.lower, axis='columns')
   a  b
0  1  4
1  2  5
2  3  6

>>> df.rename({1: 2, 2: 4}, axis='index')
   A  B
0  1  4
2  2  5
4  3  6