Results Reference#

DiffBench stores experiment-level and aggregated outputs in structured files so that results can be inspected, compared, or processed programmatically.

For an overview of the analysis workflow, see Analysis.

Analysis outputs#

The analysis pipeline typically writes aggregated results under:

exp_outputs/summary/

global_metrics.parquet#

Contains the fold-level metrics collected across experiments.

This table can be used when analyses require access to individual cross-validation folds rather than only experiment-level summaries.

summary_metrics.parquet#

Contains metrics aggregated across folds for each experiment.

Typical summaries include the mean and standard deviation of the evaluation metrics.

comprehensive_table.parquet#

Contains one row per experiment and combines:

  • aggregated performance metrics;

  • experiment identifiers;

  • flattened experiment configuration values.

This table is useful for comparing experiment settings and filtering benchmark results.

Dataset reports#

Files following the pattern:

<dataset>_report.txt

provide human-readable summaries for individual datasets, including experiment comparisons and best-performing runs.

Coverage table#

coverage_table.txt

summarizes which combinations of datasets, models, targets, and tissue representations are available in the experiment results.

Coverage table encoding#

Coverage cells use a compact two-character code describing the tissue representation and prediction target.

The first character represents the tissue:

g = gray matter
w = white matter

The second character represents the target:

g = gender
a = age
d = diagnosis

For example:

gg

represents gray matter with gender as the prediction target, while:

wa

represents white matter with age as the prediction target.

Plot outputs#

Per-run plots are stored under:

exp_outputs/plots/<run_id>/

The exact visualisations depend on the experiment and the selected analysis configuration.