You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

Element Description

The Characteristics sub-elements can be used to describe attributes unique to the parent element. Currently, characteristics can be provided for the Platform, Instrument, and ComposedOf parent elements. While providing characteristics is optional, if provided, all of the sub-elements are required. The Characteristic sub-elements include:

  •     Name: A title of the characteristic attribute.
  •     Description: A short description of the characteristic attribute.
  •     DataType: A specification for the values accepted in the Characteristics/Value field. This must be selected from an enumeration list.
  •     Unit: The unit associated with the Characteristics/Value field. 
  •     Value: The actual value of the characteristic attribute.    

Best Practices

Characteristics/Name: 

  • The name should identify what the characteristic is in relation to the parent element.
  • The name must be unique if multiple characteristics are listed under the same platform/instrument/sensor.
  • The name does not have to be unique across different platforms/instruments/sensors.  

Characteristics/Description: 

  • The description should be brief and provide a definition for the characteristic name plus any other useful information.

Characteristics/DataType: 

  • This element is controlled by an enumeration list (STRING, FLOAT, INT BOOLEAN, DATE, TIME, DATETIME, DATE_STRING, TIME_STRING, DATETIME_STRING). This should correspond to whatever is provided in the Characteristics/Value field.

Characteristics/Unit: 

  • The unit should correspond to whatever is provided in the Characteristics/Value field. There will be cases where a unit does not apply for the value. In these cases, since Unit is still a required field, it is recommend that "n/a" or "Not Applicable" be listed as the Unit. 

Characteristics/Value: 

  • The actual characteristic value should be provided here and should correspond to the data type and unit defined. For example, if the unit specified is 'degrees' then the value should be provided in degrees and not in radians. 


Examples:

Example for the ICESat Platform:

    Characteristics/Name: OrbitInclination 

    Characteristics/Description: The angle between the orbit plane and the Earth's equatorial plane.

    Characteristics/DataType: FLOAT

    Characteristics/Unit: Degrees

    Characteristics/Value: 94.0 


Example for the GLAS Instrument: 

    Characteristics/Name: SwathWidth 

    Characteristics/Description: The width of the sensor scan as the satellite moves along the ground track.

    Characteristics/DataType: INT

    Characteristics/Unit: Kilometers

    Characteristics/Value: 2


Example for a photon counter sensor: 

    Characteristics/Name: Wavelength

    Characteristics/Description: The wavelength at which photon returns were measured.

    Characteristics/DataType: INT

    Characteristics/Unit: Nanometers

    Characteristics/Value: 532


Element Specification

Providing characteristics is optional. An unlimited amount of characteristics may be specified (Cardinality: 0..*). If characteristics are provided, all 5 sub-fields (Name, Description, DataType, Unit, Value) are required.

<parent> For the complete element mappings, please see the appropriate parent element page: Platform, Instrument, ComposedOf

ModelElementTypeUsable Valid ValuesConstraintsRequired?Cardinality
UMM-Common<parent>/Characteristics/NameStringn/a

Minimum # characters: 1

Maximum # characters: 80

Yes1
UMM-Common<parent>/Characteristics/DescriptionStringn/a

Minimum # characters: 1

Maximum # characters: 2048

Yes1
UMM-Common<parent>/Characteristics/DataTypeEnumeration

STRING

FLOAT

INT

BOOLEAN

DATE

TIME

DATETIME

DATE_STRING

TIME_STRING

DATETIME_STRING

n/aYes1
UMM-Common<parent>/Characteristics/UnitStringn/a

Minimum # characters: 1

Maximum # characters: 20

Yes1
UMM-Common<parent>/Characteristics/ValueStringn/a

Minimum # characters: 1

Maximum # characters: 80

Yes1




ARC Priority Matrix

Priority CategorizationJustification

This element is categorized as highest priority when:

  • Only some of the Characteristics sub-fields are populated.
  • The characteristic listed is incorrect.
  • Any of the Characteristics sub-fields contains a spelling and/or grammatical error.
  • The Characteristics/Name is repeated for the same platform/instrument/sensor.
  • The Characteristics/DataType provided does not match one of the accepted enumeration values (STRING, FLOAT, INT BOOLEAN, DATE, TIME, DATETIME, DATE_STRING, TIME_STRING, DATETIME_STRING)

This element is categorized as medium priority when:

  • A recommendation is made to improve the wording of the Characteristics/Description.
  • A recommendation is made to add an additional characteristic.

This element is categorized as low priority when:

  • Characteristics are provided in an inconsistent manner across related datasets.

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


Dialect Mappings

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

DIF 10

An unlimited amount of science keywords may be listed (Cardinality: 1..*)

SpecificationPathTypeConstraintsRequired in DIF 10?CardinalityNotes
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

Yes1
DIF 10/DIF/Science_Keywords/TermString

KMS controlled

Yes1
DIF 10/DIF/Science_Keywords/Variable_Level_1StringKMS controlledNo0..1
DIF 10/DIF/Science_Keywords/Variable_Level_2StringKMS controlledNo0..1
DIF 10/DIF/Science_Keywords/Variable_Level_3StringKMS controlledNo0..1
DIF 10/DIF/Science_Keywords/Detailed_VariableStringUncontrolled (Free-Text)No0..1



Example Mapping

DIF 10

<Science_Keywords>
  <Category>EARTH SCIENCE</Category>
  <Topic>BIOSPHERE</Topic>
  <Term>VEGETATION</Term>
  <Variable_Level_1>VEGETATION INDEX</Variable_Level_1>
  <Variable_Level_2>NORMALIZED DIFFERENCE VEGETATION INDEX (NDVI)</Variable_Level_2>
</Science_Keywords>
<Science_Keywords>
  <Category>EARTH SCIENCE</Category>
  <Topic>BIOSPHERE</Topic>
  <Term>VEGETATION</Term>
  <Variable_Level_1>EVERGREEN VEGETATION</Variable_Level_1>
</Science_Keywords>

UMM

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

ECHO 10

An unlimited amount of science keywords may be listed (Cardinality: 1..*)

SpecificationPathTypeConstraintsRequired in ECHO10?CardinalityNotes
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/CategoryKeywordString

KMS controlled

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

KMS controlled

Yes1
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/TermKeywordStringKMS controlledYes1
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/ValueStringKMS controlledNo0..1
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/ValueStringKMS controlledNo0..1
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/VariableLevel1Keyword/VariableLevel2Keyword/VariableLevel3Keyword/ValueStringKMS controlledNo0..1
ECHO 10/Collection/ScienceKeywords/ScienceKeyword/DetailedVariableKeywordStringUncontrolled (Free-Text)No0..1


Example Mapping

ECHO 10

<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>
</ScienceKeyword>
<ScienceKeyword>
  <CategoryKeyword>EARTH SCIENCE</CategoryKeyword> 
  <TopicKeyword>BIOSPHERE</TopicKeyword> 
  <TermKeyword>VEGETATION</TermKeyword> 
  <VariableLevel1Keyword>
    <Value>EVERGREEN VEGETATION</Value>
  </VariableLevel1Keyword>
</ScienceKeyword>

UMM

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



ISO 19115-2 MENDS

An unlimited amount of science keywords may be listed (Cardinality: 1..*)

SpecificationPathTypeNotes
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 &gt; )

String


KMS controlled. This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by "&gt;"

/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

ISO 19115-2 MENDS

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

UMM

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



ISO 19115-2 SMAP

An unlimited amount of science keywords may be listed (Cardinality: 1..*)

SpecificationPathTypeNotes
ISO 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 &gt; )

StringKMS controlled. This is where the entire keyword hierarchy should be listed. Each keyword in the hierarchy must be separated by "&gt;"
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"]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

ISO 19115-2 SMAP

UMM

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



UMM Migration

None


Future Mappings

ISO 19115-1

SpecificationPathTypeNotes
ISO 19115-1


String

ISO 19115-1

UMM

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

History

UMM Versioning

VersionDateWhat Changed
1.0.0
Initial Release

ARC Documentation

VersionDateWhat ChangedAuthor
1.05/4/18Recommendations/priority matrix transferred from internal ARC documentation to wiki spaceJeanne' le Roux



  • No labels