Table Of Contents

Search

Enter search terms or a module, class or function name.

pandas.api.types.CategoricalDtype

class pandas.api.types.CategoricalDtype(categories=None, ordered=False)[source]

Type for categorical data with the categories and orderedness

Changed in version 0.21.0.

Parameters:

categories : sequence, optional

Must be unique, and must not contain any nulls.

ordered : bool, default False

Notes

This class is useful for specifying the type of a Categorical independent of the values. See CategoricalDtype for more.

Examples

>>> t = CategoricalDtype(categories=['b', 'a'], ordered=True)
>>> pd.Series(['a', 'b', 'a', 'c'], dtype=t)
0      a
1      b
2      a
3    NaN
dtype: category
Categories (2, object): [b < a]

Attributes

categories An Index containing the unique categories allowed.
ordered Whether the categories have an ordered relationship

Methods

None
Scroll To Top