pandas.Categorical.__array__#

Categorical.__array__(dtype=None, copy=None)[source]#

The numpy array interface.

Users should not call this directly. Rather, it is invoked by numpy.array() and numpy.asarray().

Parameters:
dtypenp.dtype or None

Specifies the the dtype for the array.

copybool or None, optional

See numpy.asarray().

Returns:
numpy.array

A numpy array of either the specified dtype or, if dtype==None (default), the same dtype as categorical.categories.dtype.

See also

numpy.asarray

Convert input to numpy.ndarray.

Examples

>>> cat = pd.Categorical(["a", "b"], ordered=True)

The following calls cat.__array__

>>> np.asarray(cat)
array(['a', 'b'], dtype=object)