pandas.CategoricalIndex.set_categories

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

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

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

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

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

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

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories