Spec-Zone.ru › pandas 0.25

pandas.Series.cat.set_categories

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

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

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

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

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

Параметры:
new_categories : Index-like

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

ordered : bool, default False

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

rename : bool, default False

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

inplace : bool, default False

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

Возвращает:
Категориальная переменная с переупорядоченными категориями или None, если используется inplace.
Исключения:
ValueError

Если новые категории не проверяются как категории

См. также

rename_categories
reorder_categories
add_categories
remove_categories
remove_unused_categories

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.Series.cat.set_categories.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API