pandas.Series.cat.set_categories

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

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

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

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

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

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

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories