# '$RCSfile: README,v $' # Copyright: 1997-2002 Regents of the University of California, # University of New Mexico, and # Arizona State University # Sponsors: National Center for Ecological Analysis and Synthesis and # Partnership for Interdisciplinary Studies of Coastal Oceans, # University of California Santa Barbara # Long-Term Ecological Research Network Office, # University of New Mexico # Center for Environmental Studies, Arizona State University # Other funding: National Science Foundation (see README for details) # The David and Lucile Packard Foundation # For Details: http://knb.ecoinformatics.org/ # # '$Author: jones $' # '$Date: 2004-08-10 21:21:04 $' # '$Revision: 1.33 $' # # 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: Ecological Metadata Language --------------------------------- Version: 2.0.1 Feedback and bugs to: eml-dev@ecoinformatics.org http://bugzilla.ecoinformatics.org Contributors: Matt Jones (jones@nceas.ucsb.edu) Chad Berkley (berkley@nceas.ucsb.edu) Jivka Bojilova (bojilova@nceas.ucsb.edu) Dan Higgins (higgins@nceas.ucsb.edu) Chris Jones (cjones@lifesci.ucsb.edu) Corinna Gries (corinna@asu.edu) Peter McCartney (peter.mccartney@asu.edu) James Brunt (jbrunt@lternet.edu) David Blankman (dblankman@lternet.edu) Owen Eddins (oeddins@lternet.edu) Mark Schildhauer (schild@nceas.ucsb.edu) John Harris (harris@nceas.ucsb.edu) Matthew Brooke (brooke@nceas.ucsb.edu) Scott Chapal (scott.chapal@jonesctr.org) Tim Bergsma (tbergsma@kbs.msu.edu) Ken Ramsey (kramsey@jornada.nmsu.edu) Saurabh Garg (sgarg@nceas.ucsb.edu) Web site: http://knb.ecoinformatics.org/software/eml The Ecological Metadata Language consists of a number of modules that define an XML markup syntax for ecologically relevant metadata. It was originally based on work done by the ESA Committee on the Future of Long-Term Ecological Data (http://esa.sdsc.edu/FLED/FLED.html) and on a related paper on ecological metadata by Michener et al. (see Michener, William K., et al., 1997. Ecological Applications, "Nongeospatial metadata for the ecological sciences" Vol 7(1). pp. 330-342.). Version 1.4 follows that paper closely in its content implementation, but Version 2 has been modified substantially after experience using the specification and from feedback from the ecological community. This release represents the consensus view of a large number of knowledgeable scientists and data managers on what metadata are relevant to ecological data and how best to represent it. Of course, many might differ in opinion about specific decisions made during the development of EML; we would like to encourage users to faithfully use the specification in the spirit of community building. It is better if we all use a metadata language that covers most of our needs than to modify it and use one that is perfect but not shared with anybody. It is notable that some of the rules regarding EML that are important are expressed only in the EML specification, not in the XML Schema files. This is because XML Schema was not able to express some of the constraints that we felt were important to creating a coherent metadata document, particularly with respect to identifiers and references to identifiers. Thus, we have included a new EML Validity Parser. It checks both EML rules and the schema rules to be sure an XML document is a valid EML document. It is included with the release, and provided as an online service. See docs/index.html. DOCUMENTATION ------------- Please see the docs/index.html directory for a a list of the relevant documents pertaining to EML. In particular, this release ships with a full version of the EML Specification, which is the definitive document explaining the rules associated with the Ecological Metadata Language. FILES ----- The files in this distribution are a part of the final release of EML 2.0.1. The files in this directory include a "docs" directory that contains the EML Specification and all documentation for the modules, and an XML Schema document for each of the modules that make up EML. Also included is a schema for supporting documentation, and an instance document defining standard attribute units for EML. The "lib/sample/eml-sample.xml" file is a sample document illustrating the use of EML. The "test" directory contains a number of sample instance documents used for testing the schemas, and an application for checking document validity under JUnit (see http://junit.org). This release of EML can be retrieved from CVS using the tag "RELEASE_EML_2_0_1". Previous versions of EML (such as 1.4) are available from this repository using the appropriate release tag (i.e. RELEASE_EML_1_4). HIGHLIGHTS IN THIS RELEASE -------------------------- This is a bug fix and documentation release. No changes were made that are incompatible with the earlier 2.0.0 release. A new set of XSLT stylesheets has been included to show how EML can be transformed into an HTML display. Significant changes were made to the definition of access control elements to substantially simplify the access control model and make it easier for systems storing EML to implement. In addition, the precision field has now been made optional to accomodate data sets that have varying precision across the records in a single attribute. Finally, we fixed a bug in the "inline" element that had prevented it from being used as intended as a place to store data inline in an EML document. The reminaing issues are largely changes in documentation. KNOWN ISSUES (see also http://bugzilla.ecoinformatics.org/) ----------------------------------------------------------- Some problems with unit dictionary remain and will be solved in a backwards-incompatible release in the future. See bug 1000 and 1605. BUGS FIXED AND NEW FEATURES (see also http://bugzilla.ecoinformatics.org/) -------------------------------------------------------------------------- 2.0.1 Changes- (numbers refer to the corresponding Bugzilla bug) 249: Update XSLT stylesheets for EML 2.0 modules 939: spelling errors for 'its' in index 960: parser not correctly parsing tag in additiona... 1008: inline element doesn't support character child 1017: documentation error in eml-methods 1031: enumeratedDomain doesn't define value order for ordinals 1035: Technical documentation on eml-methods has an error 1124: update precision field definition and cardinality 1129: Change temporalCoverage calendarDate type 1132: fix access control rule ambiguities 1136: kelvin conversion incorrect in unit dictionary 1149: BoundsGroup bounds min & max have incorrect cardinality 1150: documentation for KeyTypeCode is wrong 1151: misspelled element name 1153: dateTimeDomain element should be optional 1155: Documentation incorrect for dateTimeDomainType bounds 1195: tracking bug for 2.0.1 release 1233: dateTime formatString Documentation contains incorrect ex... 1529: no tag to specify how to handle mutltiple, repeated delimimeters 1652: eml-constraint documentation error 2.0.0 Changes- (numbers refer to the corresponding Bugzilla bug) 670: DateTimeDomain id/reference validation 924: make date time its own measurement scale 661: spell check eml-attribute.xsd and synchronize with unitDi 918: example tag in eml:documentation 2.0.0rc3 Changes- (numbers refer to the corresponding Bugzilla bug) 471: eml spec overview document 624: eml-methods/methodsType needs clarification on choice/seq... 627: links broken in EML FAQ 629: unit conversion coefficients need checking 637: attributeDomain should be required 638: request for id/ref in attributeDomain 654: scope of the unit element 655: need better model for numeric domains for attributes 625: Cardinality regarding eml-methods should be corrected in ... 626: ProcedureStepType schema needs revision to protect sequen... 628: eml-physical has lit: rather than cit: references 632: broken link in faq 634: Documentation of reference elements in the schemas 656: physical should be repeatable RC2 Changes- (numbers refer to the corresponding Bugzilla bug) 568: accommodate of stateful connection information 586: resolve validation problem with missing keys 588: Remove lineage tags in documentation stylesheets 589: eml-coverage: convert element references to types 592: fix validation error with xs:anyType 594: change cardinality for designDescription and studyAreaDes... 596: Proposal: make attribute optional in OtherEntityType. 597: In eml-dataTable caseSensitive and orientation are modele... 598: literature namespace references are inconsistent 599: storageType is repeatable in eml-attribute 600: eml-storedProcedure - problems & proposal 601: element names in spatial modules do not follow guidelines 602: eml-physical fixed textFormat to allow mixed fixed/delimited 608: release preparation tasks for EML2.0.0rc2 622: redundancy in eml-physical/binaryRaster RC1 Changes- (numbers refer to the corresponding Bugzilla bug) 471: created an EML specification overview document 495: created FAQ for EML 588: removed lineage tags from documentation stylesheet 484: eml-attribute changes to unit and attributeDomain 579: fixed eml-docbook validation problems 491: eml-coverage changed to correctly import types and to fix singleDateTime model 485: eml-physical changed to fix fixed ascii descriptors and distribution 477: complexTypes imports changed to consistent model 486: fixed spelling errors in eml-constraint 492: eml-literature changed for EndNote consistency 496: copyright updated throughout 557: textual elements changed to use docbook subset define in eml-text.xsd 563: changed id types from xs:ID to xs:string to allow numeric ids 482: eml-dataset changed to include method element 489: eml-protocol completely revised based on feedback, eml-method.xsd created 544: eml-attribute storageType and attributeDomain documentation clarified 556: format of eml namespaces changed to include ecoinformatics.org 539: added additionalInfo and alternateIdentifier to eml-dataTable.xsd 568: redesigned DistributionType to allow richer connection descriptions 566: changed imports in eml-resource to import resource types not elements 567: created eml sample documents and XML validation framework using ant/junit Beta9 Fixes- 1) Changed packaging concept to use internal id and references instead of triples 2) Review and revised all modules according to agreed upon changes from the April, 2002 EML meeting at Sevilleta Field Station Beta 8 Fixes- 1) Fixed illegal declaration of type and extension in eml-entity 2) Updated all PNG image files Beta 7 Fixes- 1) Added a 'style' subdirectory with a style sheet for most modules to translate the metadata to HTML 2) Changed names of coverage elements to be human readable 3) Updated the namespaces to reflect the current version number of EML 4) Added an eml-data module for the in-lining of data. 5) Added the eml module for creating packages all in one file. It is a single node with a model of ANY so any of the eml modules can be put into it. 6) Numerous bug fixes (see bugzilla.ecoinformatics.org) Legalese -------- This software is copyrighted (1997-2002) by The Regents of the University of California, University of New Mexico, and Arizona State University and licensed under the GNU GPL; see the 'LICENSE' file for details. This material is based upon work supported by the National Science Foundation under Grant No. 0225676, DEB-9980154, DBI-9904777, DEB-0072909, DBI-9983132, and DEB-9634135. Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not necessarily reflect the views of the National Science Foundation (NSF). This product includes software developed by the Apache Software Foundation (http://www.apache.org/). See the LICENSE file in lib/apache for details. The source code, object code, and documentation in the com.oreilly.servlet package is copyright and owned by Jason Hunter. See the cos-license.html file for details of the license. Licensor retains title to and ownership of the Software and all enhancements, modifications, and updates to the Software. This product includes software developed by the JDOM Project (http://www.jdom.org/). See jdom-LICENSE.txt for details.