Science Archive
Programmatic and Tools AccessDemo page

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

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:

Click on a tab to see its contents here.

SUBSTITUTE_ASYNC

Scripted access to the archive

2018-07-02:	The eso_ssa.py 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 eso_raw.py 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 eso_download_raw_and_calibs.py 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 eso_authenticated_download_raw_and_calibs.py 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

• Download the
  • latest version of TOPCAT (standalone JAR file)
• Run it (change the memory parameters according to your RAM):
  • java -Xmx2048m -Xms512m -jar topcat-full.jar
• In the TOPCAT main window:

  1.-		Click the "select from" icon in the main TOPCAT window >> The Table Access Protocol (TAP) Query panel opens up.
  2.-	Keywords: eso.org	Within the Select Service tab, filter the list of TAP services typing eso.org in the "Keywords" input field, and hit the return key. >> Only the ESO entries remain displayed
  3.-	ESO TAP_CAT ESO TAP_OBS	Click either on the ESO TAP_CAT if you want to query the ESO catalogs, or on the ESO TAP_OBS if you want to query the ESO raw, reduced, and ambient data.
  4.-	Use Service	Click the "Use service" button at the bottom right; >> The TAP search interface for the selected TAP service shows up.
  5.-	Examples	Click the "Examples" button at the bottom left, therein you can choose various query examples, which you can use as TMPL for your own queries.

 Activating Datalink within TOPCAT

• If the query result set contains a column pointing to the ESO datalink service (http://archive.eso.org/datalink/links/...), it is best if you activate the datalink option within TOPCAT.

  1.-		Click the table-lightening icon in the main TOPCAT panel >> Activation Actions panel shows up
  2.-	+	Click the green plus-sign button >> pulldown menu shows up
  3.-	View Datalink Table	Select the "View Datalink Table" from the opened pulldown menu >> the access_url field should now be associated with the View Datalink Table action.
  After that, go back to the table of results; when clicking on any access_url field: a new table opens up, with the results of the datalink query, showing you the access point(s) to the main science file (#this) and to other related files (preview, ancillary, progenitors), and even to derivations (other products generated from #this one) if they exist.

 Using ESO TAP from within Aladin

• Download Aladin Beta at:
  • http://aladin.u-strasbg.fr/java/AladinBeta.jar
• Run it (change the memory parameters according to your RAM):
  • java -Xmx2048m -Xms512m -jar AladinBeta.jar
• In Aladin, type:  eso.org  in the "select" input field at the bottom of the left panel (Collections), and hit return;
  >> the ESO services are shown in the left panel, including: ESO TAP_CAT, ESO TAP_OBS, and ESO SSAP (Simple Spectral Access Protocol).
• Click either on the ESO TAP_CAT if you want to query the ESO catalogs, on the ESO TAP_OBS if you want to query the ESO raw, reduced, and ambient data, or on the ESO SSAP to access specifically the ESO 1D reduced spectra.
• A pop up window opens, click on the "Load" button
  >> The Aladin TAP interface interfacing to the selected ESO TAP service shows up; here you can type in and execute your query.
• Place a valid query; for example, for the TAP_OBS service:
   select top 333 target_name, filter, s_ra, s_dec, s_region, access_format, access_url
   from ivoa.ObsCore
   where CONTAINS(POINT('',266.42,-29.0),s_region)=1 
   and dataproduct_type='image' and dataproduct_subtype='tile'
• In the Aladin stack, the entry  eso.org / tap_obs  should appear within seconds
• Type in the location the coordinates of your search:
  • 266 -29 to be brought to the right sky region.
• Right-click on the eso.org / tap_obs entry,
  • select Properties (at the bottom),
    • click on "Show all associated FoVs"