Ancillary Keywords

Element Description

The Ancillary Keywords element allows metadata authors to provide words or phrases beyond the controlled Science Keyword vocabulary, to further describe the the collection.

Best Practices

The Ancillary Keywords element is optional and is an uncontrolled free-text field. It can be leveraged to provide any additional keywords needed to describe the collection in addition to the Science Keywords (which must be selected from a controlled vocabulary list). This can be useful for providing tags needed for other applications or for providing niche keywords which may not fit in the current scope of the controlled science keyword vocabulary. Ancillary keywords are indexed for search using the CMR API, however, they do not appear as faceted keywords in the Earthdata Search Client user interface.

Examples:

"Hurricane Katrina"

"Mineral Resources"

"BEDI"

"Modified SAVI"

"Discrete-Band Normalized Difference Water Index"

"Principal Component Analysis"

"Hydrology"

Element Specification

Providing Ancillary Keywords is optional. An unlimited number of Ancillary Keywords may be listed (Cardinality: 0..*)

Model	Element	Type	Constraints	Required?	Cardinality
UMM-C	AncillaryKeywords	String	1 - 255 characters	No	0..*

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

["https://wiki.earthdata.nasa.gov/download/attachments/124453409/Copy%20of%20Wiki%20Page%20Metadata%20Evaluation%20Workflow-1939-51df84-0.png?api=v2"]

Loading...

Please see the expandable sections below for flowchart details.

GCMD Metadata QA/QC

Manual Review
- Check that the purpose description is appropriate for the dataset.
Automated Review
- Check that the field has been populated.
- Check that the field length is not greater than 1000 characters.

CMR Validation

If this element is used it must contain at least 1 character and be no longer than 255 characters in length.

ARC Metadata QA/QC

ARC Priority Matrix

Priority Categorization	Justification
Red = High Priority Finding	This element is categorized as highest priority when: The Ancillary Keyword contains a spelling error. The element is being used incorrectly.
Yellow = Medium Priority Finding	This element is categorized as medium priority when: A recommendation is made to change an existing keyword. The ancillary keyword is unnecessarily long. The keyword doesn't seem appropriate or related to the dataset.
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

DIF 9

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

DIF 10

Providing Ancillary_Keywords is optional. An unlimited number of Ancillary_Keywords may be listed (Cardinality: 0..*)

UMM-C Element	DIF 10 Path	Type	Constraints	Required in DIF 10?	Cardinality
AncillaryKeywords	Ancillary_Keyword	String	n/a	No	0..*

Example Mapping

DIF 10

<Ancillary_Keyword>Water Resources</Ancillary_Keyword>
<Ancillary_Keyword>Energy and Mineral Resources</Ancillary_Keyword>
<Ancillary_Keyword>Hydrology</Ancillary_Keyword>

UMM

"AncillaryKeywords": [
  "Water Resources",
  "Energy and Mineral Resources",
  "Hydrology"
]

ECHO 10

Ancillary Keywords does not map to ECHO 10.

ISO 19115-2 MENDS

Providing Ancillary Keywords is optional. An unlimited number of Ancillary Keywords may be listed (Cardinality: 0..*)

UMM-C Element	ISO Path	Type
AncillaryKeywords	/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString	String

Example Mapping

ISO 19115-2 MENDS

<gmi:MI_Metadata>
  ...
  <gmd:identificationInfo>
    <gmd:MD_DataIdentification>
      ...
      <gmd:descriptiveKeywords>
        <gmd:MD_Keywords>
          <gmd:keyword>
            <gco:CharacterString>Water Resources</gco:CharacterString>
          </gmd:keyword>
          <gmd:keyword>
            <gco:CharacterString>Energy and Mineral Resources</gco:CharacterString>
          </gmd:keyword>
          <gmd:keyword>
            <gco:CharacterString>Hydrology</gco:CharacterString>
          </gmd:keyword>
          ...
        </gmd:MD_Keywords>
      </gmd:descriptiveKeywords>
      ...
    </gmd:MD_DataIdentification>
  </gmd:identificationInfo>
  ...
</gmi:MI_Metadata>

UMM

"AncillaryKeywords": [
  "Water Resources",
  "Energy and Mineral Resources",
  "Hydrology"
]

ISO 19115-2 SMAP

Providing Ancillary Keywords is optional. An unlimited number of Ancillary Keywords may be listed (Cardinality: 0..*)

UMM-C Element	ISO Path	Type
AncillaryKeywords	/gmd:DS_Series/gmd:seriesMetadata/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString	String

Example Mapping

ISO 19115-2 SMAP

<gmd:DS_Series>
  <gmd:seriesMetadata>
    <gmi:MI_Metadata>
      ...
      <gmd:identificationInfo>
        <gmd:MD_DataIdentification>
          ...
          <gmd:descriptiveKeywords>
            <gmd:MD_Keywords>
              <gmd:keyword>
                <gco:CharacterString>Water Resources</gco:CharacterString>
              </gmd:keyword>
              <gmd:keyword>
                <gco:CharacterString>Energy and Mineral Resources</gco:CharacterString>
              </gmd:keyword>
              <gmd:keyword>
                <gco:CharacterString>Hydrology</gco:CharacterString>
              </gmd:keyword>
              ...
            </gmd:MD_Keywords>
          </gmd:descriptiveKeywords>
          ...
        </gmd:MD_DataIdentification>
      </gmd:identificationInfo>
      ...
    </gmi:MI_Metadata>
  </gmd:seriesMetadata>
</gmd:DS_Series>

UMM

"AncillaryKeywords": [
  "Water Resources",
  "Energy and Mineral Resources",
  "Hydrology"
]

UMM Migration

None

History

UMM Versioning

Version	Date	What Changed
1.15.5	12/3/2020	No changes were made for Ancillary Keywords during the transition from version 1.15.4 to 1.15.5
1.15.4	9/18/2020	No changes were made for Ancillary Keywords during the transition from version 1.15.3 to 1.15.4
1.15.3	7/1/2020	No changes were made for Ancillary Keywords during the transition from version 1.15.2 to 1.15.3
1.15.2	5/20/2020	No changes were made for Ancillary Keywords during the transition from version 1.15.1 to 1.15.2
1.15.1	3/25/2020	No changes were made for Ancillary Keywords during the transition from version 1.15.0 to 1.15.1
1.15.0	2/26/2020	No changes were made for Ancillary Keywords during the transition from version 1.14.0 to 1.15.0
1.14.0	10/21/2019	No changes were made for Ancillary Keywords during the transition from version 1.13.0 to 1.14.0
1.13.0	04/11/2019	No changes were made for Ancillary Keywords during the transition from version 1.12.0 to 1.13.0
1.12.0	01/22/2019	No changes were made for Ancillary Keywords during the transition from version 1.11.0 to 1.12.0.
1.11.0	11/28/2018	No changes were made for Ancillary Keywords during the transition from version 1.10.0 to 1.11.0.
1.10.0	05/02/2018	No changes were made for Ancillary Keywords during the transition from version 1.9.0 to 1.10.0.

ARC Documentation

Version	Date	What Changed	Author
1.0	10/12/18	Recommendations/priority matrix transferred from internal ARC documentation to wiki space	Jeanne' le Roux

Page tree

Ancillary Keywords

Element Description

Best Practices

Element Specification

Metadata Validation and QA/QC

Dialect Mappings

DIF 10

ECHO 10

ISO 19115-2 MENDS

ISO 19115-2 SMAP

UMM Migration

History

UMM Versioning

ARC Documentation