pandas.CategoricalIndex.remove_categories

CategoricalIndex.remove_categories(self, *args, **kwargs)[source]

Remove the specified categories.

removals must be included in the old categories. Values which were in the removed categories will be set to NaN

Parameters
removalscategory or list of categories

The categories which should be removed.

inplacebool, default False

Whether or not to remove the categories inplace or return a copy of this categorical with removed categories.

Returns
catCategorical with removed categories or None if inplace.
Raises
ValueError

If the removals are not contained in the categories