ESO Logo

Science Archive
Programmatic and Tools Access
Demo page

The purpose of this page is to help you to learn:
  1. how to compose URLs to interact with the different ESO science archive services, either programmatically or via tools;
  2. how to construct queries to interrogate the various database tables of the ESO science archive, using ADQL and TAP;
  3. how to put it all together and script your access to the ESO science archive, using the pyvo python module.
If some terms in this page are not familiar to you, please read the overview page first.

In this page:

This page is organised in 7 tabs. You'll have to click on a tab to see its content.

Implemented IVOA Standards: ADQL 2.0 DataLink v1.0 ObsCore v1.1 SSAP v1.1 TAP v1.0
UWS v1.1 DALI v1.1 2017-05-17
Software: taplib implements: ADQL, TAP, and UWS; by Grégory Mantelet (ARI - Astronomisches Rechen Institut, Heidelberg)
SSAPServer implements SSAP v1.1; by Vincenzo Forchì (ESO)
ESO code (not distributed) implements DataLink, ObsCore; by DFI/ESO

Last modification date of IVOA standards & ESO software: 2018-07-02

Actions for a given dataset ID:  
  • Retrieve its metadata record (VO standard services)
  • or get its     (ESO specific services)
  • Show URL only:
    Integration server: Operational server:

To change the ID in the input box above, you can either manually type therein an ID,
or click on one of the IDs here below (clicking on them sets the ID);
then, click on the service you want to activate.
Sample list of (clickable) IDs:

ADP.2011-06-24T14:55:29.867 (VVV filter=Ks tile image)
ADP.2011-06-24T14:55:29.100 (VVV filter=Z tile image)
ADP.2014-12-22T15:00:36.163 (VHS VIRCAM filter=Y pawprint image)
ADP.2016-07-18T09:00:02.473 (HAWKI filter=BrG tile image)
ADP.2016-07-20T09:16:48.344 (HAWKI filter=BrG pawprint image)
ADP.2013-08-19T15:03:41.750 (VPhas+ OMEGACAM filter=NB_659 pawprint image)
ADP.2013-07-04T15:07:12.747 (KIDS OMEGACAM filter=g_SDSS tile image)
ADP.2014-10-01T10:19:21.580 (HARPS spectrum product)
ADP.2015-04-17T12:15:34.457 (XSHOOTER spectrum of a GRB)
HARPS.2004-02-17T03:02:33.233 (HARPS spectrum raw)
ADP.2016-09-07T07:57:19.679 (catalogtile)
ADP.2016-06-01T14:07:30.134 (cube)
ADP.2015-04-13T10:13:41.080 (spectrum GIRAFFE)
ADP.2013-07-15T14:08:12.807 (catalog AMBRE)
ADP.2014-12-22T14:56:40.210 (srctbl VHS)
ADP.2016-03-17T08:31:54.133 (obsolete catalog)
ADP.2016-03-17T08:31:54.153 (obsolete srctbl)
Last modification date of Learn dataset actions: 2018-10-16
TAP Service: its list of jobs:  
Service type:  
FORMAT: votable text/xml votable/td votable/base64 votable/fits fits json csv tsv text html

Parsing results:

    Helper: Characteristics of standard filters Helper: Characteristics of ESO filters
    Last modification date of Query a TAP Service: 2018-07-02

    Click on a tab to see its contents here.



    Scripted access to the archive

    2018-07-02: The script illustrates how a python 3 script using the pyvo module can perform queries to the ESO Simple Spectral Access Protocol (SSAP), and retrive the spectra with a SNR grater than a certain threshold.
    2018-09-17: The script illustrates how to query and download raw science frames for a given object.
    2019-02-13: New version to reflect a change to the dbo.raw table.
    2019-11-25: The script illustrates how to query and download public (i.e. non-proprietary) raw science frames along with the files necessary to calibrate them (via the DataLink and calSelector services).
    2020-04-23: More python examples are available as Jupyter Notebooks at: ESO Science Archive Programmatic: HOWTOs
    2020-09-03: More python jupyter notebook examples are available in the ESO Archive Community Forum. Currently available:
     Access to Spectroscopic Data: Example #1
     Access to Catalogues: Example #1
     Access to Catalogues: Example #2
    2020-09-04: The script illustrates how to download science raw frames with authentication, allowing to download proprietary files if authorised.
    ... more examples to come...

    Last modification date of Script your access: 2020-09-04

    Configure VO tools

     Using ESO TAP from within TOPCAT

     Activating Datalink within TOPCAT

     Using ESO TAP from within Aladin

    Last modification date of Configure tools: 2018-07-02