Skip to content

Chromatograms

Chromatograms are described by a signal file (chromatograms_data.parquet) and a metadata file (chromatograms_metadata.parquet). Diagnostic traces are currently carried here as well, pending their dedicated entity-type namespace.

Chromatogram signal data — chromatograms_data.parquet

{ "name": "chromatograms_data.parquet", "entity_type": "chromatogram", "data_kind": "data arrays" }

The signal data is encoded using either point layout or chunked layout. The entity index column MUST be named chromatogram_index. The default primary axis is a MS:1000595 time array, though the unit is up to the writer.

Column Encoding
chromatogram_index delta encoding
time arrays byte stream split (byte shuffling)

Chromatogram metadata — chromatograms_metadata.parquet

{ "name": "chromatograms_metadata.parquet", "entity_type": "chromatogram", "data_kind": "metadata" }

This table uses the packed parallel metadata table schema.

chromatogram (group)

  • index (integer) — the ascending 0-based index, incrementing by 1 per entry and SHOULD be time-sorted ascending. Primary key for the chromatogram facet.
  • id (string) — a unique string identifier.
  • MS_1000465_scan_polarity (integer) — 1, -1, or null.
  • MS_1000626_chromatogram_type (CURIE) — e.g. total ion current (MS:1000235), selected ion current (MS:1000627), base peak (MS:1000628), absorption (MS:1000812).
  • data_processing_ref (integer) — a data_processing governing this chromatogram if it deviates from run.default_data_processing_id; null otherwise.
  • parameters (list).
  • number_of_auxiliary_arrays (integer) and auxiliary_arrays (list) — see auxiliary data arrays.
  • MS_1003060_number_of_data_points (integer) — data points stored in chromatograms_data.parquet.
  • MAY supply a child of MS:1000808 (chromatogram attribute) one or more times.

precursor (group)

The method of precursor-ion selection and activation.

  • source_index (integer) — the chromatogram this precursor belongs to (foreign key).
  • precursor_index (integer) — the chromatogram the precursor was created from (foreign key).
  • precursor_id (string) — the id of the chromatogram referenced by precursor_index.
  • isolation_window (group) — as for spectra: MUST supply children of MS:1000792.
  • activation (group) — as for spectra: MUST supply MS:1000044 (dissociation method) or a child.

selected_ion (group)

  • source_index (integer) / precursor_index (integer) — foreign keys.
  • ion_mobility_value (float) / ion_mobility_type (CURIE) — optional.
  • parameters (list).
  • MUST supply a child of MS:1000455 (ion selection attribute) one or more times — selected-ion m/z, charge state, intensity.