pandas.DataFrame.rename

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

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

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

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

Параметры:

mapper, index, columns : dict-like or function, optional Словарные данные или функции преобразования для применения к значениям этой оси. Используйте либо mapper и axis для указания оси, на которую следует нацеливаться с mapper, или index и columns. axis : int or str, optional Ось для целевого нацеливания с mapper. Может быть именем оси ('индекс', 'колонки') или числом (0, 1). По умолчанию — 'индекс'. copy : boolean, default True Также копировать исходные данные inplace : boolean, default False Возвращать новую таблицу DataFrame. Если True, то значение copy игнорируется. level : int or level name, default None В случае MultiIndex переименовывать метки только в указанном уровне.

Возвращаемое значение:

renamed : DataFrame

См. также

pandas.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(index=str, columns={"A": "a", "B": "c"})
   a  c
0  1  4
1  2  5
2  3  6

>>> df.rename(index=str, columns={"A": "a", "C": "c"})
   a  B
0  1  4
1  2  5
2  3  6

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

>>> 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