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

From Earth Science Information Partners (ESIP)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==ACDD variable attributes for Usability - Highly Recommended==
 
 
 
The following NetCDF Attribute Convention for Data Discovery variable attributes are highly recommended for data usability.
 
The following NetCDF Attribute Convention for Data Discovery variable attributes are highly recommended for data usability.
  
<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;">
+
==ACDD variable attributes for Usability - Highly Recommended==
  <tr>
+
<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>
      <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.