pandas.api.types.union_categoricals

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

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

Введено в версии 0.19.0.

Параметры:	to_union : список категорий, CategoricalIndex или Series с типом данных ‘category’ sort_categories : boolean, по умолчанию False Если True, результирующие категории будут отсортированы лексикографически, в противном случае они будут упорядочены так, как они появляются в данных. ignore_order: boolean, по умолчанию False Если True, атрибут ordered категорий будет проигнорирован. Результатом будет неупорядоченная категория. Введено в версии 0.20.0.
Возвращает:	result : Categorical
Возможные исключения:	TypeError все входные данные не имеют одинаковый тип все входные данные не имеют одинаковый атрибут ordered все входные данные упорядочены и их категории не идентичны sort_categories=True и Categoricals упорядочены 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]