ak.materialize#

Defined in awkward.operations.ak_materialize on line 12.

ak.materialize(array, highlevel=True, behavior=None, attrs=None)#

Materializes any virtual buffers in the array.

If the input array is not an ak.Array or an ak.contents.Content, an error will be raised.

The buffers of the returned array are no longer VirtualNDArray objects even if there were any. They will become one of numpy.ndarray, cupy.ndarray, or jax.numpy.ndarray objects, depending on the array’s backend.

Parameters:

  • array – Array-like data (either an ak.Array or an ak.contents.Content). An array that may contain virtual buffers to be materialized.

  • highlevel (bool, default is True) – 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.

Returns:

An array with the same data as the input and all virtual buffers materialized.