Installation and Use - mwgeurts/viewray_mlc GitHub Wiki
The following sections provide instructions on installing, configuring, and running the ViewRay MLC Position Check application.
Contents
Installation
To install the most recent release of this application using MATLAB apps, download ViewRay MLC Position 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_mlc
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 AnalyzeMLCProfiles_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. |
| abs | 2.0% | Gamma analysis absolute criterion |
| dta | 0.1 cm | Gamma analysis Distance To Agreement (DTA) criterion |
| thresh | 0.8 | The Gamma threshold. Reducing the range over which Gamma is reported (to 80% for example) improves visualization of the different Gamma index profiles when multiple profiles are plotted on the same axes. |
| 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. |
| axis | 'y' | Profiler axis to use for analysis. This can be set to either 'x', 'y', 'p', or 'n'. |
| 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.APfiles, handles.PANCfiles, and handles.PATCfiles cell arrays for the Anterior-Posterior, Posterior-Anterior without couch, and Posterior-Anterior through the couch orientations. Each cell contains the relative location to TPS Monte Carlo data for a given field shape. To add or edit the reference profiles available for a given orientation, first verify that the new reference file can be loaded by LoadProfilerDICOMReference(), then add the path and file name to that 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 AnalyzeMLCProfiles to run the ViewRay MLC Position 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. When prompted, click on the gantry angle where the measurement was acquired. 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 the following fields are delivered to the IC Profiler. The IC Profiler data can be saved in ASCII file export or Multi-Frame (PRM) format.
| Strip | X1 (cm) | X2 (cm) | Y1 (cm) | Y2 (cm) |
|---|---|---|---|---|
| Strip 1 | -12.5 | -7.5 | -13.65 | +13.65 |
| Strip 2 | -8.5 | -3.5 | -13.65 | +13.65 |
| Strip 3 | -4.5 | +0.5 | -13.65 | +13.65 |
| Strip 4 | -0.5 | +4.5 | -13.65 | +13.65 |
| Strip 5 | +3.5 | +8.5 | -13.65 | +13.65 |
| Strip 6 | +7.5 | +12.5 | -13.65 | +13.65 |
The choice of gantry angle will determine the reference dataset used, as follows.
| Gantry Angle | Reference Data |
|---|---|
| 0 | Anterior-Posterior |
| 90 | Anterior-Posterior |
| 180 | Posterior-Anterior through couch |
| 270 | Posterior-Anterior without couch |