Setting up matRad

This is the quick setup guide for matRad

To get matRad running you have two options:

1. Source Code for people with Matlab installation:

If you have MATLAB you can just get a local copy of the matRad source code. Then you have to choose whether you want to use the matRad GUI or execute the matRad script.

2. Standalone installation:

If you do not have MATLAB installed on your PC you are restricted to use matRad's standalone application. For this option a MATLAB installation is not required. The installer is available for Windows, Mac and Linux with the latest matRad release.

Steps for installation:

1. Download the matRad installer for your system (Win64, Mac64, Linux64)

2. Run the respective installer for your system

Windows: Run the downloaded executable installer Linux: Run the executable install script. Make sure that the *.install file has executable permissions. Mac: Here we provide a dmg containing the installer (Since the installer is not apple-certified, you might explicitly launch it from the terminal or by right-click and then open).

After that, you should be guided through the installation process. Note that the installers will want to download the "Matlab Runtime" from Mathworks in the process. The runtime is quite large (~2GB) and is required to run compiled deployed applications written in Matlab.

3. Run matRad: Windows: Just like with every other progam, you should have a desktop icon. Linux & Mac: To start matRad, you can use the provided run_matRad.sh script from the terminal. It requries one argument which gives the path to the installed Matlab-Runtime. Refer to the readme_linux.txt and readme_mac.txt in your installation directory for more information.

3. Patient/Phantom files

The patient files should be included with the installer and will be installed into the desired location. For windows, for example, they can be found within the "application" folder of the chosen installation directory. Moreover, we also provide extra links to the open source patient files stored in matRad's native *.mat format for a head and neck case, a liver case, a prostate case, a box phantom, and AAPM's TG119 phantom. Otherwise you need to start with a DICOM import of your own patient data.

---

An overview of the functions of the matRad GUI can be found here.

If you want to import patient data, check out the dicom import functionality.