Spec-Zone.ru › pandas 0.18

pandas.Series.cat.set_categories

Series.cat.set_categories(*args, **kwargs)

Устанавливает категории в указанные новые категории 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

© 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.18.1/generated/pandas.Series.cat.set_categories.html

Spec-Zone.ru

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