ESO Science Archive - PYVO Scripts and Jupyter Notebooks

Note
Much of the functionality demonstrated in this repository is now available through the astroquery.eso module.
These examples are nevertheless maintained to showcase advanced or low-level use cases—particularly those that are not yet exposed via the high-level astroquery interfaces, or where direct TAP/SSA access provides additional flexibility.

---

Python Scripts (scripts/)

Standalone scripts illustrating direct interaction with ESO archive services using TAP, SSA, DataLink, and related protocols.

• lhatpro.py
  Query the asm.lhatpros_paranal_profiles table using a cone search combined with a time constraint.

• authenticated_download_raw_and_calibs.py
  Download raw science frames and associated calibration files using authenticated access, enabling retrieval of proprietary data when authorised.

• download_raw_and_calibs.py
  Query and download public (non-proprietary) raw science frames together with the calibration files required for data reduction, via the DataLink and calSelector services.

• query_raw_data.py
  Query and download raw science frames for a specified target.

• query_ssa.py
  Perform queries against the ESO Simple Spectral Access (SSA) service and retrieve spectra matching user-defined criteria (e.g. cone search, SNR thresholds).

---

Jupyter Notebooks (notebooks/)

End-to-end, executable notebooks demonstrating common archive workflows and serving as practical, interactive examples.

• programmatic_authentication_and_authorisation.ipynb

  • Token-based authentication
  • Authorised data searches
  • Authorised downloads
  • Retrieving calibration cascades for metadata-protected raw data

• query_reduced_data.ipynb

  • Search by identifier
  • Search by original file name
  • Spatial queries and cross-matches
  • Queries by wavelength

• download_data.ipynb

  • Anonymous downloads
  • Downloads using token authentication

• query_ancillary_files.ipynb

  • Finding all files associated with a given product
  • ESPRESSO ancillary files (measured radial velocities)
  • Retrieving ANCILLARY.PREVIEW files for the MUSE collection

• meteo_paranal_simple_query.ipynb

  • Listing available measurements in the Paranal meteo table
  • Querying measurements for a specified time interval
  • Plotting example statistics (e.g. relative humidity at different heights)

---

Additional examples will be added as archive services and the astroquery.eso interface continue to evolve.