Researcher Workshop: WWT @ ADASS29 (Groningen, Netherlands; 2019 October 6)

Table of contents

Scroll down or click for:

Are you a researcher curious about using WWT? Will you be in Groningen on October 6 for ADASS 29? Then you should sign up for the WWT workshop I’ll be leading, “Interactively exploring and visualizing data on the sky with Jupyter and pywwt”! Here’s the abstract:

Sometimes, astronomers view image data with very specific goals in mind, but often, they are interested in open-ended exploration and discovery, hoping to gain new insight by comparing against multiwavelength survey data or preexisting source catalogs. Participants in this tutorial will learn how to use a powerful tool that enables this discovery from the comfort of a Jupyter notebook: pywwt, a module that allows researchers to embed the sophisticated AAS WorldWide Telescope (WWT) visualization engine in Python applications and Jupyter notebooks. The WWT engine allows scientific data to be intermingled with an interactive, 4D model of the known universe seeded with survey data from lunar surface maps to all-sky surveys across the EM spectrum. The “ds9-like” experience provided by pywwt can be controlled through code as well as manually, and the engine that it controls can be embedded anywhere that a Web browser can run since it is built on HTML, JavaScript, and WebGL. Hands-on activities will stitch the pywwt module together with other elements of the modern Python ecosystem for working with astronomical data such as astroquery. Bring your sky images or source catalogs!

The workshop is also known as “Tutorial Session #3” and will take place on Sunday (the 6th) from 15:30 to 17:30 in room 10 and 11a. When registering for the conference, all you have to do is indicate your interest by selecting “Yes” for “I would like to attend Tutorial 3 on 6 October afternoon” in the form.

Watch this thread for a detailed agenda and workshop materials, and feel free to ask questions, whether you plan to attend or not!

Preparation Instructions for Tutorial Participants

(last updated 2019 Sep 6)

Thank you for your interest in our tutorial on pywwt, powered by the AAS WorldWide Telescope! This post lists the things you should do to prepare before the tutorial.

Prerequisite knowledge

This tutorial will assume familiarity with the Python programming language and the Jupyter computation environment. No complex skills will be required, but you should at least have some experience with their basic usage. If you’re unsure about your knowledge level, please email the instructor to discuss. We will not assume any familiarity with pywwt or the AAS WorldWide Telescope ecosystem.

Additional familiarity with the standard astronomical Python stack — namely, AstroPy and its applications — will be helpful. If you’d like to gain more experience with AstroPy, we recommend visiting

pywwt is fundamentally software for working with astronomical data, so familiarity with the concepts of astronomy observing — especially coordinate systems and data formats — will be valuable as well. The final activity of the tutorial will encourage independent exploration of your own astronomical data with pywwt (see below for details). So, if you bring your own data, familiarity with the Python tools to manipulate them will be beneficial.


You should bring a personal laptop if at all possible. If you don’t have a laptop, we’ll see if we can set you up to share one with another tutorial participant.

You should also bring your laptop’s charger. Because WWT runs a realtime simulation of the known Universe, it will keep your CPU busy.

On your laptop, all you need is a web browser. Google Chrome is the officially supported choice, but other browsers work as well, on a variety of operating systems. If you have any concerns, you can test that your browser has the needed capabilities by visiting the AAS WorldWide Telescope web client and checking that the site’s functionality seems to work correctly.

For all of the Python coding, we will be running JupyterLab instances pre-loaded with pywwt and related packages in the cloud using BinderHub, so no local software installation will be necessary. However, if you would like to install the software locally, there is certainly nothing wrong with
that! Please consult the pywwt installation instructions. We strongly recommend installation in an isolated conda environment. For maximum compatibility with the tutorial, we encourage you to verify that you can use pywwt in the JupyterLab environment, which requires a bit of specialized setup right now. See the pywwt installation instructions for details.

Bring some data to visualize, if you can!

In the final part of the tutorial, we’ll have some freeform time for you to use your newly-learned skills to visualize some of your own astronomical data. Therefore, we strongly encourage you to identify a dataset that you want to visualize and make sure that it is available on your laptop! But don’t worry:
we’ll have sample data sets to play with if you don’t have anything of your own to bring

If you would like to bring your own data, here are some guidelines:

  • We will be visualizing both data tables on the sky (e.g. source catalogs) and images, so you can bring either kind of data. Better yet, bring both!
  • Because we’ll be running our Python code in the cloud, you will have to upload your data to the BinderHub server, so your dataset should not be too large. More than 30 MB might be risky. If in doubt, please email the instructor.
  • That being said, the WWT engine does have support for streaming and exploring very large (gigabyte and above) images on the fly, which is one of its unique capabilities. If you have a very large image that you would like to try visualizing, please email the instructor and we can discuss some extra preparation to explore this functionality.
  • For tabular data, WWT supports both 2D and 3D points, as well as coordinates relative to the Earth and other planets, not just in RA/Dec space. (For instance, one of our demos involves the locations of earthquakes below Earth’s crust.) So feel free to get creative in what you’d like to visualize!

Think about web hosting

We will also do an activity where we export data from a pywwt visualization to a freestanding web site. So it would be ideal if you could arrive at the tutorial prepared with some web space where you can upload HTML and JavaScript files and they’ll be accessible with a web browser on the open Internet.

If you’re not sure whether you have such a space, one option would be to use the GitHub Pages service with a temporary repository, and we’ll be prepared to walk you through the setup during the tutorial. So, if you have a GitHub account, you should be all set.

If you don’t personal web space and you don’t have or want a GitHub account, we can try to set you up with a partner who does. Or, email the instructor to discuss options.

Any questions?

If you have any questions about any of this, feel free to reach out to the instructor, Peter Williams, either by posting in this thread, or by emailing him at

We’re looking forward to seeing you in Groningen!

Bonus Tutorial Links

Here are some bonus links that tutorial participants might be interested in: