Difference between revisions of "Data Discovery (ACDD)"

From Earth Science Information Partners (ESIP)
Line 1: Line 1:
__FORCETOC__
 
 
The netCDF Group at Unidata has recommended netCDF attributes for data discovery.  Where compatible the spirals below provide like xpath references for DIF, ECHO, ECS, UMM and ISO.
 
The netCDF Group at Unidata has recommended netCDF attributes for data discovery.  Where compatible the spirals below provide like xpath references for DIF, ECHO, ECS, UMM and ISO.
 
   
 
   

Revision as of 21:34, August 25, 2014

The netCDF Group at Unidata has recommended netCDF attributes for data discovery. Where compatible the spirals below provide like xpath references for DIF, ECHO, ECS, UMM and ISO.

Attribute Convention for Data Discovery - Highly Recommended

These attributes are highly recommended by the Attribute Convention for Data Discovery

Concept Description Dialect (Fit) Paths
Resource Title A short description of the resource. The title should be descriptive enough so that when a user is presented with a list of titles the general content of the data set can be determined. DIF /dif:DIF/dif:Entry_Title
ECHO /*/echo:ShortName>/*/echo:LongName
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:ShortName> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:LongName
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString
UMM /umm:UMM/umm:CollectionCitation/umm:Title
Abstract A paragraph describing the resource. DIF /dif:DIF/dif:Summary/dif:Abstract
ECHO /*/echo:Description
ISO /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString
UMM /umm:UMM/umm:Summary
Keyword A word or phrase that describes some aspect of a resource. Can be one of several types.

Note: The general identification keywords usually have a type of "theme" and are refered to as "theme keywords". Other types and vocabularies are used for other information.
DIF (1) /dif:DIF/dif:Parameters/dif:Category
DIF (1) /dif:DIF//dif:Parameters/dif:Topic
DIF (1) /dif:DIF//dif:Parameters/dif:Term
DIF (1) /dif:DIF//dif:Parameters/dif:Variable_Level_1
DIF (1) /dif:DIF//dif:Parameters/dif:Variable_Level_2
DIF (1) /dif:DIF//dif:Parameters/dif:Variable_Level_3
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword
ECHO (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TopicKeyword
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TermKeyword
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:VariableKeyword
ISO (1) /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='theme']/gmd:keyword/gco:CharacterString
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:Category
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:Topic
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:Term
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:Value
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:Value
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:VariableLevel3/umm:Value
UMM (1) /umm:UMM/umm:ScienceKeywords/umm:DetailedVariable


Attribute Convention for Data Discovery - Recommended

These attributes are recommended by the Attribute Convention for Data Discovery

Concept Description Dialect (Fit) Paths
Resource Identifier Identifier for the resource described by the metadata DIF /dif:DIF/dif:Data_Set_Citation/dif:Dataset_DOI
DIF /dif:DIF/dif:Reference/dif:DOI
ECHO /*/echo:DataSetId
ECHO (1) /*/echo:ShortName | /*/echo:LongName
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString
Naming Authority The organization responsible for the maintenance of the identifier (namespace) ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace(19115-1)
Keyword Vocabulary If you are following a guideline or using a shared vocabulary for the words/phrases in your "keywords" attribute, put the name of that guideline here.

Note: DIF, ECHO and ECS require that theme keywords come from the Global Change Master Directory list.
ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString
Common Data Model Datatype The THREDDS data type for this resource.

Note: Current values: vector, grid, textTable, tin, stereoModel, video.
ISO /*/gmd:identificationInfo/*/gmd:spatialRepresentationType/gmd:MD_SpatialRepresentationTypeCode
Lineage Statement Information and references for sources and processes that were used to create the dataset and an audit trail for modifications to the original data. ISO /*/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:statement/gco:CharacterString
Other Information Miscellaneous information about the data. ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:otherCitationDetails/gco:CharacterString
Creation Date The date the resource was created ISO //gmd:CI_Citation/gmd:date/gmd:CI_Date[gmd:dateType/gmd:CI_DateTypeCode='creation']/gmd:date/gco:Date
ISO //gmd:CI_Citation/gmd:date/gmd:CI_Date[gmd:dateType/gmd:CI_DateTypeCode='creation']/gmd:date/gco:DateTime
Resource Contact The organization or person responsible for answering questions about the resource. DIF /dif:DIF/dif:Personnel[dif:Role='INVESTIGATOR']
ECHO /*/echo:ArchiveCenter
ECHO /*/echo:Contacts/echo:Contact
ECS /CollectionMetaDataFile/CollectionMetaDataSets/Collections/CollectionMetaData/Contact[Role='User Services']
ISO /*/gmd:identificationInfo/*/gmd:pointOfContact
Originator World Wide Web Address The World Wide Web mail address of the principal author of the resource ISO //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode='author']/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL
Originator Email Address The electronic mail address of the principal author of the resource DIF /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Creator
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode='author']/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString
Originating Organization The organization responsible for creating the resource DIF /dif:DIF/dif:Originating_Center
ECHO /*/echo:ProcessingCenter
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString
Project Name The name of the project that the resource was associated with. DIF /dif:DIF/dif:Project/dif:Short_Name
DIF /dif:DIF/dif:Project/dif:Long_Name
ECHO /*/echo:Campaigns/echo:Campaign/echo:ShortName and /*/echo:Campaigns/echo:Campaign/echo:LongName
ISO /*/gmd:identificationInfo/*/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/gmd:CI_Citation/gmd:title/gco:CharacterStringDS_AssociationTypeCode="largerWorkCitation" and DS_InitiativeTypeCode="project"
ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString with gmd:MD_KeywordTypeCode="project"
Processing Level A code that indicates the extent of processing done in the creation of a dataset. ECHO /*/echo:ProcessingLevelId
ISO /gmi:MI_Metadata/gmd:contentInfo/gmd:MD_ImageDescription/gmd:processingLevelCode/gmd:MD_Identifier/gmd:code/gco:CharacterString
Acknowledgement ISO /*/gmd:identificationInfo/*/gmd:credit/gco:CharacterString
Southernmost Latitude The southernmost latitude of the bounding rectangle.

Note: OGC-SOS offering lists may not include the entire dataset. A gml:id attribute can be used to identify the bounding offering.
DIF (1) /dif:DIF/dif:Spatial_Coverage/dif:Southernmost_Latitude
ECHO (1) /*/echo:Spatial/echo:HorizontalSpatialDomain/echo:Geometry/echo:BoundingRectangle/echo:SouthBoundingCoordinate
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Spatial/ecs:HorizontalSpatialDomain/ecs:BoundingRectangle/ecs:SouthBoundingCoordinate
ISO (1) /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:southBoundLatitude/gco:Decimal
UMM (1) /umm:UMM/umm:SpatialCoverage/umm:HorizontalSpatialDomain/umm:BoundingRectangle/umm:SouthBoundingCoordinate
Northernmost Latitude The northernmost latitude of the bounding rectangle.

Note: OGC-SOS offering lists may not include the entire dataset. A gml:id attribute (e.g. gml:id="network-all") can be used to identify the bounding offering.
DIF (1) /dif:DIF/dif:Spatial_Coverage/dif:Northernmost_Latitude
ECHO (1) /*/echo:Spatial/echo:HorizontalSpatialDomain/echo:Geometry/echo:BoundingRectangle/echo:NorthBoundingCoordinate
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Spatial/ecs:HorizontalSpatialDomain/ecs:BoundingRectangle/ecs:NorthBoundingCoordinate
ISO (1) /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:northBoundLatitude/gco:Decimal
UMM (1) /umm:UMM/umm:SpatialCoverage/umm:HorizontalSpatialDomain/umm:BoundingRectangle/umm:NorthBoundingCoordinate
Westernmost Longitude The westernmost longitude of the bounding rectangle.

Note: OGC-SOS offering lists may not include the entire dataset. A gml:id attribute can be used to identify the bounding offering.
DIF (1) /dif:DIF/dif:Spatial_Coverage/dif:Westernmost_Longitude
ECHO (1) /*/echo:Spatial/echo:HorizontalSpatialDomain/echo:Geometry/echo:BoundingRectangle/echo:WestBoundingCoordinate
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Spatial/ecs:HorizontalSpatialDomain/ecs:BoundingRectangle/ecs:WestBoundingCoordinate
ISO (1) /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:westBoundLongitude/gco:Decimal
UMM (1) /umm:UMM/umm:SpatialCoverage/umm:HorizontalSpatialDomain/umm:BoundingRectangle/umm:WestBoundingCoordinate
Easternmost Longitude The easternmost longitude of the bounding rectangle.

Note: OGC-SOS offering lists may not include the entire dataset. A gml:id attribute can be used to identify the bounding offering.
DIF (1) /dif:DIF/dif:Spatial_Coverage/dif:Easternmost_Longitude
ECHO (1) /*/echo:Spatial/echo:HorizontalSpatialDomain/echo:Geometry/echo:BoundingRectangle/echo:WestBoundingCoordinate
ECS (1) /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Spatial/ecs:HorizontalSpatialDomain/ecs:BoundingRectangle/ecs:EastBoundingCoordinate
ISO (1) /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:eastBoundLongitude/gco:Decimal
UMM (1) /umm:UMM/umm:SpatialCoverage/umm:HorizontalSpatialDomain/umm:BoundingRectangle/umm:EastBoundingCoordinate
Start Time The start of the bounding time period DIF /dif:DIF/dif:Temporal_Coverage/dif:Start_Date
ECHO /*/echo:Temporal/echo:RangeDateTime/echo:BeginningDateTime
ISO /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:beginPosition
End Time The end of the bounding time period DIF /dif:DIF/dif:Temporal_Coverage/dif:Stop_Date
ECHO /*/echo:Temporal/echo:RangeDateTime/echo:EndingDateTime
ECHO /*/echo:Temporal/echo:EndsAtPresentFlag
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Temporal/ecs:RangeDateTime/ecs:RangeBeginningDate
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Temporal/ecs:RangeDateTime/ecs:RangeBeginningTime
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Temporal/ecs:RangeDateTime/ecs:RangeEndingDate
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:Temporal/ecs:RangeDateTime/ecs:RangeEndingTime
ISO /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:endPosition
Vertical Minimum The minimum height of the bounding rectangle DIF /dif:DIF/dif:Spatial_Coverage/dif:Minimum_Altitude
DIF /dif:DIF/dif:Spatial_Coverage/dif:Minimum_Depth
ISO /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:verticalElement/gmd:EX_VerticalExtent/gmd:minimumValue/gco:Real
Resource Duration The temporal duration of a resource.
Temporal Resolution The smallest time step included in the resource.
Standard Name Vocabulary The name of the shared vocabulary from which variable standard names are taken. ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString
Vertical Maximum The maximum height of the bounding rectangle DIF /dif:DIF/dif:Spatial_Coverage/dif:Maximum_Altitude
DIF /dif:DIF/dif:Spatial_Coverage/dif:Maximum_Depth
ISO /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:verticalElement/gmd:EX_VerticalExtent/gmd:maximumValue/gco:Real
Resource Access Constraints Information about any constraints for accessing the data set. This includes any special restrictions, legal prerequisites, limitations and/or warnings on obtaining the data set. Some words that may be used in this field include: Public, In-house, Limited, Additional detailed instructions on how to access the data can be entered in this field. DIF /dif:DIF/dif:Access_Constraints
ECHO /*/echo:RestrictionFlag
ECHO /*/echo:RestrictionComment
ECS /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:AccessConstraints
ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:legalConstraints/gmd:MD_RestrictionCode
ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString
ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:legalConstraints/gco:CharacterString
ISO /*/gmd:identificationInfo/srv:SV_ServiceIdentification/srv:restrictions/gmd:MD_LegalConstraints/gmd:otherConstraints/gco:CharacterString


Attribute Convention for Data Discovery - Suggested

These attributes are suggested by the Attribute Convention for Data Discovery

Concept Description Dialect (Fit) Paths
Contributor Name Contributor to the resource ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode='author']
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode='originator']
Contributor Role The role of any individuals or institutions that contributed to the creation of the data.
Publisher Publisher of the cited resource DIF /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Publisher
DIF /dif:DIF/dif:Reference/dif:Publisher
ISO //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode='publisher']
Publisher URL World Wide Web address associated with the publisher of the cited resource DIF /dif:DIF/dif:Reference/dif:Publication_Place
ISO //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode=['publisher']/gmd:contactInfo
Publisher E-Mail Email associated with the publisher of the cited resource DIF /dif:DIF/dif:Reference/dif:Publication_Place
ISO //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode=['publisher']/gmd:contactInfo

xPath Note: The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo//*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords. Fit: The fit of the dialect path with the concept is estimated on a scale of 1 = excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.