Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated the "ARC Automated Checks"

Table of Contents
stylecircle

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/a1 - 80 charactersYes1
UMM-Common<parent>/Characteristics/DescriptionStringn/a1 - 2048 charactersYes1
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/a1 - 20 charactersYes1
UMM-Common<parent>/Characteristics/ValueStringn/a1 - 20 charactersYes1


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-viewertrue
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-45f5a93d
width1102
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details.


Expand
titleGCMD Metadata QA/QC
  • Manual Review
    • Check that the value is appropriate for the Platform/Instrument
  • Automated Review
    • Check that the field has been populated
    • Check that the field length is not greater than 80 characters for Name
    • Check that the field length is not greater than 2048 characters for Description
    • Check that the field length is not greater than 20 characters for Unit
    • Check that the field length is not greater than 20 characters for Value
    • Check that the field is populated with a valid value for Datatype


Expand
titleCMR Validation


Expand
titleARC Metadata QA/QC

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.

ARC Automated Checks<insert>

  • If a value is present, return is "OK"
  • If no values is present, return is "np"


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 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, Sensor

SpecificationPathTypeConstraintsRequired in DIF 10?CardinalityNotes
DIF 10

<parent>/Characteristics/Name

String

1 - 80 characters

Yes, if applicable

1

Only required if a characteristic is listed. Providing characteristics is optional.

DIF 10<parent>/Characteristics/DescriptionString

1 - 2048 characters

Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
DIF 10<parent>/Characteristics/DataType
String

n/a

Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
DIF 10<parent>/Characteristics/UnitString1 - 20 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
DIF 10<parent>/Characteristics/ValueString1 - 20 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.



Example Mapping

Section
Column
width50%

DIF 10

No Format
...
<Characteristics>
  <Name>SwathWidth</Name>
  <Description>The width of the sensor scan as the satellite moves along the ground track.</Description>
  <DataType>INT</DataType>
  <Unit>Kilometers</Unit>
  <Value>2330</Value>
</Characteristics>
...
Column
width50%

UMM

No Format
...
Characteristics: [
  {
    Name: "SwathWidth",
    Description: "The width of the sensor scan as the satellite moves along the ground track.",
    DataType: "INT",
    Unit: "Kilometers",
    Value: "2330",
  }
...
Expand
titleECHO 10

ECHO 10

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, Sensor

SpecificationPathTypeConstraintsRequired in ECHO10?CardinalityNotes
ECHO 10<parent>/Characteristics/Characteristic/Name
String


Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
ECHO 10<parent>/Characteristics/Characteristic/Description
String


Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
ECHO 10<parent>/Characteristics/Characteristic/DataTypeString
Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
ECHO 10<parent>/Characteristics/Characteristic/Unit 
String
Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
ECHO 10<parent>/Characteristics/Characteristic/ValueString
Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.


Example Mapping

Section
Column
width50%

ECHO 10

No Format
...
<Characteristics>
  <Characteristic>
    <Name>SwathWidth</Name>
    <Description>The width of the sensor scan as the satellite moves along the ground track.</Description>
    <DataType>INT</DataType>
    <Unit>Kilometers</Unit>
    <Value>2330</Value>
  </Characteristic>
</Characteristics>
...
Column
width50%

UMM

No Format
...
Characteristics: [
  {
    Name: "SwathWidth",
    Description: "The width of the sensor scan as the satellite moves along the ground track.",
    DataType: "INT",
    Unit: "Kilometers",
    Value: "2330",
  }
...



Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

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, Sensor

SpecificationPathTypeNotes
ISO 19115-2 MENDS

<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString


String


Corresponds to the UMM field Platforms/Instruments/Characteristics/Name.

ISO 19115-2 MENDS<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterStringString

Corresponds to the UMM field Platforms/Instruments/Characteristics/Description.



ISO 19115-2 MENDS<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:dataType/eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_DatatypeCode" codeListValue=<date type> value=<data type>Codelist

Corresponds to the UMM field Platforms/Instruments/Characteristics/DataType.

ISO codelist values (class, codelist, enumeration, codelistElement, abstractClass, aggregateClass, specifiedClass, datatypeClass, interfaceClass, unionClass, metaClass, typeClass, characterString, integer, association)

UMM enum (STRING, FLOAT, INT BOOLEAN, DATE, TIME, DATETIME, DATE_STRING, TIME_STRING, DATETIME_STRING)

ISO 19115-2 MENDS<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Unit.
ISO 19115-2 MENDS<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Value.


Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
...

...
Column
width50%

UMM

No Format
...
Characteristics: [
  {
    Name: "SwathWidth",
    Description: "The width of the sensor scan as the satellite moves along the ground track.",
    DataType: "INT",
    Unit: "Kilometers",
    Value: "2330",
  }
...



Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

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, Sensor

SpecificationPathTypeNotes
ISO 19115-2 SMAP

<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString

StringCorresponds to the UMM field Platforms/Instruments/Characteristics/Name.
ISO 19115-2 SMAP<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterStringString

Corresponds to the UMM field Platforms/Instruments/Characteristics/Description.

ISO 19115-2 SMAP<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:dataType/eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_DatatypeCode" codeListValue=<date type> value=<data type>Codelist

Corresponds to the UMM field Platforms/Instruments/Characteristics/DataType.

ISO codelist values (class, codelist, enumeration, codelistElement, abstractClass, aggregateClass, specifiedClass, datatypeClass, interfaceClass, unionClass, metaClass, typeClass, characterString, integer, association)

UMM enum (STRING, FLOAT, INT BOOLEAN, DATE, TIME, DATETIME, DATE_STRING, TIME_STRING, DATETIME_STRING)

ISO 19115-2 SMAP<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Unit.
ISO 19115-2 SMAP<parent>/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Value.


Example Mapping

Section
Column
width50%

ISO 19115-2 SMAP

No Format
Column
width50%

UMM

No Format
...
Characteristics: [
  {
    Name: "SwathWidth",
    Description: "The width of the sensor scan as the satellite moves along the ground track.",
    DataType: "INT",
    Unit: "Kilometers",
    Value: "2330",
  }
...



UMM Migration

None


Future Mappings

Expand
titleISO 19115-1

ISO 19115-1

SpecificationPathTypeNotes
ISO 19115-1


String
Section
Column
width50%

ISO 19115-1

No Format
Column
width50%

UMM

No Format
...
Characteristics: [
  {
    Name: "SwathWidth",
    Description: "The width of the sensor scan as the satellite moves along the ground track.",
    DataType: "INT",
    Unit: "Kilometers",
    Value: "2330",
  }
...

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