VIEW THIS AS

Auto mode follows the Route Engine until you choose a viewpoint.

YOU ARE HERE

ROUTE CHECK

CONNECTED TO

WHAT NEXT

Use the canonical route for this room, or HELP if you are unsure.

Why Science? | mzML and Open Mass Spectrometry Data

Three students sit around open books and worksheets at a classroom table, reading, writing and discussing the work together.

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.

Full section index · Science Learning Hub

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.

A four-step claim ladder for this method
StageQuestionEvidenceResponsible output
AcquireWhat did the instrument record?Spectra, chromatograms, scan and precursor metadataA run-level measurement record
EncodeHow are numeric arrays represented?Array type, precision, units and compressionDecodable values
DescribeWhich instrument and processing history apply?Controlled terms, software, configurations and dataProcessingInterpretable provenance
JudgeWhat can the file support?Validation, controls, calibration and retained informationA bounded analytical claim

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.

Contents · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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.

Contents · Previous section · Next section

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

Discover more from eduKate Singapore

Subscribe now to keep reading and get access to the full archive.

Continue reading