pandas.CategoricalIndex.reorder_categories

CategoricalIndex.reorder_categories(*args, **kwargs)[source]

Reorder categories as specified in new_categories.

new_categories need to include all old categories and no new category items.

Parameters

new_categories:Index-like: The categories in new order.
ordered:bool, optional: Whether or not the categorical is treated as a ordered categorical. If not given, do not change the ordered information.
inplace:bool, default False: Whether or not to reorder the categories inplace or return a copy of this categorical with reordered categories.

Deprecated since version 1.3.0.

Returns

cat:Categorical or None: Categorical with removed categories or None if inplace=True.

Raises

ValueError: If the new categories do not contain all old category items or any new ones