Page History

Element Description

The archive Archive and distribution information main element allows data providers to provide users information of what is available for downloading when they initially looking at a collection. The end users get elements provide information about a format other than its original for data immediately available for download. This includes information such as the average downloadable file size, data format, mime type, checksum, etc., and an estimate of the collections collection's entire downloadable file size, etc.

Best Practices

Instrument keywords are important for the discovery of data. All relevant instruments should be listed for each dataset, and each instrument listed should be provided under its associated platform. It is preferred that more specific instrument keyword terms be chosen from the KMS when available. For example, if data were collected from the AMSR-E instrument, it is preferred that "AMSR-E" be listed as the instrument as opposed to the more generic "RADIOMETERS" keyword. If a particular instrument keyword is missing from the KMS, it is possible to put in a request to have it added. The KMS is managed by the Global Change Master Directory (GCMD) and new keyword requests may be made through the GCMD Keywords Community Forum.

The Instruments/Technique field is optional. It can be used to further describe the technique utilized by the instrument for data collection. For example, the technique for a laser altimeter instrument on board a satellite could read "Measures the distance of the satellite from the Earth's surface by taking a precise measurement of the time it takes a transmitted laser pulse to hit the ground and then return to the instrument." 

The Instruments/NumberOfInstruments field is optional. It can be used to indicate the number of instruments (i.e. sensors) used on the instrument while acquiring data. For example, the Terra satellite carries the ASTER instrument. The ASTER instrument is made up of 3 instrument subsystems (VNIR, SWIR, and TIR). In this example, the Instruments/NumberOfInstruments field would read "3".

The Instruments/OperationalModes field is optional and may be repeated. This field can be used to specify the mode(s) in which an instrument collects data. For example, the Sentinel-1 satellite collects data in four different modes. If a collection were to contain data acquired in all four modes, the OperationalModes field could be repeated four times and read "Stripmap (SM)", "Interferomic Wide swath (IW)", "Extra-Wide swath (EW)", "Wave (WV)"  

Examples (ShortName > LongName):

SMMR > Scanning Multichannel Microwave Radiometer

OLI > Operational Land Imager

UAVSAR > Uninhabited Aerial Vehicle Synthetic Aperture Radar

LIS > Lightning Imaging Sensor

XPOL > NOAA/ETL X-band Polarimetric Doppler Radar 

There are multiple sub-elements that comprise Archive and Distribution Information for Collections:

Format: Defines a single format for an archival artifact (e.g., binary, jpeg, HDF5, HDF-EOS5, GeoTIFF). The format must be selected from the GCMD Granule Data Format vocabulary list in order to adhere to the UMM-C schema. This ensures consistent use of data formats across the CMR.  

Format Type: Allows the provider to define if the archival artifact's format is in its native format or another supported format.

Format Description: Allows the data provider to provide added information about the provided Format.

Average File Size: An approximate average of the size of the the archivable item, which gives users an idea of the magnitude of each archivable file.

Average File Size Unit: Unit of measure for the average file size (e.g., KB, MB, TB).

Total Collection File Size: An approximate total size of the archivable items, which gives users an idea of the magnitude of all the archivable files combined.

Total Collection File Size Unit: Unit of measure for the total collection file size (e.g., KB, MB, TB).

Total Collection File Size Begin Date: The date that data collection began for the collection, which should be in the following format: yyyy-MM-ddTHH:mm:ssZ

Description: Enables the provider to provide more information about the archivable item. 

Media: Defines how the distributable material can be obtained by an end user (e.g., Online Archive, CD-ROM, hard drives, etc.).

Fees: Provide the price an end user will need to pay in order to obtain the distributable material.

Each of these elements are available under 'FileArchiveInformation' and 'FileDistributionInformation'. FileArchiveInformation describes the data in its archived format. FileDistributionInformation describes the data as distributed by a data provider. It can be the original format in which the data are archived, or it can be used to specify when the data is distributed in a format other than its original format. FileDistributionInformation is the preferred location for providing the data format since this should specify the format data are being distributed in to the end user.      

Examples:

Format: "HDF-EOS5"

Format Type: "Native"

Format Description: "This is an EOSDIS specific format, and it is also available in ASCII."

Average File Size: "250"

Average File Size Unit: "KB"

Total Collection File Size: "25"

Total Collect File Size Unit: "GB"

Total Collection File Size Begin Date: "2018-04-01T00:00:00Z"

Value needed for translations:

The following value is needed by the CMR to translate older non UMM compliant records to and from the UMM and other supported specifications where non required elements are considered required but no valid is given. This is needed partly because the CMR still allows a non UMM compliant record to be ingested with warnings.

UNDEFINED  - DIF 10 records found to be missing instruments by software will be automatically assigned a value of "Not Provided". It should then be confirmed whether an instrument can be assigned or whether "Not Applicable" should be provided. The value "Not Provided" should not be used by metadata providers. 

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

Please see the expandable sections below for flowchart details.

ARC Priority Matrix

This element is categorized as highest priority when:

• The element is not included at all.
• The instrument short name tags are provided in the metadata but are left empty.
• The instrument keyword does not align with the KMS.
  • The instrument keyword does not exist in KMS.
  • A keyword(s) is placed in the incorrect position of the hierarchy (e.g. the instrument short name is placed in the long name field).
  • Keywords from two different KMS hierarchies are listed in the same hierarchy in the metadata (i.e. hierarchies cannot be mixed and matched)
• Not all relevant instruments are listed.
• An incorrect instrument is listed.
• An instrument is listed under the incorrect platform.
• A recommendation is made to replace a valid instrument with a more specific/appropriate instrument keyword.
• Please see the Characteristics wiki page for high priority issues related to the Characteristics sub-elements.

This element is categorized as medium priority when:

• A recommendation is made to add an instrument long name when a long name exists in the KMS.
• Instruments are provided in an inconsistent manner across related datasets.
• Please see the Characteristics wiki page for medium priority issues related to the Characteristics sub-elements.

This element is categorized as low priority when:

• The instrument long name tags are provided in the metadata but are left empty.
• Please see the Characteristics wiki page for low priority issues related to the Characteristics sub-elements.

ARC Automated Checks

Dialect Mappings

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

Please see the expandable sections below for flowchart details.

Dialect Mappings

DIF 10

Instrument is a required metadata element. At least 1 Instrument Keyword must be provided under each Platform. Multiple Instruments may be listed if necessary (Cardinality: 1..*).

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

<Platform>
  <Type>Earth Observation Satellites</Type>
  <Short_Name>Aqua</Short_Name>
  <Long_Name>Earth Observing System, Aqua</LongName>
  <Instrument>
    <Short_Name>MODIS</Short_Name>
    <Long_Name>Moderate-Resolution Imaging Spectroradiometer</Long_Name>
    <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>
  </Instrument>
</Platform>

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "Aqua",
    LongName: "Earth Observing System, Aqua",
    Instruments: [
      {
        ShortName: "MODIS",
        LongName: "Moderate-Resolution Imaging Spectroradiometer",  
        Characteristics: [
          {
            Name: "SwathWidth",
            Description: "The width of the sensor scan as the satellite moves along the ground track.",
            DataType: "INT",
            Unit: "Kilometers",
            Value: "2330",
          }
        ]
      }
    ]
  }
],

ECHO 10

Instrument is an optional metadata element, however, it is strongly recommended that it be provided when possible. Multiple Instruments may be listed if necessary (Cardinality: 0..*).

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

KMS controlled

KMS controlled

Example Mapping

<Platforms><gmi:MI_Metadata>
  <Platform>...
     <ShortName>Aqua</ShortName><gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/>
    <LongName>Earth  Observing System, Aqua</LongName> <gmd:MD_Format>
    <Type>Earth   Observation Satellites</Type>
    <Instruments><gmd:specification>
        <Instrument>
        <ShortName>MODIS</ShortName><gco:CharacterString>TotalCollectionFileSizeBeginDate</gco:CharacterString>
        <LongName>Moderate-Resolution Imaging Spectroradiometer</LongName>    </gmd:code>
        <Characteristics>
      <gmd:codeSpace>
    <Characteristic>
            <Name>SwathWidth</Name><gco:CharacterString>2018-04-01T00:00:00Z</gco:CharacterString>
            <Description>The width of the sensor scan as the satellite moves along the ground track.</Description>
 </gmd:codeSpace>
                 <DataType>INT</DataType><gmd:specification>
            <Unit>Kilometers</Unit><gmd:MD_Format>
      <gmd:distributionFormat      <Value>2330</Value>
          </Characteristic>xlink:href="FileDistributionInformation_<Block Number>"/>  
        </Characteristics>
      </Instrument>
    </Instruments>
  </Platform>
</Platforms>

PlatformsArchiveandDistributionInformation: [ 
  { 
     TypeAverageFileSize: "Earth Observation Satellites250", 
  },
  ShortName: "Aqua",{ 
    LongName AverageFileSizeUnit: "Earth Observing SystemKB", Aqua",
    Instruments: [},
      {
        ShortName: "MODIS",
        LongNameTotalCollectionFileSizeBeginDate: "Moderate-Resolution Imaging Spectroradiometer2018-04-01T00:00:00Z",  
  } 
],
     Characteristics: [
          {
            Name: "SwathWidth",
            Description: "The width of the sensor scan as the satellite moves along the ground track.",
            DataType: "INT",
            Unit: "Kilometers",
            Value: "2330",
          }
        ]
      }
    ]
  }
],

ISO 19115-2 MENDS

Instrument is an optional metadata element, however, it is strongly recommended that it be provided when possible. Multiple Instruments may be listed if necessary (Cardinality: 0..*).

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

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument id="<insert unique instrument ID here>"/ gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

with

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.instrumentshortname

Corresponds to the UMM field Platforms/Instruments/ShortName. A list of valid instrument short names can be found in the KMS under the 'Short_Name' column. For each instrument listed the short name is required by CMR. The short name value goes in the gmd:code field.

The value of " gov.nasa.esdis.umm.instrumentshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the instrument short name.

An ID should be provided directly after "eos:EOS_Instrument" in the ISO x-path. This ID corresponds to the instrument and is used to link the instrument information to the associated platform. The ID should be unique within the metadata record.

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString

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)

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString="OperationalMode"

and

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString

<gmi:MI_Metadata>
  ...
  <gmi:acquisitionInformation>
    <gmi:MI_AcquisitionInformation>
      <gmi:instrument>

        <eos:EOS_Instrument id="dfdaa96ba-483d-4e63-86ad-5dfd0eedf496">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>MODIS</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.instrumentshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Moderate-Resolution Imaging Spectroradiometer</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmi:identifier>
          <gmi:type>
            <gco:CharacterString>Broadband scanning radiometry</gco:CharacterString>
          </gmi:type>
          <gmi:mountedOn xlink:href="#d36bb8fb0-d827-4fd1-a2e9-5db6778abddc"/>
          <eos:otherProperty>
            <gco:Record>
              <eos:AdditionalAttributes>
                <eos:AdditionalAttribute>
                  <eos:reference>
                    <eos:EOS_AdditionalAttributeDescription>
                      <eos:type>
                        <eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation">instrumentInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>SwathWidth</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The width of the sensor scan as the satellite moves along the ground track.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="INT">INT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Kilometers</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>2330</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </eos:otherProperty>
        </eos:EOS_Instrument>
      </gmi:instrument>
      <gmi:platform>
        <eos:EOS_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>Aqua</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Earth Observing System, Aqua</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmi:identifier>
          <gmi:description>
            <gco:CharacterString>Earth Observation Satellites</gco:CharacterString>
          </gmi:description>
          <gmi:instrument xlink:href="#dfdaa96ba-483d-4e63-86ad-5dfd0eedf496"/>
        </eos:EOS_Platform>
      </gmi:platform>
    </gmi:MI_AcquisitionInformation>
  </gmi:acquisitionInformation>
</gmi:MI_Metadata>

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "Aqua",
    LongName: "Earth Observing System, Aqua",
    Instruments: [
      {
        ShortName: "MODIS",
        LongName: "Moderate-Resolution Imaging Spectroradiometer",
        Technique: "Broadband scanning radiometry", 
        Characteristics: [
          {
            Name: "SwathWidth",
            Description: "The width of the sensor scan as the satellite moves along the ground track.",
            DataType: "INT",
            Unit: "Kilometers",
            Value: "2330",
          }
        ]
      }
    ]
  }
],

ISO 19115-2 SMAP

Instrument is an optional metadata element, however, it is strongly recommended that it be provided when possible. Multiple Instruments may be listed if necessary (Cardinality: 0..*).

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

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument id="<insert unique instrument ID here>"/ gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

with

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.instrumentshortname

Corresponds to the UMM field Platforms/Instruments/ShortName. A list of valid instrument short names can be found in the KMS under the 'Short_Name' column. For each instrument listed the short name is required by CMR. The short name value goes in the gmd:code field.

The value of " gov.nasa.esdis.umm.instrumentshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the instrument short name.

An ID should be provided directly after "eos:EOS_Instrument" in the ISO x-path. This ID corresponds to the instrument and is used to link the instrument information to the associated platform. The ID should be unique within the metadata record.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString

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)

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString="OperationalMode"

and

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString

<gmd:DS_Series>
<gmd:seriesMetadata>
<gmi:MI_Metadata>
  ...
  <gmi:acquisitionInformation>
    <gmi:MI_AcquisitionInformation>
      <gmi:instrument>

        <eos:EOS_Instrument id="dfdaa96ba-483d-4e63-86ad-5dfd0eedf496">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>MODIS</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.instrumentshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Moderate-Resolution Imaging Spectroradiometer</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmi:identifier>
          <gmi:type>
            <gco:CharacterString>Broadband scanning radiometry</gco:CharacterString>
          </gmi:type>
          <gmi:mountedOn xlink:href="#d36bb8fb0-d827-4fd1-a2e9-5db6778abddc"/>
          <eos:otherProperty>
            <gco:Record>
              <eos:AdditionalAttributes>
                <eos:AdditionalAttribute>
                  <eos:reference>
                    <eos:EOS_AdditionalAttributeDescription>
                      <eos:type>
                        <eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation">instrumentInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>SwathWidth</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The width of the sensor scan as the satellite moves along the ground track.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="INT">INT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Kilometers</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>2330</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </eos:otherProperty>
        </eos:EOS_Instrument>
      </gmi:instrument>

      <gmi:platform>
        <eos:EOS_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>Aqua</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Earth Observing System, Aqua</gco:CharacterString>
              </gmd:description>
            </gmd:MD_Identifier>
          </gmi:identifier>
          <gmi:description>
            <gco:CharacterString>Earth Observation Satellites</gco:CharacterString>
          </gmi:description>
          <gmi:instrument xlink:href="#dfdaa96ba-483d-4e63-86ad-5dfd0eedf496"/>
        </eos:EOS_Platform>
      </gmi:platform>
    </gmi:MI_AcquisitionInformation>
  </gmi:acquisitionInformation>
</gmi:MI_Metadata>
</gmd:seriesMetadata>
</gmd:DS_Series>

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "Aqua",
    LongName: "Earth Observing System, Aqua",
    Instruments: [
      {
        ShortName: "MODIS",
        LongName: "Moderate-Resolution Imaging Spectroradiometer",  
        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

UMM Migration

None

History

UMM Versioning

Future Mappings

ISO 19115-1

Instrument is an optional metadata element, however, it is strongly recommended that it be provided when possible. Multiple Instruments may be listed if necessary (Cardinality: 0..*).

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

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString

with

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.instrumentshortname

Corresponds to the UMM field Platforms/Instruments/ShortName. A list of valid instrument short names can be found in the KMS under the 'Short_Name' column. For each instrument listed the short name is required by CMR. The short name value goes in the gmd:code field.

The value of " gov.nasa.esdis.umm.instrumentshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the instrument short name.

An ID should be provided directly after "eos:EOS_Instrument" in the ISO x-path. This ID corresponds to the instrument and is used to link the instrument information to the associated platform. The ID should be unique within the metadata record.

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:description/gco:CharacterString

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)

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString="OperationalMode"

and

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString

Example Mapping

<mdb:MD_Metadata>
  ...
  <mdb:acquisitionInformation>
    <mac:MI_AcquisitionInformation>
      <mac:instrument>
        <mac:MI_Instrument id="dfdaa96ba-483d-4e63-86ad-5dfd0eedf496">
          <mac:identifier>
            <mcc:MD_Identifier>
              <mcc:code>
                <gco:CharacterString>MODIS</gco:CharacterString>
              </mcc:code>
              <mcc:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.instrumentshortname</gco:CharacterString>
              </mcc:codeSpace>
              <mcc:description>
                <gco:CharacterString>Moderate-Resolution Imaging Spectroradiometer</gco:CharacterString>
              </mcc:description>
            </mcc:MD_Identifier>
          </mac:identifier>
          <mac:type>
            <gco:CharacterString>Broadband scanning radiometry</gco:CharacterString>
          </mac:type>
          <mac:mountedOn xlink:href="#d36bb8fb0-d827-4fd1-a2e9-5db6778abddc"/>
          <mac:otherProperty>
            <gco:Record>
              <eos:AdditionalAttributes>
                <eos:AdditionalAttribute>
                  <eos:reference>
                    <eos:EOS_AdditionalAttributeDescription>
                      <eos:type>
                        <eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation">instrumentInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>SwathWidth</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The width of the sensor scan as the satellite moves along the ground track.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="INT">INT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Kilometers</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>2330</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </mac:otherProperty>
        </mac:MI_Instrument>
      </mac:instrument>
      <mac:platform>
        <mac:MI_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <mac:identifier>
            <mcc:MD_Identifier>
              <mcc:code>
                <gco:CharacterString>Aqua</gco:CharacterString>
              </mcc:code>
              <mcc:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </mcc:codeSpace>
              <mcc:description>
                <gco:CharacterString>Earth Observing System, Aqua</gco:CharacterString>
              </mcc:description>
            </mcc:MD_Identifier>
          </mac:identifier>
          <mac:description>
            <gco:CharacterString>Earth Observation Satellites</gco:CharacterString>
          </mac:description>
          <mac:instrument xlink:href="#dfdaa96ba-483d-4e63-86ad-5dfd0eedf496"/>
        </mac:MI_Platform>
      </mac:platform>
    </mac:MI_AcquisitionInformation>
  </mdb:acquisitionInformation>
</mdb:MD_Metadata>

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "Aqua",
    LongName: "Earth Observing System, Aqua",
    Instruments: [
      {
        ShortName: "MODIS",
        LongName: "Moderate-Resolution Imaging Spectroradiometer",  
        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

ARC Documentation