pandas.Series.cat.rename_categories

Series.cat.rename_categories(*args, **kwargs)[source]

Переименование категорий.

Параметры:

new_categories:подобный списку, подобный словарю или вызываемый объект

Новые категории, которые заменят старые категории.

• подобный списку: все элементы должны быть уникальными, и количество элементов в новых категориях должно соответствовать количеству существующих категорий.

• подобный словарю: задаёт отображение старых категорий на новые. Категории, не содержащиеся в отображении, передаются как есть, а дополнительные категории в отображении игнорируются.

• вызываемый объект : вызываемый объект, который вызывается для всех элементов в старых категориях, а возвращаемые значения составляют новые категории.

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

Категориальные данные

Категориальные данные с переименованными категориями.

Исключения:

ValueError

Если новые категории подобны списку и не имеют такого же количества элементов, что и текущие категории, или не проходят проверку как категории

См. также

reorder_categories

Переупорядочить категории.

add_categories

Добавить новые категории.

remove_categories

Удалить указанные категории.

remove_unused_categories

Удалить неиспользуемые категории.

set_categories

Установить категории в указанные.

Примеры

>>> c = pd.Categorical(['a', 'a', 'b'])
>>> c.rename_categories([0, 1])
[0, 0, 1]
Categories (2, int64): [0, 1]

Для подобного словарю new_categories, дополнительные ключи игнорируются, а категории, отсутствующие в словаре, передаются как есть

>>> c.rename_categories({'a': 'A', 'c': 'C'})
['A', 'A', 'b']
Categories (2, object): ['A', 'b']

Вы также можете предоставить вызываемый объект для создания новых категорий

>>> c.rename_categories(lambda x: x.upper())
['A', 'A', 'B']
Categories (2, object): ['A', 'B']