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 : список-подобный объект Значения категориальной переменной. Если указаны категории, значения, не принадлежащие категориям, будут заменены на NaN. categories : индекс-подобный объект (уникальный), необязательно Уникальные категории для этой категориальной переменной. Если не указаны, категории предполагаются уникальными значениями из values. ordered : булево значение, (по умолчанию False) Указывает, считается ли категориальная переменная упорядоченной. Если не указано, категориальная переменная не будет упорядоченной. dtype : CategoricalDtype Экземпляр CategoricalDtype, используемый для этой категориальной переменной Добавлена в версии 0.21.0.

Исключения:

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

См. также

pandas.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'