pandas.Categorical.array — pandas 2.3.0 documentation (original) (raw)

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

The numpy array interface.

Users should not call this directly. Rather, it is invoked bynumpy.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.

Examples

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

The following calls cat.__array__

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