Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
stylecircle

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 are 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, and an estimate of the collection's entire downloadable file size, etc.

Best Practices

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)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 DescriptionAllows the data provider to provide added information about the provided Format.

Average File Size: An approximate average of the size of the 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 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 item. 

Examples:

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"


Element Specification

Cardinality of Archive and Distribution Information: 

ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-C

ArchiveAndDistributionInformation/ FileArchiveInformation/

Format
StringGCMD Granule Data Format vocabulary list1 - 80 characters
Yes1The format must be selected from the GCMD Granule Data Format vocabulary list.
UMM-CArchiveAndDistributionInformation/ FileArchiveInformation

Element Specification

Cardinality of Archive and Distribution Information: 

n/a

1 - 1024 characters

Common FileDistributionInformationMediaCommon FileDistributionInformationn/aCommon FileDistributionInformationEnumerationCommon FileDistributionInformationCommon FileDistributionInformationCommon FileDistributionInformationCommon FileDistributionInformation
ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/

Format
String1 - 80 characters
Yes1UMM-CommonArchiveAndDistributionInformation/ FileArchiveInformation/FormatTypeString

Native

Supported

n/aNo0..1UMM-CommonArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSizeDecimalYes, if TotalCollectionFileSizeBeginDate is used.0..1UMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSizeUnit

String

KB

MB

GB

TB

PB

NA

Yes, if AverageFileSize is used.
0..1UMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSize

DecimalNo0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDateUMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeUnit

Enumeration

KB

MB

GB

TB

PB

NA

n/aYes, if TotalCollectionFileSize is used0..1UMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeBeginDate

DateNo0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDateUMM-Common

ArchiveAndDistributionInformation/ FileArchiveInformation/ Description

Stringn/aNo0..1

ArchiveAndDistributionInformation/

FileDistributionInformation/Format

String1 - 80 charactersYes1

ArchiveAndDistributionInformation/

FileDistributionInformation/FormatType
String

Native

Supported

n/aNo0..1
UMM-CArchiveAndDistributionInformation/ FileArchiveInformation/FormatDescriptionStringn/a
1 - 80 charactersNo0..1
UMM-CArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSizeDecimaln/a



Yes, if TotalCollectionFileSizeBeginDate is used.0..1
UMM-C

ArchiveAndDistributionInformation/

FileArchiveInformation/ AverageFileSizeUnit

String

KB

MB

GB

TB

PB

NA


n/a

Yes, if AverageFileSize is used.
0..1
UMM-C

ArchiveAndDistributionInformation/

FileArchiveInformation/ TotalCollectionFileSize

Decimaln/a

No0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate
UMM-C

ArchiveAndDistributionInformation/

FileArchiveInformation/ TotalCollectionFileSizeUnit

Enumeration

KB

MB

GB

TB

PB

NA

n/aYes, if TotalCollectionFileSize is used0..1
UMM-C

ArchiveAndDistributionInformation/

FileArchiveInformation/ TotalCollectionFileSizeBeginDate

Date

No0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate
UMM-C

ArchiveAndDistributionInformation/

FileArchiveInformation/ Description

Stringn/a

1 - 1024 characters


No0..1
UMM-CommonC

ArchiveAndDistributionInformation/

FileDistributionInformation/FormatFees

Stringn/aGCMD Granule Data Format vocabulary list1 - 255 80 charactersNoYes0..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).

Lucidchartrich-viewerfalseautofittruenameCopy of Wiki Page Metadata Evaluation Workflow-1939-9df6e3ebwidth1102pages-to-displayid98e5dc28-3252-4209-953f-66f1378e1cf4alignLeftheight299

Please see the expandable sections below for flowchart details.

Expand
titleGCMD 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 field length is not greater than the maximum characters allowed for each sub-element.
    • Check that the field '/Instrument/NumberOfSensors' is an integer value.
Expand
titleCMR Validation
  • The specific instrument must be unique within the collection. The uniqueness is established by combining the instrument short name along with its characteristic's name.
  • The instrument short name must match with what is in the KMS.
  • If a granule has an instrument short name in it, it must match to one that is defined in the collection.
  • If removing an instrument from a collection, none of its granules can reference that instrument's short name.
Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

This element is categorized as highest priority when:

This element is categorized as medium priority when:

This element is categorized as low priority when:

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

ARC Automated Checks

  • TBD

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

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.

UMM-C ElementPathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotesPlatforms/Instruments/ShortName/DIF/Platform/Instrument/Short_Name
StringInstrument Short_Name Keywords

KMS controlled

Yes1For each instrument provided, a short name is required.Platforms/Instruments/LongName/DIF/Platform/Instrument/Long_NameStringInstrument Long_Name Keywords

KMS controlled

No0..1It is highly recommended that a long name be provided if one is available in KMS.Platforms/Instruments/Technique/DIF/Platform/Instrument/TechniqueString1 - 2048 charactersNo0..1Platforms/Instruments/NumberOfInstruments/DIF/Platform/Instrument/NumberOfSensorsIntegern/aNo0..1Platforms/Instruments/Characteristics/Name/DIF/Platform/Instrument/Characteristics/NameString1 - 80 charactersYes, if applicable1Only required if a characteristic is provided.Providing characteristics is optional.Platforms/Instruments/Characteristics/Description/DIF/Platform/Instrument/Characteristics/DescriptionString1 - 2048 charactersYes, if applicable1Only required if a characteristic is provided.Providing characteristics is optional.Platforms/Instruments/Characteristics/DataType/DIF/Platform/Instrument/Characteristics/DataTypeString1 - 80 charactersYes, if applicable1Only required if a characteristic is provided.Providing characteristics is optional.Platforms/Instruments/Characteristics/Unit/DIF/Platform/Instrument/Characteristics/UnitString1 - 20 charactersYes, if applicable1Only required if a characteristic is provided.Providing characteristics is optional.Platforms/Instruments/Characteristics/Value/DIF/Platform/Instrument/Characteristics/ValueString1 - 80 charactersYes, if applicable1Only required if a characteristic is provided.Providing characteristics is optional.Platforms/Instruments/OperationalModes/DIF/Platform/Instrument/OperationalModeString1 - 20 charactersNo0..*Example Mapping
Section
Column
width50%

DIF 10

No Format
<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>
Column
width50%

UMM

No Format
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",
          }
        ]
      }
    ]
  }
],
Expand
titleECHO 10

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.

1

The format must be selected from the GCMD Granule Data Format vocabulary list.

Recommend providing the data format in this element since this should specify the format data are being distributed in to the end user.

UMM-C

ArchiveAndDistributionInformation/

FileDistributionInformation/ FormatType

String

Native

Supported


No0..1
UMM-C

ArchiveAndDistributionInformation/

FileDistributionInformation/ FormatDescription

String


1 - 80 charactersNo0..1
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/

Media
Stringn/a

1 - 80 characters


No0..1
UMM-CArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSizeDecimaln/an/aYes, if TotalCollectionFileSizeBeginDate is used.0..1
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSizeUnit

Enumeration

KB

MB

GB

TB

PB

NA


Yes, if AverageFileSize is used.
0..1
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSize

Decimaln/a
No0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeUnit

Enumeration

KB

MB

GB

TB

PB

NA

n/aYes, if TotalCollectionFileSize is used0..1
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeBeginDate

Date

No0..1Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate
UMM-C

ArchiveAndDistributionInformation/ FileDistributionInformation/ Description

Stringn/a

1 - 1024 characters


No0..1
UMM-C

Fees

Stringn/a

1 - 255 characters


No0..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-viewerfalse
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-9df6e3eb
width1102
pages-to-display
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details.


Expand
titleGCMD Metadata QA/QC
  • Manual Review: TBD
  • Automated Review: TBD
Expand
titleCMR Validation
  • TBD
Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

Yellow = Medium Priority Finding

This element is categorized as medium priority when:

  • The Data Format provided is correct, but could be more specific. 
    • E.g. Providing 'ASCII' when the data format should be 'CSV'
  • A recommendation is made to add a data format to the existing list.

Blue = Low Priority Finding

Not Applicable

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
titleDIF 9

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

Expand
titleDIF 10

DIF 10

All of the sub-elements are optional in DIF 10. 

UMM-C ElementPathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes

ArchiveAndDistributionInformation/FileDistributionInformation/

Format
/DIF/Distribution/Distribution_Format
String



No0..1To ensure consistency, it is highly recommended that the format be selected from the GCMD Granule Data Format vocabulary list.
ArchiveAndDistributionInformation/FileDistributionInformation/FormatType/DIF/Distribution/Distribution_Format_TypeString

Native

Supported


No0..1This is a DIF 10.3 field. Currently in DIF 10.2 there is just one field called '/DIF/Distribution/Distribution_Format'
ArchiveAndDistributionInformation/FileDistributionInformation/Media/DIF/Distribution/Distribution_MediaString

No0..1
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSize/DIF/Distribution/Average_Granule_Size




This is a DIF 10.3 field. Currently in DIF 10.2 there is just one field called '/DIF/Distribution/Distribution_Size'
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSizeUnit/DIF/Distribution/Average_Granule_Size_UnitEnumeration

KB

MB

GB

TB

PB


No0..1This is a DIF 10.3 field. Currently in DIF 10.2 there is just one field called '/DIF/Distribution/Distribution_Size'
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSize/DIF/Distribution/Total_Collection_SizeDecimal

No0..1This is a DIF 10.3 field. Currently in DIF 10.2 there is just one field called '/DIF/Distribution/Distribution_Size'
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSizeUnit/DIF/Distribution/Distribution_Collection_Size_UnitEnumeration

KB

MB

GB

TB

PB


No0..1This is a DIF 10.3 field. Currently in DIF 10.2 there is just one field called '/DIF/Distribution/Distribution_Size'

ArchiveAndDistributionInformation/FileDistributionInformation/

Fees
/DIF/Distribution/FeesStringn/a
No0..1


Example Mapping

Section
Column
width50%

DIF 10

No Format
<Distribution>
  <Distribution_Media>Online Archive></Distribution_Media>
  <Average_Granule_Size>231</Average_Granule_Size> **Note: In DIF 10.2 this would appear as: <Distribution_Size>231 MB per file</Distribution_Size>
  <Average_Granule_Size_Unit>MB</Average_Granule_Size_Unit>
  <Distribution_Format>HDF-EOS5</Distribution_Format>
  <Distribution_Format_Type>Native</Distribution_Format_Type>  **Note: The Distribution_Format_Type field is not available in DIF 10.2
  <Fees>Free</Fees>
</Distribution>
Column
width50%

UMM

No Format
"ArchiveAndDistributionInformation": {
    "FileDistributionInformation": [
      {
        "FormatType": "Native",
        "AverageFileSize": 231,
        "Fees": "Free",
        "Format": "HDF-EOS",
        "AverageFileSizeUnit": "MB",
        "Media": [
          "Online Archive"
        ]
      }
    ]
  },
Expand
titleECHO 10

ECHO 10

Only 2 UMM-C Archive and Distribution Information sub-elements map to ECHO 10, Data Format and Fees, and neither element is required. 

UMM-C ElementPathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotes
ArchiveAndDistributionInformation/FileDistributionInformation/Format/DataFormatString

N/A

No0..1To ensure consistency, it is highly recommended that the format be selected from the GCMD Granule Data Format vocabulary list.
ArchiveAndDistributionInformation/FileDistributionInformation/Fees/PriceString

N/A

No0..1


Example Mapping

Section
Column
width50%

ECHO 10

No Format
<DataFormat>HDF-EOS5</DataFormat>
<Price>0.0</Price>
Column
width50%

UMM

No Format
"ArchiveAndDistributionInformation": {
  "FileDistributionInformation": [
    {
      "FormatType": "Native",
      "Fees": "0.0",
      "Format": "HDF-EOS5"
    }
  ]
},
Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

Archive and Distribution Information is an optional metadata element in ISO 19115-2 MENDS.


UMM-C ElementPathTypeNotes
ArchiveAndDistributionInformation/FileArchiveInformation/Format

[=> /gmd:name/gco:CharacterString

String


ArchiveAndDistributionInformation/FileArchiveInformation/FormatType

[=> /gmd:specification/gco:CharacterString = FormatType: <FormatType>

String
ArchiveAndDistributionInformation/FileArchiveInformation/AverageFileSize[=> /gmd:specification/gco:CharacterString = AverageFileSize: <AverageFileSize>Decimal
ArchiveAndDistributionInformation/FileArchiveInformation/AverageFileSizeUnit[=> /gmd:specification/gco:CharacterString = AverageFileSizeUnit: <AverageFileSizeUnit>String
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSize[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSize: <TotalCollectionFileSize>Decimal
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSizeUnit[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSizeUnit: <TotalCollectionFileSizeUnit>Enumeration
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSizeBeginDate[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSizeBeginDate: <TotalCollectionFileSizeBeginDate>Date
ArchiveAndDistributionInformation/FileArchiveInformation/Description[=> /gmd:specification/gco:CharacterString = Description: <Description>String


ArchiveAndDistributionInformation/FileDistributionInformation/Format[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:name/gco:CharacterStringString
ArchiveAndDistributionInformation/FileDistributionInformation/FormatType[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:specification/gmd:CharacterString = FormatType: <Native or Supported>String
ArchiveAndDistributionInformation/FileDistributionInformation/Media

[=> /gmd:transferOptions xlink:href="FileDistributionInformation_Media_<Block Number>"gmd:MD_DigitalTransferOptions/gmd:offLine/gmd:MD_Medium/gmd:name/gmd:MD_MediumNameCode

UMM-C ElementPathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotesPlatforms/Instruments/ShortName/Collection/Platforms/Platform/Instruments/Instrument/ShortNameStringInstrument Short_Name Keywords

KMS controlled

Yes1For each instrument provided, a short name is required.Platforms/Instruments/LongName/Collection/Platforms/Platform/Instruments/Instrument/LongNameStringInstrument Long_Name Keywords

KMS controlled

No0..1It is highly recommended that a long name be provided if one is available in KMS.Platforms/Instruments/TechniqueCollection/Platforms/Platform/Instruments/Instrument/TechniqueString1 - 2048 charactersNo0..1Platforms/Instruments/NumberOfInstrumentsCollection/Platforms/Platform/Instruments/Instrument/NumberOfSensorsIntegern/aNo0..1Platforms/Instruments/Characteristics/Name/Collection/Platforms/Platform/Instruments/Instrument/Characteristics/Characteristic/NameString1 - 80 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.Platforms/Instruments/Characteristics/Description/Collection/Platforms/Platform/Instruments/Instrument/Characteristics/Characteristic/DescriptionString1 - 2048 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.Platforms/Instruments/Characteristics/DataType/Collection/Platforms/Platform/Instruments/Instrument/Characteristics/Characteristic/DataType String1 - 80 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.Platforms/Instruments/Characteristics/Unit/Collection/Platforms/Platform/Instruments/Instrument/Characteristics/Characteristic/UnitString1 - 20 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.Platforms/Instruments/Characteristics/Value/Collection/Platforms/Platforms/Platform/Instruments/Instrument/Characteristics/Characteristic/ValueString1 - 80 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.Platforms/Instruments/OperationalModes/Collection/Platforms/Platform/Instruments/Instrument/OperationModes/OperationModeString1 - 20 charactersNo0..*Example Mapping
Section
Column
width50%

ECHO 10

No Format
<Platforms>
  <Platform>
    <ShortName>Aqua</ShortName>
    <LongName>Earth Observing System, Aqua</LongName>
    <Type>Earth Observation Satellites</Type>
    <Instruments>
      <Instrument>
        <ShortName>MODIS</ShortName>
        <LongName>Moderate-Resolution Imaging Spectroradiometer</LongName>    
        <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>
      </Instrument>
    </Instruments>
  </Platform>
</Platforms>
Column
width50%

UMM

No Format
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",
          }
        ]
      }
    ]
  }
],
Expand
titleISO 19115-2 MENDS

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.

UMM-C ElementPathTypeNotesPlatforms/Instruments/ShortName

/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

String

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.

Platforms/Instruments/LongName

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

StringCorresponds to the UMM field Platforms/Instruments/LongName. A list of valid instrument long names can be found in the KMS under the 'Long_Name' column.Platforms/Instruments/Technique/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:type/gco:CharacterString StringCorresponds to the UMM field Platforms/Instruments/Technique.Platforms/Instruments/NumberOfInstrumentsWhen translating to UMM-C the number of instruments is counted. The number is not translated to ISO 19115-2 MENDSCorresponds to the UMM field Platforms/Instruments/NumberOfInstruments./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:type/eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation" = instrumentInformationCodelistThe "instrumentInformation" codelist value must be provided so that CMR can properly identify the associated information as instrument characteristics. This codelist value does not directly map to a UMM elementchoosing 'instrumentInformation' indicates to CMR that the instrument characteristic elements should be mapped.Platforms/Instruments/Characteristics/Name/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:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Name.Platforms/Instruments/Characteristics/Description/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:description/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Description.Platforms/Instruments/Characteristics/DataType/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: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)

Platforms/Instruments/Characteristics/Unit/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:parameterUnitsOfMeasure/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Unit.Platforms/Instruments/Characteristics/Value/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Value.Platforms/Instruments/OperationalModes

/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

StringCorresponds to the UMM field Platforms/Instruments/OperationalMode. The eos:name field must read "OperationalMode" so that CMR can properly parse out the operation mode information. The actual operation mode value should be provided in the eos:value field. gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:mountedOn xlink:href='<insert unique platform ID here>'An ID should be provided here and should match the ID provided for the associated platform. This ID should be unique within a metadata record. This will link all of the information provided on the instrument to its associated platform.Example Mapping
Section
Column
width50%

ISO 19115-2 MENDS

No Format
<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>
Column
width50%

UMM

No Format
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",
          }
        ]
      }
    ]
  }
],
Expand
titleISO 19115-2 SMAP

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.

UMM-C ElementPathTypeNotesPlatforms/Instruments/ShortName

/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

String

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.

Platforms/Instruments/LongName

/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

StringCorresponds to the UMM field Platforms/Instruments/LongName. A list of valid instrument long names can be found in the KMS under the 'Long_Name' column.Platforms/Instruments/Technique/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:type/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Technique.Platforms/Instruments/NumberOfInstrumentsWhen translating to UMM-C the number of instruments is counted. The number is not translated to ISO 19115-2 MENDS
Corresponds to the UMM field Platforms/Instruments/NumberOfInstruments./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:type/eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation"=instrumentInformationCodelistThe "instrumentInformation" codelist value must be provided so that CMR can properly identify the associated information as instrument characteristics. This codelist value does not directly map to a UMM elementchoosing 'instrumentInformation' indicates to CMR that the instrument characteristic elements should be mapped.Platforms/Instruments/Characteristics/Name/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:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Name.Platforms/Instruments/Characteristics/Description/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:description/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Description.Platforms/Instruments/Characteristics/DataType/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: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)

Platforms/Instruments/Characteristics/Unit/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:parameterUnitsOfMeasure/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Unit.Platforms/Instruments/Characteristics/Value/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:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Value.Platforms/Instruments/OperationalModes

/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

StringCorresponds to the UMM field Platforms/Instruments/OperationalMode. The eos:name field must read "OperationalMode" so that CMR can properly parse out the operation mode information. The actual operation mode value should be provided in the eos:value field./gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/ gmi:mountedOn xlink:href='<insert unique platform ID here>'StringAn ID should be provided here and should match the ID provided for the associated platform. This ID should be unique within a metadata record. This will link all of the information provided on the instrument to its associated platform.Example Mapping
Section
Column
width50%

ISO 19115-2 SMAP

No Format
<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>

Column
width50%

UMM

No Format
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

Future Mappings

/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:dataType/eos:EOS_AdditionalAttributeDataTypeCode
Expand
titleISO 19115-1

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.

UMM-C ElementPathTypeNotes
Platforms/Instruments/ShortName

/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

String

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.

Platforms/Instruments/LongName

/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

StringCorresponds to the UMM field Platforms/Instruments/LongName. A list of valid instrument long names can be found in the KMS under the 'Long_Name' column.
Platforms/Instruments/Technique/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"mac:type/gco:CharacterString StringCorresponds to the UMM field Platforms/Instruments/Technique.
Platforms/Instruments/NumberOfInstrumentsWhen translating to UMM-C the number of instruments is counted. The number is not translated to ISO 19115-2 MENDSCorresponds to the UMM field Platforms/Instruments/NumberOfInstruments./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:type/eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation" = instrumentInformationCodelistThe "instrumentInformation" codelist value must be provided so that CMR can properly identify the associated information as instrument characteristics. This codelist value does not directly map to a UMM elementchoosing 'instrumentInformation' indicates to CMR that the instrument characteristic elements should be mapped.
Platforms/Instruments/Characteristics/Name/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:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Name.
Platforms/Instruments/Characteristics/Description/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:description/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Description.
Platforms/Instruments/Characteristics/DataType

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

DatatypeCode

MediumNameCode" 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)

Platforms/Instruments/Characteristics/Unit/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:parameterUnitsOfMeasure/gco:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Unit.Platforms/Instruments/Characteristics/Value/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:CharacterStringStringCorresponds to the UMM field Platforms/Instruments/Characteristics/Value.Platforms/Instruments/OperationalModes

/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

StringCorresponds to the UMM field Platforms/Instruments/OperationalMode. The eos:name field must read "OperationalMode" so that CMR can properly parse out the operation mode information. The actual operation mode value should be provided in the eos:value field. /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>/gmi:mountedOn xlink:href='<insert unique platform ID here>'An ID should be provided here and should match the ID provided for the associated platform. This ID should be unique within a metadata record. This will link all of the information provided on the instrument to its associated platform.

Example Mapping

"<value>" = <value>

String
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSize[=> /gmd:transferOptions xlink:href="FileDistributionInformation_AverageFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:unitsOfDistribution/gco:CharacterStringDecimal
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSizeUnit[=> /gmd:transferOptions xlink:href="FileDistributionInformation_AverageFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:unitsOfDistribution/gco:CharacterStringEnumeration
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSize[=> /gmd:transferOptions xlink:href="FileDistributionInformation_TotalCollectionFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:transferSize/gco:RealDecimal
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSizeUnit[=> /gmd:transferOptions xlink:href="FileDistributionInformation_TotalCollectionFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:unitsOfDistribution/gco:CharacterStringEnumeration
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSizeBeginDate[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:specification/gmd:CharacterString = TotalCollectionFileSizeBeginDate: <Date use MMDDYYYYTHH:MM:SSZ format>Date
ArchiveAndDistributionInformation/FileDistributionInformation/Description[=> /gmd:distributor xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterStringString
ArchiveAndDistributionInformation/FileDistributionInformation/Fees[=> /gmd:distributor xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:fees/gmd:CharacterStringString


Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
<gmi:MI_Metadata>
  ...
    <gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/>
        <gmd:MD_Format>
            <gmd:specification>
                <gco:CharacterString>TotalCollectionFileSizeBeginDate</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>2018-04-01T00:00:00Z</gco:CharacterString>
              </gmd:codeSpace>
            <gmd:specification>
          <gmd:MD_Format>
      <gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/>  
                

Column
width50%

UMM

No Format
ArchiveandDistributionInformation: [ 
  { 
     AverageFileSize: "250", 
  },
  { 
     AverageFileSizeUnit: "KB", 
  },
  { 
     TotalCollectionFileSizeBeginDate: "2018-04-01T00:00:00Z", 
  } 
],
                
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP

Archive and Distribution Information does not currently map to ISO 19115-2 SMAP.

UMM-C ElementPathTypeNotes
N/A

N/A

N/A

N/A


Example Mapping

Section
Column
width50%

N/A

Column
width50%

N/A

UMM Migration

None

Excerpt
hiddentrue

Future Mappings

ISO 19115-1

<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
Expand
titleISO 19115-1

ISO 19115-1


UMM-C ElementPathTypeNotes
ArchiveAndDistributionInformation/FileArchiveInformation/Format

[=> /gmd:name/gco:CharacterString

String


Platforms/Instruments/LongName

/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

String
ArchiveAndDistributionInformation/FileArchiveInformation/FormatType[=> /gmd:specification/gco:CharacterString = FormatType: <FormatType>String
ArchiveAndDistributionInformation/FileArchiveInformation/AverageFileSize[=> /gmd:specification/gco:CharacterString = AverageFileSize: <AverageFileSize>Decimal
ArchiveAndDistributionInformation/FileArchiveInformation/AverageFileSizeUnit[=> /gmd:specification/gco:CharacterString = AverageFileSizeUnit: <AverageFileSizeUnit>Enumeration
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSize[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSize: <TotalCollectionFileSize>Decimal
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSizeUnit[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSizeUnit: <TotalCollectionFileSizeUnit>Enumeration
ArchiveAndDistributionInformation/FileArchiveInformation/TotalCollectionFileSizeBeginDate[=> /gmd:specification/gco:CharacterString = TotalCollectionFileSizeBeginDate: <TotalCollectionFileSizeBeginDate>Date




ArchiveAndDistributionInformation/FileArchiveInformation/Description[=> /gmd:specification/gco:CharacterString = Description: <Description>String
ArchiveAndDistributionInformation/FileDistributionInformation/Format[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:name/gco:CharacterStringString
ArchiveAndDistributionInformation/FileDistributionInformation/FormatType

[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:specification/gmd:CharacterString = FormatType: <Native or Supported>

String
ArchiveAndDistributionInformation/FileDistributionInformation/Media[=> /gmd:transferOptions xlink:href="FileDistributionInformation_Media_<Block Number>"gmd:MD_DigitalTransferOptions/gmd:offLine/gmd:MD_Medium/gmd:name/gmd:MD_MediumNameCode
Section
Column
width50%
No Format
codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/
eosCodelists
gmxCodelists.xml#MD_MediumNameCode" codeListValue="<value>" = <value>String
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSize[=> /gmd:transferOptions xlink:href="FileDistributionInformation_AverageFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:transferSize/gco:RealDecimal
ArchiveAndDistributionInformation/FileDistributionInformation/AverageFileSizeUnit[=> /gmd:transferOptions xlink:href="FileDistributionInformation_AverageFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:unitsOfDistribution/gco:CharacterStringEnumeration
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSize[=> /gmd:transferOptions xlink:href="FileDistributionInformation_TotalCollectionFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:transferSize/gco:RealDecimal
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSizeUnit[=> /gmd:transferOptions xlink:href="FileDistributionInformation_TotalCollectionFileSize_<Block Number>"/gmd:MD_DigitalTransferOptions/gmd:unitsOfDistribution/gco:CharacterStringEnumeration
ArchiveAndDistributionInformation/FileDistributionInformation/TotalCollectionFileSizeBeginDate[=> /gmd:distributionFormat xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Format/gmd:specification/gmd:CharacterString = TotalCollectionFileSizeBeginDate: <Date use MMDDYYYYTHH:MM:SSZ format>Date
ArchiveAndDistributionInformation/FileDistributionInformation/Description[=> /gmd:distributor xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterStringString
ArchiveAndDistributionInformation/FileDistributionInformation/Fees[=> /gmd:distributor xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:fees/gmd:CharacterStringString

Example Mapping

Section
Column
width50%

ISO 19115-1

No Format
      <gmi:MI_Metadata>
  ...
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>
<gmd:specification>
     
<mac:instrument xlink:href="#dfdaa96ba-483d-4e63-86ad-5dfd0eedf496"/>
        
<
<gco:CharacterString>TotalCollectionFileSizeBeginDate</
mac
gco:
MI_Platform>
CharacterString>
     
</mac:platform>
    
</mac:MI_AcquisitionInformation>
  </
mdb:acquisitionInformation> </mdb:MD_Metadata>
Column
width50%

UMM

No Format
Platforms: [
gmd:code>
  
{
    
Type:
 
"Earth
 
Observation
 
Satellites",
    
ShortName
<gmd:
"Aqua",
codeSpace>
        
LongName:
 
"Earth
 
Observing
 
System,
 
Aqua",
    
Instruments: [
<gco:CharacterString>2018-04-01T00:00:00Z</gco:CharacterString>
      
{
        
ShortName: "MODIS",
</gmd:codeSpace>
            
LongName
<gmd:
"Moderate-Resolution Imaging Spectroradiometer",
specification>
      <gmi:MI_Metadata>
            
Characteristics
Column
width50%

UMM

No Format
ArchiveandDistributionInformation: [ 
  { 
    
{
AverageFileSize: "250", 
  },
  { 
    AverageFileSizeUnit: "KB", 
 
Name:
 
"SwathWidth"
},
  { 
    TotalCollectionFileSizeBeginDate: "2018-04-01T00:00:00Z", 
  
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.15.512/3/2020The description of the format elements now includes text about the controlled vocabulary for this field coming from KMS.
1.15.49/18/2020No changes were made for Archive and Distribution Information during the transition from version 1.15.3 to 1.15.4
1.15.37/1/2020FormatDescription was added to FileArchive and FileDistribution Information types to version 1.15.3
1.15.25/20/2020No changes were made for Archive and Distribution Information during the transition from version 1.15.1 to 1.15.2
1.15.13/25/2020No changes were made for Archive and Distribution Information during the transition from version 1.15.0 to 1.15.1
1.15.02/26/2020No changes were made for Archive and Distribution Information during the transition from version 1.14.0 to 1.15.0
1.14.010/21/2019No changes were made for Archive and Distribution Information during the transition from version 1.13.0 to 1.14.0

History

UMM Versioning

What Changed
VersionDate
1.13.004/11/2019This element was added to the UMM-C specification.

ARC Documentation

VersionDateWhat ChangedAuthor
1.005/16/18Recommendations/priority matrix transferred from internal ARC documentation to wiki space
1.104/12/21Moved "The data format provided is correct, however, it does not exactly match its entry in the GCMD Granule Data Format vocabulary list." from blue to red. GCMD keywords are now the authoritative controlled vocabulary source for data formats.  Jeanne' le Roux