pandas.Series.cat.rename_categories

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

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

Параметры

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

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

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

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

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

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

Определяет, переименовывать ли категории на месте или вернуть копию этой категориальной переменной с переименованными категориями.

Устарело начиная с версии 1.3.0.

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

cat:Categorical или None

Категориальная переменная со удаленными категориями или None, если inplace=True.

Исключения

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