eduKateSG · Why Science?
Open a mass-spectrometry run for inspection and reuse—while preserving spectra, chromatograms, instrument context, processing and numerical precision
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. mzML is the Human Proteome Organisation Proteomics Standards Initiative open XML format for mass-spectrometry output and its acquisition and processing context. The official project explains that proprietary instrument formats and reduced peak lists can hinder comparison and omit precursor or instrument metadata. mzML represents spectra and chromatograms, can preserve profile or centroid data, uses controlled vocabulary terms for instruments and methods, and can encode binary numerical arrays with declared precision and compression. The current official page exposes a 1.1.1 main schema and a 1.1.3 optional index schema, while the full specification remains version 1.1.0. An open file improves interoperability; it does not restore information discarded during conversion or prove that an instrument run is scientifically valid. 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: mass spectrometry, ionisation and mass-to-charge evidence; ion-mobility mass spectrometry; hydrogen–deuterium exchange mass spectrometry; Science Learning Hub; Education Hub; STEM Education; Careers by Subject Capability.
Primary and official sources checked on 12 October 2026: HUPO-PSI mzML official page and current schema resources, checked 12 October 2026; HUPO-PSI mzML official repository and specification, checked 12 October 2026; HUPO-PSI PSI-MS controlled vocabulary, 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
Mass spectrometers produce signals under instrument-specific acquisition methods, often stored first in proprietary files. mzML provides a common exchange layer so different tools can inspect spectra, chromatograms and metadata without pretending every instrument works identically. The original vendor file, acquisition method and conversion receipt should remain available because the open representation is a translation, not the physical measurement itself.
An mzML document is XML with a defined schema and controlled-vocabulary annotations. Core lists describe instruments, software, samples, processing and run content. References connect repeated objects so a spectrum can point to the instrument configuration and data-processing history that apply. Structural validity confirms the document model; semantic validation checks that controlled terms appear in allowed contexts.
A mass spectrum normally contains paired arrays such as mass-to-charge values and intensities. The binary numbers are encoded inside XML, with metadata stating array type, precision, byte order and compression. A parser must decode every declaration correctly. Reading 64-bit values as 32-bit, treating an intensity array as an m/z array or applying compression twice can produce plausible-looking but wrong peaks.
Chromatograms use time-like coordinates and intensities to show signals across an acquisition. Total-ion, selected-ion and other chromatogram types answer different questions and are distinguished by controlled terms. Units matter: minutes and seconds can differ by sixty-fold while both produce smooth curves. Every numerical array needs its data type, unit and semantic role.
Profile and centroid spectra are not interchangeable. Profile data preserve sampled peak shapes, whereas centroiding summarises peaks into representative positions and intensities. HUPO-PSI notes that transformation from proprietary data to peak lists can include centroiding and deisotoping. Report whether conversion retained profile data, performed peak picking or used vendor algorithms.
MS level and precursor metadata connect fragmentation spectra to earlier ion selections. Isolation windows, selected-ion attributes, collision energy and activation method shape what fragments can appear. Missing or inaccurate precursor links can mislead identification software even when the spectrum arrays themselves decode correctly. Validate parent-child relationships and acquisition mode.
The PSI-MS controlled vocabulary supplies stable accessions for instruments, software, scan types, array meanings and many processing actions. Labels are useful to people, but the accession and vocabulary release provide machine identity. A locally invented phrase should use an appropriate user parameter only when no suitable controlled term exists and should never impersonate an official accession.
Data processing can contain several steps and software tools. Conversion, peak picking, charge deconvolution, smoothing and filtering may each alter the representation. The processing graph needs software name, version and parameters where available. A final mzML file should reveal whether a clean spectrum came from raw profile data or from aggressive preprocessing.
Indexed mzML adds an optional wrapper with offsets and a checksum so software can reach spectra without scanning the whole XML stream. The official page publishes a separate optional index schema. Index validity depends on the exact file bytes; editing or reformatting XML after index creation can invalidate offsets even when the inner mzML remains readable.
Validation should combine XML schema checks, controlled-vocabulary rules and numerical tests. Count spectra and chromatograms, verify array lengths, decode representative values, inspect index offsets, confirm units and compare selected spectra with the vendor file or an independent converter. Include empty arrays, high precision values, profile data, centroid data and multiple MS levels.
File size encourages compression and lower numerical precision, but each choice can affect downstream work. Zlib compression is lossless for the encoded bytes; changing 64-bit values to 32-bit reduces precision. Numpress or other specialised encodings need explicit terms and compatible readers. Benchmark size, speed and numerical differences rather than assuming smaller means equivalent.
Interoperability does not erase experimental context. Calibration, contamination, ion suppression, detector saturation and sampling design still affect spectra. mzML can carry metadata that helps evaluation, yet a complete file cannot turn a poorly controlled run into reliable biological evidence. Quality metrics and study design remain separate evidence layers.
For students, mzML is like a science notebook whose graphs, instrument settings and processing steps use a shared dictionary. Two laboratories can exchange the notebook because each label has an agreed meaning. The optimistic lesson is that open standards make evidence easier to inspect while still asking us to protect the original measurement.
A durable package contains vendor files or governed access, acquisition method, calibration and sample manifest, converter and version, command, mzML schema and CV releases, output hash, validation report and a few expected spectra. That package lets another analyst separate acquisition changes, conversion changes, XML changes and downstream analysis changes.
Versioning requires precision. The official mzML page currently exposes a 1.1.1 main schema and a 1.1.3 optional index schema, and retains the 1.1.0 specification document, while the old 1.0.0 material is explicitly marked obsolete. Cite the schema actually used by the file, the controlled-vocabulary release and the document consulted instead of reporting a vague mzML version.
Privacy and licensing can apply even to analytical files. Sample names, run paths and metadata may reveal participants, unpublished compounds or laboratory systems. De-identify only under a documented policy and avoid breaking provenance links. An open format does not automatically make a dataset appropriate for public release.
A strong mzML review separates what the format can preserve from what a laboratory actually preserved. The schema can describe spectra, chromatograms, arrays, instrument settings and processing, yet a converted file may still reflect earlier centroiding, peak filtering or metadata loss. Reviewers should therefore compare acquisition records, conversion logs and checksums with the final exchange file. That chain turns an apparently technical file-format choice into a practical lesson about evidence provenance, reproducibility and the limits of later reconstruction.
The controlled vocabulary also deserves active reading. A term accession is not decoration: it tells software and people what an array, unit, instrument component or processing step means. When a term, unit or precision is wrong, a file may remain syntactically readable while becoming scientifically misleading. Students can learn this distinction by comparing a file that passes an XML check with one whose scientific labels do not match the values. Structure and meaning are separate tests, and reliable data needs both.
For classroom use, a small fictional experiment is enough. Let one group document a spectrum, another a chromatogram and a third the conversion history, then ask a fourth group to reconstruct the evidence without verbal help. Missing scan context, undeclared units or ambiguous processing quickly becomes visible. The exercise connects chemistry and data analysis without pretending that reading XML replaces laboratory training. It also shows why open exchange standards help teams collaborate across instruments, software packages and institutions.
A careful publication should cite the exact mzML specification or schema version used and keep the original vendor data when policy and storage allow. Future software may interpret fields more accurately, but it cannot recover information that was never exported. This is the cheerful practical promise of good stewardship: preserving a clear source-to-conversion-to-analysis route gives tomorrow’s researchers more ways to ask new questions of today’s experiment.
| Stage | Question | Evidence | Responsible output |
|---|---|---|---|
| Acquire | What did the instrument record? | Spectra, chromatograms, scan and precursor metadata | A run-level measurement record |
| Encode | How are numeric arrays represented? | Array type, precision, units and compression | Decodable values |
| Describe | Which instrument and processing history apply? | Controlled terms, software, configurations and dataProcessing | Interpretable provenance |
| Judge | What can the file support? | Validation, controls, calibration and retained information | A bounded analytical claim |
Inside this guide
1–12 · Foundations and design
- 1. Start with the measurement question
- 2. Preserve the source file
- 3. Use the correct version
- 4. Read the XML hierarchy
- 5. Read controlled vocabularies
- 6. Distinguish cvParam and userParam
- 7. Read the spectrum identity
- 8. Read MS level
- 9. Read precursor links
- 10. Read m/z arrays
- 11. Read intensity arrays
- 12. Read chromatograms
13–24 · Models and estimation
- 13. Distinguish profile and centroid
- 14. Read compression declarations
- 15. Read numerical precision
- 16. Read instrument configuration
- 17. Read software provenance
- 18. Read data-processing steps
- 19. Validate XML syntax
- 20. Validate controlled terms
- 21. Validate binary arrays
- 22. Validate the optional index
- 23. Audit completeness
- 24. Test units
25–36 · Diagnostics and interpretation
- 25. Protect sensitive metadata
- 26. Separate openness from quality
- 27. Separate spectra from identification
- 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 mzML note
- 35. Build a validation ladder
- 36. Finish with a reproducible bundle
Section 1 of 36
1. Start with the measurement question
mzML exchanges mass-spectrometry output and context.
Working checkpoint — mzML: Name sample, instrument and intended reuse. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 2 of 36
2. Preserve the source file
Conversion to an open format is a translation from vendor bytes.
Working checkpoint — mass spectrum: Archive the original or its governed identifier. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 3 of 36
3. Use the correct version
Current schema resources and the specification document have distinct version labels.
Working checkpoint — chromatogram: Record both schema and document. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 4 of 36
4. Read the XML hierarchy
Lists and references organise instruments, software, processing and run data.
Working checkpoint — mass-to-charge ratio: Validate IDs and references. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 5 of 36
5. Read controlled vocabularies
PSI-MS accessions define specialised terms and allowed meanings.
Working checkpoint — controlled vocabulary: Pin the CV release. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 6 of 36
6. Distinguish cvParam and userParam
Controlled terms support interoperability while user parameters cover genuinely local concepts.
Working checkpoint — mass spectrometry data: Do not forge accessions. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 7 of 36
7. Read the spectrum identity
Spectrum IDs and indexes locate records within one run.
Working checkpoint — mzML: Keep identifiers stable through conversion. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 8 of 36
8. Read MS level
MS level distinguishes precursor and fragmentation stages.
Working checkpoint — mass spectrum: Check acquisition logic. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 9 of 36
9. Read precursor links
Isolation and selected-ion metadata connect an MS/MS spectrum to its precursor.
Working checkpoint — chromatogram: Validate parent references. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 10 of 36
10. Read m/z arrays
Mass-to-charge arrays require declared type, units and numerical precision.
Working checkpoint — mass-to-charge ratio: Decode a known spectrum. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 11 of 36
11. Read intensity arrays
Intensity values pair positionally with m/z values.
Working checkpoint — controlled vocabulary: Require equal array lengths. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 12 of 36
12. Read chromatograms
Chromatograms pair time or another coordinate with intensity.
Working checkpoint — mass spectrometry data: Verify type and units. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 13 of 36
13. Distinguish profile and centroid
Centroiding summarises peak shapes and can discard detail.
Working checkpoint — mzML: Report the processing choice. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 14 of 36
14. Read compression declarations
Encoded binary arrays may use zlib or specialised compression.
Working checkpoint — mass spectrum: Test compatible decoding. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 15 of 36
15. Read numerical precision
32-bit and 64-bit representations trade size and precision.
Working checkpoint — chromatogram: Quantify any conversion difference. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 16 of 36
16. Read instrument configuration
Source, analyser and detector components define the measurement system.
Working checkpoint — mass-to-charge ratio: Match the actual hardware and settings. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 17 of 36
17. Read software provenance
Acquisition and conversion tools need names and versions.
Working checkpoint — controlled vocabulary: Preserve commands and parameters. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 18 of 36
18. Read data-processing steps
Peak picking, filtering and other transformations change the representation.
Working checkpoint — mass spectrometry data: Keep ordered processing history. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 19 of 36
19. Validate XML syntax
Schema validation checks element structure, types and cardinality.
Working checkpoint — mzML: Use the matching XSD. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 20 of 36
20. Validate controlled terms
Semantic rules check whether accessions occur in valid contexts.
Working checkpoint — mass spectrum: Run a current validator. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 21 of 36
21. Validate binary arrays
Decode representative arrays and compare lengths, ranges and expected peaks.
Working checkpoint — chromatogram: Use an independent reader. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 22 of 36
22. Validate the optional index
Offsets and checksum must match exact file bytes.
Working checkpoint — mass-to-charge ratio: Rebuild after any rewrite. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 23 of 36
23. Audit completeness
Counts and hashes reveal truncated or missing spectra and chromatograms.
Working checkpoint — controlled vocabulary: Compare with source runs. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 24 of 36
24. Test units
Seconds, minutes, daltons and dimensionless values must not be guessed.
Working checkpoint — mass spectrometry data: Resolve every unit accession. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 25 of 36
25. Protect sensitive metadata
Paths, sample names and annotations can expose protected information.
Working checkpoint — mzML: Apply governance before sharing. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 26 of 36
26. Separate openness from quality
An interoperable file can still contain a poor or mislabelled experiment.
Working checkpoint — mass spectrum: Review calibration and controls. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 27 of 36
27. Separate spectra from identification
mzML holds measured spectral data; peptide or protein identifications belong in another result layer.
Working checkpoint — chromatogram: Link rather than conflate files. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 28 of 36
28. Connect to Primary Science
A shared graph-and-label notebook shows why units and instrument settings travel with results.
Working checkpoint — mass-to-charge ratio: Use fictional spectra. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 29 of 36
29. Connect to Secondary Science
mzML supports lessons about measurement, calibration, transformations and uncertainty.
Working checkpoint — controlled vocabulary: Separate raw signal from processed peaks. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 30 of 36
30. Connect to mathematics
Paired arrays, precision, units and compression create quantitative reasoning.
Working checkpoint — mass spectrometry data: Check array lengths and one conversion. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 31 of 36
31. Connect to computing
XML, schemas, vocabularies, references and indexes show interoperable data engineering.
Working checkpoint — mzML: Validate a small example. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Section 32 of 36
32. Connect to pathways
Mass-spectrometry data work joins chemistry, biology, statistics and software and can illuminate STEM education and career pathways.
Working checkpoint — mass spectrum: Verify current routes separately. Read every spectrum beside instrument context, precursor links, processing history, units and calibration.
For future study, connect analytical chemistry to data standards and computing while checking official pathways separately.
Section 33 of 36
33. Did you know?
mzML can preserve both profile and centroid spectra, but conversion can already have discarded information.
Working checkpoint — chromatogram: Read processing history before analysis. Preserve profile data and discarded-information receipts; a convenient centroid file is not the complete acquisition.
For scientific writing, cite source, instrument, acquisition, converter, schema, CV and validation.
Section 34 of 36
34. Write a reader-ready mzML note
Name source, instrument, acquisition, converter, schema, CV, precision, compression and validation.
Working checkpoint — mass-to-charge ratio: Keep it beside the file. Separate structural interoperability from instrument performance, sample design and biological validity.
For students, ask what was measured, how numbers were encoded and which processing changed the graph.
Section 35 of 36
35. Build a validation ladder
Check XML, terms, references, arrays, units, processing, index, counts and source agreement.
Working checkpoint — controlled vocabulary: Stop at the first unexplained spectrum. Treat array type, precision, compression and units as scientific inputs: one silent mismatch can redraw a spectrum.
For parents, ask whether an open file still keeps the original measurement and context.
Section 36 of 36
36. Finish with a reproducible bundle
Deliver source identifiers, mzML, schemas, CVs, commands, hashes and bounded claims.
Working checkpoint — mass spectrometry data: Make every peak traceable to a run. Keep vendor source, acquisition method, converter, mzML schema, CV release, numerical encodings and validation together.
For a classroom model, exchange fictional paired arrays with units and processing notes.
Contents · Previous section · Continue to the Science Learning Hub
