noggin.xarray.concat_experiments

noggin.xarray.concat_experiments(*exps) → xarray.core.dataset.Dataset[source]

Concatenates xarray data sets from a sequence of experiments.

Specifically, data sets that record identical metrics measured across several independent experiments will be concatenated along a new dimension, ‘experiment’, which tracks the experiment-index associated with the corresponding array of metrics.

Parameters:
*exps: Dataset

One or more data sets recording metrics across independent runs of an experiment.

Returns:
Dataset

The recorded metrics joined into a single data set, along an experiment-index dimension.

Notes

The form of the resulting Dataset is:

Dimensions:     (experiment: num_exps, iterations: max_num_its)
Coordinates:
  * experiment  (experiment) int32 0 1 2 ...
  * iterations  (iterations) int64 1 2 3 ...
Data variables:
    metric0      (experiment, iterations) float64 val_0 val_1 ...
    metric1      (experiment, iterations) float64 val_0 val_1 ...
    ...