pandas.CategoricalIndex.add_categories

CategoricalIndex.add_categories(self, *args, **kwargs)

Add new categories.

new_categories will be included at the last/highest place in the categories and will be unused directly after this call.

Parameters

new_categoriescategory or list-like of category

The new categories to be included.

inplacebool, default False

Whether or not to add the categories inplace or return a copy of this categorical with added categories.

Returns

catCategorical with new categories added or None if inplace.

Raises

ValueError

If the new categories include old categories or do not validate as categories

See also

rename_categories

reorder_categories

remove_categories

remove_unused_categories

set_categories

pandas.CategoricalIndex.reorder_categories pandas.CategoricalIndex.remove_categories