Metacat

<!--

       '$RCSfile$'

       Copyright: 2000 Regents of the University of California and the

                  National Center for Ecological Analysis and Synthesis

     For Details: http://knb.ecoinformatics.org/

        '$Author$'

          '$Date$'

      '$Revision$'

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-->

<!-- EML DTD document that defines the structural

     characteristics of physical objects -->

<!-- The root element, which contains an identifier and 

     an physical description -->

<!ELEMENT eml-physical (identifier, format, characterEncoding?, size?, authentication*, compressionMethod?, 

                                         encodingMethod?, numHeaderLines?, recordDelimiter?, maxRecordLength?, 

                                         quoteCharacter*, literalCharacter*, (fieldStartColumn?, (fieldDelimiter | fieldWidth))* )>

<!-- File identifier of the metadata document -->

<!ELEMENT identifier (#PCDATA)>

<!ATTLIST identifier

  system CDATA #IMPLIED

>

<!-- size -->

<!ELEMENT size (#PCDATA)>

<!ATTLIST size

  unit CDATA "bytes"

>

<!-- Authentication value and method -->

<!ELEMENT authentication (#PCDATA)>

<!ATTLIST authentication

  method CDATA #IMPLIED

>

<!-- Entity format (e.g., text, name of various binary formats [TIFF]) -->

<!ELEMENT format (#PCDATA)>

<!-- characterEncoding fro text files (e.g., ASCII, UTF-8) -->

<!ELEMENT characterEncoding (#PCDATA)>

<!-- Method of compression -->

<!ELEMENT compressionMethod (#PCDATA)>

<!-- Method of encoding -->

<!ELEMENT encodingMethod (#PCDATA)>

<!-- The character used to delimit records in the entity -->

<!ELEMENT recordDelimiter (#PCDATA)>

<!ELEMENT maxRecordLength (#PCDATA)>

<!-- The character used to delimit quote data values so that the

     filed delimeters can be used in the data value, typically

     " or ' -->

<!ELEMENT quoteCharacter (#PCDATA)>

<!-- The character used to escape special characters

     so that they are interpreted literally, usually \  -->

<!ELEMENT literalCharacter (#PCDATA)>

<!-- Number of header lines or information that prepares data -->

<!ELEMENT numHeaderLines (#PCDATA)>

<!--

                        Variable width format fields (attributes) can vary in their 

                        field length, thus the end of the field is 

                        delimited by a special character called a 

                        field delimiter (typically a comma or a space).

                        Data sets are generally classified as fixedWidth

                        format or variableWidth format, but we have

                        determined that this is actually a per-field

                        classification because one may encounter

                        fixedWidth fields mixed together in the same

                        data file with variableWidth fields.

                        In our encoding scheme, the start of each field

                        is assumed to be the column after the last column

                        of the previous field, or the first column

                        if this is the first field in the dataset, unless 

                        the starting column is explicity enumerated using the

                        "fieldStartColumn" element.

                        The end column for each field is classified

                        using either a special character delimeter indicated

                        using the filedDelimiter element,

                        or a fixed field length indicated by using the "fieldWidth"

                        element.  The delimiter for the last field in the data set can be omitted.

                        variableWidth fields can vary in their field length, and the end of

                        the field is delimited by a special character

                        called a field delimiter, usually a comma or

                        a tab character.  fixedWidth fields have a set

                        length, and so the end of the field can always

                        be determined by adding the fieldWidth to the

                        starting column number.  Here is an example:

                        Assume we have the following data in a data set:

                        May,100aaaa,1.2,

                        April,200aaaa,3.4,

                        June,300bbbb,4.6,

                        The metadata indicating the physical layout of the 4 fields would include the 

                        following:

                          <delimiter>,</delimiter>

                          <fieldWidth>3</fieldWidth>

                          <fieldWidth>3</fieldWidth>

                          <delimiter>,</delimiter>

                        In a strictly fixed format file, the metadata would be slightly different:

                        May100aaaa1.2

                        Apr200aaaa3.4

                        Jun300bbbb4.6

                          <fieldWidth>3</fieldWidth>

                          <fieldWidth>3</fieldWidth>

                          <fieldWidth>4</fieldWidth>

                          <fieldWidth>3</fieldWidth>           

                        or, one could explicitly describe the starting columns:

                          <fieldStartColumn>1</fieldStartColumn>

                          <fieldWidth>3</fieldWidth>

                          <fieldStartColumn>4</fieldStartColumn>

                          <fieldWidth>3</fieldWidth>

                          <fieldStartColumn>7</fieldStartColumn>

                          <fieldWidth>4</fieldWidth>

                          <fieldStartColumn>11</fieldStartColumn>

                          <fieldWidth>3</fieldWidth>                   

-->

<!ELEMENT fieldStartColumn (#PCDATA)>

<!ELEMENT fieldDelimiter (#PCDATA)>

<!ELEMENT fieldWidth (#PCDATA)>

<!ELEMENT paragraph (#PCDATA)>

<!-- End of file -->

<!--

       '$RCSfile$'

       Copyright: 2000 Regents of the University of California and the

                  National Center for Ecological Analysis and Synthesis

     For Details: http://knb.ecoinformatics.org/

        '$Author$'

          '$Date$'

      '$Revision$'

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-->

<!-- EML DTD document that defines the structural

     characteristics of every entity in a dataset. -->

<!ENTITY % EntityBase "(identifier+, entityName, entityDescription?,

                       temporalCoverage*, geographicCoverage*,taxonomicCoverage*)">

<!ELEMENT table-entity (%EntityBase;, orientation?, caseSensitive?,

                        numberOfRecords?)>

<!ELEMENT other-entity (%EntityBase;, entityType)>

<!-- fields for EntityBase -->

<!ELEMENT identifier (#PCDATA)>

<!ELEMENT entityName (#PCDATA) >

<!ELEMENT entityDescription (#PCDATA) >

<!-- fields for table-entity -->

<!ELEMENT orientation EMPTY >

<!ATTLIST orientation columnorrow (columnmajor|rowmajor) "columnmajor">

<!ELEMENT caseSensitive EMPTY >

<!ATTLIST caseSensitive yesorno (yes|no) "no">

<!ELEMENT numberOfRecords (#PCDATA)>

<!-- fields for other-entity -->

<!ELEMENT entityType (#PCDATA)>   

<!ELEMENT temporalCoverage (#PCDATA)>

<!ELEMENT geographicCoverage (#PCDATA)>

<!ELEMENT taxonomicCoverage (#PCDATA)>

<!-- End of file -->

<!--

       '$RCSfile$'

       Copyright: 2000 Regents of the University of California and the

                  National Center for Ecological Analysis and Synthesis

     For Details: http://knb.ecoinformatics.org/

        '$Author$'

          '$Date$'

      '$Revision$'

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-->

<!ELEMENT eml-distribution (identifier, distributorFormat+, distributor*, digitalTransfer*)>

<!-- File identifier of the metadata document -->

<!ELEMENT identifier (#PCDATA)>

<!ATTLIST identifier

  system CDATA #IMPLIED

>

<!ELEMENT distributorFormat (formatName+, formatVersion+, formatSpec*, compressionType*, distributionFormat*)>

<!ELEMENT formatName (#PCDATA)>

<!ELEMENT formatVersion (#PCDATA)>

<!ELEMENT formatSpec (#PCDATA)>

<!ELEMENT compressionType (#PCDATA)>

<!ELEMENT distributionFormat (#PCDATA)>

<!ELEMENT distributor (contact+, standardOrderProcess*, distributorFormat*)>

<!ELEMENT contact ((individualName|organizationName|positionName),

                             address*, phone*, electronicMailAddress*, 

                             onlineLink*, role+)>

<!ELEMENT standardOrderProcess (fees*, dateTimeAvailable*, orderingInstructions*, turnaround*)>

<!ELEMENT fees (#PCDATA)>

<!ELEMENT dateTimeAvailable (#PCDATA)>

<!-- date/time -->

<!ELEMENT orderingInstructions (#PCDATA)>

<!ELEMENT turnaround (#PCDATA)>

<!ELEMENT digitalTransfer (distributionUnits?, transferSize?, onLine*, offLineResource*)>

<!ELEMENT distributionUnits (#PCDATA)>

<!ELEMENT transferSize (#PCDATA)>

<!ELEMENT onLine (#PCDATA)>

<!-- from iso-party.dtd -->

<!ELEMENT offLineResource (medium+)>

<!ELEMENT medium (medName?, medDensity?, medDensityUnits?, medVol?, medFormat*, medNote?)>

<!ELEMENT medName (#PCDATA)>

<!ELEMENT medDensity (#PCDATA)>

<!ELEMENT medDensityUnits (#PCDATA)>

<!ELEMENT medVol (#PCDATA)>

<!ELEMENT medFormat (#PCDATA)>

<!-- code list from B.6.23 -->

<!ELEMENT medNote (#PCDATA)>

<!--from eml-party-2.0-->

<!ELEMENT individualName (salutation*, givenName*, surName)>

<!ELEMENT salutation (#PCDATA)>

<!ELEMENT givenName (#PCDATA)>

<!ELEMENT surName (#PCDATA)>

<!ELEMENT organizationName (#PCDATA)>

<!ELEMENT positionName (#PCDATA)>

<!ELEMENT address (deliveryPoint*, city?, administrativeArea?, postalCode?, country?)>

<!ELEMENT deliveryPoint (#PCDATA)>

<!ELEMENT city (#PCDATA)>

<!ELEMENT administrativeArea (#PCDATA)>

<!ELEMENT postalCode (#PCDATA)>

<!ELEMENT country (#PCDATA)>

<!ELEMENT phone (#PCDATA)>

<!ATTLIST phone

  phonetype CDATA "voice"

>

<!ELEMENT electronicMailAddress (#PCDATA)>

<!ELEMENT onlineLink (#PCDATA)>

<!-- Note that the domain for role is not expressed in the DTD -->

<!ELEMENT role (#PCDATA)>

<!-- EOF -->

<!--

  * Ecological Metadata Language (EML) - Data set structural 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 IV - DATA STRUCTURE DESCRIPTORS

        *      *      *      *

        -->

<!-- Class 4 -->

<!ELEMENT eml-file (meta_file_id, file)>

<!ATTLIST eml-file description CDATA #FIXED "Data structural descriptors">

<!ELEMENT meta_file_id (#PCDATA)>

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

<!-- Class 4.A -->

<!ELEMENT file (file_name, file_size?, format, orientation?, header_lines?,

                case_sensitive?, geographic_coverage*, temporal_coverage*,

                authentication*, data_problem*)>

<!ATTLIST file description CDATA #FIXED "Data set file">

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

<!ELEMENT file_name (#PCDATA) >

<!ATTLIST file_name description CDATA #FIXED "File name">

<!-- Class 4.A.2 -->

<!ELEMENT file_size (amount, unit) >

<!ATTLIST file_size description CDATA #FIXED "Size of file">

<!ELEMENT amount (#PCDATA) >

<!ATTLIST amount description CDATA #FIXED "Amount">

<!ELEMENT unit (#PCDATA) >

<!ATTLIST unit description CDATA #FIXED "Unit">

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

<!ELEMENT format (compressed|encoded|base_file_type)>

<!ATTLIST format description CDATA #FIXED "File type and compression schemes employed">

<!ELEMENT compressed (#PCDATA)>

<!ATTLIST compressed description CDATA #FIXED "Method of compression">

<!ELEMENT encoded (#PCDATA)>

<!ATTLIST encoded description CDATA #FIXED "Method of encoding">

<!ELEMENT base_file_type (ASCII|binary)>

<!ATTLIST base_file_type description CDATA #FIXED "Base file type">

<!ELEMENT ASCII (record_delimiter)>

<!ATTLIST ASCII description CDATA #FIXED "ASCII">

<!ELEMENT record_delimiter (#PCDATA)>

<!ATTLIST record_delimiter description CDATA #FIXED "Record delimiter">

<!ELEMENT binary EMPTY>

<!ATTLIST binary description CDATA #FIXED "Binary">

<!-- NEW SECTION -->

<!ELEMENT orientation EMPTY >

<!ATTLIST orientation columnorrow (columnmajor|rowmajor) "columnmajor"

		      description CDATA #FIXED "Is file column major or row major?">

<!-- Class 4.A.4 -->

<!ELEMENT header_lines (#PCDATA) >

<!ATTLIST header_lines description CDATA #FIXED "Number of header lines or information that prepares data">

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

<!ELEMENT case_sensitive EMPTY >

<!ATTLIST case_sensitive yesorno (y|n) "n"

                   description CDATA #FIXED "Case sensitivity of field">

<!-- Class 4.A.6 -->

<!-- the field "specialfield" was removed as there were questions to its usefull ness -->

<!ELEMENT geographic_coverage (paragraph*, coordinates*)>

<!ATTLIST geographic_coverage description CDATA #FIXED "Geographic coverage">

<!ELEMENT coordinates (lattitude, longitude) >

<!ATTLIST coordinates description CDATA #FIXED "Cartesian Coordinates">

<!ELEMENT lattitude (#PCDATA)>

<!ATTLIST lattitude direction (north|south) #REQUIRED

                    description CDATA #FIXED "Lattitude coordinates">

<!ELEMENT longitude (#PCDATA)>

<!ATTLIST longitude direction (east|west) #REQUIRED

                    description CDATA #FIXED "Longitude coordinates">

<!ELEMENT temporal_coverage (start_date,stop_date?)>

<!ATTLIST temporal_coverage description CDATA #FIXED "Temporal coverage">

<!ELEMENT start_date (datetime)>

<!ATTLIST start_date description CDATA #FIXED "Date data collection commenced">

<!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 stop_date  (datetime)>

<!ATTLIST stop_date description CDATA #FIXED "Date data collection terminated">

<!-- Class 4.A.7 -->

<!ELEMENT authentication (#PCDATA) >

<!ATTLIST authentication description CDATA #FIXED "Authentication procedures or techniques">

<!-- Class 4.B -->

<!-- Class 4.B (variable) was moved to its own module (eml-variable.dtd) -->

<!-- Class 4.C -->

<!ELEMENT data_problem (paragraph+)>

<!ATTLIST data_problem problemtype (missing|anomaly|error) #REQUIRED

                      description CDATA #FIXED "Data anomalies; description of missing data">

<!ELEMENT paragraph (#PCDATA)>

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

<!-- End of file -->

<!--         

       '$RCSfile$'

       Copyright: 2000 Regents of the University of California and the

                  National Center for Ecological Analysis and Synthesis

     For Details: http://knb.ecoinformatics.org/

        '$Author$'

          '$Date$'

      '$Revision$'

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-->

<!ENTITY % responsibleParty "((individualName|organizationName|positionName)+,

                             address*, phone*, electronicMailAddress*, 

                             onlineLink*, role+)">

<!ELEMENT individualName (salutation*, givenName*, surName)>

<!ELEMENT salutation (#PCDATA)>

<!ELEMENT givenName (#PCDATA)>

<!ELEMENT surName (#PCDATA)>

<!ELEMENT organizationName (#PCDATA)>

<!ELEMENT positionName (#PCDATA)>

<!ELEMENT address (deliveryPoint*, city?, administrativeArea?, 

                   postalCode?, country?)>

<!ELEMENT deliveryPoint (#PCDATA)>

<!ELEMENT city (#PCDATA)>

<!ELEMENT administrativeArea (#PCDATA)>

<!ELEMENT postalCode (#PCDATA)>

<!ELEMENT country (#PCDATA)>

<!ELEMENT phone (#PCDATA)>

<!ATTLIST phone phonetype CDATA "voice">

<!ELEMENT electronicMailAddress (#PCDATA)>

<!ELEMENT onlineLink (#PCDATA)>

<!-- Note that the domain for role is not expressed in the DTD -->

<!ELEMENT role (#PCDATA)>

<!-- entity to conglomerate these fields into one name -->

<!ENTITY % resbase "(identifier+, shortName?, title+,

                     originator+, pubdate?, pubplace?, series?, abstract?, 

                     keywordSet*, additionalInfo?, triple*)" >

<!-- common fields -->

<!ELEMENT identifier (#PCDATA)>

<!ATTLIST identifier system CDATA "">

<!ELEMENT shortName (#PCDATA)>

<!ELEMENT title (#PCDATA)>

<!ELEMENT originator ((%responsibleParty;))>

<!ELEMENT pubdate (#PCDATA)>

<!ELEMENT pubplace (#PCDATA)>

<!ELEMENT series (#PCDATA)>

<!ELEMENT abstract (paragraph+)>

<!ELEMENT keywordSet (keyword+, keywordThesaurus*)>

<!ELEMENT keyword (#PCDATA)>

<!ATTLIST keyword keywordType CDATA "">

<!ELEMENT keywordThesaurus (#PCDATA)>

<!ELEMENT additionalInfo (paragraph+)>

<!ELEMENT paragraph (#PCDATA)>

<!ELEMENT triple (subject, relationship, object)>

<!ELEMENT subject (#PCDATA)>

<!ELEMENT relationship (#PCDATA)>

<!ELEMENT object (#PCDATA)>

<!ELEMENT temporalCoverage (#PCDATA)>

<!ELEMENT geographicCoverage (#PCDATA)>

<!ELEMENT taxonomicCoverage (#PCDATA)>

<!-- The dataset branch -->

<!ELEMENT dataset ((%resbase;), temporalCoverage*, geographicCoverage*,

                  taxonomicCoverage* )>

<!-- EOF -->

<!--

  * Ecological Metadata Language (EML) - Status 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 III A - DATA SET STATUS

        *      *      *      *

        -->

<!-- Class 3.A -->

<!ELEMENT eml-status (meta_file_id, data_update_date?, data_archive_date?, metadata_update_date?, qa_qc_status?)>

<!ATTLIST eml-status description CDATA #FIXED "Data set status">

<!ELEMENT meta_file_id (#PCDATA)>

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

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

<!ELEMENT data_update_date (datetime)>

<!ATTLIST data_update_date description CDATA #FIXED "Date of modification of data set">

<!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">

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

<!ELEMENT data_archive_date (datetime)>

<!ATTLIST data_archive_date description CDATA #FIXED "Date of last data set archival">

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

<!ELEMENT metadata_update_date (datetime)>

<!ATTLIST metadata_update_date description CDATA #FIXED "Date of last metadata update and current status">

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

<!ELEMENT qa_qc_status (paragraph+)>

<!ATTLIST qa_qc_status description CDATA #FIXED "Status of data quality assurance checking">

<!ELEMENT paragraph (#PCDATA)>

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

<!-- End of file -->

<!ELEMENT party ((party_individual | party_org), address, contactHours)>

<!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 address (street*, city?, admin_area*, postal_code?, country, resource_url*, email*, phoneFAXetc*)>

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

                      address_status (current|notcurrent) #REQUIRED

                      address_purpose (mail|institution|homeresidence) #REQUIRED>

<!ELEMENT street (#PCDATA)>

<!ATTLIST street description CDATA #FIXED "Street or other point of delivery">

<!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 phoneFAXetc (phoneType, phoneNumber)>

<!ATTLIST phone description CDATA #FIXED "Phone number for Voice, FAX, TDD, etc">

<!ELEMENT phoneType (#PCDATA)>

<!ATTLIST phonetype description CDATA #FIXED "Type of phone, such as voice, FAX, TDD, etc"

                      phone_type (phone|FAX|TDD|other) #REQUIRED>

<!ELEMENT phoneNumber (#PCDATA)>

<!ATTLIST phoneNumber 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 contactHours (#PCDATA)>

<!ATTLIST contactHours description CDATA #FIXED "Hours during which to contact party">

<!--         

       '$RCSfile$'

       Copyright: 2000 Regents of the University of California and the

                  National Center for Ecological Analysis and Synthesis

     For Details: http://knb.ecoinformatics.org/

        '$Author$'

          '$Date$'

      '$Revision$'

    This program is free software; you can redistribute it and/or modify

    it under the terms of the GNU General Public License as published by

    the Free Software Foundation; either version 2 of the License, or

    (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License

    along with this program; if not, write to the Free Software

    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

-->

<!-- entity referring to the eml-party fields -->

<!ENTITY % resParty SYSTEM "./eml-party.dtd">

%resParty;

<!-- entity to conglomerate these fields into one name -->

<!ENTITY % resbase "(identifier+, shortName?, title+,

                     originator+, pubDate?, pubPlace?, series?, abstract?, 

                     keywordSet*, additionalInfo?, triple*)" >

<!-- common fields -->

<!ELEMENT identifier (#PCDATA)>

<!ATTLIST identifier system CDATA>

<!ELEMENT shortName (#PCDATA)>

<!ELEMENT title (#PCDATA)>

<!ELEMENT originator ((%responsibleParty;))>

<!ELEMENT pubdate (#PCDATA)>

<!ELEMENT pubplace (#PCDATA)>

<!ELEMENT series (#PCDATA)>

<!ELEMENT abstract (paragraph+)>

<!ELEMENT keywordSet (keyword+, keywordThesaurus*)>

<!ELEMENT keyword (#PCDATA)>

<!ATTLIST keyword keywordType CDATA>

<!ELEMENT keywordThesaurus (#PCDATA)>

<!ELEMENT additionalInfo (paragraph+)>

<!ELEMENT paragraph (#PCDATA)>

<!ELEMENT triple (subject, relationship, object)>

<!ELEMENT subject (#PCDATA)>

<!ELEMENT relationship (#PCDATA)>

<!ELEMENT object (#PCDATA)>

<!-- EOF -->

<!--

  * Ecological Metadata Language (EML) - Research context 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 II - RESEARCH ORIGIN DESCRIPTORS

        *      *      *      *

        -->

<!-- Class 2-->

<!ELEMENT eml-context (meta_file_id,research_project)>

<!ATTLIST eml-context description CDATA #FIXED "Data set status and availabilty">

<!ELEMENT meta_file_id (#PCDATA)>

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

<!-- Class 2.A -->

<!ELEMENT research_project (title, originator+, temporal_description*,

		objectives?, abstract?, funding?, site_description*,

	 	design_description*, methods_description*, staff*)>

<!ATTLIST research_project description CDATA #FIXED "Overall project descriptors">

<!ELEMENT title (#PCDATA)>

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

<!ELEMENT originator (party)>

<!ATTLIST originator description CDATA #FIXED "Names and addresses of principal

investigators">

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

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

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

<!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 job_title (#PCDATA)>

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

<!ELEMENT party_org (#PCDATA)>

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

<!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">

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

<!-- Class 2.A.2 - see Class 2.A -->

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

<!ELEMENT temporal_description (temporal_coverage*, duration?)>

<!ATTLIST temporal_description description CDATA #FIXED "General description of temporal coverage of project">

<!ELEMENT temporal_coverage (start_date,stop_date?)>

<!ATTLIST temporal_coverage description CDATA #FIXED "Temporal coverage">

<!ELEMENT start_date (datetime)>

<!ATTLIST start_date description CDATA #FIXED "Date data collection commenced">

<!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 stop_date  (datetime)>

<!ATTLIST stop_date description CDATA #FIXED "Date data collection terminated">

<!ELEMENT duration (amount, unit)>

<!ATTLIST duration description CDATA #FIXED "Duration of temporal coverage">

<!ELEMENT amount (#PCDATA) >

<!ATTLIST amount description CDATA #FIXED "Amount">

<!ELEMENT unit (#PCDATA) >

<!ATTLIST unit description CDATA #FIXED "Unit">

<!-- Class 2.A.4 -->

<!ELEMENT objectives (paragraph+) >

<!ATTLIST objectives description CDATA #FIXED "Scope and purpose of research program">

<!ELEMENT paragraph (#PCDATA)>

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

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

<!ELEMENT abstract (paragraph+)>

<!ATTLIST abstract description CDATA #FIXED "Descriptive abstract">

<!-- Class 2.A.6 -->

<!ELEMENT funding (paragraph+) >

<!ATTLIST funding description CDATA #FIXED "Grant and contract numbers, names and addresses of funding sources">

<!-- Class 2.B -->

<!-- Class 2.B (subproject) has been assimilated to research project -->

<!-- Class 2.B.1 -->

<!ELEMENT site_description (paragraph*, sitetype?, geography?, habitat?, geology?, hydrology?, history?, climate?)>

<!ATTLIST site_description description CDATA #FIXED "Site description">

<!-- Class 2.B.1.a -->

<!ELEMENT sitetype (paragraph+) >

<!ATTLIST sitetype description CDATA #FIXED "Site type - description, e.g., short-grass prairie, blackwater stream, etc.">

<!-- Class 2.B.1.b -->

<!ELEMENT geography (coordinates*,paragraph*, citation*)>

<!ATTLIST geography description CDATA #FIXED "Location and size">

<!ELEMENT coordinates (lattitude, longitude) >

<!ATTLIST coordinates description CDATA #FIXED "Cartesian Coordinates">

<!ELEMENT lattitude (#PCDATA)>

<!ATTLIST lattitude direction (north|south) #REQUIRED

                    description CDATA #FIXED "Lattitude coordinates">

<!ELEMENT longitude (#PCDATA)>

<!ATTLIST longitude direction (east|west) #REQUIRED

                    description CDATA #FIXED "Longitude coordinates">

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

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

<!ELEMENT author (party)>

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

<!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 vol (#PCDATA)>

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

<!ELEMENT issue (#PCDATA)>

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

<!ELEMENT pubdate (datetime)>

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

<!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 2.B.1.c -->

<!ELEMENT habitat (paragraph*, citation*)>

<!ATTLIST habitat description CDATA #FIXED "Detailed characteristics of habitat sampled">

<!-- Class 2.B.1.d -->

<!ELEMENT geology (paragraph*, citation*)>

<!ATTLIST geology description CDATA #FIXED "Geology and Landform">

<!-- Class 2.B.1.e -->

<!ELEMENT hydrology (paragraph*, citation*)>

<!ATTLIST hydrology description CDATA #FIXED "Hydrology">

<!-- Class 2.B.1.f -->

<!ELEMENT history (paragraph*, citation*)>

<!ATTLIST history description CDATA #FIXED "Site history">

<!-- Class 2.B.1.g -->

<!ELEMENT climate (paragraph*, citation*)>

<!ATTLIST climate description CDATA #FIXED "Site climatic characteristics">

<!-- Class 2.B.2 -->

<!ELEMENT design_description (designmethod?, plots?, sampling?,paragraph*, citation*)>

<!ATTLIST design_description description CDATA #FIXED "Experimental or Sampling design">

<!-- Class 2.B.2.a -->

<!ELEMENT designmethod (paragraph*, citation*)>

<!ATTLIST designmethod description CDATA #FIXED "Description of Statistical/sampling design">

<!-- Class 2.B.2.b -->

<!ELEMENT plots (paragraph*,citation*) >

<!ATTLIST plots description CDATA #FIXED "Permanent plot description">

<!-- Class 2.B.2.c -->

<!ELEMENT sampling (temporal_coverage*, frequency?,paragraph*,citation*)>

<!ATTLIST sampling description CDATA #FIXED "Information necessary to understand temporal sampling regime">

<!ELEMENT frequency (#PCDATA)>

<!ATTLIST frequency description CDATA #FIXED "Frequency or period of data collection">

<!-- Class 2.B.3 -->

<!ELEMENT methods_description (method*, instrument*, taxonomy*, permit*, legal_information*,paragraph*, citation*)>

<!ATTLIST methods_description description CDATA #FIXED "Research Methods">

<!-- Class 2.B.3.a -->

<!ELEMENT method (paragraph*, citation*)>

<!ATTLIST method description CDATA #FIXED "Description or reference to field/laboratory methods">

<!-- Class 2.B.3.b -->

<!ELEMENT instrument (paragraph*, citation*)>

<!ATTLIST instrument description CDATA #FIXED "Description of Instruments used">

<!-- Class 2.B.3.c -->

<!ELEMENT taxonomy (paragraph*, citation*)>

<!ATTLIST taxonomy description CDATA #FIXED "Taxonomy information">

<!-- Class 2.B.3.d -->

<!ELEMENT permit (paragraph+) >

<!ATTLIST permit description CDATA #FIXED "References to pertinent scientific and collecting permits">

<!-- Class 2.B.3.e -->

<!ELEMENT legal_information (paragraph+)>

<!ATTLIST legal_information description CDATA #FIXED "Relevant laws, decision criteria, compliance standards">

<!-- Class 2.B.4 -->

<!ELEMENT staff (party)>

<!ATTLIST staff description CDATA #FIXED "Project Personell">

<!-- End of file -->

<!--

  * Ecological Metadata Language (EML) - Data set variable 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 IV B - VARIABLE DESCRIPTORS

        *      *      *      *

        -->

<!-- Class 4 B -->

<!ELEMENT eml-variable (meta_file_id, variable*)>

<!ATTLIST eml-variable description CDATA #FIXED "Variable description for a file">

<!ELEMENT meta_file_id (#PCDATA)>

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

<!ELEMENT variable (variable_name, variable_definition, unit?, storage_type?,

                    code_definition* , numeric_range* , missing_value_code*,

                    precision?, field_format?)>

<!ATTLIST variable description CDATA #FIXED "Variable information">

<!ELEMENT unit (#PCDATA) >

<!ATTLIST unit description CDATA #FIXED "Unit">

<!-- Class 4.B.1 -->

<!ELEMENT variable_name (#PCDATA) >

<!ATTLIST variable_name description CDATA #FIXED "Unique variable name or code">

<!-- Class 4.B.2 -->

<!ELEMENT variable_definition (#PCDATA)>

<!ATTLIST variable_definition description CDATA #FIXED "Precise definition of variables in data set">

<!-- Class 4.B.3 - see 4.A.2 -->

<!-- Class 4.B.4.a -->

<!ELEMENT storage_type (#PCDATA) >

<!ATTLIST storage_type description CDATA #FIXED "Storage type; Integer, floating point, character, string">

<!-- Class 4.B.4.b -->

<!ELEMENT code_definition (code, definition) >

<!ATTLIST code_definition description CDATA #FIXED "Description of any codes associated with variables">

<!ELEMENT code (#PCDATA) >

<!ATTLIST code description CDATA #FIXED "Code">

<!ELEMENT definition (#PCDATA) >

<!ATTLIST definition description CDATA #FIXED "List and definition of variable codes">

<!-- Class 4.B.4.c -->

<!ELEMENT numeric_range  (minimum?,maximum?) >

<!ATTLIST numeric_range description CDATA #FIXED "Range for numeric values">

<!ELEMENT minimum (#PCDATA) >

<!ATTLIST minimum description CDATA #FIXED "Minimum value">

<!ELEMENT maximum (#PCDATA) >

<!ATTLIST maximum description CDATA #FIXED "Maximum value">

<!-- Class 4.B.4.d -->

<!ELEMENT missing_value_code  (#PCDATA) >

<!ATTLIST missing_value_code description CDATA #FIXED "Character used to represent missing data">

<!-- Class 4.B.4.e -->

<!ELEMENT precision   (#PCDATA) >

<!ATTLIST precision description CDATA #FIXED "Precision; number of significant digits">

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

<!ELEMENT field_format (variable_width|fixed_width)>

<!ATTLIST field_format description CDATA #FIXED "Data format">

<!--

Data sets are generally classified as fixed_width format or

variable_width format, but we have determined that this is actually a

per-field classification because one may encounter fixed_width fields

mixed together in the same data file with variable_width fields.

In our encoding scheme, the start of each field is assumed to be the

column after the last column of the previous field, or the first column

if this is the first field in the dataset.  The end column for each

field is classified using a field_format and some information specific to

each field_format type that indicates in which column the field ends. The

two types of field formats are variable_width and fixed_width. 

Variable_width fields can vary in their field length, and the end of the

field is delimited by a special character called a field delimiter,

usually a comma or a tab character.  Fixed_width fields have a set

length, and so the end of the field can always be determined by adding

the field_width to the starting column number.  Here is an example:

Assume we have the following data in a data set:

May,100aaa,1.2,

April,200aaa,3.4,

June,300bbb,4.6,

The metadata for the 4 fields would include the following:

<variable><name>month</name>

<field_format><variable_width><delimiter>,</delimiter>

</variable_width></field_format></variable>

<variable><name>sitecode</name>

<field_format><fixed_width><field_width>3</field_width>

</fixed_width></field_format></variable>

<variable><name>subsitecode</name>

<field_format><fixed_width><field_width>3</field_width>

</fixed_width></field_format></variable>

<variable><name>response</name>

<field_format><variable_width><delimiter>,</delimiter>

</variable_width></field_format></variable>

-->

<!ELEMENT variable_width (delimiter+)>

<!ATTLIST variable_width description CDATA #FIXED "Variable width field">

<!ELEMENT delimiter (#PCDATA)>

<!ATTLIST delimiter description CDATA #FIXED "Character used to delimit end of field"><!ELEMENT fixed_width (field_width)>

<!ATTLIST fixed_width description CDATA #FIXED "Fixed width field">

<!ELEMENT field_width (#PCDATA)>

<!ATTLIST field_width description CDATA #FIXED "Width of field in characters">

<!-- Class 4.B.5.a - see Class 4.B.5 -->

<!-- Class 4.B.5.b - see Class 4.B.5 -->

<!-- Class 4.B.5.c -->

<!-- This section was removed as we were unsure of its usefullness -->

<!-- End of file -->

<!--

  * Ecological Metadata Language (EML) - General data set 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,