nicetoolbox.evaluation.data.summary.pair_arrays_to_df

nicetoolbox.evaluation.data.summary.pair_arrays_to_df(pairs: list[tuple[nicetoolbox.evaluation.data.input_loader.LoadedArray, nicetoolbox.evaluation.data.input_loader.LoadedArray]], value_names: tuple[str, str] = ('pred', 'gt')) → DataFrame

Join paired prediction/ground-truth arrays into a single long-format DataFrame.

Parameters:

• pairs (list) – List of (prediction, ground_truth) LoadedArray pairs as returned by align_arrays.

• value_names – Column names for the prediction and ground truth values respectively.

Returns:

Long-format DataFrame with one row per (meta…, subject, camera, frame, label) coordinate, or an empty DataFrame if pairs is empty.

Raises:

ValueError – If the axis merge loses rows, indicating a violated align_arrays invariant.