Documenting Projects

From Earth Science Information Partners (ESIP)
Revision as of 17:54, August 25, 2014 by Ted.Habermann (talk | contribs)

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
Project Sponsor The organization responsible for funding the project. ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgcode
Sponsor Project Identifier An identifier for the project used by the organization responsible for funding the project. ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgproj
Project Host The organization responsible for hosting a project website or including it in a portal. ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:hostorgcode
Host Project Identifier An identifier for the project used by the organization responsible for hosting a project website or including it in a portal. ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:primorgproj
Resource Identifier Identifier for the resource described by the metadata ADIwg /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:projguid
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

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.