Class: Study
A study summarizes the overall goal of a research initiative and outlines the key objective of its underlying projects.
URI: nmdc:Study
classDiagram
class Study
click Study href "../Study"
NamedThing <|-- Study
click NamedThing href "../NamedThing"
Study : alternative_descriptions
Study : alternative_identifiers
Study : alternative_names
Study : alternative_titles
Study : associated_dois
Study --> "*" Doi : associated_dois
click Doi href "../Doi"
Study : description
Study : ecosystem
Study : ecosystem_category
Study : ecosystem_subtype
Study : ecosystem_type
Study : emsl_project_identifiers
Study : funding_sources
Study : gnps_task_identifiers
Study : gold_study_identifiers
Study : has_credit_associations
Study --> "*" CreditAssociation : has_credit_associations
click CreditAssociation href "../CreditAssociation"
Study : homepage_website
Study : id
Study : insdc_bioproject_identifiers
Study : jgi_portal_study_identifiers
Study : mgnify_project_identifiers
Study : name
Study : neon_study_identifiers
Study : notes
Study : objective
Study : part_of
Study --> "*" Study : part_of
click Study href "../Study"
Study : principal_investigator
Study --> "0..1" PersonValue : principal_investigator
click PersonValue href "../PersonValue"
Study : protocol_link
Study --> "*" Protocol : protocol_link
click Protocol href "../Protocol"
Study : related_identifiers
Study : specific_ecosystem
Study : study_category
Study --> "1" StudyCategoryEnum : study_category
click StudyCategoryEnum href "../StudyCategoryEnum"
Study : study_image
Study --> "*" ImageValue : study_image
click ImageValue href "../ImageValue"
Study : title
Study : type
Study : websites
Inheritance
- NamedThing
- Study
Slots
Name | Cardinality and Range | Description | Inheritance |
---|---|---|---|
emsl_project_identifiers | * ExternalIdentifier |
Identifiers that link a NMDC study to the EMSL user facility website hosting ... | direct |
gnps_task_identifiers | * ExternalIdentifier |
identifiers that link a NMDC study to a web-based report about metabolomics a... | direct |
gold_study_identifiers | * ExternalIdentifier |
identifiers for corresponding project(s) in GOLD | direct |
insdc_bioproject_identifiers | * ExternalIdentifier |
Unique identifier for a bioproject submitted to INSDC that relates to the NMD... | direct |
jgi_portal_study_identifiers | * ExternalIdentifier |
Identifiers that link a NMDC study to a website hosting raw and analyzed data... | direct |
mgnify_project_identifiers | * ExternalIdentifier |
identifiers for corresponding project in MGnify | direct |
neon_study_identifiers | * ExternalIdentifier |
direct | |
related_identifiers | 0..1 String |
Unique identifier for a study submitted to additional resources | direct |
alternative_descriptions | * String |
A list of alternative descriptions for the entity | direct |
alternative_names | * String |
A list of alternative names used to refer to the entity | direct |
alternative_titles | * String |
A list of alternative titles for the entity | direct |
ecosystem | 0..1 String |
An ecosystem is a combination of a physical environment (abiotic factors) and... | direct |
ecosystem_category | 0..1 String |
Ecosystem categories represent divisions within the ecosystem based on specif... | direct |
ecosystem_subtype | 0..1 String |
Ecosystem subtypes represent further subdivision of Ecosystem types into more... | direct |
ecosystem_type | 0..1 String |
Ecosystem types represent things having common characteristics within the Eco... | direct |
specific_ecosystem | 0..1 String |
Specific ecosystems represent specific features of the environment like aphot... | direct |
associated_dois | * Doi |
A list of DOIs associated with a resource, such as a list of DOIS associated ... | direct |
funding_sources | * String |
A list of organizations, along with the award numbers, that underwrite financ... | direct |
has_credit_associations | * CreditAssociation |
This slot links a study to a credit association | direct |
homepage_website | * String |
The website address (URL) of an entity's homepage | direct |
notes | 0..1 String |
direct | |
objective | 0..1 String |
The scientific objectives associated with the entity | direct |
part_of | * Study |
Links a study or consortium to a parent (or umbrella) study or consortium | direct |
principal_investigator | 0..1 PersonValue |
Principal Investigator who led the study and/or generated the dataset | direct |
protocol_link | * Protocol |
direct | |
study_category | 1 StudyCategoryEnum |
The type of research initiative | direct |
study_image | * ImageValue |
Links a study to one or more images | direct |
title | 0..1 String |
A name given to the entity that differs from the name/label programmatically ... | direct |
websites | * String |
A list of websites that are associated with the entity | direct |
id | 1 Uriorcurie |
A unique identifier for a thing | NamedThing |
name | 0..1 String |
A human readable label for an entity | NamedThing |
description | 0..1 String |
A brief, link-free summary of a Study | NamedThing |
alternative_identifiers | * Uriorcurie |
Unique identifier for a study submitted to additional resources | NamedThing |
type | 1 Uriorcurie |
the class_uri of the class that has been instantiated | NamedThing |
Usages
used by | used in | type | used |
---|---|---|---|
NucleotideSequencing | associated_studies | range | Study |
MassSpectrometry | associated_studies | range | Study |
Database | study_set | range | Study |
Biosample | associated_studies | range | Study |
Study | part_of | range | Study |
DataGeneration | associated_studies | range | Study |
Aliases
- proposal
- research proposal
- research study
- investigation
- project
- umbrella project
- research initiative
Comments
- The Study class can include both consortia and research studies.
TODOs
- determine how to get data values for submitted_to_insdc, investigation_type, experimental_factor
- project_name is redundant with name, so excluding it
Identifier and Mapping Information
Schema Source
- from schema: https://w3id.org/nmdc/nmdc
Mappings
Mapping Type | Mapped Value |
---|---|
self | nmdc:Study |
native | nmdc:Study |
exact | OBI:0000066, SIO:000747, NCIT:C41198, ISA:Investigation |
broad | prov:Activity |
LinkML Source
Direct
name: Study
description: A study summarizes the overall goal of a research initiative and outlines
the key objective of its underlying projects.
alt_descriptions:
embl.ena:
source: embl.ena
description: A study (project) groups together data submitted to the archive and
controls its release date. A study accession is typically used when citing data
submitted to ENA
todos:
- determine how to get data values for submitted_to_insdc, investigation_type, experimental_factor
- project_name is redundant with name, so excluding it
notes:
- sample GOLD link https://bioregistry.io/gold:Gs0110115
- sample insdc.srs link https://www.ebi.ac.uk/ena/browser/view/PRJEB45055 ?
- sample mgnify link https://www.ebi.ac.uk/metagenomics/studies/MGYS00005757
- GOLD, insdc.srs and mgnify are reasonable prefixes for alternative study identifiers,
but no longer for the Study.id
comments:
- The Study class can include both consortia and research studies.
in_subset:
- sample subset
from_schema: https://w3id.org/nmdc/nmdc
aliases:
- proposal
- research proposal
- research study
- investigation
- project
- umbrella project
- research initiative
exact_mappings:
- OBI:0000066
- SIO:000747
- NCIT:C41198
- ISA:Investigation
broad_mappings:
- prov:Activity
is_a: NamedThing
slots:
- emsl_project_identifiers
- gnps_task_identifiers
- gold_study_identifiers
- insdc_bioproject_identifiers
- jgi_portal_study_identifiers
- mgnify_project_identifiers
- neon_study_identifiers
- related_identifiers
- alternative_descriptions
- alternative_names
- alternative_titles
- ecosystem
- ecosystem_category
- ecosystem_subtype
- ecosystem_type
- specific_ecosystem
- associated_dois
- funding_sources
- has_credit_associations
- homepage_website
- notes
- objective
- part_of
- principal_investigator
- protocol_link
- study_category
- study_image
- title
- websites
slot_usage:
id:
name: id
required: true
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
name:
name: name
annotations:
tooltip:
tag: tooltip
value: Provide a name for the study your samples will belong with.
websites:
name: websites
annotations:
tooltip:
tag: tooltip
value: Link to the Principal Investigator's research lab webpage or the study
webpage associated with this collection of samples. Multiple links can be
provided.
homepage_website:
name: homepage_website
annotations:
tooltip:
tag: tooltip
value: Link to the consortium's homepage if the study_category is a consortium.
description:
name: description
annotations:
tooltip:
tag: tooltip
value: Provide a brief description of your study.
description: A brief, link-free summary of a Study
comments:
- Include links in other Study slots, such as websites or dois.
notes:
name: notes
annotations:
tooltip:
tag: tooltip
value: Add any additional notes or comments about this study.
alternative_identifiers:
name: alternative_identifiers
description: Unique identifier for a study submitted to additional resources.
Matches that which has been submitted to NMDC
alternative_names:
name: alternative_names
annotations:
tooltip:
tag: tooltip
value: Project, study, or sample set names the are also associated with this
submission or other names / identifiers for this study.
related_identifiers:
name: related_identifiers
description: Unique identifier for a study submitted to additional resources.
Similar, but not necessarily identical to that which has been submitted to NMDC
insdc_bioproject_identifiers:
name: insdc_bioproject_identifiers
annotations:
tooltip:
tag: tooltip
value: Provide the NCBI BioProject Accession Number associated with the listed
NCBI BioProject Title.
description: Unique identifier for a bioproject submitted to INSDC that relates
to the NMDC submitted study.
part_of:
name: part_of
description: Links a study or consortium to a parent (or umbrella) study or consortium.
comments:
- Value is the id of the umbrella study or consortium.
range: Study
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
protocol_link:
name: protocol_link
multivalued: true
inlined_as_list: true
class_uri: nmdc:Study
Induced
name: Study
description: A study summarizes the overall goal of a research initiative and outlines
the key objective of its underlying projects.
alt_descriptions:
embl.ena:
source: embl.ena
description: A study (project) groups together data submitted to the archive and
controls its release date. A study accession is typically used when citing data
submitted to ENA
todos:
- determine how to get data values for submitted_to_insdc, investigation_type, experimental_factor
- project_name is redundant with name, so excluding it
notes:
- sample GOLD link https://bioregistry.io/gold:Gs0110115
- sample insdc.srs link https://www.ebi.ac.uk/ena/browser/view/PRJEB45055 ?
- sample mgnify link https://www.ebi.ac.uk/metagenomics/studies/MGYS00005757
- GOLD, insdc.srs and mgnify are reasonable prefixes for alternative study identifiers,
but no longer for the Study.id
comments:
- The Study class can include both consortia and research studies.
in_subset:
- sample subset
from_schema: https://w3id.org/nmdc/nmdc
aliases:
- proposal
- research proposal
- research study
- investigation
- project
- umbrella project
- research initiative
exact_mappings:
- OBI:0000066
- SIO:000747
- NCIT:C41198
- ISA:Investigation
broad_mappings:
- prov:Activity
is_a: NamedThing
slot_usage:
id:
name: id
required: true
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
name:
name: name
annotations:
tooltip:
tag: tooltip
value: Provide a name for the study your samples will belong with.
websites:
name: websites
annotations:
tooltip:
tag: tooltip
value: Link to the Principal Investigator's research lab webpage or the study
webpage associated with this collection of samples. Multiple links can be
provided.
homepage_website:
name: homepage_website
annotations:
tooltip:
tag: tooltip
value: Link to the consortium's homepage if the study_category is a consortium.
description:
name: description
annotations:
tooltip:
tag: tooltip
value: Provide a brief description of your study.
description: A brief, link-free summary of a Study
comments:
- Include links in other Study slots, such as websites or dois.
notes:
name: notes
annotations:
tooltip:
tag: tooltip
value: Add any additional notes or comments about this study.
alternative_identifiers:
name: alternative_identifiers
description: Unique identifier for a study submitted to additional resources.
Matches that which has been submitted to NMDC
alternative_names:
name: alternative_names
annotations:
tooltip:
tag: tooltip
value: Project, study, or sample set names the are also associated with this
submission or other names / identifiers for this study.
related_identifiers:
name: related_identifiers
description: Unique identifier for a study submitted to additional resources.
Similar, but not necessarily identical to that which has been submitted to NMDC
insdc_bioproject_identifiers:
name: insdc_bioproject_identifiers
annotations:
tooltip:
tag: tooltip
value: Provide the NCBI BioProject Accession Number associated with the listed
NCBI BioProject Title.
description: Unique identifier for a bioproject submitted to INSDC that relates
to the NMDC submitted study.
part_of:
name: part_of
description: Links a study or consortium to a parent (or umbrella) study or consortium.
comments:
- Value is the id of the umbrella study or consortium.
range: Study
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
protocol_link:
name: protocol_link
multivalued: true
inlined_as_list: true
attributes:
emsl_project_identifiers:
name: emsl_project_identifiers
description: Identifiers that link a NMDC study to the EMSL user facility website
hosting the project description of an EMSL user project
title: EMSL Project Identifiers
todos:
- elaborate on description
notes:
- these identifiers are all currently 5 digits long but that could change in the
future
examples:
- value: emsl.project:60141
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://github.com/microbiomedata/nmdc-schema/issues/927#issuecomment-1802136437
rank: 1000
is_a: study_identifiers
mixins:
- emsl_identifiers
alias: emsl_project_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^emsl\.project:[0-9]{5}$
gnps_task_identifiers:
name: gnps_task_identifiers
description: identifiers that link a NMDC study to a web-based report about metabolomics
analysis progress and results
title: GNPS task identifiers
comments:
- this could be considered a related identifier, as the metabolomics progress
and results aren't a study per se
- this identifier was registered with bioregistry but not identifiers.org
examples:
- value: gnps.task:4b848c342a4f4abc871bdf8a09a60807
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://microbiomedata.github.io/nmdc-schema/MetabolomicsAnalysis/
rank: 1000
is_a: study_identifiers
mixins:
- gnps_identifiers
alias: gnps_task_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^gnps\.task:[a-f0-9]+$
gold_study_identifiers:
name: gold_study_identifiers
description: identifiers for corresponding project(s) in GOLD
title: GOLD Study Identifiers
comments:
- uses the prefix GS (but possibly in a different case)
examples:
- value: https://bioregistry.io/gold:Gs0110115
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/studies
rank: 1000
is_a: study_identifiers
mixins:
- gold_identifiers
alias: gold_study_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^gold:Gs[0-9]+$
insdc_bioproject_identifiers:
name: insdc_bioproject_identifiers
annotations:
tooltip:
tag: tooltip
value: Provide the NCBI BioProject Accession Number associated with the listed
NCBI BioProject Title.
description: Unique identifier for a bioproject submitted to INSDC that relates
to the NMDC submitted study.
comments:
- these are distinct IDs from INSDC SRA/ENA project identifiers, but are usually(?)
one to one
examples:
- value: https://bioregistry.io/bioproject:PRJNA366857
description: Avena fatua rhizosphere microbial communities - H1_Rhizo_Litter_2
metatranscriptome
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://www.ncbi.nlm.nih.gov/bioproject/
- https://www.ddbj.nig.ac.jp/bioproject/index-e.html
aliases:
- NCBI bioproject identifiers
- DDBJ bioproject identifiers
rank: 1000
is_a: study_identifiers
mixins:
- insdc_identifiers
alias: insdc_bioproject_identifiers
owner: Study
domain_of:
- NucleotideSequencing
- Study
range: external_identifier
multivalued: true
pattern: ^bioproject:PRJ[DEN][A-Z][0-9]+$
jgi_portal_study_identifiers:
name: jgi_portal_study_identifiers
id_prefixes:
- jgi.proposal
description: Identifiers that link a NMDC study to a website hosting raw and analyzed
data for a JGI proposal. The suffix of the curie can used to query the GOLD
API and is interoperable with an award DOI from OSTI and a GOLD study identifier.
title: JGI Portal Study identifiers
comments:
- Could this could be considered a related identifier?
- Curie suffix is the Site Award Number from an OSTI award page
- Site Award Number 507130 == award doi doi:10.46936/10.25585/60000017 -- GOLD
study identifier gold:Gs0154044
- bioregistry.io/jgi.proposal:507130 ==https://genome.jgi.doe.gov/portal/BioDefcarcycling/BioDefcarcycling.info.html
examples:
- value: jgi.proposal:507130
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
is_a: study_identifiers
mixins:
- jgi_portal_identifiers
alias: jgi_portal_study_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^jgi.proposal:\d+$
mgnify_project_identifiers:
name: mgnify_project_identifiers
description: identifiers for corresponding project in MGnify
examples:
- value: https://bioregistry.io/mgnify.proj:MGYS00005757
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
is_a: study_identifiers
mixins:
- mgnify_identifiers
alias: mgnify_project_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^mgnify.proj:[A-Z]+[0-9]+$
neon_study_identifiers:
name: neon_study_identifiers
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
is_a: study_identifiers
mixins:
- neon_identifiers
alias: neon_study_identifiers
owner: Study
domain_of:
- Study
range: external_identifier
multivalued: true
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_\.]+:[a-zA-Z0-9_][a-zA-Z0-9_\-\/\.,]*$
related_identifiers:
name: related_identifiers
description: Unique identifier for a study submitted to additional resources.
Similar, but not necessarily identical to that which has been submitted to NMDC
title: Related Identifiers
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: related_identifiers
owner: Study
domain_of:
- Study
range: string
alternative_descriptions:
name: alternative_descriptions
description: A list of alternative descriptions for the entity. The distinction
between description and alternative descriptions is application-specific.
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: alternative_descriptions
owner: Study
domain_of:
- Study
range: string
multivalued: true
alternative_names:
name: alternative_names
annotations:
tooltip:
tag: tooltip
value: Project, study, or sample set names the are also associated with this
submission or other names / identifiers for this study.
description: A list of alternative names used to refer to the entity. The distinction
between name and alternative names is application-specific.
from_schema: https://w3id.org/nmdc/nmdc
exact_mappings:
- dcterms:alternative
- skos:altLabel
rank: 1000
alias: alternative_names
owner: Study
domain_of:
- ChemicalEntity
- Study
range: string
multivalued: true
alternative_titles:
name: alternative_titles
description: A list of alternative titles for the entity. The distinction between
title and alternative titles is application-specific.
from_schema: https://w3id.org/nmdc/nmdc
exact_mappings:
- dcterms:alternative
rank: 1000
alias: alternative_titles
owner: Study
domain_of:
- Study
range: string
multivalued: true
ecosystem:
name: ecosystem
description: An ecosystem is a combination of a physical environment (abiotic
factors) and all the organisms (biotic factors) that interact with this environment.
Ecosystem is in position 1/5 in a GOLD path.
comments:
- The abiotic factors play a profound role on the type and composition of organisms
in a given environment. The GOLD Ecosystem at the top of the five-level classification
system is aimed at capturing the broader environment from which an organism
or environmental sample is collected. The three broad groups under Ecosystem
are Environmental, Host-associated, and Engineered. They represent samples collected
from a natural environment or from another organism or from engineered environments
like bioreactors respectively.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/help
rank: 1000
is_a: gold_path_field
alias: ecosystem
owner: Study
domain_of:
- Biosample
- Study
range: string
ecosystem_category:
name: ecosystem_category
description: Ecosystem categories represent divisions within the ecosystem based
on specific characteristics of the environment from where an organism or sample
is isolated. Ecosystem category is in position 2/5 in a GOLD path.
comments:
- The Environmental ecosystem (for example) is divided into Air, Aquatic and Terrestrial.
Ecosystem categories for Host-associated samples can be individual hosts or
phyla and for engineered samples it may be manipulated environments like bioreactors,
solid waste etc.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/help
rank: 1000
is_a: gold_path_field
alias: ecosystem_category
owner: Study
domain_of:
- Biosample
- Study
range: string
ecosystem_subtype:
name: ecosystem_subtype
description: Ecosystem subtypes represent further subdivision of Ecosystem types
into more distinct subtypes. Ecosystem subtype is in position 4/5 in a GOLD
path.
comments:
- Ecosystem Type Marine (Environmental -> Aquatic -> Marine) is further divided
(for example) into Intertidal zone, Coastal, Pelagic, Intertidal zone etc. in
the Ecosystem subtype category.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/help
rank: 1000
is_a: gold_path_field
alias: ecosystem_subtype
owner: Study
domain_of:
- Biosample
- Study
range: string
ecosystem_type:
name: ecosystem_type
description: Ecosystem types represent things having common characteristics within
the Ecosystem Category. These common characteristics based grouping is still
broad but specific to the characteristics of a given environment. Ecosystem
type is in position 3/5 in a GOLD path.
comments:
- The Aquatic ecosystem category (for example) may have ecosystem types like Marine
or Thermal springs etc. Ecosystem category Air may have Indoor air or Outdoor
air as different Ecosystem Types. In the case of Host-associated samples, ecosystem
type can represent Respiratory system, Digestive system, Roots etc.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/help
rank: 1000
is_a: gold_path_field
alias: ecosystem_type
owner: Study
domain_of:
- Biosample
- Study
range: string
specific_ecosystem:
name: specific_ecosystem
description: Specific ecosystems represent specific features of the environment
like aphotic zone in an ocean or gastric mucosa within a host digestive system.
Specific ecosystem is in position 5/5 in a GOLD path.
comments:
- Specific ecosystems help to define samples based on very specific characteristics
of an environment under the five-level classification system.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://gold.jgi.doe.gov/help
rank: 1000
is_a: gold_path_field
alias: specific_ecosystem
owner: Study
domain_of:
- Biosample
- Study
range: string
associated_dois:
name: associated_dois
description: A list of DOIs associated with a resource, such as a list of DOIS
associated with a Study.
examples:
- value: '[{''doi'': ''doi:10.46936/intm.proj.2021.60141/60000423'', ''doi_provider'':
''emsl'', ''doi_category'': ''award_doi''}, {''doi'': ''doi:10.1101/2022.12.12.520098'',
''doi_category'': ''publication_doi''}, {''doi'': ''doi:10.48321/D1Z60Q'',
''doi_category'': ''data_management_plan_doi'', ''doi_provider'': ''gsc''}]'
description: Provides a list of two DOIs; specifically, an EMSL award DOI and
a publication DOI.
in_subset:
- data_portal_subset
from_schema: https://w3id.org/nmdc/nmdc
aliases:
- Associated DOIs
- Associated digital object identifiers
rank: 1000
alias: associated_dois
owner: Study
domain_of:
- Study
range: Doi
multivalued: true
inlined: true
inlined_as_list: true
funding_sources:
name: funding_sources
description: A list of organizations, along with the award numbers, that underwrite
financial support for projects of a particular type. Typically, they process
applications and award funds to the chosen qualified applicants.
comments:
- Include only the name of the funding organization and the award or contract
number.
examples:
- value: National Sciences Foundation Dimensions of Biodiversity (award no. 1342701)
- value: U.S. Department of Energy, Office of Science, Office of Biological and
Environmental Research (BER) under contract DE-AC05-00OR2275
from_schema: https://w3id.org/nmdc/nmdc
close_mappings:
- NCIT:C39409
rank: 1000
alias: funding_sources
owner: Study
domain_of:
- Study
range: string
multivalued: true
has_credit_associations:
name: has_credit_associations
annotations:
tooltip:
tag: tooltip
value: Other researchers associated with this study.
description: 'This slot links a study to a credit association. The credit association
will be linked to a person value and to a CRediT Contributor Roles term. Overall
semantics: person should get credit X for their participation in the study'
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
slot_uri: prov:qualifiedAssociation
alias: has_credit_associations
owner: Study
domain_of:
- Study
range: CreditAssociation
multivalued: true
inlined: true
inlined_as_list: true
homepage_website:
name: homepage_website
annotations:
tooltip:
tag: tooltip
value: Link to the consortium's homepage if the study_category is a consortium.
description: The website address (URL) of an entity's homepage.
examples:
- value: https://www.neonscience.org/
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
is_a: websites
alias: homepage_website
owner: Study
domain_of:
- Study
range: string
multivalued: true
pattern: ^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?!.*[Dd][Oo][Ii]\.[Oo][Rr][Gg]).*$
maximum_cardinality: 1
notes:
name: notes
annotations:
tooltip:
tag: tooltip
value: Add any additional notes or comments about this study.
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: notes
owner: Study
domain_of:
- Study
range: string
objective:
name: objective
description: The scientific objectives associated with the entity. It SHOULD correspond
to scientific norms for objectives field in a structured abstract.
from_schema: https://w3id.org/nmdc/nmdc
mappings:
- SIO:000337
rank: 1000
alias: objective
owner: Study
domain_of:
- Study
range: string
part_of:
name: part_of
description: Links a study or consortium to a parent (or umbrella) study or consortium.
comments:
- Value is the id of the umbrella study or consortium.
from_schema: https://w3id.org/nmdc/nmdc
aliases:
- is part of
rank: 1000
slot_uri: dcterms:isPartOf
alias: part_of
owner: Study
domain_of:
- FieldResearchSite
- Study
range: Study
multivalued: true
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
principal_investigator:
name: principal_investigator
description: Principal Investigator who led the study and/or generated the dataset.
from_schema: https://w3id.org/nmdc/nmdc
aliases:
- PI
rank: 1000
alias: principal_investigator
owner: Study
domain_of:
- Study
- DataGeneration
range: PersonValue
protocol_link:
name: protocol_link
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: protocol_link
owner: Study
domain_of:
- PlannedProcess
- Study
range: Protocol
multivalued: true
inlined_as_list: true
study_category:
name: study_category
description: The type of research initiative
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: study_category
owner: Study
domain_of:
- Study
range: StudyCategoryEnum
required: true
study_image:
name: study_image
description: Links a study to one or more images.
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: study_image
owner: Study
domain_of:
- Study
range: ImageValue
multivalued: true
inlined: true
inlined_as_list: true
title:
name: title
description: A name given to the entity that differs from the name/label programmatically
assigned to it. For example, when extracting study information for GOLD, the
GOLD system has assigned a name/label. However, for display purposes, we may
also wish the capture the title of the proposal that was used to fund the study.
from_schema: https://w3id.org/nmdc/nmdc
exact_mappings:
- dcterms:title
rank: 1000
alias: title
owner: Study
domain_of:
- Study
range: string
websites:
name: websites
annotations:
tooltip:
tag: tooltip
value: Link to the Principal Investigator's research lab webpage or the study
webpage associated with this collection of samples. Multiple links can be
provided.
description: A list of websites that are associated with the entity.
comments:
- DOIs should not be included as websites. Instead, use the associated_dois slot.
- A consortium's homepage website should be included in the homepage_website slot,
not in websites.
- consortium is a convenience term for a Study whose study_category value is consortium
- the website slot and its subproperties are virtually identical to the url slot,
except that they are multivalued and url is single-valued.
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- nmdc:url
rank: 1000
alias: websites
owner: Study
domain_of:
- PersonValue
- Study
range: string
multivalued: true
pattern: ^[Hh][Tt][Tt][Pp][Ss]?:\/\/(?!.*[Dd][Oo][Ii]\.[Oo][Rr][Gg]).*$
id:
name: id
description: A unique identifier for a thing. Must be either a CURIE shorthand
for a URI or a complete URI
notes:
- 'abstracted pattern: prefix:typecode-authshoulder-blade(.version)?(_seqsuffix)?'
- a minimum length of 3 characters is suggested for typecodes, but 1 or 2 characters
will be accepted
- typecodes must correspond 1:1 to a class in the NMDC schema. this will be checked
via per-class id slot usage assertions
- minting authority shoulders should probably be enumerated and checked in the
pattern
examples:
- value: nmdc:mgmag-00-x012.1_7_c1
description: https://github.com/microbiomedata/nmdc-schema/pull/499#discussion_r1018499248
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
identifier: true
alias: id
owner: Study
domain_of:
- NamedThing
range: uriorcurie
required: true
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_\.]+:[a-zA-Z0-9_][a-zA-Z0-9_\-\/\.,]*$
structured_pattern:
syntax: '{id_nmdc_prefix}:sty-{id_shoulder}-{id_blade}$'
interpolated: true
name:
name: name
annotations:
tooltip:
tag: tooltip
value: Provide a name for the study your samples will belong with.
description: A human readable label for an entity
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: name
owner: Study
domain_of:
- PersonValue
- NamedThing
- Protocol
range: string
description:
name: description
annotations:
tooltip:
tag: tooltip
value: Provide a brief description of your study.
description: A brief, link-free summary of a Study
comments:
- Include links in other Study slots, such as websites or dois.
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
slot_uri: dcterms:description
alias: description
owner: Study
domain_of:
- ImageValue
- NamedThing
range: string
alternative_identifiers:
name: alternative_identifiers
description: Unique identifier for a study submitted to additional resources.
Matches that which has been submitted to NMDC
from_schema: https://w3id.org/nmdc/nmdc
rank: 1000
alias: alternative_identifiers
owner: Study
domain_of:
- MetaboliteIdentification
- NamedThing
range: uriorcurie
multivalued: true
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_\.]+:[a-zA-Z0-9_][a-zA-Z0-9_\-\/\.,]*$
type:
name: type
description: the class_uri of the class that has been instantiated
notes:
- replaces legacy nmdc:type slot
- makes it easier to read example data files
- required for polymorphic MongoDB collections
examples:
- value: nmdc:Biosample
- value: nmdc:Study
from_schema: https://w3id.org/nmdc/nmdc
see_also:
- https://github.com/microbiomedata/nmdc-schema/issues/1048
- https://github.com/microbiomedata/nmdc-schema/issues/1233
- https://github.com/microbiomedata/nmdc-schema/issues/248
rank: 1000
slot_uri: rdf:type
designates_type: true
alias: type
owner: Study
domain_of:
- EukEval
- FunctionalAnnotationAggMember
- MobilePhaseSegment
- PortionOfSubstance
- MagBin
- MetaboliteIdentification
- PeptideQuantification
- ProteinQuantification
- GenomeFeature
- FunctionalAnnotation
- AttributeValue
- NamedThing
- FailureCategorization
- Protocol
- CreditAssociation
- Doi
range: uriorcurie
required: true
class_uri: nmdc:Study