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]