Setup¶

Requirements¶

Matlab 2019b or higher
Pyschtoolbox v3 or higher

Installation¶

The CAL-software-Matlab package can be installed by completing the following steps:

Download the CAL-software-Matlab.mltbx file from the latest release. This is a Matlab toolbox file (.mltbx) with all the necessary files for the CAL-software package.
Open Matlab and run the following code in the Matlab command line. Be sure to change toolboxFile to the correct path to the downloaded .mltbx file.
```
toolboxFile = 'C:\Downloads\CAL-software-Matlab.mltbx';
matlab.addons.toolbox.installToolbox(toolboxFile)
```
To test the installation run the following code in the Matlab command line:
```
CALtest()
```
This function will test the basic functionality of the toolbox and check if a GPU is available for the use of the Astra toolbox which is included in this toolbox.

You should see the following if installation was successful:
```
CAL-software-Matlab Toolbox installed successfully!
Getting GPU info...
Testing basic CPU 2D functionality...
Testing basic CUDA 2D functionality...
Testing basic CUDA 3D functionality...
```
If your computer has a NVIDIA GPU the CUDA 2D and 3D functionality should say “Ok”.

Now the toolbox can be used like any other Matlab toolbox. You do not need to be in a particular working directory to access the functions of the toolbox.

Astra Toolbox¶

Astra toolbox is a toolbox for GPU-accelerated tomography which has very flexible projector geometries that can be used for non-standard CAL systems. If Astra installation fails, go to the Astra Github repository and download the Mex and Tools folders and place them in a folder inside the source folder in which CAL-software-Matlab is installed.

Uninstallation¶

The toolbox can be uninstalled in the Add-on manager. Go to the Matlab Home tab, then Add-Ons in the Environments panel. Click the dropdown arrow and select Manage Add-Ons. Then click the Options and Uninstall for the CAL-software-Matlab toolbox.