pandas.DataFrame.rename

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

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

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

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

Параметры:

mapper, index, columns : dict-like или функция, необязательно dict-like или функции преобразований, применяемые к значениям оси. Используйте mapper и axis для указания оси, к которой будет применено mapper, или index и columns. axis : int или str, необязательно Ось, к которой будет применено mapper. Может быть именем оси (‘index’, ‘columns’) или числом (0, 1). По умолчанию — ‘index’. copy : boolean, по умолчанию True Также скопировать исходные данные inplace : boolean, по умолчанию False Возвратить ли новый %(klass)s. Если True, то значение copy игнорируется. level : int или имя уровня, по умолчанию 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