Aladin Lite documentation

<!doctype html> <html> <head> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta charset="UTF-8"> <script type="text/javascript" src="https://aladin.cds.unistra.fr/AladinLite/api/v3/latest/aladin.js" charset="utf-8"></script> <link href="/assets/css/bootstrap.min.css" rel="stylesheet">  <link href="/cds-navbar-resources/css/cdsnavbar.min.css" rel="stylesheet">  <link title="SIMBAD" rel="search" type="application/opensearchdescription+xml" href="/cds-navbar-resources/opensearch/simbad.xml"> <link title="VizieR" rel="search" type="application/opensearchdescription+xml" href="/cds-navbar-resources/opensearch/vizier.xml"> <link title="Aladin" rel="search" type="application/opensearchdescription+xml" href="/cds-navbar-resources/opensearch/aladin.xml"> <link title="XMatch" rel="search" type="application/opensearchdescription+xml" href="/cds-navbar-resources/opensearch/xmatch.xml"> <link href="/assets/css/aladin.css" rel="stylesheet"> <style> #imageSurveysList {font-size: 13px;} #imageSurveysList tr > td:first-child {font-weight: bold;} </style> <title>Aladin Lite documentation</title> </head> <body>  <nav class="cds-menu for-aladin" role="menubar" aria-label="CDS services navigation" data-pagefind-ignore>  <header><a href="https://cds.unistra.fr" role="menuitem" aria-label="CDS website"></a></header>  <ul role="menu" aria-label="CDS services">  <li class="is-collapsed-when-very-small" role="none">  <span class="menu-trigger for-all-services" tabindex="0" onclick="void(0)" role="menuitem" aria-label="List CDS services and more" aria-haspopup="true" aria-expanded="false"><span>Services</span></span>  <ul role="menu" aria-label="CDS main services"> <li role="none"><a class="portal" href="http://cdsportal.u-strasbg.fr" role="menuitem" aria-label="CDS Portal"><span></span></a></li> <li role="none"><a class="simbad" href="http://simbad.cds.unistra.fr/simbad" role="menuitem" aria-label="Simbad"><span></span></a></li> <li role="none"><a class="vizier" href="https://vizier.cds.unistra.fr/viz-bin/VizieR" role="menuitem" aria-label="VizieR"><span></span></a></li> <li role="none"><a class="aladin" href="http://aladin.cds.unistra.fr/aladin.gml" role="menuitem" aria-label="Aladin"><span></span></a></li> <li role="none"><a class="xmatch" href="http://cdsxmatch.u-strasbg.fr" role="menuitem" aria-label="X-Match"><span></span></a></li>  <li role="none">  <a class="menu-trigger for-other-services" tabindex="0" onclick="void(0)" role="menuitem" aria-label="Other resources" aria-haspopup="true">Others</a>  <ul role="menu" aria-label="Other resources"> <li role="none"><a href="https://cds.unistra.fr/cgi-bin/Sesame" role="menuitem" aria-label="Sesame name resolver">Sesame name resolver</a></li> <li role="none"><a href="https://cds.unistra.fr/cgi-bin/Dic-Simbad" role="menuitem" aria-label="Dictionary of nomenclature">Dictionary of nomenclature</a></li> <li role="separator" class="divider" aria-hidden="true"></li>  <li role="none"><a href="mailto:cds-question@unistra.fr" tabindex="0" role="menuitem" aria-label="Contact us">Contact us</a></li> </ul> </li> </ul> </li>  <li role="none"><a class="help" href="https://cds.unistra.fr/help" role="menuitem" aria-label="Help resources"><span>Help</span></a></li> </ul> </nav> <div class="cdsPageTitle"><h1></h1></div> <header class="subhead"> <div class="container"> <h1>Aladin Lite</h1> <p>A lightweight sky atlas running in the browser</p> </div> </header> <ul class="breadcrumb"> <li><a href="../">Aladin Lite</a> <span class="divider">/</span></li> <li class="active">Documentation</li> </ul> <div class="container content">  <div class="row"> <div class="span3"> <ul class="nav nav-tabs nav-stacked aladinlite-sidenav" data-spy="affix" data-offset-top="210"> <li><a href="#overview">Overview</a></li> <li><a href="#embedding">Embedding in a web page</a></li> <li><a href="#v3-new-features">New features in v3</a></li> <li><a href="#migration">Migration guide</a></li> <li><a href="#API">Javascript API</a></li> <li><a href="#features">Features</a></li> <li><a href="#usage">Usage</a></li> <li><a href="#source-code">Source code</a></li> <li><a href="#self-hosting">Self-hosting Aladin Lite v3 files</a></li> <li><a href="#ipyaladin">ipyaladin: Aladin Lite<br>in notebooks</a></li> <li><a href="#mobile-apps">Integration in mobile apps</a></li> <li><a href="#showcase">Showcase</a></li> <li><a href="#plugins">Plugins</a></li> <li><a href="#release-notes">Release page</a></li> <li><a href="#v2-links">Aladin Lite v2 still available</a></li> <li><a href="#support">Support</a></li> <li><a href="#contact">Contact</a></li> </ul> </div> <div class="span9">   <a name="overview"></a> <div class="page-header"> <h1>Overview</h1> </div> <div class="row"> <div class="span5"> <p class="lead"> Aladin lite is a lightweight version of the <a href="http://aladin.cds.unistra.fr/aladin.gml" title="Aladin home page">Aladin Sky Atlas</a>, running in the browser and geared towards simple visualization of a sky region. </p> <p>It allows one to visualize image surveys (JPEG multi-resolution HEALPix all-sky surveys) and superimpose tabular (VOTable) and footprints (STC-S) data.</p> <p>Aladin lite is powered by the WebGL, supported by all modern browsers</p> <p>Aladin lite is <a href="#embedding">easily embeddable on any web page</a> and can also be controlled through a <a href="#API">Javacript API</a>.</p> <p>It is dedicated to replace the Aladin Java applet technology in the medium term.</p> <br/> <p>The panel on the right hand is not a regular image. It is actually Aladin Lite running as an embedded widget. You might try to zoom in and out using your mouse wheel, or pan the view to move around.</p> </div> <div class="span3"> <div id="aladin-lite-div" style="width:300px;height:300px;"></div> <script type="text/javascript" src="//code.jquery.com/jquery-1.12.1.min.js"></script> <script type="text/javascript"> var aladin; A.init.then(() => { aladin = A.aladin('#aladin-lite-div', {showStatusBar: false, showFov: false, showProjectionControl: false, showLayersControl: false, showControl: false, fov: 0.5, target: "20 45 38.0 +30 42 30", cooFrame: "J2000", survey: "P/DSS2/color", showFullscreenControl: false, showFrame: false, showGotoControl: false}); }); </script> <script> </script> </div> </div>   <a name="embedding"></a> <div class="page-header"> <h1>Embedding in a web page</h1> <p><b>Terms of use:</b> you are welcome to integrate Aladin Lite in your web pages and to customize its GUI to your needs, but please <b>leave the Aladin logo and link intact</b> at the bottom right of the view.</p> </div> <iframe style="width: 100%; height: 600px;" marginheight="0" marginwidth="0" src="embedding-v3.html" width="100%" height="300px" frameborder="0" scrolling="no"></iframe> <p>For more details and options, have a look at the tutorial <b><a href="tutorials/interactive-finding-chart/">Build an interactive sky map with Aladin Lite</a></b>, initially developed for <a href="https://sites.google.com/a/dotastronomy.com/wiki/dotastro7">dotAstronomy7</a>. Developers might also be interested in this tutorial, which shows step by step how to create an interactive sky map with Aladin Lite.</p>   <a name="v3-new-features"></a> <div class="page-header"> <h1>New features coming with v3</h1> </div> <div class="row"> <div class="span5"> <p>Aladin Lite v3 is out and comes with the following features: <ul> <li>WebGL2 new graphical engine</li> <ul><li>FITS HiPS tiles support and dynamic client-side cutouts changes</li> <li>All-sky projections support: Aitoff, Mollweide, Azimuthal, Gnomonic, Mercator and many more</li> <li>Multiple image survey overlays</li></ul> <li>Better MOC support</li> <ul><li>Can display MOCs up to max HEALPix order 29 (~0.4 milli-arcsecond HEALPix cells)</li> <li>use of performant Rust librairies cds-moc and cds-healpix</li> </ul> <li>New coordinate grid overlay - more customisations to come!</li> <li>Smartphones/tablets enhanced experience: pinched rotation and zoom, move with inertia</li> <li>Still lightweight (half a megabyte)</li> </ul> The code source is available on our <a href="https://github.com/cds-astro/aladin-lite">repository at this link</a>. This also provides a little snippet of code for you to have a minimal aladin lite v3 running into your webpages. <br/> <br/> Please send us your feedback, comments, feature requests and bug reports to <a href="mailto:cds-question@unistra.fr?Subject=Aladin%20Lite">cds-question@unistra.fr</a>, they are very welcome.</p> <br/> </div> <div class="span3"> <div id="aladin-lite-v3" style="width:300px;height:300px;"></div> <style> .aladin-location { top: 0.2rem; left: 0.2rem; } .aladin-location .aladin-input-text { margin: 0; } </style> <script type="text/javascript"> let alv3; A.init.then(() => { alv3 = A.aladin('#aladin-lite-v3', {showStatusBar: false, showLayersControl: false, showFov: false, fov: 180, target: "20 45 38.0 +30 42 30", projection: "AIT", cooFrame: "J2000", survey: "P/DSS2/color", showProjectionControl: false, showFullscreenControl: false, showFrame: false, showGotoControl: false}); }); </script> </div> </div>   <a name="migration"></a> <div class="page-header"> <h1>Migration notes</h1> </div> A migration page intended to help users switching from the v2 to the v3 is available <a href="https://aladin.cds.unistra.fr/AladinLite/doc/migration-guide/">at this link</a>   <a name="API"></a> <div class="page-header"> <h1>Javascript API</h1> </div> <p>Aladin Lite comes with a new <a href="https://cds-astro.github.io/aladin-lite/">full-featured API</a> allowing one to customize its interface, control the view, change the image survey to display, create catalogues and overlay layers, develop powerful interactions between a web page and Aladin Lite. </p> <p> The Aladin Lite API is also briefly described on a <a href="API/">dedicated page</a>. </p> <p> Developers might also be interested in <a href="tutorials/interactive-finding-chart/">this tutorial</a>, which shows step by step how to create an interactive sky map with Aladin Lite. </p>   <a name="features"></a> <div class="page-header"> <h1>Features</h1> </div> <p> To give you an overview of how Aladin Lite can be used, have a look at the <a href="API/examples/">list of examples</a>. </p>   <a name="usage"></a> <div class="page-header"> <h1>Aladin Lite usage</h1> </div> <p>Aladin Lite has been integrated in the main CDS services: <ul> <li>On the SIMBAD page for an individual object, it provides an interactive preview image (see <a href="http://simbad.u-strasbg.fr/simbad/sim-id?Ident=M1">example for <em>Messier 1</em></a>).</li> <li>The VizieR results page features a <em>start Aladin Lite</em> button to visualize the positions of listed sources (see <a href="http://vizier.u-strasbg.fr/viz-bin/VizieR-4?-source=I/259/tyc2&-c=M45&-c.rm=30">example</a>) </li> </ul> </p> <p>Outside CDS, Aladin Lite is used in several projects: <ul> <li><a href="http://archive.eso.org/scienceportal/home" title="ESO Archive Science Portal">ESO Archive Science Portal</a></li> <li><a href="http://sky.esa.int/" title="ESA Sky">ESA Sky</a> allows for discovery and access of data observed by ESA space missions</li> <li><a href="http://almascience.org/aq" title="ALMA archive link">ALMA Science Archive</a></li> <li>The <a href="https://lasair.roe.ac.uk" title="Lasair website">Lasair</a> alerts broker uses Aladin Lite on its <a href="https://lasair.roe.ac.uk/object/ZTF19aafmidf/">object details</a> page.</li> <li><a href="https://virgo.pg.infn.it/index.html" title="Gravitational waves Sky Localizations">Gravitational waves interactive viewer</a> displays the localisation on the sky of the gravitational wave events.</li> <li><a href="https://heasarc.gsfc.nasa.gov/xamin/" title="Xamin">HEASARC Xamin system</a> for discovery and data retrieval</li> <li><a href="https://losc.ligo.org/s/skymapViewer/aladin/index.html#GW150914:LALI" title="Skymap viewer">Skymap Viewer</a> shows probability contours for gravitational wave events from LIGO/Virgo</li> <li><a href="http://jvo.nao.ac.jp/portal/v2/" title="JVO Portal">JVO Portal v2</a></li> <li><a href="http://gamma-sky.net/" title="Gamma Sky">Gamma Sky</a>, a portal to gamma-ray sky (developed by C. Deil and A. Voruganti)</li> <li><a href="http://archive.cefca.es/catalogues/jplus-dr1">J-PLUS DR1</a>, a portal to access data of the First Data Release of the Javalambre-Photometric Local Universe Survey (<a href="http://www.j-plus.es/">J-PLUS</a>)</li> <li>NOIRLab <a href="https://datalab.noirlab.edu/discovery.php">Astro Data Lab discovery tool</a></li> <li><a href="https://toltec.lmtgtm.org/toltec_obs_planner">TolTEC Observation Planner</a></li> <li>CEFCA<a href="http://www.cefca.es/outreach/images_navigator"> images navigator</a> and <a href="http://www.cefca.es/divulgacion/tours_imagenes">images tours</a></li> <li><a href="http://saada.unistra.fr/ArchesWalker/" title="ARCHES Walker">ARCHES Walker</a>, an Outreach tool showcasing astronomical objects in different wavelengths (<a href="http://www.arches-fp7.eu/">ARCHES project</a>)</li> <li><a href="http://hologhost.altervista.org/pointing/mopra.html" title="MOPRA Telescope pointing">MOPRA Radio Telescope Pointing and Status</a> <li><a href="http://darts.isas.jaxa.jp/astro/judo2/" title="JUDO2">JUDO2</a> (JAXA Universe Data Oriented)</li> <li><a href="http://darts.isas.jaxa.jp/astro/akari/cas/tools/explore/obj.php" title="Akari explore tool">Akari explore tool</a></li> <li><a href="http://cassis.sirtf.com/atlas/" title="CASSIS">CASSIS atlas of Spitzer Infrared Spectra</a></li> <li><a href="https://www.spitzer.caltech.edu/zoomable/glimpse-aladin" title="GLIMPSE 360 data visualized by Aladin Lite">GLIMPSE 360</a></li> <li><a href="http://cade.irap.omp.eu/">CADE</a> (<em>Centre d'Analyse de Donn茅es Etendues</em>) uses Aladin Lite to provide previews of the HEALPix maps they publish (<a href="http://cade.irap.omp.eu/dokuwiki/doku.php?id=cgps">Example for CGPS data</a>) </li> <li><a href="http://www.adsass.org/aladin/">ADS All-Sky Survey</a> makes use of Aladin Lite to display heatmaps of SIMBAD objects cited in the literature.</li> </ul> </p> <p>If your project is using Aladin Lite, we would be happy to have it listed here. <a href="mailto:cds-question@unistra.fr">Drop us a line!</a></p>   <a name="source-code"></a> <div class="page-header"> <h1>Source code</h1> </div> <p>Aladin Lite source code is available under GPL3 license and can be browsed from the <a href="https://github.com/cds-astro/aladin-lite">CDS github repository</a></p> <p>If you think this license might prevent you from using Aladin Lite in your pages/application/portal, please <a href="mailto:cds-question@unistra.fr?Subject=Aladin%20Lite">contact us</a>.</p>   <a name="self-hosting"></a> <div class="page-header"> <h1>Self-hosting Aladin Lite v3 files</h1> </div> <p>For developers willing to self-host Aladin Lite on their own server, you can <a href="//aladin.cds.unistra.fr/AladinLite/api/v3/latest/AladinLiteAssets.tar.gz"><b>download all assets at this link</b></a>.   <a name="ipyaladin"></a> <div class="page-header"> <h1>ipyaladin - Aladin Lite in Python notebooks</h1> </div> <p> Aladin Lite can be controlled from Jupyter notebooks, using <b><a href="../ipyaladin/">ipyaladin</a></b>. <b>ipyaladin</b> is a Jupyter notebook widget, developed at CDS, and allowing for easy embedding and control of Aladin Lite from an IPython notebook. </p>   <a name="mobile-apps"></a> <div class="page-header"> <h1>Integration in mobile applications</h1> </div> <p> <h3>Android</h3> Ladislav Heller (<code>ladislav.heller at gmail.com</code>) has integrated Aladin Lite in an Android application using the Xamarin framework.<br/> His development is available in his github repository: <a href="https://github.com/laheller/CDS_Aladin">github.com/laheller/CDS_Aladin</a> </p> <p> <h3>iPhone</h3> If you have integrated Aladin Lite in an iPhone application, please <a href="mailto:cds-question@unistra.fr">let us know</a>. </p>   <a name="showcase"></a> <div class="page-header"> <h1>Showcase</h1> </div> <p><a href="../showcase/">This page</a> features some experimental, original usages of Aladin Lite.   <a name="plugins"></a> <div class="page-header"> <h1>Plugins</h1> </div> <p> <ul> <li> <h3>ALiX</h3> <div class="row"> <div class="span5"> <p><a href="https://github.com/lmichel/alix/">ALiX</a> is a flexible catalog portal based on Aladin Lite. It it designed to use an interactive sky view as a primary selection tool. The ALiX view is constantly updated with data queried in the host database. It offers advanced functionalities allowing to mix local data with VO data. Users can plot by hand areas of interest and manage an historic of the views.</p> <p>ALiX has no dependency with any specific data source; it can be integrated in any existing portal.</p> </div> <div class="span3"> <a href="https://github.com/lmichel/alix/"><img src="img/alix-plugin.png" style="max-width: 100% ; height: auto;"></a> </div> </div> </li> </ul> </p> <p> <ul> <li> <h3>Region editor</h3> <div class="row"> <div class="span5"> <p>The region editor is an Aladin Lite extension allowing users to plot polygons over the current sky view, and retrieve the coordinations of the vertices.<br> It has been designed to be used as an interface for searches by region or for cutout services.<br> This development has been funded by the SSC XXM-Newton.</p> <p>Documentation, installation instructions can be found <a href="http://saada.unistra.fr/jsresources/region.html">on this page</a>.</p> </div> <div class="span3"> <a href="http://saada.unistra.fr/jsresources/region.html"><img src="img/region-editor-plugin.png" style="max-width: 100% ; height: auto;"></a> </div> </div> </li> </ul> </p> <p> <ul> <li> <h3>Tour navigator library</h3> <div class="row"> <div class="span5"> <p>The tour navigator is an Aladin Lite extension that allows to implement easily virtual tours of objects of interest. It has been designed to be used as interface for navigating through the sky from object to object. Allowing users to learn about each object they visit in the tour. The tour navigator plugin has been developed and designed at <a href="http://www.cefca.es">CEFCA</a> (Centro de Estudios de F铆sica del Cosmos de Arag贸n) by Tamara Civera. Documentation, source code and installation instructions can be found <a href="http://www.cefca.es/cefca_en/tour_navigator_library">on this page</a>.</p> </div> <div class="span3"> </div> </li> </ul> </p>   <a name="release-notes"></a> <div class="page-header"> <h1>Release page</h1> </div> A release page including all the versions deployed to help users switching between versions is available <a href="https://aladin.cds.unistra.fr/AladinLite/doc/release/">here</a>   <a name="v2-links"></a> <div class="page-header"> <h1>Aladin Lite v2 is still available</h1> </div> <p>Users can still use it but no more development will be done on it. The Aladin Lite v2 documentation can be found <a href="https://aladin.cds.unistra.fr/AladinLite/v2-doc/"><b>at this link</b></a> as well as its code source <a href="https://github.com/cds-astro/aladin-lite/tree/v2"><b>here</b></a></p>   <a name="support"></a> <div class="page-header"> <h1>Support</h1> </div> <p><em>Aladin Lite v3 is in part supported by the ESCAPE project (the European Science Cluster of Astronomy & Particle Physics ESFRI Research Infrastructures) that has received funding from the European Union's Horizon 2020 research and innovation programme under the Grant Agreement n. 824064.<br>Aladin Lite v3 has also been supported by the Europlanet 2024 RI project that has received funding from the European Union's Horizon 2020 research and innovation programme under grant agreement No 871149.</em></p>   <a name="contact"></a> <div class="page-header"> <h1>Authors</h1> </div> <p>Aladin Lite is developed and maintained by Thomas Boch and Matthieu Baumann</p> <p>Send your feedback, comments, feature requests and bug reports <a href="mailto:cds-question@unistra.fr?Subject=Aladin%20Lite">to this email address</a>.</p> </div>  </div>  </div>  <footer class="cds-footer for-aladin" data-pagefind-ignore> <div class="cds">  <a class="cds logo" href="https://cds.unistra.fr" title="CDS - Centre de Donn茅es astronomiques de Strasbourg" target="_blank"></a>  <div class="socials"> <a class="email" title="Send an email to the CDS team." href="mailto:cds-question@unistra.fr?Subject=Aladin%20Lite"></a> <a class="rss" title="RSS Feed of the CDS news" href="https://cds.unistra.fr/news/rss.php" target="_blank" rel="noopener noreferrer"></a> <a class="facebook" title="CDS' Facebook page." href="https://www.facebook.com/CDSportal/" target="_blank" rel="noopener noreferrer"></a> <a class="youtube" title="CDS' Youtube channel." href="https://www.youtube.com/@CDSportal" target="_blank" rel="noopener noreferrer"></a> <a class="github" title="CDS' GitHub page." href="https://github.com/cds-astro" target="_blank" rel="noopener noreferrer"></a> </div> </div> <div class="service"> <div class="content"> → Thanks for <a href="/aladin.gml#Acknowledgement">acknowledging Aladin Sky Atlas</a> </div> </div> <div class="legal-links"> <a href="https://cds.unistra.fr/about/contact/">Contact</a> - <a href="https://cds.unistra.fr/legals/">Legals</a> </div> </footer> <script src="/assets/js/bootstrap-affix.js"></script> <script type="text/javascript"> $(document).ready(function() { $.ajax({ url: "//aladin.u-strasbg.fr/java/nph-aladin.pl", data: {"frame": "aladinLiteDic"}, method: 'GET', dataType: 'jsonp', success: function(surveys) { surveys = surveys.sort(function(a, b) {return a.order > b.order ? 1 : -1;}); var content = ""; for (var k=0, len=surveys.length; k<len; k++) { content += '<tr><td>' + surveys[k].id + '</td><td>' + surveys[k].name + '</td></tr>'; } $('#imageSurveysList tbody').append(content); } }); }); </script> </body> </html>

CINXE.COM

Aladin Lite documentation