Module « pandas »

Classe « CategoricalDtype »

Informations générales

Héritage

    builtins.object
        ExtensionDtype
builtins.object
    ExtensionDtype
        PandasExtensionDtype
            CategoricalDtype

Définition

class CategoricalDtype(PandasExtensionDtype, ExtensionDtype):

Description _{[extrait de CategoricalDtype.__doc__]}

    Type for categorical data with the categories and orderedness.

    Parameters
    ----------
    categories : sequence, optional
        Must be unique, and must not contain any nulls.
        The categories are stored in an Index,
        and if an index is provided the dtype of that index will be used.
    ordered : bool or None, default False
        Whether or not this categorical is treated as a ordered categorical.
        None can be used to maintain the ordered value of existing categoricals when
        used in operations that combine categoricals, e.g. astype, and will resolve to
        False if there is no existing ordered to maintain.

    Attributes
    ----------
    categories
    ordered

    Methods
    -------
    None

    See Also
    --------
    Categorical : Represent a categorical variable in classic R / S-plus fashion.

    Notes
    -----
    This class is useful for specifying the type of a ``Categorical``
    independent of the values. See :ref:`categorical.categoricaldtype`
    for more.

    Examples
    --------
    >>> t = pd.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']

    An empty CategoricalDtype with a specific dtype can be created
    by providing an empty index. As follows,

    >>> pd.CategoricalDtype(pd.DatetimeIndex([])).categories.dtype
    dtype('<M8[ns]')
    

Constructeur(s)

Signature du constructeur	Description
__init__(self, categories=None, ordered: Optional[bool] = False)

Propriétés héritées de la classe PandasExtensionDtype

kind, name, type

Opérateurs hérités de la classe ExtensionDtype

__ne__

Opérateurs hérités de la classe object

__ge__, __gt__, __le__, __lt__

Méthodes héritées de la classe PandasExtensionDtype

__getstate__, __init_subclass__, __str__, __subclasshook__, reset_cache

Méthodes héritées de la classe ExtensionDtype

is_dtype

Méthodes héritées de la classe object

__delattr__, __dir__, __format__, __getattribute__, __reduce__, __reduce_ex__, __setattr__, __sizeof__