GitHub
Documentation
License
DOI badge JOSS
DOI badge AAS

Close Menu

A web application that interactively displays astronomical datasets for annotation, analysis, and discovery.

What can you do with SkyPortal?

Dashboard

The dashboard is SkyPortal's landing page. It provides a quick overview of the most recent data and events. The widgets are customizable from the configuration file, and can be moved around and resized by the user.

Sources

SkyPortal's most feature-rich page, the source page, provides a detailed view of a single astronomical object. It includes metadata, images, light curves, and spectra, follow-up capabilities, user comments, and more.

Candidates

The candidate scanning page let's user go through potential sources coming from a filtered alert stream, and decide which ones to save and/or follow up on. It includes a variety of tools to help users make decisions quickly and efficiently.

GCN Events

SkyPortal can ingest and display any GCN notices. The dedicated page provides a detailed view of the events, and let's user perform various queries, schedule observations, and report to the community.

Observing runs

Sources can be assigned as targets for observing runs. The observing run page provides a detailed view of the run, including the targets w/ priority & comments, observing conditions, star lists, and more.

Follow-up Requests

Users can request follow-up observations from any source page. The dedicated follow-up request page provides quick access to all requests for a given instrument, allocation, user, while filtering by status.

Shifts

Coordinating efforts and ensuring that people are available to monitor new multi-messenger events is crucial. The shifts page is a fully-featured calendar that allows users to sign up for shifts, comment, and receive notifications.

Telescopes

SkyPortal can handle a dynamic list of telescopes, each with its own set of instruments. The telescope page provides a world map view of the telescopes, and in-depth information about each one.

Instruments

Each telescope can have multiple instruments. The instrument page provides a detailed view of the instrument, including the filters, and the API class to interact with the instrument w/ follow-up requests.

Allocations

Concepts like follow-up requests & forced photometry require a system to manage the allocation of resources, time, and credentials to interact with the instruments. The allocation page provides a detailed view of the allocations.

TNS Integration

SkyPortal is fully integrated with the Transient Name Server. The TNS page lets user add their TNS credentials and optionally set up automated reporting, on top of the manual object submission from the source page.

Much more!

We've only scratched the surface of what SkyPortal can do. Other pages & API endpoints include: taxonomies, analysis services, galaxies, spatial catalogs, user management... SkyPortal is designed to be flexible and extensible.

How does it work?

SkyPortal builds on top of baselayer, a scientific web application platform developed by the same team. The base version of SkyPortal was designed with the Zwicky Transient Facility, and eventually LSST, in mind.


Some of the key design features of SkyPortal include:


For more information about installation, configuration, and development, please refer to the documentation.

If you find this software useful, please cite our papers:

Coughlin, Michael W., et al., A Data Science Platform to Enable Time-domain Astronomy. Publications of the Astrophysical Journal Supplement Series, 267, 2, Jul 2023. https://doi.org/10.3847/1538-4365/acdee1.

@article{Coughlin_2023,
  doi = {10.3847/1538-4365/acdee1},
  url = {https://dx.doi.org/10.3847/1538-4365/acdee1},
  year = {2023},
  month = {jul},
  publisher = {The American Astronomical Society},
  volume = {267},
  number = {2},
  pages = {31},
  author = {Michael W. Coughlin and Joshua S. Bloom and Guy Nir and Sarah Antier and Theophile Jegou du Laz and Stéfan van der Walt and Arien Crellin-Quick and Thomas Culino and Dmitry A. Duev and Daniel A. Goldstein and Brian F. Healy and Viraj Karambelkar and Jada Lilleboe and Kyung Min Shin and Leo P. Singer and Tomás Ahumada and Shreya Anand and Eric C. Bellm and Richard Dekany and Matthew J. Graham and Mansi M. Kasliwal and Ivona Kostadinova and R. Weizmann Kiendrebeogo and Shrinivas R. Kulkarni and Sydney Jenkins and Natalie LeBaron and Ashish A. Mahabal and James D. Neill and B. Parazin and Julien Peloton and Daniel A. Perley and Reed Riddle and Ben Rusholme and Jakob van Santen and Jesper Sollerman and Robert Stein and D. Turpin and Avery Wold and Carla Amat and Adrien Bonnefon and Adrien Bonnefoy and Manon Flament and Frank Kerkow and Sulekha Kishore and Shloke Jani and Stephen K. Mahanty and Céline Liu and Laura Llinares and Jolyane Makarison and Alix Olliéric and Inès Perez and Lydie Pont and Vyom Sharma},
  title = {A Data Science Platform to Enable Time-domain Astronomy},
  journal = {The Astrophysical Journal Supplement Series},
  abstract = {SkyPortal is an open-source software package designed to discover interesting transients efficiently, manage follow-up, perform characterization, and visualize the results. By enabling fast access to archival and catalog data, crossmatching heterogeneous data streams, and the triggering and monitoring of on-demand observations for further characterization, a SkyPortal-based platform has been operating at scale for >2 yr for the Zwicky Transient Facility Phase II community, with hundreds of users, containing tens of millions of time-domain sources, interacting with dozens of telescopes, and enabling community reporting. While SkyPortal emphasizes rich user experiences across common front-end workflows, recognizing that scientific inquiry is increasingly performed programmatically, SkyPortal also surfaces an extensive and well-documented application programming interface system. From back-end and front-end software to data science analysis tools and visualization frameworks, the SkyPortal design emphasizes the reuse and leveraging of best-in-class approaches, with a strong extensibility ethos. For instance, SkyPortal now leverages ChatGPT large language models to generate and surface source-level human-readable summaries automatically. With the imminent restart of the next generation of gravitational-wave detectors, SkyPortal now also includes dedicated multimessenger features addressing the requirements of rapid multimessenger follow-up: multitelescope management, team/group organizing interfaces, and crossmatching of multimessenger data streams with time-domain optical surveys, with interfaces sufficiently intuitive for newcomers to the field. This paper focuses on the detailed implementations, capabilities, and early science results that establish SkyPortal as a community software package ready to take on the data science challenges and opportunities presented by this next chapter in the multimessenger era.}
}

Stéfan J. van der Walt, Arien Crellin-Quick, Joshua S. Bloom, SkyPortal: An Astronomical Data Platform. Journal of Open Source Software, 4(37) 1247, May 2019. https://doi.org/10.21105/joss.01247.

@article{skyportal2019,
  author = {St\'efan J. van der Walt and Arien Crellin-Quick and Joshua S. Bloom},
  title = {{SkyPortal}: An Astronomical Data Platform},
  journal = {Journal of Open Source Software},
  volume = {4},
  number = {37},
  page = {1247},
  year = {2019},
  month = {may},
  doi = {10.21105/joss.01247},
  url = {http://joss.theoj.org/papers/10.21105/joss.01247}
}

Acknowledgements

We thank the Gordon and Betty Moore Foundation for a Software SkyPortal grant which partially covered the cost of the development of this project.