pandas.DataFrame.rename

DataFrame.rename(index=None, columns=None, **kwargs) [source]

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

Параметры:

index, columns : скаляр, список, словарь или функция, необязательно Скаляр или список изменят атрибут Series.name, а в случае DataFrame или Panel вызовут ошибку. Словари или функции являются преобразованиями, применяемыми к значениям соответствующей оси. copy : булево, по умолчанию True Также скопировать исходные данные inplace : булево, по умолчанию False Возвращать ли новую таблицу DataFrame. Если True, значение copy игнорируется. level : целое число или имя уровня, по умолчанию None В случае MultiIndex переименовывать метки только в указанном уровне.

Возвращает:

renamed : DataFrame (новый объект)

См. также

pandas.NDFrame.rename_axis

Примеры

>>> s = pd.Series([1, 2, 3])
>>> s
0    1
1    2
2    3
dtype: int64
>>> s.rename("my_name") # scalar, changes Series.name
0    1
1    2
2    3
Name: my_name, dtype: int64
>>> s.rename(lambda x: x ** 2)  # function, changes labels
0    1
1    2
4    3
dtype: int64
>>> s.rename({1: 3, 2: 5})  # mapping, changes labels
0    1
3    2
5    3
dtype: int64
>>> df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
>>> df.rename(2)
Traceback (most recent call last):
...
TypeError: 'int' object is not callable
>>> 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