Versions Compared

Key

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

Table of Contents
stylecircle

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

Lucidchart
rich-viewerfalse
autofittrue
nameCopy of Wiki Page Metadata Evaluation Workflow-1939-51df84
width1102
pages-to-display
id98e5dc28-3252-4209-953f-66f1378e1cf4
alignLeft
height299

Please see the expandable sections below for flowchart details. 


Expand
titleCMR Validation

<>

Expand
titleARC Metadata QA/QC

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 Rules

  • If no value is provided, return is "np."
  • Otherwise, return is "OK."

    Checks

    ARC uses the pyQuARC library for automated metadata checks. Please see the pyQuARC GitHub for more information. 

    Dialect Mappings

    Expand
    titleECHO 10

    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

    Section
    Column
    width50%

    ECHO 10

    No Format
    <PGEVersionClass>
      <PGEName>OMCLDO2 Level 2</PGEName>
      <PGEVersion>2.0.0.9</PGEVersion>
    </PGEVersionClass>
    Column
    width50%

    UMM

    No Format
    "PGEVersionClass": {
          "PGEName": "OMCLDO2 Level 2",
          "PGEVersion": "2.0.0.9"
      },
    Expand
    titleISO 19115-2 MENDS

    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

    Section
    Column
    width50%

    ISO 19115-2 MENDS

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

    UMM

    No Format
    "PGEVersionClass": {
          "PGEName": "OMCLDO2 Level 2",
          "PGEVersion": "2.0.0.9"
      },
    Expand
    titleISO 19115-2 SMAP

    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

    Section
    Column
    width50%

    ISO 19115-2 SMAP

    No Format
    N/A
    Column
    width50%

    UMM

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