cudf.core.column.categorical.CategoricalAccessor.add_categories#

CategoricalAccessor.add_categories(new_categories: Any) SeriesOrIndex | None[source]#

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.

Returns:
cat

Categorical with new categories added.

Examples

>>> import cudf
>>> s = cudf.Series([1, 2], dtype="category")
>>> s
0    1
1    2
dtype: category
Categories (2, int64): [1, 2]
>>> s.cat.add_categories([0, 3, 4])
0    1
1    2
dtype: category
Categories (5, int64): [1, 2, 0, 3, 4]
>>> s
0    1
1    2
dtype: category
Categories (2, int64): [1, 2]