pandas.Series.cat.set_categories

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

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

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

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

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

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

См. также

rename_categories, reorder_categories, add_categories, remove_categories, remove_unused_categories