`DataFrame.rename()` / `Series.rename()`

Метод rename() переименовывает метки индекса и/или столбцов. Можно передать словарь, функцию или Index.

Сигнатура

DataFrame.rename(mapper=None, *, index=None, columns=None, axis=None,
                 copy=True, inplace=False, level=None, errors="ignore")

Параметры

index — словарь/функция для меток строк.
columns — словарь/функция для имён столбцов.
axis — ось для mapper: 0 или 1.
inplace — изменить объект на месте.
errors — "raise" бросает ошибку, если метка не найдена.

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

Новый DataFrame / Series (или None при inplace=True).

Примеры

Пример 1. Переименование столбцов

import pandas as pd

df = pd.DataFrame({"t": [22, 23], "h": [55, 60]})
print(df.rename(columns={"t": "temp", "h": "hum"}))

   temp  hum
0    22   55
1    23   60

Пример 2. Переименование индекса

import pandas as pd

s = pd.Series([22, 23], index=["a", "b"])
print(s.rename({"a": "sensor_A", "b": "sensor_B"}))

sensor_A    22
sensor_B    23
dtype: int64

Пример 3. Функция-преобразователь имён

import pandas as pd

df = pd.DataFrame({"Temp": [22], "Hum": [55]})
print(df.rename(columns=str.lower))

   temp  hum
0    22   55

Пример 4. Переименование имени Series

import pandas as pd

s = pd.Series([22, 23], name="temp_raw")
s2 = s.rename("temperature_C")
print(s2.name)

temperature_C

Пример 5. errors=»raise»

import pandas as pd

df = pd.DataFrame({"a": [1, 2]})
try:
    df.rename(columns={"x": "y"}, errors="raise")
except KeyError as e:
    print("ошибка:", str(e)[:50])

ошибка: "['x'] not found in axis"

См. также

Примечание

Лицензия и источники

Техническое описание функции адаптировано из официальной документации Pandas (https://pandas.pydata.org/docs/), BSD-3-Clause License. Примеры и пояснения — © AlashEd Wiki.