Frequently Asked Questions (FAQ) - raidionics/Raidionics GitHub Wiki

0. Verification test

  • As an initial test to verify that Raidionics works properly on your computer, and before trying using your own data, the following should be performed.
  1. Download the provided test data, available through the Raidionics GUI under File > Download test data, and extract the content.
  2. Load the two MR scans (one contrast-enhanced T1-weighted and one FLAIR) inside Raidionics and run the preoperative segmentation task for a meningioma tumor type. A tutorial video for this use-case can viewed on Youtube.
    :warning: Make sure the proper MRI sequence type is filled in correctly for each MRI series in the right-hand panel. Here the contrast-enhanced T1-weighted MR scan should be associated with the T1-CE tag, while the FLAIR MR scan should be associated with the FLAIR tag.
  3. Inspect the obtained segmentation masks if the processing succeeded. Otherwise please refer to the below list or visit the issues to find potential solutions.

1. The software crashes when clicking on run segmentation or run reporting.

  • If you are running Raidionics on macOS, make sure you have installed the proper version of the software. The installer with a name trailing macOS.pkg will run on regular mac computers, while the installer with a name trailing macOS_arm.pkg is meant to be used on mac computers with an M1 chip CPU.

2. The segmentation process finishes quickly and no segmentation is produced.

  • The information available in the Logs window might provide an explanation to an unsuccessful segmentation attempt, which can be found in the top menu-bar, under Settings > Logs (alternatively using the CTRL + L shortcut).
  • A purge of the models can be attempted to trigger a re-download. Simply open the Settings panel (CTRL + P shortcut), in System settings click the Models purge option (with a trash bin icon).

3. Models missing (manual download)

  • :x: Models are not being automatically downloaded when running Raidionics (e.g., internet/firewall issues), leading to failure to run segmentation tasks.
  • :bulb: All the models used by Raidionics can be manually downloaded at the following Raidionics-models repo. After downloading each model archive, you simply need to extract the content and place the obtained folder inside ~/.raidionics/resources/models/.
  • :warning: Some models do require running other models as pre-processing step. In order to check it out, the json file inside each model folder must be read (e.g., ~/.raidionics/resources/models/MRI_GBM/pipeline.json). Each other model mentioned in the following format will need to be manually downloaded (e.g., "model": "MRI_Brain")