artistools 2026.5.28

Plotting and analysis tools for the ARTIS 3D radiative transfer code for supernovae and kilonovae.

artistools

Artistools is collection of plotting, analysis, and file format conversion tools for the ARTIS radiative transfer code.

Installation

Requires Python >= 3.12

The artistools command can be invoked with uvx artistools (after installing uv), installed globally with uv tool install artistools, or installed into your environment with pip install artistools.

Development (editable installation)

For development, you will need a rust compiler and a clone of the repository:

git clone https://github.com/artis-mcrt/artistools.git
cd artistools

To make the artistools command available using an isolated uv virtual environment, run:

uv tool install --editable .[extras]
prek install

Alternatively, to avoid uv and install into the system environment with pip:

pip install --group dev --editable .[extras]
prek install

To learn how to enable command-line autocompletions, run:

artistools completions

Citing artistools

If you artistools for a paper or presentation, please cite it. For details, see https://zenodo.org/badge/latestdoi/53433932.

Usage

Run "artistools" at the command-line to get a full list of subcommands. Some common commands are:

• artistools plotspectra
• artistools plotlightcurve
• artistools plotestimators
• artistools plotnltepops
• artistools describeinputmodel

Use the -h option to get a list of command-line arguments for each subcommand. Most of these commands should be run either within an ARTIS simulation folder or by passing the folder path as the last argument.

Example output

License

Distributed under the MIT license. See LICENSE for more information.

https://github.com/artis-mcrt/artistools