Data

Tools

Indexes

Applications

Experiments

Open Source Science

artistools

Plotting and analysis tools for ARTIS simulations

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

Science Score: 64.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ✓
    CITATION.cff file
    Found CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ✓
    Academic publication links
    Links to: zenodo.org
  • ✓
    Committers with academic emails
    2 of 11 committers (18.2%) from academic institutions
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (16.5%) to scientific vocabulary

Keywords

kilonovae monte-carlo-simulation python python-package spectra supernovae

Keywords from Contributors

battery interpretability standardization hack
Last synced: 6 months ago · JSON representation ·

Repository

Plotting and analysis tools for ARTIS simulations

Basic Info
  • Host: GitHub
  • Owner: artis-mcrt
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 59.6 MB
Statistics
  • Stars: 14
  • Watchers: 4
  • Forks: 3
  • Open Issues: 6
  • Releases: 40
Topics
kilonovae monte-carlo-simulation python python-package spectra supernovae
Created almost 10 years ago · Last pushed 6 months ago
Metadata Files
Readme License Citation Codeowners

README.md

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

The artistools command be invoked with uvx artistools (after installing uv).

Development (editable installation)

For development, you will need a rust compiler and a clone of the repository: sh git clone https://github.com/artis-mcrt/artistools.git cd artistools

To create a uv virtual environment with locked dependency versions, run: sh uv sync --extra extras --frozen uv tool install --editable .[extras] pre-commit install

Alternatively, to avoid uv and install into the system environment with pip: sh pip install --group dev --editable .[extras] pre-commit install

To learn how to enable command-line autocompletions, run: sh 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

Emission plot NLTE plot Estimator plot

License

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

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

Owner

  • Name: ARTIS Monte Carlo Radiative Transfer
  • Login: artis-mcrt
  • Kind: organization

Synthetic light curves and spectra for supernovae and kilonovae

Citation (CITATION.cff) 

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
  - name: ARTIS Collaboration
  - family-names: Shingles
    given-names: Luke J.
    orcid: https://orcid.org/0000-0002-5738-1612
    email: luke.shingles@gmail.com
  - family-names: Collins
    given-names: Christine E.
    orcid: https://orcid.org/0000-0002-0313-7817
    email: c.collins@gsi.de
  - family-names: Holas
    given-names: Alexander
    orcid: https://orcid.org/0000-0001-5184-6928
  - family-names: Callan
    given-names: Fionntan
    orcid: https://orcid.org/0000-0002-7975-8185
  - family-names: Sim
    given-names: Stuart
  - family-names: Pollin
    given-names: Joshua
    orcid: https://orcid.org/0009-0005-6989-3198
  - family-names: Leck
    given-names: Gerrit
title: artistools
version: v2025-06-08
date-released: 2025-06-08
doi: 10.5281/zenodo.7728326
license: MIT
repository-code: 'https://github.com/artis-mcrt/artistools'
abstract: >-
  Artistools is collection of plotting, analysis, and file
  format conversion tools for the ARTIS radiative transfer
  code.

Committers

Last synced: about 2 years ago

All Time
  • Total Commits: 2,853
  • Total Committers: 11
  • Avg Commits per committer: 259.364
  • Development Distribution Score (DDS): 0.186
Past Year
  • Commits: 154
  • Committers: 5
  • Avg Commits per committer: 30.8
  • Development Distribution Score (DDS): 0.26
Top Committers
Name Email Commits
Luke Shingles l****s@g****m 2,322
Christine c****2@q****k 287
ccollins c****4@h****k 205
github-actions[bot] 4****] 11
pyup.io bot g****t@p****o 11
Alexander Holas 7****s 7
fcallan678 5****8 4
Alexander Holas a****s@g****e 3
Alexander Holas h****r@c****r 1
Stuart Sim s****m@m****u 1
Fionntan Callan 5****n 1
Committer Domains (Top 20 + Academic)
mso.anu.edu.au: 1 cascade-login.cluster: 1 gmx.de: 1 pyup.io: 1 hotmail.co.uk: 1 qub.ac.uk: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 7
  • Total pull requests: 531
  • Average time to close issues: 4 days
  • Average time to close pull requests: 3 days
  • Total issue authors: 3
  • Total pull request authors: 11
  • Average comments per issue: 0.29
  • Average comments per pull request: 0.74
  • Merged pull requests: 406
  • Bot issues: 3
  • Bot pull requests: 236
Past Year
  • Issues: 5
  • Pull requests: 225
  • Average time to close issues: about 12 hours
  • Average time to close pull requests: 3 days
  • Issue authors: 2
  • Pull request authors: 7
  • Average comments per issue: 0.2
  • Average comments per pull request: 0.8
  • Merged pull requests: 149
  • Bot issues: 2
  • Bot pull requests: 132
View more stats
Top Authors
Issue Authors
  • lukeshingles (3)
  • renovate[bot] (3)
  • AlexHls (1)
Pull Request Authors
  • lukeshingles (208)
  • renovate[bot] (208)
  • ccollins22 (48)
  • github-actions[bot] (33)
  • gleck97 (14)
  • dependabot[bot] (12)
  • pyup-bot (12)
  • AlexHls (11)
  • fionntancallan (5)
  • jpollin98 (5)
  • Copilot (1)
Top Labels
Issue Labels
Pull Request Labels
dependencies (57) rust (6) bug (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 4,246 last-month
  • Total dependent packages: 1
  • Total dependent repositories: 1
  • Total versions: 45
  • Total maintainers: 1
pypi.org: artistools

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

  • Versions: 45
  • Dependent Packages: 1
  • Dependent Repositories: 1
  • Downloads: 4,246 Last month
Rankings
Downloads: 5.7%
Dependent packages count: 10.1%
Average: 14.5%
Stargazers count: 16.1%
Forks count: 19.1%
Dependent repos count: 21.5%
Maintainers (1)
lukeshingles
Last synced: 6 months ago

Dependencies

requirements.txt pypi
  • PyYAML >=5.3.1
  • argcomplete >=2.0.0
  • astropy >=4.1
  • coveralls >=1.3.0
  • extinction >=0.4.5
  • flake8 >=3.8.4
  • matplotlib >=3.3.4
  • numpy >=1.19.4
  • pandas >=1.1
  • psutil >=5.9.0
  • pynonthermal >=2021.04.21
  • pypdf2 >=1.26.0
  • pytest >=6.2.2
  • pytest-cov >=2.10.1
  • pytest-runner >=5.2
  • scipy >=1.5.4
  • setuptools_scm >=6.2
  • wheel >=0.36
  • xattr >=0.9.7
.github/workflows/deploypypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/deploytestpypi.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/linter.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • github/super-linter/slim v4 composite
  • psf/black stable composite
.github/workflows/pytest.yml actions
  • actions/cache v3 composite
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • codecov/codecov-action v3 composite