ak.concatenate — Awkward Array documentation

# ak.concatenate

Defined in awkward.operations.structure on line 1497.

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.