Skip to content

Tutorials

Hands-on Python tutorials for the AEGIS dosimetry engine. Each tutorial is a self-contained script that runs after pip install -e ".[viz]" with no STL files or external data required. Synthetic meshes (spheres, cylinders) stand in for human body phantoms.

Formats

Every tutorial is available in two formats:

  • Documentation pages (you are here) - read the tutorials with rendered equations and explanations
  • Jupyter notebooks in the notebooks/ directory - run the tutorials interactively, cell by cell

The markdown files in docs/tutorials/ are the source of truth. Notebooks are generated from them using Jupytext via a sync script. To regenerate after editing a tutorial:

python tools/sync_notebooks.py

The notebooks are numbered (01_quickstart.ipynb, 02_fidelity_levels.ipynb, ...) to reflect the recommended reading order.

Contents

  1. The geometric absorption law: Core equation, single plane wave, ReLU projection, multipath superposition
  2. Fidelity levels and convergence: The nine-level computational hierarchy, sweep_levels, level comparison plots
  3. Tissue physics and Fresnel transmission: Cole-Cole model, pseudo-Brewster compensation, angle-dependent transmission
  4. ICNIRP 2020 compliance: Regulatory limits, compliance evaluation, power sweeps, link budget analysis
  5. Coherent MIMO and ECBF: Field channel, exposure operator Q, MRT beamforming, exposure-constrained precoding

Each tutorial references equations from the AEGIS monograph and explains the underlying physics alongside the code.

WAVES Ghent University imec