pandas.CategoricalIndex.rename_categories

CategoricalIndex.rename_categories(*args, **kwargs)[source]

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

Параметры:

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

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

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

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

• вызываемая функция: вызываемая функция, которая применяется ко всем элементам старых категорий, а значения возврата составляют новые категории.

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

Categorical

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

Исключения:

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']