gammasimtools 0.22.0__tar.gz → 0.23.0__tar.gz

gammasimtools-0.23.0/.env_template

@@ -0,0 +1,24 @@
+# Template file for environment variables settings
+# Copy this file to '.env' and add the required
+# credentials for simulation model database access
+
+# Port on the MongoDB server
+SIMTOOLS_DB_API_PORT=27017
+# MongoDB server
+SIMTOOLS_DB_SERVER=cta-simpipe-protodb.zeuthen.desy.de
+# username for MongoDB: ask the responsible person
+SIMTOOLS_DB_API_USER=YOUR_USERNAME
+# Password for MongoDB: ask the responsible person
+SIMTOOLS_DB_API_PW=YOUR_PASSWORD
+SIMTOOLS_DB_API_AUTHENTICATION_DATABASE=admin
+SIMTOOLS_DB_SIMULATION_MODEL=CTAO-Simulation-Model
+SIMTOOLS_DB_SIMULATION_MODEL_VERSION=v0.10.0
+SIMTOOLS_SIMTEL_PATH=/workdir/sim_telarray
+SIMTOOLS_USER_EMAIL=default@email.org
+SIMTOOLS_USER_NAME=simtools-user
+SIMTOOLS_USER_ORGANIZATION=CTAO
+SIMTOOLS_USER_ORCID=0000-0000-0000-0000
+
+# The dashboards to monitor the MongoDB instance are in (accessible only from within DESY)
+# https://statspub.zeuthen.desy.de/d/4vXnWwMGz/mongodb?orgId=1&refresh=30s
+# https://statspub.zeuthen.desy.de/d/tBkrQGNmz/mongodb-wiredtiger?orgId=1&refresh=1m

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/CI-docs.yml

@@ -20,7 +20,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/CI-linter.yml

@@ -26,7 +26,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 
@@ -73,6 +73,11 @@ jobs:
         run: |
           pip install -e '.[tests,dev,doc]'
 
+      - name: Install and run dotenv-linter
+        run: |
+          curl -sSfL https://git.io/JLbXn | sh -s
+          ./bin/dotenv-linter --skip UnorderedKey
+
       - name: Restore pre-commit cache
         uses: actions/cache@v4
         id: precommit-cache
@@ -84,7 +89,7 @@ jobs:
 
       - name: Pre-commit
         run: |
-          pre-commit run --all-files
+          SKIP=no-commit-to-branch pre-commit run --all-files
 
       - name: Save pre-commit cache
         if: success()  # only save if previous steps succeeded
@@ -92,28 +97,3 @@ jobs:
         with:
           path: ~/.cache/pre-commit
           key: ${{ runner.os }}-pre-commit-${{ hashFiles('.pre-commit-config.yaml') }}
-
-  superlinter:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: read
-      statuses: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-        with:
-          fetch-depth: 0
-
-      - name: Lint Code Base
-        uses: super-linter/super-linter@v8
-        env:
-          VALIDATE_ALL_CODEBASE: false
-          VALIDATE_ENV: true
-          VALIDATE_NATURAL_LANGUAGE: true
-          VALIDATE_BASH: true
-          LINTER_RULES_PATH: ./
-          CREATE_LOG_FILE: true
-          LOG_FILE: superlinter.log
-          DEFAULT_BRANCH: main
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/CI-schema-validation.yml

@@ -26,7 +26,7 @@ jobs:
         uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/CI-software-update.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v5
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/CI-unittests.yml

@@ -63,7 +63,7 @@ jobs:
           fetch-depth: 0
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -84,7 +84,7 @@ jobs:
 
       - name: Python setup
         if: matrix.install-method == 'pip'
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
           check-latest: true

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/build-corsika-simtel.yml

@@ -23,7 +23,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        simtel_version: ['240205', '240927', '250304']
+        simtel_version: ['240205', '240927', '250903']
 
     steps:
       - name: Checkout repository
@@ -31,7 +31,8 @@ jobs:
 
       - name: Download corsika-simtel-package
         run: |
-          wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets[format('CLOUD_SIMTEL_{0}', matrix.simtel_version)] }}/download -O corsika_simtelarray_${{ matrix.simtel_version }}.tar.gz
+          # CLOUD_SIMTEL_R_<version> secrets points to reduced tarballs without QGSJet and autoconf
+          wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets[format('CLOUD_SIMTEL_R_{0}', matrix.simtel_version)] }}/download -O corsika_simtelarray_${{ matrix.simtel_version }}.tar.gz
           wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets.CLOUD_AUTOCONF }}/download -O autoconf.tar.gz
       - name: Upload corsika-simtel-package
         uses: actions/upload-artifact@v4
@@ -39,12 +40,32 @@ jobs:
           name: corsika-simtelarray-package-${{ matrix.simtel_version }}
           path: |
             corsika_simtelarray_${{ matrix.simtel_version }}.tar.gz
+          retention-days: 1
+
+  download-auxiliary-files:
+    runs-on: ubuntu-latest
+
+    steps:
+
+      - name: Download QGSJet and autoconf
+        run: |
+          wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets.CLOUD_QGSJET2 }}/download -O qgsdat-II-04.bz2
+          wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets.CLOUD_QGSJET3 }}/download -O qgsdat-III.bz2
+          wget --no-verbose ${{ env.CLOUD_URL }}/${{ secrets.CLOUD_AUTOCONF }}/download -O autoconf.tar.gz
+      - name: Upload QGSJet files and autoconf
+        uses: actions/upload-artifact@v4
+        with:
+          name: upload-auxiliary-files
+          path: |
+            qgsdat-II-04.bz2
+            qgsdat-III.bz2
             autoconf.tar.gz
-          retention-days: 3
+          retention-days: 1
+
 
   build-base-images:
     runs-on: ubuntu-latest
-    needs: download-corsika
+    needs: [download-corsika, download-auxiliary-files]
     permissions:
       contents: read
       packages: write
@@ -57,11 +78,13 @@ jobs:
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'avx2'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'avx512f'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'sse4'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'avx512f'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'sse4'}
         production:
           # list of productions build options: 'prod6-sc', 'prod6-baseline', 'prod5', 'prod5-sc'
-          - {build_opt: 'prod6-sc', extra_def: ''}
+          # - {build_opt: 'prod6-sc', extra_def: ''}  # currently not used
           - {build_opt: 'prod6-baseline', extra_def: ''}
 
     env:
@@ -80,7 +103,19 @@ jobs:
       - name: Rename corsika-simtel-package files
         run: |
           mv ./downloaded-artifacts/corsika_simtelarray_${{ matrix.version.simtel_version }}.tar.gz corsika_simtelarray.tar.gz
-          mv ./downloaded-artifacts/autoconf.tar.gz autoconf.tar.gz
+
+      - name: Download auxiliary files
+        uses: actions/download-artifact@v5
+        with:
+          name: upload-auxiliary-files
+          path: ./downloaded-artifacts
+
+      - name: Rename auxiliary files
+        run: |
+          mv -v ./downloaded-artifacts/qgsdat-II-04.bz2 qgsdat-II-04.bz2
+          mv -v ./downloaded-artifacts/qgsdat-III.bz2 qgsdat-III.bz2
+          mv -v ./downloaded-artifacts/autoconf.tar.gz autoconf.tar.gz
+          ls -lh autoconf.tar.gz
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/build-simtools.yml

@@ -35,11 +35,13 @@ jobs:
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'avx2'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'avx512f'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'sse4'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'avx512f'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'sse4'}
         production:
           # list of productions build options: 'prod6-sc', 'prod6-baseline', 'prod5', 'prod5-sc'
-          - {build_opt: 'prod6-sc', extra_def: ''}
+          # - {build_opt: 'prod6-sc', extra_def: ''}  # currently not used
           - {build_opt: 'prod6-baseline', extra_def: ''}
 
     env:
@@ -103,16 +105,16 @@ jobs:
           - {simtel_version: '240205', corsika_version: '77500', bernlohr_version: '1.67', hadronic_model: 'qgs2', avx_instruction: 'no_opt'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'no_opt'}
           - {simtel_version: '240927', corsika_version: '77550', bernlohr_version: '1.68', hadronic_model: 'qgs2', avx_instruction: 'avx2'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
-          - {simtel_version: '250304', corsika_version: '78000', bernlohr_version: '1.69', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'no_opt'}
+          - {simtel_version: '250903', corsika_version: '78010', bernlohr_version: '1.70', hadronic_model: 'qgs3', avx_instruction: 'avx2'}
         production:
           # list of productions build options: 'prod6-sc', 'prod6-baseline', 'prod5', 'prod5-sc'
-          - {build_opt: 'prod6-sc', extra_def: ''}
+          # - {build_opt: 'prod6-sc', extra_def: ''} # currently not used
           - {build_opt: 'prod6-baseline', extra_def: ''}
         model_version:
           - "6.0"
     container:
-      image: ghcr.io/gammasim/simtools-prod-sim-telarray-${{ matrix.version.simtel_version }}-corsika-${{ matrix.version.corsika_version }}-bernlohr-${{ matrix.version.bernlohr_version }}-${{ matrix.production.build_opt }}-${{ matrix.version.hadronic_model }}-${{ matrix.version.avx_instruction }}
+      image: ghcr.io/gammasim/simtools-sim-telarray-${{ matrix.version.simtel_version }}-corsika-${{ matrix.version.corsika_version }}-bernlohr-${{ matrix.version.bernlohr_version }}-${{ matrix.production.build_opt }}-${{ matrix.version.hadronic_model }}-${{ matrix.version.avx_instruction }}
       options: --user 0
 
     services:

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.github/workflows/pypi.yml

@@ -20,7 +20,7 @@ jobs:
       - run: git fetch --tags
 
       - name: Set up Python
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@v6
         with:
           python-version: "3.12"
 

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/.pre-commit-config.yaml

@@ -2,7 +2,7 @@
 repos:
 # Ruff
 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.12.11
+  rev: v0.14.0
   hooks:
   - id: ruff
     args: ["--fix"]
@@ -30,6 +30,9 @@ repos:
   - id: check-added-large-files
     args: ['--maxkb=500']
   - id: check-json
+  - id: check-toml
+  - id: no-commit-to-branch
+    args: [--branch=main]
 # https://github.com/HunterMcGushion/docstr_coverage
 - repo: https://github.com/HunterMcGushion/docstr_coverage
   rev: v2.3.2  # most recent docstr-coverage release or commit sha
@@ -38,12 +41,12 @@ repos:
     args: ["--verbose", "2", "--fail-under", "70.", "src/simtools"]
 # Github action
 - repo: https://github.com/rhysd/actionlint
-  rev: v1.7.7
+  rev: v1.7.8
   hooks:
   - id: actionlint
 # https://pyproject-fmt.readthedocs.io/en/latest/
 - repo: https://github.com/tox-dev/pyproject-fmt
-  rev: "v2.6.0"
+  rev: "v2.10.0"
   hooks:
   - id: pyproject-fmt
 # codespell
@@ -57,6 +60,7 @@ repos:
   hooks:
   - id: markdownlint
     args: ["--disable", "MD041"]
+    language_version: 22.11.0
 # yamllint
 - repo: https://github.com/adrienverge/yamllint.git
   rev: v1.37.1
@@ -75,3 +79,8 @@ repos:
   - id: towncrier-update
     files: $docs/changes/
     args: ['--keep']
+# shellcheck
+- repo: https://github.com/shellcheck-py/shellcheck-py
+  rev: v0.11.0.1
+  hooks:
+  - id: shellcheck

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/CHANGELOG.md

@@ -7,6 +7,40 @@ This changelog is generated using [Towncrier](https://towncrier.readthedocs.io/)
 
 <!-- towncrier release notes start -->
 
+## [v0.23.0](https://github.com/gammasim/simtools/releases/tag/v0.23.0) - 2025-10-13
+
+### Bugfixes
+
+- Bugfix in comparing model versions in integration tests to decide which tests should run.
+  Bugfix in getting model parameter values with units for the case of value-unit pairs consisting of lists with None entries. ([#1805](https://github.com/gammasim/simtools/pull/1805))
+- Fix a bug where hard stereo trigger was set every time the hard_stereo key existed in dictionary, rather than checking its value. Now it only sets hardstereo if the value is True. ([#1813](https://github.com/gammasim/simtools/pull/1813))
+- Bugfix packing model files: model version was not taken into account correctly. ([#1818](https://github.com/gammasim/simtools/pull/1818))
+- Bugfix in preparing sim_telarray command for shower simulations: power-law configuration (used to fill histograms) set at the wrong place. ([#1825](https://github.com/gammasim/simtools/pull/1825))
+- Bugfix in writing sim_telarray configuration option: "-C show=all" should be last in command. ([#1828](https://github.com/gammasim/simtools/pull/1828))
+
+### New Features
+
+- Add new CORSKIA / sim_telarray image build for:
+
+  - CORSIKA 7.8010
+  - Bernloehr package 1.70
+  - sim_telarray 250903
+
+  Improved downloading script and handling of QGSJet tables.
+
+  ([#1824](https://github.com/gammasim/simtools/pull/1824))
+- Fill telescope design types into sim_telarray metadata field for `camera_config_variant` and `optics_config_variant`. ([#1826](https://github.com/gammasim/simtools/pull/1826))
+- Allow to highlight or grey out telescopes in layout plotting application. ([#1829](https://github.com/gammasim/simtools/pull/1829))
+- Allow to provide integers in scientific notation in yaml configuration files. Currently only implemented for the --number_of_photons argument of calculate_incident_angles.py. ([#1837](https://github.com/gammasim/simtools/pull/1837))
+
+### Maintenance
+
+- Add application control functionality for all simtools applications. ([#1809](https://github.com/gammasim/simtools/pull/1809))
+- Adding --all_model_versions flag for calibration and software report generation. ([#1815](https://github.com/gammasim/simtools/pull/1815))
+- Replace superlinter in linter CI. Add toml linter and shellcheck to precommit. ([#1838](https://github.com/gammasim/simtools/pull/1838))
+- Update one function used in the tests to comply with version 2.x of pyeventio. ([#1840](https://github.com/gammasim/simtools/pull/1840))
+
+
 ## [v0.22.0](https://github.com/gammasim/simtools/releases/tag/v0.22.0) - 2025-09-30
 
 ### Bugfixes

{gammasimtools-0.22.0/src/gammasimtools.egg-info → gammasimtools-0.23.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gammasimtools
-Version: 0.22.0
+Version: 0.23.0
 Summary: Tools for the Simulation System of the CTA Observatory
 Author-email: simtools developers <simtools-developer@desy.de>
 License-Expression: BSD-3-Clause
@@ -12,6 +12,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Astronomy
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/docker/Dockerfile-corsika-simtel

@@ -7,7 +7,7 @@
 
 # Shared build arguments
 ARG CORSIKA_VERSION="77550"
-ARG CORSIKA_OPT_PATCH_VERSION="v1.0.0"
+ARG CORSIKA_OPT_PATCH_VERSION="v1.1.0"
 ARG BUILD_OPT="prod6-sc"
 ARG EXTRA_DEF="-DMAXIMUM_TELESCOPES=128"
 ARG HADRONIC_MODEL="qgs2"
@@ -24,7 +24,6 @@ FROM almalinux:9.5 AS patches_stage
 ARG CORSIKA_VERSION
 ARG CORSIKA_OPT_PATCH_VERSION
 
-
 RUN yum update -y && yum install -y git && \
     yum clean all && \
     rm -rf /var/cache/yum/* /tmp/* /var/tmp/*
@@ -132,8 +131,10 @@ RUN mv ./corsika-7*/run corsika-run && \
     find . -name "*.o" -delete && \
     rm -rf /var/cache/yum/* /tmp/* /var/tmp/*
 
-# Unzip QGSJet tables; remove tables not needed (e.g. remove qgs3 tables when using qgs2)
+# Use QGSJet tables downloaded externally (overwrite any existing copies)
 WORKDIR /workdir/sim_telarray/corsika-run
+COPY qgsdat-II-04.bz2 .
+COPY qgsdat-III.bz2 .
 RUN if [ "$HADRONIC_MODEL" = "qgs3" ]; then \
         if [ -f qgsdat-III.bz2 ]; then \
             bzip2 -dq qgsdat-III.bz2; \

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/docker/Dockerfile-dev

@@ -11,9 +11,9 @@
 # - SC1091: ignore warning about not being able to source the bashrc
 ARG BUILD_OPT="prod6-baseline"
 ARG HADRONIC_MODEL="qgs3"
-ARG SIMTEL_VERSION="250304"
-ARG CORSIKA_VERSION="78000"
-ARG BERNLOHR_VERSION="1.69"
+ARG SIMTEL_VERSION="250903"
+ARG CORSIKA_VERSION="78010"
+ARG BERNLOHR_VERSION="1.70"
 ARG AVX_INSTRUCTION="no_opt"
 ARG PYTHON_VERSION="3.12"
 FROM ghcr.io/gammasim/corsika-simtel-${SIMTEL_VERSION}-corsika-${CORSIKA_VERSION}-bernlohr-${BERNLOHR_VERSION}-${BUILD_OPT}-${HADRONIC_MODEL}-${AVX_INSTRUCTION}:latest

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/docs/_static/switcher.json

@@ -5,5 +5,6 @@
   {"version": "v0.18.0", "url": "https://gammasim.github.io/simtools/v0.18.0/"},
   {"version": "v0.20.0", "url": "https://gammasim.github.io/simtools/v0.20.0/"},
   {"version": "v0.21.0", "url": "https://gammasim.github.io/simtools/v0.21.0/"},
-  {"version": "v0.22.0", "url": "https://gammasim.github.io/simtools/v0.22.0/"}
+  {"version": "v0.22.0", "url": "https://gammasim.github.io/simtools/v0.22.0/"},
+  {"version": "v0.23.0", "url": "https://gammasim.github.io/simtools/v0.23.0/"}
 ]

gammasimtools-0.23.0/docs/changes/1808.feature.md

@@ -0,0 +1 @@
+Add new simulation model parameter `transit_time_random`.

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/docs/source/api-reference/dependencies.md

@@ -1,6 +1,15 @@
 (dependencymanagement)=
 
-# Dependency and version management.
+# Application, dependency and version management.
+
+(application_control)=
+
+## application_control
+
+```{eval-rst}
+.. automodule:: simtools.application_control
+   :members:
+```
 
 (dependencies)=
 

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/docs/source/user-guide/applications/simtools-calculate-incident-angles.rst

@@ -1,5 +1,5 @@
 simtools-calculate-incident-angles
 ==================================
 
-.. automodule:: simtools.applications.calculate_incident_angles
+.. automodule:: calculate_incident_angles
     :members:

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/pyproject.toml

@@ -21,6 +21,7 @@ classifiers = [
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Scientific/Engineering :: Astronomy",
 ]
 dynamic = [

{gammasimtools-0.22.0 → gammasimtools-0.23.0/src/gammasimtools.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gammasimtools
-Version: 0.22.0
+Version: 0.23.0
 Summary: Tools for the Simulation System of the CTA Observatory
 Author-email: simtools developers <simtools-developer@desy.de>
 License-Expression: BSD-3-Clause
@@ -12,6 +12,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Scientific/Engineering :: Astronomy
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/src/gammasimtools.egg-info/SOURCES.txt

@@ -35,6 +35,7 @@ docs/_static/simtools_logo.png
 docs/_static/simtools_logo_no_text.png
 docs/_static/switcher.json
 docs/changes/.gitkeep
+docs/changes/1808.feature.md
 docs/source/changelog.md
 docs/source/conf.py
 docs/source/index.md
@@ -164,6 +165,7 @@ src/gammasimtools.egg-info/requires.txt
 src/gammasimtools.egg-info/top_level.txt
 src/simtools/__init__.py
 src/simtools/_version.py
+src/simtools/application_control.py
 src/simtools/constants.py
 src/simtools/dependencies.py
 src/simtools/simulator.py
@@ -532,6 +534,7 @@ src/simtools/schemas/model_parameters/transit_time_compensate_error.schema.yml
 src/simtools/schemas/model_parameters/transit_time_compensate_step.schema.yml
 src/simtools/schemas/model_parameters/transit_time_error.schema.yml
 src/simtools/schemas/model_parameters/transit_time_jitter.schema.yml
+src/simtools/schemas/model_parameters/transit_time_random.schema.yml
 src/simtools/schemas/model_parameters/trigger_current_limit.schema.yml
 src/simtools/schemas/model_parameters/trigger_delay_compensation.schema.yml
 src/simtools/schemas/model_parameters/trigger_pixels.schema.yml

{gammasimtools-0.22.0 → gammasimtools-0.23.0}/src/simtools/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.22.0'
-__version_tuple__ = version_tuple = (0, 22, 0)
+__version__ = version = '0.23.0'
+__version_tuple__ = version_tuple = (0, 23, 0)
 
-__commit_id__ = commit_id = 'g1007eeb0e'
+__commit_id__ = commit_id = 'g291161d8c'

gammasimtools-0.23.0/src/simtools/application_control.py

@@ -0,0 +1,118 @@
+"""Application control utilities for startup and shutdown simtools applications."""
+
+import logging
+from dataclasses import dataclass
+from pathlib import Path
+
+import simtools.utils.general as gen
+from simtools.io import io_handler
+
+
+@dataclass
+class ApplicationContext:
+    """Container for common application context elements."""
+
+    args: dict
+    db_config: dict
+    logger: logging.Logger
+    io_handler: io_handler.IOHandler | None
+
+
+def startup_application(parse_function, setup_io_handler=True, logger_name=None):
+    """
+    Initialize common application startup tasks.
+
+    This function handles the repetitive startup tasks common to most simtools applications:
+
+    - Parse command line arguments and configuration
+    - Set up logging with appropriate level
+    - Optionally initialize IOHandler
+
+    Parameters
+    ----------
+    parse_function : Callable
+        Function that parses configuration and returns (args_dict, db_config) tuple.
+        This should be the application's _parse() function.
+    setup_io_handler : bool, optional
+        Whether to initialize and return an IOHandler instance. Default is True.
+    logger_name : str, optional
+        Name for the logger. If None, uses the root logger. Default is None.
+
+    Returns
+    -------
+    args_dict : dict
+        Parsed command line arguments and configuration.
+    db_config : dict
+        Database configuration dictionary.
+    logger : logging.Logger
+        Configured logger instance.
+    io_handler_instance : io_handler.IOHandler or None
+        IOHandler instance if setup_io_handler=True, None otherwise.
+
+    Example
+    -------
+    Basic usage in an application:
+
+    .. code-block:: python
+
+        def main():
+            app_context = startup_application(_parse)
+
+            # Application-specific code follows
+            app_context.logger.info("Starting application")
+            # ... rest of application logic
+
+    Usage without IOHandler:
+
+    .. code-block:: python
+
+        def main():
+            app_context = startup_application(_parse, setup_io_handler=False)
+
+            # Application-specific code follows
+            app_context.logger.info("Starting application")
+            # ... rest of application logic
+    """
+    args_dict, db_config = parse_function()
+
+    if logger_name:
+        logger = logging.getLogger(logger_name)
+    else:
+        logger = logging.getLogger()
+    logger.setLevel(gen.get_log_level_from_user(args_dict["log_level"]))
+
+    io_handler_instance = io_handler.IOHandler() if setup_io_handler else None
+
+    return ApplicationContext(
+        args=args_dict,
+        db_config=db_config,
+        logger=logger,
+        io_handler=io_handler_instance,
+    )
+
+
+def get_application_label(file_path):
+    """
+    Get application label from file path.
+
+    This is a convenience function to extract the application name from __file__.
+
+    Parameters
+    ----------
+    file_path : str
+        The __file__ variable from the calling application.
+
+    Returns
+    -------
+    str
+        Application label (filename without extension).
+
+    Example
+    -------
+    .. code-block:: python
+
+        def main():
+            label = get_application_label(__file__)
+            # label will be the filename without .py extension
+    """
+    return Path(file_path).stem