pyspark.pandas.CategoricalIndex.reorder_categories#

CategoricalIndex.reorder_categories(new_categories, ordered=None)[source]#

Reorder categories as specified in new_categories.

new_categories needs 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 an ordered categorical. If not given, do not change the ordered information.

Returns:
catCategoricalIndex

Categorical with removed categories

Raises:
ValueError

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

See also

rename_categories

Rename categories.

add_categories

Add new categories.

remove_categories

Remove the specified categories.

remove_unused_categories

Remove categories which are not used.

set_categories

Set the categories to the specified ones.

Examples

>>> idx = ps.CategoricalIndex(list("abbccc"))
>>> idx
CategoricalIndex(['a', 'b', 'b', 'c', 'c', 'c'],
                 categories=['a', 'b', 'c'], ordered=False, dtype='category')
>>> idx.reorder_categories(['c', 'b', 'a'])
CategoricalIndex(['a', 'b', 'b', 'c', 'c', 'c'],
                 categories=['c', 'b', 'a'], ordered=False, dtype='category')