Difference between revisions of "Documenting Projects"

From Earth Science Information Partners (ESIP)
(Created page with "The Arctic Research Mapping Application ([http://armap.org ARMAP]) brings together a multi-disciplinary collection of nearly three thousand NSF funded projects focused on char...")
 
Line 3: Line 3:
 
=Project Identification=
 
=Project Identification=
 
Identification information is used in the Project Metadata Profile implementation for ARMAP to support two types of information discovery: 1) text searches for titles and 2) unambiguous identification by a number of related organizations. Titles are included in the project citations along with links to project logistics reports (HTML metadata sum-maries). Identifiers are provided from the primary organization responsible for the pro-ject and the host organization (ARMAP in this case). In addition, there is a UUID included that unambiguously identifies the project independently from any organization.
 
Identification information is used in the Project Metadata Profile implementation for ARMAP to support two types of information discovery: 1) text searches for titles and 2) unambiguous identification by a number of related organizations. Titles are included in the project citations along with links to project logistics reports (HTML metadata sum-maries). Identifiers are provided from the primary organization responsible for the pro-ject and the host organization (ARMAP in this case). In addition, there is a UUID included that unambiguously identifies the project independently from any organization.
==Crosswalks==<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;">
+
==Crosswalks==
 +
<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>
 
   <tr>
 
       <th>Concept</th>
 
       <th>Concept</th>
Line 10: Line 11:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
       <td style="word-break:break-all;">Resource Title</td>
+
       <td>Resource Title</td>
 
       <td style="word-break:break-all;">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.
 
       <td style="word-break:break-all;">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.
 
       </td>
 
       </td>
Line 16: Line 17:
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
       <td style="word-break:break-all;">Online Resource</td>
+
       <td>Online Resource</td>
 
       <td style="word-break:break-all;">Online Resource for the cited resource</td>
 
       <td style="word-break:break-all;">Online Resource for the cited resource</td>
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:citation/adiwg:citeinfo/adiwg:onlink<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Online_Resource<br><b>DIF</b> /dif:DIF/dif:Reference/dif:Online_Resource<br><b>ISO</b> //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource<br><b>ISO-1</b> //cit:CI_Citation/cit:onlineResource/cit:CI_OnlineResource<br></td>
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:citation/adiwg:citeinfo/adiwg:onlink<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Online_Resource<br><b>DIF</b> /dif:DIF/dif:Reference/dif:Online_Resource<br><b>ISO</b> //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource<br><b>ISO-1</b> //cit:CI_Citation/cit:onlineResource/cit:CI_OnlineResource<br></td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
       <td style="word-break:break-all;">Resource Identifier</td>
+
       <td>Resource Identifier</td>
 
       <td style="word-break:break-all;">Identifier for the resource described by the metadata</td>
 
       <td style="word-break:break-all;">Identifier for the resource described by the metadata</td>
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:projguid<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Dataset_DOI<br><b>DIF</b> /dif:DIF/dif:Reference/dif:DOI<br><b>ECHO</b> /*/echo:DataSetId<br><b>ECHO</b> (1)  /*/echo:ShortName | /*/echo:LongName<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO-1</b> //cit:CI_Citation/cit:identifier/cit:MD_Identifier/cit:code<br></td>
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:projguid<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Dataset_DOI<br><b>DIF</b> /dif:DIF/dif:Reference/dif:DOI<br><b>ECHO</b> /*/echo:DataSetId<br><b>ECHO</b> (1)  /*/echo:ShortName | /*/echo:LongName<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO-1</b> //cit:CI_Citation/cit:identifier/cit:MD_Identifier/cit:code<br></td>
 
   </tr>
 
   </tr>
 
   <tr>
 
   <tr>
       <td style="word-break:break-all;">Naming Authority</td>
+
       <td>Naming Authority</td>
 
       <td style="word-break:break-all;">The organization responsible for the maintenance of the identifier (namespace)</td>
 
       <td style="word-break:break-all;">The organization responsible for the maintenance of the identifier (namespace)</td>
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace
 
       <td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode<br><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:authority<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:codeSpace

Revision as of 16:41, August 25, 2014

The Arctic Research Mapping Application (ARMAP) brings together a multi-disciplinary collection of nearly three thousand NSF funded projects focused on characterizing and understanding the Arctic environment. These projects are described in a standard and structured way using a metadata profile developed during 2011 by the Alaska Data Integration working group (ADIwg). This profile was originally derived from the FGDC Content Standard for Digital Geospatial Metadata (documentation from the original ADIwg wiki will be available at https://github.com/adiwg/project-metadata-fgdc). It includes a number of fundamental documentation concepts that, taken together, have been proven to make up a successful framework for providing access to information about NSF funded projects in the Arctic region and their geographic distribution. The fundamental project documentation concepts and how these concepts might be shared across a broader community using other metadata dialects are described here.

Project Identification

Identification information is used in the Project Metadata Profile implementation for ARMAP to support two types of information discovery: 1) text searches for titles and 2) unambiguous identification by a number of related organizations. Titles are included in the project citations along with links to project logistics reports (HTML metadata sum-maries). Identifiers are provided from the primary organization responsible for the pro-ject and the host organization (ARMAP in this case). In addition, there is a UUID included that unambiguously identifies the project independently from any organization.

Crosswalks

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. ADIwg /adiwg:project/adiwg:idinfo/adiwg:citation/adiwg:citeinfo/adiwg:title
DIF /dif:DIF/dif:Entry_Title
ECHO /*/echo:ShortName>/*/echo:LongName
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
Online Resource Online Resource for the cited resource ADIwg /adiwg:project/adiwg:idinfo/adiwg:citation/adiwg:citeinfo/adiwg:onlink
DIF /dif:DIF/dif:Data_Set_Citation/dif:Online_Resource
DIF /dif:DIF/dif:Reference/dif:Online_Resource
ISO //gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource
ISO-1 //cit:CI_Citation/cit:onlineResource/cit:CI_OnlineResource
Resource Identifier Identifier for the resource described by the metadata ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:projguid
ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode
ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode
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
ISO-1 //cit:CI_Citation/cit:identifier/cit:MD_Identifier/cit:code
Naming Authority The organization responsible for the maintenance of the identifier (namespace) ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode
ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode
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)

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.