Page History
Table of Contents | ||
---|---|---|
|
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. If a certain location keyword is not Providing 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 | 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 Subregion1 Keywords | KMS controlled | No | 0..1 | |
UMM-C | LocationKeywords/Subregion2 | String |
Variable_Level_1
Location Subregion2 Keywords | KMS controlled | No | 0..1 | |
UMM-C | LocationKeywords/Subregion3 | String |
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 | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Please see the expandable sections below for flowchart details.
Expand | ||
---|---|---|
| ||
|
Expand | |||
---|---|---|---|
| |||
|
Expand | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
ARC Priority ARC Priority Matrix
ARC Automated Checks
If no value isprovided, return is "np" |
Expand | ||
---|---|---|
| ||
<> |
Dialect Mappings
Expand | ||
---|---|---|
| ||
DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018) |
ARC Automated Checks ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information. |
Dialect Mappings
Expand | ||
---|---|---|
| ||
DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018) |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIF 10Providing a Location is optional. Multiple Locations may be provided, if necessary (Cardinality: 0..*).
|
Expand | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||
ECHO 10Providing a Spatial Keyword is optional. Multiple Spatial Keywords may be provided, if necessary (Cardinality: 0..*).
| ||||||||||||||||||||||||||||||||
Expand | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
DIF 10Science_Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*) | ||||||||||||||||||||||||||||||||
Specification | Path | Type | Constraints | Required in DIF 10? | Cardinality | Notes | ||||||||||||||||||||||||||
DIF 10 | /DIF/Science_Keywords/Category | String | KMS controlled | Yes | 1 | The category keyword will always be "EARTH SCIENCE" | DIF 10 | /DIF/Science_Keywords/Topic | String | KMS controlled | Yes | 1 | DIF 10 | /DIF/Science_Keywords/Term | String | KMS controlled | Yes | 1 | DIF 10 | /DIF/Science_Keywords/Variable_Level_1 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Variable_Level_2 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Variable_Level_3 | String | KMS controlled | No | 0..1 | DIF 10 | /DIF/Science_Keywords/Detailed_Variable | String | 1 - 80 characters (Uncontrolled/Free-Text) | No | 0..1 | Example Mapping
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 MENDSProviding a Location Keyword is optional. Multiple Location ECHO 10Science Keywords are required. An unlimited amount of Science Keywords may be provided, if necessary (Cardinality: 10..*).
Specification | Path
Required in ECHO10? | Cardinality |
String | KMS controlled Yes | 1 | The category keyword will always be "EARTH SCIENCE" |
ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/TopicKeyword | String | KMS controlled Yes | 1 | ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/TermKeyword | String | KMS controlled | Yes | 1 | ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/VariableLevel3Keyword/Value | String | KMS controlled | No | 0..1 | ECHO 10 | /Collection/ScienceKeywords/ScienceKeyword/DetailedVariableKeyword | String | Uncontrolled (Free-Text) | No | 0..1
|
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
ISO 19115-2 SMAPProviding a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*). | ||||||||||||||
Expand | ||||||||||||||
| ||||||||||||||
ISO 19115-2 MENDSScience Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*) | ||||||||||||||
Specification | Path | Type | Notes | ISO 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 > ) | /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/ gmd:keyword/gmd:type/MD_KeywordTypeCode[@codeListValue="theme"] | Codelist | |||||||
Section | ||||||||||||||
Column | ||||||||||||||
| ||||||||||||||
No Format |
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=" |
Column | ||
---|---|---|
| ||
UMM
|
title | ISO 19115-2 SMAP |
---|
ISO 19115-2 SMAP
Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 1..*)
/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 > )
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.
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
UMM Migration
None
|
UMM Migration
None
Future Mappings
Expand | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
ISO 19115-1Providing a Location Keyword is optional. Multiple Location Keywords may be provided, if necessary (Cardinality: 0..*).
Example Mapping
|
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. |
Future Mappings
title | ISO 19115-1 |
---|
ISO 19115-1
Science Keywords are required. An unlimited amount of Science Keywords may be provided (Cardinality: 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 > )
/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:descriptiveKeywords/
mri:MD_Keywords/mri:keyword/mri:type/mri:MD_KeywordTypeCode[@codeListValue="theme"]
codeList=http://standards.iso.org/iso/19115/resources/Codelist/cat/codelists.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.
Section | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
History
UMM Versioning
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 |