pandas.Series.cat.add_categories

Series.cat.add_categories(*args, **kwargs)[source]

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

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

Параметры

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

Новые категории для включения.

inplace:bool, по умолчанию False

Добавлять ли категории на месте или возвращать копию этой категориальной переменной с добавленными категориями.

Устарело начиная с версии 1.3.0.

Возвращает

cat:Categorical или None

Категориальная переменная с добавленными новыми категориями или None, если inplace=True.

Возбуждает

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']