XML Schema "SIA-v1.2.xsd"
Target Namespace:
http://www.ivoa.net/xml/SIA/v1.1
Version:
1.2
Defined Components:
13 local elements, 4 complexTypes, 1 simpleType
Default Namespace-Qualified Form:
Local Elements: unqualified; Local Attributes: unqualified
Schema Location:
/home/msdemlei/gavo/trunk/gavo/resources/schemata/SIA-v1.2.xsd; see XML source
Imports Schema:
VOResource-v1.1.xsd [src]
Annotation
Implementation of an XML Schema describing a Simple Image Access Service. Based on the Simple Image Access Specification by Doug Tody et al.
XML Source
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www.ivoa.net/xml/SIA/v1.1" version="1.2" xmlns:sia="http://www.ivoa.net/xml/SIA/v1.1" xmlns:vm="http://www.ivoa.net/xml/VOMetadata/v0.1" xmlns:vr="http://www.ivoa.net/xml/VOResource/v1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:annotation>
<xs:appinfo>
<vm:schemaName>SIA</vm:schemaName>
<vm:schemaPrefix>xs</vm:schemaPrefix>
<vm:targetPrefix>sia</vm:targetPrefix>
</xs:appinfo>
<xs:documentation>
Implementation of an XML Schema describing a Simple Image
Access Service. Based on the Simple Image Access Specification
by Doug Tody et al.
</xs:documentation>
</xs:annotation>
<xs:complexType name="SimpleImageAccess">
<xs:annotation>
<xs:documentation>
The capabilities of an SIA implementation.
</xs:documentation>
</xs:annotation>
<xs:complexContent>
<xs:extension base="vr:Capability">
<xs:sequence>
<xs:element name="imageServiceType" type="sia:ImageServiceType">
<xs:annotation>
<xs:documentation>
The class of image service: Cutout, Mosaic, Atlas, Pointed
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="maxQueryRegionSize" type="sia:SkySize">
<xs:annotation>
<xs:documentation>
The maximum image query region size, expressed in
decimal degrees. Not providing this element or
specifying a value of 360 degrees indicates that
there is no limit and the entire data collection
(entire sky) can be queried.
</xs:documentation>
<xs:documentation>
Not providing a value is the prefered way to indicate
that there is no limit.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="maxImageExtent" type="sia:SkySize">
<xs:annotation>
<xs:documentation>
An upper bound on a region of the sky that can
be covered by returned images. That is, no image
returned by this service will cover more than
this limit. Not providing this element or
specifying a value of 360 degrees indicates that
there is no fundamental limit to the region covered
by a returned image.
</xs:documentation>
<xs:documentation>
When the imageServiceType is &#8220;Cutout&#8221; or &#8220;Mosaic&#8221;,
this represents the largest area that can be requested.
In this case, the &#8220;no limit&#8221; value means that all-sky
images can be requested. When the type is &#8220;Atlas&#8221; or
&#8220;Pointed&#8221;, it should be a region that most closely
encloses largest images in the archive, and the &#8221;no
limit&#8221; value means that the archive contains all-sky
(or nearly so) images.
</xs:documentation>
<xs:documentation>
Not providing a value is the prefered way to indicate
that there is no limit.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="maxImageSize" type="xs:positiveInteger">
<xs:annotation>
<xs:documentation>
A measure of the largest image the service
can produce given as the maximum number of
pixels along the first or second axes.
Not providing a value indicates that there is
no effective limit to the size of the images
that can be returned.
</xs:documentation>
<xs:documentation>
This is primarily relevant when the imageServiceType
is &#8220;Cutout&#8221; or &#8220;Mosaic&#8221;, indicating the largest
image that can be created. When the imageServiceType
is &#8220;Atlas&#8221; or &#8220;Pointed&#8221;, this should be specified only
when there are static images in the archive that can
be searched for but not returned because they are
too big.
</xs:documentation>
<xs:documentation>
When a service is more fundementally limited
by the total number of pixels in the image, this
value should be set to the square-root of that
number. This number will then represent a
lower limit on the maximum length of a side.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="maxFileSize" type="xs:positiveInteger">
<xs:annotation>
<xs:documentation>
The maximum image file size in bytes. Not providing
a value indicates that there is no effective limit
the size of files that can be returned.
</xs:documentation>
<xs:documentation>
This is primarily relevant when the imageServiceType
is &#8220;Cutout&#8221; or &#8220;Mosaic&#8221;, indicating the largest
files that can be created. When the imageServiceType
is &#8220;Atlas&#8221; or &#8220;Pointed&#8221;, this should be specified only
when there are static images in the archive that can
be searched for but not returned because they are
too big.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="maxRecords" type="xs:positiveInteger">
<xs:annotation>
<xs:documentation>
The largest number of records that the Image Query web
method will return. Not providing this value means that
there is no effective limit.
</xs:documentation>
<xs:documentation>
This does not refer to the total number of images in
the archive but rather maximum number of records the
service is capable of returning. A limit that is
greater than the number of images available in the
archive is equivalent to their being no effective
limit. (See RM, Hanisch 2007.)
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element maxOccurs="1" minOccurs="0" name="testQuery" type="sia:Query">
<xs:annotation>
<xs:documentation>
a set of query parameters that is expected
to produce at least one matched record which
can be used to test the service.
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:extension>
</xs:complexContent>
</xs:complexType>
<xs:complexType name="SkySize">
<xs:sequence>
<xs:element name="long" type="xs:double">
<xs:annotation>
<xs:documentation>
The maximum size in the longitude (R.A.) direction
given in degrees
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="lat" type="xs:double">
<xs:annotation>
<xs:documentation>
The maximum size in the latitude (Dec.) direction
given in degrees
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:complexType name="SkyPos">
<xs:sequence>
<xs:element name="long" type="xs:double">
<xs:annotation>
<xs:documentation>
The sky position in the longitude (R.A.) direction
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="lat" type="xs:double">
<xs:annotation>
<xs:documentation>
The sky position in the latitude (Dec.) direction
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<xs:simpleType name="ImageServiceType">
<xs:annotation>
<xs:documentation>
The class of image service: Cutout, Mosaic, Atlas, Pointed
</xs:documentation>
</xs:annotation>
<xs:restriction base="xs:token">
<xs:enumeration value="Cutout">
<xs:annotation>
<xs:documentation>
This is a service which extracts or &#8220;cuts out&#8221; rectangular
regions of some larger image, returning an image of the
requested size to the client. Such images are usually drawn
from a database or a collection of survey images that cover
some large portion of the sky. To be considered a cutout
service, the returned image should closely approximate (or at
least not exceed) the size of the requested region; however,
a cutout service will not normally resample (rescale or
reproject) the pixel data. A cutout service may mosaic image
segments to cover a large region but is still considered a
cutout service if it does not resample the data. Image
cutout services are fast and avoid image degredation due to
resampling.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Mosaic">
<xs:annotation>
<xs:documentation>
This service is similar to the image cutout service
but adds the capability to compute an image of the
size, scale, and projection specified by the
client. Mosaic services include services which
resample and reproject existing image data, as well
as services which generate pixels from some more
fundamental dataset, e.g., a high energy event list
or a radio astronomy measurement set. Image mosaics
can be expensive to generate for large regions but
they make it easier for the client to overlay image
data from different sources. Image mosaicing
services which resample already pixelated data will
degrade the data slightly, unlike the simpler cutout
service which returns the data unchanged.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Atlas">
<xs:annotation>
<xs:documentation>
This category of service provides access to
pre-computed images that make up a survey of some
large portion of the sky. The service, however, is
not capable of dynamically cutting out requested
regions, and the size of atlas images is
predetermined by the survey. Atlas images may range
in size from small cutouts of extended objects to
large calibrated survey data frames.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
<xs:enumeration value="Pointed">
<xs:annotation>
<xs:documentation>
This category of service provides access to
collections of images of many small, &#8220;pointed&#8221;
regions of the sky. &#8220;Pointed&#8221; images normally focus
on specific sources in the sky as opposed to being
part of a sky survey. This type of service usually
applies to instrumental archives from observatories
with guest observer programs (e.g., the HST archive)
and other general purpose image archives (e.g., the
ADIL). If a service provides access to both survey
and pointed images, then it should be considered a
Pointed Image Archive for the purposes of this
specification; if a differentiation between the
types of data is desired the pointed and survey data
collections should be registered as separate image
services.
</xs:documentation>
</xs:annotation>
</xs:enumeration>
</xs:restriction>
</xs:simpleType>
<xs:complexType name="Query">
<xs:annotation>
<xs:documentation>
A query to be sent to the service
</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element minOccurs="0" name="pos" type="sia:SkyPos">
<xs:annotation>
<xs:documentation>
the center position of the rectangular region that
should be used as part of the query to the SIA service.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="size" type="sia:SkySize">
<xs:annotation>
<xs:documentation>
the rectangular size of the region that should be
used as part of the query to the SIA service.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="verb" type="xs:positiveInteger">
<xs:annotation>
<xs:documentation>
the verbosity level to use where 0 means the bare
minimum set of columns and 3 means the full set of
available columns.
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="extras" type="xs:string">
<xs:annotation>
<xs:documentation>
any extra (particularly non-standard) parameters that must
be provided (apart from what is part of base URL given by
the accessURL element).
</xs:documentation>
<xs:documentation>
this value should be in the form of name=value
pairs delimited with ampersands (&amp;).
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>

This XML schema documentation has been generated with DocFlex/XML RE 1.8.0 using DocFlex/XML XSDDoc 2.2.0 template set.
DocFlex/XML RE is a reduced edition of DocFlex/XML, which is a tool for programming and running highly sophisticated documentation and reports generators by the data obtained from any kind of XML files. The actual doc-generators are implemented in the form of special templates that are designed visually using a high quality Template Designer GUI basing on the XML schema (or DTD) files describing the data source XML.
DocFlex/XML XSDDoc is a commercial template application of DocFlex/XML that implements a high-end XML Schema documentation generator with simultaneous support of framed multi-file HTML, single-file HTML and RTF output formats. (More formats are planned in the future).
A commercial license for "DocFlex/XML XSDDoc" will allow you:
  • To configure the generated documentation so much as you want. Thanks to our template technology, it was possible to support more than 300 template parameters (working the same as "options" of an ordinary doc-gen), which will give you an unprecedented control over the generated content!
  • To use certain features disabled in the free mode (such as the full documenting of substitution groups).
  • To enable/disable documenting of the initial, imported, included and redefined XML schemas selectively.
  • To document local element components both globally and locally (similar to attributes).
  • To enable/disable reproducing of namespace prefixes.
  • To format your annotations with XHTML tags and reproduce that formatting both in HTML and RTF output.
  • To insert images in your annotations using XHTML <img> tags (supported both in HTML and RTF output).
  • To use PlainDoc.tpl main template to generate all the XML schema documentation in the form of a single HTML file.
  • To use the same template to generate the incredible quality RTF documentation.
  • To document only selected XML schema components specified by name.
  • To remove this very advertisement text
Once having only such a license, you will be able to run the fully-featured XML schema documentation generator both with DocFlex/XML SDK and with DocFlex/XML RE, which is a reduced free edition containing only the template interpretor / output generator. No other licenses will be required!
But this is not all. In addition to it, a commercial license for DocFlex/XML SDK will allow you to modify the XSDDoc templates themselves as much as you want. You will be able to achieve whatever was impossible to do with the template parameters only. And, of course, you could develop any template applications by your own!
Please note: By purchasing a license for this software, you not only acquire a useful tool, you will also make an important investment in its future development, the result of which you could enjoy later by yourself. Every single your purchase matters and makes a difference for us!
To buy a license, please follow this link: http://www.filigris.com/shop/