'$RCSfile: eml-dataset.xsd,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: obrien $' '$Date: 2009-02-25 23:51:54 $' '$Revision: 1.59 $' 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-dataset
The eml-dataset module - Dataset specific information
all datasets yes
Dataset Descriptors The dataset field encompasses all information about a single dataset. The dataset field encompasses all information about a single dataset. A dataset is defined as all of the information describing a data collection event. This event may take place over some period of time and include many actual collections (a time series or remote sensing application) or it could be just one actual collection (a day in the field). Dataset DatasetType is the base type for the dataset element. DatasetType is the base type for the dataset element. The dataset field encompasses all information about a single dataset. A dataset is defined as all of the information describing a data collection event. This event may take place over some period of time and include many actual collections (a time series or remote sensing application) or it could be just one actual collection (a day in the field). Purpose A synopsis of the purpose of this dataset. A synopsis of the purpose of this dataset. It may include one or more paragraphs as well as inline links to table(s) and figure(s) that summarize the data included in the data paper, including a summary of key findings if appropriate. Note that this element requires DocBook style formatting. See eml-text for more information. Introduction An overview of the background and context for the dataset. One to many paragraphs that provide background and context for the dataset with appropriate figures and references. This is similar to the introduction for a journal article, and would include, for example, project objectives, hypotheses being addressed, what is known about the pattern or process under study, how the data have been used to date (including references), and how they could be used in the future. The introduction may include figure(s) and table(s) by first attaching those entities to the dataset (e.g., dataTable, otherEntity), providing an id attribute for that entity, and then referencing that entity id in the text of the introduction using Markdown's syntax for inline images. See eml-text for more information on formatting within this section. Getting Started A high level overview of interpretation, structure, and content of the dataset. One or more paragraphs that describe the overall interpretation, content and structure of the dataset. For example, the number and names of data files, they types of measurements that they contain, how those data files fit together in an overall design, and how they relate to the data collections methods, experimental design, and sampling design that are described in other EML sections. One might describe any specialized software that is available and/or may be necessary for analyzing or interpreting the data, and possibly include a high level description of data formats if they are unusual, keeping in mind that detailed desriptions of data structure and format are contained in the entity sections of EML. Citations, inline figures, and inline images can be included via inline references in Markdown sections. See eml-text for more information on formatting within this section. Acknowledgements Text that acknowledges funders and other key contributors. One or more sentences that acknowledge funders and other key contributors to the study (excluding the dataset authors listed in the creator field). Note that funding awards are also listed by award number in the eml-project award element, which provides a structured list of funders, award numbers, and award URIs for the dataset. When displaying acknowledgements, client software should provide both the information in this acknowledgements element as well as links from the award element. See eml-text for more information on formatting within this section. Maintenance A description of the maintenance of this data resource. A description of the maintenance of this data resource. This includes information about the frequency of update, and whether there is ongoing data collection. Contact The contact for this dataset The contact field contains contact information for this dataset. This is the person or institution to contact with questions about the use, interpretation of a data set. Data Set Publisher The publisher of this data set The publisher of this data set. At times this is a traditional publishing house, but it may also simply be an institution that is making the data available in a published (ie, citable) format. Publication place The location that the resource was published. The pubPlace field is the location where the resource was published, which may be different from where the resource was created. San Francisco, CA, USA New York, NY, USA methods The methods field documents scientific methods used in the collection of this dataset. The methods field documents scientific methods used in the collection of this dataset. It includes information on items such as tools, instrument calibration and software. project The project field contains information on the project in which this dataset was collected. The project field contains information on the project in which this dataset was collected. It includes information such as project personnel, funding, study area, project design and related projects. The project description can also contain documentation on subprojects. data table The dataTable field documents the dataTable(s) that make up this dataset. The dataTable field documents the dataTable(s) that make up this dataset. A dataTable could be anything from a Comma Separated Value (CSV) file to a spreadsheet to a table in an RDBMS. spatial raster The spatialRaster field describes any spatial raster images included in this dataset. The spatialRaster field describes any spatial raster images included in this dataset. spatial vector The spatialVector field describes any spatial vectors included in this dataset. The spatialVector field describes any spatial vectors included in this dataset. stored procedure The storedProcedure field contains information about any stored procedures included with this dataset. The storedProcedure field contains information about any stored procedures included with this dataset. This usually implies that the dataset is stored in a DBMS or some other data management system capable of processing your dataset. view The view field contains information about any views included with this dataset. The view field contains information about any view included with this dataset. This usually implies that the dataset is stored in a DBMS or some other data management system capable of processing your dataset. other entity The otherEntity field contains information about any entity in the dataset that is not any of the preceding entities. The otherEntity field contains information about any entity in the dataset that is not any of the preceding entities. (i.e. it is not a table, spatialRaster, spatialVector, storedProcedure or view.) OtherEntity allows the documentation of basic entity fields as well as a plain text field to allow you to type your entity. Reference Publication A citation to an additional publication that serves as an important reference for a dataset. A citation to an additional publication that serves as an important reference for a dataset. People using this dataset should generally cite the dataset itself (using the creator, pubDate, title, publisher, and packageId fields), and consider providing an additional citation to the Reference Publication. Common cases where a Reference Publication may be useful include when a data paper is published that describes the dataset, or when a paper is intended to be the canonical or examplar reference to the dataset. Usage Citation A citation to articles or products in which the dataset is used or referenced. A citation to articles or products in which the dataset is used or referenced. The citation element contains general information about a literature resource that has used or references this dataset resource. It is not expected that the list of usageCitations will necessarily be complete, but rather they serve as examples and pointers to scholarly works in which this dataset has been used. Literature Cited A citation to articles or products which were referenced in the dataset or its associated metadata. A citation to articles or products which were referenced in the dataset or its associated metadata. The list represents the bibliography of works related to the dataset, whether for reference, comparison, or others purposes. Maintenance Type The maintenance type defines the fields for the maintenance element. It encompasses all information related to the maintenance and upkeep of this dataset. The maintenance type defines the fields for the maintenance element. Maintenance Description A text description of the maintenance of this data resource. A text description of the maintenance of this data resource. Note that this field must be marked up using DocBook like tagging. See eml-text for more information. Maintenance Update Frequency Frequency with which changes and additions are made to the dataset after the initial dataset is completed. Frequency with which changes and additions are made to the dataset after the initial dataset is completed. The values for this field must come from the enumeration MaintUpFreqType. Change History A description of changes made to the data since its release. A description of changes made to the data since its release. Change Scope An expression describing the scope to which the documented change was applied. The expression should unambiguously identify the entity(s) and attribute(s) that were changed. Old Value The previous value of the data prior to the change. The previous value or an expression that describes the previous value of the data. Change Date The date the changes were applied. The date the changes were applied. Comment Explanation or justification for the change made to the data. Explanation or justification for the change made to the data.