25. Skip to content

25. mzPeak file index JSON

Describe the JSON format of the file index

Type: object

25.1 Properties

Property Type Required Description
files array of 25.3.1 file Yes The files described in the index
metadata object Yes  

25.2 Property Details

files - array of 25.3.1 file (required)

The files described in the index

metadata - object (required)


25.3 Definitions

25.3.1 file

A single file in the mzPeak archive of a certain type

Type: object

25.3.1.1 Properties

Property Type Required Description
name string Yes The name of the file, relative to the root of the archive
entity_type string Yes The things being described in one facet or another by this file
data_kind string Yes The facet of the thing being described in this file
column_mapping array of 25.3.2 column_mapping   A list of Parquet column to controlled vocabulary term mappings
parameters array of param   A list of parameters describing the file stored in the mzPeak archive itself

25.3.1.2 Property Details

name - string (required)

The name of the file, relative to the root of the archive

entity_type - string (required)

The things being described in one facet or another by this file

Examples: "spectrum", "chromatogram", "other", "proprietary", "wavelength_spectrum"

data_kind - string (required)

The facet of the thing being described in this file

Examples: "data_arrays", "metadata", "peaks", "other", "proprietary"

column_mapping - array of 25.3.2 column_mapping (optional)

A list of Parquet column to controlled vocabulary term mappings

parameters - array of param (optional)

A list of parameters describing the file stored in the mzPeak archive itself


25.3.2 column_mapping

A mapping from a Parquet column to a controlled vocabulary term

Type: object

25.3.2.1 Properties

Property Type Required Description
name string   The human-readable term name
path string   The path in a Parquet schema for the mapped column delimited at nesting levels by '.', omitting [list, item
accession string or null   The CURIE for the controlled vocabulary term, or null if no controlled vocabulary term is available. Null may be used to indicate that a column has a human readable name but does not map to a controlled vocabulary term
unit string or null    

25.3.2.2 Property Details

name - string (optional)

The human-readable term name

Examples: "ms level", "filter string", "selected ion m/z", "collision energy", "scan lower limit"

path - string (optional)

The path in a Parquet schema for the mapped column delimited at nesting levels by '.', omitting [list, item|element] tokens

Examples: "ms_level", "isolation_window.target_mz", "activation.collision_energy", "scan_window.scan_lower_limit"

accession - string or null (optional)

The CURIE for the controlled vocabulary term, or null if no controlled vocabulary term is available. Null may be used to indicate that a column has a human readable name but does not map to a controlled vocabulary term

unit - string or null (optional)