pandas.Series.cat.set_categories

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

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

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

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

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

Параметры

new_categories:Index-like

Категории в новом порядке.

ordered:bool, по умолчанию False

Определяет, рассматривается ли категориальный признак как упорядоченный категориальный признак. Если не указано, информация об упорядоченности не изменяется.

rename:bool, по умолчанию False

Определяет, следует ли рассматривать новые категории как переименование старых категорий или как переупорядоченные категории.

inplace:bool, по умолчанию False

Определяет, следует ли переупорядочить категории на месте или вернуть копию этой категориальной переменной с переупорядоченными категориями.

Устарело начиная с версии 1.3.0.

Возвращает

Категориальная переменная с переупорядоченными категориями или None, если inplace.

Возбуждает

ValueError

Если new_categories не валидируется как категории

См. также

rename_categories

Переименование категорий.

reorder_categories

Переупорядочивание категорий.

add_categories

Добавление новых категорий.

remove_categories

Удаление указанных категорий.

remove_unused_categories

Удаление категорий, которые не используются.