pandas.Series.cat.rename_categories

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

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

Параметры:	new_categories : list-like, dict-like or callable подобный списку: все элементы должны быть уникальными, и количество элементов в новых категориях должно соответствовать количеству существующих категорий. подобный словарю: указывает отображение от старых категорий к новым. Категории, не содержащиеся в отображении, передаются как есть, а дополнительные категории в отображении игнорируются. Добавлена в версии 0.21.0. функция: функция, которая вызывается для всех элементов в старых категориях, а значения возврата составляют новые категории. Добавлена в версии 0.23.0. Предупреждение В настоящее время Series рассматриваются как подобные спискам. В будущих версиях pandas они будут рассматриваться как подобные словарям. inplace : boolean (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]