FEATRUES

CARTA key features

CARTA adopts a client-server architecture which is suitable for visualizing images with large file sizes (GB to TB) easily obtained from ALMA, VLA, or SKA pathfinder observations. It is impractical to process such a huge file with a personal computer or laptop. In a client-server architecture, computation and data storage are handled by remote enterprise-class servers or clusters with high performance storage, while processed products are sent to clients only for visualization with modern web features, such as GPU-accelerated rendering. This architecture also enables users to interact with the ALMA and VLA science archives by using CARTA as an interface.

CARTA has two flavors: Desktop version and Server version. The former is suitable for single-user usage with a laptop, a desktop, or a remote server in the "remote" execution mode. The later is suitable for institution-wide deployment to support multiple users with user authentication and addtional server-side features.

Memory-efficient when loading images

With ~1 GB of ram, a 16000 pixel x 16000 pixel image or a 16000 pixel x 16000 pixel x 1000 channel cube (~1 TB in size) can be loaded in seconds.

Parallelization and GPU-accelerated rendering

Parallelization with CPUs is invoked in data processing. GPU-accelerated rendering is adopted for tiled raster images, contour images, and catalog overlays.

Spectral line cube analysis tools

Flexible multi-profile plotting capability is supported. Analysis tools such as profile fitting, profile smoothing, moment map generator, and spectral line query and labelling are out of box.

Customizable and reusable GUI layouts and preferences

CARTA is equipped with a highly customizable and reusable graphical user interface for various use cases.

Efficient catalog processing and rendering

Catalogs with millions of sources can be loaded and rendered in seconds. Catalog files are processed with parallelization techniques and are rendered with GPU acceleration.

Efficient visualization with HDF5 (IDIA schema) images

The HDF5 format with the IDIA schema improves the user's experience of viewing large image cubes significantly.

ROADMAP

Release plan

Current release

The current release is v2.0, released on 7th of June 2021, with the following features:

  • Multi-profile plot with the spectral profiler
  • Progress report and cancellation when requesting a long file list
  • Forming a Stokes hypercube at image loading stage
  • Colorbar display in the image viewer and enhanced raster image config widget
  • Support rectangular pixel rendering for PV image
  • Filtering function in the spectral line query widget
  • Enhanced FITS and CASA image support
  • Saving subimage
  • Searching a keyword from image header
  • Profile fitting in the spectral profiler
  • Marker-based catalog rendering and performance enhancement
  • New deployment modes

Next release

The next release will be v3.0. The planned main new features:

  • Multiple-panel view
  • Enhancement of polarization visualization
  • Position-Velocity map generator
  • Publication quality export
  • 2D image fitting
  • Python3 scripting interface (continuous efforts)

Future release

This is a non-exclusive list of features we would like to add in subsequent releases, but they are not 100% decided upon yet and depend on feedback from users, resourcing etc.:

  • Polarization contour and images
  • Multi-panel view
  • Channel map view
  • Position-velocity map generator
  • Server collaborative tools
  • Vector field (polarization) rendering
  • Volume (pseudo 3D) rendering
  • Profile, histogram, and image fitting tools
  • Scripting interface (Python3)
  • Three-color blender
  • Angular distance measuring tool
  • Image source finder
  • VO service (image and catalog)
  • Image arithmetic

INSTALLATION

Obtaining CARTA

v2.0

Supported operating systems:

  • Ubuntu Linux: 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa)
  • Red Hat Enterprise Linux: 7, 8
  • macOS: 10.15 (Catalina), 11 (Big Sur)

To deploy CARTA at your institution as a web-based application for multiple users, please refer to the CARTA controller documentation.

To start CARTA, please refer to the user manual How to Run CARTA.

Ubuntu 18.04 and 20.04 packages are available from our PPA.

sudo add-apt-repository ppa:cartavis-team/carta
sudo apt-get update
sudo apt install carta

To start CARTA, please refer to the user manual How to Run CARTA.

For Red Hat Enterprise Linux 7 users, you first need to add the el7 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el7.repo --output /etc/yum.repos.d/cartavis.repo
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum -y install carta

To start CARTA, please refer to the user manual How to Run CARTA.

For CentOS7 users, you first need to add the el7 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el7.repo --output /etc/yum.repos.d/cartavis.repo
sudo yum -y install epel-release
sudo yum -y install carta

To start CARTA, please refer to the user manual How to Run CARTA.

For Red Hat Enterprise Linux 8 users, you first need to add the el8 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el8.repo --output /etc/yum.repos.d/cartavis.repo
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo yum -y install carta

To start CARTA, please refer to the user manual How to Run CARTA.

For CentOS8 users, you first need to add the el8 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el8.repo --output /etc/yum.repos.d/cartavis.repo
sudo dnf -y install 'dnf-command(config-manager)'
sudo dnf -y install epel-release
sudo dnf -y config-manager --set-enabled powertools
sudo dnf -y install carta

To start CARTA, please refer to the user manual How to Run CARTA.

We officially support macOS 10.15 Catalina and macOS 11.0 Big Sur through Homebrew.

If you do not already have it, you may install Homebrew using the following command (root access is required):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Now CARTA can be installed with:
brew install cartavis/tap/carta

To start CARTA, please refer to the user manual How to Run CARTA.

The traditional macOS Electron Desktop version can be downloaded by clicking the download button below.
If you use an M1 based Mac, you may see better performance with the native Apple Silicon version of CARTA available here.

Installation:
Click the download button below. After downloading, open the DMG installer and drag the CARTA icon to the Applications folder.
Operation:
Click the CARTA icon in the Launchpad.

Alternatively, you may create an alias for starting CARTA in your terminal.
Here is an example:
Open your ~/.zshrc file (or ~/.bashrc if you use bash) in a text editor and add the following line:
alias carta='/Applications/CARTA.app/Contents/MacOS/CARTA'
Then enter source ~/.zshrc (or source ~/.bashrc) in the terminal.
Now you will be able to start CARTA by simply typing carta in the terminal.
DOWNLOAD

The Ubuntu Linux AppImage does not require root access. You simply download, extract, and run it. It uses your default web browser to display the CARTA graphical interface. The AppImage has been tested to run on Ubuntu 18.04 and 20.04.

Installation:
Either click the Download button below or run:
wget https://github.com/CARTAvis/carta/releases/download/v2.0/CARTA-v2.0-ubuntu.tgz
Extract the tarball:
tar -xzf carta-v2.0-ubuntu.tar.gz
Operation:
To start CARTA, please refer to the user manual How to Run CARTA.

Note: If you wish to run the AppImage inside a Docker container, or you system has trouble with FUSE, please prefix with the following environment variable:
APPIMAGE_EXTRACT_AND_RUN=1 ./carta-v2.0-ubuntu.AppImage
DOWNLOAD

The Red Hat Linux AppImage does not require root access. You simply download, extract, and run it. It uses your default web browser to display the CARTA graphical interface. The AppImage has been tested to run on Red Hat Enterprise Linux (RHEL) 7 and 8, as well as CentOS 7 and 8.

Installation:
Either click the Download button below or run:
wget https://github.com/CARTAvis/carta/releases/download/v2.0/CARTA-v2.0-redhat.tgz
Extract the tarball:
tar -xzf carta-v2.0-redhat.tar.gz
Operation:
To start CARTA, please refer to the user manual How to Run CARTA.

Note: If you wish to run the AppImage inside a Docker container, or you system has trouble with FUSE, please prefix with the following environment variable:
APPIMAGE_EXTRACT_AND_RUN=1 ./carta-v2.0-redhat.AppImage
DOWNLOAD

For more information, please refer to the user manual.

In case of any issues encountered during the installation, please contact the CARTA helpdesk.

To obtain previous release versions, please refer to https://github.com/CARTAvis/carta/releases.


v3.0-beta1b

Supported operating systems:

  • Ubuntu Linux: 18.04 LTS (Bionic Beaver), 20.04 LTS (Focal Fossa)
  • Red Hat Enterprise Linux: 7, 8
  • macOS: 10.15 (Catalina), 11 (Big Sur)

To deploy CARTA at your institution as a web-based application for multiple users, please refer to the CARTA controller documentation.

To start CARTA, please refer to the user manual How to Run CARTA.

Ubuntu 18.04 and 20.04 packages are available from our PPA.

sudo add-apt-repository ppa:cartavis-team/carta-testing
sudo apt-get update
sudo apt install carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

For Red Hat Enterprise Linux 7 users, you first need to add the el7 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el7.repo --output /etc/yum.repos.d/cartavis.repo
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo yum remove carta carta-frontend carta-backend # if you have installed CARTA v2.0 before
sudo yum -y install carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

For CentOS7 users, you first need to add the el7 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el7.repo --output /etc/yum.repos.d/cartavis.repo
sudo yum -y install epel-release
sudo yum remove carta carta-frontend carta-backend # if you have installed CARTA v2.0 before
sudo yum -y install carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

For Red Hat Enterprise Linux 8 users, you first need to add the el8 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el8.repo --output /etc/yum.repos.d/cartavis.repo
sudo rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
sudo yum remove carta carta-frontend carta-backend # if you have installed CARTA v2.0 before
sudo yum -y install carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

For CentOS8 users, you first need to add the el8 'cartavis' and EPEL repositories. Please note that root access is required, unless you install in a Docker container.

sudo curl https://packages.cartavis.org/cartavis-el8.repo --output /etc/yum.repos.d/cartavis.repo
sudo dnf -y install 'dnf-command(config-manager)'
sudo dnf -y install epel-release
sudo dnf -y config-manager --set-enabled powertools
sudo yum remove carta carta-frontend carta-backend # if you have installed CARTA v2.0 before
sudo dnf -y install carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

We officially support macOS 10.15 Catalina and macOS 11.0 Big Sur through Homebrew.

If you do not already have it, you may install Homebrew using the following command (root access is required):
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Now CARTA can be installed with:
brew install cartavis/tap/carta-beta

To start CARTA, please refer to the user manual How to Run CARTA.

The traditional macOS Electron Desktop version can be downloaded by clicking the download button below.
If you use an M1 based Mac, you may see better performance with the native Apple Silicon version of CARTA available here.

Installation:
Click the download button below. After downloading, open the DMG installer and drag the CARTA-v3.0.0-beta.1b icon to the Applications folder.
Operation:
Click the CARTA-v3.0.0-beta.1b icon in the Launchpad.

Alternatively, you may create an alias for starting CARTA in your terminal.
Here is an example:
Open your ~/.zshrc file (or ~/.bashrc if you use bash) in a text editor and add the following line:
alias carta='/Applications/CARTA-v3.0.0-beta.1b.app/Contents/MacOS/CARTA-v3.0.0-beta.1b'
Then enter source ~/.zshrc (or source ~/.bashrc) in the terminal.
Now you will be able to start CARTA by simply typing carta in the terminal.
DOWNLOAD

The Ubuntu Linux AppImage does not require root access. You simply download, extract, and run it. It uses your default web browser to display the CARTA graphical interface. The AppImage has been tested to run on Ubuntu 18.04 and 20.04.

Installation:
Either click the Download button below or run:
wget https://github.com/CARTAvis/carta/releases/download/v3.0.0-beta.1b/CARTA-v3.0.0-beta.1b-ubuntu.tgz
Extract the tarball:
tar -xzf CARTA-v3.0.0-beta.1b-ubuntu.tgz
Operation:
To start CARTA, please refer to the user manual How to Run CARTA.

Note: If you wish to run the AppImage inside a Docker container, or you system has trouble with FUSE, please prefix with the following environment variable:
APPIMAGE_EXTRACT_AND_RUN=1 ./CARTA-v3.0.0-beta.1b-ubuntu.AppImage
DOWNLOAD

The Red Hat Linux AppImage does not require root access. You simply download, extract, and run it. It uses your default web browser to display the CARTA graphical interface. The AppImage has been tested to run on Red Hat Enterprise Linux (RHEL) 7 and 8, as well as CentOS 7 and 8.

Installation:
Either click the Download button below or run:
wget https://github.com/CARTAvis/carta/releases/download/v3.0.0-beta.1b/CARTA-v3.0.0-beta.1b-redhat7.tgz
wget https://github.com/CARTAvis/carta/releases/download/v3.0.0-beta.1b/CARTA-v3.0.0-beta.1b-redhat8.tgz
Extract the tarball:
tar -xzf CARTA-v3.0.0-beta.1b-redhat7.tgz
tar -xzf CARTA-v3.0.0-beta.1b-redhat8.tgz
Operation:
To start CARTA, please refer to the user manual How to Run CARTA.

Note: If you wish to run the AppImage inside a Docker container, or you system has trouble with FUSE, please prefix with the following environment variable:
APPIMAGE_EXTRACT_AND_RUN=1 ./CARTA-v3.0.0-beta.1b-redhat7.AppImage
APPIMAGE_EXTRACT_AND_RUN=1 ./CARTA-v3.0.0-beta.1b-redhat8.AppImage
DOWNLOAD-RedHat7 DOWNLOAD-RedHat8

For more information, please refer to the beta release quick guide.

In case of any issues encountered during the installation, please contact the CARTA helpdesk.