Difference between revisions of "Documenting Citations"

From Earth Science Information Partners (ESIP)
Line 67: Line 67:
 
</table>
 
</table>
  
<table border="1" cellpadding="5">
+
<table border="1" cellpadding="5"> <tr> <th width="20%" valign="top">Usage</th> <th width="60%" valign="top">Description and Xpath</th> </tr> <tr> <td align="center">Identifier <gallery> File:180px-WhereAreCI_Citations.MD_Identifier.png </gallery> </td> <td> CI_Citation + code = MD_Identifier The MD_Identifier is the simplest of the CI_Citation++ objects. It includes a code and an authority. The code is an alphanumeric value identifying an object in a namespace that is maintained by the authority. In this case the CI_Citation cites the authority for the code. In many ways this is similar to the namespace for the code. It is the authority which understands and can explain or resolve the code. There is no agreed upon approach for how the namespace is described in the CI_Citation. ISO 19115-1 addresses this limitation by adding a codeSpace field to the MD_Identifier object. The codeSpace field unambiguously defines the namespace for the identifier. ISO 19115-1 also includes description and version fields in the MD_Identifier object. The description field enables a brief description of the code to be documented, and the version field enables the the Identifier version to be documented. //gmd:MD_Identifier </td> </tr> <tr> <td align="center">Reference System Identifier <gallery> File:180px-WhereAreCI_Citations.RS_Identifier.png </gallery> </td> <td> CI_Citation + code + codeSpace + version = RS_Identifier The RS_Identifier extends the MD_Identifier by adding a codeSpace and a version for the namespace. These additions address the lack of an agreed upon approach for describing a namespace using the authority/gco:CI_Citation alone. However, the standard only supports RS_Identifiers in the referenceSystemInfo class. Note: In ISO 19115-1 the RS_Identifier object is replaced with an MD_Identifier object which includes codeSpace, version and description fields. See the MD_Identifier description above. //gmd:RS_Identifier </td> </tr> <tr> <td align="center">Keyword Thesaurus Citation <gallery> File:180px-WhereAreCI_Citations.MD_Keywords.png </gallery> </td> <td> CI_Citation + keyword + type = MD_Keywords The MD_Keywords object is similar to an MD_Identifier in that it gives a keyword that is unique in a "namespace" that is maintained by the individual or organization cited in the thesaurusName. In this case, the type codeList is used to group related keywords. Note: In ISO 19115-1, 10 additional GCMD keyword type codes have been added to the codelist. These codes will help improve consistent data discovery, particularly using faceted searches. /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification | srv:ServiceIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName </td> </tr> <tr> <td align="center">Algorithm Citation <gallery> File:180px-WhereAreCI_Citations.LE_Algorithm.png </gallery> </td> <td> CI_Citation + description = LE_Algorithm The Algorithm Citation is straightforward. It includes a description that, like the description in the CI_OnlineResource object, should provide information that identifies the algorithm used to process data so that a user can understand that information without following the citation. The description is similar to an abstract for the algorithm referenced in the CI_Citation. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:processStep/gmd:LE_ProcessStep/gmd:processingInformation/gmd:LE_Processing/gmd:algorithm/LE_Algorithm/gmd:citation </td> </tr> <tr> <td align="center">Conformance Standard Specification Citation <gallery> File:180px-WhereAreCI_Citations.DQ_ConformanceResult.png </gallery> </td> <td> CI_Citation + explanation + pass = DQ_ConformanceResult The DQ_ConformanceResult is a good example of including critical information in the standard while referencing an external resource for more information. In this case the critical information is a brief explanation of the conformance test and the result of the test. If a user needs more information about the specifics of the test, they can follow the citation to the specification. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:result/gmd:DQ_Result/gmd:DQ_ConformanceResult/gmd:specification </td> </tr> <tr> <td align="center">Source Citation <gallery> File:180px-WhereAreCI_Citations.LE_Source.png </gallery> </td> <td> CI_Citation + description + scaleDenominator + sourceReferenceSystem + sourceExtent + processedLevel + resolution + sourceStep = LE_Source. LE_Source fields enable the sources utilized to generate a data product to be described and referenced. Sources are both used and produced by process steps. Documenting the chain of sources and process steps utilized to generated a data product is an important role of high-quality metadata. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:source | gmd:output/gmd:LE_Source/gmd:sourceCitation </td> </tr> <tr> <td align="center">Data Quality Evaluation Procedure Citation <gallery> File:180px-WhereAreCI_Citations.DQ_Element.png </gallery> </td> <td> /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:evaluationProcedure </td> </tr> <tr> <td align="center">Feature Catalog Citation <gallery> File:180px-WhereAreCI_Citations.MD_FeatureCatalogDescription.png </gallery> </td> <td> /gmi:MI_Metadata/gmd:contentinfo/gmd:MD_ContentInformation/gmd:MD:FeatureCatalogDescription/gmd:featureCatalogueCitation </td> </tr> <tr> <td align="center">Application Schema Citation <gallery> File:180px-WhereAreCI_Citations.MD_ApplicationSchemaInformation.png </gallery> </td> <td> CI_Citation + schemaLanguage + constraintLanguage + schemaAscii + graphicsFile + softwareDevelopmentFile + softwareDevelopmentFIleFormat = MD_ApplicationSchemaInformation /gmi:MI_Metadata/gmd:applicationSchemaInfo/gmd:MD_ApplicationSchemaInformation/gmd:name </td> </tr> </table>
            <tr>
 
                <th width="20%" valign="top">Usage</th>
 
                <th width="60%" valign="top">Description and Xpath</th>
 
            </tr>
 
            <tr>
 
                <td align="center">Identifier
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.MD_Identifier.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + code = MD_Identifier
 
                   
 
                    The MD_Identifier is the simplest of the CI_Citation++ objects. It includes a code and an authority. The code is an alphanumeric value identifying an object in a namespace that is maintained by the authority. In this case the CI_Citation cites the authority for the code. In many ways this is similar to the namespace for the code. It is the authority which understands and can explain or resolve the code. There is no agreed upon approach for how the namespace is described in the CI_Citation.
 
                   
 
                    ISO 19115-1 addresses this limitation by adding a codeSpace field to the MD_Identifier object. The codeSpace field unambiguously defines the namespace for the identifier. ISO 19115-1 also includes description and version fields in the MD_Identifier object.   The description field enables a brief description of the code to be documented, and the version field enables the the Identifier version to be documented.
 
                    //gmd:MD_Identifier
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Reference System Identifier
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.RS_Identifier.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + code + codeSpace + version = RS_Identifier
 
                   
 
                    The RS_Identifier extends the MD_Identifier by adding a codeSpace and a version for the namespace. These additions address the lack of an agreed upon approach for describing a namespace using the authority/gco:CI_Citation alone. However, the standard only supports RS_Identifiers in the referenceSystemInfo class.
 
                   
 
                    Note: In ISO 19115-1 the RS_Identifier object is replaced with an MD_Identifier object which includes codeSpace, version and description fields. See the MD_Identifier description above.
 
                   
 
                   
 
                    //gmd:RS_Identifier
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Keyword Thesaurus Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.MD_Keywords.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + keyword + type = MD_Keywords
 
                   
 
                    The MD_Keywords object is similar to an MD_Identifier in that it gives a keyword that is unique in a "namespace" that is maintained by the individual or organization cited in the thesaurusName. In this case, the type codeList is used to group related keywords.
 
                   
 
                    Note: In ISO 19115-1, 10 additional GCMD keyword type codes have been added to the codelist. These codes will help improve consistent data discovery, particularly using faceted searches.
 
                    /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification | srv:ServiceIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Algorithm Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.LE_Algorithm.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + description = LE_Algorithm
 
                   
 
                    The Algorithm Citation is straightforward. It includes a description that, like the description in the CI_OnlineResource object, should provide information that identifies the algorithm used to process data so that a user can understand that information without following the citation. The description is similar to an abstract for the algorithm referenced in the CI_Citation.
 
                   
 
                    /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:processStep/gmd:LE_ProcessStep/gmd:processingInformation/gmd:LE_Processing/gmd:algorithm/LE_Algorithm/gmd:citation
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Conformance Standard Specification Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.DQ_ConformanceResult.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + explanation + pass = DQ_ConformanceResult
 
                   
 
                    The DQ_ConformanceResult is a good example of including critical information in the standard while referencing an external resource for more information. In this case the critical information is a brief explanation of the conformance test and the result of the test. If a user needs more information about the specifics of the test, they can follow the citation to the specification.
 
                   
 
                    /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:result/gmd:DQ_Result/gmd:DQ_ConformanceResult/gmd:specification
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Source Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.LE_Source.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + description + scaleDenominator + sourceReferenceSystem + sourceExtent + processedLevel + resolution + sourceStep = LE_Source. LE_Source fields enable the sources utilized to generate a data product to be described and referenced. Sources are both used and produced by process steps. Documenting the chain of sources and process steps utilized to generated a data product is an important role of high-quality metadata.
 
                   
 
                    /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:source | gmd:output/gmd:LE_Source/gmd:sourceCitation
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Data Quality Evaluation Procedure Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.DQ_Element.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:evaluationProcedure
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Feature Catalog Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.MD_FeatureCatalogDescription.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    /gmi:MI_Metadata/gmd:contentinfo/gmd:MD_ContentInformation/gmd:MD:FeatureCatalogDescription/gmd:featureCatalogueCitation
 
                </td>
 
            </tr>
 
            <tr>
 
                <td align="center">Application Schema Citation
 
                    <gallery>
 
                        File:180px-WhereAreCI_Citations.MD_ApplicationSchemaInformation.png
 
                    </gallery>
 
                </td>
 
                <td>
 
                    CI_Citation + schemaLanguage + constraintLanguage + schemaAscii + graphicsFile + softwareDevelopmentFile + softwareDevelopmentFIleFormat = MD_ApplicationSchemaInformation
 
                   
 
                    /gmi:MI_Metadata/gmd:applicationSchemaInfo/gmd:MD_ApplicationSchemaInformation/gmd:name
 
                </td>
 
            </tr>  
 
        </table>
 

Revision as of 14:52, January 4, 2017


Overview

Citations are used to provide information about citing the resource being described in the metadata or to refer to resources outside of the metadata record. These citations are an important part of the identification information and, as such, they are in a special location in the record. In addition, they can provide connection to relevant materials that can not be included in the metadata.

Structure

The CI_Citation includes two required and eleven optional elements and introduces several new objects. The CI_Series object gives the name, issue, and page numbers of an article in a periodical. The ISBN and ISSN elements are internationally recognized identifiers for books and periodicals. The MI_Identifier and CI_Date objects are discussed below.

Usage

CI_Citation serves two purposes in the ISO 19115 Standard. First, it gives the information required to cite the data or the service (the resource) that is being described in the metadata. This CI_Citation can be part of the gmd:MD_DataIdentification or srv:ServiceIdentification objects.

Usage Description and Xpath
Resource Citation

The Resource Citation includes information that should be used when citing the resource that is being described by the metadata record. It includes descriptions of the people involved in the creation of the resource. They usually have roles of originator, author, or principleInvestigator.

An important enhancement to the CI_Citation object occured in ISO 19115-1. The enhancement includes the addition of OnlineResource and BrowseGraphic fields which enable online digital resources and graphics to be referenced from the CI_Citation object. An expanded description is available in the Revisions section of this page.

/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation


or

/gmi:MI_Metadata/gmd:identificationInfo/srv:ServiceIdentification/gmd:citation

CI_Citation++

Second, CI_Citations provide information about external references that are related to the resource being described and provide additional documentation. This Figure shows most of the places where CI_Citations occur. Those shown in red were added in ISO 19115-1. In many of these situations the CI_Citation is in an object with a generally small amount of additional annotation information. This additional information is available to the user so they may not need to look up the resource cited in the CI_Citation. These objects are termed CI_Citation++.

The most straightforward member of this group is the MI_Identifier, which includes a code, the identifier, and a CI_Citation for the authority for the code. The MD_Identifier is used throughout the standard to attach a unique identifier to objects, including CI_Citations.

Usage Description and Xpath
Identifier CI_Citation + code = MD_Identifier The MD_Identifier is the simplest of the CI_Citation++ objects. It includes a code and an authority. The code is an alphanumeric value identifying an object in a namespace that is maintained by the authority. In this case the CI_Citation cites the authority for the code. In many ways this is similar to the namespace for the code. It is the authority which understands and can explain or resolve the code. There is no agreed upon approach for how the namespace is described in the CI_Citation. ISO 19115-1 addresses this limitation by adding a codeSpace field to the MD_Identifier object. The codeSpace field unambiguously defines the namespace for the identifier. ISO 19115-1 also includes description and version fields in the MD_Identifier object. The description field enables a brief description of the code to be documented, and the version field enables the the Identifier version to be documented. //gmd:MD_Identifier
Reference System Identifier CI_Citation + code + codeSpace + version = RS_Identifier The RS_Identifier extends the MD_Identifier by adding a codeSpace and a version for the namespace. These additions address the lack of an agreed upon approach for describing a namespace using the authority/gco:CI_Citation alone. However, the standard only supports RS_Identifiers in the referenceSystemInfo class. Note: In ISO 19115-1 the RS_Identifier object is replaced with an MD_Identifier object which includes codeSpace, version and description fields. See the MD_Identifier description above. //gmd:RS_Identifier
Keyword Thesaurus Citation CI_Citation + keyword + type = MD_Keywords The MD_Keywords object is similar to an MD_Identifier in that it gives a keyword that is unique in a "namespace" that is maintained by the individual or organization cited in the thesaurusName. In this case, the type codeList is used to group related keywords. Note: In ISO 19115-1, 10 additional GCMD keyword type codes have been added to the codelist. These codes will help improve consistent data discovery, particularly using faceted searches. /gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification | srv:ServiceIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName
Algorithm Citation CI_Citation + description = LE_Algorithm The Algorithm Citation is straightforward. It includes a description that, like the description in the CI_OnlineResource object, should provide information that identifies the algorithm used to process data so that a user can understand that information without following the citation. The description is similar to an abstract for the algorithm referenced in the CI_Citation. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:processStep/gmd:LE_ProcessStep/gmd:processingInformation/gmd:LE_Processing/gmd:algorithm/LE_Algorithm/gmd:citation
Conformance Standard Specification Citation CI_Citation + explanation + pass = DQ_ConformanceResult The DQ_ConformanceResult is a good example of including critical information in the standard while referencing an external resource for more information. In this case the critical information is a brief explanation of the conformance test and the result of the test. If a user needs more information about the specifics of the test, they can follow the citation to the specification. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:result/gmd:DQ_Result/gmd:DQ_ConformanceResult/gmd:specification
Source Citation CI_Citation + description + scaleDenominator + sourceReferenceSystem + sourceExtent + processedLevel + resolution + sourceStep = LE_Source. LE_Source fields enable the sources utilized to generate a data product to be described and referenced. Sources are both used and produced by process steps. Documenting the chain of sources and process steps utilized to generated a data product is an important role of high-quality metadata. /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:lineage/gmd:LE_Lineage/gmd:source | gmd:output/gmd:LE_Source/gmd:sourceCitation
Data Quality Evaluation Procedure Citation /gmi:MI_Metadata/gmd:dataQualityInfo/gmd:MD_DataQuality/gmd:report/gmd:DQ_Element/gmd:evaluationProcedure
Feature Catalog Citation /gmi:MI_Metadata/gmd:contentinfo/gmd:MD_ContentInformation/gmd:MD:FeatureCatalogDescription/gmd:featureCatalogueCitation
Application Schema Citation CI_Citation + schemaLanguage + constraintLanguage + schemaAscii + graphicsFile + softwareDevelopmentFile + softwareDevelopmentFIleFormat = MD_ApplicationSchemaInformation /gmi:MI_Metadata/gmd:applicationSchemaInfo/gmd:MD_ApplicationSchemaInformation/gmd:name