nicetoolbox.evaluation.data.input_loader.load_array

nicetoolbox.evaluation.data.input_loader.load_array(meta: NpzMeta, filters: NpzAxis) → LoadedArray | None[source]

Load one NPZ entry, read axis labels from data_description, and apply filters.

Parameters:

  • meta – Metadata describing the NPZ file path and key to load.

  • filters – Axis filter spec (subjects, cameras, labels, data) to apply after loading.

Returns:

LoadedArray with filtered data and axis labels, or None if any filtered axis has no overlap with the available labels.

Raises:

  • KeyError – If data_description is missing from the NPZ file or the requested key is absent from data_description.

  • ValueError – If the data array shape does not match data_description axis lengths.