Installation and Use - mwgeurts/viewray_fielduniformity GitHub Wiki
The following sections provide instructions on installing, configuring, and running the ViewRay Field Uniformity-Timing Check application.
Contents
Installation
To install the most recent release of this application using MATLAB apps, download ViewRay Field Uniformity-Timing Check.mlappinstall from this repository, then open MATLAB, select the Apps tab, and click Install App. In the Install App dialog box, browse to the downloaded file and then click Open. Finally, in the App Installer dialog box click Install or Reinstall. If using git, execute the following command.
git clone --recursive https://github.com/mwgeurts/viewray_fielduniformity
Compatibility
Refer to the Software Compatibility wiki page for more information on Operating System and MATLAB version compatibility.
Global Variables
Global configuration variables such as Gamma criteria and the expected beam on time can be modified by changing the values in FieldUniformity_OpeningFcn prior to execution. Each global variable is stored in the handles guidata structure. A full list of variables is provided in the following table.
| Global Variable | Default Value | Description |
|---|---|---|
| path | userpath() |
The initial path to search when browsing for input files. This path will automatically be set to the location of the most recent loaded file during application execution. |
| time | 30 seconds | The expected beam on time, in seconds. This is used when computing the time difference between measured and expected. |
| abs | 3.0% | Gamma analysis absolute criterion |
| dta | 0.1 cm | Gamma analysis Distance To Agreement (DTA) criterion |
| rot | 90 deg | The Profiler rotation relative to its specified coordinates. This factor will adjust how reference data (computed by the TPS) is extracted for the Profiler axes. If the Profiler is aligned along the TPS axes, set to zero. If the profiler is rotated 90 degrees such that the Profiler Y axis is aligned to the TPS X axis,vset to 90. |
| unit | 0 | Unit test flag. This will be set to 1 if the application is being run as part of unit testing (see UnitTestHarness for more information) |
Reference Data
Reference data is specified by the handles.references cell array. Each cell contains the relative location to TPS Monte Carlo data for a given field size. To add or edit the reference profiles available, first verify that the new reference file can be loaded by LoadProfilerDICOMReference(), then add the path and file name to the cell array.
Application Use
This application processes measured data from the SNC IC Profiler device on ViewRay MRIdian treatment systems. Refer to the Measurement Instructions page on the wiki for sample instructions on how to collect this data.
Once measurement data has been acquired, open MATLAB and execute FieldUniformity to run the ViewRay Field Uniformity-Timing Check. A graphical user interface will automatically load. Next, click the Browse button on the panel for the desired head. In the file selection dialog that appears, navigate to and select the measured data file and select OK. The application will automatically process the data and return a result. To change the plotted data, change the value of the Display drop down menu. Finally, to print the results to a PDF report click Print Report.
When measuring data with IC Profiler, it is assumed that the profiler will be positioned with the electronics pointing toward IEC+Z for a 90 degree gantry angle for 30 seconds of beam on time. The Monte Carlo data assumes that a symmetric 27.3 cm x 27.3 cm or 10.5 cm x 10.5 cm field is delivered through the front of the IC Profiler. The IC Profiler data must be saved in Multi-Frame (PRM) format.