eduKateSG · Why Science?
Make metabolomics results readable and computable—while preserving small-molecule evidence, features, spectra references, study variables and identification confidence
Choose the closest route, then return to the full index whenever you need the wider evidence chain.
Science learning becomes powerful when students can tell a measured pattern from a model, a statistical decision from a mechanism, and a useful lead from a finished conclusion. mzTab-M is the HUPO Proteomics Standards Initiative lightweight, tab-delimited format for reporting mass-spectrometry-based small-molecule metabolomics and lipidomics results. The official project lists ratified version 2.0.0 from March 2019 and describes it as a non-backwards-compatible specification distinct from proteomics-focused mzTab 1.0. The current official repository identifies 2.1.0 as in development in 2026, so production reports must state whether they use stable 2.0.0 or a development snapshot. mzTab-M makes results accessible to people and software, but a valid table does not prove molecular identity, concentration, pathway mechanism or clinical meaning. This guide supports Primary Science, PSLE Science, Secondary Science, O-Level Science and STEM education as a longform evidence-reading route; it is not medical advice, a laboratory protocol, an admission promise or a career guarantee.
Related eduKate reading: mzTab and tabular proteomics results; mzML and open mass-spectrometry data; mass spectrometry, ionisation and mass-to-charge evidence; Science Learning Hub; Education Hub; STEM Education; Careers by Subject Capability.
Primary and official sources checked on 12 October 2026: HUPO-PSI mzTab project page and ratified mzTab-M 2.0.0 specification, checked 12 October 2026; HUPO-PSI mzTab-M official development repository, including 2.0 resources and 2.1.0 development status, checked 12 October 2026; HUPO-PSI jmzTab-m reference implementation and validator, checked 12 October 2026; 2026 Singapore–Cambridge O-Level Biology syllabus; MOE G2/G3 Lower Secondary Science teaching and learning syllabus; 2026 MOE G2 Computing syllabus. Specifications, vocabularies, tools and recommendations can change, so preserve dated documentation, exact source data and software versions.
A deeper reading route
Metabolomics workflows can produce feature tables, tentative annotations, confirmed compounds and quantitative values across many samples. mzTab-M places metadata and typed sections in one tab-delimited file so collaborators can inspect the broad result without proprietary software. Its value is a shared map of the result, not a replacement for source spectra, chromatography, standards or laboratory notes.
The small-molecule section can describe reported chemical entities, while feature and evidence layers keep links to measured signals. One chemical entity may correspond to several features because of adducts, isotopes, fragments or chromatographic peaks. Conversely, one unresolved feature may have several candidate identities. The data model should preserve those relationships rather than force a one-row-one-molecule story.
Metadata gives context to every later value: instruments, software, databases, samples, assays, study variables, spectra references, score definitions and units. Numbered keys and controlled terms make this context machine-readable. A reviewer should resolve every referenced object before comparing columns across files.
Mass-to-charge ratio and retention time help locate a feature, but they do not uniquely identify a compound. Isomers can share formula and mass; adducts shift observed mass; chromatography and ionisation depend on method. Identification confidence needs its evidence category, database, spectral match, standard or orthogonal confirmation.
Spectra references connect summary results to observations. The reference must identify the exact source file and scan or spectrum under a declared convention. If public, a durable identifier can improve retrieval. A missing or broken reference turns a plausible table cell into an uninspectable claim.
Adduct and charge annotations change the relationship between neutral mass and measured mass-to-charge value. Parsing them as decoration can assign the wrong formula or merge distinct ions. Keep the notation, charge, mass calculation and software rule together.
Quantitative columns need a clear level, unit and normalisation method. Peak area, peak height, relative abundance, concentration and fold change answer different questions. Study-variable summaries are derived values, not raw observations. Reports should keep assay-level evidence and calculation scripts alongside the table.
Missing values can reflect non-detection, extraction failure, filtering, unmatched features or unavailable reporting. Those states are scientifically different. Imputation is a model and must be named, parameterised and separated from measured values.
Lipidomics adds structural ambiguity. A lipid class, sum composition, fatty-acyl composition and fully resolved molecular species represent different confidence levels. mzTab-M can report structured names and identifiers, but the author must not promote a partial annotation into a precise structure without supporting fragmentation or standards.
Controlled vocabularies reduce ambiguity for instruments, software, assays, databases, units and scores. Syntax validation checks rows and columns; semantic validation checks allowed terms, references and value rules. A file opening in a spreadsheet proves neither type of validity.
The 2.0.0 format is ratified and supported by a reference implementation. The repository says 2.1.0 is in development in 2026, with goals including modularisation, FAIR use cases and intermediate outputs. That status matters: a development snapshot may change, so it should never be labelled as the stable standard.
mzTab-M is not backwards-compatible with mzTab 1.0. The shared family name can mislead users into applying proteomics row rules to metabolomics files. Always state the domain and version in the filename, methods and reader guidance.
For students, mzTab-M resembles a museum catalogue for chemical signals. The catalogue makes many finds browsable, but each label should point back to the object, the measurement and the curator’s confidence. A readable name is still an evidence claim.
A classroom model can use fictional features with mass, retention time and candidate compounds. Students add an adduct, score and confidence level, then see why equal mass does not prove equal identity. The exercise joins chemistry, ratios, tables and uncertainty.
A reproducible bundle includes mzTab-M, source mzML or repository records, extraction and alignment parameters, libraries and database releases, standards, controlled vocabularies, validator output, scripts and hashes. These receipts let another team reconstruct both the table and its limits.
The cheerful practical benefit is shared visibility. A good mzTab-M report invites chemists, biologists and data scientists into the same result while keeping source links and uncertainty close. Accessibility makes better collaboration possible when it is paired with disciplined evidence.
A cautious reviewer begins with one small-molecule row and follows every linked feature and spectrum. The row should reveal how names, identifiers, adducts, charge, formula, m/z, retention and reliability relate. A broken link or unexplained score should pause interpretation rather than being filled by a familiar database guess.
Spreadsheet round trips are particularly risky for chemical identifiers and scientific notation. Import columns as declared text or numbers, save to a new file and compare with a standards-aware parser. The human-readable design invites inspection, but original bytes and typed validation protect the scientific record.
Between-study merging needs a common model for feature detection, alignment, adduct grouping, identification confidence, normalisation and missingness. Two rows with the same compound name may represent different isomers or confidence levels. Prefer accessions, spectra and explicit mappings to name-only joins.
A compact publication note can state stable mzTab-M version, source data, extraction software, databases and libraries, confidence policy, quantitative units and validator. The reader then gets both a welcoming overview and a precise route into deeper evidence.
Feature grouping should remain auditable. Isotopes, adducts and in-source fragments may be combined into one putative chemical entity, but that grouping depends on tolerances, correlation and method assumptions. Preserve the original features and the grouping rule so another analyst can test whether the same evidence supports the same entity.
Blank controls and pooled quality-control samples help reveal contaminants, drift and batch effects. Their roles belong in metadata and the methods narrative, while filtering decisions should remain reproducible. A valid result row should not hide that its signal was also strong in a procedural blank.
Identification levels should be reported without marketing shortcuts. Exact standard confirmation, library match, formula-level annotation and unknown feature are useful but different outcomes. Map the project’s terminology to a documented confidence framework and retain the underlying score and evidence rather than publishing labels alone.
Quantitative comparison also needs transparent denominators. Normalising to total signal, internal standards, sample mass or another reference produces different questions. State the denominator in words and structured metadata, then keep pre-normalisation values so future readers can evaluate the choice.
Long-term reuse requires a release-aware reader. The tab-delimited surface may still look familiar years later, while controlled terms, validators and software expectations have moved. Archive the stable 2.0.0 specification, validation receipts and exact dependency versions with the file. If a future team migrates the result toward 2.1, keep the original and publish a field-by-field transformation log. That approach preserves the historic scientific claim while allowing newer tools and FAIR workflows to benefit from carefully reviewed improvements.
A final spot check should open the file in both a plain-text editor and an independent parser. People can catch surprising names or scales, while software catches shifted tabs and broken references. Agreement between those views gives the readable format its full value.
| Stage | Question | Evidence | Responsible output |
|---|---|---|---|
| Describe | Which study and method produced the result? | Metadata, assays, study variables, software and CV terms | An interpretable context |
| Observe | Which signal was measured? | Features, m/z, retention time and spectra references | A traceable observation |
| Annotate | Which chemical entity may explain it? | Identifiers, adducts, scores and confidence | A bounded identification |
| Quantify | How was amount compared? | Units, values, normalisation and missingness | A reproducible result |
Inside this guide
1–12 · Foundations and design
13–24 · Models and estimation
25–36 · Diagnostics and interpretation
- 25. Protect sensitive metadata
- 26. Separate annotation from identity
- 27. Separate abundance from effect
- 28. Connect to Primary Science
- 29. Connect to Secondary Science
- 30. Connect to mathematics
- 31. Connect to computing
- 32. Connect to pathways
- 33. Did you know?
- 34. Write a reader-ready result note
- 35. Build a validation ladder
- 36. Finish with a reproducible bundle
Section 1 of 36
1. Start with the metabolomics question
Name the sample, chemical scope, comparison and intended decision.
Working checkpoint — mzTab-M: Keep claims narrower than the table. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 2 of 36
2. Record format status
mzTab-M 2.0.0 is ratified; 2.1.0 is in development in 2026.
Working checkpoint — metabolomics results: State the exact version. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 3 of 36
3. Distinguish mzTab 1.0
Proteomics mzTab and metabolomics mzTab-M are not backwards-compatible.
Working checkpoint — lipidomics: Use the correct rules. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 4 of 36
4. Preserve original bytes
Spreadsheet programs can reinterpret identifiers and numbers.
Working checkpoint — small molecule: Archive the untouched file and hash. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 5 of 36
5. Read metadata first
Metadata defines samples, assays, software, databases, scores and units.
Working checkpoint — spectral feature: Resolve numbered references. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 6 of 36
6. Read assays
Assay columns connect values to measurements.
Working checkpoint — identification reliability: Map them to source files. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 7 of 36
7. Read study variables
Study variables group assays for comparisons.
Working checkpoint — mzTab-M: Check replicate membership. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 8 of 36
8. Read small-molecule rows
Chemical entities need identifiers and confidence context.
Working checkpoint — metabolomics results: Do not trust names alone. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 9 of 36
9. Read feature rows
Features carry measured m/z, retention and abundance evidence.
Working checkpoint — lipidomics: Keep one-to-many relationships. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 10 of 36
10. Read evidence rows
Evidence links reported molecules to features and spectra.
Working checkpoint — small molecule: Follow every source reference. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 11 of 36
11. Read spectra references
A scan identifier needs an exact source file and convention.
Working checkpoint — spectral feature: Test retrieval. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 12 of 36
12. Read adducts
Adduct identity changes neutral-mass interpretation.
Working checkpoint — identification reliability: Validate notation and charge. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 13 of 36
13. Read charge
Charge affects mass-to-charge calculations.
Working checkpoint — mzTab-M: Never infer silently. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 14 of 36
14. Read retention time
Retention depends on chromatography and method.
Working checkpoint — metabolomics results: State unit and calibration. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 15 of 36
15. Read formulas
A formula does not uniquely specify structure.
Working checkpoint — lipidomics: Keep isomer ambiguity visible. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 16 of 36
16. Read identifiers
Database and version give accessions meaning.
Working checkpoint — small molecule: Pin releases. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 17 of 36
17. Read reliability
Confidence levels and scores need explicit definitions.
Working checkpoint — spectral feature: Do not compare unlike scales. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 18 of 36
18. Read quantitative values
Peak area, abundance and concentration are different measures.
Working checkpoint — identification reliability: Name level and unit. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 19 of 36
19. Read missing values
Non-detection and unavailable reporting are not ordinary zeroes.
Working checkpoint — mzTab-M: Preserve the declared state. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 20 of 36
20. Validate tabs and widths
Every row must match its header and prefix.
Working checkpoint — metabolomics results: Reject shifted columns. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 21 of 36
21. Validate metadata links
Numbered references and column mappings must resolve.
Working checkpoint — lipidomics: Stop on broken links. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 22 of 36
22. Validate controlled terms
Terms and units need valid accessions in allowed positions.
Working checkpoint — small molecule: Run semantic checks. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 23 of 36
23. Validate mass logic
m/z, charge, adduct and neutral mass should agree.
Working checkpoint — spectral feature: Recalculate a fixture. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 24 of 36
24. Validate evidence links
Candidate identities must point to inspectable supporting records.
Working checkpoint — identification reliability: Test representative rows. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 25 of 36
25. Protect sensitive metadata
Sample names and file locations can expose governed information.
Working checkpoint — mzTab-M: Apply access rules. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 26 of 36
26. Separate annotation from identity
A database match is not automatically a confirmed compound.
Working checkpoint — metabolomics results: Report confidence honestly. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 27 of 36
27. Separate abundance from effect
A changed signal does not prove a pathway mechanism.
Working checkpoint — lipidomics: Use biological evidence separately. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 28 of 36
28. Connect to Primary Science
A results catalogue shows why labels and observations should remain linked.
Working checkpoint — small molecule: Use fictional chemicals. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 29 of 36
29. Connect to Secondary Science
Features support lessons about mixtures, measurement, controls and uncertainty.
Working checkpoint — spectral feature: Compare candidates for one feature. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 30 of 36
30. Connect to mathematics
Ratios, missing values, scores and retention ranges build data literacy.
Working checkpoint — identification reliability: Check one calculation. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 31 of 36
31. Connect to computing
Typed text, references and validators show interoperable data design.
Working checkpoint — mzTab-M: Test one malformed row. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Section 32 of 36
32. Connect to pathways
Metabolomics joins chemistry, biology, statistics and software and can illuminate STEM education and career pathways.
Working checkpoint — metabolomics results: Verify current routes separately. Read every row beside its section, identifiers, adduct, charge, confidence and source evidence.
For future study, connect metabolomics to chemistry, databases and statistics while checking official pathways separately.
Section 33 of 36
33. Did you know?
mzTab-M 2.0 is a separate, non-backwards-compatible specification from proteomics mzTab 1.0.
Working checkpoint — lipidomics: Name domain and version. Preserve candidates and missing states; a readable table is not a complete experiment.
For scientific writing, cite version, method, identifiers, confidence, values and validation.
Section 34 of 36
34. Write a reader-ready result note
State version, method, sections, identifiers, confidence, units, evidence and limits.
Working checkpoint — small molecule: Place it beside the file. Separate tabular accessibility from molecular identity, quantitative validity and biological meaning.
For students, ask which feature and spectrum support each molecule name.
Section 35 of 36
35. Build a validation ladder
Check bytes, prefixes, metadata, rows, terms, mass logic and evidence links.
Working checkpoint — spectral feature: Stop at the first inconsistency. Treat tabs, prefixes, m/z, retention and accessions as scientific inputs: one shifted field can rename a result.
For parents, ask whether an accessible result keeps confidence and source evidence visible.
Section 36 of 36
36. Finish with a reproducible bundle
Deliver mzTab-M, source spectra, methods, libraries, standards, validator logs and hashes.
Working checkpoint — identification reliability: Make every feature traceable. Keep original bytes, metadata, features, molecules, spectra references, scores, units and validation together.
For a classroom model, exchange fictional features and candidate chemicals.
Contents · Previous section · Continue to the Science Learning Hub
