pandas.CategoricalIndex.add_categories

CategoricalIndex.add_categories(*args, **kwargs)[source]

Добавление новых категорий.

new_categories будут включены в конец/на верхнее место в категориях и не будут использоваться непосредственно после этого вызова.

Parameters:

new_categories:категория или список категорий

Новые категории, которые необходимо включить.

Returns:

Categorical

Категориальный объект с добавленными новыми категориями.

Raises:

ValueError

Если новые категории включают старые категории или не соответствуют требованиям к категориям.

См. также

rename_categories

Переименование категорий.

reorder_categories

Изменение порядка категорий.

remove_categories

Удаление указанных категорий.

remove_unused_categories

Удаление неиспользуемых категорий.

set_categories

Установка категорий к заданным значениям.

Примеры

>>> c = pd.Categorical(['c', 'b', 'c'])
>>> c
['c', 'b', 'c']
Categories (2, object): ['b', 'c']

>>> c.add_categories(['d', 'a'])
['c', 'b', 'c']
Categories (4, object): ['b', 'c', 'd', 'a']