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_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.
Deprecated since version 1.3.0.
- Returns
- catCategorical 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
See also
rename_categoriesRename categories.
add_categoriesAdd new categories.
remove_categoriesRemove the specified categories.
remove_unused_categoriesRemove categories which are not used.
set_categoriesSet the categories to the specified ones.