FEATURES
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 v5.0-stable
The current release is v5.0, released on 29th of July 2025, with the following feature highlights:
- Channel map view (raster only)
- Multi-color image blending
- HiPS2FITS online image query
- Dynamic layout
- Image coordinate and flexible offset coordinate
- PV generator with a polyline region
- New design of the in-app help and user manual
- Enable the copy function in the cursor info widget
- Support flux density calculations with various pixel units in the statistics widget
- Support automatic generation of initial values for multiple Gaussian image fitting
- Support sorting the spectral line table
- support changing the depth order of floating widget and dialog on select
- A button for deleting all regions
- Support setting a custom rest frequency for the moment maps
- Support wavelength^2 as a new spectral convention
- Support plotting catalog sources with a size in image pixel and in angular units
- Bug fix
- Performance improvement
- Codebase maintenance library update
Next release v6-beta
The next beta release will be v6.0-beta with the following major features
- Full support of channel map view
- Volumetric (pseudo 3D) rendering
- Full support of workspace
- Full support of workspace sharing (carta-controller only)
- Collaboration tools (carta-controller only)
- Initial support for time-domain astronomy tools
- Initial support of the Python scripting interface
- VO services
Future releases v7+
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.:
- TBD
INSTALLATION
Obtaining CARTA
v5.0
Supported operating systems:
- Ubuntu Linux: 22.04 LTS (Jammy Jellyfish), 24.04 LTS (Noble Numbat) for amd64 and aarch64 architectures.
- Red Hat Enterprise Linux (or equivalent community distributions): 8 and 9 for x86_64 and aarch64 architectures.
- macOS: 14 (Sonoma), and 15 (Sequoia) for Intel and Apple Silicon architectures. Earlier versions may work but are not tested.
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 22.04 and 24.04 packages are available from our PPA. Our packages may also work on other distributions based on these Ubuntu releases.
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.
Note: The carta-beta
package is updated with intermediate preview releases as
well as official releases. Users may install this package instead if
they wish to receive these updates,
and users who already have carta-beta
installed may update their
existing package now to obtain this release:
sudo apt-get update
sudo apt install carta-beta
We host the CARTA RPMs on the Fedora Copr service. Our packages should work on RHEL or the equivalent community distributions (like AlmaLinux or RockyLinux).
Follow these steps to add the Copr repository and install CARTA (root access is required):
sudo dnf -y install 'dnf-command(copr)'
sudo dnf -y copr enable cartavis/carta
sudo dnf -y install epel-release
sudo dnf -y install carta
To start CARTA, please refer to the user manual: How to Run CARTA.
We officially support macOS 14 (Sonoma) and macOS 15 (Sequoia) through Homebrew. Earlier macOS versions may work, but are not tested.
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 update
brew install --cask cartavis/tap/carta
To start CARTA, please refer to the user manual: How to Run CARTA.
You can download the CARTA Electron Desktop app for macOS by clicking the appropriate download button below. We provide an x86_64 version for Intel-based Macs and an arm64 version for Apple Silicon-based Macs.
After downloading, open the DMG installer and drag the CARTA icon to the Applications folder.
To launch CARTA, click the CARTA icon in the Launchpad. Alternatively, you may create an alias for starting CARTA in your terminal. For 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 simply by typing carta
in the terminal.
The CARTA 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 can run universally on Ubuntu and RedHat platforms (and should also work on other distributions), but there are separate versions for the x86_64 and aarch64 architectures.
Either click on one of the download buttons below, or run: wget https://github.com/CARTAvis/carta/releases/latest/download/carta.AppImage.$(arch).tgz
Extract the tarball: tar -xzf carta.AppImage.$(arch).tgz
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 your system has trouble with FUSE, please prefix with the following environment variable:
APPIMAGE_EXTRACT_AND_RUN=1 ./carta-x86_64.AppImage
CARTA is available in the form of a Docker container from Docker Hub. This version can be used to run CARTA on unsupported platforms such as macOS 10.14.
With Docker installed and running on your system, simply enter the following command in your terminal:
docker run --rm -ti -p 3002:3002 -v $PWD:/images -v $HOME/.carta:/home/cartauser/.carta cartavis/carta:latest
This will download the latest version of CARTA from Docker Hub and run it using your
current directory ($PWD
) in the CARTA file-browser. A unique URL will be
displayed in the terminal.
Copy & Paste the unique URL into your local web browser in order to access the CARTA
frontend interface.
Please refer to the user manual for more information: How to Run CARTA.
Please refer to the release note for feature highlights.
Known critical bugs: frontend, backend, controller
Known bugs: frontend, backend, controller
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.
ABOUT
Project information
CARTA publications
Journal
Development and application of an HDF5 schema for SKA-scale image cube
visualization
Proceedings and others
CARTA: Cube Analysis and Rendering Tool for Astronomy
CARTA: Cube Analysis and Rendering Tool for Astronomy
CARTA: Cube Analysis and Rendering Tool for Astronomy
CARTA: Cube Analysis and Rendering Tool for Astronomy
The
ALMA Science Archive Reaches a Major Milestone
Codebase
CARTA is mainly built in C++, TypeScript, and JavaScript, and with the following third-party libraries. Check out the codebase on Github.
- AST: http://starlink.eao.hawaii.edu/starlink/AST
- Blueprint: https://blueprintjs.com
- casacore: https://casacore.github.io
- CASA source code: https://casa.nrao.edu/index.shtml
- Chart.js: https://www.chartjs.org
- Electron: https://electronjs.org
- GoldenLayout: https://golden-layout.com
- GSL: https://www.gnu.org/software/gsl
- MobX: https://mobx.js.org
- MongoDB: https://www.mongodb.com
- node.js: https://nodejs.org
- Plotly: https://plotly.com
- Protocol buffers: https://developers.google.com/protocol-buffers
- Pugixml: https://pugixml.org
- React: https://reactjs.org
- spdlog: https://github.com/gabime/spdlog
- sse2neon: https://github.com/DLTcollab/sse2neon
- uWebsockets: https://github.com/uNetworking/uWebSockets
- WebAssembly: https://webassembly.org
Citation
Please use the DOI 10.5281/zenodo.3377984 as a citation when using CARTA for publications.