ak.with_parameter

Defined in awkward.operations.ak_with_parameter on line 15.

ak.with_parameter(array, parameter, value, *, highlevel=True, behavior=None, attrs=None)

Parameters:

• array – Array-like data (anything ak.to_layout recognizes).

• parameter (str) – Name of the parameter to set on that array.

• value (JSON) – Value of the parameter to set on that array.

• highlevel (bool) – If True, return an ak.Array; otherwise, return a low-level ak.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 returns a new array with a parameter set on the outermost node of its ak.Array.layout.

Note that a “new array” is a lightweight shallow copy, not a duplication of large data buffers.

You can also remove a single parameter with this function, since setting a parameter to None is equivalent to removing it.