Score distribution analysis and statistical significance testing
Curated, evidence-grounded skill and software-tool collections for scientific AI agents, generated by the AgenticScienceBuilder
npx -y skills add HolobiomicsLab/asb-skill-collections --skill score-distribution-analysis-and-statistical-significance-testingAssembled 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 author says it does
Copied from the file, not written here
Use when after computing a scoring function over all possible genomic-metabolomic candidate pairs (e.g., all 2966 MIBiG-GNPS BGC-spectrum pairs), when you have a subset of known validated links and need to assess whether the scoring function ranks them significantly higher than expected by chance.
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
8.3 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it
score-distribution-analysis-and-statistical-significance-testing
Summary
Analyze the distribution of link-scoring function outputs (e.g., IOKR, strain correlation) across all candidate pairs and compare validated links against the null distribution using statistical hypothesis tests to quantify enrichment. This skill determines whether a scoring function reliably separates true BGC-spectrum pairs from spurious matches.
When to use
After computing a scoring function over all possible genomic-metabolomic candidate pairs (e.g., all 2966 MIBiG-GNPS BGC-spectrum pairs), when you have a subset of known validated links and need to assess whether the scoring function ranks them significantly higher than expected by chance. Apply this skill to decide whether a single scoring function is sufficiently discriminative, or whether multiple scores must be combined.
When NOT to use
- No validated link ground truth is available; statistical tests require a known positive set to contrast against the null distribution.
- Scoring function output is categorical or ordinal rather than continuous numeric; choose rank-based or contingency-table tests instead.
- Sample size is very small (validated subset <5–10 pairs); statistical power will be insufficient and visual inspection alone may be more honest.
Inputs
- Scoring function output (numeric scores) for all candidate pairs (e.g., 2966 BGC-spectrum pairs)
- Curated list of validated/true links (subset of the candidate pairs with known correct matches)
- Optionally, multiple scoring functions to be compared or combined
Outputs
- Mean score and standard deviation for all pairs and validated subset
- P-value and test statistic quantifying enrichment of validated links
- Distribution histogram(s) with validated link positions overlaid
- Percentile-based enrichment table (e.g., proportion of validated links above the 90th percentile)
- Ranking metrics such as top-n accuracy and area-under-curve (AUC) relative to random baseline
How to apply
Calculate the mean and standard deviation of the scoring function for all candidate pairs and separately for the known validated subset. Perform a two-sample statistical test (e.g., t-test or Mann-Whitney U, depending on normality) to compute a p-value quantifying whether validated links are enriched at higher scores. Construct histograms of the full score distribution and overlay the positions of validated links to visually confirm separation from the null distribution. Compute percentile ranks (e.g., what fraction of all pairs score above the 90th percentile?) and compare the proportion of validated links in the high-scoring tail. Report mean scores, p-values, and effect sizes (e.g., mean difference and 95% confidence intervals) alongside the visual distributions to support claims of enrichment.
Related tools
- NPLinker (Framework providing candidate link enumeration and scoring functions (strain correlation, IOKR) whose distributions are analyzed) — https://github.com/sdrogers/nplinker
- MIBiG (Source of validated BGC-metabolite links used as ground truth for enrichment testing)
- GNPS (Source of mass spectrometry data paired with MIBiG entries to construct the evaluation dataset)
Examples
import numpy as np; from scipy import stats; iokr_all = [0.0105] * 2966; iokr_val = [0.0364] * 50; t_stat, p_val = stats.ttest_ind(iokr_val, iokr_all); print(f'Mean (all): {np.mean(iokr_all):.4f}, Mean (validated): {np.mean(iokr_val):.4f}, p={p_val:.2e}')
Evaluation signals
- Validated links show mean score significantly higher than all-pairs mean (p < 0.05), with effect size large enough to be actionable (e.g., mean difference ≥ 0.02 IOKR units or ≥ 3.5 standardized correlation units).
- Visual histogram confirms bimodal or right-skewed distribution with validated links concentrated in the upper tail, not randomly scattered across the distribution.
- Top-n accuracy (e.g., fraction of validated links in top 5, 10, 20 ranks) is substantially higher than random baseline (e.g., top-5 >0.17 vs. baseline 0.0014), and AUC > 0.65 vs. random AUC ≈ 0.52.
- Percentile enrichment analysis (e.g., proportion of validated links above 90th percentile) matches reported p-values; if 90th percentile p ≈ 2×10⁻¹¹, the enrichment should be visually obvious.
- Combined or standardized scoring function shows further improvement in both mean separation and AUC relative to individual scoring functions, confirming complementarity.
Limitations
- P-values are sensitive to sample size; with large numbers of candidate pairs (e.g., 2966), even small effect sizes become statistically significant but may lack practical utility for ranking.
- Validated link set may be incomplete or biased toward certain product types or metabolite classes; the observed enrichment reflects only the ground truth available, not the true biological signal.
- Distribution analysis assumes independence of scores within the candidate set; if scores are correlated (e.g., due to shared spectral features), standard statistical tests may overestimate significance.
- High dependence on the choice of kernel function and molecular fingerprints used in scoring; optimizing these choices may substantially alter both the mean scores and the distribution shape.
- Reliance on MIBiG homology to assign candidate structures restricts applicability; BGCs with weak or no homology to MIBiG entries are excluded, potentially biasing the evaluation.
Evidence
- [results] Finding: IOKR mean score comparison: "IOKR achieves a mean score of 0.0105 for all 2966 BGC-spectrum links and 0.0364 for validated links (p=1.7968 × 10−9)"
- [results] Standardised correlation mean score comparison: "Standardised correlation: -0.0060 (all), 3.6717 (validated), p-value 6.8302 × 10−64"
- [results] Top-n accuracy and AUC for IOKR: "Table 3 shows the top-n performance of IOKR: top-1: 0.1208, top-5: 0.1708, top-10: 0.1870, top-20: 0.2121, top-200: 0.2946; AUC: 0.6534"
- [results] Percentile enrichment analysis for validated links: "both the IOKR and standardised strain correlation scores are significantly enriched (p-value of 0.0139 and 2.483 × 10−11, respectively) for validated links"
- [results] Distribution evaluation method: "we selected to evaluate the standardised strain correlation score. To do this, we examine the distribution of scores for validated links in relation to the scores for all hypothetical links"
- [other] Visualization and statistical reporting: "Generate distribution histograms of IOKR scores for all 2966 pairs and overlay positions of validated links, reporting mean scores, p-values, and visual confirmation against reported S2 Fig and Table"
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.