IVOA Standards and Documents

https://www.ivoa.net/documents/
Admin
International Virtual Observatory Alliance (IVOA) official technical standards, recommendations,...
Tokens:1,033,040
Snippets:9,979
Trust Score:9.9
Update:4 months ago
Show doc for...
Tokens:
Raw
### Base URL Examples

Source: https://www.ivoa.net/Documents/PR/DAL/PR-SIA-1.0-20090521.html

Examples of base URLs for image query services, demonstrating the structure with and without extra GET arguments.

```text
http://myimages.org/cgi-bin/VOimq?   
http://adil.ncsa.uiuc.edu/voimagequery?resolv&issurvey=T&
```

--------------------------------

### RMILite Client Example

Source: https://www.ivoa.net/Documents/Notes/Plastic/PlasticDesktopInterop-20060601.html

Example code demonstrating how a client accesses a server using RMILite, including exporting an interface by reference.

```Java
Client client = new Client("localhost", port);
client.exportInterface(PlasticListener.class);
hub = (PlasticHubListener) client.lookup(PlasticHubListener.class);
```

--------------------------------

### Example VOEvent Packet Start

Source: https://www.ivoa.net/Documents/WD/VOEvent/VOEvent-20050714.html

An example of how a VOEvent packet might start, referencing Tycho Brahe's discovery.

```XML
<VOEvent id="ivo://uraniborg.hven/VOEvent#1572-11-11/0001" role="observation" version="1.0" xmlns:... >
```

--------------------------------

### Example Base URLs

Source: https://www.ivoa.net/Documents/PR/DAL/ConeSearch-20060908.html

Provides examples of base URLs for cone search services, one with extra GET arguments.

```http
http://mycone.org/cgi-bin/VOsearch?
```

```http
http://adil.ncsa.uiuc.edu/vocone?resolv&issurvey=T&
```

--------------------------------

### Example SSA HTTP GET Query

Source: https://www.ivoa.net/Documents/REC/DAL/SSA-20071220.html

An example of a complete URL for an SSA data query, including parameters for position and size.

```http
http://www.myvo.org/ssa?VERSION=1.0&REQUEST=queryData&POS=22.438,-17.2&SIZE=0.02
```

--------------------------------

### RMILite Server Example

Source: https://www.ivoa.net/Documents/Notes/Plastic/PlasticDesktopInterop-20060601.html

Example code demonstrating how a server exposes an object's methods over RMI using RMILite.

```Java
Server server = new Server(port);
server.publish(PlasticHubListener.class, new PlasticHubListenerImpl());
```

--------------------------------

### Metadata Query Example: Input Parameter Listing

Source: https://www.ivoa.net/Documents/WD/SIA/sia-20040524.html

This example shows how a Pointed Image Archive service lists its supported input parameters for a metadata query, including required, optional, and non-standard parameters.

```xml
<RESOURCE type="results">
     <DESCRIPTION>ADIL Simple Image Access Service</DESCRIPTION>
     <INFO name="QUERY_STATUS" value="OK"/>
     <PARAM name="INPUT:POS" value="0,0">
       <DESCRIPTION>Search Position in the form "ra,dec" where
                    ra and dec are given in decimal degrees in the ICRS
		    coordinate system.</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:SIZE" value="0.05">
       <DESCRIPTION>Size of search region in the RA and Dec. directions</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:FORMAT" value="ALL">
       <DESCRIPTION>Requested format of images</DESCRIPTION>
       <VALUES>
         <OPTION>image/fits</OPTION>
         <OPTION>image/gif</OPTION>
         <OPTION>text/html</OPTION>
         <OPTION>ALL</OPTION>
         <OPTION>GRAPHIC</OPTION>
         <OPTION>METADATA</OPTION>
       </VALUES>
     </PARAM>
     <PARAM name="INPUT:INTERSECT" value="OVERLAPS">
       <DESCRIPTION>Choice of overlap with requested region</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:VERB" value="1">
       <DESCRIPTION>Verbosity level, controlling the number of columns returned</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:telescope">
       <DESCRIPTION>Telescope name</DESCRIPTION>
     </PARAM>
     ...

```

--------------------------------

### Example VOEvent Publisher IVORN

Source: https://www.ivoa.net/Documents/PR/VOE/VOEvent-20060629.html

An example of a VOEvent Publisher IVORN that can be looked up in a VO registry to get publisher details.

```text
ivo://nvo.caltech/VOEventPublisher
```

--------------------------------

### Example VOEvent Packet Start

Source: https://www.ivoa.net/Documents/PR/VOE/VOEvent-20060629.html

An example of how a VOEvent packet might begin, including essential attributes like ivorn, role, and version.

```xml
<VOEvent ivorn="ivo://uraniborg.hven#1572-11-11/0001" 
        role="observation" version="1.1" xmlns:... >


```

--------------------------------

### Metadata Query Example: Input Parameter Listing

Source: https://www.ivoa.net/Documents/PR/DAL/PR-SIA-1.0-20090521.html

An example of how a Pointed Image Archive service lists its supported input parameters using PARAM elements within a RESOURCE.

```xml
<RESOURCE type="results">
     <DESCRIPTION>ADIL Simple Image Access Service</DESCRIPTION>
     <INFO name="QUERY_STATUS" value="OK"/>
     <PARAM name="INPUT:POS" value="0,0" datatype="double">
       <DESCRIPTION>Search Position in the form "ra,dec" where
                    ra and dec are given in decimal degrees in the ICRS
		    coordinate system.</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:SIZE" value="0.05"  datatype="double">
       <DESCRIPTION>Size of search region in the RA and Dec. directions</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:FORMAT" value="ALL" datatype="char" arraysize="*">
       <DESCRIPTION>Requested format of images</DESCRIPTION>
       <VALUES>
         <OPTION value="image/fits"/>
         <OPTION value="image/gif"/>
         <OPTION value="text/html"/>
         <OPTION value="ALL"/>
         <OPTION value="GRAPHIC"/>
         <OPTION value="METADATA"/>
       </VALUES>
     </PARAM>
     <PARAM name="INPUT:INTERSECT" value="OVERLAPS" datatype="char" arraysize="*">
       <DESCRIPTION>Choice of overlap with requested region</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:VERB" value="1" datatype="int">
       <DESCRIPTION>Verbosity level, controlling the number of columns returned</DESCRIPTION>
     </PARAM>
     <PARAM name="INPUT:telescope" datatype="char" arraysize="*" value="HST">
       <DESCRIPTION>Telescope name</DESCRIPTION>
     </PARAM>
     </RESOURCE>
     ...
```

--------------------------------

### Format List Example

Source: https://www.ivoa.net/Documents/PR/DAL/PR-SIA-1.0-20090521.html

An example of a FORMAT parameter list specifying multiple desired image formats.

```text
image/fits,text/html,GRAPHIC-jpeg,png
```

--------------------------------

### VOTable XML Example

Source: https://www.ivoa.net/Documents/Notes/VOTableSTC/NOTE-VOTableSTC-1.1-20090612.html

An example of a VOTable document listing three astronomical observations, including celestial coordinates, observation start time, and exposure time, with STC-related attributes.

```xml
<?xml version="1.0"?>
<VOTABLE version="1.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:stc="http://www.ivoa.net/xml/STC/stc-v1.30.xsd"
 xmlns="http://www.ivoa.net/xml/VOTable/v1.2">

  <RESOURCE name="myObservations">
    <TABLE name="results">
      <DESCRIPTION>Observation log</DESCRIPTION>
      <PARAM name="Telescope" datatype="float" ucd="phys.size;instr.tel"
             unit="m" value="3.6"/>
      <GROUP ID="Coo1" utype="stc:AstroCoords" >
        <PARAM name="cooframe" datatype="char" arraysize="*" ucd="pos.frame"
               utype="stc:AstroCoords.coord_system_id"
               value="UTC-ICRS-TOPO" /> <!-- UTC-ICRS-TOPO defined in STC-Lib -->
        <FIELDref ref="ObsStart" /> <!-- second referencing, optional -->
        <FIELDref ref="RAJ2000"/>   <!-- second referencing, optional -->
        <FIELDref ref="DEJ2000"/>   <!-- second referencing, optional -->
      </GROUP>
      <FIELD name="RAJ2000" ucd="pos.eq.ra;meta.main" ref="Coo1"
             ID="RAJ2000" utype="stc:AstroCoords.Position2D.Value2.C1"
             datatype="float" precision="4" unit="deg" />
      <FIELD name="DEJ2000" ucd="pos.eq.dec;meta.main" ref="Coo1"
             ID="DEJ2000" utype="stc:AstroCoords.Position2D.Value2.C2"
             datatype="float" precision="4" unit="deg" />
      <FIELD name="ObsStart" ucd="time.start;obs" datatype="char" xtype="iso8601"
             arraysize="19" unit="s" ID="ObsStart" ref="Coo1"
             utype="stc:AstroCoords.Time.TimeInstant.ISOTime" />
      <FIELD name="ExpTime" ucd="time.duration;obs.exposure"
             datatype="float" width="6" precision="1" unit="s"/>
      <DATA>
        <TABLEDATA>
        <TR>
          <TD>035.0798</TD><TD>-05.2336</TD><TD>2005-11-01T12:00:55</TD><TD>1200</TD>
        </TR>
        <TR>
          <TD>035.0547</TD><TD>-05.2253</TD><TD>2005-11-01T12:25:20</TD><TD>600</TD>
        </TR>
        <TR>
          <TD>035.0463</TD><TD>-05.2503</TD><TD>2005-11-01T12:36:20</TD><TD>600</TD>
        </TR>
        </TABLEDATA>
      </DATA>
    </TABLE>
  </RESOURCE>
</VOTABLE>

```

--------------------------------

### Full Query Example

Source: https://www.ivoa.net/Documents/PR/DAL/PR-SIA-1.0-20090521.html

An example of a complete query URL formed by concatenating the base URL and constraint list.

```text
http://myimages.org/cgi-bin/VOimq?POS=180.567,-30.45&SIZE=0.0125 
```

--------------------------------

### Example Messages

Source: https://www.ivoa.net/Documents/Notes/Plastic/PlasticDesktopInterop-20060601.html

A list of other Plastic messages currently in use, including their arguments, return values, and descriptions.

```text
Message ID |  Args |  Returns |  Description  
---|---|---|---
ivo://votech.org/votable/loadFromURL  |  url: String, id: String |  success: Boolean |  Load a VOTable from the supplied URL.   
ivo://votech.org/votable/showObjects |  id: String , rows: int[] |  success: Boolean |  Highlight/select the selected VOTable objects in the table with that id.   
ivo://votech.org/fits/image/loadFromURL  |  url : String, id: String |  success: Boolean |  Load a FITS image from the supplied URL.  
```

--------------------------------

### Resolving a UType URI with curl

Source: https://www.ivoa.net/Documents/Notes/UTypes/utype-uri-20070302.html

Example of using curl to resolve an unknown UType URI and get its superclass.

```bash
% curl http://localhost/superclasses?http://example.org/utypes/1.0%23sharpBounds
http://www.ivoa.net/ut/characterization#coverage-bounds

```
Tokens:
Raw