pandas.CategoricalIndex.set_categories

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

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

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

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

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

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

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories