3. A First Query

To follow the examples, start TOPCAT and select TAP in the VO menu.

At Keywords type gavo. Wait until the results are filtered and select the entry “GAVO DC TAP”. Then click “Use Service”.

You already made use of the VOs Google-like service: the Registry. A rough introduction of the registry how you can use it for data discovery will be explained in chapter “Data Discovery”. In the query pane, enter:

SELECT TOP 1 1+1 AS result FROM ivoa.obscore

and then click “Ok”. This should give you a table with a single 2 in it. If that hasn’t worked complain.

Copying and Pasting from http://docs.g-vo.org/adql is legal.

Note that in the top part of the dialog there’s metadata on the tables exposed by the service (in particular, the names of the tables and the descriptions, units, etc., of the columns). Use that when you construct queries later.

There are other TAP clients than TOPCAT – after all, we’re talking about a standard protocol. Another TAP client widely used is Aladin.

You can also use an ipython notebook, and with a bit of creativity, you can even follow this course in this kind of interface. Attached to this page or pdf is a notebook showing some of the more common features.

Most of the queries here assume you’re querying against the server with the IVOA id


To get that, typing server ivo://org.g and then completing with Tab should be sufficient.

You can also use TAPHandle, which runs entirely in your browser.

For running a TAP client in scripts there is STILTS or PyVO

More TAP clients can be found on the IVOA applications page.


Markus Demleitner, Hendrik Heinl

Copyright Notice