SarrpDose 2.2.10 Installation Instructions

1 minute read

This guide outlines the necessary steps to install the most up-to-date SarrpDoseEngine software.

Applicable Versions

  • 2.2.10

Procedure

Install Software

  • Download and launch the SarrpDose 2.2.10 installer.
  • If a previous version of the dose engine is installed, you will need to uninstall it. Click Yes in the dialog prompt to remove the old version of the dose engine.
  • Follow the on screen prompts of the installer wizard; you can leave the selected options as the defaults, with the following exception:
  • On the Choose Start Menu Folder page, check the box at the bottom left Do not create shortcuts.
  • Click Finish to finish the install.

Give User Permissions

If may be necessary to give the user permissions to the installation folder of SarrpDose. The subsequent steps outline how to do this.

  1. Open File Explorer and type in or copy/paste the following path in the navigation bar: %PROGRAMDATA%\Xstrahl.
  2. Right click the SarrpDose folder.
  3. Select Properties
  4. Click the Security tab
  5. Click the Edit button
  6. Under Group of user names select each item in the table and ensure that all the boxes under Permissions for Users are checked. If they are not, select the user and then check every box in the lower section.
  7. Click Ok.
  8. Click Ok again.

Install Needed Files

The dose engines require a number of data files to run properly. In the case of the default superposition-convolution (SC) engine, all necessary files are included with the SarrpDose installer.

The Monte Carlo (MC) dose engine, if included in the installation, requires a phase space data file for each installed collimator that depends on the machine’s treatment head type.

The different treatment head types are:

  • brass_block - Brass block treatment head, older SARRPs.
  • 4d_ic - 4D head with an ion chamber
  • 4d_no_ic - 4D head without an ion chamber

To download the required phase space data:

  1. Within existing directory:

    %PROGRAMDATA%\Xstrahl\SarrpDose\EGSnrc\egs_home\dosxyznrc

    manually create the subdirectory tree:

    \data\<treatment_head_type>

    where <treatment_head_type> is the name of the machine’s treatment head type and matches one of the options given above.

  2. Copy the phase space files required for the user’s system from subdirectory <treatment_head_type> in the phase space Sharepoint folder into the new subdirectory:

    %PROGRAMDATA%\Xstrahl\SarrpDose\EGSnrc\egs_home\dosxyznrc\data\<treatment_head_type>

The naming convention of phase space files is given in the table below:

collimator phase space file name
10x10 mm <treatment_head_type>_10.0x10.0.egsphsp1
5x5 mm <treatment_head_type>_5.0x5.0.egsphsp1
3x3 mm <treatment_head_type>_3.0x3.0.egsphsp1
3x9 mm <treatment_head_type>_3.0x9.0.egsphsp1
dia. = 1 mm <treatment_head_type>_c1.0.egsphsp1
MVC <treatment_head_type>_mvc.egsphsp1

Updated: