pandas.CategoricalIndex.rename_categories

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

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

Параметры:	new_categories : list-like, dict-like or callable подобный списку: все элементы должны быть уникальными, и количество элементов в новых категориях должно соответствовать количеству существующих категорий. подобный словарю: задаёт отображение старых категорий на новые. Категории, отсутствующие в отображении, передаются без изменений, а дополнительные категории в отображении игнорируются. Введено в версии 0.21.0. вызываемый объект: вызываемый объект, который применяется ко всем элементам в старых категориях, и возвращаемые значения составляют новые категории. Введено в версии 0.23.0. inplace : bool, default False Определяет, переименовывать ли категории на месте или вернуть копию этой категории с переименованными категориями.
Возвращаемое значение:	cat : Categorical or None При inplace=False, возвращается новая категория. При 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]