agentsclimarketplace

Baseline comparison analysis

Skill HolobiomicsLab/asb-skill-collections/packs/metabolomics/lc-ms/skills/baseline-comparison-analysis

Use when when you have trained a candidate model (e.g., an ensemble, a new architecture) and need to demonstrate its advantage over published or reference implementations on the same test data.From its SKILL.md

Install
npx -y skills add HolobiomicsLab/asb-skill-collections --skill baseline-comparison-analysis

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its file declares

Copied from the file, not written here

The file declares its own license as CC-BY-4.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

7.6 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it

baseline-comparison-analysis

Summary

Quantitatively compare a novel model's performance against established baseline methods on a standardized test dataset, using consistent evaluation metrics to measure percentage improvement. This skill isolates and validates the contribution of the proposed approach by isolating confounding factors and computing reproducible performance deltas.

When to use

When you have trained a candidate model (e.g., an ensemble, a new architecture) and need to demonstrate its advantage over published or reference implementations on the same test data. Specifically when the goal is to measure ranking-based metabolite annotation performance or similar IR-style metrics where average rank and Rank@K are the primary signals, and a baseline model's predictions are already available or can be reproduced from published code.

When NOT to use

  • When test data has not been held out — using training or validation data for comparison introduces optimistic bias.
  • When baseline and candidate models are evaluated with different hyperparameters, preprocessing pipelines, or data augmentations — this confounds architecture contribution with tuning choices.
  • When the baseline model has not been independently reproduced or verified — relying on reported numbers without code verification risks propagating errors or misinterpretation of metrics.

Inputs

  • Baseline model checkpoint (e.g., best_model_mlp_can.pt)
  • Candidate model checkpoint (e.g., ESP_can.pt)
  • Test spectra dataset (ESI/LC-MS, e.g., NPLIB1 or NIST-20 subset)
  • Test candidate set with NIST InChiKey targets

Outputs

  • Average rank metric for baseline model
  • Average rank metric for candidate model
  • Rank@K curves for both models (k=1 to 20)
  • Percentage improvement table (((ESP_rank − MLP_rank) / MLP_rank) × 100)
  • Comparison summary (e.g., 23.7% improvement as reported)

How to apply

Load both the baseline model (e.g., MLP/NEIMS) and the candidate model (e.g., ESP ensemble) from their respective published checkpoints. Apply both models to identical test spectra (ESI/LC-MS dataset in this case) to generate separate prediction rankings. Compute the average rank metric for each model's outputs on the full NIST candidate set. Calculate the percentage improvement as ((ESP_rank − MLP_rank) / MLP_rank) × 100, where lower average rank indicates better performance. Generate a side-by-side comparison table showing both raw metrics (average rank ± std, Rank@K values for k=1 to 20) and the derived percentage gain. Validate that the comparison uses the same hyperparameters, data splits, and evaluation protocol for both models to ensure fair attribution of improvement to the model architecture rather than to configuration differences.

Related tools

Examples

python ens_train_canopus.py --cuda 0 --disable_two_step_pred --disable_fingerprint --disable_mt_fingerprint --disable_mt_ontology --correlation_mat_rank 100 --full_dataset --mode 'canopus'

Evaluation signals

  • Average rank for MLP baseline on test set matches published baseline performance (e.g., 339.350 ± 1264.715 for NPLIB1).
  • Average rank for candidate model (ESP) shows lower rank than baseline, indicating better ranking performance.
  • Percentage improvement calculation is mathematically correct: ((ESP_rank − MLP_rank) / MLP_rank) × 100 yields the claimed 23.7% or similar magnitude.
  • Rank@K metrics (k=1–20) for candidate model are consistent with or superior to baseline across all k values, showing improved performance at all recall levels.
  • Standard deviation and sample counts for average rank are reported, confirming statistical rigor; confidence intervals or significance tests may be employed to verify improvement is not due to random variation.

Limitations

  • Comparison is limited to NPLIB1 public data; models trained on NIST-20 cannot be published due to licensing restrictions, so reproducibility on that dataset is unavailable to external researchers.
  • The 23.7% improvement is measured on ESI/LC-MS data only; improvement does not transfer to EI/GC-MS data (as explicitly noted in the README), limiting generalization claims.
  • Average rank is sensitive to outliers (high-rank false candidates), so datasets with very large candidate pools may show inflated standard deviations; median rank or trimmed statistics may be more robust in such cases.
  • The baseline MLP implementation is a generalized version of the NEIMS model adapted to the NPLIB1 dataset; direct reproduction of the original NEIMS model's performance on its native EI/GC-MS data is not provided for comparison.

Evidence

  • [other] Calculate the percentage improvement as ((ESP_rank − MLP_rank) / MLP_rank) × 100: "Calculate the percentage performance gain: ((ESP_rank − MLP_rank) / MLP_rank) × 100, targeting 23.7% improvement."
  • [readme] 23.7% improvement on NPLIB1 test spectra with baseline model: "We have shown improvements with ESP over the MLP model (implementation of NEIMS model (Wei et al., 2019) with a generalized dataset ESI/LC-MS but not EI/GC-MS data in NEIMS), in terms of a 23.7%"
  • [other] Load both models and apply to identical test spectra to generate predictions: "Generate predictions on test spectra using the MLP baseline model. 4. Generate predictions on the same test spectra using the ESP ensemble model"
  • [other] Compute average rank and Rank@K metrics for both models: "Our results, measured in average rank and Rank@K for the test spectra, show remarkable performance gain over existing neural network approaches."
  • [readme] Example baseline MLP output showing average rank 339.350: "Average rank 339.350 +- 1264.715 Rank at 1 0.230 Rank at 2 0.310"
  • [readme] Limitation: improvement does not transfer to EI/GC-MS data: "We have shown improvements with ESP over the MLP model (implementation of NEIMS model (Wei et al., 2019) with a generalized dataset ESI/LC-MS but not EI/GC-MS data in NEIMS)"

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,861. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.