simtools
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
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/).
2 maintainers
Metadata
2 maintainers
Release files for gammasimtools 0.38.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gammasimtools-0.38.1.tar.gz | 3.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gammasimtools-0.38.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.8 MB
Release files / gammasimtools-0.38.1.tar.gz
| Download URL | gammasimtools-0.38.1.tar.gz |
|---|---|
| Size | 3.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
da3d5045c5b7613720debe9727a1de901902a5cb4dcc41458494e3b7eddf811b
|
|
BLAKE2b-256 checksum How to use checksums |
9d9946d41b93d111541714f2953b5c6f95631ecaad0ffe7cc80fa89019b48a5b
|
| 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 Oct 2, 2026.
Transparency logRelease files / gammasimtools-0.38.1-py3-none-any.whl
| Download URL | gammasimtools-0.38.1-py3-none-any.whl |
|---|---|
| Size | 970.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f02f70ac22361aba2c529a7fd4477401e3d31e769cbd0646dc5cc362642f3850
|
|
BLAKE2b-256 checksum How to use checksums |
545a2dd1ecfb1308b5974bf5dc6e4f36868a84b8051a08b38f1fd49d306d8e1d
|
| 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 Oct 2, 2026.
Transparency log
