pandas.Categorical

class pandas.Categorical(values, categories=None, ordered=None, dtype=None, fastpath=False) [source]

Представляет категориальную переменную в стиле классического R / S-plus.

Categoricals может принимать только ограниченное, и обычно фиксированное, число возможных значений (categories). В отличие от статистических категориальных переменных, Categorical может иметь порядок, но арифметические операции (сложение, деление и т. д.) невозможны.

Все значения Categorical находятся либо в categories, либо в np.nan. Присвоение значений за пределами categories вызовет ValueError. Порядок определяется порядком categories, а не лексикографическим порядком значений.

Параметры:

values : list-like Значения категориальной переменной. Если категории указаны, значения, отсутствующие в категориях, будут заменены NaN. categories : Index-like (unique), optional Уникальные категории для этой категориальной переменной. Если не указаны, категории предполагаются уникальными значениями values (отсортированные, если возможно, в противном случае в порядке их появления). ordered : bool, default False Указывает, рассматривается ли эта категориальная переменная как упорядоченная. Если True, результирующая категориальная переменная будет упорядоченной. Упорядоченная категориальная переменная учитывает при сортировке порядок её атрибута categories (который, в свою очередь, является аргументом categories, если указан). dtype : CategoricalDtype Экземпляр CategoricalDtype для использования с этой категориальной переменной Введено в версии 0.21.0.

Возбуждает:

ValueError Если категории не валидны. TypeError Если явный ordered=True задан, но нет categories, и values не могут быть отсортированы.

См. также

api.types.CategoricalDtype

Тип для категориальных данных.

CategoricalIndex

Индекс с базовым Categorical.

Примечания

Дополнительную информацию см. в руководстве пользователя.

Примеры

>>> pd.Categorical([1, 2, 3, 1, 2, 3])
[1, 2, 3, 1, 2, 3]
Categories (3, int64): [1, 2, 3]

>>> pd.Categorical(['a', 'b', 'c', 'a', 'b', 'c'])
[a, b, c, a, b, c]
Categories (3, object): [a, b, c]

Упорядоченные Categoricals могут быть отсортированы в соответствии с пользовательским порядком категорий и иметь минимальное и максимальное значение.

>>> c = pd.Categorical(['a', 'b', 'c', 'a', 'b', 'c'], ordered=True,
...                    categories=['c', 'b', 'a'])
>>> c
[a, b, c, a, b, c]
Categories (3, object): [c < b < a]
>>> c.min()
'c'

Атрибуты

categories	Категории этой категориальной переменной.
codes	Коды категорий этой категориальной переменной.
ordered	Указывает, имеют ли категории упорядоченные отношения.
dtype	Тип CategoricalDtype для данного экземпляра.

Методы

from_codes(codes[, categories, ordered, dtype])	Создать тип Categorical из кодов и категорий или типа.
__array__(self[, dtype])	Интерфейс массива NumPy.