Difference between revisions of "Data Usability (netCDF ACDD)"

From Earth Science Information Partners (ESIP)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
The following NetCDF Attribute Convention for Data Discovery variable attributes are highly recommended for data usability.
 +
 
==ACDD variable attributes for Usability - Highly Recommended==
 
==ACDD variable attributes for Usability - Highly Recommended==
 
+
<table width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;"><tr><th>Concept</th><th>Description</th><th>Dialect (Fit) Paths</th></tr><tr><td>Parameter Name (Standard)</td><td>The name of a parameter included in the resource from a standard vocabulary.</td><td style="word-break:break-all;"><b>ISO-1</b> /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:attribute/*/mrc:name/mcc:MD_Identifier/mcc:code/gco:CharacterString<br><b>netCDF</b> /nc:netcdf/nc:variable/nc:attribute[@nc:name='standard_name']/@nc:value<br></td></tr><tr><td>Standard Name Vocabulary</td><td>The name of the shared vocabulary from which variable standard names are taken.</td><td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='theme']/mri:thesaurusName/cit:CI_Citation/cit:title/gco:CharacterString<br><b>netCDF</b> /nc:netcdf/nc:variable/attribute[@nc:name=standard_name_vocabulary]/@nc:value<br></td></tr><tr><td>Units</td><td>The units of the variables data values.</td><td style="word-break:break-all;"><b>ISO</b> /gmi:MI_Metadata/gmd:contentInfo/gmi:MI_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:units<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:attribute/mrc:MD_SampleDimension/mrc:units<br><b>netCDF</b> metadata/variables/variable@units/@nc:value<br></td></tr><tr><td>Coverage Content Type</td><td>An ISO 19115-1 code to indicate the source of the data</td><td style="word-break:break-all;"><b>ISO</b> /gmd:MD_Metadata/gmd:contentInfo/gmd:MD_CoverageDescription/gmd:contentType/gmd:MD_CoverageContentTypeCode<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:contentType/mrc:MD_CoverageContentTypeCode<br></td></tr></table>
The following NetCDF Attribute Convention for Data Discovery variable attributes are highly recommended for data usability.<br/>
 
 
 
<table xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:cw="http://www.ngdc.noaa.gov/metadata/published/xsd/crosswalk.xsd" xmlns:xs="http://www.w3.org/2001/XMLSchema" width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;">
 
  <tr>
 
      <th width="15%">Concept</th>
 
      <th width="25%">Description</th>
 
      <th width="60%">Dialect (Fit) Paths</th>
 
  </tr>
 
  <tr>
 
      <td>[https://geo-ide.noaa.gov/wiki/index.php?title=ISO_Keywords Keyword]</td>
 
      <td style="word-break:break-all;">A word or phrase that describes some aspect of a resource. Can be one of several types.<br><br><i>Note: The general identification keywords usually have a type of "theme" and are referred to as "theme keywords". Other types and vocabularies are used for other information.</i></td>
 
      <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:keywords/adiwg:theme/adiwg:themekey<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Category<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Topic<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Term<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Variable_Level_1<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Variable_Level_2<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Variable_Level_3<br><b>DIF</b> (1)  /dif:DIF/dif:Parameters/dif:Detailed_Variable<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword<br><b>ECHO</b> (1)  /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword<br><b>ECS</b> (1)  /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword<br><b>ECS</b> (1)  /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TopicKeyword<br><b>ECS</b> (1)  /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TermKeyword<br><b>ECS</b> (1)  /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:VariableKeyword<br><b>ISO</b> (1)  /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='theme']/gmd:keyword/gco:CharacterString<br></td>
 
  </tr>
 
  <tr>
 
      <td>[http://wiki.esipfed.org/index.php/Concepts_Glossary#Abstract Keyword]</td>
 
      <td style="word-break:break-all;">The topic of the content of the resource<br><br><i>Note: This concept is called "Subject" in the CSW Specification</i></td>
 
      <td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Parameters/dif:Category<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Topic<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Term<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Variable_Level_1<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Variable_Level_2<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Variable_Level_3<br><b>DIF</b> /dif:DIF/dif:Parameters/dif:Detailed_Variable<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword<br><b>ECHO</b> /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword<br><b>ECS</b> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:CollectionDescription<br><b>ECS</b> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword<br><b>ECS</b> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TopicKeyword<br><b>ECS</b> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:TermKeyword<br><b>ECS</b> /ecs:CollectionMetaDataFile/ecs:CollectionMetaDataSets/ecs:Collections/ecs:CollectionMetaData/ecs:DisciplineTopicParameters/ecs:VariableKeyword<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type='theme']/gmd:keyword/gco:CharacterString<br></td>
 
  </tr>
 
  <tr>
 
      <td>[https://geo-ide.noaa.gov/wiki/index.php?title=ISO_Keywords Keyword Vocabulary]</td>
 
      <td style="word-break:break-all;">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.<br><br><i>Note: DIF, ECHO and ECS require that theme keywords come from the Global Change Master
 
            Directory list.</i></td>
 
      <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:keywords/adiwg:theme/adiwg:themekt<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString<br></td>
 
  </tr>
 
  <tr>
 
      <td>[http://wiki.esipfed.org/index.php/Concepts_Glossary#Units Units]</td>
 
      <td style="word-break:break-all;">The units of the variables data values.</td>
 
      <td style="word-break:break-all;"><b>ISO</b> /gmi:MI_Metadata/gmd:contentInfo/gmi:MI_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:units<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:attribute/mrc:MD_SampleDimension/mrc:units<br></td>
 
  </tr>
 
  <tr>
 
      <td>[http://wiki.esipfed.org/index.php/Concepts_Glossary#Coverage%20Content%20Type Coverage Content Type]</td>
 
      <td style="word-break:break-all;">An ISO 19115-1 code to indicate the source of the data</td>
 
      <td style="word-break:break-all;"><b>ISO</b> /gmd:MD_Metadata/gmd:contentInfo/gmd:MD_CoverageDescription/gmd:contentType/gmd:MD_CoverageContentTypeCode<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:contentType/mrc:MD_CoverageContentTypeCode<br></td>
 
  </tr>
 
</table>
 
 
''xPath Note:'' The xPaths included in this table use several wildcards. // means
 
''xPath Note:'' The xPaths included in this table use several wildcards. // means
 
any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere
 
any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere
Line 46: Line 13:
 
''Fit:'' The fit of the dialect path with the concept is estimated on a scale of 1
 
''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.
 
= excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.
[[Category:Documentation Connections]]
 

Latest revision as of 08:32, June 5, 2015

The following NetCDF Attribute Convention for Data Discovery variable attributes are highly recommended for data usability.

ACDD variable attributes for Usability - Highly Recommended

ConceptDescriptionDialect (Fit) Paths
Parameter Name (Standard)The name of a parameter included in the resource from a standard vocabulary.ISO-1 /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:attribute/*/mrc:name/mcc:MD_Identifier/mcc:code/gco:CharacterString
netCDF /nc:netcdf/nc:variable/nc:attribute[@nc:name='standard_name']/@nc:value
Standard Name VocabularyThe 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
ISO-1 /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='theme']/mri:thesaurusName/cit:CI_Citation/cit:title/gco:CharacterString
netCDF /nc:netcdf/nc:variable/attribute[@nc:name=standard_name_vocabulary]/@nc:value
UnitsThe units of the variables data values.ISO /gmi:MI_Metadata/gmd:contentInfo/gmi:MI_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:units
ISO-1 /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:attribute/mrc:MD_SampleDimension/mrc:units
netCDF metadata/variables/variable@units/@nc:value
Coverage Content TypeAn ISO 19115-1 code to indicate the source of the dataISO /gmd:MD_Metadata/gmd:contentInfo/gmd:MD_CoverageDescription/gmd:contentType/gmd:MD_CoverageContentTypeCode
ISO-1 /mdb:MD_Metadata/mdb:contentInfo/mrc:MD_CoverageDescription/mrc:attributeGroup/mrc:MD_AttributeGroup/mrc:contentType/mrc:MD_CoverageContentTypeCode

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.