pandas.Series.cat.reorder_categories

Series.cat.reorder_categories(self, *args, **kwargs)

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

See also

rename_categories

add_categories

remove_categories

remove_unused_categories

set_categories

pandas.Series.cat.rename_categories pandas.Series.cat.add_categories