pandas.Categorical.from_codes
- classmethodCategorical.from_codes(codes, categories=None, ordered=None, dtype=None, validate=True)[source]
-
Создание типа Categorical из кодов и категорий или типа данных.
Этот конструктор полезен, если у вас уже есть коды и категории/тип данных, и вам не нужен (ёмкий по вычислениям) этап факторизации, который обычно выполняется в конструкторе.
Если ваши данные не соответствуют этому соглашению, используйте обычный конструктор.
- Параметры:
-
- codes:массив целых чисел
-
Массив целых чисел, где каждое целое число указывает на категорию в категориях или dtype.categories, или же равно -1 для NaN.
- categories:подобный индексу, необязательно
-
Категории для категориального типа. Элементы должны быть уникальными. Если категории не указаны здесь, то они должны быть указаны в dtype.
- ordered:bool, необязательно
-
Является ли категориальный тип упорядоченным. Если не указано здесь или в dtype, полученный категориальный тип будет неупорядоченным.
- dtype:CategoricalDtype или “category”, необязательно
-
Если
CategoricalDtype, нельзя использовать вместе с categories или ordered. - validate:bool, по умолчанию True
-
Если True, проверяет, являются ли коды допустимыми для типа данных. Если False, не проверяет, являются ли коды допустимыми. Будьте осторожны при пропуске проверки, так как недопустимые коды могут привести к серьёзным проблемам, таким как ошибки segfaults.
Добавлена в версии 2.1.0.
- Возвращает:
-
- Categorical
Примеры
>>> dtype = pd.CategoricalDtype(['a', 'b'], ordered=True) >>> pd.Categorical.from_codes(codes=[0, 1, 0, 1], dtype=dtype) ['a', 'b', 'a', 'b'] Categories (2, object): ['a' < 'b']
© 2008–2022, 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/2.2.2/reference/api/pandas.Categorical.from_codes.html