You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

I need attributes in my metadata that are specific to my product

 

Overview


The ECHO and ISO metadata models both include the ability to add non-standard elements required by specific communities:

  • ECHO additional attributes are parameters, also known as Product-Specific Attributes (PSAs), which further describe the data represented in each granule within a collection. These values are important search criteria for the granules.
  • ISO 19115: This International Standard provides standard metadata and an associated structure that will serve a wide variety of digital geographic data. The definitions and domain values are intended to be sufficiently generic to satisfy the metadata needs of various disciplines. However, the very diversity of data means that generic metadata may not accommodate all applications. The standard provides rules for defining and applying additional metadata to better serve special user needs.

ECHO Additional Attributes have the following properties:

  • Name – Unique name of the additional attribute.
  • DataType – Data type of the additional attribute, chosen from the supported list of types.
  • Description – A textual description of the attribute to help end users understand the purpose and data represented by the attribute.
  • MeasurementResolution – Identifies the smallest unit increment to which the parameter value is measured.
  • ParameterRangeBegin – Minimum value of all attribute values that will be provided by the collection or granules.
  • ParameterRangeEnd – Maximum value of all attribute values that will be provided by the collection or granules.
  • ParameterUnitsOfMeasure – Unit of measure for parameter (e.g. AVHRR: unit of geophysical parameter-units of geophysical parameter.)
  • ParameterValueAccuracy – Estimate of the accuracy of the assignment of attribute value. This can be specified in percent or the unit with which the parameter is measured.
  • ValueAccuracyExplanation – Defines the method used for determining the parameter value accuracy.

 

Recommendations for ISO 19115 and 19115-1

 

The ECHO Collection Level Metadata includes 149 structured elements and 327 Additional Attributes, so they are an important part of the existing metadata. The additional attributes need to be classified in order to attach them to the correct object in the ISO metadata. Preliminary categories and examples are shown here. These will almost certainly change as the categories are reviewed.

 

Category Name

Count

Definition

Examples

citation.date

13

A date related to the resource. Generally mapped to a date object in the citation. May need to extend dateType codelist.

AcquisitionDate, GenerationDateandTime, LatestAcquisitionDate

citation.identifier

115

An identifier for the resource.

SEQUENCE, FRAME_ID, GRANULENUMBER, MAX_FRAME_ID, MIN_FRAME_ID, OrderingId, ASTERGRANULEID, FileNumbe

citation.pointOfContact

16

Information about a person or organization associated with the resource.

ScienceTeamWebSite

contentInformation

1333

Information or statistical description of the content of the resource.

Names that include Pct, PERCENT. Many of these attributes are actually quality information. They are added to contentInformation in order to simplify access and to keep it more consistent with approach used in ECHO. More sophisticated quality assessments will go in DQ_DataQuality

descriptiveKeyword

55

Miscellaneous information that might support discovery

ASCENDING_DESCENDING, AscendingDescendingFlg,

distributionInformation

18

Information related to the distribution of the resource

OPeNDAPServer, DigitalFileSize, ArchiveLocation,

geographicIdentifier

372

Identifier of geographic feature associated with the resource

HORIZONTALTILENUMBER, TileID, VERTICALTILENUMBER, Cycle, Instance, ReferenceOrbit, Track, EndingPolygonNumber, NominalPassIndex, StartingPolygonNumber, Track_Segment, AIRSAR_FLIGHT_LINE, Path, CENTER_FRAME_ID, PATH_NUMBER, FlightPath,

instrumentInformation

124

Information about the instrument used to collect the data

All instrumentCharacteristics, , Instrument_State, Instrument_State_Date, Instrument_State_Time, VNIR1_ObservationMode, VNIR2_ObservationMode, GainBand1, GainBand2, GainBand3, GainBand4, GainBand5,

lineage

69

Information related to sources and process steps used to create the resource.

ALBEDOFILEID, BRDFCODEID, BRDFDATABASEVERSION, ClimateSeedSource, INPUTPRODUCTRESOLUTION, PDS_ID, INPUTFILERESOLUTION

processingInformation

255

Information about process steps used to create the resource.

PROCESSVERSION, Timing_Bias, Timing_Bias_Date, Timing_Bias_Time, Timing_Drift, Timing_Drift_Date, Timing_Drift_Time, Range_Bias, Range_Bias_Date, Range_Bias_Time,

processStep

2

Information about a specific processStep

ASTERProcessingCenter

qualityInformation

178

Information related to the quality of the resource

QAFRACTIONGOODQUALITY, QAFRACTIONNOTPRODUCEDCLOUD, QAFRACTIONNOTPRODUCEDOTHER, QAFRACTIONOTHERQUALITY, OrbitQuality, NDAYS_COMPOSITED, PERCENTSUBSTITUTEBRDFS, Band1_Available, Band10_Available, Band11_Available, Band12_Available

 

The distinction between this category and contentInformation might be arbitrary. It could be that some/all of these fit better in contentInformation

resourceFormat

2

Information about the format of the resource

FileFormat

Conceptual Model (UML)


ISO 19115 is being extended to include ECHO additional attributes (and characteristics). We define the structures that are used in the extension and, because we are adding ECHO Additional Attributes, the existing structure is a good candidate for the structure in the extension.

The conceptual structure of the ECHO additional attributes and the proposed ISO structure are shown in the figure. The current ECHO practice is to define the properties of Additional Attributes in collection metadata and to provide values in the granule metadata. In order to support that practice the additional attribute definition was made a separate object in the proposed ISO model. In addition, three new properties were proposed (shown in red):

  1. type : EOS_AdditionalAttributeTypeCode - a codelist that gives the type of the additionalAttribute. Values for this codelist are TBD, but potential candidates include: contentInformation, qualityInformation, instrumentInformation, processingInformation, distributionInformation, ... This is different than the dataType for the additional attribute.
  2. identifier : MD_Identifier - a unique identifier for the additionalAttribute. This MD_Identifier includes the identifier and information about the authority that guarantees uniqueness.
  3. dataType : EOS_AdditionalAttributeDataTypeCode - a codelist that gives the data type for the additional attribute. The values are the same as those of the ECHO DataType (i.e. STRING, FLOAT, INT, BOOLEAN, ...). Note: many of the current occurrences of this field are lower case and so do not match the restriction in the ECHO schema.

Implementation (XML) 


<eos:AdditionalAttributes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://earthdata.nasa.gov/schema/eos ../schema.xsd"
 xmlns:eos="http://earthdata.nasa.gov/schema/eos"
 xmlns:gco="http://www.isotc211.org/2005/gco"
 xmlns:gmd="http://www.isotc211.org/2005/gmd"
 xmlns:xlink="http://www.w3.org/1999/xlink">
  <eos:EOS_AdditionalAttributes>
    <eos:additionalAttribute>
      <eos:EOS_AdditionalAttribute id="ID001" uuid="uuid1">
        <eos:reference>
          <eos:EOS_AdditionalAttributeDescription id="ID002" uuid="uuid2">
            <eos:type>
              <eos:EOS_AdditionalAttributeTypeCode codeList="http://earthdata.nasa.gov/metadata/resources/" codeListValue="additionalAttributeType">additionalAttributeType</eos:EOS_AdditionalAttributeTypeCode>
            </eos:type>
            <eos:identifier>
              <gmd:MD_Identifier id="ID003" uuid="uuid3">
                <gmd:code>
                  <gco:CharacterString>Unique identifier for the additionalAttribute</gco:CharacterString>
                </gmd:code>
              </gmd:MD_Identifier>
            </eos:identifier>
            <eos:name>
              <gco:CharacterString>Name of the additionalAttribute</gco:CharacterString>
            </eos:name>
            <eos:description>
              <gco:CharacterString>This attribute provides a description for the additionalAttribute.</gco:CharacterString>
            </eos:description>
            <eos:dataType>
              <eos:EOS_AdditionalAttributeDataTypeCode codeList="http://earthdata.nasa.gov/metadata/resources/" codeListValue="STRING">STRING</eos:EOS_AdditionalAttributeDataTypeCode>
            </eos:dataType>
            <eos:measurementResolution>
              <gco:CharacterString>This attribute will be used to identify the smallest unit increment to which the additionalAttribute value is measured.</gco:CharacterString>
            </eos:measurementResolution>
            <eos:parameterRangeBegin>
              <gco:CharacterString>This attribute provides the minimum value of additionalAttribute over whole collection.</gco:CharacterString>
            </eos:parameterRangeBegin>
            <eos:parameterRangeEnd>
              <gco:CharacterString>This attribute provides the maximum value of additionalAttribute over whole collection.</gco:CharacterString>
            </eos:parameterRangeEnd>
            <eos:parameterUnitsOfMeasure>
              <gco:CharacterString>The standard unit of measurement for a additionalAttribute.</gco:CharacterString>
            </eos:parameterUnitsOfMeasure>
            <eos:parameterValueAccuracy>
              <gco:CharacterString>An estimate of the accuracy of the assignment of attribute value.</gco:CharacterString>
            </eos:parameterValueAccuracy>
            <eos:valueAccuracyExplanation>
              <gco:CharacterString>This defines the method used for determining the parameter value accuracy that is given for this additionalAttribute.</gco:CharacterString>
            </eos:valueAccuracyExplanation>
          </eos:EOS_AdditionalAttributeDescription>
        </eos:reference>
        <eos:value>
          <gco:CharacterString>This attribute contains the value of the additionalAttribute for all granules across a given collection</gco:CharacterString>
        </eos:value>
      </eos:EOS_AdditionalAttribute>
    </eos:additionalAttribute>
    <eos:additionalAttribute xlink:href="http://componentService/uuid1" xlink:title="additionalAttribute with value"/>
    <eos:additionalAttribute>
      <eos:EOS_AdditionalAttribute>
        <eos:reference xlink:href="http://componentService/uuid2" xlink:title="additionalAttribute definition"/>
        <eos:value>
          <gco:CharacterString>This attribute contains the value of the additionalAttribute for all granules across a given collection</gco:CharacterString>
        </eos:value>
      </eos:EOS_AdditionalAttribute>
    </eos:additionalAttribute>
  </eos:EOS_AdditionalAttributes>
</eos:AdditionalAttributes>

Usage

 

TypeISO xPath
citation.date/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date
citation.identifier/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier
citation.website/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty
contentInformation/gmi:MI_Metadata/gmd:contentInfo/gmd:MD_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:otherProperty/gco:Record/eos:AdditionalAttributes
descriptiveKeyword/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString
distributionInformation 
geographicIdentifier/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier
instrumentInformation/gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/eos:EOS_Instrument/eos:otherProperty/gco:Record/eos:AdditionalAttributes
lineage 
processingInformation/gmi:MI_Metadata/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:processStep/gmi:LE_ProcessStep/gmi:processingInformation/eos:EOS_Processing/eos:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute
processStep 
qualityInformation/gmi:MI_Metadata/gmd:contentInfo/gmd:MD_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:otherProperty/gco:Record/eos:AdditionalAttributes
resourceFormat/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceFormat/gmd:MD_Format

Translation Details

Some existing AdditionalAttributes include information that fits in an existing ISO 19115 element without the NASA extensions. In this case, custom translations are required. The details of these translations are described here.

citation.date

 

 

 

UserEditsCommentsLabels
John Kozimor 700
Ted Habermann 603
Ross Bagwell 100

  • No labels