Open in Colab: https://colab.research.google.com/github/casangi/casadocs/blob/v6.5.3/docs/notebooks/carta.ipynb


CARTA

CARTA is the Cube Analysis and Rendering Tool for Astronomy, a new image visualization and analysis tool designed for the ALMA, the VLA, and the SKA pathfinders. As image sizes continue to increase with modern telescopes, viewing an image with a local image viewer or with a remote image viewer via the ssh protocol becomes less efficient. The mission of CARTA is to provide usability and scalability for the future by utilizing modern web technologies and computing parallelization.

Download and Installation (see https://cartavis.github.io/)

CARTA is a separate application and not directly integrated with CASA. Refer to the official CARTA website for download and installation instructions as well as a proper set of documentation.

Some advantages over the CASA Viewer (tasks imview and msview):

  • Much better performance, able to handle very large image cubes

  • Modern web browser based interface allowing local and remote display options.

  • Can display Stokes wedges.

  • Proper display of image headers

  • Flexibility to modify and save the layout

  • Supports new HDF5 image format (in addition to CASA Image, MIRIAD, and FITS)

  • Rotation support for regions

  • RMS display for spectra

  • Better image rendering widget

  • Better animation control

  • Gzip image display

Subsequent releases of CARTA will continue to enhance CARTA’s performance. For a full overview of the current and upcoming features, see the official CARTA website.

cartadisplaylight

CARTA is developed by the Academia Sinica Institute of Astronomy and Astrophysics (ASIAA), the Inter-University Institute for Data Intensive Astronomy (IDIA), the National Radio Astronomy Observatory (NRAO), and the Department of Physics, University of Alberta.

Remaining Capability Gaps

Note: CARTA does not yet offer an exact replacement for every feature in the old CASA Viewer (tasks imview and msview). Many things are complete, and CARTA offers a good deal of enhanced functionality over the imview task, but a small subset of things may still be missing.

Some remaining features of the CASA Viewer that are not yet in CARTA and either under development for CARTA v.4, or planned for a future CARTA version:

  • Complete set of fitting tools (under development)

  • Image annotation (under development)

  • Multi-channel plots (under development)

  • Save and reload states (under development)

  • Sharing of states (under development)

  • Support for AIPS files with beam in HISTORY (under development)

  • Source finder tool (planned)

  • Profile annotation (planned)

  • Rotated cube view (planned)

  • Scalable output (SVG ir PDF) (planned)

  • Regions that extend across spectral and stokes planes (planned)

  • Histogram fitting (planned)

  • Full support CRTF (not available in CASA Viewer) (planned)

Interactive Clean

The CASA Viewer serves as both a stand-alone analysis platform for image artifacts, as well as an interactive front-end to control CASA execution (via interactive clean).

CARTA is focused on providing image analysis to a wide variety of groups and organizations, some of which are not affiliated with CASA or only have access to the output images. Integrating CASA and CARTA together through interactive clean control would not be efficient.

Instead, the CASA team is developing a separate interactive control interface for users of CASA. This interface will include interactive clean unified with other widgets in the CASA suite related to runtime execution, status, and control. This interface will not duplicate CARTA analysis functionality and is intended to be used in conjunction with CARTA for image viewing. More details will be provided as development progresses.

MS View

The CASA Viewer is also able to open MeasurementSet format files for raster display and flagging of visibility data. CARTA will focus solely on image format files (including FITS and HDF5). The CASA team is working to migrate MS view and PlotMS to a new unified MeasurementSet plotting and analysis utility. More details will be provided as development progresses.


Using CARTA with CASA

The CARTA Website provides download links for CARTA on a variety of platforms and usage types. CARTA is intended for more than just CASA usage and supports installation within large data warehouses and archives.

Refer to the CARTA installation and configuration instructions for more information.

Personal laptops or workstations

Many users expect to run CARTA alongside a CASA instance to view the products produced by CASA. The Stand-alone application version of CARTA is intended for this purpose.

If you are running CASA on your own laptop or workstation that you are directly using (so the machine where the data reside is the same that will render the visualization), then simply downloading and executing the Stand-alone application version of CARTA for your OS is sufficient.

Clusters

If you are running CASA or viewing data products on a cluster, you should have a site deployment of CARTA configured by your system administrator. This is a single CARTA instance that is always running at a fixed URL and allows users to connect with their institution login credentials.

Note that the stand-alone application version of CARTA may work on a cluster through ssh/VNC with the --no_browser option discussed in the next section, but the site deployment version is the intended distribution for this type of usage.


Running CARTA at NRAO

Instructions for users within the NRAO network or with an NRAO account.

Warning: The default Firefox installation on some NRAO machines may not support the WebGL version of CARTA. Try Chrome or contact the helpdesk for an updated version of Firefox

Remotely Connecting to an NRAO Workstation or Cluster

You can invoke the stand-alone installation of carta by using the --no_browser switch:

  • via VPN

  1. Connect your home computer to the NRAO VPN

  2. (Optional) Reserve a cluster node in the usual manner

  3. $ ssh <username>@your_cluster_node or $ ssh <username>@your_workstation from your home computer, or from a terminal in a remote VNC or fastx desktop display

  4. from the ssh or VNC/fastx terminal, (optional) cd to the directory where the data you want to visualize live and (not optional) type one of the following:

    • $ carta --no_browser

    • $ APPIMAGE_EXTRACT_AND_RUN=1 carta --no_browser

    This starts the CARTA backend on the remote machine and prints a link to the terminal

  5. Copy the link printed to the screen to a web browser opened on your home computer (not a web browser within your VNC or fastx display).

  • via ssh tunneling

To invoke the stand-alone installation of carta through ssh, use the following instructions:

  1. (Optional) Reserve a cluster node in the usual manner

  2. $ ssh username@ssh.aoc.nrao.edu (for NM)

    $ ssh username@polaris.cv.nrao.edu (for CV)

  3. $ ssh your_cluster_node (e.g., ssh nmpost43 or cvpost002)

  4. cd to the directory where the data you want to visualize live and (not optional) type the following:

    • $ carta --no_browser

  5. Get the following line:

    [info] CARTA is accessible at http://10.64.10.143:3002/?token=052680c2-b602-4d8d-9ac4-e4cb1120f56b

  6. Pick the port number from the URL above (here: 3002) then, in a new terminal:

    $ ssh -N username@ssh.aoc.nrao.edu -L 3002:nmpost043.aoc.nrao.edu:3002 (for NM and example nmpost043)

    $ ssh -N username@polaris.cv.nrao.edu -L 3002:cvpost002.cv.nrao.edu:3002 (for CV and example cvpost002)

  7. Then, in a local browser, replace the URL but not port to ‘localhost’:

    $ http://localhost:3002/?token=052680c2-b602-4d8d-9ac4-e4cb1120f56b

NOTE: Using the CARTA stand-alone application version through VNC or fastx without the –no_browser option may not work or will lead to significantly diminished performance (since it bypasses CARTA’s graphics acceleration features). While this is how one would typical use the CASA viewer or DS9, this is not how CARTA is designed to be used.

NOTE: Many NRAO desktops here have 2 ethernet cards, one for the normal internet and another for a direct connection to the cluster. When starting carta —no_browser, it comes up with an URL, but it is not always the URL of the internet but sometimes the URL for the cluster ethernet card. Since that is not accessible from the internet, the star of CARTA fails.

The problem can be identified when the IP address in the CARTA URL come up starting 192.xxx, e.g.

http://192.168.101.137:3002/?token=b452a313-d27a-4dd5-9175-d4c463324750

CARTA will not start with the URL as it points to the cluster.

To find the IP address of the internet card, ping the desktop, e.g.

ping rocky PING rocky.aoc.nrao.edu (146.88.3.222) 56(84) bytes of data.

(Another way is to run ‘ifconfig’ and check the output.)

Then, replace the IP address in the CARTA link by the IP address from ping, leaving the rest of the URL intact

http://146.88.3.222:3002/?token=b452a313-d27a-4dd5-9175-d4c463324750

That is the one to be used for CARTA