pandas.CategoricalIndex.set_categories

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

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

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

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

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

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

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories