pandas.Series.rename

Series.rename(index=None, *, axis=None, copy=True, inplace=False, level=None, errors='ignore')[source]

Изменение меток индекса или имени Series.

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

В качестве альтернативы, измените Series.name на скалярное значение.

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

Параметры

index:скалярное значение, хешируемая последовательность, dict-подобный объект или функция необязательно

Функции или dict-подобные объекты – это преобразования, применяемые к индексу. Скалярное значение или хешируемая последовательность изменят атрибут Series.name.

axis:{0 или ‘index’}

Не используется. Параметр необходим для совместимости с DataFrame.

copy:bool, по умолчанию True

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

inplace:bool, по умолчанию False

Возвращать ли новую Series. Если True, значение copy игнорируется.

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

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

errors:{‘ignore’, ‘raise’}, по умолчанию ‘ignore’

Если ‘raise’, возникает KeyError, когда dict-подобный маппер или index содержат метки, отсутствующие в преобразуемом индексе. Если ‘ignore’, существующие ключи будут переименованы, а дополнительные ключи будут проигнорированы.

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

Series или None

Series с измененными метками индекса или именем, или None, если inplace=True.

См. также

DataFrame.rename

Соответствующий метод DataFrame.

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