pandas.CategoricalIndex.set_categories

CategoricalIndex.set_categories(*args, **kwargs)

Устанавливает категории в указанные новые категории new_categories.

new_categories может включать новые категории (что приведёт к неиспользуемым категориям) или удалять старые категории (что приведёт к значениям, установленным в NaN). Если rename==True, категории будут просто переименованы (меньше или больше элементов, чем в старых категориях, приведёт к значениям, установленным в NaN, или к неиспользуемым категориям соответственно).

Этот метод может использоваться для выполнения более чем одного действия по добавлению, удалению и переупорядочению одновременно и, следовательно, быстрее, чем выполнение отдельных шагов через более специализированные методы.

С другой стороны, этот метод не выполняет проверок (например, о том, включены ли старые категории в новые категории при переупорядочивании), что может привести к неожиданным изменениям, например, при использовании специальных типов данных строк на python3, который не считает строку S1 равной строке с одиночным символом python.

Параметры:	new_categories : Index-like Категории в новом порядке. ordered : boolean, (по умолчанию: False) Является ли категориальное значение категориальным значением с порядком. Если не задано, не изменяйте информацию о порядке. rename : boolean (по умолчанию: False) Являются ли новые категории переименованием старых категорий или переупорядоченными категориями. inplace : boolean (по умолчанию: False) Переупорядочить ли категории на месте или вернуть копию этой категориальной переменной с переупорядоченными категориями.
Возвращает:	cat : Categorical с переупорядоченными категориями или None, если inplace.
Исключения:	ValueError Если new_categories не валидируются как категории

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories