ak.to_list

Defined in awkward.operations.convert on line 891.

ak.to_list(array)

Converts array (many types supported, including all Awkward Arrays and Records) into Python objects.

Awkward Array types have the following Pythonic translations.

  • ak.types.PrimitiveType: converted into bool, int, float.

  • ak.types.OptionType: missing values are converted into None.

  • ak.types.ListType: converted into list.

  • ak.types.RegularType: also converted into list. Python (and JSON) forms lose information about the regularity of list lengths.

  • ak.types.ListType with parameter "__array__" equal to "__bytestring__": converted into bytes.

  • ak.types.ListType with parameter "__array__" equal to "__string__": converted into str.

  • ak.types.RecordArray without field names: converted into tuple.

  • ak.types.RecordArray with field names: converted into dict.

  • ak.types.UnionArray: Python data are naturally heterogeneous.

See also ak.from_iter and ak.Array.tolist.