pandas.CategoricalIndex.set_categories

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

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

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

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

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

Параметры

new_categories:Индекс-подобный

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

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

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

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

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

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

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

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

Возвращает

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

Возбуждает

ValueError

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

См. также

rename_categories

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

reorder_categories

Переупорядочить категории.

add_categories

Добавить новые категории.

remove_categories

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

remove_unused_categories

Удалить неиспользуемые категории.