Data Access Worksheet - Workbench
This is a step by step worksheet that demonstrates some ways to retrieve and visualise astronomical images, spectra and catalogue data using the AstroGrid workbench. As of 2008, the AstroGrid Desktop will give a better service, please see links from higher level help pages.
AstroGrid Data Access Worksheet
This is a step by step worksheet that demonstrates some ways to retrieve and visualise astronomical images, spectra and catalogue data using AstroGrid.
To access AstroGrid services, launch the Workbench.
Answer 'Yes' or 'Start' at security warnings.
1. AstroScope
Acquiring data
AstroScope is an AstroGrid tool that allows you to query archives of images, spectra and catalogue data around a given position or SIMBAD object, visualise the results and download data files either to your local machine or to your storage space on the Astrogrid system, called MySpace.
In the Workbench main panel, click on AstroScope. For example, enter the symbiotic star HM Sge as the Object and a
Region of 0.1 (if you have chosen decimal degrees as units). Select some data by
clicking to open up an entry and then double-clicking - e.g. a couple
of HST images, a radio catalogue and one each IUE and ISO spectra
Click on the Save icon, and log in to MySpace if prompted. Then select or create
a suitable subdirectory and click OK.
Right-click on any image to open it full-size in a new window.

You can check when the data have been downloaded by launching the MySpace browser from the workbench.
2. Visualising data
PLASTIC
directly links AstroGrid and data visualisation
and manipulation tools such as TopCat, Aladin, SPLAT, GAIA,
VOSpec and VisiVO. In most cases an external web link allows you to use
webstart and/or download and run the compatible version of the
application. You need to run the Workbench and the relevant
application(s) at the
same time for full interoperability. Alternatively, you can
download data to your desktop or copy URLs to any suitable
viewer. See the Helper Applications view of the Workbench for
links to PLASTIC-enabled applications. See also the Documentation page on Workbench: Helper Applications.

You are advised to start by selecting just one or a few images/tables/spectra in case any items selected are very bulky, to get a feel for data transport speeds over your connection.
Images
These can be dispalyed in GAIA or in the Prototype version of Aladin, which is available for download or webstart. The Aladin logo will
then appear in AstroScope. If you click on the icon any selected
images will be automatically loaded. You can also use the Aladin LOAD
window to get data already saved in MySpace.
SPLAT and VOSpec are available. For example, after starting VOSpec and selecting a few spectra, click on the icon in AstroScope and the spectra will be displayed. You can do some basic manipulations such as change units, fit a black body, and save the spectra to your local disc.
IUE and ISO spectra displayed in VOSpec ovelaid with images created in Aladin after using the MERLIN Imager.
Tables
Virtual observatories and many other applications exchange tabular
data in
VOTable format.
This can include lists of images with their URLs or simple spectra as
well as lists of e.g. sources and properties. Aladin and VOSpec,
described above, use VOTables and TopCat is a dedicated tool
which lets you browse and plot tables, add new columns (including
coordinate conversions) and exchange data with Aladin and any other
tool which can see MySpace. The latest
version can be downloaded and started using
java -jar topcat-full.jar
and automatically registers itself with Plastic if you have the
Workbench running
You can then load tables from MySpace by clicking on
FileWarning: at present, it is slow to open and navigate in MySpace but this does not affect loading the data once it has been located.
Load Table
Filestore Browser
Location MySpace
Log in

If you view the same table in Aladin and TopCat, a source selected in one application will be highlighted in the other.
More detailed data selection
Using the Task Launcher
Multiple selection criteria
The Astronomers' Data Query Language (ADQL) lets you select the columns you want within chosen ranges. If you select the Task Launcher from the workbench, you can search for a data set, e.g. "FIRST and object and catalogue" (Faint Images if the Radio Sky at Twentyone cm, see Resource Browser help). If you get back a service which supports ADQL, you can build a query constraining any parameters in the catalogue. Click the tick-box on the left and a Query Builder box will appear. You can use the GUI Tree or enter SQL directly under the Adql/s tab. The following is an example:
which is then expanded into the Tree and also translated into Adql/x for sending to the data centre.
SELECT * FROM catalogue AS T1 WHERE
T1.POS_EQ_RA > 186 AND T1.POS_EQ_RA < 188
AND T1.POS_EQ_DEC > 1 AND T1.POS_EQ_DEC < 3
AND T1.EXTENSION_FWHM_MAJ > 0.0

Once you have finished the query using the Parameter button to select the file you want to save the results in in MySpace. Finally, click the green button to launch the query. You should be able to monitor progress in the Lookout and view the results e.g. in TopCat or Aladin.
Cone Search and Simple Image/Spectral Access
You may see one of these services offered for your chosen dataset. The simplest type of query takes a position and a search radius and returns all the catalogue objects within that radius, or the images or spectra with reference positions inside the radius. This is the way that AstroScope works. Some Simple Image Access Protocol (SIAP) services also recognise any overlap with the field of view and other constraints. If you select a data set offering Cone or SIAP/SSAP access, a box will pop up asking for the position and radius (J2000, decimal degrees). You also need to use the Parameter button (see above) if you want to save the results to MySpace. SIAP will return a VOTable of the URLs of images and a brief description.
On-the-Fly data extraction
Some data centres offer custom-made data products. For example,
the MERLIN Imager produces an image to your specifications (or the
nearest possible values of size and resolution) from radio
interferometry data. Search for "MERLIN" in the Task Launcher. Fill in either the position or the object name
and, optionally, other criteria, and the destination of the Output.
At present only MERLIN names are recognised but you can check what
sources have been observed by browsing the MERLIN
Processed Data archive

If there are data anywhere within the field of view of an observation
which match your criteria, the five best images will be made and
supplied via a SIAP-like VOTable which can be loaded into Aladin or
browsed with TopCat. The service uses ParselTongue, a python-based
scripting language developed by RadioNet. It
will be developed to link with SIMBAD, and
other data products (e.g. spectra, time series) could be extracted in
a simlar fashion from visibility data, X-ray event series etc.

Using the Workflow Builder
Queries available through the Task Launcher can also be inserted in a workflow using the Workflow Builder launched from the Workbench. If you insert a Step into a workflow, the Task Editor will then let you select a queryable dataset and build a query in the same way.
Colour Cutter
This Ready-made Workflow is launched from the workbench. The ColourCutter
allows selection by position and magnitude difference from one
IR and one optical catalogue and cross-matches the sources in common.
Multiple cone search
The Cone Search ready-made workflow allows you to send a VOTable containing a list of positions as a query to a catalogue. This is useful if you have a short table of e.g. high-redshift objects or candidate proto-planetary nebulae scattered all over the sky, and you want to find counterparts in a catalogue which is too big to download e.g. SDSS.
Author: A M S Richards, amsr@jb.man.ac.uk
Last revised : 2 April 2006