Skip to main content

simtools

LICENSE release DOI pypyi

simtools is a modular toolkit for managing simulation model parameters, configuring, running, and validating simulation productions for arrays of imaging atmospheric Cherenkov telescopes.

Documentation: simtools documentation

simtools is part of the SimPipe pipeline of the Cherenkov Telescope Array Observatory (CTAO).

Authors: see the CITATION.cff file. Contributors: see the Contributors page.

Note simtools is under active development. Contact the developers before using it: simtools-developer@desy.de

Features

  • Simulation model libraries and management
  • Interfaces for reading simulation model parameters from the CTAO Simulation Models repository
  • Tools for preparing, configuring, running, and validating simulation productions
  • Applications for deriving and validating model parameters (see CTAO Model setting and validation workflows)
  • Standardized interfaces and outputs independent of the simulation software (e.g., CORSIKA air shower simulations and sim_telarray telescope simulations)
  • I/O and reporting tools for simulation models and production data

Quick Start

For users:

pip install gammasimtools

Copy .env_template to .env and update the file to set up your environment.

For developers:

git clone https://github.com/gammasim/simtools.git
cd simtools
python -m venv .venv
source .venv/bin/activate
# rehash (to avoid shell mixup in certain envs)
pip install -e '.[tests,dev,doc]'

Citing this Software

Please cite this software if it is used for a publication, see the Zenodo record and CITATION.cff.

Software Quality

CI CI-integrationtest CI-docs

Coverage Quality Gate Status

Generative AI disclosure

Generative AI tools (including, but not limited to, Claude, ChatGPT, and Gemini) were used to assist with code development, debugging, and documentation drafting. All AI-assisted outputs were reviewed, validated, and, where necessary, modified by the authors to ensure accuracy and reliability.

Acknowledgements

This project has been supported by the Deutsche Forschungsgemeinschaft (DFG, German Research Foundation) - project number 460248186 (PUNCH4NFDI https://www.punch4nfdi.de/).

Metadata

Release files for gammasimtools 0.39.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gammasimtools 0.39.1
File Size Uploaded Provenance Actions
gammasimtools-0.39.1.tar.gz 5.1 MB With provenance Details for gammasimtools-0.39.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for gammasimtools 0.39.1
File Interpreter ABI Platform Actions
gammasimtools-0.39.1-py3-none-any.whl Python 3 none any Details for gammasimtools-0.39.1-py3-none-any.whl

Total release size: 6.3 MB

Release files / gammasimtools-0.39.1.tar.gz

Download URL gammasimtools-0.39.1.tar.gz
Size 5.1 MB
Tags Source
SHA-256 checksum
How to use checksums
bcf57ef220bcd2ca9d1ffffb6c96932db9cffbdd9852d42d94c0746ff5bf8fff
BLAKE2b-256 checksum
How to use checksums
18e882ee66866533dea97fd1a98f3f45be0bd12690aa9ad3a3585a4c66fc0fc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 12, 2026.

Transparency log

Release files / gammasimtools-0.39.1-py3-none-any.whl

Download URL gammasimtools-0.39.1-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
423b1108e0b01b317e65b3dc7a78837028877bffb3984986b3d131de9c53c0db
BLAKE2b-256 checksum
How to use checksums
7f71290d3815deb43536839bc953d13684d267beec11a8fb783c9f0166d0a5ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 12, 2026.

Transparency log

Security for gammasimtools 0.39.1

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gammasimtools-0.39.1.tar.gz

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 Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.39.1 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page