The pln struct - e0404/matRad GitHub Wiki
The pln struct holds the meta information about the radiation treatment plan in the following fields.
pln.radiationMode
Specifies the radiation modality. Can either be photons, protons, or carbon.
pln.machine
In order to load the appropriate base data, one can introduce the machine in which the treatment plan have incorporated and the code will look for the file under {pln.radiationMode}_{pln.machine}.mat. For example, setting pln.machine to 'Generic' for a photon treatment plan will load the already available photons_Generic.mat file.
pln.numOfFractions
Specifies the number of fractions. Note that this parameter only needs to be set for biological treatment planning for carbon ions, where the optimization process is based on the fraction dose and not based on the overall dose.
Starting from Version 3.0.0, the pln holds the meta information in two separate substructures, one for steering meta information under pln.propStf and the other for optimization meta information under pln.propOpt. There is also the possibility to opt for a different resolution grid for dose calculation by introducing it under pln.propDoseCalc substructure.
pln.propStf.gantryAngles
Specifies the gantry angles as MATLAB vector according to the matRad coordinate system.
pln.propStf.couchAngles
Specifies the couch angles as MATLAB vector according to the matRad coordinate system.
pln.propStf.bixelWidth
Specifies the width (and height) of quadratic photon bixels (i.e. discrete fluence elements). For particles, this parameter specifies the lateral spot distance.
pln.propStf.numOfBeams
Specifies the number of beam directions. During the matRad script, this parameter is automatically determined.
pln.propStf.isocenter
Specifies the isocenter of the treatment plan in voxel coordinates within the ct.cube. By default, the isocenter is calculated as the center of gravity of all voxels belonging to structures that have been modeled as target volume in the cst cell.
pln.propOpt.bioOptimization
Specifies the type of biological optimization. none corresponds to a conventional optimization based on the physical dose. effect corresponds to an effect based optimization according to Wilkens & Oelfke. RBExD corresponds to an optimization of the RBE weighted dose according to Krämer & Scholz.
pln.propOpt.runDAO
Setting this value to true will enable Direct Aperture Optimization run allowing us to directly optimize aperture shapes and weights.
pln.propOpt.runSequencing
Setting this value to true will enable sequencing algorithms run.
The following properties of the pln struct can additionally be adjusted. If they are not explicitly set, default values are used. The default values are handled by the MatRad_Config class.
pln.propStf.longitudinalSpotSpacing
Specifies the longitudinal spot spacing. Default: 3 mm.
pln.propStf.addMargin
If this property is set to true, the target is expanded for beamlet finding. Default: true.
pln.propDoseCalc.doseGrid.resolution
Specifies the resolution for the dose calculation. Default: x direction: 3 mm, y direction: 3 mm, z direction: _3_mm.
pln.propDoseCalc.defaultLateralCutOff
Specifies the lateral cutoff. Default: 0.995 rel..
pln.propDoseCalc.defaultGeometricCutOff
Specifies the geometric cutoff. Default: 50 mm.
pln.propDoseCalc.ssdDensityThreshold
Specifies the ssd density threshold. Default: 0.05 rel..
pln.propOpt.defaultMaxIter
Specifies the number of maximum iterations. Default: 500.
pln.propMC.ompMC_defaultHistories
Specifies the number of particles simulated per pencil beam photon Monte Carlo calculation ompMC. Default: 1e6.
pln.propMC.ompMC_outputVariance
If it is set to true, variance scoring for MCsquare is not supported for the photon Monte Carlo calculation ompMC. Default: false.
pln.propMC.MCsquare_defaultHistories
Specifies the number of particles simulated per pencil beam for the proton Monte Carlo calculation MCsquare. Default: 1e6.
pln.propMC.direct_defaultHistories
Specifies the number of particles simulated per pencil beam for the Monte Carlo calculation when bypassing the dij calculation. Default: 2e4.
pln.disableGUI
If this value is set to true, matRadGUI is disabled. Default: false.
