Page History
Table of Contents | ||
---|---|---|
|
Element Description
This element stores the DOIs (Digital Object Identifier) for associated collections. A DOI is a persistent identifier that is used to uniquely identify objects including datasets and documents. This element allows data providers to associate parent collections, or collections or other peer collections together. These DOIs are searchable through Earthdata Search and the CMR API. Use the "doi" parameter to search for collection DOIs or the associated DOIs.
This element also includes the option to provide information on the authority that registers the DOI as well as the title , a title, an enumerated type element to allow users to quickly understand the relationships, and a DescriptionOfTypeOther when the type has a value of Other, so that curators can explain the relationship that is not in the type enumeration list.
Best Practices
The Associated DOIs main element is defined as a list of Associated DOIs, which means that 1 or more associations with other collections or other items can be made. There are multiple sub-elements that comprise Associated DOIs:
DOI: The DOI (Digital Object Identifier) that identifies the associated collection.
- When providing information in the DOI field, only the DOI string should be provided. The string value should begin with the directory indicator.
- The DOI URL should not be stored in the DOI element but should instead be provided as a RelatedURL.
- For ESDIS providers specifically:
- More details on the ESDIS DOI process can be found here: ESDIS DOI Process
- A list of DOIs registered through ESDIS can be found here: EOSDIS ESDIS DOIs Status and Listing
- The directory indicator for ESDIS is "10." Therefore, if the DOI was registered through ESDIS, the beginning of the DOI string should be "10.5067".
Title: The title or very short description of the item the DOI describes.
Authority: The DOI organization that is responsible for creating the DOI.
- For ESDIS providers specifically:
- The CollectionDOI/Authority element value should be "https://doi.org/"
Examples:
DOI: "10.5067/ISS/CATS/L2O_N-M7.1-V2-01_05KMPRO"
Title: " CATS-ISS Level 2 Operational Night Mode 7.1 Version 2-01 5 km Profile"
Authority: "https://doi.org/"
Type: The enumerated relationship between the record and the associated DOI. The enumerated values are: Child Dataset, Collaborative/Other Agency, Field Campaign, Parent Dataset, and Related Dataset, Other
- Child Dataset: A dataset generated from another dataset.
- Collaborative/Other Agency: Two or more organizations/agencies working together on a data product, service/tool, or documentation.
- Document/Manuscript: Documentation related or associated to the dataset.
- Field Campaign: A related or associated series of field operations intended to achieve a particular objective for the product.
- Parent Dataset: A dataset that generates other datasets.
- Sibling Dataset: An offspring (or related) dataset having a common parent.
- Other: An associated DOI not related to one of the elements defined enumerations.
Description Of Type Other: If the enumeration of Other is chosen for the Type element, the record curator needs to provide a short description that describes the relationship between the record and the associated DOI.
Examples:
DOI: "10.5067/ISS/CATS/L2O_N-M7.1-V2-01_05KMPRO"
Title: " CATS-ISS Level 2 Operational Night Mode 7.1 Version 2-01 5 km Profile"
Authority: "https://doi.org/"
Type: Related Dataset
Element Specification
Choice of:
Model | Element | Type | Constraints | Required? | Cardinality |
---|---|---|---|---|---|
UMM-C | AssociatedDOIs/DOI | String | 1 to 1024 characters | Yes | 1 |
UMM-C | AssociatedDOIs/Title | String | 1 |
Element Specification
Choice of:
Model | Element | Type | Constraints | Required? | Cardinality | |
---|---|---|---|---|---|---|
UMM-C | AssociatedDOIs/DOI | String | 1 to 1024 characters | Yes | 1 | |
UMM-C | AssociatedDOIs/Title | String | 1to 1030 characters | No | 0..1 | |
UMM-C | AssociatedDOIs/Authority | String | 1 to 80 characters | No | 0..1 | |
UMM-C | AssociatedDOIs/Type | Enumeration | Valid values: Child Dataset, Collaborative/Other Agency, Field Campaign, Parent Dataset, and Related Dataset, Other | No | 0..1 | |
UMM-C | AssociatedDOIs/DescriptionOfTypeOther | String | 1 to 1024 characters | Yes if Type=Other | 0 or 1 |
Metadata Validation and QA/QC
All metadata entering the CMR goes
Metadata Validation and QA/QC
All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).
Lucidchart rich-viewer false autofit true name Copy of Wiki Page Metadata Evaluation Workflow-1939-51df84 width 1102 pages-to-display id 98e5dc28-3252-4209-953f-66f1378e1cf4 align Left height 299
Please see the expandable sections below for flowchart details.
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Expand | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||
ARC Automated Rules Checks ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information. If a value is provided, return is "OK." |
Dialect Mappings
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIF 10
Example Mapping
Example Mapping
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ECHO 10Only 1 DOI may be provided (Cardinality: 1) Choice of: | UMM-C Element | ECHO 10 Path | Type | Constraints | Required in ECHO10? | Cardinality | Notes | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AssociatedDOIs/DOI | AssociatedDOIs/AssociatedDOI/DOI | String | n/a | 1 - 1024 characters | Yes | 1 | n/a | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AssociatedDOIs/DOI | AssociatedDOIs/AssociatedDOI/Title | String | n/a | 1 - 1030 characters | No | 0..1 | n/a | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AssociatedDOIs/DOI | AssociatedDOIs/AssociatedDOI/Authority | String | n/a | 1 - 80 characters | No | 0..1 | n/a |
Section | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ECHO 10Only 1 DOI may be provided (Cardinality: 1) Choice of:
Example Mapping
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 MENDS
Example Mapping
| |||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 MENDS | |||||||||||||||||||||||||||||||||||||||||||||||||||
UMM-C Element | ISO 19115-2 MENDS Path | Type | Notes | Where the Associated DOI string is provided. | String | The value of "gov.nasa.esdis.umm.associateddoi" should be provided here so that CMR can properly parse out the associated DOI. | |||||||||||||||||||||||||||||||||||||||||||||
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification /gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier /gmd:description/gco:CharacterString contains associated doi | String | The value must contain the string "associated doi" so that CMR can properly identify and translate the associated DOI. | |||||||||||||||||||||||||||||||||||||||||||||||||
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:associationType/gmd:DS_AssociationTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#DS_AssociationTypeCode" codeListValue="associatedDOIs" | String | Choose the "associatedDOIs" codelist value so that CMR can properly identify the Associated DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'associatedDOIs' indicates to CMR that the Authority element should be mapped. | AssociatedDOIs/Title | /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:aggregateDataSetName/gmd:CI_Citation /gmd:title/gco:CharacterString | String | AssociatedDOIs/Authority/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier /gmd:authority/gmd:CI_Citation/gmd:title - empty element | String | Leave this element empty. | |||||||||||||||||||||||||||||||||||||||||||
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier /gmd:authority/gmd:CI_Citation/gmd:date - empty element | String | Leave this element empty. | |||||||||||||||||||||||||||||||||||||||||||||||||
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier /gmd:authority/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty /gmd:organisationName/gco:CharacterString | String | Provide the authority here. For ESDIS providers, recommend listing "https://doi.org" as the DOI authority. | |||||||||||||||||||||||||||||||||||||||||||||||||
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo /gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier /gmd:authority/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty /gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="" = authority | Codelist | Choose the "authority" codelist value so that CMR can properly identify the DOI/Authority element. This codelist value does not directly map to a UMM element - choosing 'authority' indicates to CMR that the Authority element should be mapped. |
Section | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 SMAP
Example Mapping
|
UMM Migration
None
Future Mappings
Expand | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||
ISO 19115-1
Example Mapping
|
History
UMM Versioning
Excerpt Include | ||||||
---|---|---|---|---|---|---|
|
Version | Date | What Changed | ||
---|---|---|---|---|
1.18.0 | ProductionDate | The sub elements of Type and DescriptionOfTypeOther were added. | ||
1.16.1 | 2021-04 | /-07 | /2021This element was added to the UMM-C specification. |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 2021-06-30 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space |