pandas.core.categorical.Categorical.rename_categories

Categorical.rename_categories(new_categories, inplace=False)

Renames categories.

The new categories has to be a list-like object. All items must be unique and the number of items in the new categories must be the same as the number of items in the old categories.

Parameters :

new_categories : Index-like

The renamed categories.

inplace : boolean (default: False)

Whether or not to rename the categories inplace or return a copy of this categorical with renamed categories.

Returns :

cat : Categorical with renamed categories added or None if inplace.

Raises :

ValueError

If the new categories do not have the same number of items than the current categories or do not validate as categories

See also

reorder_categories, add_categories, remove_categories, remove_unused_categories, set_categories