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