pandas.Categorical.from_codes#

метод класса Categorical.from_codes(коды, категории=None, ordered=None, dtype=None, проверять=True)[источник]#

Создать категориальный тип из кодов и категорий или dtype.

Этот конструктор полезен, если у вас уже есть коды и категории/тип данных, и вам не нужен (вычислительно затратный) этап факторизации, который обычно выполняется в конструкторе.

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

Параметры:
кодыarray-like из int

Целочисленный массив, где каждое целое число указывает на категорию в categories или dtype.categories, или равно -1 для NaN.

категорииподобный индексу, опционально

Категории для категориальных данных. Элементы должны быть уникальными. Если категории не указаны здесь, то они должны быть предоставлены в dtype.

orderedbool, необязательно

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

dtypeCategoricalDtype или «category», optional

Если CategoricalDtype, не может использоваться вместе с категории или ordered.

проверятьbool, по умолчанию True

Если True, проверяет, что коды допустимы для dtype. Если False, не проверяет допустимость кодов. Будьте осторожны при пропуске проверки, так как недопустимые коды могут привести к серьезным проблемам, таким как сегфолты.

Добавлено в версии 2.1.0.

Возвращает:
Категориальный

Примеры

>>> 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']