Difference between revisions of "Documenting Resource Identification"

From Earth Science Information Partners (ESIP)
Line 1: Line 1:
The Identification Spiral sets the stage for discovery using text search engines.
+
==Identification==
It includes a unique identifier for the metadata, a title, an abstract, theme keywords
+
The Identification Spiral sets the stage for discovery of the described resource using text search engines. It includes a unique identifier for the metadata, a title, an abstract, theme keywords and contact information for the metadata and the dataset.
and contact information for the metadata and the dataset.
+
In many dialects citations to the described resource are used to provide important information about how users should cite the documented resource that is described by the metadata. These citations are an important part of the identification information and, as such, they are in a special location in the record.
 
==Crosswalks==
 
==Crosswalks==
 
 
<table width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;">
 
<table width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;">
 
<tr>
 
<tr>
Line 16: Line 15:
 
</tr>
 
</tr>
 
<tr>
 
<tr>
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#title_Attribute Title]</td>
+
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#title_Attribute Resource Title]</td>
<td style="word-break:break-all;">A short description of the dataset.</td>
+
<td style="word-break:break-all;">A short description of the resource. The title should be descriptive enough so that
<td style="word-break:break-all;"><b>DIF</b> /DIF/Entry_Title<br><b>Dryad</b> dcterms:title<br><b>ECHO</b> /Collection/ShortName&gt;/Collection/LongName<br><b>EML</b> /eml:dataset/eml:title/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:citation/fgdc:citeinfo/fgdc:title<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Title<br><b>THREDDS</b> /catalog/dataset/@name<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=title]<br></td>
+
when a user is presented with a list of titles the general content of the data set
</tr>
+
can be determined.
<tr>
+
</td>
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#date_created_Attribute Creation Date]</td>
+
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Entry_Title<br><b>Dryad</b> dcterms:title<br><b>ECHO</b> /echo:Collection/echo:ShortName&gt;/echo:Collection/echo:LongName<br><b>EML</b> /eml:dataset/eml:title/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:citation/fgdc:citeinfo/fgdc:title<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString<br><b>ISO-1</b> /*/mdb:identificationInfo/*/rmd:citation/cit:CI_Citation/cit:title/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Title<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/@thredds:name<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/thredds:metadata/thredds:@dc:title<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=title]<br></td>
<td style="word-break:break-all;">The date the resource was created</td>
 
<td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:Date<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=date_created]<br></td>
 
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#summary_Attribute Abstract]</td>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#summary_Attribute Abstract]</td>
<td style="word-break:break-all;">A paragraph describing the dataset.</td>
+
<td style="word-break:break-all;">A paragraph describing the resource.</td>
<td style="word-break:break-all;"><b>DIF</b> /DIF/Summary/Abstract<br><b>Dryad</b> dcterms:description<br><b>ECHO</b> /Collection/Description<br><b>EML</b> /eml:dataset/eml:abstract/eml:descendant<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:descript/fgdc:abstract<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Abstract<br><b>THREDDS</b> metadata/documentation[@type=summary]<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=summary]<br></td>
+
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Summary/dif:Abstract<br><b>Dryad</b> dcterms:description<br><b>ECHO</b> /echo:Collection/Description<br><b>EML</b> /eml:dataset/eml:abstract/eml:descendant<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:descript/fgdc:abstract<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString<br><b>ISO-1</b> /*/mdb:identificationInfo/*/rmd:abstract/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Abstract<br><b>THREDDS</b> /thredds:catalog/thredds:metadata/thredds:documentation[@thredds:type=summary]<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=summary]<br></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">Topic Category</td>
 
<td style="word-break:break-all;">Topic Category</td>
<td style="word-break:break-all;">High level category used in ISO</td>
+
<td style="word-break:break-all;">High level category enumeration used in ISO</td>
 
<td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:topicCategory/gmd:MD_TopicCategoryCode<br></td>
 
<td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:topicCategory/gmd:MD_TopicCategoryCode<br></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_Attribute Keyword]</td>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_Attribute Keyword]</td>
<td style="word-break:break-all;">A comma separated list of key words and phrases.</td>
+
<td style="word-break:break-all;">A comma separated list of key words and phrases. Can be one of several types.</td>
 
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Parameters/dif:Category &gt; //dif:Parameters/dif:Topic &gt; //dif:Parameters/dif:Term
 
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Parameters/dif:Category &gt; //dif:Parameters/dif:Topic &gt; //dif:Parameters/dif:Term
 
&gt; //dif:Parameters/dif:Variable_Level_1 &gt; //dif:Parameters/dif:Variable_Level_2 &gt;
 
&gt; //dif:Parameters/dif:Variable_Level_1 &gt; //dif:Parameters/dif:Variable_Level_2 &gt;
Line 43: Line 40:
 
<br><b>Dryad</b> dcterms:subject<br><b>ECHO</b> / echo:Collection/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword&gt;//echo:TopicKeyword&gt;//echo:TermKeyword&gt;//echo:VariableLevel1Keyword/echo:Value&gt;//echo:VariableLevel2Keyword/echo:Value&gt;//echo:VariableLevel3Keyword&gt;//echo:DetailedVariableKeyword<br><b>ECS</b> METADATA &gt; COLLECTIONMETADATA &gt; DisciplineTopicParameters &gt; DisciplineTopicParametersContainer.ECSDisciplineKeyword
 
<br><b>Dryad</b> dcterms:subject<br><b>ECHO</b> / echo:Collection/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword&gt;//echo:TopicKeyword&gt;//echo:TermKeyword&gt;//echo:VariableLevel1Keyword/echo:Value&gt;//echo:VariableLevel2Keyword/echo:Value&gt;//echo:VariableLevel3Keyword&gt;//echo:DetailedVariableKeyword<br><b>ECS</b> METADATA &gt; COLLECTIONMETADATA &gt; DisciplineTopicParameters &gt; DisciplineTopicParametersContainer.ECSDisciplineKeyword
 
&gt; DisciplineTopicParametersContainer.ECSParameterKeyword &gt; DisciplineTopicParametersContainer.ECSTermKeyword
 
&gt; DisciplineTopicParametersContainer.ECSParameterKeyword &gt; DisciplineTopicParametersContainer.ECSTermKeyword
&gt; DisciplineTopicParametersContainer.ECSTopicKeyword<br><b>EML</b> /eml:dataset/eml:keywordSet/eml:keyword/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:theme/fgdc:themekey |/fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:place/fgdc:placekey<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Keywords/ows:Keyword<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=keywords]<br></td>
+
&gt; DisciplineTopicParametersContainer.ECSTopicKeyword<br><b>EML</b> /eml:dataset/eml:keywordSet/eml:keyword/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:theme/fgdc:themekey |/fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:place/fgdc:placekey<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Keywords/ows:Keyword<br><b>THREDDS</b> thredds:catalog/thredds:metadata/thredds:keyword<br><b>THREDDS</b> thredds:catalog/thredds:dataset/thredds:keyword<br><b>netCDF</b> /nc:netcdf/nc:attribute[@name=keywords]<br></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_vocabulary_Attribute Keyword Vocabulary]</td>
 
<td style="word-break:break-all;">[http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_vocabulary_Attribute Keyword Vocabulary]</td>
<td style="word-break:break-all;">If you are following a guideline for the words/phrases in your "keywords" attribute,
+
<td style="word-break:break-all;">If you are following a guideline or using a shared vocabulary for the words/phrases
put the name of that guideline here.
+
in your "keywords" attribute, put the name of that guideline here.
 
</td>
 
</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>netCDF</b> /nc:netcdf/nc:attribute[@name=keyword_vocabulary]<br></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>netCDF</b> /nc:netcdf/nc:attribute[@name=keyword_vocabulary]<br></td>
Line 54: Line 51:
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">Metadata Contact</td>
 
<td style="word-break:break-all;">Metadata Contact</td>
<td style="word-break:break-all;">The organization or person responsible for the metadata.</td>
+
<td style="word-break:break-all;">The organization or person currently responsible for the metadata.</td>
<td style="word-break:break-all;"><b>ISO</b> /*/gmd:contact<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider<br></td>
+
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel[dif:Role='DIF AUTHOR']<br><b>DIF</b> /dif:DIF/dif:Originating_Metadata_Node<br><b>ISO</b> /*/gmd:contact<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider<br></td>
 
</tr>
 
</tr>
 
<tr>
 
<tr>
 
<td style="word-break:break-all;">Resource Contact</td>
 
<td style="word-break:break-all;">Resource Contact</td>
 
<td style="word-break:break-all;">The organization or person responsible for answering questions about the resource.</td>
 
<td style="word-break:break-all;">The organization or person responsible for answering questions about the resource.</td>
<td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:pointOfContact<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider<br></td>
+
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel[dif:Role='INVESTIGATOR']<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:pointOfContact<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider<br></td>
 +
</tr>
 +
<tr>
 +
<td style="word-break:break-all;">Complete Citation</td>
 +
<td style="word-break:break-all;">Complete citation for the resource</td>
 +
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:CitationForExternalPublication<br></td>
 
</tr>
 
</tr>
 
</table>
 
</table>

Revision as of 11:31, January 4, 2013

Identification

The Identification Spiral sets the stage for discovery of the described resource using text search engines. It includes a unique identifier for the metadata, a title, an abstract, theme keywords and contact information for the metadata and the dataset. In many dialects citations to the described resource are used to provide important information about how users should cite the documented resource that is described by the metadata. These citations are an important part of the identification information and, as such, they are in a special location in the record.

Crosswalks

Concept Description Paths
Metadata Identifier A unique reference to the record within the catalogue (Metadata Identifier) DIF /dif:Entry_Id
ISO /*/gmd:fileIdentifier/gco:CharacterString
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
Dryad dcterms:title
ECHO /echo:Collection/echo:ShortName>/echo:Collection/echo:LongName
EML /eml:dataset/eml:title/eml:text
FGDC /fgdc:metadata/fgdc:idinfo/fgdc:citation/fgdc:citeinfo/fgdc:title
ISO /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString
ISO-1 /*/mdb:identificationInfo/*/rmd:citation/cit:CI_Citation/cit:title/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceIdentification/ows:Title
THREDDS /thredds:catalog/thredds:dataset/@thredds:name
THREDDS /thredds:catalog/thredds:dataset/thredds:metadata/thredds:@dc:title
netCDF /nc:netcdf/nc:attribute[@name=title]
Abstract A paragraph describing the resource. DIF /dif:DIF/dif:Summary/dif:Abstract
Dryad dcterms:description
ECHO /echo:Collection/Description
EML /eml:dataset/eml:abstract/eml:descendant
FGDC /fgdc:metadata/fgdc:idinfo/fgdc:descript/fgdc:abstract
ISO /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString
ISO-1 /*/mdb:identificationInfo/*/rmd:abstract/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceIdentification/ows:Abstract
THREDDS /thredds:catalog/thredds:metadata/thredds:documentation[@thredds:type=summary]
netCDF /nc:netcdf/nc:attribute[@name=summary]
Topic Category High level category enumeration used in ISO ISO /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:topicCategory/gmd:MD_TopicCategoryCode
Keyword A comma separated list of key words and phrases. Can be one of several types. DIF /dif:DIF/dif:Parameters/dif:Category > //dif:Parameters/dif:Topic > //dif:Parameters/dif:Term

> //dif:Parameters/dif:Variable_Level_1 > //dif:Parameters/dif:Variable_Level_2 > //dif:Parameters/dif:Variable_Level_3 > //dif:Parameters/dif: > //dif:Parameters/dif:Variable_Level_3
Dryad dcterms:subject
ECHO / echo:Collection/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword>//echo:TopicKeyword>//echo:TermKeyword>//echo:VariableLevel1Keyword/echo:Value>//echo:VariableLevel2Keyword/echo:Value>//echo:VariableLevel3Keyword>//echo:DetailedVariableKeyword
ECS METADATA > COLLECTIONMETADATA > DisciplineTopicParameters > DisciplineTopicParametersContainer.ECSDisciplineKeyword > DisciplineTopicParametersContainer.ECSParameterKeyword > DisciplineTopicParametersContainer.ECSTermKeyword

> DisciplineTopicParametersContainer.ECSTopicKeyword
EML /eml:dataset/eml:keywordSet/eml:keyword/eml:text
FGDC /fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:theme/fgdc:themekey |/fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:place/fgdc:placekey
ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString
OGC-SOS /sos:Capabilities/ows:ServiceIdentification/ows:Keywords/ows:Keyword
THREDDS thredds:catalog/thredds:metadata/thredds:keyword
THREDDS thredds:catalog/thredds:dataset/thredds:keyword
netCDF /nc:netcdf/nc:attribute[@name=keywords]
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.

ISO /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString
netCDF /nc:netcdf/nc:attribute[@name=keyword_vocabulary]
Metadata Contact The organization or person currently responsible for the metadata. DIF /dif:DIF/dif:Personnel[dif:Role='DIF AUTHOR']
DIF /dif:DIF/dif:Originating_Metadata_Node
ISO /*/gmd:contact
OGC-SOS /sos:Capabilities/ows:ServiceProvider
Resource Contact The organization or person responsible for answering questions about the resource. DIF /dif:DIF/dif:Personnel[dif:Role='INVESTIGATOR']
ISO /*/gmd:identificationInfo/*/gmd:pointOfContact
OGC-SOS /sos:Capabilities/ows:ServiceProvider
Complete Citation Complete citation for the resource ECHO /echo:Collection/echo:CitationForExternalPublication

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.