artistools
Artistools is collection of plotting, analysis, and file format conversion tools for the ARTIS radiative transfer code.
Installation
Requires Python >= 3.13
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" (or the short alias "at") at the command-line to get a full list of subcommands, and "artistools --version" to check the installed version. Some common commands are:
- artistools plotspectra (alias: at spec)
- artistools plotlightcurve (alias: at lc)
- artistools plotestimators (alias: at estimators)
- artistools plotnltepops
- artistools inputmodel describe
Use the -h option to get a list of command-line arguments for each subcommand. Set ARTISTOOLS_TRACEBACK=1 to get the full traceback of an error. 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.
1 maintainer
Metadata
1 maintainer
Release files for artistools 2026.9.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| artistools-2026.9.4.tar.gz | 8.4 MB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| artistools-2026.9.4-cp315-cp315t-manylinux_2_28_x86_64.whl | CPython 3.15 | CPython 3.15 free-threading | Linux glibc 2.28+ x86-64 | Details |
| artistools-2026.9.4-cp315-cp315t-manylinux_2_28_aarch64.whl | CPython 3.15 | CPython 3.15 free-threading | Linux glibc 2.28+ ARM64 | Details |
| artistools-2026.9.4-cp315-cp315t-macosx_13_0_arm64.whl | CPython 3.15 | CPython 3.15 free-threading | macOS 13.0+ ARM64 | Details |
| artistools-2026.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ x86-64 | Details |
| artistools-2026.9.4-cp314-cp314t-manylinux_2_28_aarch64.whl | CPython 3.14 | CPython 3.14 free-threading | Linux glibc 2.28+ ARM64 | Details |
| artistools-2026.9.4-cp314-cp314t-macosx_13_0_arm64.whl | CPython 3.14 | CPython 3.14 free-threading | macOS 13.0+ ARM64 | Details |
| artistools-2026.9.4-cp313-abi3-manylinux_2_28_x86_64.whl | CPython 3.13 | abi3 | Linux glibc 2.28+ x86-64 | Details |
| artistools-2026.9.4-cp313-abi3-manylinux_2_28_aarch64.whl | CPython 3.13 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| artistools-2026.9.4-cp313-abi3-macosx_13_0_arm64.whl | CPython 3.13 | abi3 | macOS 13.0+ ARM64 | Details |
Total release size: 139.8 MB
Release files / artistools-2026.9.4.tar.gz
| Download URL | artistools-2026.9.4.tar.gz |
|---|---|
| Size | 8.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f4c0853a2137659b4cfe5b3a142752cb1a37a2898780e6c65738a1e596ea54f8
|
|
BLAKE2b-256 checksum How to use checksums |
f0510ce59f05a412bf64c73d5f4b0ccef160aca3c742f25abc848d426d6dde3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp315-cp315t-manylinux_2_28_x86_64.whl
| Download URL | artistools-2026.9.4-cp315-cp315t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
d222e0c726e9b16ea3a3c071784e9a0e83359413cac2ca1e6dee44b801e3cf6d
|
|
BLAKE2b-256 checksum How to use checksums |
93fbc0aff797eece78c69b8f4b3cecdbc0806d14bd5009842c26e0ad91809414
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp315-cp315t-manylinux_2_28_aarch64.whl
| Download URL | artistools-2026.9.4-cp315-cp315t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.15 CPython 3.15 free-threading Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
8fadefebb8d5c31356c417c0d23d5316d242a1a75aba6ab172da97d53d6b5eca
|
|
BLAKE2b-256 checksum How to use checksums |
94637f6c84a06808a6b1bb65d3e2b0b22bdc74b4eb2cd96b5da8e3858d0a0177
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp315-cp315t-macosx_13_0_arm64.whl
| Download URL | artistools-2026.9.4-cp315-cp315t-macosx_13_0_arm64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.15 CPython 3.15 free-threading macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
f961d2cadb10d45687631a6e7b18dc1ee8f119402ab0911a99e81e1357f887fb
|
|
BLAKE2b-256 checksum How to use checksums |
0b2a5fc2d41a7efce07a70d098d571389029128bf5051ce06d51d3cee86aee88
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl
| Download URL | artistools-2026.9.4-cp314-cp314t-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
13a771ed63a2d5a333cd441f7db15438627e869ece12f5a19bd090510f652488
|
|
BLAKE2b-256 checksum How to use checksums |
d3bd0a430a3c0e29ab47f1896c14c03e18dfdcb016c6c2a386b78ea31bae1a98
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp314-cp314t-manylinux_2_28_aarch64.whl
| Download URL | artistools-2026.9.4-cp314-cp314t-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading Linux glibc 2.28+ ARM64 |
|
SHA-256 checksum How to use checksums |
3b0553c9ff7ea50eca3b389743a4b31df44b22568b38ffd2c9ce660c894a46f2
|
|
BLAKE2b-256 checksum How to use checksums |
bb99d60201724642370fa9fac9b90db3a483f5ba5016af18dc7062af913fbca3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp314-cp314t-macosx_13_0_arm64.whl
| Download URL | artistools-2026.9.4-cp314-cp314t-macosx_13_0_arm64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.14 CPython 3.14 free-threading macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
15c31b08b0b9c14170cce886b19e1cd883a916038307c23696520ff0413b9d4d
|
|
BLAKE2b-256 checksum How to use checksums |
01d7cc1a12927be1dd8a7dd36dbb8e53e36f69c01de6a305cf1bb8dac2928005
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp313-abi3-manylinux_2_28_x86_64.whl
| Download URL | artistools-2026.9.4-cp313-abi3-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a5e7e6c61e66bba18975e9f428461e0359bc8e59845ec8fe2a6cbca18226f29c
|
|
BLAKE2b-256 checksum How to use checksums |
2d1c86977e93084c9ddadc7aa617aa112215e295f8208e1cf59c47075af3ef44
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp313-abi3-manylinux_2_28_aarch64.whl
| Download URL | artistools-2026.9.4-cp313-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 15.3 MB |
| Tags | CPython 3.13 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
d821239721a9fee224c28de6b29f54b652d7de4e2ceb273f036b2c8489cbcefd
|
|
BLAKE2b-256 checksum How to use checksums |
0faa7bb41a2ea72153c5c7d83bce4af54ab79b23e321b3d5d71ed397074e2e41
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency logRelease files / artistools-2026.9.4-cp313-abi3-macosx_13_0_arm64.whl
| Download URL | artistools-2026.9.4-cp313-abi3-macosx_13_0_arm64.whl |
|---|---|
| Size | 13.2 MB |
| Tags | CPython 3.13 abi3 macOS 13.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
e4b7bf1f9838330aabd928c9098fefe58c7989400a614da0c8f2aaac7b164859
|
|
BLAKE2b-256 checksum How to use checksums |
27cbd5cc4a380e3401c245135e2a53aeab6102ccc5941469daef6e40fc7fd013
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 4, 2026.
Transparency log
