Data Submission/Data Upload: Difference between revisions

Latest revision as of 16:53, 18 September 2026

Instructions to submit Biomarker Data

To submit data for the BiomarkerKB Portal, the biomarker data model must be followed. Instructions on how to format the data for submission, where to send it, and creating a BCO for the data submitted are provided below.

Create a TSV file with the agreed upon fields which correspond to the biomarker data model.
Once your data is formatted and cleaned, please send it to mazumder_lab@gwu.edu.
Concurrently with submitting data please provide metadata and description on how biomarker data was collected. This is important for adding submitted data to the Biomarker Data page as each dataset needs a BioCompute Object (BCO). Examples of BCOs are available on the biomarker data page.
If there are any further questions please consult the GitHub Documentation for contributing data.

BiomarkerKB data model fields

This is the standard way to report biomarker data. This section covers how biomarkers should be reported and how other fields should be filled out.

To make reporting easier, please use these templates with color-coded fields: orange for mandatory and green for optional.

Disease biomarkers: Download the Disease Biomarker Template
- Example of a disease biomarker: AN5370-8
Exposure agent biomarkers: Download the Exposure Agent Biomarker Template
- Example of an exposure agent biomarker: BMKB151582-1

Headers

Your file must contain the following headers:

biomarker_index (required): biomarker counter - integer (1, 2, 3...).
- component_index (required): sub-index within biomarker_index. Component counter within each biomarker (integer). To learn the difference between single and multicomponent biomarkers, see Single biomarker and Multicomponent biomarker.
  - entity_index (required): sub-index within component_index. Entity counter within each component (integer). This index is used to represent complex entities such as glycoforms or protein complexes. E.g., in a biomarker where a glycoprotein is being measured, within one component entity 1 is a glycan, while entity 2 is a protein. See Multi-entity biomarker.
  - assessed_biomarker_entity_id (required): entity ID for each entity_index
  - assessed_biomarker_entity (required): see assessed_biomarker_entity
  - assessed_entity_type (required): see assessed_entity_type
biomarker_controlled_vocab (required): this replaces the field "biomarker" (see below) to emphasize that controlled vocabulary is expected. This field is going to be broken down into three items: change, aspect, and entity.
taxonomy_id (optional): taxonomy ID of the organism in which the biomarker has been measured (human, mouse, zebrafish...)
condition or exposure_agent (optional): see condition or exposure_agent
condition_id or exposure_agent_id (required): see condition_id or exposure_agent_id
best_biomarker_role (optional): see best_biomarker_role
specimen (optional): see specimen
specimen_id (required): see specimen_id
loinc_code (optional): see loinc_code
evidence_source (optional): see evidence_source
evidence (optional): see evidence

Biomarker representation framework

A biomarker is not simply a gene, protein, metabolite, or other biological entity. A biomarker must include a defined measurement or change concept — such as presence, absence, increase, or decrease — describing what is observed. For example, EGFR alone is not a biomarker, but a specific EGFR mutation used for diagnostic, prognostic, or treatment-selection purposes is. Likewise, "IL6" alone is not a biomarker, but "increased IL6 expression" in a defined clinical context may be.

The fields below fall into two groups. Core fields directly align with the biomarker definition: biomarker, assessed_biomarker_entity, assessed_biomarker_entity_id, condition, condition_id, exposure_agent, and exposure_agent_id. Contextual fields enrich the representation: specimen, best_biomarker_role, and evidence.

In the BiomarkerKB accession model, the canonical biomarker concept represents the measured change or observation (e.g. "increased IL6 expression"), and disease- or condition-specific records are represented as child records linked to that canonical biomarker.

biomarker

Follow the BiomarkerKB Controlled Vocabulary for standardized reporting. There are several distinctions here and changes are made based on the entity being reported. The text should be in lowercase except when a gene name appears then it should remain all uppercase. Examples

Increased level of protein SPP1/UPKB:P10451
Increased expression of RNA PCA3/HGNC:8637
Increased expression of gene B2M PCA3/NCBI:567
Increased methylation in gene VIM/NCBI:7431

For more examples please refer to the BiomarkerKB Data Page

assessed_biomarker_entity

assessed_biomarker_entity is the entity in which the change is assessed. Should start off with a capital letter but if it is just a gene then it should remain in all capitals (e.g Myosin-binding protein H-like or IL6). If the entity type is anything but a gene the whole name should be typed out.

assessed_biomarker_entity_id

Refer to the GitHub documentation for which standards to follow.

Assessed Entity Type	Resource (in order of preference/availability)
Carbohydrate	Chemical Entities of Biological Interest (ChEBI)
Cell	Cell Ontology (CO) -> National Cancer Institute Thesaurus (NCIt)
Chemical Element	PubChem (PCCID) -> National Cancer Institute Thesaurus (NCIt)
DNA	National Cancer Institute Thesaurus (NCIt)
Gene	NCBI
Gene (mutation)	NCBI dbSNP
Glycan	GlyTouCan Accession (GTC) -> PubChem (PCCID)
Lipoprotein	Chemical Entities of Biological Interest (ChEBI)
Metabolite	PubChem (PCCID) -> Chemical Entities of Biological Interest (ChEBI)
Peptide	Protein Ontology (PRO)
Protein	Uniprot (UPKB) -> Protein Data Bank (PDB) -> Protein Ontology (PRO) -> National Cancer Institute Thesaurus (NCIt)
Protein Complex	Protein Ontology (PRO) -> Gene Ontology (GO)
RNA	HUGO Gene Nomenclature Committee (HGNC) -> RNA Central (RNAC)
miRNA	miRBase (MRB)

Refer to the GitHub Documentation for the correct resource.

assessed_entity_type

Report in all lowercase.

Example: gene

Only the following entity types are allowed:

protein
glycan
DNA
RNA
cell
lipid
image
metabolite
element
gene

condition

condition should be reported in all lowercase.

Example: colon cancer

condition_id

condition_id (from Disease Ontology, MONDO, or SNOMED or NCIt). Format as DOID:0080600. Refer to https://disease-ontology.org/do/.

Example: DOID:219

exposure_agent

Report in all lowercase. The exposure_agent documents any external stimulus, treatment, environmental factor, or intervention relevant to the biomarker's expression or activity. It provides context for biomarkers that respond to specific exposures rather than intrinsic disease processes (for example, response biomarkers). Leave blank if not applicable. Example: cisplatin

exposure_agent_id

The ontology identifier for the exposure_agent, provided in the following column. Leave blank if not applicable. Example: CHEBI:27899

best_biomarker_role

Report in all lowercase. Refer to the [BEST Resource](https://www.ncbi.nlm.nih.gov/books/NBK326791/) to infer the correct biomarker role. Accepted role terms are:

diagnostic: Detects or confirms the presence of a disease or condition, or identifies individuals with a specific disease subtype.
monitoring: Assesses the status of a disease, medical condition, or exposure to a medical product over time.
predictive: Identifies which patients are more or less likely to respond favorably or unfavorably to a specific treatment or exposure.
prognostic: Identifies the likelihood of a clinical event, disease recurrence, or progression in patients with an already established disease or condition.
response: Shows that a biological response has occurred in a patient after being exposed to a medical product or environmental agent.
risk: Indicates the potential for an individual to develop a disease or condition in the future.
safety: Measures or indicates the likelihood, nature, or severity of adverse effects, toxicity, or organ injury.

If reporting more than one, use separate rows. Example:

`biomarker_index`	`component_index`	`entity_index`	`biomarker`	...	`best_biomarker_role`
1	1	1	increased protein X	...	diagnostic
1	1	1	increased protein X	...	monitoring

specimen

Report in all lowercase. Leave blank if not applicable.

Example: feces

If reporting more than one, use separate rows. Example:

`biomarker_index`	`component_index`	`entity_index`	`biomarker`	...	`specimen`	`specimen_id`
1	1	1	increased protein X	...	blood	UBERON:0000178
1	1	1	increased protein X	...	urine	UBERON:0001088

specimen_id

specimen_id in the following column should be from UBERON. Format as UBERON:0000178. Refer to https://www.ebi.ac.uk/ols4/ontologies/uberon. Leave blank if not applicable.

Example: UBERON:0001988

loinc_code

Report the Logical Observation Identifiers Names and Codes (LOINC) code corresponding to the test or measurement (e.g. 77354-9). Format as LOINC:100153-6. Refer to https://loinc.org/ (you may need to create an account to access the search functionality). Leave blank if not applicable.

Example: 77354-9

evidence

One or more exact citations from the evidence source (in most cases, it will be the PubMed publication).

evidence_source

Report in the format SOURCE:ID, for example PubMed:32677844.

If reporting more than one, use separate rows. Example:

`biomarker_index`	`component_index`	`entity_index`	`biomarker`	...	`evidence`	`evidence_source`
1	1	1	increased protein X	...	Insert a quote from the paper	PubMed:26243686
1	1	1	increased protein X	...	Insert a quote from the paper	PubMed:25096510

annotations

Provide extra annotations from your DCC with the agreed upon standards from the Biomarker Annotation RFC. This data does not have to follow the data model and can be submitted in a separate file or can be added in the comment field. For example, relevant EHR data/LOINC data for biomarkers/biomarker entities can be included in a separate sheet.

@@ Line 1: / Line 1: @@
-==Instructions to submit Biomarker Data==
+== Instructions to submit Biomarker Data ==
-To submit data for the BiomarkerKB Portal, the biomarker data model must be followed. Instructions on how to format the data for submission, where to send it, and creating a BCO for the data submitted will be provided below.
+To submit data for the BiomarkerKB Portal, the biomarker data model must be followed. Instructions on how to format the data for submission, where to send it, and creating a BCO for the data submitted are provided [[Data Submission/Data Upload#Headers|below]].
-# Biomarker data collected should follow the biomarker data model.
+# Create a TSV file with the agreed upon fields which correspond to the biomarker data model.
-# "Core" fields should be filled in from the data source where biomarker data is collected. Core fields:
+# Once your data is formatted and cleaned, please send it to mazumder_lab@gwu.edu.
-## <code>biomarker</code>
+# Concurrently with submitting data please provide metadata and description on how biomarker data was collected. This is important for adding submitted data to the Biomarker Data page as each dataset needs a BioCompute Object (BCO). Examples of BCOs are available on the [https://data.biomarkerkb.org/BMK_000001 biomarker data page].
-## <code>assessed_biomarker_entity</code> and <code>assessed_biomarker_entity_id</code>
+# If there are any further questions please consult the [https://github.com/clinical-biomarkers/biomarker-partnership/blob/main/supplementary_files/documentation/contributing_data.md GitHub Documentation] for contributing data.
-## <code>condition</code> and <code>condition_id</code> OR <code>exposure_agent</code> and <code>exposure_agent_id</code>
-## <code>component_group</code> containing integers (1, 2, 3...) from 1 to N where N is the number of components. Normally N would simply be equal to the number of rows, unless your data contains multicomponent biomarkers. A multicomponent biomarker must have the same integer in all rows related to that biomarker.
-# Other fields and annotations may also be collected from the data source, however if data is missing it can also be inferred or mapped from other sources.
-## <code>evidence</code> is one or more exact citations from the evidence source (in most cases, it will be the PubMed publication).
-# Apply the following standards to the data when possible:
-## <code>condition_id</code> = <code>DOID:0080600</code>. Refer to https://disease-ontology.org/do/.
-## <code>specimen_id</code> = <code>UBERON:0000178</code>. Refer to https://www.ebi.ac.uk/ols4/ontologies/uberon.
-## <code>loinc_code</code> = <code>LOINC:100153-6</code>. Refer to https://loinc.org/ (you may need to create an account to access the search functionality).
-## <code>evidence_source</code> = <code>SOURCE:ID</code>, for example <code>PubMed:32677844</code>
-## For <code>assessed_biomarker_entity_id</code> please refer to the [https://github.com/clinical-biomarkers/biomarker-controlled-vocabulary GitHub documentation] for which standards to follow
-# Provide extra annotations from your DCC/data with the agreed upon standards from the Biomarker Annotation RFC. This data does not have to follow the data model and can be submitted in a separate file or can be added in the <code>comment</code> field .
-## For example: Relevant EHR data/LOINC data for biomarkers/biomarker entities can be included in a separate sheet.
-# Create a tsv/json file with the agreed upon fields which correspond to the biomarker data model. The data dictionary provides details on what the different fields represent.
-## The preferred method for data submission is a json file as it will help ingest the data into the existing data efficiently. However, tsv file submissions are ok as well. In the GitHub, <code>data_conversion.py</code> script exists in the Data Conversion Folder and it will handle tsv to json file conversion and json to tsv file conversion as well.
-## The [BiomarkerKB data page] has examples of tsv data submissions and how the data should be formatted with the appropriate biomarker fields. Example
-# For panel biomarkers, if the biomarkers are part of the same panel, the biomarker_id value for each biomarker should be any string value that can uniquely identify which rows are part of the same biomarker panel. Documentation
-# If curating data in tsv format: If biomarker rows are part of the same biomarker entry but differ on specimen, evidence, or role, then the biomarker_id for each row should be any string value that can uniquely identify which rows are part of the same biomarker.
-=== Submission ===
+== BiomarkerKB data model fields ==
-Once your data is formatted and cleaned, please send it to mazumder_lab@gwu.edu.
-# Concurrently with submitting data please fill out the BCO Information: Biomarker Data Google Form.
-## This will give metadata and description on how biomarker data was collected and is important for adding submitted data to the Biomarker Data page. An example of a previous BCO is provided in the sheet and available on the biomarker data page as well. [https://hivelab.biochemistry.gwu.edu/biomarker-partnership/data/BCO_000435 Example]
-# If there are any further questions please consult the [https://github.com/clinical-biomarkers/biomarker-partnership/blob/main/supplementary_files/documentation/contributing_data.md GitHub Documentation] for contributing data or reach out to Daniall using the email above.
-==BiomarkerKB dataset datamodel fields==
+This is the standard way to report biomarker data. This section covers how biomarkers should be reported and how other fields should be filled out.
+To make reporting easier, please use these templates with color-coded fields: orange for mandatory and green for optional.
+* Disease biomarkers: [https://data.biomarkerkb.org/ln2downloads/templates/current/disease_biomarker_template.xlsx Download the Disease Biomarker Template]
+** Example of a disease biomarker: [https://biomarkerkb.org/biomarker/AN5370-8 AN5370-8]
+* Exposure agent biomarkers: [https://data.biomarkerkb.org/ln2downloads/templates/current/exposure_agent_biomarker_template.xlsx Download the Exposure Agent Biomarker Template]
+** Example of an exposure agent biomarker: [https://biomarkerkb.org/biomarker/BMKB151582-1 BMKB151582-1]
-This is the standard way to report biomarker data. This section covers how biomarkers should be reported and how other fields should be filled out.
 === Headers ===
 Your file must contain the following headers:
-* <code>biomarker_index</code> ('''required'''): biomarker counter - integer (1, 2, 3...)
+* <code>biomarker_index</code> ('''required'''): biomarker counter - integer (1, 2, 3...).
-** <code>component_index</code> ('''required'''): component counter within each biomarker (integer). In most cases, a biomarker would have only one component, unless it is a multicomponent biomarker. A multicomponent biomarker is a group of biological markers tested together to provide a comprehensive assessment of health, e.g., a lipid panel (blood test) that measures total cholesterol, LDL, HDL, and triglycerides. These four entities would occupy four rows with the <code>component_index</code> from 1 to 4 (see example table in the "Examples" section).
+** <code>component_index</code> ('''required'''): sub-index within <code>biomarker_index</code>. Component counter within each biomarker (integer). To learn the difference between single and multicomponent biomarkers, see [[Single biomarker]] and [[Multicomponent biomarker]].
-*** <code>entity_index</code> ('''required'''): entity counter within each component (integer). This index is used to represent complex entities such as glycoforms or protein complexes. E.g., in a biomarker where a glycoprotein is being measured, within one component entity 1 is a glycan, while entity 2 is a protein (see example in the "Examples" section).
+*** <code>entity_index</code> ('''required'''): sub-index within <code>component_index</code>. Entity counter within each component (integer). This index is used to represent complex entities such as glycoforms or protein complexes. E.g., in a biomarker where a glycoprotein is being measured, within one component entity 1 is a glycan, while entity 2 is a protein. See [[Multi-entity biomarker]].
-*** <code>assessed_biomarker_entity_id</code>: entity ID for each entity_index
+*** <code>assessed_biomarker_entity_id</code> ('''required'''): entity ID for each entity_index
-*** <code>assessed_biomarker_entity</code>: see [[Data Submission/Data Upload#assessed_biomarker_entity|assessed_biomarker_entity]]
+*** <code>assessed_biomarker_entity</code> ('''required'''): see [[Data Submission/Data Upload#assessed_biomarker_entity|assessed_biomarker_entity]]
-*** <code>assessed_entity_type</code>: see [[Data Submission/Data Upload#assessed_entity_type|assessed_entity_type]]
+*** <code>assessed_entity_type</code> ('''required'''): see [[Data Submission/Data Upload#assessed_entity_type|assessed_entity_type]]
-* <code>biomarker_controlled_vocab</code>: this replaces the field "biomarker" (see below) to emphasize that controlled vocabulary is expected
+* <code>biomarker_controlled_vocab</code> ('''required'''): this replaces the field "biomarker" (see below) to emphasize that controlled vocabulary is expected. This field is going to be broken down into three items: change, aspect, and entity.
-* <code>organism_name</code>: organism in which the biomarker has been measured (human, mouse, zebrafish...)
+* <code>taxonomy_id</code> (optional): taxonomy ID of the organism in which the biomarker has been measured (human, mouse, zebrafish...)
-* <code>condition</code>: see [[Data Submission/Data Upload#condition|condition]]
+* <code>condition</code> or <code>exposure_agent</code> (optional): see [[Data Submission/Data Upload#condition|condition]] or [[Data Submission/Data Upload#exposure_agent|exposure_agent]]
-* <code>condition_id</code>: see [[Data Submission/Data Upload#condition_id|condition_id]]
+* <code>condition_id</code> or <code>exposure_agent_id</code> ('''required'''): see [[Data Submission/Data Upload#condition_id|condition_id]] or [[Data Submission/Data Upload#exposure_agent_id|exposure_agent_id]]
-* <code>best_biomarker_role</code>: see [[Data Submission/Data Upload#best_biomarker_role|best_biomarker_role]]
+* <code>best_biomarker_role</code> (optional): see [[Data Submission/Data Upload#best_biomarker_role|best_biomarker_role]]
-* <code>specimen</code>: see [[Data_Submission/Data_Upload#specimen|specimen]]
+* <code>specimen</code> (optional): see [[Data_Submission/Data_Upload#specimen|specimen]]
-* <code>specimen_id</code>: see [[Data Submission/Data Upload#specimen_id|specimen_id]]
+* <code>specimen_id</code> ('''required'''): see [[Data Submission/Data Upload#specimen_id|specimen_id]]
-* <code>loinc_code</code>: see [[Data Submission/Data Upload#loinc_code|loinc_code]]
+* <code>loinc_code</code> (optional): see [[Data Submission/Data Upload#loinc_code|loinc_code]]
-* <code>evidence_source</code>: see [[Data Submission/Data Upload#evidence_source|evidence_source]]
+* <code>evidence_source</code> (optional): see [[Data Submission/Data Upload#evidence_source|evidence_source]]
-* <code>evidence</code>: see [[Data Submission/Data Upload#evidence|evidence]]
+* <code>evidence</code> (optional): see [[Data Submission/Data Upload#evidence|evidence]]
-==== Examples ====
-===== Multicomponent single-entity biomarker =====
-{| class="wikitable"
-|-
-! <code>biomarker_index</code> !! <code>component_index</code> !! <code>entity_index</code> !! <code>assessed_biomarker_entity</code>
-|-
-| 1 || 1 || 1 || total cholesterol
-|-
-| 1 || 2 || 1 || LDL
-|-
-| 1 || 3 || 1 || HDL
-|-
-| 1 || 4 || 1 || triglycerides
-|}
-===== Single-component multi-entity ("complex") biomarker =====
-[[File:Data upload example table.png|660px]]
-===== Multicomponent multi-entity biomarker =====
-{| class="wikitable"
-|-
-! <code>biomarker_index</code> !! <code>component_index</code> !! <code>entity_index</code> !! <code>assessed_biomarker_entity</code>
-|-
-| 2 || 1 || 1 || glycan A
-|-
-| 2 || 1 || 2 || protein X
-|-
-| 2 || 2 || 1 || some DNA
-|-
-| 2 || 3 || 1 || some RNA
-|}
-In this example, component 1 is a glycoprotein, component 2 is a DNA molecule, and component 3 is an RNA molecule.
 === Biomarker representation framework ===
@@ Line 91: / Line 42: @@
 In the BiomarkerKB accession model, the canonical biomarker concept represents the measured change or observation (e.g. "increased IL6 expression"), and disease- or condition-specific records are represented as child records linked to that canonical biomarker.
-=== biomarker_id ===
-A unique identifier assigned to each canonical biomarker concept. The canonical biomarker represents the measured change or observation (e.g. "increased IL6 expression"); disease- or condition-specific records are child records that share the same biomarker_id while differing in condition, specimen, or evidence. biomarker_id is assigned by the biomarkerKB data processing scripts automatically so the field can be left blank.
 === biomarker ===
-The biomarker field is the most important as follows the [https://github.com/clinical-biomarkers/biomarker-controlled-vocabulary BiomarkerKB Controlled Vocabulary] for standardized reporting. There are several distinctions here and changes are made based on the entity being reported. The text should be in lowercase except when a gene name appears then it should remain all uppercase.
+Follow the [https://github.com/clinical-biomarkers/biomarker-controlled-vocabulary BiomarkerKB Controlled Vocabulary] for standardized reporting. There are several distinctions here and changes are made based on the entity being reported. The text should be in lowercase except when a gene name appears then it should remain all uppercase.
 Examples
 * Increased level of protein SPP1/UPKB:P10451
@@ Line 105: / Line 53: @@
 === assessed_biomarker_entity ===
-assessed_biomarker_entity is the entity in which the change is assessed.
+<code>assessed_biomarker_entity</code> is the entity in which the change is assessed.
 Should start off with a capital letter but if it is just a gene then it should remain in all capitals (e.g Myosin-binding protein H-like or IL6).
 If the entity type is anything but a gene the whole name should be typed out.
 === assessed_biomarker_entity_id ===
+Refer to the [https://github.com/clinical-biomarkers/biomarker-controlled-vocabulary GitHub documentation] for which standards to follow.
 {| class="wikitable"
 !Assessed Entity Type
@@ Line 160: / Line 109: @@
 === assessed_entity_type ===
 Report in all lowercase.
 Example: gene
+Only the following entity types are allowed:
+* protein
+* glycan
+* DNA
+* RNA
+* cell
+* lipid
+* image
+* metabolite
+* element
+* gene
 === condition ===
-`condition` should be reported in all lowercase.
+<code>condition</code> should be reported in all lowercase.
-Example: colon cancer
+* Example: colon cancer
 === condition_id ===
-`condition_id` (from Disease Ontology, MONDO, or SNOMED or NCIt) should be provided in the following column.
+<code>condition_id</code> (from Disease Ontology, MONDO, or SNOMED or NCIt). Format as <code>DOID:0080600</code>. Refer to https://disease-ontology.org/do/.
-Example: DOID:219
+* Example: DOID:219
 === exposure_agent ===
@@ Line 189: / Line 151: @@
 * safety: Measures or indicates the likelihood, nature, or severity of adverse effects, toxicity, or organ injury.
-Example: diagnostic
+If reporting more than one, use separate rows. Example:
+{| class="wikitable"
+|-
+! <code>biomarker_index</code> !! <code>component_index</code> !! <code>entity_index</code> !! <code>biomarker</code> !! ... !! <code>best_biomarker_role</code>
+|-
+| 1 || 1 || 1 || increased protein X || ... || diagnostic
+|-
+| 1 || 1 || 1 || increased protein X || ... || monitoring
+|}
 === specimen ===
 Report in all lowercase. Leave blank if not applicable.
-Example: feces
+* Example: feces
+If reporting more than one, use separate rows. Example:
+{| class="wikitable"
+|-
+! <code>biomarker_index</code> !! <code>component_index</code> !! <code>entity_index</code> !! <code>biomarker</code> !! ... !! <code>specimen</code> !! <code>specimen_id</code>
+|-
+| 1 || 1 || 1 || increased protein X || ... || blood || UBERON:0000178
+|-
+| 1 || 1 || 1 || increased protein X || ... || urine || UBERON:0001088
+|}
 === specimen_id ===
-`specimen_id` in the following column should be from UBERON. Leave blank if not applicable.
+<code>specimen_id</code> in the following column should be from UBERON. Format as <code>UBERON:0000178</code>. Refer to https://www.ebi.ac.uk/ols4/ontologies/uberon. Leave blank if not applicable.
-Example: UBERON:0001988
+* Example: UBERON:0001988
 === loinc_code ===
-Report the Logical Observation Identifiers Names and Codes (LOINC) code corresponding to the test or measurement (e.g. 77354-9). Leave blank if not applicable.
+Report the Logical Observation Identifiers Names and Codes (LOINC) code corresponding to the test or measurement (e.g. 77354-9). Format as <code>LOINC:100153-6</code>. Refer to https://loinc.org/ (you may need to create an account to access the search functionality). Leave blank if not applicable.
-Example: 77354-9
+* Example: 77354-9
+=== evidence ===
+One or more exact citations from the evidence source (in most cases, it will be the PubMed publication).
+=== evidence_source ===
+Report in the format <code>SOURCE:ID</code>, for example <code>PubMed:32677844</code>.
+If reporting more than one, use separate rows. Example:
+{| class="wikitable"
+|-
+! <code>biomarker_index</code> !! <code>component_index</code> !! <code>entity_index</code> !! <code>biomarker</code> !! ... !! <code>evidence</code> !! <code>evidence_source</code>
+|-
+| 1 || 1 || 1 || increased protein X || ... || Insert a quote from the paper || PubMed:26243686
+|-
+| 1 || 1 || 1 || increased protein X || ... || Insert a quote from the paper || PubMed:25096510
+|}
+=== annotations ===
+Provide extra annotations from your DCC with the agreed upon standards from the Biomarker Annotation RFC. This data does not have to follow the data model and can be submitted in a separate file or can be added in the <code>comment</code> field. For example, relevant EHR data/LOINC data for biomarkers/biomarker entities can be included in a separate sheet.

Data Submission/Data Upload: Difference between revisions

Latest revision as of 16:53, 18 September 2026

Contents

Instructions to submit Biomarker Data

BiomarkerKB data model fields

Headers

Biomarker representation framework

biomarker

assessed_biomarker_entity

assessed_biomarker_entity_id

assessed_entity_type

condition

condition_id

exposure_agent

exposure_agent_id

best_biomarker_role

specimen

specimen_id

loinc_code

evidence

evidence_source

annotations

Navigation menu

Data Submission/Data Upload: Difference between revisions

Latest revision as of 16:53, 18 September 2026

Instructions to submit Biomarker Data

BiomarkerKB data model fields

Headers

Biomarker representation framework

biomarker

assessed_biomarker_entity

assessed_biomarker_entity_id

assessed_entity_type

condition

condition_id

exposure_agent

exposure_agent_id

best_biomarker_role

specimen

specimen_id

loinc_code

evidence

evidence_source

annotations

Navigation menu

Search