pandas.DataFrame.rename

DataFrame.переименовать(mapper=None, *, index=None, столбцы=None, ось=None, copy=None, inplace=False, уровень=None, ошибки='ignore')

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

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

См. руководство пользователя подробнее.

Параметры:

mapperсловарь или функция

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

indexсловарь или функция

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

столбцысловарь или функция

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

ось{0 или 'index', 1 или 'columns'}, по умолчанию 0

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

copybool, по умолчанию True

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

Примечание

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

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

inplacebool, по умолчанию False

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

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

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

ошибки{‘ignore’, ‘raise’}, по умолчанию ‘ignore’

Если 'raise', вызывает исключение KeyError когда словарный объект mapper, index, или столбцы содержит метки, которые отсутствуют в преобразуемом Index. Если '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