Skip to content

Latest commit

 

History

History
71 lines (52 loc) · 3.36 KB

README.rst

File metadata and controls

71 lines (52 loc) · 3.36 KB

icons/radiopadre-logo-long-400px.png?raw=True

Python (Radio) Astronomy Data & Results Examiner

Radiopadre is a Jupyter notebook framework for quick and easy visualization of [radio astronomy, primarily] data products and pipelines.

Radiopadre includes integration with JS9 and CARTA for live FITS viewing of [remote] FITS files straight from your browser. (In boldface, because this is a pretty neat capability to have!)

Radiopadre is a custom Jupyter kernel, so in principle you could install it and create radiopadre notebooks directly from a Jupyter session. Some of the tight integration with JS9 and CARTA, however, works smoother if you start your sessions via the run-radiopadre client script, which takes care of starting up and stopping appropriate helper processes and such.

The general use case for Radiopadre is "here I am sitting with a slow ssh connection into a remote cluster node, my pipeline has produced 500 plots/logs/FITS images, how do I make sense of this mess?" More specifically, there are three (somewhat overlapping) scenarios that Radiopadre is designed for:

  • Just browsing: interactively exploring the aforementioned 500 files using a notebook.
  • Automated reporting: customized Radiopadre notebooks that automatically generate a report composed of a pipeline's outputs and intermediate products. Since your pipeline's output is (hopefully!) structured, i.e. in terms of filename conventions etc., you can write a notebook to exploit that structure and make a corresponding report automatically.
  • Sharing notebooks: fiddle with a notebook until everything is visualized just right, insert explanatory text in mardkdown cells in between, voila, you have an instant report you can share with colleagues.

Usage, in a nutshell

See radiopadre-client package.

Tutorial

For a quick tutorial on radiopadre, download the tutorial_package, untar, and run radiopadre inside the resulting directory, locally or remotely (you can also refer to the PDF enclosed in the tarball for a poor man's rendering of the notebook).