Welcome to IDEAL’s documentation!

Independent DosE cAlculation for Light ion beam therapy using Geant4/GATE. Also known as “pyidc” (python module for independent dose calculation).

This is the 1.0 release of the IDEAL project. This was developed between February 2018 and March 2021 at EBG MedAustron GmbH, in collaboration with ACMIT Gmbh and the Medical University of Vienna. This code has been tested to work correctly for treatment plans with the fixed beam lines of the MedAustron clinic. At the time of this release it has not yet been tested at any other clinic, but we hope that this software will be useful at other clinics as well.

If you wish to install this 1.0 release, please clone this code directly from GitHub on a shared disk of the submit node of your HTCondor cluster and follow the installation instructions.

In order to facilitate installation with pip, the code will be reorganized a bit. In particular the ideal python module will effectively be renamed pyidc, in order to avoid a name collision with another python module. This reorganized version of IDEAL will get release tag 1.1.

This project will not work until it has been properly configured, regardless of whether you install this project by cloning or with pip (v1.1 and later). Please take your time and read the Installation and Commissioning sections of the documentation carefully.

Contents

• Overview
  • Synopsis
  • Disclaimers
  • Intended Use
  • Intended Users
  • User interfaces
• Installation
  • System requirements
  • IDEAL installation
• Commissioning
  • System configuration file
  • Log daemon configuration file
  • API configuration file
  • Beam line modelling
  • CT protocol Hounsfield Lookup tables
  • Phantoms
  • Simulation parameters
• User Manual
  • The IDEAL workflow
  • Requirements and limitations on DICOM input
  • Details per user interface
• DICOM specification
• Reference manual
  • Architectural overview
  • Developers’ manual
  • TODO list
  • Modules

Indices and tables

• Index

• Module Index

• Search Page

References

[GateGeant4]

Gate is a Geant4 application for medical imaging and dosimetry studies, see the OpenGATE website.

[GateRTion]

Gate/Geant4 release for clinical ion therapy applications, GATE-RTion, see the GATE-RTion website and Technical Note: GATE-RTion: a GATE/Geant4 release for clinical applications in scanned ion beam therapy by L. Grevillot et al., PMID: 32422684 DOI: 10.1002/mp.14242.

[HTCondor]

High Throughput Computing with Condor, see HTCondor home page and the HTCondor docs.

[Schneider2000]

Schneider W., Bortfeld T., Schlegel W.: Correlation between CT numbers and tissue parameters needed for Monte Carlo simulations of clinical dose distributions. Phys Med Biol. 2000; 45: 459-478.

[Winterhalter2020]

Carla Winterhalter et al.: Evaluation of GATE-RTion (GATE/Geant4) Monte Carlo simulation settings for proton pencil beam scanning quality assurance, DOI: 10.1002/mp.14481.

[FuchsBeamlineModels2020]

Hermann Fuchs et al., Computer assisted beam modeling for particle therapy DOI 10.1002/mp.14647

[Python3]

Python 3, see the Python main website and the Python docs.

[Ubuntu]

Ubuntu Linux.

[VeriSoft]

VeriSoft by PTW.

[RayStation]

RayStation by RaySearch.

[GPLv3]

GNU General Public License v3.0, by the Free Software Foundation.