Profeel-An OS Dosimetry Data Analyzer
Profeel-An OS Dosimetry Data Analyzer
a r t i c l e i n f o a b s t r a c t
Article history: Background and objectives: This article presents Profeel, a Matlab (MathWorks Inc., MA) based open
Received 30 April 2021 source dosimetry data visualization and analysis software. Profeel aims to support quality assurance,
Accepted 11 September 2021
dosimetry and research in the field of radiotherapy by providing an environment to visualize, process and
analyse measured and simulated dosimetry data from several data sources used in radiotherapy practice
Keywords: and research.
Dosimetry Methods: The processing and analysis tools are based on routinely used dosimetry analysis methods, such
Matlab as gamma analysis, different data normalizations and data filtering. Additionally the Profeel performs an
Radiotherapy automatic 1 dimensional profile and percentage depth dose analysis in accordance with International
Quality assurance
Electrotechnical Commission definitions. All data can be operated by user created custom functions and
lower dimensionality data can be extracted from volume doses and dose planes.
Results: Profeel supports data import in all 3 dimensions and offers an intuitive user interface to perform
data visualization, processing and analysis between simulated and measured data. Profeel and its source
code are distributed free of charge under the General Public Licence (GPL).
Conclusions: Profeel has shown to be an agile tool for fulfilling various needs of several researchers and
since Profeel is under constant development and is an open source project, community needs, issues and
bug reports are taken into account in the development.
© 2021 The Author(s). Published by Elsevier B.V.
This is an open access article under the CC BY license (http://creativecommons.org/licenses/by/4.0/)
https://doi.org/10.1016/j.cmpb.2021.106457
0169-2607/© 2021 The Author(s). Published by Elsevier B.V. This is an open access article under the CC BY license (http://creativecommons.org/licenses/by/4.0/)
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
There are few published works considering open source pro- ‘analytical’ refers to solving the line or plane cross sections ana-
grams and tools for radiotherapeutic dosimetry data analysis. Pro- lytically in cases where the initial linear interpolation sampling is
grams, such as Computational Environment for Radiological re- not adequate, e.g. when lower dimension extraction is requested
search (CERR) [1] SlicerRT radiation therapy toolkit for 3D slicer from a point that does not exist in the data structure. The user is
[2] and XSTING [3] are developed tools for radiotherapeutic re- prompted to wait during data import, since large dataset import
search purposes, but do not support measured data import and times may be long (minutes). For .3ddose data type, the measure-
thus, computed and measured data comparison. Other published ment uncertainty (‘error’ in Profeel) dataset can optionally be ne-
dosimetry and dose calculation software often require custom glected, thus halving the import time. Otherwise the uncertainty
measurement setups [4], are intended on fields outside of radio- data will be imported as default.
therapy [5] or focus on radiotherapy treatment planning and op- Data- and metadata structures are added to the main struc-
timization [6,7], and rarely supply the source code. Unpublished ture during lower dimension extraction, similar to the structure
work such as 3ddose-tools (.3ddose) [8] and web-based VICTORIA transformations during the data import. If the user-requested plane
(.3ddose, .dcm, .egsphant) [9] allow the user to import, visualize does not exist in 3D stack, Profeel interpolates the plane from the
and plot computed data but unfortunately do not support mea- requested position. For analogous cases in 1D, Profeel finds the
sured data formats. At the time and until today, to the best of our nearest existing points from the linearly interpolated data sub-
knowledge, there are no existing open-source programs to visual- structure.
ize, process and analyze the required source data (see section 3.1)
from a dosimetric standpoint. 2.3. Interactive profile
Imported 1D and 2D data are automatically interpolated with 2.4.1. Data preparation for gamma analysis
linear interpolation to 10 times the original resolution, i.e. values Profeel prepares the data for gamma computation by automat-
are added linearly between successive data points, preserving the ically matching the spatial dimensions between the two datasets
original points. Interpolated data is then added to the data struc- by truncating the largest axes. Hence, analysed input data does not
ture. 3D data is not interpolated during import, apart from lower have to have the same spatial dimensions. Both datasets are also
resolution interpolation. The interpolated data is used as the de- interpolated to the same resolution, if their physical sampling di-
fault data source for profile and PDD parameters, and for ‘brute mensions disagree, so that gamma, DTA and DD can be computed
force’ method computations. Additionally, interpolated data is used for each data point. The default sampling resolution is equal to the
as the source data in ‘analytical method’ computation for gamma dataset with lower resolution, but the used resolution can be mod-
parameters and lower dimension data extraction. Here the ‘brute ified by the user.
force’ method refers to additional interpolation, finding the clos- The gamma analysis results are sensitive to the statistical fluc-
est values in a numeric manner through linear interpolation, and tuations present in MC dose distributions, as described by Graves
2
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
et al. [12] Therefore the user of Profeel has an option to apply Table 1
Supported data types in Profeel.
the smoothing prior to gamma analysis and to choose whether
to use MC dose distribution as reference or as evaluation dataset. Data type Extension
Additionally, the user can use custom functions to operate both PTW beamscan exports .mcc
input datasets along with several different normalization options IBA Omnipro exports ASCII, .OmniIMRT, .opg
(section 3.1). PTW software exports ASCII
EGSnrc output files .3ddose.dcm
2.5. Error determination due to finite grid sampling DICOM RT RD dose files
Matlab structures compatible with Profeel .mat
(previous sessions)
Finite sampling introduces error to the computed DTAs, which
further transfers to the gamma-indices. The user is informed about Table 2
the error in the DTA result legend. The origin of the error is pre- Normalizations in profeel.
sented in Fig. 1.
Normalization type Applicable data
DTAs are computed within a moving neighbourhood on a sur-
face S⊂Z2 : for which, function f: S → R and reference dose point No normalization 1D, 2D 3D
Normalization to maximum 1D, 2D 3D
c ∈ R. Let’s define the neighbourhood H s.t.
Normalization to central axis (CAX) 1D
H := {(r1 , r2 ) ∈ S|r1 − r2 ≤ ( f (r1 ) − c ) · ( f (r2 ) − c ) < 0}, (3) Distance percentMean value from range 1D1D
Normalization to value 1D, 2D 3D
where maximum
√ error within the neighborhood becomes ξ =
r2 − r1 = 2 · resolutionx,y , for spatially isotropic square grids. As
demonstrated in Fig. 1, the spatial order of D2 and D3 from the ref-
All data with the same dimensionality can be visualized and
erence dose is known, thus the actual DTA must lie within ξ from
processed simultaneously as presented in Fig. 2.
D2. This only accounts for error due to finite grid sampling in DTA
Profeel offers several data processing and analysis tools with
algorithm.
varying flexibility, and data and result exportation in .mat and .csv
3. Results formats for further processing and analysis. Data saved in .mat
form is equivalent to saving the work session and can be imported
Profeel open-source project was originally created as a support- to Profeel as such.
ive tool for intuitive dosimetry data comparison and analytics be-
tween different data sources used in radiotherapy quality assur- 3.2. User interface
ance (QA). Subsequently project development has been directed to-
wards research purposes. The project was initialized in 2020 at the The Profeel graphical user interface (GUI) is built in the Mat-
Department of Oncology at Tampere University Hospital (Tays). lab (MathWorks Inc., MA) R2020a graphical user interface devel-
opment environment (GUIDE). Profeel GUI is presented in Fig. 3,
3.1. Supported data types for which, the GUI object groupings are presented in Table 3.
The UI figure, visualizing the data is referred as the ‘main fig-
Profeel (v. 1.17) supports several different data types, includ- ure’. After data import, the data chosen from group b) is presented
ing commonly used dosimetry measurement equipment outputs in in the main figure. In the example in Fig. 3, a 3D DICOM RT dose
radiotherapy QA, and computed or simulated output file formats dataset is chosen. 3D data is saved during import to a Matlab
listed in Table 1 structure as 2D stacks, which can be navigated through with the
There are no limitations for the number of imported data other mouse scroll wheel. 2D and 3D data are always presented as 2D
than set by the amount of computer memory. All datatypes are slices/planes in Profeel.
reconstructed to common structural form (.mat), containing raw,
processed, result, parent reference and metadata fields. 3.3. Data processing tools
Lower dimension data can be extracted from higher dimen-
sions, i.e. 2D and 1D from 3D and 1D from 2D. Available data nor- Data processing tools are mainly located in GUI grouping c),
malizations are presented in Table 2. under the ‘Main data processing panel’. The panel includes sub-
3
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
Table 3
Profeel GUI groupings in Fig. 3.
a) Data import panel Data import button and 1D CAX correction during import
b) Imported data listbox Contains all imported data. Data is activated by mouse click.
c) Main data processing panel Orientation, scaling, data filtering and custom operations
d) Profile and PDD parameters(See chapter 3.4) Shows automatically computed 1D profile and PDD parameters
e) Data normalization panel Different normalizations (see Table 2)
f) Gamma, DTA and DD panel Gamma analysis tools
g) Data exportation panel .csv and .mat data export
h) Tool ribbon Additional and future tools
4
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
Table 4
Profile parameters.
CAX dev [cm] Offset between computed CAX and data position axis 0-point. Computed CAX is derived from the computed field size as
the symmetric center
Sym [%] Profile symmetry is defined inside the flattened region as max(d(x)/d(-x)), where d(x) refers to the dose value at point x.
Dmax [%] Relative maximum dose to CAX within the flattened region
Dmin [%] Relative minimum dose to CAX within the flattened region
Dev [%] Dose deviation between CAX and the minimum dose within the flattened region
Fieldsize [cm] Fieldsize is defined at 50% dose value around the CAX
PenR & PenL [cm] Right and left side penumbras, defines as the distance between 80% and 20% dose values from CAX
Table 5
PDD parameters.
R100, R80, R50 [cm] 100%, 80% and 50% relative to maximum dose depths from the surface, respectively.
D100, D200 [%] Relative doses at depths of 10 and 20 cm from the surface, respectively.
Ds [%] Surface dose relative to the maximum dose. Surface is defined as the depth of 0.05mm in the IEC 60976.
J100/J200 Dimensionless quality parameter. Ratio between doses at 10 and 20 cm, respectively
5
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
3.4.2. Gamma, DTA and DD analysis Gamma, DTA and DD results are shown automatically in the
Gamma, DTA and DD analysis are performed after the user has main figure legend after computation. The legend is located by de-
set required parameters in the UI panel f). First, the user selects fault in the north-east corner of the figure. For 1D data, all cho-
the data (1D or 2D), so that the reference data is selected first. sen line profiles and pass percentages are presented in the legend,
Gamma criteria are set as default to 3% (DD) and 3 mm (DTA), i.e. target data, reference data, brute force computation results and
but the values can be modified by the user preceding the gamma analytical computation results consisting of DTA, relative DD and
analysis from the respective edit fields. Gamma interpolation res- absolute DD.
olution defaults to the lower resolution data by default, but can 2D pass percentages are presented similarly in the main fig-
also be changed from the ‘interp-interval’ edit field, located in the ure legend, but 2D distributions can only be viewed when refer-
UI group e), which will perform linear interpolation using the re- ence data (data which was chosen 1st to the analysis) is activated.
quested resolution. The gamma, DTA and DD computations are ex- Gamma, DTA or DD distribution can be chosen from UI group b)
ecuted for the whole data area by default, but the user may change from respectively named buttons. Additionally, the quick profile
the analysis area by setting an isodose level from isodose edit field, tool can be used to inspect the results against the dose profile in
which limits the computation to doses equal, or higher to the set 1D.
level as presented in Fig. 7.
6
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
Fig. 8. Quick profile comparison between the Eclipse treatment plan and Monte carlo simulated dose data, before gamma analysis.
Gamma, DTA and DD results can be exported to .mat or .csv for- function and constants were first added in a custom function ASCII
mat from the export buttons shown in Fig. 5. .mat format contains file, which was then operated on the 3D dataset via a custom func-
all data in the saved structure including the results, but the .csv tion tool in Profeel (GUI group C). Next, proper transversal slices
format exports only the 1D normalization and interpolated data for analysis were searched, inspected with the quick profile tool
with the results. For 2D data, only final gamma, DTA and DD pass and extracted from both datasets. The quick profile inspection is
percentages are exported during .csv export. presented in Fig. 8
No additional normalization was chosen, since in this case
proper dose calibration data was available. Next 2D gamma anal-
3.5. Sample run
ysis was performed for the data with 20 Gy isodose limit and the
default 3 mm DTA and 3% dose difference criteria. With this con-
Sample run was performed with a DICOM RT export of volu-
figuration, the 2D gamma pass percentage was found to be 94.35%
metric modulated arc (VMAT) plan from Eclipse TPS (version 13.6)
with 79,9% DTA and 60.9% dose difference pass percentages. The
(Varian Medical Systems Inc., Palo Alto, CA, USA) and Monte Carlo
individual gamma and gamma component maps were then in-
simulated .3ddose data for the same case. After import, the units
spected with the quick profile tool, which overlays the gamma re-
of the .3ddose data set were scaled using known calibration in-
sults with the dose distribution as shown in Fig. 9.
formation for the simulated treatment machine. The dose scaling
7
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
8
T. Pakarinen and J. Ojala Computer Methods and Programs in Biomedicine 212 (2021) 106457
Acnowledgemenets [7] Sang-Won Kang, Jin-Beom Chung, Kyeong-Hyeon Kim, Ji-Yeon Park,
Hae-Jin Park, Woong Cho, Sven Olberg, Tae Suk Suh, Justin Park, Devel-
opment of Volumetric Independent Dose Calculation System for Verification
Authors have no competing interest to declare. This research of the Treatment Plan in Image-Guided Adaptive Brachytherapy, Frontiers in
did not receive any specific grant from funding agencies in the Oncology (2020) 10.609.10.3389/fonc.2020.00609.
public, commercial, or not-for-profit sectors. [8] Martinov, M., Thomson, M. 3ddose_tools, v. 1.1, GitHub repository. 2016.
Retrieved from https://physics.carleton.ca/clrp/3ddose_tools/3ddose-tools [Ac-
cessed 28.4.2021].
References [9] Badum, E. VICTORIA - Voxel Interactive Contour Tool for Online Radiation
Intensity Analytics. 2021. Retrieved from http://web.uvic.ca/∼bazalova/dose_
[1] J. Deasy, A. Blanco, V. Clark, CERR: a computational environment for radio- viewer [Accessed 28.4.2021].
therapy research, Med Phys 30 (5) (2003 May) 979–985 PMID: 12773007, [10] DA Low, WB Harms, S Mutic, JA. Purdy, A technique for the quantitative eval-
doi:10.1118/1.1568978. uation of dose distributions, Med Phys 25 (5) (1998) 656–661, doi:10.1118/1.
[2] C Pinter, A Lasso, A Wang, D Jaffray, G. Fichtinger, SlicerRT: radiation therapy 598248.
research toolkit for 3D Slicer, Med Phys 39 (10) (2012 Oct) 6332–6338 PMID: [11] Geurts, M. CalcGamma, GitHub repository. 2014. Retrieved from https://github.
23039669, doi:10.1118/1.4754659. com/mwgeurts/gamma [Accessed 5.8.2020].
[3] Omer, H., Alzimami, K. and Sulieman, A., “XSTING, Software for Evaluation [12] YJ Graves, X Jia, SB. Jiang, Effect of statistical fluctuation in Monte Carlo based
of Radiotherapy Planning Performed Using EGSnrcMP Codes”, Current Medical photon beam dose calculation on gamma index evaluation, Phys Med Biol 58
Imaging. 2014 10: 48. doi: 10.2174/157340561001140424145206. (6) (2013 Mar 21) 1839–1853 Epub 2013 Feb 27. PMID: 23442443, doi:10.1088/
[4] JY Park, JW Lee, KS Choi, JS Lee, YH Kim, S Hong, TS Suh, Development of a 0031-9155/58/6/1839.
novel quality assurance system based on rolled-up and rolled-out radiochromic [13] MathWorks. 2020. Matlab Documentation - Savitzky-Golay filtering. Re-
films in volumetric modulated arc therapy, Med Phys 38 (12) (2011 Dec) 6688– trieved from https://se.mathworks.com/help/signal/ref/sgolayfilt.html [Ac-
6696 PMID: 22149851, doi:10.1118/1.3659706. cessed 9.4.2021].
[5] H Wang, Q Liu, D Wan, J Xiang, L Du, Y Wang, J Cao, Y Fu, F Fan, M. Hecker, [14] T. Pakarinen, J.Profeel Ojala, Open Source Dosimetry Data Visualization and An-
BioDoser: improved dose-estimation software for biological radiation dosime- alytics Software, v. 1.17, GitHub repository (2020). [Accessed 9.4.2021]. https:
try, Comput Methods Programs Biomed 108 (1) (2012 Oct) 402–406 Epub 2012 //github.com/TPakar/Profeel.
Apr 14. PMID: 22503129, doi:10.1016/j.cmpb.2012.03.010. [15] IEC - International Electrotechnical Commission, Medical electrical equipment
[6] H.-P. Wieser, E. Cisternas, N. Wahl, S. Ulrich, A. Stadler, H. Mescher, L.-R. Müller, - Dosimeters with ionization chamber as used in radiotherapy, IEC Standard
T. Klinge, H. Gabrys, L. Burigo, A. Mairani, S. Ecker, B. Ackermann, M. Eller- 60976 (2011) Genève: IEC.
brock, K. Parodi, O. Jäkel, M Bangert, Development of the open-source dose [16] M Hussein, CH Clark, A. Nisbet, Challenges in calculation of the gamma index
calculation and optimization toolkit matRad, Med. Phys. 44 (2017) 2556–2568, in radiotherapy - Towards good practice, Phys Med 36 (2017 Apr) 1–11 Epub
doi:10.1002/mp.12251. 2017 Mar 14. PMID: 28410677, doi:10.1016/j.ejmp.2017.03.001.