Versions Compared

Key

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

Table of Contents

Element Description

The Metadata Association element is used to identify other metadata resources that are dependent on or related to the data described by the metadata. Such metadata resources may include (but are not limited to): services, other collections, visualizations, variables, granules, documents, etc. 

Best Practices

Metadata Association is an optional element. It can be used to identify resources stored in different metadata records that are related to the data and can also be used to define relationships between collections. For instance, a metadata association can be used to identify a parent metadata record if it exists. This usage should be reserved for instances where a group of metadata records are subsets that can be better represented by one parent metadata record, which describes the entire set. In some instances, a 'child' metadata record may point to more than one 'parent'.

The association must be made to another collection level metadata record (via the Entry Id sub-element, which should contain the related collection's Short Name) and then the Type and Description fields can be used to further explain the relationship (whether it be to the collection itself, or to a component provided in the other collection's metadata such as a service, document, visualization, etc.).      

There are four sub-elements that comprise Metadata Association:

      Entry ID: The Short Name of the target metadata record that is associated with the collection record. The Entry ID is required and should point to another collection level metadata record that includes the related information. 

      Version: The version of the target metadata record that is associated with the collection record. Providing a version is optional but is recommended if the associated collection has multiple available versions. 

      Type: The type of association between the collection metadata record and the target metadata record. Providing a Type is optional but recommended. This is a controlled vocabulary field and must be select from the following options:

  • SCIENCE ASSOCIATED: There is an associated science resource (such as a document or data) in the target metadata record.  
  • DEPENDENT: The collection is somehow dependent on the target record.  
  • INPUT: The target record is an input to the collection. For example, the target record could be a lower level data product that was input to an algorithm and processed to create the collection. 
  • PARENT: The target record is a parent of the collection. This means the collection is a subset or 'child' of a larger parent collection. 
  • CHILD: The target record is a child of the collection. This means the collection is a parent record with a number of associated 'child' records. 
  • RELATED: The target record is somehow related to the collection. 
  • LARGER CITATION WORKS: There is a document cited in the target record that is related to the collection.  

Description: Free-text description of the association between the collection and the target metadata record. Providing a description is optional but can be important for identifying a specific related resource such as a document, citation or piece of data in the target metadata record (recommended for SCIENCE ASSOCIATED, DEPENDENT, INPUT, RELATED and LARGER CITATION WORKS association types). 

Examples:

EntryId"AST_L1A" 

Version: "4"

Type"INPUT"

Description"Raw sensor counts that were converted to radiometric values found in this collection."


EntryId"Polarimetric_CT_1602" 

Version: "1"

Type"RELATED"

Description: "This related dataset contains forest vertical structure and associated uncertainty products over the same study area derived by applying multi-baseline Polarimetric Interferometric Synthetic Aperture Radar (PolInSAR) and Polarimetric Coherence Tomographic SAR (PCT or PC-TomoSAR)."


Element Specification

Providing the Metadata Association element is optional (Cardinality: 0..*). Multiple Metadata Associations may provided, of if necessary. 

ModelElementTypeConstraintsRequired?Cardinality
UMM-CMetadataAssociations/EntryIdString

1 - 80 characters

Yes, if applicable1
UMM-CMetadataAssociations/VersionString

1 - 80 characters

No0..1
UMM-CMetadataAssociations/TypeEnumeration

SCIENCE ASSOCIATED

DEPENDENT

INPUT

PARENT

CHILD

RELATED

LARGER CITATION WORKS

No0..1
UMM-CMetadataAssociations/DescriptionString

1 - 4000 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-51df84
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
    • Identify errors, discrepancies or omissions.
    • Proof all content for conciseness and readability.
  • Automated Review
    • Check the Type field to make sure it matches a Type keyword in the enumeration list.
    • Check that the Description field length is not greater than 4,000 characters  

    • Check that the Short_Name, Version, and Type field lengths are not greater than 80 characters  

Expand
titleCMR Validation
  • Check the Type field to make sure it matches a Type keyword in the enumeration list.
  • Check that the Description field length is not greater than 4,000 characters  
  • Check that the Short_Name, Version, and Type field lengths are not greater than 80 characters  
Expand
titleARC Metadata QA/QC

ARC Priority Matrix

Priority CategorizationJustification

Red = High Priority Finding

This element is categorized as highest priority when:

  • A Metadata Association is provided but the Entry Id is missing (Entry Id is required).
  • An incorrect enumeration value is provided for the Metadata Association/Type field.
Yellow = Medium Priority Finding

This element is categorized as medium priority when:

  • The Metadata Association points to an outdated collection (i.e. a collection that no longer exists).
  • The Metadata Association/Description includes spelling or grammatical errors.

Blue = Low Priority Finding

This element is categorized as low priority when:

  • Suggestions are made to change the information provided in the Metadata Association for clarity.
  • Suggestions are made to provide additional information in the Metadata Association for clarity.

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

Providing the Metadata Association element is optional (Cardinality: 0..*). Multiple Metadata Associations may provided, if necessary.

UMM-C ElementDIF 10 PathTypeConstraintsRequired in DIF 10?Cardinality
MetadataAssociations/EntryIdMetadata_Association/Entry_ID/Short_NameString
Yes1
MetadataAssociations/VersionMetadata_Association/Entry_ID/Version

String


Yes1
MetadataAssociations/TypeMetadata_Association/TypeEnumeration

Parent

Child

Related

Dependent

Input

Science Associated

Yes1
Metadata Associations/DescriptionMetadata_Association/DescriptionString
No0..1

Enumeration Mapping

DIF 10

Translation

Direction

UMM
ParentPARENT
ChildCHILD
RelatedRELATED
DependentDEPENDENT
InputINPUT
Science AssociatedSCIENCE ASSOCIATED

LARGER CITATION WORKS


Example Mapping

Section
Column
width50%

DIF 10

No Format
<Metadata_Association>
  <Entry_ID>
    <Short_Name>AST_L1A</Short_Name>
    <Version>004</Version>
  </Entry_ID>
  <Type>Input</Type>
  <Description>Raw sensor counts that were converted to radiometric values found in this collection.</Description>
</Metadata_Association>
Column
width50%

UMM

No Format
MetadataAssociations: [
  - {
       Type: "INPUT",
       Description: "Raw sensor counts that were converted to radiometric values found in this collection.",
       EntryId: "AST_L1A"
       Version: "4"
    }
],



Expand
titleECHO 10

ECHO 10

Providing the Collection Association element is optional (Cardinality: 0..*). Multiple Collection Associations may provided, if necessary.

UMM-C ElementECHO 10 PathTypeConstraintsRequired in ECHO10?CardinalityNote
MetadataAssociations/EntryIdCollectionAssociations/CollectionAssociation/ShortNameString

1 - 80 characters

Yes, if applicable1

The short name of an input collection and/or a dependent collection that is somehow associated with this collection.

MetadataAssociations/VersionCollectionAssociations/CollectionAssociation/VersionIdString1 - 80 charactersYes, if applicable1

The version of an input collection and/or a dependent collection that is somehow associated with this collection.

MetadataAssociations/TypeCollectionAssociations/CollectionAssociation/CollectionTypeString1 - 80 charactersYes, if applicable1

The type of the association whether an input type, or dependent type etc. This field is not controlled in ECHO10, but is controlled in the UMM. Therefore, strongly recommend utilizing one of the UMM enumeration types in this field in order to prevent errors when translating from ECHO10 to other metadata formats. UMM controlled vocabulary options for this field include: SCIENCE ASSOCIATED, DEPENDENT, INPUT, PARENT, CHILD, RELATED, LARGER CITATION WORKS

MetadataAssociations/DescriptionCollectionAssociations/CollectionAssociation/CollectionUseString1 - 4000 charactersNo0..1

Explanation of how the associated collection is used for this collection.


Enumeration Mapping

ECHO 10

Translation

Direction

UMM
SCIENCE ASSOCIATEDSCIENCE ASSOCIATED
DEPENDENTDEPENDENT
INPUTINPUT
PARENTPARENT
CHILDCHILD
RELATEDRELATED
LARGER CITATION WORKSLARGER CITATION WORKS


Example Mapping

Section
Column
width50%

ECHO 10

No Format
<CollectionAssociations>
  <ShortName>AST_L1A</ShortName> 
  <VersionId>4</VersionId>
  <CollectionType>Input</CollectionType>
  <CollectionUse>Raw sensor counts that were converted to radiometric values found in this collection.</CollectionUse>
</CollectionAssociations>
Column
width50%

UMM

No Format
MetadataAssociations: [
  - {
       Type: "INPUT",
       Description: "Raw sensor counts that were converted to radiometric values found in this collection.",
       EntryId: "AST_L1A"
       Version: "4"
    }
],
Expand
titleISO 19115-2 MENDS

ISO 19115-2 MENDS

Providing the Metadata Association element is optional (Cardinality: 0..*). Multiple Metadata Associations may provided, if necessary.

UMM-C Element

ISO 19115-2 MENDS Path

Type
MetadataAssociations

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/gmd:CI_Citation

Metadata Associations:
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:associationType/gmd:DS_AssociationTypeCode  codeListValue="Science Associated"

Parent Associations:
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:associationType/gmd:DS_AssociationTypeCode  codeListValue="largerWorkCitation"

String


Enumeration/Code List Mapping

ISO MENDS

Translation

Direction

UMM



Example Mapping

Section
Column
width50%

ISO 19115-2 MENDS

No Format
Metadata Association Sample:

<gmd:dataQualityInfo>
                <gmd:DQ_DataQuality>
                    <gmd:lineage>
                        <gmd:LI_Lineage>
                            <gmd:source>
                                <gmd:LI_Source>
                                    <gmd:description>
                                        <gco:CharacterString>Raw sensor counts that were converted to radiometric values found in this collection.</gco:CharacterString>
                                    </gmd:description>
                                    <gmd:sourceCitation>
                                        <gmd:CI_Citation>
                                            <gmd:title>
                                                <gco:CharacterString>AST_L1A</gco:CharacterString>
                                            </gmd:title>
                                            <gmd:date gco:nilReason="unknown"></gmd:date>
                                            <gmd:edition>
                                                <gco:CharacterString>4</gco:CharacterString>
                                            </gmd:edition>
                                        </gmd:CI_Citation>
                                    </gmd:sourceCitation>
                                </gmd:LI_Source>
                            </gmd:source>
                        </gmd:LI_Lineage>
                    </gmd:lineage>
                </gmd:DQ_DataQuality>
            </gmd:dataQualityInfo>


Parent Association Example:

 <gmd:identificationInfo>
                <gmd:MD_DataIdentification>
                    <gmd:aggregationInfo>
                        <gmd:MD_AggregateInformation>
                            <gmd:aggregateDataSetName>
                                <gmd:CI_Citation>
                                    <gmd:title>
                                        <gco:CharacterString>MYD02SSH</gco:CharacterString>
                                    </gmd:title>
                                    <gmd:date gco:nilReason="unknown"></gmd:date>
                                    <gmd:edition>
                                        <gco:CharacterString>6.1NRT</gco:CharacterString>
                                    </gmd:edition>
                                    <gmd:otherCitationDetails>
                                        <gco:CharacterString>Parent collection for child product MYD021KM.</gco:CharacterString>
                                    </gmd:otherCitationDetails>
                                </gmd:CI_Citation>
                            </gmd:aggregateDataSetName>
                            </gmd:MD_AggregateInformation>
                            </gmd:aggregationInfo>
                </gmd:MD_DataIdentification>
            </gmd:identificationInfo>

Column
width50%

UMM

No Format
MetadataAssociations: [
  - {
       Type: "INPUT",
       Description: "Raw sensor counts that were converted to radiometric values found in this collection.",
       EntryId: "AST_L1A"
       Version: "4"
    }
],
Expand
titleISO 19115-2 SMAP

ISO 19115-2 SMAP


There is currently no mapping between UMM-C and ISO 19115- for Metadata Association. 

UMM-C Element

ISO 19115-2 SMAP Path

TypeNotes
MetadataAssociationsN/AN/AN/A


Enumeration/Code List Mapping

ISO SMAP

Translation

Direction

UMM




UMM Migration

UMM Version 1.9.0Translation DirectionUMM Version 1.10.0



Excerpt
hiddentrue

Future Mappings

Expand
titleISO 19115-1

ISO 19115-1

Providing the Metadata Association element is optional (Cardinality: 0..*). Multiple Metadata Associations may provided, if necessary.

UMM-C ElementISO 19115-1 PathType
MetadataAssociations

/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:associatedResource/mri:MD_AssociatedResource/mri:name

Metadata Associations:
/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:associatedResource/mri:MD_AssociatedResource/mri:associationType/mri:DS_AssociationTypeCode codeList="codeListLocation#DS_AssociationTypeCode"codeListValue="Science Associated"

Parent Associations:
/mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:associatedResource/mri:MD_AssociatedResource/mri:associationType/mri:DS_AssociationTypeCode codeList="codeListLocation#DS_AssociationTypeCode"codeListValue="largerWorkCitation"

String


Enumeration/Code List Mapping

ISO MENDS

Translation

Direction

UMM



Example Mapping

Section
Column
width50%

ISO 19115-1

No Format
ADD EXAMPLE
(need 2 examples - one for metadata association & one for parent association)
Column
width50%

UMM

No Format
MetadataAssociations: [
  - {
       Type: "INPUT",
       Description: "Raw sensor counts to be converted to radiometric values",
       EntryId: "AST_L1A"
       Version: "4"
    }
],

History

UMM Versioning

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

No changes were made for Metadata Association during the transition from version 1.9.0 to 1.10.0.

1.9.0

ARC Documentation

VersionDateWhat ChangedAuthor
1.002/01/2018Recommendations/priority matrix transferred from internal ARC documentation to wiki space