pandas.api.types.union_categoricals

pandas.api.types.union_categoricals(to_union, sort_categories=False, ignore_order=False) [source]

Объединение списка категориальных типов, объединяющее категории. Все категории должны иметь одинаковый тип.

Добавлена в версии 0.19.0.

Параметры:	to_union : list-like of Categorical, CategoricalIndex, или Series с типом ‘category’ sort_categories : boolean, default False Если True, результирующие категории будут отсортированы лексикографически, иначе они будут отсортированы так, как появляются в данных. ignore_order : boolean, default False Если True, атрибут ordered категорий будет игнорироваться. Результатом будет неупорядоченная категория. Добавлена в версии 0.20.0.
Возвращает:	result : Categorical
Возможные исключения:	TypeError все входные данные не имеют одинаковый тип все входные данные не имеют одинаковый атрибут ordered все входные данные упорядочены и их категории не идентичны sort_categories=True и категории упорядочены ValueError Передан пустой список категорий

Примечания

Дополнительную информацию о категориях см. на ссылке

Примеры

>>> from pandas.api.types import union_categoricals

Если вы хотите объединить категории, которые не обязательно имеют одинаковые категории, union_categoricals объединит список категорий. Новые категории будут представлять собой объединение объединяемых категорий.

>>> a = pd.Categorical(["b", "c"])
>>> b = pd.Categorical(["a", "b"])
>>> union_categoricals([a, b])
[b, c, a, b]
Categories (3, object): [b, c, a]

По умолчанию результирующие категории будут отсортированы так, как они появляются в categories данных. Если вы хотите, чтобы категории были лексикографически отсортированы, используйте параметр sort_categories=True.

>>> union_categoricals([a, b], sort_categories=True)
[b, c, a, b]
Categories (3, object): [a, b, c]

union_categoricals также работает в случае объединения двух категорий с одинаковыми категориями и информацией об упорядоченности (например, то, что вы также можете append).

>>> a = pd.Categorical(["a", "b"], ordered=True)
>>> b = pd.Categorical(["a", "b", "a"], ordered=True)
>>> union_categoricals([a, b])
[a, b, a, b, a]
Categories (2, object): [a < b]

Возникает TypeError, так как категории упорядочены и не идентичны.

>>> a = pd.Categorical(["a", "b"], ordered=True)
>>> b = pd.Categorical(["a", "b", "c"], ordered=True)
>>> union_categoricals([a, b])
TypeError: to union ordered Categoricals, all categories must be the same

Добавлена в версии 0.20.0

Упорядоченные категории с разными категориями или упорядочиваниями можно объединить, используя параметр ignore_ordered=True.

>>> a = pd.Categorical(["a", "b", "c"], ordered=True)
>>> b = pd.Categorical(["c", "b", "a"], ordered=True)
>>> union_categoricals([a, b], ignore_order=True)
[a, b, c, c, b, a]
Categories (3, object): [a, b, c]

union_categoricals также работает со CategoricalIndex, или Series содержащими категориальные данные, но обратите внимание, что результирующий массив всегда будет простым Categorical

>>> a = pd.Series(["b", "c"], dtype='category')
>>> b = pd.Series(["a", "b"], dtype='category')
>>> union_categoricals([a, b])
[b, c, a, b]
Categories (3, object): [b, c, a]