pandas.CategoricalIndex.rename_categories

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

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

Параметры:	new_categories : список или словарь список: все элементы должны быть уникальными, и количество элементов в новых категориях должно соответствовать количеству существующих категорий. словарь: задаёт соответствие между старыми и новыми категориями. Категории, не содержащиеся в отображении, передаются, а дополнительные категории в отображении игнорируются. Введено в версии 0.21.0. Предупреждение В настоящее время Series рассматриваются как списки. В будущих версиях pandas они будут рассматриваться как словари. inplace : boolean (по умолчанию: False) Нужно ли переименовывать категории на месте или вернуть копию категориального объекта с переименованными категориями.
Возвращает:	cat : Categorical или None Если inplace=False, возвращается новый категориальный объект. Если inplace=True, значения не возвращаются.
Возможные исключения:	ValueError Если новые категории являются списком и не имеют такого же количества элементов, что и текущие категории, или не валидируются как категории.

См. также

reorder_categories, add_categories, remove_categories, remove_unused_categories, set_categories

Примеры

>>> c = 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]