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:словарноподобный объект или функция

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

index:словарноподобный объект или функция

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

columns:словарноподобный объект или функция

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

axis:{0 или ‘index’, 1 или ‘columns’}, по умолчанию 0

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

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

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

Примечание

Ключевое слово copy изменит поведение в pandas 3.0. Copy-on-Write будет включено по умолчанию, что означает, что все методы с ключевым словом copy будут использовать механизм ленивой копии для отсрочки копии и игнорировать ключевое слово copy. Ключевое слово copy будет удалено в будущей версии pandas.

Вы уже можете получить будущее поведение и улучшения, включив копирование при записи pd.options.mode.copy_on_write = True

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

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

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

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

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

Если ‘raise’, вызывать KeyError при словаре 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