dlamb 0.0.1__tar.gz

dlamb-0.0.1/.agents/skills/gm-pr-workflow

@@ -0,0 +1 @@
+../../../.skills/skills/gm-pr-workflow

dlamb-0.0.1/.clang-format

@@ -0,0 +1,5 @@
+---
+BasedOnStyle: LLVM
+ColumnLimit: 100
+IndentWidth: 2
+SortIncludes: CaseSensitive

dlamb-0.0.1/.clang-tidy

@@ -0,0 +1,17 @@
+---
+Checks: >
+  -*,
+  bugprone-argument-comment,
+  bugprone-branch-clone,
+  bugprone-empty-catch,
+  bugprone-exception-escape,
+  bugprone-infinite-loop,
+  bugprone-macro-parentheses,
+  bugprone-suspicious-memset-usage,
+  bugprone-undefined-memory-manipulation,
+  performance-for-range-copy
+WarningsAsErrors: '*'
+HeaderFilterRegex: 'cpp/include/dlamb/.*'
+CheckOptions:
+  - key: readability-identifier-length.MinimumVariableNameLength
+    value: '2'

dlamb-0.0.1/.claude/skills/gm-pr-workflow

@@ -0,0 +1 @@
+../../../.skills/skills/gm-pr-workflow

dlamb-0.0.1/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+trim_trailing_whitespace = true
+
+[*.py]
+indent_size = 4

dlamb-0.0.1/.gitattributes

@@ -0,0 +1,7 @@
+* text=auto eol=lf
+
+*.cpp text diff=cpp
+*.hpp text diff=cpp
+*.py text diff=python
+*.yml text
+*.yaml text

dlamb-0.0.1/.github/workflows/changelog.yml

@@ -0,0 +1,32 @@
+---
+name: Changelog
+# Require a changelog entry for each pull request
+# from: https://github.com/cta-observatory/ctapipe/blob/main/.github/workflows/changelog.yml
+
+on:
+  pull_request:
+    types: [opened, reopened, synchronize, labeled, unlabeled, ready_for_review]
+    branches:
+      - 'main'
+
+env:
+  FRAGMENT_NAME_PREFIX: "docs/changes/${{ github.event.number }}"
+
+permissions:
+  contents: read
+
+jobs:
+  changelog:
+    runs-on: ubuntu-slim
+    if: >-
+      github.event.pull_request.draft == false &&
+      !contains(github.event.pull_request.labels.*.name, 'no-changelog-needed') &&
+      !contains(github.event.pull_request.labels.*.name, 'dependencies')
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7
+
+      - name: Check for at least one changelog fragment
+        run: |
+          find docs/changes -type f | \
+          grep -E "^${FRAGMENT_NAME_PREFIX}\.(feature|bugfix|maintenance)\.md$"

dlamb-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+---
+name: CI-linter
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-slim
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.14'
+      - name: Install linters
+        run: python -m pip install --upgrade pip pre-commit clang-format
+      - name: Run repository hooks
+        run: pre-commit run --all-files
+      - name: Check C++ formatting
+        run: >-
+          find cpp -type f \( -name '*.cpp' -o -name '*.hpp' \) -print0
+          | xargs -0 clang-format --dry-run --Werror

dlamb-0.0.1/.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+---
+name: CI-docs
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || 'pages' }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-slim
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+      - name: Install dlamb with the documentation tools
+        run: python -m pip install --upgrade pip && python -m pip install ".[docs]"
+      - name: Build documentation
+        run: sphinx-build -W --keep-going -b html docs docs/_build/html
+      - uses: actions/upload-pages-artifact@v5
+        with:
+          path: docs/_build/html
+
+  deploy:
+    if: github.event_name != 'pull_request' && (github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v'))
+    needs: build
+    runs-on: ubuntu-slim
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v5

dlamb-0.0.1/.github/workflows/pypi.yml

@@ -0,0 +1,108 @@
+---
+name: Build and publish dlamb
+
+on:
+  pull_request:
+    paths:
+      - "cpp/**"
+      - "python/**"
+      - "CMakeLists.txt"
+      - "pyproject.toml"
+      - ".github/workflows/pypi.yml"
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      publish_testpypi:
+        description: Publish the built distributions to TestPyPI
+        required: false
+        type: boolean
+        default: false
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
+
+permissions:
+  contents: read
+
+jobs:
+  wheels:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, ubuntu-24.04-arm, macos-15]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.ref }}
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+      - name: Install wheel tooling
+        run: python -m pip install --upgrade cibuildwheel
+      - name: Build and smoke-test wheels
+        env:
+          CIBW_BUILD: "cp314-* cp315-*"
+          CIBW_TEST_REQUIRES: "pytest matplotlib"
+          CIBW_TEST_COMMAND: python -m pytest {project}/python/tests -q
+        run: python -m cibuildwheel --output-dir wheelhouse
+      - uses: actions/upload-artifact@v7
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  sdist:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ github.ref }}
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.14"
+      - name: Build source distribution
+        run: |
+          python -m pip install --upgrade build
+          python -m build --sdist --outdir dist
+      - uses: actions/upload-artifact@v7
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    needs: [wheels, sdist]
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Publish distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-testpypi:
+    if: >-
+      ${{
+        github.event_name == 'workflow_dispatch' && inputs.publish_testpypi
+      }}
+    needs: [wheels, sdist]
+    runs-on: ubuntu-24.04
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v8
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Publish distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

dlamb-0.0.1/.github/workflows/tests.yml

@@ -0,0 +1,49 @@
+---
+name: CI-tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-test:
+    strategy:
+      fail-fast: false
+      matrix:
+        runner: [ubuntu-24.04, ubuntu-24.04-arm, macos-15]
+        python-version: ['3.14', '3.15']
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          allow-prereleases: true
+      - name: Install Python package and test dependencies
+        run: python -m pip install --upgrade pip && python -m pip install ".[plot]" pytest
+      - name: Configure and build
+        run: >-
+          cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+          && cmake --build build --parallel
+      - name: Run native and Python tests
+        run: ctest --test-dir build --output-on-failure && pytest python/tests
+  sanitizers:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v7
+      - name: Configure, build, and test with sanitizers
+        run: >-
+          cmake -S . -B build-sanitize -DCMAKE_BUILD_TYPE=Debug
+          -DCMAKE_CXX_FLAGS="-fsanitize=address,undefined -fno-omit-frame-pointer"
+          -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address,undefined"
+          && cmake --build build-sanitize --parallel
+          && ctest --test-dir build-sanitize --output-on-failure

dlamb-0.0.1/.gitignore

@@ -0,0 +1,32 @@
+# CMake and native build products
+/build/
+/out/
+/compile_commands.json
+/tmp_planning/
+*.o
+*.obj
+*.a
+*.so
+*.dylib
+*.dll
+
+# Generated trace and visualisation products
+*.npz
+*.html
+
+# Python
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.venv/
+*.egg-info/
+/dist/
+
+# IDE and operating-system files
+.DS_Store
+.vscode/
+.idea/
+
+# Documentation build
+/docs/_build/

dlamb-0.0.1/.pi/skills/gm-pr-workflow

@@ -0,0 +1 @@
+../../../.skills/skills/gm-pr-workflow

dlamb-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,64 @@
+---
+default_language_version:
+  python: python3.14
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v5.0.0
+  hooks:
+  - id: check-yaml
+  - id: check-json
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.12.7
+  hooks:
+  - id: ruff-check
+    args: [--fix]
+  - id: ruff-format
+# Github action
+- repo: https://github.com/rhysd/actionlint
+  rev: v1.7.12
+  hooks:
+  - id: actionlint
+# https://pyproject-fmt.readthedocs.io/en/latest/
+- repo: https://github.com/tox-dev/pyproject-fmt
+  rev: "v2.29.2"
+  hooks:
+  - id: pyproject-fmt
+# codespell
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.4.3
+  hooks:
+  - id: codespell
+    args: [
+      "--ignore-words-list=als,hel",
+    ]
+# markdownlint
+- repo: https://github.com/igorshubovych/markdownlint-cli
+  rev: v0.49.1
+  hooks:
+  - id: markdownlint
+    args: ["--disable", "MD041"]
+# yamllint
+- repo: https://github.com/adrienverge/yamllint.git
+  rev: v1.38.0
+  hooks:
+  - id: yamllint
+    args:
+      [
+        "--strict",
+        "-d",
+        '{extends: default, rules: {line-length: {max: 300}, indentation: {spaces: 2, indent-sequences: consistent}, truthy: {allowed-values: ["true", "false", "on", "off"]}}}'
+      ]
+# towncrier
+- repo: https://github.com/twisted/towncrier
+  rev: 25.8.0
+  hooks:
+  - id: towncrier-check
+    files: ^docs/changes/
+# shellcheck
+- repo: https://github.com/shellcheck-py/shellcheck-py
+  rev: v0.11.0.1-1
+  hooks:
+  - id: shellcheck

dlamb-0.0.1/AGENTS.md

@@ -0,0 +1,65 @@
+# dlamb Agent Guide
+
+## Scope
+
+`dlamb` generates photons from artificial light sources (flashers, illuminators,
+laser beams, LEDs, focal-plane and NSB sources, stars) with their angular, spectral
+and pulse profiles. It writes photons at sky, telescope-sphere (G), telescope (T) or
+camera (C) level. Atmospheric propagation, optics and camera simulation are out of
+scope.
+
+## Layout
+
+- `cpp/include/dlamb/`: C++ core headers.
+- `cpp/bindings/core.cpp`: nanobind extension; the only C++ file that may
+  depend on Python.
+- `cpp/tests/`: native tests (`test_*.cpp`) and shared helpers (`check.hpp`).
+- `python/dlamb/`: Python boundary (API, CLI, optional plotting).
+- `python/tests/`: pytest suite.
+- `docs/`: Sphinx sources. `docs/changes/` is towncrier input.
+
+## Design rules
+
+- Never ever modify the main README.md. Suggest instead changes, don't apply them.
+- Keep the core C++20 standard-library-only. Python, plotting and file formats of
+  other programs belong at the boundary, never in a per-photon kernel.
+- Per-photon kernels are pure functions of (chunk, parameters): no allocation, I/O,
+  Python calls or virtual dispatch per photon. Float32 SoA photon columns,
+  counter-based random numbers (Philox) keyed on (seed, stage id, event, telescope,
+  photon index). The scalar version is the reference for any SIMD or GPU version.
+- Write kernels as templates on the scalar type (later differentiability).
+- Make units, frames, random seeds and applied efficiencies explicit. Reject invalid
+  input; never silently discard fields.
+- Do not hardwire CTAO names, telescope geometry, model versions or physics
+  parameters. Configuration comes from validated input written by simtools.
+- Plotting is optional (`.[plot]`); matplotlib is never a core dependency.
+- Use Python >=3.14 (as in `pyproject.toml`).
+- Sources are defined by validated input data (position, direction, angular,
+  spectral and pulse profiles), never by hardwired device names.
+
+## Changes and validation
+
+- Make the narrowest complete change and preserve unrelated work.
+- Add a Towncrier fragment under `docs/changes/` for changes that should appear in
+  the release notes.
+- Add or update a focused test for every behavioural change. Analytic kernel tests
+  come before cross-tool or performance tests.
+- Results must not depend on photon ordering, chunk size or thread count.
+- Do not weaken tolerances or replace reference data to hide a discrepancy.
+
+## Build, test, and lint
+
+```bash
+python -m pip install -e '.[dev]'
+cmake --preset debug
+cmake --build --preset debug
+ctest --test-dir build/debug --output-on-failure
+python -m pytest python/tests
+ruff format --check python
+ruff check python
+find cpp -type f \( -name '*.cpp' -o -name '*.hpp' \) -print0 | \
+xargs -0 clang-format --dry-run --Werror
+pre-commit run --all-files
+```
+
+Docs build with warnings as errors: `sphinx-build -W --keep-going -b html docs docs/_build/html`.

dlamb-0.0.1/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+This project follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and uses semantic versioning after the first stable release.
+
+<!-- towncrier release notes start -->
+
+## [v0.0.1] - 2026-11-07
+
+### Added
+
+- Initial repository skeleton (build, packaging, CI, documentation); no functionality yet.

dlamb-0.0.1/CITATION.cff

@@ -0,0 +1,14 @@
+cff-version: 1.2.0
+message: "If you use dlamb, please cite it using the metadata below."
+title: "dlamb: Artificial light sources for Cherenkov-telescope simulations"
+version: 0.0.1
+date-released: 2026-11-07
+license: BSD-3-Clause
+type: software
+repository-code: "https://github.com/GernotMaier/dlamb"
+authors:
+  - given-names: Gernot
+    family-names: Maier
+    affiliation: DESY
+    orcid: 'https://orcid.org/0000-0001-9868-4700'
+abstract: "Artificial light sources for Cherenkov-telescope simulations: flashers, illuminators, lasers, LEDs and stars, emitting photons at sky, telescope-sphere, telescope or camera level, as a standard-library-only C++20 core with a Python API writing gstrickd photon streams."

dlamb-0.0.1/CLAUDE.md

@@ -0,0 +1,2 @@
+@../AGENTS.md
+@AGENTS.md

dlamb-0.0.1/CMakeLists.txt

@@ -0,0 +1,50 @@
+cmake_minimum_required(VERSION 3.20)
+project(dlamb VERSION 0.1.0 LANGUAGES CXX)
+
+option(DLAMB_BUILD_TESTING "Build the C++ tests" ON)
+if(DEFINED SKBUILD_PLATLIB_DIR)
+  set(DLAMB_BUILD_PYTHON_API_DEFAULT ON)
+else()
+  set(DLAMB_BUILD_PYTHON_API_DEFAULT OFF)
+endif()
+option(DLAMB_BUILD_PYTHON_API "Build the Python extension" ${DLAMB_BUILD_PYTHON_API_DEFAULT})
+
+# Header-only, standard-library-only core.
+add_library(dlamb_core INTERFACE)
+target_include_directories(dlamb_core INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}/cpp/include)
+target_compile_features(dlamb_core INTERFACE cxx_std_20)
+# Identical floating-point results for any thread count and chunk size on one
+# platform: no implicit fused multiply-add contraction.
+if(NOT MSVC)
+  target_compile_options(dlamb_core INTERFACE -ffp-contract=off)
+endif()
+
+function(dlamb_enable_warnings target)
+  if(MSVC)
+    target_compile_options(${target} PRIVATE /W4 /WX)
+  else()
+    target_compile_options(${target} PRIVATE -Wall -Wextra -Wpedantic -Werror)
+  endif()
+endfunction()
+
+if(DLAMB_BUILD_PYTHON_API)
+  find_package(Python 3.14 COMPONENTS Interpreter Development.Module REQUIRED)
+  execute_process(COMMAND "${Python_EXECUTABLE}" -m nanobind --cmake_dir
+                  OUTPUT_VARIABLE nanobind_DIR OUTPUT_STRIP_TRAILING_WHITESPACE
+                  COMMAND_ERROR_IS_FATAL ANY)
+  find_package(nanobind CONFIG REQUIRED)
+  nanobind_add_module(_core NB_STATIC cpp/bindings/core.cpp)
+  target_link_libraries(_core PRIVATE dlamb_core)
+  dlamb_enable_warnings(_core)
+  install(TARGETS _core LIBRARY DESTINATION dlamb)
+endif()
+
+if(DLAMB_BUILD_TESTING)
+  enable_testing()
+  foreach(test_name version)
+    add_executable(test_${test_name} cpp/tests/test_${test_name}.cpp)
+    target_link_libraries(test_${test_name} PRIVATE dlamb_core)
+    dlamb_enable_warnings(test_${test_name})
+    add_test(NAME ${test_name} COMMAND test_${test_name})
+  endforeach()
+endif()

dlamb-0.0.1/CMakePresets.json

@@ -0,0 +1,55 @@
+{
+  "version": 3,
+  "cmakeMinimumRequired": {
+    "major": 3,
+    "minor": 20,
+    "patch": 0
+  },
+  "configurePresets": [
+    {
+      "name": "base",
+      "hidden": true,
+      "generator": "Ninja",
+      "binaryDir": "${sourceDir}/build/${presetName}",
+      "cacheVariables": {
+        "CMAKE_EXPORT_COMPILE_COMMANDS": "ON",
+        "DLAMB_BUILD_TESTING": "ON"
+      }
+    },
+    {
+      "name": "debug",
+      "displayName": "Debug",
+      "inherits": "base",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Debug"
+      }
+    },
+    {
+      "name": "release",
+      "displayName": "Release",
+      "inherits": "base",
+      "cacheVariables": {
+        "CMAKE_BUILD_TYPE": "Release"
+      }
+    }
+  ],
+  "buildPresets": [
+    {
+      "name": "debug",
+      "configurePreset": "debug"
+    },
+    {
+      "name": "release",
+      "configurePreset": "release"
+    }
+  ],
+  "testPresets": [
+    {
+      "name": "debug",
+      "configurePreset": "debug",
+      "output": {
+        "outputOnFailure": true
+      }
+    }
+  ]
+}

dlamb-0.0.1/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, dlamb contributors, Gernot Maier (DESY)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

dlamb-0.0.1/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.2
+Name: dlamb
+Version: 0.0.1
+Summary: Artificial light sources for Cherenkov-telescope simulations
+Author: dlamb contributors
+License: BSD 3-Clause License
+         
+         Copyright (c) 2026, dlamb contributors, Gernot Maier (DESY)
+         All rights reserved.
+         
+         Redistribution and use in source and binary forms, with or without
+         modification, are permitted provided that the following conditions are met:
+         
+         1. Redistributions of source code must retain the above copyright notice, this
+            list of conditions and the following disclaimer.
+         
+         2. Redistributions in binary form must reproduce the above copyright notice,
+            this list of conditions and the following disclaimer in the documentation
+            and/or other materials provided with the distribution.
+         
+         3. Neither the name of the copyright holder nor the names of its
+            contributors may be used to endorse or promote products derived from
+            this software without specific prior written permission.
+         
+         THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+         AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+         IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+         DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+         FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+         DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+         SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+         CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+         OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+         OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+         
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.14
+Requires-Dist: numpy>=2.3
+Provides-Extra: dev
+Requires-Dist: nanobind>=3.1; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: myst-parser; extra == "docs"
+Requires-Dist: pydata-sphinx-theme; extra == "docs"
+Requires-Dist: pyyaml; extra == "docs"
+Requires-Dist: sphinx; extra == "docs"
+Provides-Extra: plot
+Requires-Dist: matplotlib>=3.8; extra == "plot"
+Description-Content-Type: text/markdown
+
+# dlamb
+
+Artificial light sources for Cherenkov-telescope simulations.
+
+Artificial light sources for Cherenkov-telescope simulations: flashers, illuminators, lasers, LEDs and stars, emitting photons at sky, telescope-sphere, telescope or camera level, as a standard-library-only C++20 core with a Python API writing gstrickd photon streams.
+
+`dlamb` is one module of a modular Cherenkov-telescope simulation chain
+(CORSIKA7 or light sources, atmosphere, optics, camera). Modules exchange photons as
+[gstrickd](https://github.com/gammasim/gstrickd) photon streams;
+[simtools](https://github.com/gammasim/simtools) configures and runs the chain.
+
+Status: pre-alpha, no functionality yet.
+
+## User Installation
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install dlamb
+```
+
+(requires python 3.14 or higher)
+
+## Developer Installation
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install -e '.[dev]'
+cmake --preset debug
+cmake --build --preset debug
+```
+
+Test your installation with:
+
+```sh
+ctest --test-dir build/debug --output-on-failure
+python -m pytest python/tests
+```
+
+## License and Citation
+
+BSD 3-Clause License, see [LICENSE](LICENSE). Please cite `dlamb` using the
+metadata in [CITATION.cff](CITATION.cff).

dlamb-0.0.1/README.md

@@ -0,0 +1,44 @@
+# dlamb
+
+Artificial light sources for Cherenkov-telescope simulations.
+
+Artificial light sources for Cherenkov-telescope simulations: flashers, illuminators, lasers, LEDs and stars, emitting photons at sky, telescope-sphere, telescope or camera level, as a standard-library-only C++20 core with a Python API writing gstrickd photon streams.
+
+`dlamb` is one module of a modular Cherenkov-telescope simulation chain
+(CORSIKA7 or light sources, atmosphere, optics, camera). Modules exchange photons as
+[gstrickd](https://github.com/gammasim/gstrickd) photon streams;
+[simtools](https://github.com/gammasim/simtools) configures and runs the chain.
+
+Status: pre-alpha, no functionality yet.
+
+## User Installation
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install dlamb
+```
+
+(requires python 3.14 or higher)
+
+## Developer Installation
+
+```sh
+python -m venv .venv
+source .venv/bin/activate
+python -m pip install -e '.[dev]'
+cmake --preset debug
+cmake --build --preset debug
+```
+
+Test your installation with:
+
+```sh
+ctest --test-dir build/debug --output-on-failure
+python -m pytest python/tests
+```
+
+## License and Citation
+
+BSD 3-Clause License, see [LICENSE](LICENSE). Please cite `dlamb` using the
+metadata in [CITATION.cff](CITATION.cff).

dlamb-0.0.1/cpp/bindings/core.cpp

@@ -0,0 +1,17 @@
+// Python.h must precede all standard headers (it sets feature-test macros such as
+// _POSIX_C_SOURCE), so the nanobind headers come first.
+#include <nanobind/nanobind.h>
+#include <nanobind/stl/tuple.h>
+
+#include "dlamb/version.hpp"
+
+#include <tuple>
+
+namespace nb = nanobind;
+
+NB_MODULE(_core, module) {
+  module.doc() = "dlamb native core";
+  module.def("core_version", [] {
+    return std::make_tuple(dlamb::version_major, dlamb::version_minor, dlamb::version_patch);
+  });
+}

dlamb-0.0.1/cpp/include/dlamb/version.hpp

@@ -0,0 +1,10 @@
+#pragma once
+
+namespace dlamb {
+
+// Version of the C++ core; the Python package version comes from the git tag.
+inline constexpr int version_major = 0;
+inline constexpr int version_minor = 1;
+inline constexpr int version_patch = 0;
+
+} // namespace dlamb

dlamb-0.0.1/cpp/tests/check.hpp

@@ -0,0 +1,43 @@
+#pragma once
+
+#include <cmath>
+#include <cstdio>
+#include <cstdlib>
+#include <exception>
+
+// Assertions that stay active in Release builds.
+inline int check_failures = 0;
+
+#define CHECK(condition)                                                                           \
+  do {                                                                                             \
+    if (!(condition)) {                                                                            \
+      std::fprintf(stderr, "%s:%d: CHECK failed: %s\n", __FILE__, __LINE__, #condition);           \
+      ++check_failures;                                                                            \
+    }                                                                                              \
+  } while (false)
+
+#define CHECK_NEAR(value, expected, tolerance)                                                     \
+  do {                                                                                             \
+    const double check_v = (value), check_e = (expected);                                          \
+    if (!(std::abs(check_v - check_e) <= (tolerance))) {                                           \
+      std::fprintf(stderr, "%s:%d: CHECK_NEAR failed: %s = %.17g, expected %.17g +- %g\n",         \
+                   __FILE__, __LINE__, #value, check_v, check_e, static_cast<double>(tolerance));  \
+      ++check_failures;                                                                            \
+    }                                                                                              \
+  } while (false)
+
+// Run the tests; an escaping exception counts as a failure.
+template <class Tests> int run_checks(Tests tests) noexcept {
+  try {
+    tests();
+  } catch (const std::exception &error) {
+    std::fprintf(stderr, "unexpected exception: %s\n", error.what());
+    ++check_failures;
+  } catch (...) {
+    std::fprintf(stderr, "unexpected exception\n");
+    ++check_failures;
+  }
+  if (check_failures)
+    std::fprintf(stderr, "%d check(s) failed\n", check_failures);
+  return check_failures ? EXIT_FAILURE : EXIT_SUCCESS;
+}

dlamb-0.0.1/cpp/tests/test_version.cpp

@@ -0,0 +1,11 @@
+#include "check.hpp"
+
+#include "dlamb/version.hpp"
+
+int main() {
+  return run_checks([] {
+    CHECK(dlamb::version_major >= 0);
+    CHECK(dlamb::version_minor >= 0);
+    CHECK(dlamb::version_patch >= 0);
+  });
+}

dlamb-0.0.1/docs/changelog.md

@@ -0,0 +1,2 @@
+```{include} ../CHANGELOG.md
+```

dlamb-0.0.1/docs/conf.py

@@ -0,0 +1,42 @@
+"""Sphinx configuration of the dlamb documentation."""
+
+import tomllib
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
+import yaml
+
+ROOT = Path(__file__).resolve().parents[1]
+
+project = "dlamb"
+copyright = "2026, dlamb developers"  # noqa: A001
+with open(ROOT / "CITATION.cff", encoding="utf-8") as file:
+    author = ", ".join(
+        f"{a['given-names']} {a['family-names']}" for a in yaml.safe_load(file)["authors"]
+    )
+with open(ROOT / "pyproject.toml", "rb") as file:
+    distribution = tomllib.load(file)["project"]["name"]
+try:
+    release = version(distribution)
+except PackageNotFoundError:
+    release = "unknown"
+version = release
+
+extensions = ["myst_parser", "sphinx.ext.autodoc", "sphinx.ext.mathjax", "sphinx.ext.githubpages"]
+source_suffix = {".md": "markdown"}
+root_doc = "index"
+exclude_patterns = ["_build", "changes"]
+myst_heading_anchors = 3
+myst_enable_extensions = ["colon_fence", "dollarmath"]
+
+html_theme = "pydata_sphinx_theme"
+html_title = project
+html_theme_options = {
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/gammasim/dlamb",
+            "icon": "fa-brands fa-github",
+        },
+    ],
+}

dlamb-0.0.1/docs/index.md

@@ -0,0 +1,11 @@
+# dlamb
+
+Artificial light sources for Cherenkov-telescope simulations: flashers, illuminators, lasers, LEDs and stars, emitting photons at sky, telescope-sphere, telescope or camera level, as a standard-library-only C++20 core with a Python API writing gstrickd photon streams.
+
+Status: pre-alpha, no functionality yet.
+
+```{toctree}
+:maxdepth: 1
+
+changelog
+```

dlamb-0.0.1/pyproject.toml

@@ -0,0 +1,71 @@
+[build-system]
+build-backend = "scikit_build_core.build"
+requires = [ "nanobind>=3.1", "scikit-build-core>=0.10", "setuptools-scm>=8" ]
+
+[project]
+name = "dlamb"
+description = "Artificial light sources for Cherenkov-telescope simulations"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [ { name = "dlamb contributors" } ]
+requires-python = ">=3.14"
+classifiers = [
+  "Development Status :: 2 - Pre-Alpha",
+  "License :: OSI Approved :: BSD License",
+  "Programming Language :: C++",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
+]
+dynamic = [ "version" ]
+dependencies = [
+  "numpy>=2.3",
+]
+optional-dependencies.dev = [ "nanobind>=3.1", "pre-commit", "pytest", "ruff" ]
+optional-dependencies.docs = [ "myst-parser", "pydata-sphinx-theme", "pyyaml", "sphinx" ]
+optional-dependencies.plot = [ "matplotlib>=3.8" ]
+
+[tool.setuptools_scm]
+fallback_version = "0.1.0"
+
+[tool.scikit-build]
+build-dir = "build/{wheel_tag}"
+cmake.args = [ "-DDLAMB_BUILD_TESTING=OFF" ]
+cmake.build-type = "Release"
+sdist.include = [ "cpp/**", "CMakeLists.txt", "python/**", "README.md", "LICENSE" ]
+wheel.packages = [ "python/dlamb" ]
+wheel.platlib = true
+# Editable installs rebuild the extension when the C++ sources change.
+editable.rebuild = true
+editable.verbose = false
+
+[tool.cibuildwheel]
+# Oldest macOS release supported by the binary wheels.
+macos.environment = { MACOSX_DEPLOYMENT_TARGET = "13.3" }
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+preview = true
+lint.select = [ "E", "F", "I", "UP" ]
+
+[tool.pyproject-fmt]
+max_supported_python = "3.15"
+
+[tool.towncrier]
+package = "dlamb"
+package_dir = "python"
+directory = "docs/changes"
+filename = "CHANGELOG.md"
+start_string = "<!-- towncrier release notes start -->\n"
+title_format = "## [{version}] - {project_date}"
+issue_format = "#{issue}"
+underlines = [ "", "", "" ]
+type = [
+  { directory = "feature", name = "Added", showcontent = true },
+  { directory = "bugfix", name = "Fixed", showcontent = true },
+  { directory = "maintenance", name = "Maintenance", showcontent = true },
+]
+
+[[tool.dynamic-metadata]]
+provider = "scikit_build_core.metadata.setuptools_scm"

dlamb-0.0.1/python/dlamb/__init__.py

@@ -0,0 +1,8 @@
+"""dlamb: artificial light sources for Cherenkov-telescope simulations."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("dlamb")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

dlamb-0.0.1/python/tests/test_import.py

@@ -0,0 +1,9 @@
+"""The package and its native extension import."""
+
+import dlamb
+from dlamb import _core
+
+
+def test_version():
+    assert isinstance(dlamb.__version__, str)
+    assert len(_core.core_version()) == 3