pandas.Series.cat.remove_categories#
- Series.cat.remove_categories(*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.
Deprecated since version 1.3.0.
- Returns
- catCategorical or None
Categorical with removed categories or None if
inplace=True
.
- Raises
- ValueError
If the removals are not contained in the categories
See also
rename_categories
Rename categories.
reorder_categories
Reorder categories.
add_categories
Add new categories.
remove_unused_categories
Remove categories which are not used.
set_categories
Set the categories to the specified ones.
Examples
>>> c = pd.Categorical(['a', 'c', 'b', 'c', 'd']) >>> c ['a', 'c', 'b', 'c', 'd'] Categories (4, object): ['a', 'b', 'c', 'd']
>>> c.remove_categories(['d', 'a']) [NaN, 'c', 'b', 'c', NaN] Categories (2, object): ['b', 'c']