VOResource
xs
vr
Implementation of an XML Schema describing a resource to
be used in the Virtual Observatory Project. Based on "Resource
Metadata for the Virtual Observatory", Version 0.8,
February 2002 by Bob Hanisch et al.
Diff 0.05-0.06: The Topologi tool apparently doesn't like
annotations of global elements referenced locally.
Although, this does not appear to be in violation of the XML
Schema standard, they have been commented out for the time
being.
Diff 0.06-0.1: Changed target namespace to
http://www.ivoa.net/xml/prop/VOResource.
Diff 0.8-0.1: Updated for RM v0.8; jumped version # to match RM.
Diff 0.8.1-0.8: A proposed structuring of the RM model for v0.9
Diff 0.8.2-0.8.1: "Manager" changed back to "Publisher";
"Subject" contents elevated one level, "Topic" changed back
to "Subject"; more documentation; "ResourceKey" made
mandatory; added extensible relationships.
Diff 0.8.3-0.8.2: fix bug in def of VOResource; set minimum mandatory
elements; added LogicalIdentifier; added admin attributes to Resource:
created, updated, status; moved Description, ReferenceURL, Source to
Summary element; added Source; correct misspelling of categoryType;
added "Other" type; make RelatedTo a ResourceReferenceType; dropped
ManagedResourceType; dropped Contact/Address,Phone; added role
attribute to Date; dropped ProjectRef,DataCollRef,ServiceRef,OrgRef;
Interface overhaul: move URL (as AccessURL) up as common child, move
ParamHTTPGet to VODataService (as ParamHTTP).
Diff 0.9-0.8.3: primarily version update to WD status; more
vm tagging.
Diff 0.10-0.9: restructured to replace substitution groups with
xsi:types. The schema no longer defines any global elements; only
global types. (Applications are responsible for defining root
elements.) Furthermore, the element names and hierarchy have been
modified to more closely match that of the RM document. The
use of the generic inclusion layer represented by
VOResourceRelType.xsd has been eliminated due to archiving
complications; it may be brought back when this schema reaches version
1.0.
A date stamp that can be given to a precision of either a
day (type xs:date) or seconds (type
vr:UTCdateTimeZ)
A UTC date stamp that is compliant with the ISO8601
specification of the timezone label.
Any entity or component of a VO application that is
describable and identifiable by a IVOA Identifier.
Title
the full name given to the resource
a short name or abbreviation given to the resource.
This name will be used where brief annotations for
the resource name are required. Applications may
use to refer to this resource in a compact display.
One word or a few letters is recommended. No more
than sixteen characters are allowed.
Identifier
Unambiguous reference to the resource conforming to the IVOA
standard for identifiers
Information regarding the general curation of the resource
Information regarding the general content of the resource
The date this resource metadata description was created.
The date this resource metadata description was last updated.
a tag indicating whether this resource is believed to be still
actively maintained.
resource is believed to be currently maintained, and its
description is up to date (default).
resource is apparently not being maintained at the present.
resource publisher has explicitly deleted the resource.
a short name or abbreviation given to something.
This name will be used where brief annotations for
the resource name are required. Applications may
use to refer to this resource in a compact display.
One word or a few letters is recommended. No more
than sixteen characters are allowed.
Information regarding the general curation of a resource
Publisher
Entity (e.g. person or organisation) responsible for making the
resource available
Creator
The entity (e.g. person or organisation) primarily responsible
for creating the content or constitution of the resource.
A logo need only be provided for the first occurance.
When multiple logos are supplied via multiple creator
elements, the application is free to choose which to
use.
Contributor
Entity responsible for contributions to the content of
the resource
Date
Date associated with an event in the life cycle of the
resource.
This will typically be associated with the creation or
availability (i.e., most recent release or version) of
the resource. Use the role attribute to clarify.
Label associated with creation or availablilty of a version of
a resource.
Information that can be used for contacting someone with
regard to this resource.
the name of a potentially registered resource. That is, the entity
referred to may have an associated identifier.
The URI form of the IVOA identifier for the resource refered to
Information that can be used for contacting someone
the name or title of the contact person.
This can be a person's name, e.g. "John P. Jones" or
a group, "Archive Support Team".
the contact mailing address
All components of the mailing address are given in one
string, e.g. "3700 San Martin Drive, Baltimore, MD 21218 USA".
the contact email address
the contact telephone number
Complete international dialing codes should be given, e.g.
"+1-410-338-1234".
The entity (e.g. person or organisation) primarily responsible
for creating something
the name or title of the creating person or organization
Users of the creation should use this name in
subsequent credits and acknowledgements.
URL pointing to a graphical logo, which may be used to help
identify the information source
A string indicating what the date refers to.
While this vocabulary is uncontrolled, recognized strings
include "creation", indicating the date that the resource
itself was created, and "update", indicating when the
resource was updated last. The default value,
"representative", means that the date is a rough
representation of the time coverage of the resource.
Note that this date refers to the resource; dates describing
the metadata description of the resource are handled by
the "created" and "updated" attributes of the Resource
element.
Information regarding the general content of a resource
Subject
a topic, object type, or other descriptive keywords
about the resource.
Terms for Subject should be drawn from the IAU Astronomy
Thesaurus (http://msowww.anu.edu.au/library/thesaurus/).
Description
An account of the nature of the resource
The description may include but is not limited to an abstract,
table of contents, reference to a graphical representation of
content or a free-text account of the content.
Source
a bibliographic reference from which the present resource is
derived or extracted.
This is intended to point to an article in the published
literature. An ADS Bibcode is recommended as a value when
available.
URL pointing to a human-readable document describing this
resource.
Type
Nature or genre of the content of the resource
Subject
Subject.ContentLevel
Description of the content level or intended audience
a description of a relationship to another resource.
The reference format. Recognized values include "bibcode",
referring to a standard astronomical bibcode
(http://cdsweb.u-strasbg.fr/simbad/refcode.html).
resource that does not fall into any of the category names
currently defined.
Collection of pointed observations
Collection of bibliographic reference, abstracts, and
publications
Collection of derived data, primarily in tabular form
Collection of scholarly publications under common editorial
policy
Collection of published materials (journals, books, etc.)
Theoretical simulation or model
Collection of observations covering substantial and
contiguous areas of the sky
A service that transforms data
Collection of materials appropriate for educational use, such
as teaching resources, curricula, etc.
Collection of materials appropriate for public outreach, such
as press releases and photo galleries
Collection of materials that may be suitable for EPO
products but which are not in final product form, as in Type
Outreach or Type Education. EPOResource would apply,
e.g., to archives with easily accessed preview images or to
surveys with easy-to-use images.
Animation clips of astronomical phenomena
Artists' renderings of astronomical phenomena or objects
Background information on astronomical phenomena or objects
Compilations of basic astronomical facts about objects,
such as approximate distance or membership in constellation.
Historical information about astronomical objects
Publication-quality photographs of astronomical objects
Press releases about astronomical objects
An organization that is a publisher or curator of other
resources.
A project that is a publisher or curator of other resources
a query service for which response is a structured
description of resources.
Resource provides information appropriate for all users
Resource provides information appropriate for use in elementary
education (e.g. approximate ages 6-11)
Resource provides information appropriate for use in middle
school education (e.g. approximate ages 11-14)
Resource provides information appropriate for use in elementary
education (e.g. approximate ages 14-18)
Resource provides information appropriate for use in
community/junior college or early university education.
Resource provides information appropriate for use in
university education
Resource provides information appropriate for
supporting scientific research.
Resource provides information of interest to
amateur astronomers.
Resource provides information appropriate for education
at museums, planetariums, and other centers of informal learning.
A description of the relationship between one resource and one or
more other resources.
the named type of relationship
the name of resource that this resource is related to.
The current resource mirrors another resource
The current resource is a service that provides access to
a data collection
The current resource can be accessed via the identified service.
The current resource is derived from another resource.
The current resource is related to another resource in an
unspecified way.
A named group of one or more persons brought together to pursue
participation in VO applications.
According to the Resource Metadata Recommendation, organisations
"can be hierarchical and range in size and scope. At a high level,
an organisation could be a university, observatory, or government
agency. At a finer level, it could be a specific scientific
project, mission, or individual researcher."
The main purpose of an organisation as a registered resource is
to serve as a publisher of other resources.
Subject
the observatory or facility used to collect the data
contained or managed by this resource.
Subject
Subject.Instrument
the Instrument used to collect the data contain or
managed by a resource.
a resource that can be invoked by a client to perform some action
on its behalf.
a description of how a client invokes the service
Since the Interface type is abstract, one must describe
the interface using a subclass of Interface, denoting
it via xsi:type.
A description of a service interface.
Since this type is abstract, one must use an Interface subclass
to describe an actual interface.
Additional interface subtypes (beyond WebService and WebBrowser) are
defined in the VODataService schema.
The URL (or base URL) that a client uses to access the
service. How this URL is to be interpreted and used
depends on the specific Interface subclass
Editor's note: this element assumes that
all registered services are inherently web based.
A flag indicating whether this should be interpreted as a base
URL, a full URL, or a URL to a directory that will produce a
listing of files.
The default value assumed when one is not given depends on the
context.
Assume a full URL--that is, one that can be invoked
directly without alteration. This usually returns a
single document or file.
Assume a base URL--that is, one requiring an extra portion
to be appended before being invoked.
Assume URL points to a directory that will return a listing
of files.
A (form-based) interface intended to be accesed interactively
by a user via a web browser.
The accessURL represents the URL of the web form itself.
To provide a metadata specific to a particular Service type,
this type is usually extended and added as a child of the
specific Service subclass.
An IVOA identifier for a standard service.
This provides a unique way to refer to a service
specification standard, such as a Simple Image Access service.
It assumes that such standard is registered and accessible.
A URL that points to a human-readable document that
describes the standard upon which a service is based.