'$RCSfile: eml-resource.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.93 $'

    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

moduleName: eml-resource

moduleDescription: 
          
            
              The eml-resource module - Base information for
              all resources
            
          
        

recommendedUsage: all datasets

standAlone: no

tooltip: References

summary: The id of another element in this
            EML document to be used to here in this context.
            

description: The id of another element in
            this EML document to be used to here in this context.
            This is used instead of duplicating information when an identical
            piece of information needs to be used multiple times in an
            EML document. For example, if the same person is the creator,
            metadataProvider, and contact for a dataset, their name and address
            can be provided once as part of the "creator" element, and then
            their "id" can be used in the "references" element of
            metadataProvider and contact.  This reduces the likelihood of
            error by reducing redundancy, and allows one to specify that
            two pieces of information are identical.  To be a valid EML
            document, the content of every "references" element MUST be
            defined in the document as the value of an "id" attribute on
            some element within the document.  Other critical rules
            about the use of IDs and references in EML are provided in the
            text of the EML specification.

example: knb.45.3

tooltip: Alternate Identifier

summary: A secondary identifier for this entity

description: An additional, secondary identifier for this
            entity. The primary identifier belongs in the "id" attribute, but
            additional identifiers that are used to label this entity, possibly
            from different data management systems, can be listed
            here.

example: VCR3465

tooltip: Short Name

summary: A short name that describes the resource, sometimes a
            filename.

description: The 'shortName' field provides a concise name that
            describes the resource that is being documented. It is the
            appropriate place to store a filename associated with other storage
            systems.

example: vernal-data-1999

tooltip: Title

summary: A brief description of the resource, providing enough
            detail to differentiate it from other similar
            resources.

description: The 'title' field provides a description of the
            resource that is being documented that is long enough to
            differentiate it from other similar resources. Multiple titles may
            be provided to indicate alternate titles for the resource. When
            specifying translations of the resource's title, it is recommended
            that translations be provided in one or more 'value' child elements
            rather than with repeated 'title' elements. See
            'i18nNonEmptyStringType' for more information on providing
            translations.
            

example: Vernal pool amphibian density data, Isla Vista,
            1990-1996.

example: To indicate a translation of a title, add
              value child elements inside the title field:

              <title>
                Vernal pool amphibian density data, Isla Vista, 1990-1996.
                <value xml:lang="es">
                  Données de densité d'amphibiens de la piscine vernale, Isla
                  Vista, 1990-1996.
                </value>
              </title>

tooltip: Creator

summary: The people or organizations who created this
            resource.

description: The 'creator' element provides the full name of
            the person, organization, or position who created the resource. The
            list of creators for a resource represent the people and
            organizations who should be cited for the
            resource.

example: For a book, the creators are its
            authors.

tooltip: Metadata Provider

summary: The people or organizations who created provided
            documentation and other metadata for this resource.

description: The 'metadataProvider' element provides the full
            name of the person, organization, or position who created
            documentation for the resource.

example: The scientist who collected the data, sometimes a data
            technician, or other individual.

tooltip: Associated Party

summary: Other people or organizations who should be associated
            with this resource.

description: The 'associatedParty' element provides the full
            name of other people, organizations, or positions who should be
            associated with the resource. These parties might play various
            roles in the creation or maintenance of the resource, and these
            roles should be indicated in the "role" element.

example: The technician who collected the data.

tooltip: Role

summary: The role the party played with respect to
                      the resource.

description: Use this field to describe the role the
                      party played with respect to the resource. Some potential
                      roles include technician, reviewer, principal
                      investigator, and many others.

example: principalInvestigator

tooltip: Publication date

summary: The publication date of the resource.

description: The 'pubDate' field represents the date that the
            resource was published. The format should be represented as: CCYY,
            which represents a 4 digit year, or as CCYY-MM-DD, which denotes
            the full year, month, and day. Note that month and day are optional
            components. Formats must conform to ISO 8601.

example: 1999-10-26

tooltip: Language

summary: The language in which the resource is
            written.

description: The language in which the resource is written.
            This can be a well-known language name, or one of the ISO language
            codes to be more precise.

example: English

tooltip: Series

summary: The series from which the resource came.

description: This field describes the series of resources that
            include the resource being described. For example, a volume of a
            journal may be part of a series of the journal for a particular
            year.

example: Volume 20

tooltip: Abstract

summary: A brief overview of the resource.

description: A brief overview of the resource that is being
            documented. The abstract should include basic information that
            summarizes the resource.

tooltip: Keyword information

summary: Keyword information that describes the
            resource.

description: The 'keywordSet' element is a container for the
            'keyword' and 'keywordThesaurus' fields. Each keywordSet field can
            contain one or more keywords and a name of a thesaurus for the set
            of keywords. Each keyword field should contain one and only one
            keyword (i.e., keywords should not be separated by commas or other
            delimiters).

example: Please see the examples for the subfields contained
            within this field.

tooltip: Keyword

summary: A single keyword that describes the
                  resource.

description: This field names a keyword or key phrase that
                  concisely describes the resource or is related to the
                  resource. Each keyword field should contain one and only one
                  keyword (i.e., keywords should not be separated by commas or
                  other delimiters).

example: biodiversity

tooltip: Keyword thesaurus

summary: The name of a thesaurus from which the keyword
                  is derived.

description: This field provides the name of the official
                  keyword thesaurus from which keyword was derived. The keyword
                  thesauri are usually discipline specific.

example: IRIS keyword thesaurus

tooltip: Additional Information

summary: Any extra information pertitent to the
            resource.

description: This field provides any information that is not
            characterized by the other resource metadata
            fields.

example: Copyright 2001, Robert Warner

tooltip: Intellectual Property Rights

summary: Intellectual property rights regarding usage and
            licensing of this resource.

description: Typically, an intellectual Rights element will
            contain a rights management statement for the resource, or
            reference a service providing such information. Rights information
            encompasses Intellectual Property Rights (IPR), Copyright, and
            various Property Rights. In the case of a data set, rights might
            include requirements for use, requirements for attribution, or other
            requirements the owner would like to impose.

example: Copyright 2001 Regents of the University of California
            Santa Barbara. Free for use by all individuals provided that the
            owners are acknowledged in any use or publication.

tooltip: License

summary: Information identifying a well-known license for the metadata and data
            

description: This element provides information on how the resource is licensed
                and what rights may be available to users.   While data are often not
                copyrightable in the US and other jurisdictions, it is still useful
                to clarify rights by declaring a CC0, CC-BY, or similar license for both the
                metadata and data.  Whatever license is declared here is intended to apply to
                all metadata and data described in the metadata record, including attached data
                resources such as external files and databases.  If multiple license elements
                are provided, this indicates that the resource can be used under the terms of
                any of the listed licenses. The field is meant to be highly structured
                to allow machine-interpretable licenses to be asserted for the resource.  This
                is done by identifying a well-defined license or contract and providing
                the SPDX license key or the license URL, and the name of the license.
                Where posisble, the name, URL, and SPDX key should match the values found in
                the official SPDX license vocabulary (https://spdx.org/licenses/).  If
                the license is not found in SPDX, then other well-established URIs for
                licenses can be used, but avoid using arbitrary URIs that
                are not maintained for persistence.
            

example: 
                <license>
                    <licenseName>Apache License 2.0</licenseName>
                    <url>https://spdx.org/licenses/Apache-2.0.html</url>
                    <identifier>Apache-2.0</identifier>
                </license>

tooltip: License Name

summary: The official name of the license

description: The official name of a license that applies to the
                        data and metadata described in this metadata record.
                        The name should match the name of a well-known license from
                        the SPDX license vocabulary or a similar persistent vocabulary.
                    

example: Apache License 2.0

tooltip: License URL

summary: The persistent URL for the license

description: The persistent URL for the license, typically
                        a SPDX URL, or an official URL from another well-known
                        license vocabulary.  Users should avoid using arbitrary
                        URLs that are not the official URL for a license.
                    

example: https://spdx.org/licenses/Apache-2.0.html

tooltip: License Identifier

summary: License Identifier

description: The official identifier for the license, which
                        should be drawn from the SPDX license vocabulary, or a similar
                        well-known license vocabulary.
                    

example: Apache-2.0

tooltip: Distribution Information

summary: Information on how the resource is distributed online
            and offline

description: This element provides information on how the
            resource is distributed. When used at the resource level, this element can provide
            only general information, but elements for describing connections to online
            systems are provided. See the Type for specific recommendations and examples.

tooltip: distribution/online

summary: Online distribution information

description: This element contains information for accessing the
              resource online, represented either as a URL a connection, or
              a connectionDefinition which may be referenced in other parts of
              the EML document. See the Type definition for more information.

tooltip: Description of online information

summary: Brief description of the the content of online

description: This element can hold a brief description of the content
            of the online element's online|offline|inline child. This description element could
            supply content for an html anchor tag.

tooltip: URL

summary: A URL or this resource.

description: A URL (Uniform Resource Locator) from which this additional
              information can be obtained, or from which the resource can be downloaded
              directly. In the resource module, the distribution URL is generally meant for
              informational purposes, and the "function" attribute should be set to "information".
              However, if the URL returns the data stream itself, then the "function" attribute
              should be set to "download".  See the Type Definition for more information.

tooltip: Connection

summary: A connection to a data service

description: A description of the information needed to make an application
              connection to a data service. The connection contains a connectionDefinition
              and optional parameters for overriding defaults. See the Type Definition for
              more information.

tooltip: Connection Definition

summary: Connection Definition

description: In a ConnectionType, the connectionDefinition element provides the definition of the protocol and its parameters. The definition has a "scheme" which identifies the protocol by name, with a detailed description and its required parameters. A connectionDefinition lists all of the parameters needed for the connection and possible default values for each.

tooltip: Scheme Name

summary: The name of the scheme used to identify this
              connection.

description: The name of the scheme used to identify this
              connection.  The scheme name is qualified by its system attribute.
              The scheme name implies a particular protocol for
              accessing information from the connection.  Applications must
              have a knowledge of the scheme or be able to deduce the protocol
              from the scheme description in order to effectively access data
              over the connection.  Many schemes will be unknown to client
              applications.  At some later point in time a registry for
              connection schemes may be established in order to promote
              application interoperability, and we may expand this portion of
              EML to adopt a more comprehensive standard such as WSDL, but for
              now this simpler description is provided.

example: metacat

tooltip: Scheme Description

summary: The description of the scheme used to identify this
              connection.

description: The description of the scheme used to identify
              this connection. The scheme name implies a particular protocol for
              accessing information from the connection.  Applications must
              have a knowledge of the scheme or be able to deduce the protocol
              from the scheme description in order to effectively access data
              over the connection.

example: The metacat application protocol.  Applications
              must first log into metacat by sending an HTTP POST request
              in http-url-encoded format with the parameters action, username,
              and password.  Action must be set to "login".
              If authentication is successful, the metacat
              server will respond with a session cookie.  All future requests
              should include the session cookie in the HTTP header.  To
              retrieve an object, the client then would send an HTTP POST
              in http-url-encoded format, with an action parameter set to
              "get" and the docid parameter set to the identifier for the
              desired object.  The response will either be an XML document
              or a multipart-form-encoded response containing data.

tooltip: Parameter Definition

summary: The definition of a parameter that is needed to
              properly use this connection scheme.

description: The definition of a parameter that is needed to
              properly use this connection scheme.  Each parameter has a name
              and a definition that are used by applications to assess the type
              of information needed for the request.  Parameters may also set
              default values that are used if a connection does not provide a
              value for a parameter.

tooltip: Parameter Name

summary: The Name of a parameter that is needed to
                    properly use this connection scheme.

description: The name of a parameter that is needed to
                    properly use this connection scheme.

example: hostname

tooltip: Parameter Definition

summary: The definition of a parameter that is needed
                    to properly use this connection scheme.

description: The definition of a parameter that is
                    needed to properly use this connection scheme.  The
                    definition is used by applications to assess the type
                    of information needed for the request.

example: The fully qualified name of the internet host
                    that is providing the metacat service, as would be returned
                    by a Domain Name System (DNS) query.

tooltip: Default Parameter Value

summary: The default value for a parameter that is
                    needed to properly use this connection scheme.

description: The default value for a parameter that is
                    needed to properly use this connection scheme.  If a default
                    value is set, then it should be used for connections that
                    do not override the default with a connection-specific
                    value. This allows a definition to be established that
                    declares common information that might be shared by several
                    connections as default values.  Parameter values provided
                    in the connection always override any default values
                    provided in the connection definition.

example: metacat.nceas.ucsb.edu

tooltip: Parameter

summary: A parameter to be used to make this
                            connection.

description: A parameter to be used to make
                            this connection. This value overrides any
                            default value that may have been provided in the
                            connection definition.

tooltip: Parameter Name

summary: Name of the parameter to be
                                  used to make this connection.

description: The name of the parameter
                                  to be used to make this connection.
                                  

example: hostname

tooltip: Parameter Value

summary: The value of the parameter to
                                  be used to make this connection.
                                  

description: The value of the parameter
                                  to be used to make this connection. This
                                  value overrides any default value that may
                                  have been provided in the connection
                                  definition.

example: nceas.ucsb.edu

tooltip: Connection Definition

summary: The definition of a connection
        that will be used in another location in the EML
        document
                            

description: 
The definition of a type of connection
        that will be used in another location in the EML
        document. The connectionDefinition element only provides the definition of the
        protocol and its parameters, but not the actual values
        to be used to make the connection (instead, see the
        connection element).  This connectionDefinition may be
        used by multiple connections (e.g., to download different files
        from the same database), but each connection must provide or
        reference a valid connection definition.

     The definition has a "scheme" which identifies the
                            protocol by name, with a detailed description
                            and its required parameters. A connectionDefinition
                    lists all of the parameters needed for the connection
                    and possible default values for each.

tooltip: Offline distribution

summary: data are available offline

description: This element is for data which are distributed offline,
         generally by request. See the Type
        definition for more information.

tooltip: Medium name

summary: Name of the medium that for this resource
                    distribution

description: Name of the medium on which this resource
                    is distributed. Can be various digital media such as tapes
                    and disks, or printed media which can collectively be
                    termed 'hardcopy'.

example: Tape, 3.5 inch Floppy Disk,
                    hardcopy

tooltip: density of the digital medium

summary: the density of the digital medium if this is
                    relevant.

description: the density of the digital medium if this
                    is relevant. Used mainly for floppy disks or
                    tape.

example: High Density (HD), Double Density
                    (DD)

tooltip: units of a numerical density

summary: a numerical density's units

description: if a density is given numerically, the
                    units should be given here.

example: B/cm

tooltip: storage volume

summary: total volume of the storage
                    medium

description: the total volume of the storage medium on
                    which this resource is shipped.

example: 650 MB

tooltip: medium format

summary: format of the medium on which the resource is
                    shipped.

description: the file system format of the medium on
                    which the resource is shipped

example: NTFS, FAT32, EXT2, QIK80

tooltip: note about the media

summary: note about the media

description: any additional pertinent information about
                    the media

tooltip: Inline distribution

summary: data distributed inline in the metadata.

description: The data are distributed inline, with the metadata. See the Type
        definition for more information.

tooltip: Resource coverage

summary: Extent of the coverage of the resource.

description: This element describes the extent of the coverage
            of the resource in terms of its spatial extent, temporal extent,
            and taxonomic extent. For data sets, this is useful to specify the
            entire extent to which all of the data might
            apply.

example: See the coverage module for examples.

tooltip: Semantic Annotation

summary: A precisely-defined semantic statement about this resource.
            

description: An annotation represents a precisely-defined semantic
                  statement that applies to this resource.  This semantic
                  statement is used to associate precise semantics with the
                  resource.  Each annotation consists of a propertyURI and
                  valueURI that define a property and value that apply to the
                  resource. The subject of the statement is implicitly the
                  eml:resource that contains the annotation.  The associated
                  labels can be used to display the statement to users.
                  Each URI is resolvable to a controlled vocabulary
                  that provides a definition, relationships to other terms, and
                  multiple labels for displaying the statement.

tooltip: Non Empty String Type

summary: Non Empty String Type

description: This type specifies a content pattern for all elements
          that are required by EML to ensure that there is actual content (i.e.,
          not just whitespace). The pattern described can be interpreted as
          "at least one non-whitespace character, followed
          by any number of whitespace plus not-whitespace characters. "
          Leading and/or trailing whitespace is allowed, and whitespace
          may include carriage returns and newlines.