Page History

Table of Contents

style	circle

Element Description

Note: This page is a draft/ work in progress

The Location Keywords element contains keywords that characterize the study area/region where data was collected from. This allows users to narrow their searches to areas that suit their geographic interest. The Location Keywords are chosen from a controlled keyword hierarchy maintained in the Keyword Management System (KMS). A list of valid Location Keywords can be found here: https://gcmdservicesgcmd.gsfcearthdata.nasa.gov/statickms/kmsconcepts/locationsconcept_scheme/locations.csv? ?format=csv.

Best Practices

Location keywords specify Keywords identify areas where data was collectedcollection occurred and are provided in a hierarchical structure. The keywords can be chosen to classify broad study areas/regions or very specific places. However, it is suggested that location keywords are as specific as possible to aid in data discovery. At bare minimum, a location keyword/category is required in the hierarchy, which provides a general area of data collectionProviding a Location Keyword is optional. If provided, the top level of the Location Keyword hierarchy must be provided (at a minimum). If a specific location keyword is not already included in the KMS, a request to have it added can be made through the through the GCMD Keywords Community Forum.

Examples:

LocationKeywords/Category: "CONTINENT"

LocationKeywords/Topic: "NORTH AMERICA"

LocationKeywords/Subregion1: "UNITED STATES"

LocationKeywords/Subregion2: "ALABAMA"

LocationKeywords/

Subregion3: "HUNTSVILLE"LocationKeywords/

DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"

LocationKeywords/Category: "CONTINENT"

LocationKeywords/Topic: "NORTH AMERICA"

LocationKeywords/Subregion1: "CANADA"

LocationKeywords/Subregion2: "ONTARIO"

LocationKeywords/Category: "GEOGRAPHIC REGION"

LocationKeywords/Topic: "TROPICS"

Element Specification

Location Keywords are required. An unlimited amount of Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 10..*).

Model	Element	Type	Usable Valid Values	Constraints	Required?	Cardinality	Notes
UMM-C	LocationKeywords/Category	String	Location Category Keywords	KMS controlled	Yes, if applicable	1

UMM-CLocationKeywords/TypeStringLocation Type KeywordsKMS controlled

If a Location Keyword is included in the metadata (it's optional), then a Category keyword must be provided at a minimum.
UMM-C	LocationKeywords/Type	String	Location Type Keywords	KMS controlled	No	0..1
UMM-C	LocationKeywords/Subregion1	String	Location

Subregion_1

Subregion1 Keywords	KMS controlled	No	0..1
UMM-C	LocationKeywords/Subregion2	String	Location

Subregion_2

Subregion2 Keywords	KMS controlled	No	0..1
UMM-C	LocationKeywords/Subregion3	String

Science Subregion_3

Location Subregion3 Keywords

KMS controlled

No

0..1

UMM-C

LocationKeywords/DetailedLocation

String

n/a

1 - 80 characters

(Uncontrolled/Free-Text)

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

Lucidchart

rich-viewer	true

autofit	true
name	Copy of Wiki Page Metadata Evaluation Workflow-1939-12404ac7
width	1102
id	98e5dc28-3252-4209-953f-66f1378e1cf4
align	Left
height	299

Please see the expandable sections below for flowchart details.

Expand

title	GCMD Metadata QA/QC

Manual Review
- Identify errors, discrepancies, or omissions.
- Verify that all pertinent keywords have been applied.
- Verify that existing facets and other controlled keyword values are consistent and suitable for the data.
Automated Review
- Check that the field has been populated.
- Check that the field is populated with a valid value from KMS.
- Check that the field value is not a duplicate.
- Check that the 'Detailed_Variable' field length is not greater than 80 characters.

Expand

title	ARC Metadata QA/QC	CMR Validation

If this element is used, every location keyword must have at least the category sub-element populated.
All location keyword sub-elements except for DetailedLocation must be valid according to the keyword management system.

Expand

title	ARC Metadata QA/QC

ARC Priority Matrix

Priority Categorization	Justification
Red = High Priority Finding

ARC Priority Matrix

Justification

Priority Categorization

This element is categorized as highest priority when:

The element is not included at all.
The element is included but is empty.
Location Keyword does not align with the KMS.
- The Location Keyword does not exist in the
The location keyword does not align with the KMS.
- The location keyword does not exist in KMS.
- A keyword(s) is missing from the hierarchy.
- A keyword(s) is placed in the incorrect position of the hierarchy (e.g. a Subregion 2 keyword is placed in the Subregion 1 field).
The location keyword Location Keyword is not appropriate for the dataset.

Yellow = Medium Priority Finding

This element is categorized as medium priority when:

A recommendation is made to add a relevant location keyword to the metadata.A recommendation is made to add to an existing keyword Location Keyword in the metadata (i.e. i.e. to extend a keyword hierarchy down to a more detailed keyword).

Not Applicable

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

ARC Automated Checks

Category

If no value is provided, return is: "This is a required field. Recommend providing at least one science keyword hierarchy relevant to this data set. This field should contain the Category keyword as specified in the hierarchy (EARTH SCIENCE). Science keywords are GCMD controlled and should be chosen from the following list: https://gcmdservices.gsfc.nasa.gov/static/kms/sciencekeywords/sciencekeywords.csv?ed_wiki_keywords_page"
If the provided value is in the incorrect position of the hierarchy, return is: "<provided value> is in the incorrect position of the project keyword hierarchy."
If the provided value does not conform to GCMD, return is: "<provided value> does not conform to GCMD."

Topic

If no value is provided, return is: "This is a required field. Recommend providing at least one science keyword hierarchy relevant to this data set. This field should contain the Topic keyword as specified in the hierarchy. Science keywords are GCMD controlled and should be chosen from the following list: https://gcmdservices.gsfc.nasa.gov/static/kms/sciencekeywords/sciencekeywords.csv?ed_wiki_keywords_page"
If the provided value is in the incorrect position of the hierarchy, return is: "<provided value> is in the incorrect position of the project keyword hierarchy."
If the provided value does not conform to GCMD, return is: "<provided value> does not conform to GCMD."

Term

If no value is provided, return is: "This is a required field. Recommend providing at least one science keyword hierarchy relevant to this data set. This field should contain the Term keyword as specified in the hierarchy. Science keywords are GCMD controlled and should be chosen from the following list: https://gcmdservices.gsfc.nasa.gov/static/kms/sciencekeywords/sciencekeywords.csv?ed_wiki_keywords_page"
If the provided value is in the incorrect position of the hierarchy, return is: "<provided value> is in the incorrect position of the project keyword hierarchy."
If the provided value does not conform to GCMD, return is: "<provided value> does not conform to GCMD."

Variable Level 1 - Variable Level 3

If no value is provided, return is "np"
If the provided value is in the incorrect position of the hierarchy, return is: "<provided value> is in the incorrect position of the project keyword hierarchy."
If the provided value does not conform to GCMD, return is: "<provided value> does not conform to GCMD."

Detailed Variable
If no value isprovided, return is "np"

If a value is provided, return is "OK"

Expand

title	CMR Validation

<>

Dialect Mappings

Expand

title	DIF 9

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

Blue = Low Priority Finding

This element is categorized as low priority when:

A recommendation is made to add a relevant Location Keyword to the metadata.
A recommendation is made to remove a stand-alone instance of a keyword (i.e. "CONTINENT" or "GEOGRAPHIC LOCATION") when a more detailed hierarchy is also provided.
A recommendation is made to remove duplicate keywords.

Green = No Findings/Issues

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

ARC Automated Checks

ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information.

Dialect Mappings

Expand

title	DIF 9

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

Expand

title	DIF 10

DIF 10

Providing a Location is optional. Multiple Locations may be provided, if necessary (Cardinality: 0..*).

UMM-C Element	DIF 10 Path	Type	Usable Valid Values	Constraints	Required in DIF 10?	Cardinality	Notes
LocationKeywords/Category	Location/Location_Category	String	Location Category Keywords	KMS controlled	Yes, if applicable	1	If a Location is included in the metadata (it's optional), then a Location_Category must be provided at a minimum.
LocationKeywords/Type	Location/Location_Type	String	Location Type Keywords	KMS controlled	No	0..1
LocationKeywords/Subregion1	Location/Location_Subregion1	String	Location Subregion1 Keywords	KMS controlled	No	0..1
LocationKeywords/Subregion2	Location/Location_Subregion2	String	Location Subregion2 Keywords	KMS controlled	No	0..1
LocationKeywords/Subregion3	Location/Location_Subregion3	String	Location Subregion3 Keywords	KMS controlled	No	0..1
LocationKeywords/DetailedLocation	Location/Detailed_Location	String	n/a	1 - 80 characters (Uncontrolled/Free-Text)	No	0..1

Example Mapping

Section

Column

width	50%

DIF 10

No Format

<Location>
  <Location_Category>CONTINENT</Location_Category>
  <Location_Type>NORTH AMERICA</Location_Type>
  <Location_Subregion1>UNITED STATES</Location_Subregion1>
  <Location_Subregion2>ALBAMA</Location_Subregion2>
  <Detailed_Location>THE UNIVERSITY OF ALABAMA IN HUNTSVILLE</Detailed_Location>
</Location>
<Location>
  <Location_Category>CONTINENT</Location_Category>
  <Location_Type>NORTH AMERICA</Location_Type>
  <Location_Subregion1>CANADA</Location_Subregion1>
  <Location_Subregion2>ONTARIO</Location_Subregion2>
</Location>

Column

width	50%

UMM

No Format

LocationKeywords: [
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "UNITED STATES",
    Subregion2: "ALABAMA",
    DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
  },
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "CANADA",
    Subregion2: "ONTARIO"
  }
],

Expand

title	ECHO 10

ECHO 10

Providing a Spatial Keyword is optional. Multiple Spatial Keywords may be provided, if necessary (Cardinality: 0..*).

UMM-C Element

ECHO 10 Path

Type

Usable Valid Values

Constraints

Required in ECHO10?

Cardinality

Notes

LocationKeywords/Category

LocationKeywords/Type

LocationKeywords/Subregion1

LocationKeywords/Subregion2

LocationKeywords/Subregion3

LocationKeywords/DetailedLocation

/Collection/SpatialKeywords/Keyword

String

Any GCMD Location Keyword

KMS controlled

No

0..*

ECHO 10 only has 1 field for spatial keywords. Therefore, a keyword from any position in the GCMD location keyword hierarchy can be provided in this field. If a value is provided that is not in the keyword list, then it will map to Location Category Keyword "OTHER" followed by a Location Type Keyword of the unique value in the UMM (see mapping example below, where the spatial keyword 'THE UNIVERSITY OF ALABAMA IN HUNTSVILLE' is not included in the GCMD location keyword list.)

Example Mapping

Section

Column

width	50%

ECHO 10

No Format
<SpatialKeywords> <Keyword>ONTARIO</Keyword> <Keyword>THE UNIVERSITY OF ALABAMA IN HUNTSVILLE</Keyword> </SpatialKeywords>

Column

width	50%

UMM

No Format
LocationKeywords: { Category: "CONTINENT", Type: "NORTH AMERICA", Subregion1: "CANADA", Subregion2: "ONTARIO" } { Category: "OTHER", Type: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE" }, ],

Expand

title	ISO 19115-2 MENDS

ISO 19115-2 MENDS

Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).

UMM-C Element

ISO 19115-2 MENDS Path

Type

Notes

LocationKeywords/Category

LocationKeywords/Type

LocationKeywords/Subregion1

LocationKeywords/Subregion2

LocationKeywords/Subregion3

LocationKeywords/DetailedLocation

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/ gmd:keyword/gco:CharacterString (list each value of the keyword hierarchy delimited by > )

String

KMS controlled. Valid Location Keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/locations?format=csv

This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in-between. The CMR will not translate the NONE values as they are only used to place each keyword in its correct space in the hierarchy.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/ gmd:type/MD_KeywordTypeCode

codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="place"

Codelist

codeList=https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml #MD_KeywordTypeCode

Select the value "place" from the codelist. This codelist value does not directly map to a UMM element; choosing "place" indicates to CMR that the provided value should be mapped to 'Location Keywords'.

Example Mapping

Section

Column

width	50%

ISO 19115-2 MENDS

No Format

<gmi:MI_Metadata>
  ...
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      ...
      <gmd:descriptiveKeywords>
        <gmd:MD_Keywords>
          <gmd:keyword>
            <gco:CharacterString>CONTINENT&gt;NORTH AMERICA&gt;UNITED STATES&gt;ALABAMA&gt;NONE&gt;THE UNIVERSITY OF ALABAMA IN HUNTSVILLE</CharacterString>
          </gmd:keyword>
          <gmd:keyword>
            <gco:CharacterString>CONTINENT&gt;NORTH AMERICA&gt;CANADA&gt;ONTARIO</CharacterString>
          </gmd:keyword>
          <gmd:type>
            <gmd:MD_KeywordTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="place">place</gmd:MD_KeywordTypeCode>
          </gmd:type>
        </gmd:MD_Keywords> 
      </gmd:descriptiveKeywords>
      ...
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
  ...
</gmi:MI_Metadata>

Column

width	50%

UMM

No Format

LocationKeywords: [
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "UNITED STATES",
    Subregion2: "ALABAMA"
    DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
  },
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "CANADA",
    Subregion2: "ONTARIO"
  }
],

DIF 10

Science_Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)

Example Mapping

Expand

title	ISO 19115-2 SMAP

ISO 19115-2 SMAP

Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).

UMM-C Element

ISO 19115-2 SMAP Path

Type

Notes

LocationKeywords/Category

LocationKeywords/Type

LocationKeywords/Subregion1

LocationKeywords/Subregion2

LocationKeywords/Subregion3

LocationKeywords/DetailedLocation

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/ gmd:MD_Keywords/gmd:keyword/gco:CharacterString (list each value of the keyword hierarchy delimited by > )

String

KMS controlled. Valid Location Keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/locations?format=csv

This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in-between. The CMR will not translate the NONE values as they are only used to place each keyword in its correct space in the hierarchy.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/ gmd:MD_Keywords/gmd:type/MD_KeywordTypeCode

codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="place"

Codelist

codeList=https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml #MD_KeywordTypeCode

Select the value "place" from the codelist. This codelist value does not directly map to a UMM element; choosing "place" indicates to CMR that the provided value should be mapped to 'Location Keywords'.

Example Mapping

Section

Column

width	50%

ISO 19115-2 SMAP

No Format

<gmd:DS_Series>
  <gmd:seriesMetadata>
    <gmi:MI_Metadata>
      ...
      <gmd:identificationInfo>
        <gmd:MD_DataIdentification>
          ...
          <gmd:descriptiveKeywords>
            <gmd:MD_Keywords>
              <gmd:keyword>
                <gco:CharacterString>CONTINENT&gt;NORTH AMERICA&gt;UNITED STATES&gt;ALABAMA&gt;NONE&gt;THE UNIVERSITY OF ALABAMA IN HUNTSVILLE</CharacterString>
              </gmd:keyword>
              <gmd:keyword>
                <gco:CharacterString>CONTINENT&gt;NORTH AMERICA&gt;CANADA&gt;ONTARIO</CharacterString>
              </gmd:keyword>
              <gmd:type>
                <gmd:MD_KeywordTypeCode codeList="

Expand

title	DIF 10

Specification

Path

Type

Constraints

Required in DIF 10?

Cardinality

Notes

DIF 10

/DIF/Location_Keywords/Category

String

KMS controlled

Yes

1

DIF 10

/DIF/Location_Keywords/Type

String

KMS controlled

No

0..1

DIF 10

/DIF/Science_Keywords/Subregion_1

String

KMS controlled

No

0..1

DIF 10

/DIF/Science_Keywords/Subregion_2

String

KMS controlled

No

0..1

DIF 10

/DIF/Science_Keywords/Subregion_3

String

KMS controlled

No

0..1

DIF 10

/DIF/Science_Keywords/Detailed_Location

String

1 - 80 characters (Uncontrolled/Free-Text)

No

0..1

Section

Column

width	50%

DIF 10

No Format

<Location_Keywords>
  <Category>CONTINENT</Category>
  <Type>NORTH AMERICA</Type>
  <Subregion_1>UNITED STATES</Subregion_1>
  <Subregion_2>ALBAMA</Subregion_2>
  <Subregion_3>HUNTSVILLE</Subregion_3>
  <Detailed_Location>THE UNIVERSITY OF ALABAMA IN HUNTSVILLE</Detailed_Location>
</Location_Keywords>
<Location_Keywords>
  <Category>CONTINENT</Category>
  <Type>NORTH AMERICA</Type>
  <Subregion_1>CANADA</Subregion_1>
  <Subregion_2>ONTARIO</Subregion_2>
</Location_Keywords>

Column

width	50%

UMM

No Format

LocationKeywords: [
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "UNITED STATES",
    Subregion2: "ALABAMA"
    Subregon3: "HUNTSVILLE"
    DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
  },
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "CANADA",
    Subregion2: "ONTARIO"
  }
],

Expand

title	ECHO 10

ECHO 10

Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)

SpecificationPathTypeConstraintsRequired in ECHO10?CardinalityNotesECHO 10/Collection/ScienceKeywords/ScienceKeyword/CategoryKeywordString

KMS controlled

Yes1The category keyword will always be "EARTH SCIENCE"ECHO 10/Collection/ScienceKeywords/ScienceKeyword/TopicKeywordString

KMS controlled

Yes1ECHO 10/Collection/ScienceKeywords/ScienceKeyword/TermKeywordStringKMS controlledYes1ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/ValueStringKMS controlledNo0..1ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/ValueStringKMS controlledNo0..1ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/VariableLevel3Keyword/ValueStringKMS controlledNo0..1ECHO 10/Collection/ScienceKeywords/ScienceKeyword/DetailedVariableKeywordStringUncontrolled (Free-Text)No0..1Example Mapping

Section

Column

width	50%

ECHO 10

No Format

<ScienceKeyword>
  <CategoryKeyword>EARTH SCIENCE</CategoryKeyword> 
  <TopicKeyword>BIOSPHERE</TopicKeyword> 
  <TermKeyword>VEGETATION</TermKeyword> 
  <VariableLevel1Keyword>
    <Value>VEGETATION INDEX</Value>
      <VariableLevel2Keyword>
        <Value>NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)</Value>
      </VariableLevel2Keyword>
  </VariableLevel1Keyword>
  <DetailedVariableKeyword>0.9 DENSITY</DetailedVariableKeyword>
</ScienceKeyword>
<ScienceKeyword>
  <CategoryKeyword>EARTH SCIENCE</CategoryKeyword> 
  <TopicKeyword>BIOSPHERE</TopicKeyword> 
  <TermKeyword>VEGETATION</TermKeyword> 
  <VariableLevel1Keyword>
    <Value>EVERGREEN VEGETATION</Value>
  </VariableLevel1Keyword>
</ScienceKeyword>

Column

width	50%

UMM

No Format

ScienceKeywords: [
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "VEGETATION INDEX"
    VariableLevel2: "NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)"
    DetailedVariable: "0.9 DENSITY"
  },
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "EVERGREEN VEGETATION"
  }
],

Expand

title	ISO 19115-2 MENDS

ISO 19115-2 MENDS

Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)

SpecificationPathTypeNotesISO 19115-2 MENDS

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/ gmd:keyword/gco:CharacterString (list each value of the keyword hierarchy delimited by > )

String

KMS controlled. This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in between. The CMR will not translate the NONE values they are only used to place each keyword in its correct space in the hierarchy.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/ gmd:keyword/gmd:type/MD_KeywordTypeCode[@codeListValue="theme"]
Codelist

codeList=https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml #MD_KeywordTypeCode

Select the value "theme" from the codelist. This codelist value does not directly map to a UMM element; choosing "theme" indicates to CMR that the Science Keywords should be mapped.

Example Mapping

Section

Column

width	50%

ISO 19115-2 MENDS

No Format

...
<gmd:identificationInfo>
  <gmd:MD_DataIdentification>
    <gmd:descriptiveKeywords>
      <gmd:MD_Keywords>
        <gmd:keyword>
          <gco:CharacterString>EARTH SCIENCE&gt;BIOSPHERE&gt;VEGETATION&gt;VEGETATION INDEX&gt;NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)&gt;NONE&gt;0.9 DENSITY</CharacterString>
        </gmd:keyword>
        <gmd:keyword>
          <gco:CharacterString>EARTH SCIENCE&gt;BIOSPHERE&gt;VEGETATION&gt;EVERGREEN VEGETATION</CharacterString>
        </gmd:keyword>
        <gmd:type>
          <gmd:MD_KeywordTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="theme">theme</gmd:MD_KeywordTypeCode>
        </gmd:type>
      </gmd:MD_Keywords> 
    </gmd:descriptiveKeywords>
  </gmd:MD_DataIdentification>
</gmd:identificationInfo>
...

Column

width	50%

UMM

No Format

ScienceKeywords: [
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "VEGETATION INDEX"
    VariableLevel2: "NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)"
    DetailedVariable: "0.9 DENSITY"
  },
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "EVERGREEN VEGETATION"
  }
],

Expand

title	ISO 19115-2 SMAP

ISO 19115-2 SMAP

Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)

SpecificationPathTypeNotesISO 19115-2 SMAP

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/ gmd:MD_Keywords/gmd:keyword/gco:CharacterString (list each value of the keyword hierarchy delimited by > )

StringKMS controlled. This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in between. The CMR will not translate the NONE values they are only used to place each keyword in its correct space in the hierarchy.ISO 19115-2 SMAP/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/ gmd:type/MD_KeywordTypeCode[@codeListValue="theme"]CodelistcodeList=

https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.

xml#MD

xml#MD_KeywordTypeCode

Select the value "theme" from the codelist. This codelist value does not directly map to a UMM element; choosing "theme" indicates to CMR that the Science Keywords should be mapped.

Example Mapping

Section

Column

width	50%

ISO 19115-2 SMAP

No Format

...
<gmd:identificationInfo>
  <gmd:MD_DataIdentification>
    <gmd:descriptiveKeywords>
" codeListValue="place">place</gmd:MD_KeywordTypeCode>
         <gmd:MD_Keywords>
        <gmd:keyword></gmd:type>
          <gco:CharacterString>EARTH SCIENCE&gt;BIOSPHERE&gt;VEGETATION&gt;VEGETATION INDEX&gt;NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)&gt;NONE&gt;0.9 DENSITY</CharacterString>
 </gmd:MD_Keywords> 
          </gmd:keyword>descriptiveKeywords>
        <gmd:keyword>
  ...
        <gco:CharacterString>EARTH SCIENCE&gt;BIOSPHERE&gt;VEGETATION&gt;EVERGREEN VEGETATION</CharacterString></gmd:MD_DataIdentification>
        </gmd:keyword>identificationInfo>
      ...
    <gmd:type></gmi:MI_Metadata>
  </gmd:seriesMetadata>
</gmd:DS_Series>

Column

width	50%

UMM

No Format

LocationKeywords: [
  {
     <gmd:MD_KeywordTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="theme">theme</gmd:MD_KeywordTypeCode>
        </gmd:type>Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "UNITED STATES",
    Subregion2: "ALABAMA"
    DetailedLocation:  </gmd:MD_Keywords> 
    </gmd:descriptiveKeywords>
  </gmd:MD_DataIdentification>
</gmd:identificationInfo>
...

Column

width	50%

UMM

No Format

ScienceKeywords: [
"THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
  },
  {
    Category: "EARTH SCIENCECONTINENT",
    TopicType: "BIOSPHERENORTH AMERICA",
    TermSubregion1: "VEGETATIONCANADA",
    VariableLevel1Subregion2: "VEGETATION INDEXONTARIO"
    VariableLevel2: "NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)"
    DetailedVariable: "0.9 DENSITY"
  },
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "EVERGREEN VEGETATION"
  }
],

UMM Migration

None

}
],

UMM Migration

None

Future Mappings

Expand

title	ISO 19115-1

ISO 19115-1

Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).

UMM-C Element

ISO 19115-1 Path

Type

Notes

LocationKeywords/Category

LocationKeywords/Type

LocationKeywords/Subregion1

LocationKeywords/Subregion2

LocationKeywords/Subregion3

LocationKeywords/DetailedLocation

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/mri:MD_Keywords/ mri:keyword/gco:CharacterString

(list each value of the keyword hierarchy delimited by > )

String

KMS controlled. Valid Location Keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/locations?format=csv

Future Mappings

Expand

title	ISO 19115-1

ISO 19115-1

Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)

Specification

Path

Type

Notes

ISO 19115-1

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/

mri:MD_Keywords/mri:keyword/gco:CharacterString

(list each value of the keyword hierarchy delimited by > )

String

KMS controlled.

This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by ">". If any keyword is missing and there exists a keyword later in the hierarchy (such as DetailedLocation), use NONE to fill in the values in-between. The CMR will not translate the NONE values as they are only used to place each keyword in its correct space in the hierarchy.

ISO 19115-1

//mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/mri:MD_Keywords/ mri:keyword/mri:type/mri:MD_KeywordTypeCode[@codeListValue="theme"]

codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="place"

Codelist

codeList=httphttps://standardscdn.earthdata.isonasa.orggov/iso/19115/resources/Codelist/cat/codelists.xml#MDgmxCodelists.xml #MD_KeywordTypeCode

Select the value "themeplace" from the codelist. This codelist value does not directly map to a UMM element; choosing "themeplace" indicates to CMR that the Science Keywords provided value should be mapped .to 'Location Keywords'.

Example Mapping

Section

Column

width	50%

ISO 19115-1

No Format

<mdb:MD_Metadata>
  ...    
    <mdb:identificationInfo>
        <mri:MD_DataIdentification>

      ...
      <mri:descriptiveKeywords>
                <mri:MD_Keywords>
                    <mri:keyword>
                        <gco:CharacterString>EARTH SCIENCECharacterString>CONTINENT&gt;BIOSPHERENORTH AMERICA&gt;VEGETATIONUNITED STATES&gt;VEGETATION INDEXALABAMA&gt;NONE&gt;NORMALIZEDTHE DIFFERENCEUNIVERSITY VEGETATIONOF INDEX (NDVI)&gt;NONE&gt;0.9 DENSITY</gco:ALABAMA IN HUNTSVILLE</CharacterString>
          </mri:keyword>
          </mri<mri:keyword>
            <gco:CharacterString>CONTINENT&gt;NORTH AMERICA&gt;CANADA&gt;ONTARIO</CharacterString>
          <mri</mri:keyword>
           <mri:type>
             <gco:CharacterString>EARTH SCIENCE&gt;BIOSPHERE&gt;VEGETATION&gt;EVERGREEN VEGETATION</gco:CharacterString><mri:MD_KeywordTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_KeywordTypeCode" codeListValue="place">place</gmd:MD_KeywordTypeCode>
          </mri:type>
          </mri:keyword>MD_Keywords>
      </mri:descriptiveKeywords>
      ...
    </mri:MD_DataIdentification>
    <mri:type></mdb:identificationInfo>
  ...
</mdb:MD_Metadata>

Column

width	50%

UMM

No Format

LocationKeywords: [
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: "UNITED STATES",
   <mri:MD_KeywordTypeCode Subregion2: "ALABAMA"
    DetailedLocation: "THE UNIVERSITY OF ALABAMA IN HUNTSVILLE"
  },
  {
    Category: "CONTINENT",
    Type: "NORTH AMERICA",
    Subregion1: codeList="http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.xml#MD_KeywordTypeCode"
                            codeListValue="MD_KeywordTypeCode_theme">theme</mri:MD_KeywordTypeCode>
                    </mri:type>
                </mri:MD_Keywords>
            </mri:descriptiveKeywords>
         </mri:MD_DataIdentification>
    </mdb:identificationInfo>       
...

Column

width	50%

UMM

No Format

ScienceKeywords: [
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "VEGETATION INDEX"
    VariableLevel2: "NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)"
    DetailedVariable: "0.9 DENSITY"
  },
  {
    Category: "EARTH SCIENCE",
    Topic: "BIOSPHERE",
    Term: "VEGETATION",
    VariableLevel1: "EVERGREEN VEGETATION"
  }
],

"CANADA",
    Subregion2: "ONTARIO"
  }
],

History

UMM Versioning

Version	Date	What Changed
1.15.5	12/3/2020	No changes were made for Location Keywords during the transition from version 1.15.4 to 1.15.5
1.15.4	9/18/2020	No changes were made for Location Keywords during the transition from version 1.15.3 to 1.15.4
1.15.3	7/1/2020	No changes were made for Location Keywords during the transition from version 1.15.2 to 1.15.3
1.15.2	5/20/2020	No changes were made for Location Keywords during the transition from version 1.15.1 to 1.15.2
1.15.1	3/25/2020	No changes were made for Location Keywords during the transition from version 1.15.0 to 1.15.1
1.15.0	2/26/2020	No changes were made for Location Keywords during the transition from version 1.14.0 to 1.15.0
1.14.0	10/21/2019	No changes were made for Location Keywords during the transition from version 1.13.0 to 1.14.0
1.13.0	04/11/2019	No changes were made for Location Keywords during the transition from version 1.12.0 to 1.13.0
1.12.0	01/22/2019	No changes were made for Location Keywords during the transition from version 1.11.0 to 1.12.0
1.11.0	11/28/2018	No changes were made for Location Keywords during the transition from version 1.10.0 to 1.11.0
1.10.0	05/02/2018	No changes were made for Location Keywords during the transition from version 1.9.0 to 1.10.

History

UMM Versioning

VersionDateWhat Changed1.10.05/2/2018No changes were made to Science Keywords in the transition from UMM Version 1.9.0 to 1.10.01.9.

0

ARC Documentation

Version	Date	What Changed	Author
1.0	502/401/182018	Recommendations/priority matrix transferred from internal ARC documentation to wiki space	Jeanne' le Roux

Page tree

Versions Compared

Old Version 13

New Version Current

Key

Element Description

Best Practices

Element Specification

Metadata Validation and QA/QC

DIF 10

ECHO 10

ISO 19115-2 MENDS

DIF 10

ISO 19115-2 SMAP

ECHO 10

ISO 19115-2 MENDS

ISO 19115-2 SMAP

UMM Migration

UMM Migration

ISO 19115-1

ISO 19115-1

History

UMM Versioning

History

UMM Versioning

ARC Documentation