Skip to content

Metabolomics Hub Common Data Model Nodes

MHD Domain Objects

Assay

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType Its value MUST be assay
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
repository_identifier required str An assay identifier that uniquely identifies the assay in repository
Minimum length: 2
Validation Rule:
Min Length: 2, Required
name required str Name of the assay. It SHOULD be unique in a study
Minimum length: 2
Validation Rule:
Min Length: 2, Required
metadata_file_ref required MhdObjectId Target node type: metadata-file
Validation Rule:
Target node type: metadata-file
technology_type_ref required CvTermObjectId Target CV term type: descriptor
Validation Rules:
Target node type: descriptor
Allowed CV Terms:
* [OBI, OBI:0000470, mass spectrometry assay],
* [OBI, OBI:0000623, NMR spectroscopy assay]
analysis_type_ref required CvTermObjectId Target CV term type: descriptor
Validation Rules:
Target node type: descriptor
Allowed CV Terms:
* [OBI, OBI:0003097, liquid chromatography mass spectrometry assay],
* [OBI, OBI:0003110, gas chromatography mass spectrometry assay],
* [OBI, OBI:0000470, mass spectrometry assay],
* [OBI, OBI:0000623, NMR spectroscopy assay]
measurement_methodology_ref required CvTermObjectId Target CV term type: descriptor
Validation Rules:
Target node type: descriptor
Allowed CV Terms:
* [MSIO, MSIO:0000100, targeted metabolite profiling],
* [MSIO, MSIO:0000101, untargeted metabolite profiling],
* [OBI, OBI:0000366, metabolite profiling assay]
protocol_refs optional list[MhdObjectId] The id properties of protocols used in assay. A protocol is a defined and standardized procedure followed to collect, prepare, or analyze biological samples
Target node type: protocol
Validation Rule:
Target node type: protocol
sample_run_refs optional list[MhdObjectId] Target node type: sample-run
Validation Rule:
Target node type: sample-run

Node Relationships

Source Relationship Reverse Name Target Min Max Description
assay described-as describes descriptor 0 N A link to a descriptor that describes the assay.
assay follows used-in protocol 0 N A link to a protocol conducted in assay.
assay has-derived-data-file created-in derived-data-file 0 N A link to a descriptor that describes the assay.
assay part-of has-assay study 1 1 A link to a study that the assay was conducted as part of it to generate data addressing study objectives
Required min count in the dataset: 1.

Embedded Relationships: descriptor, metadata-file, protocol, sample-run

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
derived-data-file created-in has-derived-data-file assay 0 N
descriptor describes described-as assay 0 N
protocol used-in follows assay 0 N
study has-assay part-of assay 1 N Required min count in the dataset: 1.

Characteristic Definition

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be characteristic-definition
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
characteristic_type_ref required CvTermObjectId Target CV term type: characteristic-type
Validation Rules:
Target node type: characteristic-type
Allowed CV Terms:
* [NCIT, NCIT:C14250, organism],
* [NCIT, NCIT:C103199, organism part],
* [EFO, EFO:0000408, disease],
* [EFO, EFO:0000324, cell type]

Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-definition has-instance instance-of characteristic-value 0 N Required min count in the dataset: 2.

Target Validation Rules:
-----
Conditional - (Organism)
[Source characteristic_type_ref.accession = NCIT:C14250]
Ontology Sources:ENVO, NCBITAXON
Exceptions:
Allowed Other Sources: wikidata
-----
Conditional - (Organism part)
[Source characteristic_type_ref.accession = NCIT:C103199]
Ontology Sources:UBERON, BTO, NCIT
Exceptions:
Allowed Other Sources: wikidata
-----
Conditional - (Disease)
[Source characteristic_type_ref.accession = EFO:0000408]
Ontology Sources:DOID, HP, MP
-----
Conditional - (Cell type)
[Source characteristic_type_ref.accession = EFO:0000324]
Ontology Sources:CL

-----
characteristic-definition used-in has-characteristic-definition study 0 N Required min count in the dataset: 2.

Embedded Relationships: characteristic-type

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-value instance-of has-instance characteristic-definition 1 N Required min count in the dataset: 2.
study has-characteristic-definition used-in characteristic-definition 2 N Required min count in the dataset: 2.

Derived Data File

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be derived-data-file
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Name of the file. File MUST be a file (not folder or link).It MAY be relative path (e.g., FILES/study.txt) or a file in a compressed file (e.g., FILES/study.zip#data/metadata.tsv)
Minimum length: 2
Validation Rule:
Min Length: 2, Required
size optional int The size of the file in bytes, representing the total amount of data contained in the file
hash_sha256 optional str The SHA-256 cryptographic hash of the file content, used to verify file integrity and ensure that the file has not been altered
format_ref required CvTermObjectId The structure or encoding used to store the contents of the file, typically indicated by its extension (e.g., .txt, .csv, .mzML, .raw, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
compression_format_ref optional CvTermObjectId The structure or encoding used to compress the contents of the file, typically indicated by its extension (e.g., .zip, .tar, .gz, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
extension optional str The extension of file. It MUST contain all extensions (e.g., .raw, .mzML, .d.zip, .raw.zip, etc.)

Node Relationships

Source Relationship Reverse Name Target Min Max Description
derived-data-file created-in has-derived-data-file assay 0 N
derived-data-file created-in has-derived-data-file study 1 1
derived-data-file described-as describes descriptor 0 N A link to a descriptor that describes the derived data file.
derived-data-file referenced-in references metadata-file 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
assay has-derived-data-file created-in derived-data-file 0 N A link to a descriptor that describes the assay.
descriptor describes described-as derived-data-file 0 N
metadata-file references referenced-in derived-data-file 0 N
study has-derived-data-file created-in derived-data-file 0 N

Factor Definition

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be factor-definition
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
factor_type_ref required CvTermObjectId Target CV term type: factor-type
Validation Rules:
Target node type: factor-type
Allowed CV Terms:
* [EFO, EFO:0000408, disease]

Node Relationships

Source Relationship Reverse Name Target Min Max Description
factor-definition has-instance instance-of factor-value 0 N Target Validation Rule:
-----
Conditional - (Disease)
[Source factor_type_ref.accession = EFO:0000408]
Ontology Sources:DOID, HP, MP

-----
factor-definition used-in has-factor-definition study 0 N

Embedded Relationships: factor-type

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
factor-value instance-of has-instance factor-definition 1 N
study has-factor-definition used-in factor-definition 0 N

Metabolite

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be metabolite
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 2
Validation Rule:
Min Length: 2, Required

Node Relationships

Source Relationship Reverse Name Target Min Max Description
metabolite described-as describes descriptor 0 N
metabolite identified-as reported-identifier-of metabolite-identifier 0 N Target Validation Rule:
-----
Allowed Parent CV Terms:
* [CHEMINF, CHEMINF:000464, chemical database identifier]
Allow parent CV Term: No
Allow only leaf CV Terms: No

-----
metabolite reported-in reports study 1 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as metabolite 0 N
metabolite-identifier reported-identifier-of identified-as metabolite 1 N
study reports reported-in metabolite 0 N

Metadata File

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be metadata-file
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list required list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
Minimum length: 1
Validation Rule:
Min Length: 1, Required
name required str Name of the file. File MUST be a file (not folder or link).It MAY be relative path (e.g., FILES/study.txt) or a file in a compressed file (e.g., FILES/study.zip#data/metadata.tsv)
Minimum length: 2
Validation Rule:
Min Length: 2, Required
size optional int The size of the file in bytes, representing the total amount of data contained in the file
hash_sha256 optional str The SHA-256 cryptographic hash of the file content, used to verify file integrity and ensure that the file has not been altered
format_ref required CvTermObjectId The structure or encoding used to store the contents of the file, typically indicated by its extension (e.g., .txt, .csv, .mzML, .raw, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
compression_format_ref optional CvTermObjectId The structure or encoding used to compress the contents of the file, typically indicated by its extension (e.g., .zip, .tar, .gz, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
extension required str The extension of file. It MUST contain all extensions (e.g., .raw, .mzML, .d.zip, .raw.zip, etc.)

Node Relationships

Source Relationship Reverse Name Target Min Max Description
metadata-file describes has-metadata-file study 1 N Required min count in the dataset: 1.
metadata-file referenced-in references metadata-file 0 N
metadata-file references referenced-in derived-data-file 0 N
metadata-file references referenced-in raw-data-file 0 N
metadata-file references referenced-in result-file 0 N
metadata-file references referenced-in supplementary-file 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
derived-data-file referenced-in references metadata-file 0 N
descriptor describes described-as metadata-file 0 N
metadata-file referenced-in references metadata-file 0 N
raw-data-file referenced-in references metadata-file 0 N
result-file referenced-in references metadata-file 0 N
study has-metadata-file describes metadata-file 1 N Required min count in the dataset: 1.
supplementary-file referenced-in references metadata-file 0 N

Organization

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be organization
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
repository_identifier optional str
name required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
department optional str
unit optional str
address optional str

Node Relationships

Source Relationship Reverse Name Target Min Max Description
organization affiliates affiliated-with person 0 N
organization coordinates coordinated-by project 0 N
organization described-as describes descriptor 0 N
organization funds funded-by project 0 N
organization manages managed-by project 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as organization 0 N
person affiliated-with affiliates organization 0 N
project coordinated-by coordinates organization 0 N
project funded-by funds organization 0 N
project managed-by manages organization 0 N

Parameter Definition

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be parameter-definition
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
parameter_type_ref required CvTermObjectId Target node type: parameter-type
Validation Rule:
Target node type: parameter-type

Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-definition has-instance instance-of parameter-value 0 N Required min count in the dataset: 1.
Target Validation Rule:
-----
Conditional - (Mass spectrometry instrument)
[Source parameter_type_ref.accession = MSIO:0000171]
Allowed Parent CV Terms:
* [MS, MS:1000031, instrument model]
Allow parent CV Term: No
Allow only leaf CV Terms: Yes
Excluded CV Terms:
* [MS, MS:1000491, Dionex instrument model],
* [MS, MS:1000488, Hitachi instrument model]

-----

Embedded Relationships: parameter-type

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-value instance-of has-instance parameter-definition 1 N Required min count in the dataset: 1.
protocol has-parameter-definition defined-in parameter-definition 0 N Required min count in the dataset: 1.

Person

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The value of this property MUST be 'person'
Its value MUST be person
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
full_name optional str Full name of person
orcid optional str ORCID identifier of person

Example:
"1234-0001-8473-1713"
"1234-0001-8473-171X"
emails optional list[EmailStr] Email addresses of person
phones optional list[str] Phone number of person (with international country code)

Example:
[
"+449340917271",
"00449340917271"
]
addresses optional list[str]

Node Relationships

Source Relationship Reverse Name Target Min Max Description
person affiliated-with affiliates organization 0 N
person author-of has-author publication 0 N
person contributes has-contributor project 0 N
person contributes has-contributor study 0 N
person described-as describes descriptor 0 N
person principal-investigator-of has-principal-investigator study 0 N Required min count in the dataset: 1.
person submits submitted-by study 0 1 Required min count in the dataset: 1.

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as person 0 N
organization affiliates affiliated-with person 0 N
project has-contributor contributes person 0 N
publication has-author author-of person 0 N
study has-contributor contributes person 0 N
study has-principal-investigator principal-investigator-of person 0 N Required min count in the dataset: 1.
study submitted-by submits person 1 N Required min count in the dataset: 1.

Project

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be project
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
title required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
description optional str
grant_identifiers optional list[Annotated]
doi optional str

Node Relationships

Source Relationship Reverse Name Target Min Max Description
project coordinated-by coordinates organization 0 N
project described-as describes descriptor 0 N
project funded-by funds organization 0 N
project has-contributor contributes person 0 N
project has-publication describes publication 0 N
project has-study part-of study 0 N
project managed-by manages organization 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as project 0 N
organization coordinates coordinated-by project 0 N
organization funds funded-by project 0 N
organization manages managed-by project 0 N
person contributes has-contributor project 0 N
publication describes has-publication project 0 N
study part-of has-study project 0 N

Protocol

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be protocol
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str
protocol_type_ref required CvTermObjectId Target CV term type: protocol-type
Validation Rules:
Target node type: protocol-type
Allowed CV Terms:
* [EFO, EFO:0005518, sample collection protocol],
* [MS, MS:1000831, sample preparation],
* [CHMO, CHMO:0000470, mass spectrometry],
* [OBI, OBI:0200000, data transform],
* [MI, MI:2131, metabolite identification],
* [CHMO, CHMO:0001000, chromatography],
* [EFO, EFO:0003969, treatment protocol],
* [CHMO, CHMO:0001024, capillary electrophoresis],
* [MS, MS:1000058, flow injection analysis]
Exceptions:
Allowed Other Sources: wikidata
description required str
parameter_definition_refs optional list[MhdObjectId] Target node type: parameter-definition

Node Relationships

Source Relationship Reverse Name Target Min Max Description
protocol described-as describes descriptor 0 N
protocol has-parameter-definition defined-in parameter-definition 0 N Required min count in the dataset: 1.
protocol used-in follows assay 0 N
protocol used-in has-protocol study 1 N Required min count in the dataset: 1.

Embedded Relationships: protocol-type

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
assay follows used-in protocol 0 N A link to a protocol conducted in assay.
descriptor describes described-as protocol 0 N
study has-protocol used-in protocol 0 N Required min count in the dataset: 1.

Publication

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be publication
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
title required str
doi required str
pub_med_id optional str
authors optional list[Annotated]

Node Relationships

Source Relationship Reverse Name Target Min Max Description
publication described-as describes descriptor 0 N
publication describes has-publication project 0 N
publication describes has-publication study 0 1
publication has-author author-of person 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as publication 0 N
person author-of has-author publication 0 N
project has-publication describes publication 0 N
study has-publication describes publication 0 N

Raw Data File

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be raw-data-file
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list required list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
Minimum length: 1
Validation Rule:
Min Length: 1, Required
name required str Name of the file. File MUST be a file (not folder or link).It MAY be relative path (e.g., FILES/study.txt) or a file in a compressed file (e.g., FILES/study.zip#data/metadata.tsv)
Minimum length: 2
Validation Rule:
Min Length: 2, Required
size optional int The size of the file in bytes, representing the total amount of data contained in the file
hash_sha256 optional str The SHA-256 cryptographic hash of the file content, used to verify file integrity and ensure that the file has not been altered
format_ref required CvTermObjectId The structure or encoding used to store the contents of the file, typically indicated by its extension (e.g., .txt, .csv, .mzML, .raw, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
compression_format_ref optional CvTermObjectId The structure or encoding used to compress the contents of the file, typically indicated by its extension (e.g., .zip, .tar, .gz, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
extension optional str The extension of file. It MUST contain all extensions (e.g., .raw, .mzML, .d.zip, .raw.zip, etc.)

Node Relationships

Source Relationship Reverse Name Target Min Max Description
raw-data-file created-in has-raw-data-file study 1 1 Required min count in the dataset: 1.
raw-data-file described-as describes descriptor 0 N
raw-data-file referenced-in references metadata-file 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as raw-data-file 0 N
metadata-file references referenced-in raw-data-file 0 N
study has-raw-data-file created-in raw-data-file 1 N Required min count in the dataset: 1.

Result File

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be result-file
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list required list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
Minimum length: 1
Validation Rule:
Min Length: 1, Required
name required str Name of the file. File MUST be a file (not folder or link).It MAY be relative path (e.g., FILES/study.txt) or a file in a compressed file (e.g., FILES/study.zip#data/metadata.tsv)
Minimum length: 2
Validation Rule:
Min Length: 2, Required
size optional int The size of the file in bytes, representing the total amount of data contained in the file
hash_sha256 optional str The SHA-256 cryptographic hash of the file content, used to verify file integrity and ensure that the file has not been altered
format_ref required CvTermObjectId The structure or encoding used to store the contents of the file, typically indicated by its extension (e.g., .txt, .csv, .mzML, .raw, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
compression_format_ref optional CvTermObjectId The structure or encoding used to compress the contents of the file, typically indicated by its extension (e.g., .zip, .tar, .gz, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
extension optional str The extension of file. It MUST contain all extensions (e.g., .raw, .mzML, .d.zip, .raw.zip, etc.)

Node Relationships

Source Relationship Reverse Name Target Min Max Description
result-file created-in has-result-file study 1 N
result-file described-as describes descriptor 0 N
result-file referenced-in references metadata-file 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as result-file 0 N
metadata-file references referenced-in result-file 0 N
study has-result-file created-in result-file 0 N

Sample

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be sample
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 1
Validation Rule:
Min Length: 1, Required
repository_identifier required str
additional_identifiers optional list[CvTermValue]
subject_refs required list[MhdObjectId] Minimum length: 1
Target node type: subject
Validation Rule:
Min Length: 1, Required

Node Relationships

Source Relationship Reverse Name Target Min Max Description
sample derived-from source-of subject 1 N
sample described-as describes descriptor 0 N
sample has-factor-value value-of factor-value 0 N
sample used-in has-sample study 1 1

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as sample 0 N
factor-value value-of has-factor-value sample 1 N
study has-sample used-in sample 0 N
subject source-of derived-from sample 1 N

Sample Run

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be sample-run
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name optional str
sample_ref required MhdObjectId Target node type: sample
sample_run_configuration_refs optional list[MhdObjectId] Target node type: sample-run-configuration
raw_data_file_refs required list[MhdObjectId] Minimum length: 1
Target node type: raw-data-file
Validation Rule:
Min Length: 1, Required
derived_data_file_refs optional list[MhdObjectId] Target node type: derived-data-file
result_file_refs optional list[MhdObjectId] Target node type: result-file
supplementary_file_refs optional list[MhdObjectId] Target node type: supplementary-file

Node Relationships

Source Relationship Reverse Name Target Min Max Description
sample-run described-as describes descriptor 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as sample-run 0 N

Sample Run Configuration

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be sample-run-configuration
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
protocol_ref required MhdObjectId Target node type: protocol
parameter_value_refs optional list[MhdObjectId or CvTermObjectId or CvTermValueObjectId] Target node type: parameter-value

Node Relationships

Source Relationship Reverse Name Target Min Max Description

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as sample-run-configuration 0 N

Study

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be study
created_by_ref required CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
mhd_identifier required str Minimum length: 8
Validation Rule:
Min Length: 8, Required
repository_identifier optional str
additional_identifiers optional list[KeyValue] Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
title required str Minimum length: 2
Validation Rule:
Min Length: 2, Required
description required str Minimum length: 5
Validation Rule:
Min Length: 5, Required
submission_date required datetime
public_release_date required datetime
dataset_license required HttpUrl
Example:
"https://creativecommons.org/publicdomain/zero/1.0"
dataset_uri_list optional list[KeyValue]
related_datasets optional list[KeyValue]
protocol_refs required list[MhdObjectId] Target node type: protocol

Node Relationships

Source Relationship Reverse Name Target Min Max Description
study defines defined-in characteristic-type 2 N Required min count in the dataset: 2.
study described-as describes descriptor 0 N
study has-assay part-of assay 1 N Required min count in the dataset: 1.
study has-characteristic-definition used-in characteristic-definition 2 N Required min count in the dataset: 2.
study has-contributor contributes person 0 N
study has-derived-data-file created-in derived-data-file 0 N
study has-factor-definition used-in factor-definition 0 N
study has-metadata-file describes metadata-file 1 N Required min count in the dataset: 1.
study has-principal-investigator principal-investigator-of person 0 N Required min count in the dataset: 1.
study has-protocol used-in protocol 0 N Required min count in the dataset: 1.
study has-publication describes publication 0 N
study has-raw-data-file created-in raw-data-file 1 N Required min count in the dataset: 1.
study has-repository-keyword keyword-of descriptor 0 N
study has-result-file created-in result-file 0 N
study has-sample used-in sample 0 N
study has-submitter-keyword keyword-of descriptor 0 N Target Validation Rule:
-----
Allow any valid CV Term
Exceptions:
Allowed Placeholder Values: source='' accession=''
Allowed Other Sources: wikidata

-----
study has-supplementary-file created-in supplementary-file 0 N
study part-of has-study project 0 N
study reports reported-in metabolite 0 N
study submitted-by submits person 1 N Required min count in the dataset: 1.

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
assay part-of has-assay study 1 1 A link to a study that the assay was conducted as part of it to generate data addressing study objectives
Required min count in the dataset: 1.
characteristic-definition used-in has-characteristic-definition study 0 N Required min count in the dataset: 2.
characteristic-type defined-in defines study 1 1 Required min count in the dataset: 2.
data-provider provides provided-by study 0 N
derived-data-file created-in has-derived-data-file study 1 1
descriptor describes described-as study 0 N
descriptor keyword-of has-repository-keyword study 0 N
factor-definition used-in has-factor-definition study 0 N
factor-type used-in use-factor-type study 0 N
metabolite reported-in reports study 1 N
metadata-file describes has-metadata-file study 1 N Required min count in the dataset: 1.
person contributes has-contributor study 0 N
person principal-investigator-of has-principal-investigator study 0 N Required min count in the dataset: 1.
person submits submitted-by study 0 1 Required min count in the dataset: 1.
project has-study part-of study 0 N
protocol used-in has-protocol study 1 N Required min count in the dataset: 1.
publication describes has-publication study 0 1
raw-data-file created-in has-raw-data-file study 1 1 Required min count in the dataset: 1.
result-file created-in has-result-file study 1 N
sample used-in has-sample study 1 1
supplementary-file created-in has-supplementary-file study 1 N

Subject

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be subject
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list optional list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
name required str Minimum length: 1
Validation Rule:
Min Length: 1, Required
subject_type optional CvTerm
repository_identifier required str Minimum length: 1
Validation Rule:
Min Length: 1, Required

Node Relationships

Source Relationship Reverse Name Target Min Max Description
subject described-as describes descriptor 0 N
subject has-characteristic-value value-of characteristic-value 2 N
subject source-of derived-from sample 1 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-value value-of has-characteristic-value subject 1 N
descriptor describes described-as subject 0 N
sample derived-from source-of subject 1 N

Supplementary File

Properties

Property Name Necessity Type Description
id optional MhdObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the object
Its value MUST be supplementary-file
created_by_ref optional CvTermValueObjectId The id property of the data-provider who created the object
Target CV term type: data-provider
Validation Rule:
Allow any valid CV Term
Exceptions:
Allowed Other Sources: wikidata
tags optional list[KeyValue] Key-value tags related to the object
descriptors optional list[CvTerm] Descriptors of the object
external_references optional list[KeyValue] External references related to the object
uri_list required list[KeyValue] URI list related to the object. Key MUST be uri type CV Term
Minimum length: 1
Validation Rule:
Min Length: 1, Required
name required str Name of the file. File MUST be a file (not folder or link).It MAY be relative path (e.g., FILES/study.txt) or a file in a compressed file (e.g., FILES/study.zip#data/metadata.tsv)
Minimum length: 2
Validation Rule:
Min Length: 2, Required
size optional int The size of the file in bytes, representing the total amount of data contained in the file
hash_sha256 optional str The SHA-256 cryptographic hash of the file content, used to verify file integrity and ensure that the file has not been altered
format_ref required CvTermObjectId The structure or encoding used to store the contents of the file, typically indicated by its extension (e.g., .txt, .csv, .mzML, .raw, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
compression_format_ref optional CvTermObjectId The structure or encoding used to compress the contents of the file, typically indicated by its extension (e.g., .zip, .tar, .gz, etc.)
Target CV term type: descriptor
Validation Rule:
Allowed Parent CV Terms:
* [EDAM, EDAM:1915, Format]
Allow parent CV Term: No
Allow only leaf CV Terms: No
extension optional str The extension of file. It MUST contain all extensions (e.g., .raw, .mzML, .d.zip, .raw.zip, etc.)

Node Relationships

Source Relationship Reverse Name Target Min Max Description
supplementary-file created-in has-supplementary-file study 1 N
supplementary-file described-as describes descriptor 0 N
supplementary-file referenced-in references metadata-file 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as supplementary-file 0 N
metadata-file references referenced-in supplementary-file 0 N
study has-supplementary-file created-in supplementary-file 0 N

MHD CV Term Objects

Characteristic Type

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be characteristic-type
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-type defined-in defines study 1 1 Required min count in the dataset: 2.
characteristic-type type-of has-type characteristic-value 0 N Required min count in the dataset: 2.

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
study defines defined-in characteristic-type 2 N Required min count in the dataset: 2.

Characteristic Value

Properties

Property Name Necessity Type Description
id optional CvTermValueObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term Value object
Its value MUST be characteristic-value
value optional str or int or float or Decimal
unit optional UnitCvTerm
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-value instance-of has-instance characteristic-definition 1 N Required min count in the dataset: 2.
characteristic-value value-of has-characteristic-value subject 1 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
characteristic-definition has-instance instance-of characteristic-value 0 N Required min count in the dataset: 2.
characteristic-type type-of has-type characteristic-value 0 N Required min count in the dataset: 2.
subject has-characteristic-value value-of characteristic-value 2 N

Data Provider

Properties

Property Name Necessity Type Description
id optional CvTermValueObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term Value object
Its value MUST be data-provider
value required str
unit optional UnitCvTerm
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
data-provider provides provided-by study 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description

Descriptor

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be descriptor
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
descriptor describes described-as assay 0 N
descriptor describes described-as study 0 N
descriptor describes described-as metadata-file 0 N
descriptor describes described-as raw-data-file 0 N
descriptor describes described-as derived-data-file 0 N
descriptor describes described-as supplementary-file 0 N
descriptor describes described-as result-file 0 N
descriptor describes described-as metabolite 0 N
descriptor describes described-as organization 0 N
descriptor describes described-as person 0 N
descriptor describes described-as project 0 N
descriptor describes described-as publication 0 N
descriptor describes described-as protocol 0 N
descriptor describes described-as sample 0 N
descriptor describes described-as subject 0 N
descriptor describes described-as sample-run 0 N
descriptor describes described-as sample-run-configuration 0 N
descriptor keyword-of has-repository-keyword study 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
assay described-as describes descriptor 0 N A link to a descriptor that describes the assay.
derived-data-file described-as describes descriptor 0 N A link to a descriptor that describes the derived data file.
metabolite described-as describes descriptor 0 N
organization described-as describes descriptor 0 N
person described-as describes descriptor 0 N
project described-as describes descriptor 0 N
protocol described-as describes descriptor 0 N
publication described-as describes descriptor 0 N
raw-data-file described-as describes descriptor 0 N
result-file described-as describes descriptor 0 N
sample described-as describes descriptor 0 N
sample-run described-as describes descriptor 0 N
study described-as describes descriptor 0 N
study has-repository-keyword keyword-of descriptor 0 N
study has-submitter-keyword keyword-of descriptor 0 N
subject described-as describes descriptor 0 N
supplementary-file described-as describes descriptor 0 N

Factor Type

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be factor-type
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
factor-type type-of has-type factor-value 0 N
factor-type used-in use-factor-type study 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description

Factor Value

Properties

Property Name Necessity Type Description
id optional CvTermValueObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term Value object
Its value MUST be factor-value
value optional str or int or float or Decimal
unit optional UnitCvTerm
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
factor-value instance-of has-instance factor-definition 1 N
factor-value value-of has-factor-value sample 1 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
factor-definition has-instance instance-of factor-value 0 N
factor-type type-of has-type factor-value 0 N
sample has-factor-value value-of factor-value 0 N

Metabolite Identifier

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be metabolite-identifier
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
metabolite-identifier reported-identifier-of identified-as metabolite 1 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
metabolite identified-as reported-identifier-of metabolite-identifier 0 N

Parameter Type

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be parameter-type
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-type type-of has-type parameter-value 0 N

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-value has-type type-of parameter-type 1 N Required min count in the dataset: 1.

Parameter Value

Properties

Property Name Necessity Type Description
id optional CvTermValueObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term Value object
Its value MUST be parameter-value
value optional str or int or float or Decimal
unit optional UnitCvTerm
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-value has-type type-of parameter-type 1 N Required min count in the dataset: 1.
parameter-value instance-of has-instance parameter-definition 1 N Required min count in the dataset: 1.

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description
parameter-definition has-instance instance-of parameter-value 0 N Required min count in the dataset: 1.
parameter-type type-of has-type parameter-value 0 N

Protocol Type

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be protocol-type
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description

Uri Type

Properties

Property Name Necessity Type Description
id optional CvTermObjectId The id property uniquely identifies the object
type optional MhdObjectType The type property identifies type of the CV Term object
Its value MUST be uri-type
source optional str Ontology source name
accession optional str Accession number of CV term in compact URI format
name optional str Label of CV term

Node Relationships

Source Relationship Reverse Name Target Min Max Description

Reverse Node Relationships

Source Relationship Reverse Name Target Min Max Description