| Science Archive |
In the Query a TAP service tab you can learn how to write and execute a query to the ESO databases. Queries must be written in the Astronomical Query Data Language (ADQL). To learn the ADQL syntax, a pulldown menu (Choose a query [...]) provides you some precooked query examples: you can modify them at will, validate them, and/or execute them. Queries can be issued either synchronously, or, for more complex and slower queries, they can be issued asynchronously. The link to the ESO TAP Query Manager is provided, to allow you to (learn how to) control the ESO asynchronous jobs.
Passband characteristics are provided to help formulating wavelength constraints to the ivoa.ObsCore table. Though, please note that the ESO ivoa.ObsCore table exposes some extra, non-standard, columns, as shown in the following table.
| column name | description |
|---|---|
| abmaglim | limiting magnitude, available only for images, source tables, and cubes |
| dp_id | ESO internal unique identifier of a dataset, useful to join with other tables |
| filter | name of the filter |
| gal_lat | galactic latitude |
| gal_lon | galactic longitude |
| n_obs | number of scientific frames used to generate the given product (NCOMBINE) |
| snr | signal-to-noise ratio available only for 1d spectra |
| multi_ob | either M or S. M for products result of combination of exposures from multiple telescope visits; S for a product result of combination of exposures taken during the same visit |
| obstech | technique of observation |
| p3orig | Either EDP or IDP, EDPs are products certified by the user community, IDPs by ESO |
| publication_date | time when the product has been made available (though it could still be under proprietary period) |
It is also possible to query some other TAP servers (provided in the TAP Service pulldown menu), in which case the query validator and the provided query examples are not guaranteed to work.
In the async Query Manager tab, you can (learn how to) control the asynchronous queries. From there you can change the execution duration of a job, set its destruction time, run it, abort it, and of course you can check at any time the status of the job; when the job is successfully completed, you can fetch the results.
The Script your access to the archive tab provides a python script to illustrate how to query the SSAP service and download high signal-to-noise spectra in a given region, using the pyvo module.
In the Configure VO tools tab, you can learn how to configure some VO-aware tools like TOPCAT and ALADIN to make use of the new ESO services. In a second stage, when the ESO VO interfaces will have been registered in the EUROVO registry, the tools will be already aware of the ESO interaces; at that point this section will be removed.
In the Learn dataset actions tab you can learn how to interact with the ESO Science Archive at the level of an individual dataset, recognised by its unique identifier (ID). Once you provide an ID, by clicking on the provided buttons you can get to its preview, metadata (obscore), or download its main science file and/or its associated files (datalink), etc. With the checkbox Show URL only activated, the action's URL is only displayed, and not actually retrieved, so to allow you to learn how you can construct the various service URLs for consumption via scripts or via tools.
The IVOA standards and software tab lists the standards and the software suites onto which the ESO programmatic and tool access is based. Links to the standards are provided. Links to the software libraries available on github are provided.
The Change Log tab lists all the changes to the programmatic and tool interfaces that could affect your scripts or anyway your way of accessing the ESO science archive via TAP, SSAP, or via one of the URLs specified in the Learn dataset actions. Keep an eye on it, to make sure to be up-to-date with this newly born and still evolving functionality of the ESO Science Archive.
| Implemented IVOA Standards: | ADQL 2.0 | DataLink v1.0 | ObsCore v1.1 | SSAP v1.1 |
TAP v1.1 |
UWS v1.1 | DALI v1.1 2017-05-17 | SODA v1.0 |
|---|---|---|---|---|---|---|---|---|
| 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, SODA; by DFI/ESO | ||||||||
Last modification date of IVOA standards & ESO software: 2021-11-22
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.2020-03-02T15:35:28.594 (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) |
| Helper: Characteristics of standard filters | Helper: Characteristics of ESO filters |
Click on a tab to see its contents here.
SUBSTITUTE_ASYNC