Metacat

<!--

  * Ecological Metadata Language (EML) - Supplemental descriptors

  *

  *      Authors: Matt Jones, Zheng Wang, and Noah Goldstein

  * Organization: National Center for Ecological Analysis and Synthesis

  *  For Details: http://www.nceas.ucsb.edu/

  *      Created: 1997 August 19

  *     Modified: 1999 June 23

  *      Version: 1.4

  *    File Info: '$Id$'

  *

  * Ecological Metadata Language is a general purpose metadata content

  * specification for documenting ecological data.  The specification

  * consists of a series of modular document type definitions (DTD) that

  * provide metadata content descriptors. It describes the owner and

  * contents of the dataset  (eml-dataset.dtd), the research context in

  * which it was created (eml-context.dtd), the structural

  * characteristics of data files (eml-file.dtd), the

  * characteristics of variables in a file (eml-variable.dtd), current

  * status of data and metadata files (eml-status.dtd), access control

  * rules regarding the data  and metadata (eml-access.dtd), software

  * information (eml-software) and a variety of miscellaneous

  * supplemental descriptors (eml-supplement.dtd).

  *

  * Files generated under the structural constraints of eml are

  * plain-text files and therefore are editable in ordinary

  * text-processors.  However, these DTDs are intended for use within

  * general purpose metadata editors, and within a more specific

  * metadata editor being developed at NCEAS for the ecological

  * community.  This metadata editor will provide facilities for

  * version control and efficient metadata entry.

  * The purpose of this specification was to formalize the

  * Michener et al. work in a structured language to examine its

  * application to ecological data in a controlled manner.

  *

  * This specification was based on the work of the Ecological Society

  * of America's Committee on the Future of Long Term Data, and more

  * specifically on a related paper, Michener et al., 1997. See:

  * Michener, William K., et al., 1997. Ecological Appications,

  * "Nongeospatial metadata for the ecological sciences"

  * Vol 7(1). pp. 330-342.

  *

  * Where appropriate, we have used elements of the ISO/TC 211 draft

  * standard - the ISO Geographic information/Geomatics standard,

  * which includes xml code, as well as ISO 8601 schema. Some elements

  * in the ISO/TC 211 were expanded to allow for greater

  * resolution.

  *

  * For an explanation of the classes of metadata and elements defined

  * below, see Michener et al. 1997. In particular, the numbered comment

  * labels found below refer to Table 1 (pp. 336-337) of Michener

  * et al. 1997. In addition, each of the principal elements in the

  * specification is accompanied by a FIXED attribute called "description"

  * that provides a brief description of the content of the element. These

  * descriptions are derived from Michener et al. 1997.

  *

-->

<!--    *      *      *      *

        CLASS V - SUPPLEMENTAL DESCRIPTORS

        *      *      *      *

        -->

<!-- Class 5 -->

<!ELEMENT eml-supplement (meta_file_id, data_forms*, entry_verification*,

                  quality_assurance*, related_material*, archival_procedures*,

		archival_sites*, publications*, data_request*, review_history*, remarks*)>

<!ATTLIST eml-supplement description CDATA #FIXED "Supplemental descriptors">

<!ELEMENT meta_file_id (#PCDATA)>

<!ATTLIST meta_file_id description CDATA #FIXED "Unique identifier of this metadata record">

<!-- Class 5.A.1 -->

<!ELEMENT data_forms  (meta_address?,formdescription?,examples?)+ >

<!ATTLIST data_forms description CDATA #FIXED "Description or examples of data forms, automated data loggers, digitizers, digitizing procedures">

<!ELEMENT meta_address (address*, city?, admin_area*, postal_code?, country, resource_url*, email*, phone*, fax*, tdd_phone*)>

<!ATTLIST meta_address description CDATA #FIXED "Contact information"

                      meta_address_status (current|notcurrent) #REQUIRED

                      meta_address_purpose (mail|institution|homeresidence) #REQUIRED>

<!ELEMENT address (#PCDATA)>

<!ATTLIST address description CDATA #FIXED "Street address">

<!ELEMENT city (#PCDATA)>

<!ATTLIST city description CDATA #FIXED "City">

<!ELEMENT admin_area (#PCDATA)>

<!ATTLIST admin_area description CDATA #FIXED "Administrative area (state, province, territory)">

<!ELEMENT postal_code (#PCDATA)>

<!ATTLIST postal_code description CDATA #FIXED "Postal code">

<!ELEMENT country (#PCDATA)>

<!ATTLIST country description CDATA #FIXED "Country">

<!ELEMENT resource_url (#PCDATA)>

<!ATTLIST resource_url description CDATA #FIXED "URL">

<!ELEMENT email (#PCDATA)>

<!ATTLIST email description CDATA #FIXED "Email address">

<!ELEMENT phone (country_code?,area_code?,local_code, extension?)>

<!ATTLIST phone description CDATA #FIXED "Phone number">

<!ELEMENT fax (country_code?,area_code?,local_code)>

<!ATTLIST fax description CDATA #FIXED "Facimilie telephone">

<!ELEMENT tdd_phone (country_code?,area_code?,local_code)>

<!ATTLIST tdd_phone description CDATA #FIXED "TDD/TTY telephone">

<!ELEMENT country_code (#PCDATA)>

<!ATTLIST country_code description CDATA #FIXED "Countrycode">

<!ELEMENT area_code (#PCDATA)>

<!ATTLIST area_code description CDATA #FIXED "Area code">

<!ELEMENT local_code (#PCDATA)>

<!ATTLIST local_code description CDATA #FIXED "Local phone code">

<!ELEMENT extension (#PCDATA)>

<!ATTLIST extension description CDATA #FIXED "Phone extension code">

<!ELEMENT formdescription (paragraph+)>

<!ATTLIST formdescription description CDATA #FIXED "Description of forms">

<!ELEMENT paragraph (#PCDATA)>

<!ATTLIST paragraph description CDATA #FIXED "Paragraph of text">

<!ELEMENT examples  (paragraph+)>

<!ATTLIST examples description CDATA #FIXED "Examples">

<!-- for Class 5.A.2 - see 5.A.1 -->

<!-- Class 5.A.3 -->

<!ELEMENT entry_verification (paragraph*|citation*) >

<!ATTLIST entry_verification description CDATA #FIXED "Procedures employed to verify that digital data is error free">

<!-- Class 5.B -->

<!ELEMENT quality_assurance (paragraph*|citation*) >

<!ATTLIST quality_assurance description CDATA #FIXED "Quality assurance / quality control procedures">

<!-- CLass 5.C -->

<!ELEMENT related_material (paragraph*|citation*) >

<!ATTLIST related_material description CDATA #FIXED "References and locations of related materials">

<!-- Class 5.D - see Software module -->

<!-- Class 5.E.1 -->

<!ELEMENT archival_procedures (paragraph*|citation*) >

<!ATTLIST archival_procedures description CDATA #FIXED "Description of how data are archived for long-term storage and access">

<!-- Class 5.E.2 -->

<!ELEMENT archival_sites (meta_address*) >

<!ATTLIST archival_sites description CDATA #FIXED "Locations of redundant archival sites">

<!-- Class 5.F -->

<!ELEMENT publications ((citation, paragraph*)+) >

<!ATTLIST publications description CDATA #FIXED "List of all Publications and results in all media">

<!ELEMENT citation ( (author|editor)*, source_information?)>

<!ATTLIST citation description CDATA #FIXED "Citation">

<!ELEMENT author (party)>

<!ATTLIST author description CDATA #FIXED "Author">

<!ELEMENT party ((party_individual | party_org), meta_address)>

<!ATTLIST party description CDATA #FIXED "Responsible party information">

<!ELEMENT party_individual (salutation*, given_name+, surname, jobtitle*)>

<!ATTLIST party_individual description CDATA #FIXED "Full name of individual">

<!ELEMENT salutation (#PCDATA)>

<!ATTLIST salutation description CDATA #FIXED "Salutation">

<!ELEMENT given_name (#PCDATA)>

<!ATTLIST given_name description CDATA #FIXED "First name">

<!ELEMENT surname (#PCDATA)>

<!ATTLIST surname description CDATA #FIXED "Last Name">

<!ELEMENT jobtitle (#PCDATA)>

<!ATTLIST jobtitle description CDATA #FIXED "Job title">

<!ELEMENT party_org (#PCDATA)>

<!ATTLIST party_org description CDATA #FIXED "Name of organization">

<!ELEMENT editor (party)>

<!ATTLIST editor description CDATA #FIXED "Editor">

<!ELEMENT source_information    (title, vol?, issue?, pubdate?,

                        publisher?, edition?, series?, chapter_title?,

                        pages?, resource_url*)>

<!ATTLIST source_information description CDATA #FIXED "Source information">

<!ELEMENT title (#PCDATA)>

<!ATTLIST title description CDATA #FIXED "Title or theme of data set">

<!ELEMENT vol (#PCDATA)>

<!ATTLIST vol description CDATA #FIXED "Volume">

<!ELEMENT issue (#PCDATA)>

<!ATTLIST issue description CDATA #FIXED "Issue id">

<!ELEMENT pubdate (datetime)>

<!ATTLIST pubdate description CDATA #FIXED "Date of publication">

<!ELEMENT datetime (year?, month?, day?, hour?, minute?, second?, second_fraction?, time_zone_designator?)>

<!ATTLIST datetime description CDATA #FIXED "Date and time as designated in ISO 8601">

<!ELEMENT year (#PCDATA)>

<!ATTLIST year description CDATA #FIXED "Year in YYYY format">

<!ELEMENT month (#PCDATA)>

<!ATTLIST month description CDATA #FIXED "Month in MM format">

<!ELEMENT day (#PCDATA)>

<!ATTLIST day description CDATA #FIXED "Day of month in DD format">

<!ELEMENT hour (#PCDATA)>

<!ATTLIST hour description CDATA #FIXED "Hour in hh">

<!ELEMENT minute (#PCDATA)>

<!ATTLIST minute description CDATA #FIXED "Minute in mm">

<!ELEMENT second (#PCDATA)>

<!ATTLIST second description CDATA #FIXED "Seconds in ss">

<!ELEMENT second_fraction (#PCDATA)>

<!ATTLIST second_fraction description CDATA #FIXED "One or more digits representing a decimal fraction of a second">

<!ELEMENT time_zone_designator (#PCDATA)>

<!ATTLIST time_zone_designator description CDATA #FIXED "Time zone designator">

<!ELEMENT publisher (party)>

<!ATTLIST publisher description CDATA #FIXED "Publisher">

<!ELEMENT edition (#PCDATA)>

<!ATTLIST edition description CDATA #FIXED "Edition">

<!ELEMENT series  (#PCDATA)>

<!ATTLIST series description CDATA #FIXED "Series">

<!ELEMENT chapter_title (title)>

<!ATTLIST chapter_title description CDATA #FIXED "Chapter title">

<!ELEMENT pages (#PCDATA)>

<!ATTLIST pages description CDATA #FIXED "Pages">

<!-- Class 5.G.1 -->

<!ELEMENT data_request (datetime,party,paragraph*) >

<!ATTLIST data_request description CDATA #FIXED "Log of who requested data, for what purpose, and how data set was actually used">

<!-- Class 5.G.2 - see Class 3.A.1 -->

<!-- Class 5.G.3 -->

<!ELEMENT review_history (datetime, party, paragraph*) >

<!ATTLIST review_history description CDATA #FIXED "Review history; Last entry, last researcher review">

<!-- Class 5.G.4 -->

<!ELEMENT remarks (datetime, party, comments)>

<!ATTLIST remarks description CDATA #FIXED "Questions and comments from secondary users, including problems with data">

<!ELEMENT comments (paragraph+)>

<!ATTLIST comments description CDATA #FIXED "Comments of users">

<!-- End of file -->