ipyaladin 0.1.11

ipyaladin

ipyaladin

Description

A bridge between Jupyter and Aladin Lite, enabling interactive sky visualization in IPython notebooks.

With a couple of lines, you can display Aladin Lite, center it on the target of your choice, and overlay an Astropy table:

Examples

Some example notebooks can be found in the examples directory.

. You can also try it directly in mybinder, without installing anything.

Installation

To install use pip:

$ pip install ipyaladin

Make sure you have jupyter installed

$ pip install jupyter

Then, make sure to enable widgetsnbextension:

$ jupyter nbextension enable --py widgetsnbextension

Finally, enable ipyaladin:

$ jupyter nbextension enable --py --sys-prefix ipyaladin

And you are ready to use ipyaladin inside your notebooks! Additionny, for a jupyterlab usage you will need to:

$ jupyter labextension develop ipyaladin --overwrite

There is also an experimental conda package that can be installed with:

$  conda install -c tboch ipyaladin

Development

For a development installation (requires Node.js and Yarn version 1),

$ git clone https://github.com/cds-astro/ipyaladin.git
$ cd ipyaladin
$ npm install yarn
$ pip install -e .
$ jupyter nbextension install --py --symlink --overwrite --sys-prefix ipyaladin
$ jupyter nbextension enable --py --sys-prefix ipyaladin

When actively developing your extension for JupyterLab, you will need to run this command too:

$ jupyter labextension develop --overwrite ipyaladin

Then you need to rebuild the JS when you make a code change:

$ cd js
$ yarn run build

You then need to refresh the JupyterLab page when your javascript changes.