pandas.CategoricalIndex.reorder_categories

CategoricalIndex.reorder_categories(self, *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_categoriesIndex-like

The categories in new order.

orderedbool, optional

Whether or not the categorical is treated as a ordered categorical. If not given, do not change the ordered information.

inplacebool, default False

Whether or not to reorder the categories inplace or return a copy of this categorical with reordered categories.

Returns
catCategorical with reordered categories or None if inplace.
Raises
****ValueError

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

Scroll To Top