'$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.