All data in this repository is only preliminary, and may still be subject to change.
This repository serves as a centralized location for all Monte Carlo (MC) simulations relevant to calculating dose, LET, and other derived quantities for a proton therapy reference setup.
The primary reference setup explicitly omits detector details. This is intentional. The objective is to ascertain how effectively a detector can gauge the LET at a specific position as if the detector was absent. This concept draws parallels to cavity theory, where the dose in a given point is assessed as though no detector is present.
Certain detectors will necessitate specialized calculations. For such cases:
- Users can fork this repository and integrate their detector-specific simulations.
- Alternatively, a dedicated folder can be introduced within this repository for those detector-specific calculations.
Multiple MC codes will be used.
Most MC codes here use a native convention of beam transport along the positive Z-axis, as is convention for most MC codes, also to minimize confusion during setup in the experimental room. z_iso = 0.0 cm marks the isocenter position. Note that this +Z direction is the native MC convention, not the canonical storage/comparison frame: results are compared in the DICOM/IEC patient frame, and "depth" is a derived scalar. See docs/coordinates.md for the authoritative contract.
The DCPT beam model is supplied. It is defined on a plane upstream of the isocenter (50 cm for v2, 60 cm for v5) and is independent of transport direction — it is not anchored to a signed world-z coordinate. See docs/coordinates.md.
- Coordinate conventions (patient frame, derived depth, per-code transforms): docs/coordinates.md
- Simulation geometry: docs/geometry.md
- Irradiation Plans: data/resources/plans/
- Scoring geometry: docs/scoring.md
- Detector reference (
detect.datlayout): docs/detector_reference.md - Interactive plot browser: aptg.github.io/2022_DCPT_LET — comparison plots across MC codes, built automatically from tracked result files via
.github/workflows/pages-gallery.yml
You can create new issues, and create new branches based on these issues. The branches will be reviewed before entering the master branch. See also doc/contributing.md for general guidelines.
To cite this work please referer to the Zenodo dataset https://zenodo.org/records/10641085 It can be cited as:
Bassler, N., Grzanka, L., Christensen, J. B., Villads J, Brkić, H., Perrot, Y., Pasariček, L., & Romero-Expósito, M. (2024). MC particle transport simulations for the 2022 LET-measurements at DCPT: v1.0.0 (v1.0.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.10641085