Skip to main content

artistools

DOI PyPI - Version License

Supported Python versions Installation and pytest codecov

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 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

Emission plot NLTE plot Estimator plot

License

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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

artistools-2026.8.20.2.tar.gz (8.3 MB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_x86_64.whl (15.2 MB view details)

Uploaded CPython 3.15tmanylinux: glibc 2.28+ x86-64

artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_aarch64.whl (15.2 MB view details)

Uploaded CPython 3.15tmanylinux: glibc 2.28+ ARM64

artistools-2026.8.20.2-cp315-cp315t-macosx_13_0_arm64.whl (13.1 MB view details)

Uploaded CPython 3.15tmacOS 13.0+ ARM64

artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_x86_64.whl (15.2 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ x86-64

artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_aarch64.whl (15.2 MB view details)

Uploaded CPython 3.14tmanylinux: glibc 2.28+ ARM64

artistools-2026.8.20.2-cp314-cp314t-macosx_13_0_arm64.whl (13.1 MB view details)

Uploaded CPython 3.14tmacOS 13.0+ ARM64

artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_x86_64.whl (15.2 MB view details)

Uploaded CPython 3.13+manylinux: glibc 2.28+ x86-64

artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_aarch64.whl (15.2 MB view details)

Uploaded CPython 3.13+manylinux: glibc 2.28+ ARM64

artistools-2026.8.20.2-cp313-abi3-macosx_13_0_arm64.whl (13.1 MB view details)

Uploaded CPython 3.13+macOS 13.0+ ARM64

File details

Details for the file artistools-2026.8.20.2.tar.gz.

File metadata

  • Download URL: artistools-2026.8.20.2.tar.gz
  • Upload date:
  • Size: 8.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for artistools-2026.8.20.2.tar.gz
Algorithm Hash digest
SHA256 7c23772fb0bbe143466b0be153f50238dad5bd2036d19b1f6397a96aeb7c1f9a
MD5 a3117d4239edbc2f6a1f9a24afb1a685
BLAKE2b-256 b0ffe775011fa606bd03a0b6afee43746efc59dfd43a0a4e81cbf428a364722d

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2.tar.gz:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 ee5541845e9193f24c237d16f5303ffcc2ba42de7b2727d82f99a08fd7c10d3f
MD5 87f52af82c2441110abb82c71b445c8e
BLAKE2b-256 419330754d031e55cb0c5a7359c9583a6f60e093534b926dd45964d5e337965a

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_x86_64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 634225e8309ebab2dfb94af9865ed0119e2793db2f8f179e6f193de892f4883b
MD5 c807a9cc50a0623e033abe6d72594eec
BLAKE2b-256 f8793476c37c11518599bb40abd6a07910a971e569124c9b0711a27411303260

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp315-cp315t-manylinux_2_28_aarch64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp315-cp315t-macosx_13_0_arm64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp315-cp315t-macosx_13_0_arm64.whl
Algorithm Hash digest
SHA256 1371b9e885814e1cd873ffbf0999b1e7f4ca0b399f459b7b252328799daf0fb2
MD5 d21e685941320585445b73aec049bfdc
BLAKE2b-256 c0af4f1738f1c1a2475bd0a972ed8a86ee57d84dd2854483e1ef2109c650bfae

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp315-cp315t-macosx_13_0_arm64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 341d80bdbe8be07a8fb4398e3a6c79ac917b1b39ab76b8bcbed42b73f311513b
MD5 5afc96b8856e65aff24ee0baedf72df8
BLAKE2b-256 a470c327d809ed95d24f47e332f04d1f58599244e869e0077696aa92f02c5990

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_x86_64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 796b5b66a512f05bba9eacfa817dc76b7011e923ce879f8524f718cac3979952
MD5 326dd6a7071f612a0d28fe40c4657954
BLAKE2b-256 47a9043c691f04333f6a135cb094029fbc982456a32007426e6837904268450c

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp314-cp314t-manylinux_2_28_aarch64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp314-cp314t-macosx_13_0_arm64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp314-cp314t-macosx_13_0_arm64.whl
Algorithm Hash digest
SHA256 cf3b161c4f2c2f2f58e53b2e8574a49a94ddc447d55968138a87c5725424337a
MD5 d731f075411117e9acc532b957aa025d
BLAKE2b-256 23f2a4ddc3841900ea716df72c242f1d402a6ac6e559a9c68bf2637f2787ab78

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp314-cp314t-macosx_13_0_arm64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 cd0a8128bcf20b01eefa17385b7ea2d099040d12ca0fb491b4c5d6b93ee44077
MD5 260bab134ae6191be9d5bbf560530345
BLAKE2b-256 771f68107ca05913a5066db6e79fe45155d44d69604dddd0f0cfa20b3d9ca719

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_x86_64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 2bf10e7891ceacb2359b3b2ffe5dc4301118b1cdaba080974b75838dc987c23c
MD5 ecb5824e02d59878df8295760b2f7f0d
BLAKE2b-256 5bb7e0c049aa1a6a0dff6a801b75acb3cf85d9ee457e0e548c2d20ffc167e261

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp313-abi3-manylinux_2_28_aarch64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file artistools-2026.8.20.2-cp313-abi3-macosx_13_0_arm64.whl.

File metadata

File hashes

Hashes for artistools-2026.8.20.2-cp313-abi3-macosx_13_0_arm64.whl
Algorithm Hash digest
SHA256 0d098af58766633f1a7ca328f5a737a805f6704d1e73f87643f2b9e00511579a
MD5 0ae20dd4397d360d4b4b771521c95520
BLAKE2b-256 2fc0c226167c7f0a2aa0fee8fe804c2cf23a7f657d7c80dfd7cecbcf011f66e5

See more details on using hashes here.

Provenance

The following attestation bundles were made for artistools-2026.8.20.2-cp313-abi3-macosx_13_0_arm64.whl:

Publisher: deploypypi.yml on artis-mcrt/artistools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2026.8.21

10 files

This release

2026.8.20.2 This release

10 files

2026.8.20

10 files

2026.8.8

10 files

2026.8.5

10 files

2026.7.18

7 files

2026.6.18

13 files

2026.6.1

13 files

2026.5.31

13 files

2026.5.28

13 files

2026.5.9

13 files

2026.4.20

13 files

2026.4.14

13 files

2026.3.3

16 files

2026.2.17

16 files

2026.2.13

16 files

2025.11.6.4

16 files

2025.11.6.3

16 files

2025.11.6.2

16 files

2025.11.6.1

16 files

2025.11.6

16 files

2025.10.13

16 files

2025.10.7

16 files

2025.9.27.2

16 files

2025.9.27.1

16 files

2025.9.27

16 files

2025.9.19.1

16 files

2025.9.19

16 files

2025.9.4

19 files

2025.8.7

19 files

2025.7.24

16 files

2025.6.8

4 files

2025.5.21

4 files

2025.4.15

4 files

2025.3.31

4 files

2025.3.12

4 files

2025.3.7

4 files

2025.1.23

4 files

2025.1.7

4 files

2024.12.9

4 files

2024.12.6

4 files

2024.10.28

4 files

2024.9.12

4 files

2024.7.4.2

4 files

2024.7.4.1

4 files

2024.7.4

4 files

2024.6.17.1

16 files

2024.6.8

2 files

2024.4.29.1

2 files

2024.4.29

2 files

2024.4.23

2 files

2024.2.22.2

2 files

2024.2.22

2 files

2024.2.20.2

2 files

2024.2.20

2 files

2024.2.17

2 files

2023.8.30

2 files

2023.8.21.3

2 files

2023.8.21.2

2 files

2023.8.21.1

2 files

2023.8.21

2 files

2023.8.1

2 files

2023.5.16.3

2 files

2023.5.16.2

2 files

2023.5.16

2 files

2023.4.19.2

2 files

2023.4.19

2 files

2022.8.23

2 files

2022.4.4

2 files

2021.4.23

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page