pandas.DataFrame.rename

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

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

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

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

Параметры:	mapper : dict-like or function Преобразования в виде словаря или функций, применяемые к значениям оси. Используйте mapper и axis для указания оси, к которой применять mapper, или index и columns. index : dict-like or function Альтернатива указанию оси (mapper, axis=0 эквивалентно index=mapper). columns : dict-like or function Альтернатива указанию оси (mapper, axis=1 эквивалентно columns=mapper). axis : int or str Ось, к которой применять mapper. Может быть именем оси ('index', 'columns') или номером (0, 1). По умолчанию 'index'. copy : bool, default True Также копирует исходные данные. inplace : bool, default False Возвращать новую таблицу DataFrame. Если True, значение copy игнорируется. level : int or level name, default None В случае MultiIndex переименовываются только метки в указанном уровне. errors : {‘ignore’, ‘raise’}, default ‘ignore’ Если ‘raise’, поднимается KeyError при содержании словарем-подобного mapper, index, или columns меток, отсутствующих в индексе, который преобразуется. Если ‘ignore’, существующие ключи будут переименованы, а дополнительные ключи будут проигнорированы.
Возвращает:	DataFrame DataFrame с переименованными метками осей.
Возможные исключения:	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