pandas.Series.cat.set_categories

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

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

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

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

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

Параметры:	new_categories : Подобный индексу Категории в новом порядке. 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