Difference between revisions of "Attribute Conventions for Data Discovery 2.0"

From Earth Science Information Partners (ESIP)
(made a redirect)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
        <font color="red">'''DRAFT - Not ready for use'''</font>
+
#REDIRECT [[Attribute Convention for Data Discovery 2.0]]
== Version and Status ==
 
This version is designated as Version 2.0
 
This page always has the current version of the Attribute Convention for Data Discovery (ACDD). As it is updated, the version number at the top of the page will be updated.
 
 
 
See the [[http://wiki.esipfed.org/index.php/Category:Attribute_Conventions_Dataset_Discovery category page]] for information on the history of this convention.
 
 
 
=== Development ===
 
 
 
Any development version of the ACDD definitions is maintained at [[Attribute_Convention_for_Data_Discovery_(ACDD)_Working]].
 
 
 
= Overview =
 
The NetCDF Group at Unidata has recommended  [http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html attributes for data discovery] . The Attribute Convention for Data Discovery (ACDD) addresses that need, providing definitions for NetCDF global attributes that will help data to be located efficiently. 
 
 
 
== Alignment with NetCDF and CF Conventions ==
 
The NetCDF User Guide [http://www.unidata.ucar.edu/software/netcdf/docs/netcdf.html (NUG)] provides basic recommendations for creating NetCDF files; the NetCDF Climate and Forecast Metadata Conventions [http://cf-pcmdi.llnl.gov/documents/cf-conventions/latest-cf-conventions-document-1/ (CF)]  provides more specific guidance. The ACDD builds upon and is compatible with these conventions; it may refine the definition of some terms in those conventions, but does not preclude the use of any attributes defined by the NUG or CF.
 
 
 
The NUG does not require any global attributes, though it recommends and defines two, title and history; CF specifies many more. ACDD 1.2 adopts all CF 1.6 global attributes with the exception of 'institution'; we specify 'creator_institution' and 'publisher_institution', to provide more provenance information. We also modify the syntax of the 'Conventions' attribute; we adopt the NUG recommendation to supply all conventions in a single attribute. This change has been approved by the CF Conventions Committee and will be part of CF 1.7, which is not yet published.
 
 
 
== Attribute Crosswalks ==
 
Many of these attributes correspond to general discovery metadata content, so they are available in many metadata standards. This [http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html Unidata crosswalk to THREDDS] page includes also includes a crosswalk to ISO 19115-2. Note that the attribute names link to the Unidata definitions. Many of these elements are included in the [https://geo-ide.noaa.gov/wiki/index.php?title=ISO_19115_Core_Elements ISO 19115 Core] specification. They are indicated in this Table by an M, O, or C in parentheses. An “M” indicates that the element is mandatory. An “O” indicates that the element is optional. A “C” indicates that the element is mandatory under certain conditions.
 
 
 
== Additional Metadata: metadata_link attribute ==
 
 
 
Other metadata dialects (i.e. ISO 19115) can provide information about collections and more details about the dataset. If additional metadata exists, you can make users aware of it by adding a global attribute named "metadata_link" to the netCDF file. The value of this attribute is a URL that gives the location of the more complete metadata.
 
 
 
<!--
 
== Conformance Test ==
 
A [https://geo-ide.noaa.gov/wiki/index.php?title=NetCDF_Attribute_Convention_for_Dataset_Discovery_Conformance_Test Conformance Test] is available for this convention.
 
-->
 
 
 
== Maintenance of Metadata ==
 
 
 
ACDD attributes, like all NetCDF attributes, characterize their containing (parent) granules. As NetCDF data are processed (e.g., through subsetting or other algorithms), these characteristics can be altered. The software or user processor is responsible to update these attributes as part of the processing, but some software processes and user practices leave them unchanged. This affects both consumers and producers of these files, which comprises three roles:
 
* developers of software tools that process NetCDF files;
 
* users that create new NetCDF files from existing ones; and
 
* end users of NetCDF files.
 
 
 
NetCDF file ''creators'' (the first two roles) should ensure that the attributes of output files accurately represent those files, and specifically should not "pass through" any source attribute in unaltered form, unless it is known to remain accurate. NetCDF file ''users'' (all three roles) should verify critical attribute values, and understand how the source data and metadata were generated, to be confident the source metadata is current.
 
 
 
The ACDD geospatiotemporal attributes present a special case, as this information is already fully defined by the CF coordinate variables (the redundant attributes are recommended to simplify access).  Errors in these attributes will create an inconsistency between the metadata and data of the granule or file.  The risk of these 'inconsistency errors' is highest for files that are aggregated into longer or larger products, or subset into shorter or smaller products, such as files from numerical forecast models and gridded satellite observations. For this reason, some providers of those data types may choose to omit the ACDD geospatiotemporal attributes from their files. If the ACDD geospatiotemporal attributes are present, checking them against the CF coordinate variables can serve as a partial test of the metadata's validity.
 
 
 
<!--''{(Not for inclusion in final draft) As a working tool, the page [[NetCDF Utilities Metadata Handling]] has been created to identify the state of play for how tools handle metadata attributes when processing files.}''-->
 
 
 
==Metadata Link==
 
The netCDF metadata model is focused on providing "use metadata" for the data included in the file (or granule). Other metadata dialects (i.e. ISO 19115) can provide information about collections and more details about the dataset. In order to make users aware of that additional metadata we recommend adding a global attribute named "Metadata_Link" to the netCDF file. The value of this attribute is a URL that gives the location of the more complete metadata. This element is not included in the current version of the NetCDF Attribute Convention for Dataset Discovery.
 
 
 
=Highly Recommended=
 
<table width="95%" border="1" cellpadding="2" cellspacing="2">
 
    <tr>
 
      <th valign="top">Attribute</th>
 
      <th valign="top">Description</th>
 
      <th valign="top">THREDDS</th>
 
      <th valign="top">ISO 19115-2</th>
 
      <th valign="top">OGC CSW</th>
 
      <th valign="top">Rubric Category</th>
 
</tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#title_Attribute title]<br>
 
      </td>
 
      <td valign="top">A short description of the dataset.<br>
 
      </td>
 
      <td valign="top">dataset@name<br>
 
      </td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString (M)<br>
 
      </td>
 
<td>Title</td>
 
<td>Text Search</td>
 
    </tr>
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#summary_Attribute summary]<br>
 
      </td>
 
      <td valign="top">A paragraph describing the dataset.<br>
 
      </td>
 
      <td valign="top">metadata/documentation[@type="summary"]<br>
 
      </td>
 
  <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:abstract/gco:CharacterString (M)<br>
 
  </td>
 
<td>Abstract</td>
 
<td>Text Search</td>
 
</tr>
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_Attribute keywords]<br>
 
      </td>
 
      <td valign="top">A comma separated list of key words and phrases.<br>
 
      </td>
 
  <td valign="top">metadata/keyword<br>
 
  </td>
 
  <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString<br>
 
  </td>
 
<td>Subject</td>
 
<td>Text Search</td>
 
    </tr>
 
</table>
 
 
 
=Recommended=
 
<table width="95%" border="1" cellpadding="2" cellspacing="2">
 
    <tr>
 
      <th valign="top">Attribute</th>
 
      <th valign="top">Description</th>
 
      <th valign="top">THREDDS</th>
 
      <th valign="top">ISO 19115-2</th>
 
      <th valign="top">OGC CSW</th>
 
      <th valign="top">Rubric Category</th>
 
    </tr>   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#id_Attribute id]<br>
 
      </td>
 
      <td rowspan="2" colspan="1" valign="top">The
 
combination of the "naming authority" and the "id" should be a globally unique identifier for the dataset.<br>
 
      </td>
 
      <td rowspan="2" valign="top">dataset@id<br>
 
      </td>
 
      <td rowspan="2" colspan="1" valign="top">/gmi:MI_Metadata/gmd:fileIdentifier/gco:CharacterString (O)<br>
 
      </td>
 
<td rowspan="2">Identifier</td>
 
<td rowspan="2">Identifier</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#naming_authority_Attribute naming_authority]<br>
 
      </td>
 
          </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#keywords_vocabulary_Attribute keywords_vocabulary]<br>
 
      </td>
 
      <td valign="top">If you are following a guideline for the words/phrases in your "keywords" attribute, put the name of that guideline here.<br>
 
      </td>
 
      <td valign="top">metadata/keyword@vocabulary</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString <br>
 
      </td>
 
<td></td>
 
<td>Text Search</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#cdm_data_type_Attribute cdm_data_type]<br>
 
      </td>
 
      <td valign="top">The [http://www.unidata.ucar.edu/projects/THREDDS/tech/catalog/InvCatalogSpec.html#dataType THREDDS data type] appropriate for this dataset.</td>
 
      <td valign="top">metadata/dataType</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:spatialRepresentationType/gmd:MD_SpatialRepresentationTypeCode<br> May need some extensions to this codelist. Current values: vector, grid, textTable, tin, stereoModel, video.
 
</td>
 
<td></td>
 
<td>Other</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#history_Attribute history]<br></td>
 
      <td valign="top">Provides an audit trail for modifications to the original data.</td>
 
      <td valign="top">metadata/documentation[@type="history"]</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:lineage/gmd:LI_Lineage/gmd:statement/gco:CharacterString (O)</td>
 
<td></td>
 
<td>Text Search</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#comment_Attribute comment]<br>
 
      </td>
 
      <td valign="top">Miscellaneous information about the data.</td>
 
      <td valign="top">metadata/documentation<br>
 
      </td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:supplementalInformation<br>
 
      </td>
 
<td></td>
 
<td>Text Search</td> 
 
    </tr>
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#date_created_Attribute date_created]</td>
 
      <td valign="top">The date on which the data was created.<br>
 
      </td>
 
      <td valign="top">metadata/date[@type="created"]</td>   
 
  <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:Date (M)<br>
 
    /gmd:dateType/gmd:CI_DateTypeCode="creation"</br></td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#creator_name_Attribute creator_name]<br>
 
      </td>
 
      <td rowspan="4" colspan="1" valign="top">The data creator's name, URL, and email. The "institution" attribute will be used if the "creator_name" attribute does not exist. <br>
 
      </td>
 
      <td valign="top">metadata/creator/name<br></td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br>
 
        CI_RoleCode="originator" (O)</td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#creator_url_Attribute creator_url]<br>
 
      </td>     
 
      <td valign="top">metadata/creator/contact@url<br></td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL<br></td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#creator_email_Attribute creator_email]<br>
 
      </td>
 
     
 
      <td valign="top">metadata/creator/contact@email</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString</td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#institution_Attribute institution]<br>
 
      </td>
 
      <td valign="top">metadata/creator/name</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString</td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#project_Attribute project]<br>
 
      </td>
 
      <td valign="top">The scientific project that produced the data.<br>
 
      </td>
 
  <td valign="top">metadata/project<br></td>
 
  <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString<br/>and/or<br/>/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetName/gmd:CI_Citation/gmd:title/gco:CharacterString<br>DS_AssociationTypeCode="largerWorkCitation" and DS_InitiativeTypeCode="project"<br/>and/or<br/>
 
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString with gmd:MD_KeywordTypeCode="project"
 
</td>
 
<td></td>
 
<td>Responsible Party</td>     
 
    </tr>
 
   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#processing_level_Attribute processing_level]</td>
 
      <td valign="top">A textual description of the processing (or quality control) level of the data.<br>
 
      </td>
 
      <td valign="top">metadata/documentation[@type="processing_level"]</td>
 
<td></td><td></td><td></td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#acknowledgement_Attribute acknowledgement]</td><td valign="top">A place to acknowledge various type of support for the project that produced this data.<br>
 
      </td>
 
      <td valign="top">metadata/documentation[@type="funding"]</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:credit/gco:CharacterString</td>
 
      <td></td>
 
<td>Responsible Party</td>
 
    </tr> 
 
    <tr>
 
      <td valign="top">geospatial_bounds</td>
 
      <td>Describes geospatial extent using any of the geometric objects (2D or 3D) supported by the [http://en.wikipedia.org/wiki/Well-known_text Well-Known Text] (WKT) format.</td>
 
      <td></td>
 
      <td></td>
 
      <td>BoundingPolygon</td>
 
      <td>Extent</td>
 
    </tr>
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lat_min_Attribute geospatial_lat_min]<br>
 
      </td>
 
      <td rowspan="4" colspan="1" valign="top">Describes a simple latitude/longitude bounding box.  geospatial_lat_min specifies the southernmost latitude; geospatial_lat_max specifies the northernmost latitude; geospatial_lon_min specifies the westernmost longitude; geospatial_lon_max specifies the easternmost longitude of the bounding box.<br/>The values of geospatial_lon_min and geospatial_lon_max reflect the actual longitude data values. Cases where geospatial_lon_min is greater than geospatial_lon_max indicate the bounding box extends from geospatial_lon_max, through the longitude range discontinuity meridian (either the antimeridian or Prime Meridian), to geospatial_lon_min.<br/>For a more detailed geospatial coverage, see the [http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#suggested_geospatial suggested geospatial attributes].<br>
 
      </td>
 
      <td valign="top">metadata/geospatialCoverage/northsouth/start<br>
 
      </td>
 
  <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:southBoundLatitude/gco:Decimal<br>
 
  </td>
 
<td>BoundingBox</td>
 
<td>Extent</td>     
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lat_max_Attribute geospatial_lat_max]</td>
 
     
 
      <td valign="top">metadata/geospatialCoverage/northsouth/size</td>
 
     
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:northBoundLatitude/gco:Decimal<br>
 
      </td>
 
<td>BoundingBox</td>
 
<td>Extent</td>           
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lon_min_Attribute geospatial_lon_min]</td>
 
     
 
      <td valign="top">metadata/geospatialCoverage/eastwest/start</td>
 
     
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:westBoundLongitude/gco:Decimal<br>
 
      </td>
 
<td>BoundingBox</td>     
 
      <td>Extent</td>
 
</tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lon_max_Attribute geospatial_lon_max]</td>
 
     
 
      <td valign="top">metadata/geospatialCoverage/eastwest/size</td>
 
     
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicBoundingBox/gmd:eastBoundLongitude/gco:Decimal<br>
 
      </td>
 
<td>BoundingBox</td>
 
<td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_vertical_min_Attribute geospatial_vertical_min]<br>
 
      </td>
 
      <td rowspan="2" colspan="1" valign="top">Describes a simple vertical bounding box. For a more detailed geospatial coverage, see the [http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#suggested_geospatial suggested geospatial attributes].</td>
 
      <td valign="top">metadata/geospatialCoverage/updown/start</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:verticalElement/gmd:EX_VerticalExtent/gmd:minimumValue/gco:Real</td>
 
<td></td>
 
<td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_vertical_max_Attribute geospatial_vertical_max]</td>     
 
      <td valign="top">metadata/geospatialCoverage/updown/size</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:verticalElement/gmd:EX_VerticalExtent/gmd:maximumValue/gco:Real</td>
 
<td></td>
 
<td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#time_coverage_start_Attribute time_coverage_start]</td>
 
      <td rowspan="4" colspan="1" valign="top">Describes the temporal coverage of the data as a time range.</td>
 
      <td valign="top">metadata/timeCoverage/start</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:beginPosition</td>
 
<td></td>
 
<td>Extent</td>     
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#time_coverage_end_Attribute time_coverage_end]</td>
 
      <td valign="top">metadata/timeCoverage/end</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:endPosition</td>
 
<td></td>
 
<td>Extent</td>     
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#time_coverage_duration_Attribute time_coverage_duration]</td>
 
      <td valign="top">metadata/timeCoverage/duration</td>
 
<td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:temporalElement/gmd:EX_TemporalExtent/gmd:extent/gml:TimePeriod/gml:beginPosition provides an ISO8601 compliant description of the time period covered by the dataset. This standard supports descriptions of [http://en.wikipedia.org/wiki/ISO_8601#Durations durations].</td>
 
<td></td>
 
<td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#time_coverage_resolution_Attribute time_coverage_resolution]</td>
 
      <td valign="top">metadata/timeCoverage/resolution</td>
 
<td></td>
 
<td></td>
 
<td>Extent</td>     
 
    </tr><tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#standard_name_vocabulary_Attribute standard_name_vocabulary]<br>
 
      </td>
 
      <td valign="top">The name of the controlled vocabulary from which variable standard names are taken.<br>
 
      </td>
 
      <td valign="top">metadata/variables@vocabulary</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:thesaurusName/gmd:CI_Citation/gmd:title/gco:CharacterString <br></td>
 
<td></td>
 
<td>Text Search</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#license_Attribute license]</td>
 
      <td valign="top">Describe the restrictions to data access and distribution. </td>
 
      <td valign="top">metadata/documentation[@type="rights"]</td>
 
<td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:resourceConstraints/gmd:MD_LegalConstraints/gmd:useLimitation/gco:CharacterString<br></td>
 
<td></td><td></td>
 
    </tr>
 
</table>
 
 
 
=Suggested=
 
<table width="95%" border="1" cellpadding="2" cellspacing="2">
 
    <tr>
 
      <th valign="top">Attribute</th>
 
      <th valign="top">Description</th>
 
      <th valign="top">THREDDS</th>
 
      <th valign="top">ISO 19115-2</th>
 
      <th valign="top">OGC CSW</th>
 
      <th valign="top">Rubric Category</th>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#contributor_name_Attribute contributor_name]<br>
 
      </td>
 
      <td rowspan="2" colspan="1" valign="top">The name and role of any individuals or institutions that contributed to the creation of this data.<br>
 
      </td>
 
      <td valign="top">metadata/contributor<br>
 
      </td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br>
 
        </td>
 
<td></td>
 
<td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#contributor_role_Attribute contributor_role]<br>
 
      </td>
 
     
 
      <td valign="top">metadata/contributor@role</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode<br>
 
        ="principalInvestigator" | "author"</td>
 
<td></td><td>Responsible Party</td>
 
    </tr>
 
   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#publisher_name_Attribute publisher_name]<br>
 
      </td>
 
      <td rowspan="3" colspan="1" valign="top">The data publisher's name, URL, and email. The publisher may be an individual or an institution.</td>
 
      <td valign="top">metadata/publisher/name<br>
 
      </td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorContact/gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString<br/>and/or<br/>/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br>CI_RoleCode="publisher"<br/>and/or<br/>
 
/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords/gmd:MD_Keywords/gmd:keyword/gco:CharacterString with gmd:MD_KeywordTypeCode="dataCenter"</td>
 
<td></td><td>Responsible Party</td>
 
          </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#publisher_url_Attribute publisher_url]<br>
 
      </td>
 
     
 
      <td valign="top">metadata/publisher/contact@url<br>
 
      </td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorContact/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL<br/>and/or<br/>/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource/gmd:linkage/gmd:URL<br>
 
        CI_RoleCode="publisher"</td>
 
<td></td><td>Responsible Party</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#publisher_email_Attribute publisher_email]<br>
 
      </td>
 
     
 
      <td valign="top">metadata/publisher/contact@email</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorContact/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString<br/>and/or<br/>/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString<br>
 
        CI_RoleCode="publisher"</td>
 
<td></td><td>Responsible Party</td>
 
    </tr>   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#date_modified_Attribute date_modified]<br>
 
      </td>
 
      <td valign="top">The date on which this data was last modified.<br>
 
      </td>
 
      <td valign="top">metadata/date[@type="modified"]</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:Date<br>
 
          /gmd:dateType/gmd:CI_DateTypeCode="revision"</td>
 
<td>Modified</td><td>Responsible Party</td>
 
    </tr>   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#date_issued_Attribute date_issued]<br>
 
      </td>
 
      <td valign="top">The date on which this data was formally issued.<br>
 
      </td>
 
      <td valign="top">metadata/date[@type="issued"]</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:date/gmd:CI_Date/gmd:date/gco:Date<br>
 
          /gmd:dateType/gmd:CI_DateTypeCode="publication"</td>
 
<td></td><td>Responsible Party</td>
 
    </tr>
 
   
 
<tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lat_units_Attribute geospatial_lat_units]<br>
 
      </td>
 
      <td rowspan="7" colspan="1" valign="top">Further refinement of the geospatial bounding box can be provided by using these units and resolution attributes.<br>
 
 
 
      </td>
 
      <td valign="top">metadata/geospatialCoverage/northsouth/units</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:spatialRepresentationInfo/gmd:MD_Georectified/gmd:axisDimensionProperties/gmd:MD_Dimension/gmd:resolution/gco:Measure/@uom</td>
 
<td></td><td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lat_resolution_Attribute geospatial_lat_resolution]</td>
 
     
 
      <td valign="top">metadata/geospatialCoverage/northsouth/resolution</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:spatialRepresentationInfo/gmd:MD_Georectified/gmd:axisDimensionProperties/gmd:MD_Dimension/gmd:resolution/gco:Measure</td>
 
<td></td><td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lon_units_Attribute geospatial_lon_units]<br>
 
      </td>     
 
      <td valign="top">metadata/geospatialCoverage/eastwest/units</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:spatialRepresentationInfo/gmd:MD_Georectified/gmd:axisDimensionProperties/gmd:MD_Dimension/gmd:resolution/gco:Measure/@uom</td>
 
<td></td><td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_lon_resolution_Attribute geospatial_lon_resolution]</td>     
 
      <td valign="top">metadata/geospatialCoverage/eastwest/resolution</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:spatialRepresentationInfo/gmd:MD_Georectified/gmd:axisDimensionProperties/gmd:MD_Dimension/gmd:resolution/gco:Measure</td>
 
<td></td><td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_vertical_units_Attribute geospatial_vertical_units]<br>
 
      </td>
 
      <td valign="top">metadata/geospatialCoverage/updown/units</td>
 
      <td valign="top" rowspan="3">/gmi:MI_Metadata/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:extent/gmd:EX_Extent/gmd:verticalElement/gmd:EX_VerticalExtent/gmd:verticalCRS</td>
 
<td></td>    <td>Extent</td>
 
</tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_vertical_resolution_Attribute geospatial_vertical_resolution]<br>
 
      </td>     
 
      <td valign="top">metadata/geospatialCoverage/updown/resolution<br>
 
      </td>     
 
<td></td><td>Extent</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#geospatial_vertical_positive_Attribute geospatial_vertical_positive]<br>
 
      </td>
 
     
 
      <td valign="top">metadata/geospatialCoverage@zpositive<br>
 
      </td>
 
<td></td><td>Extent</td>
 
    </tr>
 
</table>
 
 
 
=Highly Recommended Variable Attributes=
 
<table width="95%" border="1" cellpadding="2" cellspacing="2">
 
    <tr>
 
      <th valign="top">Attribute</th>
 
      <th valign="top">Description</th>
 
      <th valign="top">THREDDS</th>
 
      <th valign="top">ISO 19115-2</th>
 
    </tr>   
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#long_name_Attribute long_name]</td>
 
      <td valign="top">A long descriptive name for the variable (not necessarily from a controlled vocabulary).</td>
 
      <td valign="top">metadata/variables/variable@vocabulary_name</td>
 
      <td rowspan="2" valign="top">At present the ISO 19115-2 Standard supports only one name for a variable. Standard names can be provided as keywords with the appropriate thesaurus.</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#standard_name_Attribute standard_name]<br></td>
 
      <td valign="top">A long descriptive name for the variable taken from a controlled vocabulary of variable names.</td>
 
      <td valign="top">metadata/variables/variable@vocabulary_name</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">[http://www.unidata.ucar.edu/software/thredds/v4.3/netcdf-java/formats/DataDiscoveryAttConvention.html#units_Attribute units]</td>
 
      <td valign="top">The units of the variables data values. This attributes value should be a valid udunits string.</td>
 
      <td valign="top">metadata/variables/variable@units</td>
 
      <td valign="top">/gmi:MI_Metadata/gmd:contentInfo/gmi:MI_CoverageDescription/gmd:dimension/gmd:MD_Band/gmd:units</td>
 
    </tr>
 
    <tr>
 
      <td valign="top">coverage_content_type</td>
 
      <td valign="top">An ISO 19115-1 code to indicate the source of the data.</td>
 
      <td valign="top"></td>
 
      <td valign="top">The valid values in the MD_CoverageContentTypeCode list are image, thematicClassification, physicalMeasurement, auxiliaryInformation, qualityInformation, referenceInformation, modelResult, coordinate</td>
 
    </tr>
 
</table>
 
 
 
 
 
=Translation Revisions=
 
 
 
=Determining an Order of Precedence=
 
 
 
[[Category:Attribute Conventions Dataset Discovery]]
 
[[Category: Documentation Cluster]]
 

Latest revision as of 17:22, September 22, 2014