CINXE.COM

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html> <head><script type="text/javascript" src="https://web-static.archive.org/_static/js/bundle-playback.js?v=7YQSqjSh" charset="utf-8"></script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/wombat.js?v=txqj7nKC" charset="utf-8"></script> <script>window.RufflePlayer=window.RufflePlayer||{};window.RufflePlayer.config={"autoplay":"on","unmuteOverlay":"hidden"};</script> <script type="text/javascript" src="https://web-static.archive.org/_static/js/ruffle/ruffle.js"></script> <script type="text/javascript"> __wm.init("https://web.archive.org/web"); __wm.wombat("https://archive.eso.org/cms/eso-data/programmatic-access.html","20220618003211","https://web.archive.org/","web","https://web-static.archive.org/_static/", "1655512331"); </script> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/banner-styles.css?v=p7PEIJWi" /> <link rel="stylesheet" type="text/css" href="https://web-static.archive.org/_static/css/iconochive.css?v=3PDvdIFv" />  <meta http-equiv="X-UA-Compatible" content="IE=7"/><meta http-equiv="content-type" content="text/html; charset=UTF-8"/> <meta http-equiv="pragma" content="no-cache"/> <meta http-equiv="Reply-to" content="webteam@eso.org"/> <meta name="robots" content="index,follow"/> <meta name="description" content="ESO is the European Organisation for Astronomical Research in the Southern Hemisphere. It operates the La Silla Paranal Observatory in Chile and has its headquarters in Garching, near Munich, Germany."/> <meta name="MSSmartTagsPreventParsing" content="TRUE"/> <meta name="author" content="webteam@eso.org"/> <meta name="page-topic" content="Astronomy"/> <meta name="page-type" content="Research Organisation"/> <meta name="organisation" content="ESO, European Organisation for Astronomical Research in the Southern Hemisphere"/> <meta name="Content-Language" content="en"/> <meta name="Language" content="en"/> <meta name="publisher" content="ESO"/> <meta name="copyright" content="1999-2008 ESO"/> <meta name="revisit-after" content="1 day"/> <meta name="keywords" content="ESO, eso.org, Astronomy, Astrophysics, Astronomie, Suedsternwarte, telescopes, detectors, comets, planets, stars, galaxies, nebulae, universe, NTT, VLT, VLTI, ALMA, E-ELT, La Silla, Paranal, Garching, Chile"/> <title>ESO - Programmatic Access</title> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/designs/eso/resources/functions.js"></script> <link href="/web/20220618003211cs_/https://archive.eso.org/etc/designs/eso/resources/layout_eso_2007.css" rel="stylesheet" type="text/css"> <link href="https://web.archive.org/web/20220618003211/https://www.eso.org/fcc/news.xml" rel="alternate" type="application/rss+xml" title="ESO Top News"/> <link href="https://web.archive.org/web/20220618003211/https://www.eso.org/fcc/announcements.xml" rel="alternate" type="application/rss+xml" title="ESO Announcements"/> <link href="https://web.archive.org/web/20220618003211/https://feeds.feedburner.com/ESOcast" rel="alternate" type="application/rss+xml" title="ESOCast"/> <link href="https://web.archive.org/web/20220618003211/https://recruitment.eso.org/jobs.rss" rel="alternate" type="application/rss+xml" title="Jobs@ESO"/> <link href="/web/20220618003211cs_/https://archive.eso.org/etc/designs/eso/static.css" rel="stylesheet" type="text/css"> <link href="/web/20220618003211cs_/https://archive.eso.org/etc/designs/eso.css" rel="stylesheet" type="text/css">   <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/granite/jquery.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/granite/utils.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/granite/jquery/granite.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/foundation/jquery.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/eso/modernizr.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/eso/jquerycommon.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/eso/jquery.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/eso/json2.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/clientlibs/eso/jsonpath.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/designs/eso/resources/swfobject.js"></script> <script type="text/javascript" src="/web/20220618003211js_/https://archive.eso.org/etc/designs/eso/resources/flash.js"></script> <script type="text/javascript"> var attribWithoutAll="location=no,menubar=no,toolbar=no,status=no"; attribWithoutAll+=",resizable=no,scrollbars=no,width=1000,height=750"; var subwindow=0; var firstTeaserID=""; function ClosePopUp() { if (!subwindow) return; if (subwindow.closed) return; subwindow.close(); } function PopUpWithoutAll() { ClosePopUp() subwindow=window.open("outreach\/bond\/","popup",attribWithoutAll); subwindow.moveTo(10,50); } function PopUpWithoutAll2() { ClosePopUp() subwindow=window.open("outreach\/bond\/\Flash007\/","popup",attribWithoutAll); subwindow.moveTo(10,50); } function getCookie(c_name) { var i,x,y,ARRcookies=document.cookie.split(";"); for (i=0;i<ARRcookies.length;i++) { x=ARRcookies[i].substr(0,ARRcookies[i].indexOf("=")); y=ARRcookies[i].substr(ARRcookies[i].indexOf("=")+1); x=x.replace(/^\s+|\s+$/g,""); if (x==c_name) { return unescape(y); } } } function redirectToInstrumentSelectorFromCookie(currentPageName) { var instrumentSelector=getCookie("eso-phase2-instrument-selector"); if (instrumentSelector != null && instrumentSelector != "") { location.href = currentPageName + "." + instrumentSelector + ".html"; } } var sPath = window.location.pathname; if (sPath.indexOf("/sci/observing/phase2") != -1) { var sPage = sPath.substring(sPath.lastIndexOf('/') + 1); var sPageName = sPage.substring(0, sPage.indexOf('.')); var selectors = sPage.substring(sPageName.length, sPage.lastIndexOf('.')); if (selectors.length == 0) { redirectToInstrumentSelectorFromCookie(sPageName); } } </script> </head> <body> <div id="headerbg"> <div id="headerbg_inner1"> </div> <div id="headerbg_inner2"> </div> </div> <div id="page_margins"> <div id="page" class="hold_floats"> <div class="header"> <div id="header"> <div id="eso_header"> <table width="100%"> <tbody> <tr> <td class="esologo"><a href="/web/20220618003211/https://archive.eso.org/public.html" title="ESO"> <img src="/web/20220618003211im_/https://archive.eso.org/i/esologo.png" width="61" height="80" alt="European Southern Observatory"></a></td> <td class="esologotext" width="120" valign="top"><br><p>European<br>Southern<br>Observatory<br></p></td> <td class="headcenter"></td> <td class="headright"> <div class="pagetitle"> <h1></h1> <div id="slogan"> <h2>ESO — Reaching New Heights in Astronomy</h2> <div id="flags"> <a href="/web/20220618003211/https://archive.eso.org/public/austria/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/austria.gif" title="Austria" alt="Austria" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/belgium/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/belgium.gif" title="Belgium" alt="Belgium" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/czechrepublic/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/czechrepublic.gif" title="Czech Republic" alt="Czech Republic" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/denmark/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/denmark.gif" title="Denmark" alt="Denmark" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/finland/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/finland.gif" title="Finland" alt="Finland" border="0" width="26" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/france/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/france.gif" title="France" alt="France" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/germany/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/germany.gif" title="Germany" alt="Germany" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/ireland/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/ireland.gif" title="Ireland" alt="Ireland" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/italy/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/italy.gif" title="Italy" alt="Italy" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/netherlands/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/netherlands.gif" title="Netherlands" alt="Netherlands" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/poland/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/poland.gif" title="Poland" alt="Poland" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/portugal/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/portugal.gif" title="Portugal" alt="Portugal" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/spain/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/spain.gif" title="Spain" alt="Spain" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/sweden/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sweden.gif" title="Sweden" alt="Sweden" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/switzerland/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/switzerland.gif" title="Switzerland" alt="Switzerland" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep1.gif" width="4"/><a href="/web/20220618003211/https://archive.eso.org/public/unitedkingdom/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/unitedkingdom.gif" title="UK" alt="UK" border="0" width="24" height="16"/></a> <img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/sep2.gif" width="20"/><a href="/web/20220618003211/https://archive.eso.org/public/chile/?lang"><img class="nopadding" src="/web/20220618003211im_/https://archive.eso.org/i/chile.gif" title="Chile" alt="Chile" border="0" width="24" height="16"/></a> </div> </div> </div> </td> </tr> </tbody> </table> </div> </div>  </div> <div class="topnav"> <script> $(document).ready(function() { $('#logout').click(function() { //Use JQuery AJAX request to post data to the ESO Logout Servlet $.ajax({ type: 'POST', url:'/cms/eso-data/programmatic-access.esologout.html', data:'', success: function(data){ setTimeout(function(){ location.reload(); }, 1000); } }); }); }); // end ready </script>  <form action="/web/20220618003211/https://archive.eso.org/cms/search.html" id="cse-search-box" method="get" name="search_top" class="search"> <div id="nav">  <div id="nav_main"> <ul> <li id="first"> </li> <li><a href="/web/20220618003211/https://archive.eso.org/public.html" title="Public">Public</a></li> <li class="topnavSelected"><a href="/web/20220618003211/https://archive.eso.org/sci.html" title="Science">Science</a></li> <li><a href="https://web.archive.org/web/20220618003211/https://www.eso.org/UserPortal/">User Portal</a></li> <li><a href="/web/20220618003211/https://archive.eso.org/intra.html" title="Intranet">Intranet</a></li> </ul> <ul class="topnav_right"> <li><a href="/web/20220618003211/https://archive.eso.org/sci/contacts.html" title="Contact">Contact</a></li> <li><a href="/web/20220618003211/https://archive.eso.org/public/sitemap.html" title="Site Map">Site Map</a></li> <li class="search">  <input type="text" name="q" size="18" id="query" value="Search" onfocus="javascript:clearField('query','Search');" onblur="javascript:setField('query','Search');"/> </li> <li class="go">  <button type="submit" value="Go!" class="subm" name="searchthis">Go!</button> </li> </ul> </div> </div> </form>  </div> <div class="breadcrumb">  <div id="bread"> <div id="navpager"> <a href="/web/20220618003211/https://archive.eso.org/sci.html">Science Users Information</a>  >  <a href="/web/20220618003211/https://archive.eso.org/cms.html">Science Archive Facility</a>  >  <a href="/web/20220618003211/https://archive.eso.org/cms/eso-data.html">ESO Data</a>  >  <a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/programmatic-access.html">Programmatic Access</a> </div> <div id="navdate"> <a href="https://web.archive.org/web/20220618003211/https://www.eso.org/public/events/special-evt/" title="Calendar"> 18 Jun 2022</a></div> </div>  </div> <a class="skip" href="#navigation" title="jump to navigation">jump to navigation</a> <a class="skip" href="#content" title="jump to content ">jump to content</a><div id="outer_wrapper">  <div id="main">  <div id="col1"> <div id="col1_content" class="clearfix"> <div class="leftnavi navigation">  <div class="smenu"><a id="navigation" name="navigation"></a> <ul id="leftmenu"> <li class="title"><a href="/web/20220618003211/https://archive.eso.org/cms.html">Science Archive Facility</a></li> <li> <ul id="leftnav"> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/data-portal.html">Data Portal</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.eso.org/sso/login?service=https%3A%2F%2Fwww.eso.org%3A443%2FUserPortal%2FauthenticatedArea%2Fwelcome2.eso">User Portal Login</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.eso.org/sso/login?service=https%3A%2F%2Fwww.eso.org%2Face">Data Access Control</a></li> </ul> </li> <li class="curr0s"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data.html">ESO Data</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/eso/eso_archive_main.html">Raw Data Query Form</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/instrument-specific-query-forms.html">Instrument Specific Query Forms</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/eso-data-products.html">Data Products</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/eso-data-direct-retrieval.html">Data Direct Retrieval</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.eso.org/qi">ESO Catalogue Facility</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/wdb/wdb/eso/sched_rep_arc/form">Observing Schedule</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/ambient-conditions.html">Ambient Conditions Database</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://telbib.eso.org/">User Publications</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/data-packages.html">Data Packages</a></li> <li class="curr1"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/programmatic-access.html">Programmatic Access</a><ul class="sub2"> <li class="std2"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data/programmatic-access/authentication-and-authorisation.html">Authentication & Authorisation</a></li> </ul> </li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/scienceportal/">Science Portal</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/hubble-space-telescope-data.html">Hubble Space Telescope Data</a></li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/virtual-observatory-tools.html">Virtual Observatory Tools</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://www.euro-vo.org/pub/fc/software.html">EURO-VO Applications page</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/cgi-bin/twiki/bin/view/IVOA/IvoaApplications">IVOA Applications Page</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/catalogs-dss.html">Catalogues, Plates and DSS</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/dss/dss">Digitized Sky Survey</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/skycat/servers/usnoa">The USNO A2.0 Catalogue</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/gsc/gsc2">The Guide Star Catalogue v2.2</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://www.ipac.caltech.edu/2mass/">The 2MASS Catalogue</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/skycat/servers/ASTROM">Astrometric Catalogues</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://esoads.eso.org/">ESO ADS Abstract Mirror</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/wdb/wdb/eso/eso_schmidt/form">ESO Schmidt Plates</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/wdb/wdb/eso/eso_clichotheque/form">Special Plates</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/tools-documentation.html">Tools and Documentation</a><ul class="sub1"> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/tools-documentation/eso-data-interface-control.html">ESO Data Interface Control</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/tools-documentation/jsky.html">The JSky Intiative</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/cms/tools-documentation/the-eso-st-ecf-digitized-sky-survey-application.html">The ESO DSS Batch Tool</a></li> <li class="std1"><a href="/web/20220618003211/https://archive.eso.org/sci/observing/tools/skycat">The ESO SkyCat Tool</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/related-external-services.html">Related External Services</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://vizier.u-strasbg.fr/">VizieR Catalogues (CDS)</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.cadc-ccda.hia-iha.nrc-cnrc.gc.ca/en/cfht/">CFHT Catalogues (CADC)</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.cadc-ccda.hia-iha.nrc-cnrc.gc.ca/en/jcmt/">JCMT Catalogues (CADC)</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.cadc-ccda.hia-iha.nrc-cnrc.gc.ca/en/gemini/">GEMINI Archive (CADC)</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://www.cadc-ccda.hia-iha.nrc-cnrc.gc.ca/en/hst/">HST Archive (CADC)</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://simbad.u-strasbg.fr/simbad/">Simbad Databases</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://aladin.u-strasbg.fr/">Aladin Sky Atlas</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/https://esoads.eso.org/">ESO ADS Abstract Mirror</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-hst-image-galleries.html">ESO & HST Image Galleries</a><ul class="sub1"> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://www.eso.org/public/images/">ESO Photo Gallery</a></li> <li class="std1"><a href="https://web.archive.org/web/20220618003211/http://www.spacetelescope.org/images/">HEIC Hubble Gallery</a></li> </ul> </li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-archive-news.html">News and Updates</a></li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/faq.html">FAQ</a></li> <li class="std0"><a href="/web/20220618003211/https://archive.eso.org/cms/eso-data-access-policy.html">ESO Data Access Policy</a></li> </ul> </li> </ul> <div id="welcomenoticeshort"><h3>Warning!!</h3> <p>We have recently uncovered a bug in the delivery software that started to be in use as of February 2020, which led to the possibility that the incorrect copy of 561 files have been downloaded. Please check <a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/cms/eso-data/bad-copies-of-archived-files-possibly-downloaded.html">here</a>.</p> </div></div> </div> </div>  </div>  <a id="content" name="content"></a> <div id="col3"> <div id="col3_content" class="clearfix"> <div class="subcolumns"> <div class="par parsys"><div class="title section"> <h1>Programmatic Access</h1> </div> <div class="textbox parbase section"> <div class="box1"> <h3><b>Overview</b></h3> <div class="richtext text parbase"> <link rel="stylesheet" href="/web/20220618003211cs_/https://archive.eso.org/etc/clientlibs/wcm/foundation/accessibility.css" type="text/css"/> <p>Users can gain programmatic and tool access to the archive science portal utilising the standard interfaces provided by the International Virtual Observatory Alliance protocols described here below.  </p> <table style="width: 60.0%; margin-left: auto; margin-right: auto; background-color: orange;"> <tbody><tr><td><div style="padding: 0.0px 10.0px;"><h1>News</h1> Since <b>August 2021</b>, the following new features are available:</div> <ul> <li><b>Authorised TAP queries</b> (via token authentication) allow to search through observations with private metadata: <b>useful only to users who have been granted specific permissions, </b>for example to instrument and operation teams, or to PIs of confidential observing programmes (or their delagates); <b>not useful to PIs of regular programmes</b>, nor to normal archive users (<i>tap_obs</i> service)</li> <li><b>Authorised DataLink access</b> (via token authentication) allows to find data files (e.g. calibration files) related to an observation whose metadata are private.</li> <li>To know more, visit the new <a adhocenable="false" href="/web/20220618003211/https://archive.eso.org/cms/eso-data/programmatic-access/authentication-and-authorisation.html"><b>Authentication & Authorisation</b></a> documentation page and from therein the related <b>python jupyter notebook</b>.<br> </li> <li><b>New columns</b> added to the tables of reduced data (<i>ivoa.ObsCore</i>); for details <a adhocenable="false" href="https://web.archive.org/web/20220618003211/http://archive.eso.org/programmatic/changelog.html#2021-07-19">check the change log page</a>.</li> <li><b>Ability to search for products whose metadata have changed (curation)</b> using the new <i>last_mod_date</i> column (<i>ivoa.ObsCore</i> table of the <i>tap_obs</i> service, while <i>dbo.raw</i> already supported this)<br> </li> </ul> <div style="padding: 0.0px 10.0px;">Since <b>April 2020</b>, the following new features are available:<br> Content:<ul> <li><b>support for ALMA data </b>within the same ivoa.ObsCore table that already hosts Paranal La Silla and APEX data, for an integrated data discovery experience via the Tabular Access Protocol (tap_obs service)</li> </ul> Functionality:<ul> <li><b>authenticated access to proprietary (and other) data</b>:<ul> <li>authentication via token (<b>OAuth2.0</b>, JSON Web Token)</li> <li>basic authentication</li> </ul> </li> <li><b>positional and spectral cutout</b> of science data products and their ancillary files<ul> <li>via the IVOA <i>Server-side Operations for Data Access</i> (<b>SODA</b>) standard</li> </ul> </li> <li><b>datalink: support for proprietary data</b></li> <li><b>datalink: support for SODA</b> (cutout)</li> </ul> Documentation:<ul> <li>A (growing) collection of HOWTOs, in form of <b>jupiter notebooks</b>, is available to illustrate the ESO programmatic interfaces.</li> </ul> Older but related news:<ul> <li>Since November 2019, the <b>datalink service supports calSelector</b> to associate calibrations to raw frames.</li> </ul> <p><a style="float: right;" href="https://web.archive.org/web/20220618003211/http://archive.eso.org/programmatic/changelog.html">Read more...</a></p> </div> </td> </tr></tbody></table> <p> </p> <p>The <b><i>Table Access Protocol (TAP)</i></b> is a web-service protocol that gives access to tabular data. The tables made accessible via TAP are stored in relational database management systems. A TAP service opens and exposes the database to client applications so that queries can be posed directly against the avaialble tables. Queries to the ESO TAP services are formulated using the Astronomical Data Query Language ADQL <a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/documents/TAP/20180416/PR-TAP-1.1-20180416.html#std:ADQL">(Ortiz and Lusted et al., 2008, IVOA Recommendation)</a> and may execute synchronously or asynchronously. Query results are normally returned as a VOTable, though other output formats are available (FITS, json, txt, etc.).<br> </p> <ul> <li>In particular, ESO offers two TAP services:  <b>tap_obs</b> to query both the database tables describing the observed raw and reduced data obtained at the La Silla Paranal Observatory, and the database tables containing the ESO ambient conditions and meteorological measurements (seeing, isoplanatic angle, precipitable water, turbulence profiles, etc.); <b>tap_cat</b> to query the scientific catalogues provided by the principal investigators [PIs] of ESO public surveys and observing programmes.<br> </li> <p> </p> <li>Powerful <b>spatially-indexed queries</b> can be formulated using the spatial extensions of ADQL, which is otherwise based on the SQL 92 standard. For example, it is possible to query the reduced data products by their footprints: does the footprint contain or intersect a specific sky region? which images or source tables overlap for a minimum extent of 0.8 square degrees? <b>Note:</b> while tap_obs offers the full power of spatially-indexed queries, <b>tap_cat supports only the cone search</b> formulated as in the following example:  SELECT ... FROM pessto_tran_cat_fits_V2 WHERE CONTAINS(point('', transient_raj2000, transient_decj2000), circle('', 41.2863, -55.7406, 0.04))=1 AND ...<br> </li> <p> </p> <li><b>Asynchronous queries</b> allow for long running queries to complete without the client maintaining a connection to the service. Results are stored by the service for later retrieval by the client. Asynchronous query execution is generally more robust and not susceptible to time-outs or other transient failures. They are especially suited to queries that run for a long time before producing output (e.g. queries that compute or aggregate values). See (<a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/documents/TAP/20100327/">TAP 1.0, P. Dowler et al, 2010, IVOA Recommendation</a>) for the full TAP specification, but also the (<a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/documents/latest/UWS-REST.html">UWS REST Note, G. Rixon, 2007</a>) for a primer on how to interact with the TAP asynchronous jobs. <b>Please note that</b> <b>the TAP UPLOAD feature is not implemented</b>, though it will become available in a later release.<br> </li> <p> </p> <li><b>Synchronous queries</b> execute immediately and the client must wait for the query to finish. Synchronous query execution is generally simpler and provides a faster (low latency) response and should be adequate when the query will execute and start returning results quickly. Even with large query results, synchronous queries are a good approach as long as the service can stream the output and consume modest internal resources.</li> <p> </p> <li>Via tap_obs, users can query the standard <b><i><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/tap_obs/sync?REQUEST=doQuery&FORMAT=html&LANG=ADQL&MAXREC=200&QUERY=SELECT+column_name%2C+unit%2C+ucd%2C+description+FROM+TAP_SCHEMA.columns+where+table_name+%3D+%27ivoa.ObsCore%27">ivoa.ObsCore</a></i></b> table (<a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/documents/ObsCore/20170509/">ObsCore, M. Louys et al, 2017, IVOA Recommendation)</a>) to gather access to all the ESO reduced data, the <b><i><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/tap_obs/sync?REQUEST=doQuery&FORMAT=html&LANG=ADQL&MAXREC=200&QUERY=SELECT+column_name%2C+unit%2C+ucd%2C+description+FROM+TAP_SCHEMA.columns+where+table_name+%3D+%27dbo.raw%27">dbo.raw</a></i></b> table to gather access to all the ESO raw data, and all the <b><i><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/tap_obs/sync?REQUEST=doQuery&FORMAT=html&LANG=ADQL&MAXREC=200&QUERY=SELECT+table_name%2C+description+FROM+TAP_SCHEMA.tables+where+table_name+like+%27asm.%25%27">asm.*</a></i></b> tables to gather access to the ambient conditions and meteorological measurements of the La Silla, Paranal and Chajnantor sites.</li> </ul> <div> </div> <ul> <li><b>Authorised tap_obs queries</b> (via token authentication) allow to search through all raw observations the user has been granted (metadata) access to, including the ones with private metadata not accessible anonymously.<br> </li> </ul> <p style="margin-left: 40.0px;"><b>Useful only to: </b>users who have been granted specific permissions (on a run, or on an instrument)<b>, </b>for example to instrument and operation teams, or to PIs of confidential observing programmes (or their delagates);</p> <p style="margin-left: 40.0px;"><b>Not useful to: </b>PIs of regular programmes, nor to normal archive users; these users can still run authenticated queries (provided they have <a adhocenable="false" href="https://web.archive.org/web/20220618003211/https://www.eso.org/UserPortal/">an ESO account),</a> but:</p> <p>                - their queries will return exactly the same records as if unauthenticated,</p> <p>                - their queries will run slower than if unathenticated.</p> <p> </p> <p>The <b><i>Simple Spectral Access Protocol</i></b> of the VO (<a href="https://web.archive.org/web/20220618003211/http://ivoa.net/documents/SSA/20120210/REC-SSA-1.1-20120210.htm">SSAP, D. Tody et al., 2012, IVOA Recommendation</a>) defines a uniform interface to remotely discover and access one dimensional spectra. The ESO Simple Spectral Access service provides access to the 1D reduced spectra generated either by the principal investigators of ESO observations, or by an unattended ESO processing-pipeline that makes use of certified master calibrations. The spectra are FITS files adhering to the ESO Science Data Product standard (<a href="https://web.archive.org/web/20220618003211/http://www.eso.org/sci/observing/phase3/p3sdpstd.pdf">PDF</a>), based on the Virtual Observatory Spectral Data Model standard (v1.0 for some (simple) spectra, and v2.0 for some others (more complex): use the VOCLASS FITS keyword to discern between the two). A dedicated page provides <a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/cms/eso-data/help/1dspectra.html">help in reading and displaying the 1D spectral format</a>, also using IRAF, IDL, and python.</p> <p>Example: In its simplest form, a query to the ESO SSAP for 1d science spectra in a cone of 0.2 degrees around a given equatorial J2000 position, looks like this:<br> <i>http://archive.eso.org/ssap?REQUEST=queryData&POS=123.269560,-34.57804&SIZE=0.2</i></p> <p> </p> <p>The <b><i>DataLink service</i></b> (<a href="https://web.archive.org/web/20220618003211/http://www.ivoa.net/documents/DataLink/20150617/">P. Dowler et al, 2015, IVOA Recommendation</a>) is a service that finds all files that are somehow related to the selected science file, and presents a table with the access points of all those files. The output result of a DataLink invocation is a VOTable, unless the parameter RESPONSFORMAT=json is added to the request. The ESO datalink service is linked to from within the responses received from queries to the <i>ivoa.ObsCore</i> table for reduced data, and the <i>dbo.raw</i> table for raw data. For example, a query to the <i>ivoa.ObsCore</i> table can return a column called <i>access_url</i>; such URL can be recognised (by its UCD) as a datalink resource. Following a datalink URL, the user can gather the access points (for download) of the main science file described in the selected ObsCore record, of any ancillary file associated to the main science file, of the file(s) out of which the main science file originated (progenitors), of the preview of the main science file, of the data release description associated to the main science file, and of any product that could have been generated out of the selected science file (derivation). Similarly, for the <i>datalink_url</i> column of the <i>dbo.raw</i> table.<br> </p> <p>It is also possible to compute a datalink URL, instead of querying for it, by appending the ESO identifier dp_id field to the fixed string 'http://archive.eso.org/datalink/links?ID=ivo://eso.org/ID?', for example:<br> </p> <ul> <li>(reduced data): <i>http://archive.eso.org/datalink/links?ID=ivo://eso.org/ID?ADP.2014-10-01T10:19:21.580</i></li> <li>(raw data): <i>http://archive.eso.org/datalink/links?ID=ivo://eso.org/ID?GIRAF.2003-09-26T23:43:54.741</i></li> </ul> <p>Since <b>2019-Nov-15</b>, the datalink response for a raw science frame includes links to the service that returns the calibration files needed to calibrate it. More information is available within the programmatic section of the page: <a href="/web/20220618003211/https://archive.eso.org/cms/application_support/calselectorInfo.html#programmatic">Automatic selection of calibration files</a>. </p> <p>Since <b>April 2020</b>, the DataLink service supports the SODA Service Descriptor standard (refer to the section <a href="https://web.archive.org/web/20220618003211/http://ivoa.net/documents/SODA/20170517/REC-SODA-1.0.html#tth_sEc4.2">4.2 SODA Service Descriptor from DataLink</a>), providing all the metadata necessary for the user to invoke the ESO cutout service onto the specific dataset at hand (see below).<br> </p> <p>Since <b>April 2020</b>, the DataLink service supports proprietary data, on top of the already supported public data.<br> </p> <p>Since<b> August 2021</b>, the service supports token authentication, allowing operations teams and users with specific granted permissions, to run datalink also on their own private observations (not visible anonymously, e.g., commissioning and project-specific files).<br> </p> <p> </p> <p>The <b>Cutout service, </b>compliant to the<b> Server-side Operations for Data Access (SODA) standard</b> (<a href="https://web.archive.org/web/20220618003211/http://ivoa.net/documents/SODA/20170517/">F. Bonnarel et al, 2017 IVOA Recommendation</a>) is available <b>since April 2020</b>. It offers to the users the possibility to download just only the positional or spectral data chunks (including errors and quality arrays) they are interested in, without any loss in accuracy (no resampling, no rescaling) for any science or ancillary file with suitable positional and/or spectral dimensions. Currently supported are positional cutouts for images, cubes, source tables, and catalog tiles, and spectral cutouts for cubes and spectra, and their accompanying ancillary files like weightmaps, etc.</p> <p> </p> <p><b>Authentication</b> to the <b>ESO data portal</b>, to download files or their cutouts, via either <i>basic authentication</i> or via <i>OAuth2.0 OpenID_Connect</i> is supported <b>since April 2020</b>. Users can programmatically authenticate and download their proprietary data (whether full download, or SODA/cutout) using those standard authentication protocols, without the need to handshake with the archive in a complex Archive Request process.</p> <p><b>Authentication</b> to the <b>tap_obs</b> and <b>datalink </b>via<i> OAuth2.0 OpenID_Connect (basic authentication</i> not supported)<b>: </b>As of <b>July 2021</b>, it is possible to invoke tap_obs and datalink with token authentication, with the purpose of exercising specific user's permissions that allow to access data whose metadata are not accessible anonymously. For a full explanation and examples of this, please visit a dedicated <a adhocenable="false" href="/web/20220618003211/https://archive.eso.org/cms/eso-data/programmatic-access/authentication-and-authorisation.html"><b>ESO Programmatic Authentication & Authorisation</b></a> and, from therein, a related <b>python jupyter notebook</b>.</p> <p>With basic authentication, the user attaches to the HTTP header the directive: "<i>Authorization: Basic xxx</i>" where xxx is the base64-encoding of the byte sequence composed of her "username:password";</p> <p>With token-based authentications, the user, when authenticating through the OAuth2.0 endpoint (see below), receives a token that must be inserted in the HTTP header. The token remains active and valid for 8 hours (the validity range might change in the future). In that case the HTTP header directive becomes: "<i>Authorization: Bearer xxx</i>" where xxx is the received token.</p> <p> </p> <center><table width="507" height="67" cellspacing="0" cellpadding="1" border="1"> <tbody><tr><th scope="col">Service</th> <th scope="col">End Point (link to capabilities)</th> </tr><tr><td>tap_obs</td> <td><a href="https://web.archive.org/web/20220618003211/https://archive.eso.org/tap_obs/capabilities" adhocenable="false">https://archive.eso.org/tap_obs</a></td> </tr><tr><td>tap_cat</td> <td><a href="https://web.archive.org/web/20220618003211/https://archive.eso.org/tap_cat/capabilities" adhocenable="false">https://archive.eso.org/tap_cat</a></td> </tr><tr><td>ssap</td> <td>https://archive.eso.org/ssap</td> </tr><tr><td>datalink</td> <td><a href="https://web.archive.org/web/20220618003211/https://archive.eso.org/datalink/capabilities" adhocenable="false">https://archive.eso.org/datalink</a></td> </tr><tr><td>SODA/cutout</td> <td><a href="https://web.archive.org/web/20220618003211/https://dataportal.eso.org/dataPortal/soda/capabilities" adhocenable="false">https://dataportal.eso.org/dataPortal/soda</a></td> </tr><tr><td>OAuth2.0 OpenID_Connect</td> <td>https://www.eso.org/sso/oidc/token</td> </tr></tbody></table> <p> </p> <p><a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/programmatic/">A demo page is available</a>, with live examples, to learn how to use all the above (and more). Therein, live examples are provided; the user can execute them, or can modify them to learn how to use the system, can learn how to formulate valid URLs that can be used to script the archive access. Some simple python scripts are also provided, including, <b>since April 2020,</b> some <a adhocenable="false" href="https://web.archive.org/web/20220618003211/http://archive.eso.org/programmatic/HOWTO/">jupyter notebooks</a>, to illustrate how to script the access to the ESO science archive.</p> <p>The <a href="https://web.archive.org/web/20220618003211/http://archive.eso.org/programmatic/QueryManager.html">TAP Query Management page</a> can be used to control, or to learn how to control from a script, the TAP asynchronous jobs.</p> </center> <p> </p> <p> </p> <p> </p> <p> </p> <p> </p> <p> </p> <p> </p> <p> </p> </div> </div> </div> </div> </div> </div> </div> </div>  <div class="footer">  <div id="footer"> <div id="footerupdate"> <table> <tbody> <tr> <th>Last Update: 02.08.21 © ESO</th> <td><a href="https://web.archive.org/web/20220618003211/https://support.eso.org/"> Send us your comments</a> | <a href="/web/20220618003211/https://archive.eso.org/cms/rss.xml">Subscribe to Newsletter</a> | <a href="/web/20220618003211/https://archive.eso.org/cms/eso-data-access-policy.html">Privacy Statement</a></td> </tr> </tbody> </table> </div> </div>  </div> </div>  </div>   <script type="text/javascript"> var _paq = _paq || []; /* tracker methods like "setCustomDimension" should be called before "trackPageView" */ _paq.push(['trackPageView']); _paq.push(['enableLinkTracking']); (function() { var u="/mtmo/"; _paq.push(['setTrackerUrl', u+'piwik.php']); _paq.push(['setSiteId', '1']); var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0]; g.type='text/javascript'; g.async=true; g.defer=true; g.src=u+'piwik.js'; s.parentNode.insertBefore(g,s); })(); </script>  </body> </html>