Versions Compared

Key

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

Table of Contents
stylecircle

Element Description

The Version element indicates the version of the collection. The short name and version combination must be unique across the CMR.dataset. 

Best Practices

The version should be identical consistent throughout the metadata record. The version in the metadata should be identical to the version as is specified on the dataset landing page and in dataset documentation. For example, if the dataset landing page specifies the dataset as version 1.1, then the version number in the metadata should also be 1.1 (e.g. not 1.10). If the version in the title is specified as 3.4.2004 then the version in the metadata should also be 3.4.2004 (e.g. not 03.04.2004).     

The Data Product Development Guide for Data Producers offers the following information about versioning:

"The global attribute product_version is used to distinguish between versions of a given data
product (e.g., produced using different processing algorithms or updates to calibration parameters).
It is particularly important for users to know if they will acquire the latest version of a data product.

It is highly recommended to represent the data product version with an ordinal identifier (e.g., 1, 2,
3, etc.) that expresses its position in a series of data product publications. The data product version
can be represented with both a major and minor version identifier (e.g., 2.1, 2.2, etc.). A minor
version is used to identify selected files associated with a limited reprocessing of data (e.g., changes
around a data anomaly that did not affect the rest of the data product). A change that affects the
whole data product (e.g., complete reprocessing) would be considered a major version change.
Guidance for setting version numbers should be sought from the DAAC hosting the data. Some
guidance by the DIWG regarding version numbers can be found in [26] (Rec. 3.10). Whatever
versioning scheme is used, it is understood that all files in a given data product were produced in a
consistent manner.

Periodic reprocessing of data products can produce new versions with a distinct data product
identifier. In general, data that are sufficiently different should be organized into separate data
products. When data are reprocessed, the data producer must distinguish between major and minor
version changes. Also, the nature of changes and the records to which they apply should be
described for every version. In practice, a DAAC may choose to combine different minor versions of
data into a single major version of a data product in the archive and only advance to the next major
version upon reprocessing of the entire data product.
If possible, it is useful to use the same version for the data product as for the algorithm software
used to generate the product (e.g., PGEVersion), to avoid confusing the data product users."

Examples:

"2.0"

"1"

"007"


Element Specification

ModelElementTypeConstraintsRequired?Cardinality
UMM-CVersionString

? maximum number of characters

Yes1

1 - 80 characters

Yes1


Note: The short name and version combination must be unique across the CMR.


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-9cf7421b
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
    • Check that the version value is appropriate for the dataset.
  • Automated Review
    • Check that the field has been populated.
    • Check that the field length is not greater than 80 characters.
Expand
titleCMR Validation
  • This element is required
  • Must contain at least 1 character and be no longer than 80 characters in length
  • The ShortName together with the Version must be unique per data provider
Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

  • The element is not included at all.
  • The element is included but is empty.
    • No Version is provided. 
    • The Version
    The version
    • is incorrect for the
    associated data
    • dataset.

    Not applicable

    Yellow = Medium Priority Finding

    Not Applicable

    Blue = Low Priority Finding

    Not Applicable

    Green = No Findings/Issues

    Not applicable

    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

    UMM-C ElementDIF 10
    Specification
    PathTypeConstraintsRequired in DIF 10?CardinalityNotes
    DIF 10
    Version
    /DIF/

    Entry_ID/Version

    String

    1 - 80 characters

    Yes

    1

    Version and

    Entry

    Short_

    Title

    Name must be unique for a provider.

    Enumeration Mapping

    N/A

    Example Mapping

    Section
    Column
    width50%

    DIF 10

    No Format
    <Entry_ID>
      <Version>2.0</Version>
    </Entry_ID>
    Column
    width50%

    UMM

    No Format
    "Version" : "2.0",
    Expand
    titleECHO 10

    ECHO 10

    UMM-C Element

    ECHO 10 

    Specification

    Path

    TypeConstraintsRequired in ECHO10?CardinalityNotes
    ECHO 10
    Version/Collection/VersionIdString
    Yes1


    Enumeration Mapping

    N/A

    Example Mapping

    Section
    Column
    width50%

    ECHO 10

    No Format
    <VersionId>2.0</VersionId>
    Column
    width50%

    UMM

    No Format
    "Version" : "2.0",



    Expand
    titleISO 19115-2 MENDS

    ISO 19115-2 MENDS

    UMM-C Element

    ISO 19115-2 MENDS 

    Specification

    Path

    TypeNotes
    ISO 19115-2 MENDS
    Version

    /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:edition/gco:CharacterString


    String

    This field is not required by the ISO schema, however, it is required in the CMR.

    Enumeration/Code List Mapping

    N/A

    Example Mapping

    Section
    Column
    width50%

    ISO 19115-2 MENDS

    No Format
    <gmi:MI_Metadata>
      ...
      <gmd:identificationInfo>
        <gmd:MD_DataIdentification>
          <gmd:citation>
            <gmd:CI_Citation>  
              ... 
              <gmd:edition>
                <gco:CharacterString>2.0</gco:CharacterString>
              </gmd:edition>
              ...
            </gmd:CI_Citation>
          </gmd:citation>
         ...
        </gmd:MD_DataIdentification>
      </gmd:identificationInfo>
      ...
    </gmi:MI_Metadata>
    Column
    width50%

    UMM

    No Format
    "Version" : "2.0",



    Expand
    titleISO 19115-2 SMAP

    ISO 19115-2 SMAP

    UMM-C Element

    ISO 19115-2 SMAP 

    Specification

    Path

    TypeNotes
    ISO 19115-2 SMAP
    Version

    /gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/

    gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/ [=>

    [=>gmd:code/gco:CharacterString
    with
    [=>gmd:description/gco:CharacterString="The ECS Version ID"

    StringThis field is not required by the ISO schema, however, it is required in the CMR.

    Enumeration/Code List Mapping

    N/A

    Example Mapping

    Section
    Column
    width50%

    ISO 19115-2 SMAP

    No Format
    <gmd:DS_Series>
      <gmd:seriesMetadata>
        <gmi:MI_Metadata>
          ...
          <gmd:identificationInfo>
            <gmd:MD_DataIdentification>
              <gmd:citation>
                <gmd:CI_Citation>
                  ...
                  <gmd:identifier>
                    <gmd:MD_Identifier>
                      <gmd:code>
                        <gco:CharacterString>2.0</gco:CharacterString>
                      </gmd:code>
                      <gmd:description>
                        <gco:CharacterString>The ECS Version ID</gco:CharacterString>
                      </gmd:description>
                    </gmd:MD_Identifier>
                  </gmd:identifier>
                  ...
                </gmd:CI_Citation>
              </gmd:citation>
              ...
            </gmd:MD_DataIdentification>
          </gmd:identificationInfo>
          ...
        </gmi:MI_Metadata>
      </gmd:seriesMetadata>
    </gmd:DS_Series>
    
    
    Column
    width50%

    UMM

    No Format
    "Version" : "2.0",