ak.concatenate

Defined in awkward.operations.structure on line 1496.

ak.concatenate(arrays, axis=0, merge=True, mergebool=True, highlevel=True, behavior=None)
Parameters

  • arrays – Arrays to concatenate along any dimension.

  • axis (int) – The dimension at which this operation is applied. The outermost dimension is 0, followed by 1, etc., and negative values count backward from the innermost: -1 is the innermost dimension, -2 is the next level up, etc.

  • merge (bool) – If True, combine data into the same buffers wherever possible, eliminating unnecessary ak.layout.UnionArray8_64 types at the expense of materializing ak.layout.VirtualArray nodes.

  • mergebool (bool) – If True, boolean and numeric data can be combined into the same buffer, losing information about False vs 0 and True vs 1; otherwise, they are kept in separate buffers with distinct types (using an ak.layout.UnionArray8_64).

  • highlevel (bool) – If True, return an ak.Array; otherwise, return a low-level ak.layout.Content subclass.

  • behavior (None or dict) – Custom ak.behavior for the output array, if high-level.

Returns an array with arrays concatenated. For axis=0, this means that one whole array follows another. For axis=1, it means that the arrays must have the same lengths and nested lists are each concatenated, element for element, and similarly for deeper levels.