Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Element Description

The Collection Citation element provides the information required to properly cite a collection 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 Citation 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"

          CollectionCitation/OnlineResource/Linkage: "https://disc.gsfc.nasa.gov/datacollection/MATUCPUDT_5.2.0.html"

          CollectionCitation/OnlineResource/Publisher"Goddard Earth Sciences Data and Information Services Center (GES DISC)"

          CollectionCitation/OnlineResource/ReleaseDate"2008-07-23T00:00:00.000Z"

          CollectionCitation/OnlineResource/DataPresentationForm"Digital Science Data"


Element Specification

Providing the Collection Citation element is optional. Only 1 Collection Citation may be provided (Cardinality: 0..1)

ModelElementTypeConstraintsRequired?CardinalityNotes
UMM-CCollectionCitation/CreatorsString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/EditorsString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/TitleString

1 - 1030 characters

No0..1
UMM-CCollectionCitation/SeriesNameString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/ReleaseDatedate-time
N/ANo0..1Dates must comply with the ISO 8601 Standard.
UMM-CCollectionCitation/ReleasePlaceString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/PublisherString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/VersionString

1 - 80 characters

No0..1
UMM-CCollectionCitation/IssueIdentificationString

1 - 80 characters

No0..1
UMM-CCollectionCitation/DataPresentationFormString

1 - 80 characters

No0..1
UMM-CCollectionCitation/OnlineResource/LinkageString

1 - 1024 characters

Yes, if applicable1Providing a Linkage is optional, however, none of the OnlineResource sub-elements (see below) may be provided without a Linkage.
UMM-CCollectionCitation/OnlineResource/ProtocolString

1 - 80 characters

No0..1
UMM-CCollectionCitation/OnlineResource/ApplicationProfileString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/OnlineResource/NameString

1 - 80 characters

No0..1
UMM-CCollectionCitation/OnlineResource/DescriptionString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/OnlineResource/FunctionString

1 - 1024 characters

No0..1
UMM-CCollectionCitation/OnlineResource/MimeTypeStringKMS controlledNo0..1
UMM-CCollectionCitation/OtherCitationDetailsString

1 - 4000 characters

No0..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).

Lucidchart
rich-viewerfalse
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-51df84
width1102
pages-to-display
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details.


Expand
titleGCMD Metadata QA/QC
  • Manual Review
    • Identify errors, discrepancies or omissions.
    • Proof all content for conciseness and readability.
  • Automated Review
    • Checks that Dataset_Release_Date is properly formatted. 
    • Checks that URLs are properly formatted and operational. 
    • Checks that field lengths do not exceed maximum characters allowed. 
    • Checks that Persistent_Identifier/Type keyword is valid.
Expand
titleCMR Validation
  • Automated Review 
    • Checks that field lengths do not exceed maximum characters allowed.
    • Checks that Mime Type keyword is valid.
Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

This element is categorized as highest priority when:

  • The information provided is for a resource other than the dataset.
  • Information provided in any of the Collection Citation sub-elements is incorrect for the dataset.
  • The Collection Citation linkage is a broken URL.
  • The incorrect DOI is provided for the dataset.

This element is categorized as medium priority when:

  • No Collection Citation is provided in the metadata.
  • A recommendation is made to add an important sub-element to the Collection Citation.

This element is categorized as low priority when:

  • A recommendation is made to update the Collection Citation linkage from http to https.
  • The Publication Reference linkage description contains grammatical errors.

The element is provided and follows all applicable criteria specified in the best practices section above.

ARC Automated Rules

  • If novalue is provided, return is "np."
  • Otherwise, return is "OK."

Dialect Mappings

Expand
titleDIF 9

DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018)

Expand
titleDIF 10

DIF 10

Providing the Dataset_Citation element is optional (Cardinality: 0..*)

UMM-C ElementDIF 10 PathTypeConstraintsRequired in DIF 10?CardinalityNotes
CollectionCitation/CreatorsDataset_Citation/Dataset_CreatorString
No0..1
CollectionCitation/EditorsDataset_Citation/Dataset_EditorString
No0..1
CollectionCitation/TitleDataset_Citation/Dataset_TitleString
No0..1
CollectionCitation/SeriesNameDataset_Citation/Dataset_Series_NameString
No0..1
CollectionCitation/ReleaseDateDataset_Citation/Dataset_Release_DateDate
No0..1Date fields should be in date (YYYY-MM-DD) format.
CollectionCitation/ReleasePlaceDataset_Citation/Dataset_Release_PlaceString
No0..1
CollectionCitation/PublisherDataset_Citation/Dataset_PublisherString
No0..1
CollectionCitation/VersionDataset_Citation/VersionString
No0..1
CollectionCitation/IssueIdentificationDataset_Citation/Issue_IdentificationString
No0..1
CollectionCitation/DataPresentationFormDataset_Citation/Data_Presentation_FormString
No0..1
CollectionCitation/OtherCitationDetailsDataset_Citation/Other_Citation_DetailsString
No0..1
DOIDataset_Citation/Persistent_Identifier

See DOI for details

See DOI for details

No0..1

There is no equivalent field in the UMM for Persistent_Identifier within the Dataset_Citation.

Note: there are several sub-elements that comprise Persistent_Identifier. Refer to the DOI wiki page for full details on Persistent_Identifier.

CollectionCitation/OnlineResource/LinkageDataset_Citation/Online_ResourceString
No0..1A URL may be provided here. For Dataset_Citation, this should be a link to the dataset landing page.


Example Mapping

Section
Column
width50%

DIF 10

No Format
<Dataset_Citation>
  <Dataset_Creator>Seto, K., B. Guneralp, and L.R. Hutyra</Dataset_Creator>
  <Dataset_Title>Global Grid of Probabilities of Urban Expansion to 2030</Dataset_Title>
  <Dataset_Release_Date>2015-12-31</Dataset_Release_Date>
  <Dataset_Release_Place>Palisades, NY</Dataset_Release_Place>
  <Dataset_Publisher>NASA Socioeconomic Data and Applications Center (SEDAC)</Dataset_Publisher>
  <Version>1.0</Version>
  <Persistent_Identifier>
    <Type>DOI</Type>
    <Identifier>10.7927/H4Z899CG</Identifier>
  </Persistent_Identifier>
  <Online_Resource>https://doi.org/10.7927/H4Z899CG</Online_Resource>
</Dataset_Citation>
Column
width50%

UMM

No Format
CollectionCitations: [
    {
        Creator: "Seto, K., B. Guneralp, and L.R. Hutyra",
        ReleasePlace: "Palisades, NY",
        Title: "Global Grid of Probabilities of Urban Expansion to 2030",
        OnlineResource: {
          Linkage: "https://doi.org/10.7927/H4Z899CG"
        },
        Publisher: "NASA Socioeconomic Data and Applications Center (SEDAC)",
        ReleaseDate: "2015-12-31",
        Version: "1.0"
     }
],



Expand
titleECHO 10

ECHO 10

Providing the Citation For External Publication element is optional (Cardinality: 0..*)

UMM-C ElementECHO 10 PathTypeConstraintsRequired in ECHO10?CardinalityNote
CollectionCitation/OtherCitationDetailsCitationForExternalPublicationString

1 - 4000 characters

No0..1

In ECHO10 the collection citation is currently a single block of free text. As a result, the entire citation will map to the UMM field "CollectionCitations/OtherCitationDetails"

The citation should include: the originator (the name of an organization or individual that developed the dataset), where the data were published, editor(s) names followed by (ed.), the publication date (the date of publication or release of the dataset), the dataset title, and the DOI if applicable.


Example Mapping

Section
Column
width50%

ECHO 10

No Format
<CitationForExternalPublication>Bourgeau-Chavez, L.L., S. Endres, L. Jenkins, M. Battaglia, E. Serocki, and M. Billmire. 2017. ABoVE: Burn Severity, Fire Progression, and Field Data, NWT, Canada, 2015-2016. ORNL DAAC, Oak Ridge, Tennessee, USA. https://doi.org/10.3334/ORNLDAAC/1548</CitationForExternalPublication>  
Column
width50%

UMM

No Format
CollectionCitations: [
    {
        OtherCitationDetails: "Bourgeau-Chavez, L.L., S. Endres, L. Jenkins, M. Battaglia, E. Serocki, and M. Billmire. 2017. ABoVE: Burn Severity, Fire Progression, and Field Data, NWT, Canada, 2015-2016. ORNL DAAC, Oak Ridge, Tennessee, USA. https://doi.org/10.3334/ORNLDAAC/1548"
     }
],
Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

Providing the Collection Citation element is required (Cardinality: 1)

UMM-C ElementISO PathTypeNotes
CollectionCitation/Creators

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
WRITE and READ - must NOT have positionName with the value of editor.)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=author

String


CollectionCitation/Editors
(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
WRITE and READ - must have positionName and the value must be editor where the role is author)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or 
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString = editor
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=author
String
CollectionCitation/Title
[=>/gmd:title/gco:CharacterStringString
CollectionCitation/SeriesName
[=>/gmd:series/gmd:CI_Series/gmd:name/gco:CharacterStringString
CollectionCitation/ReleaseDate
[=>/gmd:editionDate/gco:DateTimeString
CollectionCitation/ReleasePlace
(READ - concatenate all elements of CI_Address
WRITE - if parsable parse into individual components if not then put all into deliveryPoint
READ and WRITE: must contain positionName and the value must be release place and the role must be publisher)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty>/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address [==>
[==>/gmd:deliveryPoint
[==>/gmd:city/gco:CharacterString (0..1)
[==>/gmd:administrativeArea/gco:CharacterString (0..1)
[==>/gmd:postalCode/gco:CharacterString (0..1)
[==>/gmd:country/gco:CharacterString (0..1)
[==>/gmd:electronicMailAddress/gco:CharacterString (0..*)
with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString = release place
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=publisher
String
CollectionCitation/Publisher
(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
READ and WRITE: must NOT contain positionName with value of release place)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=publisher
String
CollectionCitation/Version
[=>/gmd:edition/gco:CharacterStringString
CollectionCitation/IssueIdentification
[=>/gmd:series/gmd:CI_Series/gmd:issueIdentification/gco:CharacterStringString
ICollectionCitation/DataPresentationForm[=>/gmd:presentationForm/gmd:CI_PresentationFormCode codeList="" codeListValue="" =String
CollectionCitation/OtherCitationDetails
[=>/gmd:otherCitationDetails/gco:CharacterString "Other Details: ….."StringProvide the prefix "Other Details: "
CollectionCitation/OnlineResource
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource [===>
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="resourceProvider"  = resourceProvider
String
CollectionCitation/OnlineResource/Linkage
[===>/gmd:linkage/gmd:URLString
CollectionCitation/OnlineResource/Protoco
[===>/gmd:protocol/gco:CharacterStringString
CollectionCitation/OnlineResource/ApplicationProfile
[===>/gmd:applicationProfile/gco:CharacterStringString
CollectionCitation/OnlineResource/Name
[===>/gmd:name/gco:CharacterStringString
CollectionCitation/OnlineResource/Description
[===>/gmd:description/gco:CharacterStringString
CollectionCitation/OnlineResource/Function
[===>/gmd:function/gmd:CI_OnLineFunctionCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode" codeListValue="information" = informationString


Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
<gmi:MI_Metadata>
...
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:citation>
        <gmd:CI_Citation>
          <gmd:title>
            <gco:CharacterString>Global Grid of Probabilities of Urban Expansion to 2030</gco:CharacterString>
          </gmd:title>
          <gmd:edition>
            <gco:CharacterString>1.0</gco:CharacterString>
          </gmd:edition>
          <gmd:editionDate>
            <gco:DateTime>2015-12-31T00:00:00.000Z</gco:DateTime>
          </gmd:editionDate>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:individualName>
                <gco:CharacterString>Seto, K., B. Guneralp, and L.R. Hutyra</gco:CharacterString>
              </gmd:individualName>
            </md:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:individualName>
                <gco:CharacterString>NASA Socioeconomic Data and Applications Center (SEDAC)</gco:CharacterString>
              </gmd:individualName>
              <gmd:role>
                <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="publisher"=publisher</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:positionName>
                <gco:CharacterString>release place</gco:CharacterString>
              </gmd:positionName>
              <gmd:contactInfo>
                <gmd:CI_Contact>
                  <gmd:address>
                    <gmd:CI_Address>
                      <gmd:deliveryPoint>
                        <gco:CharacterString>Palisades, NY</gco:CharacterString>
                      </gmd:deliveryPoint>
                    </gmd:CI_Address>
                  </gmd:address>
                </gmd:CI_Contact>
              </gmd:contactInfo>
              <gmd:role>
               <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="publisher"=publisher</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:contactInfo>
                <gmd:CI_Contact>
                  <gmd:onlineResource>
                    <gmd:CI_OnlineResource>
                      <gmd:linkage>
                        <gmd:URL>https://doi.org/10.7927/H4Z899CG</gmd:URL>
                      </gmd:linkage>
                    </gmd:CI_OnlineResource>
                  </gmd:onlineResource>
                </gmd:CI_Contact>
              </gmd:contactInfo>
              <gmd:role>
                <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="resourceProvider"=resourceProvider</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
        </gmd:CI_Citation>
      </gmd:citation>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
...
</gmi:MI_Metadata>
Column
width50%

UMM

No Format
CollectionCitations: [
    {
        Creator: "Seto, K., B. Guneralp, and L.R. Hutyra",
        ReleasePlace: "Palisades, NY",
        Title: "Global Grid of Probabilities of Urban Expansion to 2030",
        OnlineResource: {
          Linkage: "https://doi.org/10.7927/H4Z899CG"
        },
        Publisher: "NASA Socioeconomic Data and Applications Center (SEDAC)",
        ReleaseDate: "2015-12-31",
        Version: "1.0"
     }
],
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

Providing the Collection Citation element is required (Cardinality: 1)

UMM-C ElementISO PathType
CollectionCitation/Creators

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
WRITE and READ - must NOT have positionName with the value of editor.)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=author

String

CollectionCitation/Editors

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
WRITE and READ - must have positionName and the value must be editor where the role is author)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or 
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString = editor
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=author

String
CollectionCitation/Title
[=>/gmd:title/gco:CharacterStringString
CollectionCitation/SeriesName
[=>/gmd:series/gmd:CI_Series/gmd:name/gco:CharacterStringString
CollectionCitation/ReleaseDate
[=>/gmd:editionDate/gco:DateTimeString
CollectionCitation/ReleasePlace

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation [=>

(READ - concatenate all elements of CI_Address
WRITE - if parsable parse into individual components if not then put all into deliveryPoint
READ and WRITE: must contain positionName and the value must be release place and the role must be publisher)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty>/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address [==>
[==>/gmd:deliveryPoint
[==>/gmd:city/gco:CharacterString (0..1)
[==>/gmd:administrativeArea/gco:CharacterString (0..1)
[==>/gmd:postalCode/gco:CharacterString (0..1)
[==>/gmd:country/gco:CharacterString (0..1)
[==>/gmd:electronicMailAddress/gco:CharacterString (0..*)
with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString = release place
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=publisher

String
CollectionCitation/Publisher

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
READ and WRITE: must NOT contain positionName with value of release place)
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString and/or
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString with
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/CI_RoleCode=publisher

String
CollectionCitation/Version
[=>/gmd:edition/gco:CharacterStringString
CollectionCitation/IssueIdentification
[=>/gmd:series/gmd:CI_Series/gmd:issueIdentification/gco:CharacterStringString
CollectionCitation/DataPresentationForm
[=>/gmd:presentationForm/gmd:CI_PresentationFormCode codeList="" codeListValue="" =String
CollectionCitation/OtherCitationDetails
[=>/gmd:otherCitationDetails/gco:CharacterStringString
CollectionCitation/OnlineResource
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:onlineResource/gmd:CI_OnlineResource [===>
and
[=>/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="resourceProvider"  = resourceProvider
String
CollectionCitation/OnlineResource/Linkage
[===>/gmd:linkage/gmd:URLString
CollectionCitation/OnlineResource/Protocol
[===>/gmd:protocol/gco:CharacterStringString
CollectionCitation/OnlineResource/ApplicationProfile
[===>/gmd:applicationProfile/gco:CharacterStringString
CollectionCitation/OnlineResource/Name
[===>/gmd:name/gco:CharacterStringString
CollectionCitation/OnlineResource/Description
[===>/gmd:description/gco:CharacterStringString
CollectionCitation/OnlineResource/Function
[===>/gmd:function/gmd:CI_OnLineFunctionCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_OnLineFunctionCode" codeListValue="information" = informationString


Example Mapping

Section
Column
width50%

ISO 19115-2 SMAP

No Format
<gmd:DS_Series>
<gmd:seriesMetadata>
<gmi:MI_Metadata>
...
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      <gmd:citation>
        <gmd:CI_Citation>
          <gmd:title>
            <gco:CharacterString>Global Grid of Probabilities of Urban Expansion to 2030</gco:CharacterString>
          </gmd:title>
          <gmd:edition>
            <gco:CharacterString>1.0</gco:CharacterString>
          </gmd:edition>
          <gmd:editionDate>
            <gco:DateTime>2015-12-31T00:00:00.000Z</gco:DateTime>
          </gmd:editionDate>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:individualName>
                <gco:CharacterString>Seto, K., B. Guneralp, and L.R. Hutyra</gco:CharacterString>
              </gmd:individualName>
            </md:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:individualName>
                <gco:CharacterString>NASA Socioeconomic Data and Applications Center (SEDAC)</gco:CharacterString>
              </gmd:individualName>
              <gmd:role>
                <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="publisher"=publisher</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:positionName>
                <gco:CharacterString>release place</gco:CharacterString>
              </gmd:positionName>
              <gmd:contactInfo>
                <gmd:CI_Contact>
                  <gmd:address>
                    <gmd:CI_Address>
                      <gmd:deliveryPoint>
                        <gco:CharacterString>Palisades, NY</gco:CharacterString>
                      </gmd:deliveryPoint>
                    </gmd:CI_Address>
                  </gmd:address>
                </gmd:CI_Contact>
              </gmd:contactInfo>
              <gmd:role>
               <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="publisher"=publisher</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
          <gmd:citedResponsibleParty>
            <gmd:CI_ResponsibleParty>
              <gmd:contactInfo>
                <gmd:CI_Contact>
                  <gmd:onlineResource>
                    <gmd:CI_OnlineResource>
                      <gmd:linkage>
                        <gmd:URL>https://doi.org/10.7927/H4Z899CG</gmd:URL>
                      </gmd:linkage>
                    </gmd:CI_OnlineResource>
                  </gmd:onlineResource>
                </gmd:CI_Contact>
              </gmd:contactInfo>
              <gmd:role>
                <gmd:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="resourceProvider"=resourceProvider</gmd:CI_RoleCode>
              </gmd:role>
            </gmd:CI_ResponsibleParty>
          </gmd:citedResponsibleParty>
        </gmd:CI_Citation>
      </gmd:citation>
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
...
</gmi:MI_Metadata>
</gmd:seriesMetadata>
</gmd:DS_Series>
Column
width50%

UMM

No Format
CollectionCitations: [
    {
        Creator: "Seto, K., B. Guneralp, and L.R. Hutyra",
        ReleasePlace: "Palisades, NY",
        Title: "Global Grid of Probabilities of Urban Expansion to 2030",
        OnlineResource: {
          Linkage: "https://doi.org/10.7927/H4Z899CG"
        },
        Publisher: "NASA Socioeconomic Data and Applications Center (SEDAC)",
        ReleaseDate: "2015-12-31",
        Version: "1.0"
     }
],

UMM Migration

UMM Version 1.9.0Translation DirectionUMM Version 1.10.0



Excerpt
hiddentrue

Future Mappings

Expand
titleISO 19115-1

ISO 19115-1

Providing the Collection Citation element is required (Cardinality: 1)

UMM-C ElementISO PathType
CollectionCitation/Creators

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.)
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/
cit:CI_Individual/cit:name/gco:CharacterString and/or [=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/cit:CI_Organization/cit:name/gco:CharacterString
with
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:role/cit:CI_RoleCode=author

String

CollectionCitation/Editor

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation [=>

(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.
WRITE and READ - must have positionName and the value must be editor where the role is author)
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/
cit:CI_Individual/cit:name/gco:CharacterString and/or [=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/cit:CI_Organization/cit:name/gco:CharacterString
with
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:role/cit:CI_RoleCode=author

String
CollectionCitation/Title[=>/cit:title/gco:CharacterStringString
CollectionCitation/SeriesName[=>/cit:series/cit:CI_Series/cit:name/gco:CharacterStringString
CollectionCitation/ReleaseDate[=>/cit:editionDate/gco:DateTimeString
CollectionCitation/ReleasePlace(READ - concatenate all elements
WRITE - if parsable parse into individual components if not then put all into deliveryPoint)
[=>/cit:contactInfo/cit:CI_Contact/cit:address/cit:CI_Address [==>
[==>/cit:deliveryPoint
[==>/cit:city/gco:CharacterString (0..1)
[==>/cit:administrativeArea/gco:CharacterString (0..1)
[==>./cit:postalCode/gco:CharacterString (0..1)
[==>/cit:country/gco:CharacterString (0..1)
[==>/cit:electronicMailAddress/gco:CharacterString (0..*)
String
CollectionCitation/Publisher(READ from both individualName and organistionName and concatenate - WRITE to individual name only since we don't know how to parse the data.)
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/
cit:CI_Individual/cit:name/gco:CharacterString and/or [=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:party/cit:CI_Organization/cit:name/gco:CharacterString
with
[=>/cit:citedResponsibleParty/cit:CI_Responsibility/cit:role/cit:CI_RoleCode=publisher
String
CollectionCitation/Version[=>/cit:edition/gco:CharacterStringString
CollectionCitation/IssueIdentification[=>/cit:series/cit:CI_Series/cit:issueIdentification/gco:CharacterStringString
CollectionCitation/DataPresentationForm[=>/cit:presentationForm/cit:CI_PresentationFormCode codeList="" codeListValue="" =String
CollectionCitation/OtherCitationDetails[=>/cit:otherCitationDetails/gco:CharacterStringString
CollectionCitation/OnlineResource[=>/cit:onlineResource/cit:CI_OnlineResource [===>String
CollectionCitation/OnlineResource/Linkage[===>/cit:linkage/gco:CharacterStringString
CollectionCitation/OnlineResource/Protocol[===>/cit:protocol/gco:CharacterStringString
CollectionCitation/OnlineResource/ApplicationProfile[===>/cit:applicationProfile/gco:CharacterStringString
CollectionCitation/OnlineResource/Name[===>/cit:name/gco:CharacterStringString
CollectionCitation/OnlineResource/Description[===>/cit:description/gco:CharacterStringString
CollectionCitation/OnlineResource/Functio[===>/cit:function/cit:CI_OnLineFunctionCode codeList="codeListLocation#CI_OnLineFunctionCode" codeListValue="information" =information String


Example Mapping

Section
Column
width50%

ISO 19115-1

No Format
<mdb:MD_Metadata>
...
  <mdb:identificationInfo>
    </mri:MD_DataIdentification>
      <mri:citation>
        <cit:CI_Citation>
          <cit:title>
            <gco:CharacterString>Global Grid of Probabilities of Urban Expansion to 2030</gco:CharacterString>
          </cit:title>
          <cit:edition>
            <gco:CharacterString>1.0</gco:CharacterString>
          </cit:edition>
          <cit:editionDate>
            <gco:DateTime>2015-12-31T00:00:00.000Z</gco:DateTime>
          </cit:editionDate>
          <cit:citedResponsibleParty>
            <cit:CI_ResponsibleParty>
              <cit:individualName>
                <gco:CharacterString>Seto, K., B. Guneralp, and L.R. Hutyra</gco:CharacterString>
              </cit:individualName>
            </cit:CI_ResponsibleParty>
          </cit:citedResponsibleParty>
          <cit:citedResponsibleParty>
            <cit:CI_ResponsibleParty>
              <cit:individualName>
                <gco:CharacterString>NASA Socioeconomic Data and Applications Center (SEDAC)</gco:CharacterString>
              </cit:individualName>
              <cit:role>
                <cit:CI_RoleCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#CI_RoleCode" codeListValue="author"=author</gmd:CI_RoleCode>
              </cit:role>
            </cit:CI_ResponsibleParty>
          </cit:citedResponsibleParty>
          <cit:contactInfo>
            <cit:CI_Contact>
              <cit:address>
                <cit:CI_Address>
                  <cit:deliveryPoint>
                    <gco:CharacterString>Palisades, NY</gco:CharacterString>
                  </cit:deliveryPoint>
                </cit:CI_Address>
              </cit:address>
            </cit:CI_Contact>
          </cit:contactInfo>
          <cit:onlineResource>
            <cit:CI_OnlineResource>
              <cit:linkage>
                <gco:CharacterString>https://doi.org/10.7927/H4Z899CG</gco:CharacterString>
              </cit:linkage>
            </cit:CI_OnlineResource>
          </cit:onlineResource>
        </cit:CI_Citation>
      </mri:citation>
    </mri:MD_DataIdentification>
  </mdb:identificationInfo>
...
</mdb:MD_Metadata>
Column
width50%

UMM

No Format
CollectionCitations: [
    {
        Creator: "Seto, K., B. Guneralp, and L.R. Hutyra",
        ReleasePlace: "Palisades, NY",
        Title: "Global Grid of Probabilities of Urban Expansion to 2030",
        OnlineResource: {
          Linkage: "https://doi.org/10.7927/H4Z899CG"
        },
        Publisher: "NASA Socioeconomic Data and Applications Center (SEDAC)",
        ReleaseDate: "2015-12-31",
        Version: "1.0"
     }
],

History

UMM Versioning

VersionDateWhat Changed
1.15.37/1/2020No changes were made for Collection Citation during the transition from version 1.15.2 to 1.15.3
1.15.25/20/2020No changes were made for Collection Citation during the transition from version 1.15.1 to 1.15.2
1.15.13/25/2020No changes were made for Collection Citation during the transition from version 1.15.0 to 1.15.1
1.15.02/26/2020No changes were made for Collection Citation during the transition from version 1.14.0 to 1.15.0
1.14.010/21/2019No changes were made for Collection Citation during the transition from version 1.13.0 to 1.14.0
1.13.0

04/11/2019

No changes were made for Collection Citation during the transition from version 1.12.0 to 1.13.0
1.12.001/22/2019No changes were made for Collection Citation during the transition from version 1.11.0 to 1.12.0.
1.11.011/28/2018No changes were made for Collection Citation during the transition from version 1.10.0 to 1.11.0.
1.10.005/02/2018

No changes were made for Collection Citation during the transition from version 1.9.0 to 1.10.0.

1.9.0

ARC Documentation

VersionDateWhat ChangedAuthor
1.011/16/18Recommendations/priority matrix transferred from internal ARC documentation to wiki space
1.19/15/2020The ARC priority matrix was updated to specify that if a Collection Citation 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.