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
-
Если новые категории не проверяются как категории
-
© 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