pandas.Series.cat.rename_categories

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

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

Параметры:	new_categories : список, словарь или вызываемый объект список: все элементы должны быть уникальными, а количество элементов в новых категориях должно соответствовать количеству существующих категорий. словарь: определяет отображение старых категорий на новые. Категории, отсутствующие в отображении, пропускаются, а дополнительные категории в отображении игнорируются. Введено в версии 0.21.0. вызываемый объект: вызываемый объект, который применяется к всем элементам старых категорий, а значения возврата образуют новые категории. Введено в версии 0.23.0. Предупреждение В настоящее время Series считаются похожими на списки. В будущих версиях pandas они будут считаться похожими на словари. inplace : булево (по умолчанию: False) Определяет, переименовать ли категории на месте или вернуть копию этой категориальной переменной с переименованными категориями.
Возвращает:	cat : Категориальная переменная или 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]

Также можно указать вызываемый объект для создания новых категорий.

>>> c.rename_categories(lambda x: x.upper())
[A, A, B]
Categories (2, object): [A, B]