Element Description
The Collection Citations element provides the information required to properly cite a data product in professional scientific literature. Providing the Collection Citation is also useful for the attribution of data products in external data catalogs. This information is for citing the collection itself, and is not designed for bibliographic references related to the collection. Any references related to the collection should be provided in the Publication Reference element.
Best Practices
While Collection Citations is not required, it is highly recommended that it be provided so that the dataset may be appropriately cited. The dataset citation should also be provided on the collection's dataset landing page.
There are seventeen sub-elements that comprise Collection Citation:
Creators: The name of the organization(s) or individual(s) with primary intellectual responsibility for the collection's development.
Editors: The individual(s) responsible for changing the data in the collection.
Title: The title of the collection; this should be the same as the collection Entry Title.
Series Name: The name of the data series, or aggregate data of which the data is a part.
Release Date: The date when the collection was made available for release.
Release Place: The name of the city (and state or province and country if needed) where the collection was made available for release.
Publisher: The name of the individual or organization that made the collection available for release.
Version: The version of the collection. This should be the same value as provided in the Version element.
Issue Identification: The volume or issue number of the publication (if applicable).
Data Presentation Form: The mode in which the data are represented, e.g. atlas, image, profile, text, etc.
OnlineResource/Linkage: The URL of the website related to the online resource. For Collection Citation, this URL should link to the dataset landing page. If the collection has a DOI, then it is recommended that the DOI URL be provided here.
OnlineResource/Protocol: The protocol of the linkage for the online resource (e.g. https, svn, ftp, etc.). Providing a Protocol is optional.
OnlineResource/ApplicationProfile: The Application Profile holds the name of the application that can service the data. For example if the URL points to a word document, then the Application Profile is MS-Word. Providing an Application Profile is optional.
OnlineResource/Name: A name for the link to the collection. Providing Name is optional.
OnlineResource/Description: A brief description of the link to the collection. Providing a Description is optional.
OnlineResource/Function: The function of the online resource. This field originated from the ISO metadata standard where the valid values are: download, information, offlineAccess, order, and search. Providing a Function is optional.
OnlineResource/MimeType: MIME stands for "Multipurpose Internet Mail Extensions". Mime types are used to identify the nature and format of files provided on the Internet, and are typically used by internet browsers in order to determine how to properly process or display a document or file. Providing the Mime Type element in the metadata helps ensure that the URL contents will be properly displayed on the Web. Providing a Mime Type is optional. Mime Type is a controlled vocabulary field and should be chosen from the GCMD mime type keyword list.
Other Citation Details: Additional free-text information about the collection citation.
Examples:
CollectionCitations/Creator: "Global Modeling and Assimilation Office (GMAO)"
CollectionCitations/ReleasePlace: "Greenbelt, MD, USA"
CollectionCitations/Title: "tavgU_3d_udt_Cp: MERRA 3D IAU Tendency, Wind Components, Diurnal V5.2.0"
CollectionCitations/SeriesName: "MATUCPUDT"
CollectionCitations/Version: "5.2.0"
CollectionCitations/OnlineResource/Linkage: "https://disc.gsfc.nasa.gov/datacollection/MATUCPUDT_5.2.0.html"
CollectionCitations/OnlineResource/Publisher: "Goddard Earth Sciences Data and Information Services Center (GES DISC)"
CollectionCitations/OnlineResource/ReleaseDate: "2008-07-23T00:00:00.000Z"
CollectionCitations/OnlineResource/DataPresentationForm: "Digital Science Data"
Element Specification
Providing the Collection Citations element is optional. Only 1 Collection Citation may be provided (Cardinality: 0..1)
Model | Element | Type | Constraints | Required? | Cardinality | Notes |
---|---|---|---|---|---|---|
UMM-C | CollectionCitations/Creators | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/Editors | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/Title | String | 1 - 1030 characters | No | 0..1 | |
UMM-C | CollectionCitations/SeriesName | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/ReleaseDate | date-time | N/A | No | 0..1 | Dates must comply with the ISO 8601 Standard. |
UMM-C | CollectionCitations/ReleasePlace | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/Publisher | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/Version | String | 1 - 80 characters | No | 0..1 | |
UMM-C | CollectionCitations/IssueIdentification | String | 1 - 80 characters | No | 0..1 | |
UMM-C | CollectionCitations/DataPresentationForm | String | 1 - 80 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/Linkage | String | 1 - 1024 characters | Yes, if applicable | 1 | Providing a Linkage is optional, however, none of the OnlineResource sub-elements (see below) may be provided without a Linkage. Recommend providing the DOI URL is applicable. |
UMM-C | CollectionCitations/OnlineResource/Protocol | String | 1 - 80 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/ApplicationProfile | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/Name | String | 1 - 80 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/Description | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/Function | String | 1 - 1024 characters | No | 0..1 | |
UMM-C | CollectionCitations/OnlineResource/MimeType | String | KMS controlled | No | 0..1 | |
UMM-C | CollectionCitations/OtherCitationDetails | String | 1 - 4000 characters | No | 0..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
UMM Version 1.9.0 | Translation Direction | UMM Version 1.10.0 |
---|---|---|
History
UMM Versioning
Version | Date | What Changed |
---|---|---|
1.15.5 | 12/3/2020 | No changes were made for Collection Citations during the transition from version 1.15.4 to 1.15.5 |
1.15.4 | 9/18/2020 | No changes were made for Collection Citations during the transition from version 1.15.3 to 1.15.4 |
1.15.3 | 7/1/2020 | No changes were made for Collection Citations during the transition from version 1.15.2 to 1.15.3 |
1.15.2 | 5/20/2020 | No changes were made for Collection Citations during the transition from version 1.15.1 to 1.15.2 |
1.15.1 | 3/25/2020 | No changes were made for Collection Citations during the transition from version 1.15.0 to 1.15.1 |
1.15.0 | 2/26/2020 | No changes were made for Collection Citations during the transition from version 1.14.0 to 1.15.0 |
1.14.0 | 10/21/2019 | No changes were made for Collection Citations during the transition from version 1.13.0 to 1.14.0 |
1.13.0 | 04/11/2019 | No changes were made for Collection Citations during the transition from version 1.12.0 to 1.13.0 |
1.12.0 | 01/22/2019 | No changes were made for Collection Citations during the transition from version 1.11.0 to 1.12.0. |
1.11.0 | 11/28/2018 | No changes were made for Collection Citations during the transition from version 1.10.0 to 1.11.0. |
1.10.0 | 05/02/2018 | No changes were made for Collection Citations during the transition from version 1.9.0 to 1.10.0. |
1.9.0 |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 11/16/18 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space | |
1.1 | 9/15/2020 | The ARC priority matrix was updated to specify that if a Collection Citations is missing from the metadata, a yellow (medium priority) recommendation will be made to provide it. This recommendation is driven by the need to make data product citation information more easily accessible/visible, so that NASA data can be appropriately cited by external entities that re-distribute NASA data. |