pandas.CategoricalIndex.set_categories

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

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

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

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

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

Параметры:	new_categories : Index-like Категории в новом порядке. ordered : bool, default False Указывает, обрабатывается ли категориальный ряд как упорядоченный. Если не указано, информация об упорядоченности не изменяется. rename : bool, default False Указывает, должны ли новые категории рассматриваться как переименование старых категорий или как переупорядоченные категории. inplace : bool, default False Указывает, необходимо ли переупорядочить категории на месте или вернуть копию этого категориального ряда с переупорядоченными категориями.
Возвращает:	Категориальный ряд с переупорядоченными категориями или None, если используется inplace.
Возможные исключения:	ValueError Если new_categories не валидируются как категории

См. также

rename_categories

reorder_categories

add_categories

remove_categories

remove_unused_categories