Element Description

The PGE Version Class element stores basic descriptive characteristics related to the Product Generation Executable (PGE) associated with a granule. PGE refers to software used to produce a standard data product. 


Best Practices

There are two sub-elements that comprise PGE Version Class:

  • PGE Name: The name of the product generation executable.
  • PGE Version: Version of the product generation executable used to produce the granule.

Providing the PGE Version Class is optional. If provided, the Version number must be included - providing the PGE Name remains optional. 


Examples:

PGE Name: "MOD_PR10A2_8day_snow_cover_tile"

PGE Version: "6.0.27"

PGE Name: "OMCLDO2 Level 2"

PGE Version: "2.0.0.9"


Element Specification

The PGE Version Class element is optional. Only one PGE Version Class may be provided (Cardinality: 0..1)

ModelElementTypeConstraintsRequired?Cardinality
UMM-GPGEVersionClass/PGENameString

1 - 1024 characters

No0..1
UMM-GPGEVersionClass/PGEVersionString1 - 10 charactersYes, if applicable1



Metadata Validation and QA/QC

All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).

Please see the expandable sections below for flowchart details. 


<>

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

    • The information provided is incorrect for the granule.
    • A PGE Name is provided without an accompanying PGE Version.

Yellow = Medium Priority Finding

Not Applicable

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

ECHO 10

The PGE Version Class element is optional in ECHO 10. Only one PGE Version Class may be provided (Cardinality: 0..1)

UMM-G ElementECHO 10 PathTypeConstraintsRequired in ECHO10?Cardinality
PGEVersionClass/PGENamePGEVersionClass/PGENameString

1 - 1024 characters

No0..1
PGEVersionClass/PGEVersion
PGEVersionClass/PGEVersionString1 - 10 charactersYes, if applicable1


Example Mapping

ECHO 10

<PGEVersionClass>
  <PGEName>OMCLDO2 Level 2</PGEName>
  <PGEVersion>2.0.0.9</PGEVersion>
</PGEVersionClass>

UMM

"PGEVersionClass": {
      "PGEName": "OMCLDO2 Level 2",
      "PGEVersion": "2.0.0.9"
  },

ISO 19115-2 MENDS

The below table specifies where the CMR looks for PGE Version Class information in ISO. Only one PGE Version Class will be translated from ISO to the CMR (Cardinality: 0..1). Providing PGE Version class is optional, but if provided, should at a minimum include the PGE Version.

UMM-G ElementISO PathTypeNotes

PGEVersionClass/PGEName

PGEVersionClass/PGEVersion

(CMR read and write - use this ISO path to insure that the PGE Version Class will be translated from ISO to other CMR supported metadata dialects)*

/gmi:MI_Metadata/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:processStep/gmi:LE_ProcessStep [=>

[=>/gmd:description/gco:CharacterString = PGEVersionClass
[=>/gmi:processingInformation/eos:EOS_Processing/gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString = PGEName: {the actual PGEName} PGEVersion: {the actual PGEVersion}
[=>/gmi:processingInformation/eos:EOS_Processing/gmi:identifier/gmd:MD_Identifier/gmd:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.pgeversionclass
[=>/gmi:processingInformation/eos:EOS_Processing/gmi:identifier/gmd:MD_Identifier/gmd:description/gco:CharacterString = PGEVersionClass

(The below x-path is CMR write only. This means that metadata records that gets translated from another metadata format to ISO will have the PGE Version Class written to this location in ISO in addition to the read & write path specified above)

/gmi:MI_Metadata/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:processStep/gmi:LE_ProcessStep [=>

[=>/gmi:processingInformation/eos:EOS_Processing/gmi:softwareReference/gmd:CI_Citation/gmd:title/gco:CharacterString {PGEName}
[=>/gmi:processingInformation/eos:EOS_Processing/gmi:softwareReference/gmd:CI_Citation/gmd:date gco:nilReason="unknown"
[=>/gmi:processingInformation/eos:EOS_Processing/gmi:softwareReference/gmd:CI_Citation/gmd:edition/gco:CharacterString {PGEVersion}

String

For read & write:

Both the PGE Name and PGE Version should be provided in the gmd:code field. The PGE Name should be preceded by the prefix "PGEName: " and the PGE Version should be preceded by the prefix "PGEVersion: ". It is not necessary to use any symbols to separate the PGE Version and PGE Class - all that is needed is the prefix.

For write only:

Provide the PGE Name value in the gmd:title field. Provide the PGE Version in the gmd:edition field. The "gmd:date gco:nilReason="unknown" path is present because it is required by ISO, but is not needed by the CMR.


Example Mapping

ISO 19115-2 MENDS

Example 1: CMR read & write
<gmi:MI_Metadata>
 <gmd:dataQualityInfo>
   <gmd:DQ_DataQuality>
     <gmd:lineage>
       <gmd:LI_Lineage>
         <gmd:processStep>
           <gmi:LE_ProcessStep>
             <gmd:description>
               <gco:CharacterString>PGEVersionClass</gco:CharacterString>
             </gmd:description>
             <gmi:processingInformation>
               <eos:EOS_Processing>
                 <gmi:identifier>
                   <gmd:MD_Identifier>
                     <gmd:code>
                       <gco:CharacterString>PGEName:OMCLDO2 Level 2 PGEVersion:2.0.0.9</gco:CharacterString>
                     </gmd:code>
                     <gmd:codeSpace>
                       <gco:CharacterString>gov.nasa.esdis.umm.pgeversionclass</gco:CharacterString>
                     </gmd:codeSpace>
                     <gmd:description>
                       <gco:CharacterString>PGEVersionClass</gco:CharacterString>
                     </gmd:description>
                   </gmd:MD_Identifier>
                 </gmi:identifier> 
               </eos:EOS_Processing>
             </gmi:processingInformation>
           </gmi:LE_ProcessStep>
         </gmd:processStep>
       </gmd:LI_Lineage>
     </gmd:lineage>
   </gmd:DQ_DataQuality>
 </gmd:dataQualityInfo>
</gmi:MI_Metadata>

Example 2: CMR write only
<gmi:MI_Metadata>
  <gmd:dataQualityInfo>
    <gmd:DQ_DataQuality>
      <gmd:lineage>
        <gmd:LI_Lineage>
          <gmd:processStep>
            <gmi:LE_ProcessStep>

              <gmi:processingInformation>
                <eos:EOS_Processing>
                  <gmi:softwareReference>
                    <gmd:CI_Citation>
                      <gmd:title>
                        <gco:CharacterString>OMCLDO2 Level 2</gco:CharacterString>
                      </gmd:title>
                      <gmd:date gco:nilReason="unknown"/>
                      <gmd:edition>
                        <gco:CharacterString>2.0.0.9</gco:CharacterString>
                      </gmd:edition>
                    </gmd:CI_Citation>
                  </gmi:softwareReference>
                </eos:EOS_Processing>
              </gmi:processingInformation>
            </gmi:LE_ProcessStep>
          </gmd:processStep>
        </gmd:LI_Lineage>
      </gmd:lineage>
    </gmd:DQ_DataQuality>
  </gmd:dataQualityInfo>
</gmi:MI_Metadata>

UMM

"PGEVersionClass": {
      "PGEName": "OMCLDO2 Level 2",
      "PGEVersion": "2.0.0.9"
  },

ISO 19115-2 SMAP

PGE Version Class currently does not map to ISO 19115-2 SMAP.

UMM-G ElementISO PathTypeNotes
PGEVersionClass

N/A

N/A

N/A


Example Mapping

ISO 19115-2 SMAP

N/A

UMM

N/A

UMM Migration

UMM Version 1.4.0Translation DirectionUMM Version 1.5.0




History

UMM Versioning

VersionDateWhat Changed
1.6.011/4/2019No changes were made for PGE Version Class during the transition from version 1.5.0 to 1.6.0.
1.5.001/30/2019No changes were made for PGE Version Class during the transition from version 1.4.0 to 1.5.0.
1.4.008/01/2018No changes were made for PGE Version Class during the transition from version 1.3.0 to 1.4.0.

ARC Documentation

VersionDateWhat ChangedAuthor
1.004/11/2019Recommendations/priority matrix transferred from internal ARC documentation to wiki space
  • No labels