Element Description

The platform elements enable the specification of platforms used to collect the data available in the dataset. Platforms provided in CMR metadata must be chosen from a controlled keyword hierarchy maintained in the Keyword Management System (KMS). A list of valid platform keywords can be found here: https://gcmd.earthdata.nasa.gov/kms/concepts/concept_scheme/platforms?format=csv

Optionally, attributes specific to the platform (such as equator crossing time, inclination angle, orbital period, etc.) may be specified in the characteristics elements. Please see the Characteristics wiki page for a detailed description of the characteristics sub-elements. 

Best Practices

Platform keywords are important for the discovery of data. All relevant platforms should be listed for each dataset. It is preferred that more specific platform keyword terms be chosen from the KMS when available. For example, if data were collected from the NASA DC-8 aircraft, it is preferred that "NASA DC-8" be listed as the platform as opposed to the more generic "AIRCRAFT" keyword. If a particular platform 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.

In the KMS, there is a hierarchy for platform keywords. Platform keywords should be provided in the metadata field corresponding to the appropriate position of the keyword hierarchy, otherwise the keyword will be rendered invalid. For example, the platform short name specified in the KMS should not be provided in the platform 'long name' field in the metadata. When listing platforms, a platform short name will always be required. While platform long names are not required, it is highly encouraged that long names be provided if one is listed in the KMS. Many platform short names are comprised of acronyms, so inclusion of the long name provides additional context to a user who may not be familiar with the acronym. Platform keywords are not case sensitive.

It is recommended that platform keywords be assigned in a consistent manner. For example, if data for several collections were collected by the "LANDSAT-8" satellite, it is recommended that the metadata for all of those collections list "LANDSAT-8" as the platform short name. Providing "LANDSAT-8" as the platform in some records, but the more generic "LANDSAT" as the platform in other records, results in an inconsistent experience for a user discovering data. This is especially true for users narrowing down their search results in the Earthdata Search client by using the faceted search options. 

In the case that it does not make sense to provide a platform for a dataset, "Not Applicable" is an accepted value.     

        

Examples (ShortName > LongName):

Terra > Earth Observing System, Terra (AM-1)

METOP-A > Meteorological Operational Satellite - A

VIC-LSM > Variable Infiltration Capacity (VIC) Land Surface Model

MESONET > Mesoscale Meteorological Network

BE-200 > Beechcraft King Air BE-200


Element Specification

Platform is a required element. A minimum of 1 Platform must be provided. Multiple Platforms may also be provided if necessary (Cardinality: 1..*).

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

ModelElementTypeUsable Valid ValuesConstraintsRequired?CardinalityNotes
UMM-CommonPlatforms/TypeStringPlatform Category Keywords

KMS controlled

No0..1
UMM-CommonPlatforms/ShortNameStringPlatform Short_Name KeywordsKMS controlled
Yes1
UMM-CommonPlatforms/LongNameStringPlatform Long_Name KeywordsKMS controlledNo0..1
UMM-CommonPlatforms/Characteristics/NameStringn/a

1 - 80 characters


Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
UMM-CommonPlatforms/Characteristics/DescriptionStringn/a1 - 80 charactersYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
UMM-CommonPlatforms/Characteristics/DataTypeEnumeration

STRING

FLOAT

INT

BOOLEAN

DATE

TIME

DATETIME

DATE_STRING

TIME_STRING

DATETIME_STRING

n/aYes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
UMM-CommonPlatforms/Characteristics/UnitStringn/a

1 - 20 characters


Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.
UMM-CommonPlatforms/Characteristics/ValueStringn/a

1 - 80 characters


Yes, if applicable1Only required if a characteristic is listed. Providing characteristics is optional.

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 value is given. This is needed partly because the CMR still allows a non UMM compliant record to be ingested with warnings.

NOT PROVIDED  - DIF 10 records found to be missing platforms by software will be automatically assigned a value of "Not Provided". It should then be confirmed whether a platform 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.


  • 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.
  • The specific platform must be unique within the collection. The uniqueness is established by combining the platform short name along with its characteristic's name and value.
  • The platform short name must match with what is in the KMS.
  • If a granule has a platform short name in it, it must match to one that is defined in the collection.
  • If removing a platform from a collection, none of its granules can reference that platform's short name.

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

  • No Platform Short Name is provided.
  • The platform keyword does not align with the KMS.
    • The platform keyword does not exist in the KMS.
    • A keyword(s) is placed in the incorrect position of the hierarchy (e.g. the Platform Short Name is placed in the Long Name field).
    • Keywords from two different KMS hierarchies are listed in the same hierarchy in the metadata (hierarchies cannot be mixed and matched).
  • Not all relevant platforms are listed.
  • An incorrect platform is listed.
  • A recommendation is made to replace a valid platform with a more specific/appropriate platform keyword.
  • Please see the Characteristics wiki page for high priority findings related to the Platform/Characteristics sub-elements.

Yellow = Medium Priority Finding

This element is categorized as medium priority when:

Blue = Low Priority Finding

This element is categorized as low priority when:

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

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

DIF 10

Platform is a required element. A minimum of 1 Platform must be provided. Multiple Platforms may also be provided if necessary (Cardinality: 1..*).

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

UMM-C ElementDIF 10 PathTypeUsable Valid ValuesConstraintsRequired in DIF 10?CardinalityNotes
Platforms/Type

Platform/Type

String

Platform Category KeywordsKMS controlled

Yes

1

Corresponds to the Platform 'Category' keywords in KMS.

Platforms/ShortNamePlatform/Short_Name
StringPlatform Short_Name Keywords

KMS controlled

Yes1For each platform provided, a short name is required.
Platforms/LongNamePlatform/Long_NameStringPlatform Long_Name Keywords

KMS controlled

No0..1It is highly recommended that a long name be provided if one is available in KMS.
Platforms/Characteristics/NamePlatform/Characteristics/NameString
1 - 80 charactersYes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/DescriptionPlatform/Characteristics/DescriptionString
1 - 2048 charactersYes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/DataTypePlatform/Characteristics/DataTypeString
1 - 80 charactersYes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/UnitPlatform/Characteristics/UnitString
1 - 20 charactersYes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/ValuePlatform/Characteristics/ValueString
1 - 80 charactersYes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.


Example Mapping

DIF 10

<Platform>
  <Type>Earth Observation Satellites</Type>
  <Short_Name>ICESat</Short_Name>
  <Long_Name>Ice, Cloud and Land Elevation Satellite</LongName>
  <Characteristics>
    <Name>OrbitInclination</Name>
    <Description>The angle between the orbit plane and the Earth's equatorial plane.</Description>
    <DataType>FLOAT</DataType>
    <Unit>Degrees</Unit>
    <Value>94.0</Value>
  </Characteristics>
............
</Platform>

UMM

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "ICESat",
    LongName: "Ice, Cloud and Land Elevation Satellite",
    Characteristics: [
      {
        Name: "OrbitInclination",
        Description: "The angle between the orbit plane and the Earth's equatorial plane.",
        DataType: "FLOAT",
        Unit: "Degrees",
        Value: "94.0"
      }
    ]
    .............
  }
]

ECHO 10

Platform is an optional element in ECHO10, however, it is required in the UMM. Therefore it is strongly recommended that a Platform be provided if possible. Multiple Platforms may also be provided if necessary (Cardinality: 0..*).

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

UMM-C ElementECHO 10 PathTypeUsable Valid ValuesConstraintsRequired in ECHO10?CardinalityNotes
Platforms/Type/Collection/Platforms/Platform/TypeStringPlatform Category Keywords

KMS controlled

Yes, if applicable1Corresponds to the Platform 'Category' keywords in KMS.
Platforms/ShortName/Collection/Platforms/Platform/ShortNameStringPlatform Short_Name Keywords

KMS controlled

Yes, if applicable1

For each platform provided, a short name is required.

Corresponds to the 'Short_Name' keywords in KMS.

Platforms/LongName/Collection/Platforms/Platform/LongNameStringPlatform Long_Name KeywordsKMS controlledNo0..1

It is highly recommended that a long name be provided if one is available in KMS.

Corresponds to the 'Long_Name' keywords in KMS.

Platforms/Characteristics/Name/Collection/Platforms/Platform/Characteristics/Characteristic/NameString

Yes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/Description/Collection/Platforms/Platform/Characteristics/Characteristic/DescriptionString

Yes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/DataType/Collection/Platforms/Platform/Characteristics/Characteristic/DataType String

Yes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/Unit/Collection/Platforms/Platform/Characteristics/Characteristic/UnitString

Yes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.
Platforms/Characteristics/Value/Collection/Platforms/Platform/Characteristics/Characteristic/ValueString

Yes, if applicable1Only required if a characteristic is provided. Providing characteristics is optional.


Example Mapping

ECHO 10

<Platforms>
  <Platform>
    <Type>Earth Observation Satellites</Type>
    <ShortName>ICESat</ShortName>
    <LongName>Ice, Cloud and Land Elevation Satellite</LongName>
    <Characteristics>
      <Characteristic>
        <Name>OrbitInclination</Name>
        <Description>The angle between the orbit plane and the Earth's equatorial plane.</Description>
        <DataType>FLOAT</DataType>
        <Unit>Degrees</Unit>
        <Value>94.0</Value>
      </Characteristic>
    </Characteristics>
............
  </Platform>
</Platforms>

UMM

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "ICESat",
    LongName: "Ice, Cloud and Land Elevation Satellite",
    Characteristics: [
      {
        Name: "OrbitInclination",
        Description: "The angle between the orbit plane and the Earth's equatorial plane.",
        DataType: "FLOAT",
        Unit: "Degrees",
        Value: "94.0"
      }
    ]
    .............
  }
]

ISO 19115-2 MENDS

Platform is a required element. A minimum of 1 Platform must be provided. Multiple Platforms may also be provided if necessary (Cardinality: 1..*).

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

UMM-C Element

ISO 19115-2 MENDS Path

TypeNotes
Platforms/Type

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform id="<insert unique instrument ID here>"/ gmd:description/gco:CharacterString

String


Values should be selected from the platform 'Category' keywords in KMS.

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

Platforms/ShortName

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

with

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.platformshortname

String

A list of valid platform short names can be found in the KMS under the 'Short_Name' column. For each platform 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.platformshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the platform short name.

Platforms/LongName/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterStringStringA list of valid platform long names can be found in the KMS under the 'Long_Name' column.

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ 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="platformInformation"=platformInformationCodelistThe "platformInformation" codelist value must be provided so that CMR can properly identify the associated information as platform characteristics. This codelist value does not directly map to a UMM element - choosing 'platformInformation' indicates to CMR that the platform characteristic elements should be mapped.
Platforms/Characteristics/Name/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterStringString
Platforms/Characteristics/Description/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterStringString
Platforms/Characteristics/DataType/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ 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

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/Characteristics/Unit/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterStringString
Platforms/Characteristics/Value/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterStringString

/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/gmi:instrument xlink:href=<insert unique instrument ID here>'StringAn ID should be provided here and should match the ID provided for the associated instrument. This ID should be unique within a metadata record. This will link all of the information provided on the platform to its associated instrument.


Example Mapping

ISO 19115-2 MENDS

<gmi:MI_Metadata>
  ...
  <gmi:acquisitionInformation>
    <gmi:MI_AcquisitionInformation>
      ...
      <gmi:platform>
        <eos:EOS_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>ICESat</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Ice, Cloud and Land Elevation Satellite</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: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="platformInformation">platformInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>OrbitInclination</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The angle between the orbit plane and the Earth's equatorial plane.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="FLOAT">FLOAT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Degrees</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>94.0</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </eos:otherProperty>
          ...
        </eos:EOS_Platform>
      </gmi:platform>
    </gmi:MI_AcquisitionInformation>
  </gmi:acquisitionInformation>
</gmi:MI_Metadata>

UMM

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "ICESat",
    LongName: "Ice, Cloud and Land Elevation Satellite",
    Characteristics: [
      {
        Name: "OrbitInclination",
        Description: "The angle between the orbit plane and the Earth's equatorial plane.",
        DataType: "FLOAT",
        Unit: "Degrees",
        Value: "94.0"
      }
    ]
    .............
  }
]



ISO 19115-2 SMAP

Platform is a required element. A minimum of 1 Platform must be provided. Multiple Platforms may also be provided if necessary (Cardinality: 1..*).

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

UMM-C Element

ISO 19115-2 SMAP Path

TypeNotes
Platforms/Type

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform id="<insert unique instrument ID here>"/ gmd:description/gco:CharacterString

String


Values should be selected from the platform 'Category' keywords in KMS.

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


Platforms/ShortName

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString

with

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.platformshortname

String

A list of valid platform short names can be found in the KMS under the 'Short_Name' column. For each platform 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.platformshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the platform short name.

Platforms/LongName/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ gmi:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterStringStringA list of valid platform long names can be found in the KMS under the 'Long_Name' column.

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ 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="platformInformation"=platformInformationCodelistThe "platformInformation" codelist value must be provided so that CMR can properly identify the associated information as platform characteristics. This codelist value does not directly map to a UMM element - choosing 'platformInformation' indicates to CMR that the platform characteristic elements should be mapped.
Platforms/Characteristics/Name/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterStringString
Platforms/Characteristics/Description/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterStringString
Platforms/Characteristics/DataType/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ 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

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/Characteristics/Unit/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterStringString
Platforms/Characteristics/Value/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/ /eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterStringString

/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/eos:EOS_Platform/gmi:instrument xlink:href=<insert unique instrument ID here>'StringAn ID should be provided here and should match the ID provided for the associated instrument. This ID should be unique within a metadata record. This will link all of the information provided on the platform to its associated instrument.


Example Mapping

ISO 19115-2 SMAP

<gmd:DS_Series>
<gmd:seriesMetadata>
<gmi:MI_Metadata>
  ...
  <gmi:acquisitionInformation>
    <gmi:MI_AcquisitionInformation>
      ...
      <gmi:platform>
        <eos:EOS_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <gmi:identifier>
            <gmd:MD_Identifier>
              <gmd:code>
                <gco:CharacterString>ICESat</gco:CharacterString>
              </gmd:code>
              <gmd:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </gmd:codeSpace>
              <gmd:description>
                <gco:CharacterString>Ice, Cloud and Land Elevation Satellite</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: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="platformInformation">platformInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>OrbitInclination</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The angle between the orbit plane and the Earth's equatorial plane.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="FLOAT">FLOAT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Degrees</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>94.0</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </eos:otherProperty>
          ...
        </eos:EOS_Platform>
      </gmi:platform>
    </gmi:MI_AcquisitionInformation>
  </gmi:acquisitionInformation>
</gmi:MI_Metadata>
</gmd:seriesMetadata>
</gmd:DS_Series>

UMM

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "ICESat",
    LongName: "Ice, Cloud and Land Elevation Satellite",
    Characteristics: [
      {
        Name: "OrbitInclination",
        Description: "The angle between the orbit plane and the Earth's equatorial plane.",
        DataType: "FLOAT",
        Unit: "Degrees",
        Value: "94.0"
      }
    ]
    .............
  }
]



UMM Migration

None

Future Mappings

ISO 19115-1

Platform is a required element. A minimum of 1 Platform must be provided. Multiple Platforms may also be provided if necessary (Cardinality: 1..*).

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

UMM-C Element

ISO 19115-1 Path

TypeNotes
Platforms/Type

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform id="<insert unique instrument ID here>"/ mac:description/gco:CharacterString

String


Values should be selected from the platform 'Category' keywords in KMS.

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


Platforms/ShortName

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/ mac:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString

with

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/ mac:identifier/mcc:MD_Identifier/mcc:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.platformshortname

String

A list of valid platform short names can be found in the KMS under the 'Short_Name' column. For each platform 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.platformshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the platform short name.

Platforms/LongName/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/ mac:identifier/mcc:MD_Identifier/mcc::description/gco:CharacterStringStringA list of valid platform long names can be found in the KMS under the 'Long_Name' column.

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

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="platformInformation"=platformInformation


CodelistThe "platformInformation" codelist value must be provided so that CMR can properly identify the associated information as platform characteristics. This codelist value does not directly map to a UMM element - choosing 'platformInformation' indicates to CMR that the platform characteristic elements should be mapped.
Platforms/Characteristics/Name

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString

String
Platforms/Characteristics/Description

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterString

String
Platforms/Characteristics/DataType

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac: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

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/Characteristics/Unit

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterString

String
Platforms/Characteristics/Value

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString

String

/mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:platform/mac:MI_Platform/

mac:instrument xlink:href=<insert unique instrument ID here>'

StringAn ID should be provided here and should match the ID provided for the associated instrument. This ID should be unique within a metadata record. This will link all of the information provided on the platform to its associated instrument.

Example Mapping

ISO 19115-1

<mdb:MI_Metadata>
  ...
  <mdb:acquisitionInformation>
    <mac:MI_AcquisitionInformation>
      ...
      <mac:platform>
        <mac:MI_Platform id="d36bb8fb0-d827-4fd1-a2e9-5db6778abddc">
          <mac:identifier>
            <mcc:MD_Identifier>
              <mcc:code>
                <gco:CharacterString>ICESat</gco:CharacterString>
              </mcc:code>
              <mcc:codeSpace>
                <gco:CharacterString>gov.nasa.esdis.umm.platformshortname</gco:CharacterString>
              </mcc:codeSpace>
              <mcc:description>
                <gco:CharacterString>Ice, Cloud and Land Elevation Satellite</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: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="platformInformation">platformInformation</eos:EOS_AdditionalAttributeTypeCode>
                      </eos:type>
                      <eos:name>
                        <gco:CharacterString>OrbitInclination</gco:CharacterString>
                      </eos:name>
                      <eos:description>
                        <gco:CharacterString>The angle between the orbit plane and the Earth's equatorial plane.</gco:CharacterString>
                      </eos:description>
                      <eos:dataType>
                        <eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/eosCodelists.xml#EOS_AdditionalAttributeDataTypeCode" codeListValue="FLOAT">FLOAT</eos:EOS_AdditionalAttributeDataTypeCode>
                      </eos:dataType>
                      <eos:parameterUnitsOfMeasure>
                        <gco:CharacterString>Degrees</gco:CharacterString>
                      </eos:parameterUnitsOfMeasure>
                    </eos:EOS_AdditionalAttributeDescription>
                  </eos:reference>
                  <eos:value>
                    <gco:CharacterString>94.0</gco:CharacterString>
                  </eos:value>
                </eos:AdditionalAttribute>
              </eos:AdditionalAttributes>
            </gco:Record>
          </mac:otherProperty>
          ...
        </mac:MI_Platform>
      </mac:platform>
    </mac:MI_AcquisitionInformation>
  </mdb:acquisitionInformation>
</mdb:MI_Metadata>

UMM

Platforms: [
  {
    Type: "Earth Observation Satellites",
    ShortName: "ICESat",
    LongName: "Ice, Cloud and Land Elevation Satellite",
    Characteristics: [
      {
        Name: "OrbitInclination",
        Description: "The angle between the orbit plane and the Earth's equatorial plane.",
        DataType: "FLOAT",
        Unit: "Degrees",
        Value: "94.0"
      }
    ]
    .............
  }
]

History

UMM Versioning

VersionDateWhat Changed
1.15.512/3/2020No changes were made for Platform during the transition from version 1.15.4 to 1.15.5
1.15.49/18/2020No changes were made for Platform during the transition from version 1.15.3 to 1.15.4
1.15.37/1/2020No changes were made for Platform during the transition from version 1.15.2 to 1.15.3
1.15.25/20/2020No changes were made for Platform during the transition from version 1.15.1 to 1.15.2
1.15.13/25/2020No changes were made for Platform during the transition from version 1.15.0 to 1.15.1
1.15.02/26/2020No changes were made for Platform during the transition from version 1.14.0 to 1.15.0
1.14.010/21/2019No changes were made for Platform during the transition from version 1.13.0 to 1.14.0
1.13.004/11/2019No changes were made for Platform during the transition from version 1.12.0 to 1.13.0
1.12.001/22/2019No changes were made for Platform during the transition from version 1.11.0 to 1.12.0.
1.11.011/28/2018No changes were made for Platform during the transition from version 1.10.0 to 1.11.0.
1.10.005/02/2018No changes were made for Platform during the transition from version 1.9.0 to 1.10.0.

ARC Documentation

VersionDateWhat ChangedAuthor
1.005/14/2018Recommendations/priority matrix transferred from internal ARC documentation to wiki space