ak.from_categorical#
Defined in awkward.operations.ak_from_categorical on line 13.
- ak.from_categorical(array, *, highlevel=True, behavior=None, attrs=None)#
- Parameters:
array – Array-like data (anything
ak.to_layout
recognizes).highlevel (bool) – If True, return an
ak.Array
; otherwise, return a low-levelak.contents.Content
subclass.behavior (None or dict) – Custom
ak.behavior
for the output array, if high-level.attrs (None or dict) – Custom attributes for the output array, if high-level.
This function replaces categorical data with non-categorical data (by removing the label that declares it as such).
This is a metadata-only operation; the running time does not scale with the size of the dataset. (Conversion to categorical is expensive; conversion from categorical is cheap.)
See also ak.is_categorical
, ak.categories
, ak.str.to_categorical
.