Software Products for the Radiological Sciences
|Home Page||Product Review||Program Manuals||Download Programs||Purchase||Site Map|
|Dosimetry Check||MarkRT (VGRT)||RtDosePlan||System 2100||MillComp||C++ Library|
Update files will be posted here. You will be notified of when an update is available.
Download the install file for updates:
Currently FDA cleared and CE MARK:
updatedcV5R7.exe to update to version 5 release 7, password protected. Run the install program updatedcV5R6.exe. You will need a new license key from Math Resolutions for version 5 from version 4. If going from version 4 to version 5, we recommend that you first email us your license file c:\mathresolutions\rl.dir\DosimetryCheck.lic so that we can add the new key to the file and return to you before you install the update. Please down load the release notes: CCReleaseNotes.pdf and review for important information.
Linux: Download the update tar file
Version 4 Release 11: linuxupdate.tar.gpg , password protected. Do:
tar -xvf linuxupdate.tar
sudo cp -v librlmrl64.so /usr/lib
The update will include all of the changes listed for prior updates. Also there will be a directory rlfiles.d that might contain new program resource files that you might not have. If you need one, edit the file and copy to the program resource files directory rl.dir. We do not otherwise want to wipe out a file you have already changed.
To include all prior changes:
13 April 2018: Added fitting off axis transmission to the EPID deconvolution file for better fit for large field sizes for exit-transit dosimetry. EPID kernel file format changed to level 4 with transmission parameters added to the EPID kernel file. EPID convert utilities updated to read the new data format. DosimetryCheck updated for Tomo Radixact Dicom detector file.
21 March 2018: Corrected wrong color for "false" for gamma summary with a theshold dose. 14 March 2018: Dosimetry Check Version 5 Release 7: Dose volume histogram dose limits with summary on a web page. Review this new featuure in the Dosimetry Check reference manual Volume Histogram Dose Limits The programs uses the Dicom tags <300A,25-28> for targets and <300A,2A-2D> for organs at risk, picking up the dose and fraction limits from the planning system or a protocol file. In addiction there is minimum limit on target dose and maximum limit on organ at risk dose. Corrected error in ReadDicomCheck released in Dosimetry Check versions V5 release 4, 5, and 6 where the AutoRead would not work. Download a corrected copy of ReadDicomCheck.exe here but it is also included in the above update. Put this program in c:\mathresolutions.
7 Feb 2018: Dosmetry Check version 5 release 6 dated 7 Feb 2018. More control is added in the user preference file for the collapsed cone algorithm. See the section on the "Algorithm Default File" in the "Dose Algorithm" section of the Dosimetry Check reference manual. With this update you will get a new DefaultDoseAlgorithm.txt file in the program resources directory rl.dir, so you will want to review that.
24 Jan 2018: Dosmetry Check version 5 release 5 dated 24 Jan 2018. Corrected error introduced in V 5 R 2 in regard to electron contamination calculation for the CC algoritihm near dmax. The statistics for the gamma passing rate on a plane intersecting a selected ROI volume will be displayed in the auto report on that plane. Prior only the statistics for the patient volume, the external contour, was shown. Now all volumes selected for gamma volume histogram will also be reported on the transverse, coronal, and sagittal planes. The statistics is only for points on the plane inside the respective volume.
18 Dec 2017: A correction was made in program ConvertIMATImages that corrected the writing of a text file into the folder where the calibation is stored for future use, that will eventually result in an error message that not all input files could be processed when in fact no real error occurred.
11 Dec 2017: Dosimetry Check Version 5 release 4, bug fix for TomoTherapy machine in regard to re-computing a plan computed from an earlier version, lacking a file recently added below. Program would initially fail to pick up the dose convert constant, resultion in no dose being computed.
16 Oct 2017: Dosimetry Check Version 5 release 4. Added check and error report statement in regard to the below 4 August 2017 change for TomoTherapy. Changed program for TomoTherapy to use the same algorithm when there is an automatic recompute instead of reverting to the defaault algorithm. Added patient's birthdate to exported Dicom dose file.
4 August 2017: Dosimetry Check Version 5 release 4 corrected for TomoTherapy machine where by if retrieving a plan computed prior with pencil beam, the algorithm was reported as CC on the points report instead of PB. Date of release is now 3 August 2017.
10 July 2017: Dosimetry Check Version 5 release 4 is strictly a bug correction for releases 1 through 3. For a very long stacked image set (in the feet to head direction), the convolution/superposition collapsed cone algorithm might stop computing the dose after about 60 to 65 cm from the inferior end of the patient.
5 June 2017: Dosimetry Check Version 5 release 3. Changes: Gamma volume histogram now computed in parallel. Added options for batch mode to produce Dicom export of dose.
4 Jan 2017: Dosimetry Check Version 5 release 2. change is increased speed for convolution/superposition calculation.
19 Dec 2016: Dosimetry Check Version 5 release 1 has been recompiled and relinked with the assigned date changed to 19 Dec 2016, with a correction for the possibility of a parallel thread not completing.
5 Dec 2016: Dosimetry Check Version 5 release 1:
The convolution/superposition "collapsed cone" dose algorithm was added. Please down load the release notes: CCReleaseNotes.pdf and review for important information.
24 June 2016: Dosimety Check Version 4 release 11
The gamma normalization dose upon initializing the auto report will default to the largest dose in the planning system downloaded dose matrix instead of the dose at isocenter. This was changed because isocenter is not always in the target. The user is otherwise responsible for typing in the dose to use for the gamma percent.
For the auto report, a log file was created that will record the percent of the volume that is less than a gamma of one. The log file is appended to every time an autoreport is run, recording the patient's name, plan name, date and time, and name of the volume reported. A pass or fail is written depending upon the user's specified pass fail rate. This log file will allow for a quick look at results for all patient trials. Review this function in the manual gamma log file.
12 April 2016: the executable AutoProcessEPIDImages.exe, part of AutoRunDC,
was corrected to use the machine named in the plan to look up the air gap
correction file for exit images.
29 Feb 2016: ReadDicomCheck will now set holes allowed for ROI structures of type SUPPORT (for couch modeling).
8 Feb 2016: corrected ReadDicomCheck for change in Tomotherapy encoding of plan file involving position of jaws.
5 Feb 2016: reloaded update for correction for Siemens images with AutoRunDC.
20 Jan 2016: reloaded the update with a minor correction for ReadDicomCheck when reading in a large dose matrix from the planning system.
22 July 2015: DosimetryCheck version 4 release 10:
The patient folder (directory) name will have the patient ID number appended to it. So patient James Bond with ID 007 will be under the folder name Bond_James_007. For automation with current patients you must rename the patient's folder by appending underscore and the current patient ID (shown on the printouts) to the folder name. Otherwise AutoRunDC will not be able to match the EPID images to the patient as it will be looking for the name with the ID appended. ReadDicomCheck will create all future patients entries in this manner when it is left to create the patient entry (when you do not select NEW under patient and enter the name manually).
The program will now track the user login name of who last changed a plan for a patient that would require recalculation. That name will appear on reports. This will start with all new patient's created with ReadDicomCheck. To implement with a current patient, select the plan that was downloaded, change the matrix size (release mouse) and then change it back again.
Export of DC dose now works for trial plans created by AutoRunDC.
25 June 2015: ConvertIMATImages version 4 release 20 is available
for use with RapidArc on a TrueBeam machine.
This version has
a added feature that will allow the user to correct for the wrong
SID in the Dicom RT EPID file from Varian version 2.0, and to
add 90 degrees to the gantry angle to correct for the gantry
angle of the kVp imagier being reported instead of the MV imagier.
Please read the new item for TrueBeam in the IMAT manual:
Note also that Varian has
corrected this in their version 2.5 MR1. ConvertIMATImages must
be used for TrueBeam. AutoRunDC will not be able to make this correction
or sort out which images belongs to which arc. You cannot use static
IMRT mode for the calibration image.
This update also includes ConvertEPIDImages and a component of AutoRunDC that will match static TrueBeam EPID files to beams by means of the gantry angle. In TrueBeam static files the image label contains the form MV_90 where 90 is the gantry angle. Note that the plan name is not included, so the latest plan downloaded has to be assumed. Static EPID files are integrated in IMRT mode. You must use the same mode for the calibration image.
3 June 2015: Dosimetry Check Version 4 release 9: change is to account
for TomoEdge for TomoTherapy.
14 May 2015: Added running auto report from the Convert...Images utilities.
Version 4 release 8 of DosimetryCheck: added default file for setting default values for gamma distance and percent.
1 May 2015: Added initial selecting of beam for IMAT plan from image label in selected images for program ConvertIMATImages. Improved same for IMRT in program ConvertEPIDImages.
20 April 2015: bug corrected in AutoRunDC not resetting gamma if you run the same EPID images a second time.
Bug corrected in CalibrateEPID for reading in multiple images.
Support for TomoTherapy Dicom detector added to AutoRunDC.
DosimetryCheck version 4 release 7: only change is AutoReport can be accessed when there are no fluence files to make specifications only.
14 April 2015: Corrected run AutoRunDC for collimator setting.
Added searching two deep sub-directories.
24 March 2015: IviewToDicom corrected for copying inclinometer file.
19 March 2015: AutoRunDC: corrected not using the roll off term in the program resource file DeconvRollOff.
13 March 2015: corrected bug in the automated EPID processing program if EPID name did not equal the machine name. Patient matching is changed to case insensitive.
4 March 2015: Version 4 release 6 of DosimetryCheck. Added display of gamma statistics for doses >= a threshold dose for a plane.
25 Feb 2015: Automated processing of EPID images to production of the auto report. This does not change the Dosimetry Check executable but rather ReadDicomCheck, IviewToDicom, and an additional program called AutoRunDC. You must read Automatic processing of EPID images to Dose Comparison (Auto) Report
5 Jan 2015: updated DosimetryCheck to Version 4 release 5 to read TomoTherapy detector files in Dicom format (or the prior binary bin files). This is only for the clinical treatments, not the utilities.
8 Dec 2014: updated ConvertIMATImages for TrueBeam RapidArc. Program will read in continuous images and group into increments of 5 degrees, creating a beam every 5 degrees or so to simulate the rotation.
23 Oct 2014: updated ReadDicomCheck to version 2 release 13 with correction for feet first patient. Only first beam was being marked as feet first prior to this fix.
12 Sept 2014: Version 4 release 4 of DosimetryCheck. Added storing and retrieving ROI volumes as a template, primary for the purpose of storing and reusing a couch model. Review Outlining in the System2100 manual Moving an ROI volume. This includes a new procedure for moving an ROI volume since you will have to make an adjustment for a different stacked image set. Also, information popups will now be popped up so that they are not in the center of the application nor on top of each other.
17 June 2014: Change to the Convert...Images utility programs that improves the transit dose computed for exit images of large field sizes. EPID Dicom input files are now copied to the patient directory for archive to the FluenceFiles.d directory.
4 June 2014: Dosimetry Check version 4 release 3, 4 June 2014 build.
Change: added support for the directory tree for server paths that start with two slashes, such as \\drive1
5 May 2014: Dosimetry Check version 4 release 3, 5 May 2014 build.
Change: file selection dialogs changed to use a directory tree instead of a list of directories in the currently selected directory.
ReadDicomCheck: Auto Read Case will create the patient entry from the name in the plan file if you otherwise have NOT selected a patient. If you select or create a patient, that will override the name in the plan file. Back out of the program for a different patient.
3 April 2014: updated ReadDicomCheck to version 2 release 11 to not read in a beam that is of not type TREATMENT in Dicom (300A,CE). This avoids adding non-treatment beams to the list of beams in DosimetryCheck which could be some what a problem if the non-treatment beams has the same name as a treatment beam but different parameters, such as the energy, which can occur with some planning systems. Otherwise you will have to edit the beam or delete extra beams.
20 Feb 2014: DosimetryCheck version 4 release 2 20 Feb 2014 build, with one change in reading CT scans.
9 Dec 2013: Dosimetry Check version 4, release 2 9 Dec 2013: Includes support for TomoTherapy machines which is now FDA cleared and CE Mark cleared. For TomoTherapy, please also download utility programs for TomoTherapy: Download Dosimetry Check Tomo Utilities and run the install program InstallTomoUtilities.exe.
Also in this update is a batch que and batch program for running the auto reports in a batch mode. Please review the manuals for this feature. Batching the auto report and the batch que (You will get a complaint about an empty temp file first time you use it because I cannot get the install software to create an empty directory on your computer.) Also is a new default file for defaulting the calculation grid size. defaulting calculation dose matrix.
5 Feb 2013:
Changes to Dosimetry Check, for version 3, release 9:
The distance measuring function on the Stacked Image Set pull down on the main toolbar has been expanded to also show the equivalent water path computed between the two selected points. The path considering only the CT numbers converted to density will be shown separately from the final result that also takes into account any ROI volumes that have been transversed that have an assigned density. This latter value is what the program will use in any path computation.
The Dosimetry Check dose export has been updated so that the Eclipse planning system will read in the export Dicom RT dose file without complaining about any missing tags.
ConvertEPIDImages has been updated to support a recent change in the private code Siemens uses to store the number of frames averaged.
The monitor unit check facility has been updated to divide doses by the number of fractions downloaded from the planning system. A dose specification point dose is for only one fraction in the Dicom RT download regardless of the number of fractions in the downloaded 3D dose matrix from the planning system. This division will only work for plans downloaded with the included update to ReadDicomCheck, as the number of fractions was not being saved prior to this from the # Fractions / Normalization number shown on the Plan toolbar, which is subject to change by the user, as the number of fractions will otherwise be defaulted to the value of one. Be advised that there is no new information in comparing monitor units versus comparing dose.
16 Oct 2012: The 64 bit version of DosimetryCheck was relinked with a larger stack size allocated. The version date is shown as 16 Oct 2012 64.
28 Sept 2012: ConvertEPIDImages (Elekta and Varian), ConvertIMATImages,
and ConvertSiemenImages: version 4 release 11:
A method was added to correct for the shift in the EPID when the image was integrated at a different gantry angle then the calibation image. See the link:
for details. The correction is applied for IMRT or IMAT images. This will be of interest for those with the Varian R arm, and there may be interest for the Varian E arm and the Elekta EPID for IMAT.
EPID log was changed to plot output versus the day the calibration image was measured, not used. See http://www.mathresolutions.com/dcman.d/ConvertEPIDImages.htm#_Toc336847555
Changes for verson 3, release 8, 24 Sept 2012 Dosimetry Check:
Parallel Processing: has been enabled. If you have an I7 computer, which is what we have been shipping the past few years, you have 8 independent threads. Dosimetry Check has been changed to use more than one thread, so your calculations can now go 7 to 8 times faster on an I7 computer. Please review the link in the manual at:
ParallelProcessing and "Calculate All Beams 3D" for details on how this will work.
If you do not have multiple hardware threads, then there is no advantage to you for this update. In that case you should edit the new file NumberOfThreads.txt which comes with this update, and set the number to 1.
While we have made every effort to make this leap error free, things do happen that we do not anticipate or missed. Should the program crash on you, please report it to us. If it continues to do so, then edit the file NumberOfThreads.txt and change the number 7 to 1, which will turn off parallel processing.
For the Dicom export of dose computed by Dosimetry Check, the patient name and ID in the RP file is now written to the RD file for consistancy. The frame of reference UID Dicom tag (20,52) is copied from the RP file to the RD file.
Changes for version 3 release 7 20 Aug 2012: The DosimetryCheck dose can be exported in Dicom RT format. This will only work for cases stored with the latest version of ReadDicomCheck, also in this release, version 2 release 9. See below for further notes on ReadDicomCheck.
Changes for version 3 release 6:
11 July 2012 Bug fixed for version 3 release 6 21 June 2012 in auto report if there is a space in the point name. Bug fix prevents program crash with fatal error reading the prior auto report settings file if you picked a point with a space in the file name.
14 July 2012: 64 bit version DosimetryCheck64.exe, date field in a particualr file StackedSetChangeDate corrected, for program to recomputed if the stacked image set was changed when the plan is not read in.
Air Gap Correction for transit dosimetry:
The change in air gap from the nominal geometry can now be corrected for. The nominal air gap is given by the equation:
air gap = EPID SID cm - (100.0 cm + 1/2 x thickness)
The above is the geometry assumed for the exit EPID data and the air gap correction will not work correctly if you did not keep a fixed EPID Source Image Distance (SID) and put isocenter in the center of the water thickness for images taken to fit the exit EPID kernel. For the nominal air gap, the air gap correction will be 1.0. The patient scatter to the EPID is rather insenitive to the air gap as previously noted: Patient scatter insensitivity to SID
Here we now provide a mechanism for correction from the nominal assumed air gap for patient exit images. For a fixed thickness and field size, the response for different air gaps is fitted to a second order polynominal, and normlized to 1.0 for the nominal air gap, which was given above, where the EPID SID is the SID for the images taken to fit the EPID exit deconvolution kernel (and not the EPID SID for the air gap correction images).
See Example Air Gap Fitting
The images for fitting the EXIT kernel are generated using a fixed EPID distance with the water moved so isocenter is always at the center depth. That geometry is that assumed to apply the correction.
We have every reason to believe that data measued on one machine will be sufficient for other machines because (1) the scatter from the phantom/patient to the EPID is fixed by physics (and the beam energy) and (2) we would not expect much variation in energy response of the EPID. The EPID exit image has already been corrected for field size response, and here we are normalizing the air gap for each field size and thickness.
See the new section in the exit data needed manual: Air Gap Correction
We have a correction file to date for 6x and 25x measured on Varian which we
can email you upon
In addition, you must edit your exit EPID kernel file to put in the SID at which the images were taken for fitting the EPID exit kernel. The format version must be changed to 2, and the SID added after the energy:
/* file format version */ 2 /* file type exit deconvolution kernel */ 111 /* description */ <*Example*> /* machine name: */ <*Varian*> /* nominal energy MeV: */ 6 /* EPID distance cm */ 157Only the new version of software in the update will be able to read the files with format version 2. The program will not apply the air gap correction if the SID is not in the exit kernel file or an air gap correction file is not in the beam data directory for the particular machine. To veryify if the air gap correction was applied, look at either the log file ceistdout.log or cimatdout.log or from Dosimetry Check, go to the Beam toolbar and under the Options pulldown look at the field information.
ROI Volume Trace Control:
There is a new control to turn off an ROI volume contributing to the start and stop point location along a ray from the source to a pixel on the EPID for exit to transit dosimetry, and for dose calculation. See ROI Volume Trace Control This feature adds to the change in release 5 that will consider all ROI volumes and not just the external outline so that it is no longer necessary to make a new external volume that is the union of the patient external volume and any outlying volumes that need to be considered such as bolus or the supporting couch. However, you might have an ROI volume protruding from the external contour that you don't want to be adding to the accumulation of matter outside of the external contour.
Copy patient plan:
A copy patient plan is now provided in the Convert EPID and IMAT image utility, so that you can create a new plan to send the new images to for a transit case. Dose matrices and prior fluence images are not copied in this new function. This allows you to easily create a day two and subsquent plans for transit dosimetry.
Contouring in ReadDicomCheck:
You can now set up the external contour, couch model, and CT to Density curve before leaving the Dicom RT inport program, so that you will not have to run Dosimetry Check to do the same before processing exit images to in air fluence images. Version 2 release 9 will store the RS (structures), RP (plan), and RD (dose) files in the patient directory under the sub-directory Imports.d. The RP file is referred to in order to export the DosimetryCheck dose in an RD file.
Example tomo cases.
Prostate case: TomoProstate.zip
Head and Neck case: TomoHead.zip
Return to homepageMath Resolutions, LLC