pandas.CategoricalIndex.rename_categories

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