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 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, 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: 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/"
Type: The enumerated relationship between the record and the associated DOI. The enumerated values are: Child Dataset, Collaborative/Other Agency, Field Campaign, Parent Dataset, Sibling Dataset, IsPreviousVersionOf, IsNewVersionOf, and 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.
- IsPreviousVersionOf: This collection has been superseded by the Associated DOI.
- IsNewVersionOf: The collection supersedes the Associated DOI.
- 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 to 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, Sibling Dataset, IsPreviousVersionOf, IsNewVersionOf, and 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 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).
Please see the expandable sections below for flowchart details.
Dialect Mappings
UMM Migration
None
Future Mappings
History
UMM Versioning
1.16.2 is the current UMM-C version. No changes were made to this element since the last documented changes below.
Version | Date | What Changed |
---|---|---|
1.18.0 | ProductionDate | The sub elements of Type and DescriptionOfTypeOther were added. |
1.16.1 | 2021-04-07 | This element was added to the UMM-C specification. |
1.18.2 | 2024-10-01 | Added 2 new enumerations for AssociatedDOIs/Type: (IsPreviousVersionOf, IsNewVersionOf) |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 2021-06-30 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space |