Assistance Required for Running OpenTPS Sample Case on macOS

General
1

I am currently working on learning and testing OpenTPS on my system. I’m using a MacBook Air (Model MacBook Air MRXR3 2024 LLA), and I have successfully installed and launched OpenTPS using the Conda environment (conda activate OpenTPS).

I am writing to seek your guidance regarding a few issues I’ve encountered while trying to run a sample dataset. I’ve explained the situation in detail below:

⸻

System & Execution Setup:
I have downloaded the module Master/testData/simplefantomwithStruct from GitLab. In OpenTPS, I load the data from the Patient Data > Load Data section, and the phantom appears successfully. However, under Patient Data > ROI, only one ROI (TargetVolume) appears, while in tutorial videos, multiple ROIs are usually visible.

Questions:
• Are ROIs supposed to be imported as external files, or are they expected to be defined within the Python code?
• If external, where can I obtain proper sample files that include predefined ROIs?

Plan Design & Optimization Issues:
• I can define a Beam and configure its parameters, but clicking on Validate does nothing.
• The Objective section states “No Objective Defined Yet,” and I am unsure how to define it.
• Clicking on Optimize Plan does not trigger any process, and the terminal logs:
Could not find a target volume in dose fidelity objectives

Dose Computation Issues:
• The Plan and Overwrite options are inactive.
• Clicking Validate yields no response.
• Clicking Compute Dose results in this error in the terminal:
AttributeError: ‘NoneType’ object has no attribute ‘scanMode’

Evaluation & Scripting:
• Plan Evaluation buttons are visible but inactive.
• Dose Comparison shows no values and cannot be edited.
• Scripting requires attached files — could you kindly advise where to obtain them?

Please note that these issues are not specific to the simplefantomwithStruct dataset. I have tested other data as well, with the same results.

OpenTPS is an exceptional and valuable tool. I am deeply enthusiastic about learning and possibly helping to share knowledge about it. However, to proceed further, I would greatly appreciate your support.

Do you believe these problems may be due to incompatibility with my Mac system, or do I simply need to follow additional training steps?

Thank you very much in advance for your time and kind assistance.

Best regards,
Kimia khatami
Master’s student in Medical Radiation Engineering at Shahid Beheshti University

2

Dear Kimia,

Thank you for your questions — I’ll do my best to address them all.

First, ROIs are generally included in the dataset. However, the example you’re referring to is a very simple synthetic case, which is why it only includes one ROI. If you’d like to work with more ROIs, you can create your own data using Python (you’ll find examples on our website or GitLab). For more complex datasets, such as real patient data, you would need to obtain them through your institution, as we’re unable to share clinical data.

Regarding the Plan Design section, you should see the beams listed in the panel after adding them. Once you click Design Plan, you’ll need to navigate to the next panel to view the generated plan.

Next, make sure to open the Objective panel, select at least one target, and assign a prescription to it (you can also specify a Dmax or Dmin if needed).

Most of the errors you encountered are likely due to not setting a target or prescription, which are required steps.

Lastly, I don’t believe these issues are related to your macOS system. That said, some compatibility issues with OpenTPS on macOS may arise later on, so please keep that in mind.

Best regards,

Romain Schyns
The OpenTPS team

3

Dear Romain Schyns and the OpenTPS Team,

I would like to sincerely thank you and your team for taking the time to respond to my questions. I apologize for not expressing my gratitude earlier — unfortunately, a 12-day external conflict occurred in my country, during which we had no access to the internet. That prevented me from reaching out sooner to acknowledge your kindness and support.

In the meantime, I’ve encountered some technical issues while running the software on my MacBook. It seems that two essential packages cannot be fully installed, and the program suffers from some performance limitations.

After further investigation, I realized that in order for the program to run correctly, the system should ideally meet the following requirements — especially when using a computer:

• The computer should have a dedicated GPU

• The GPU must be from NVIDIA

• Preferably from a recent series (e.g., GTX 1050 or higher)

Additionally, the software is only supported on x64-based systems and does not work with ARM64 or M series Macs.

Without these specifications, the software does not work properly and returns various errors.

Once again, thank you for your generous assistance and understanding. I truly appreciate your continued support.

Best regards,

Kimia Sadat Khatami

Master’s student in Medical Radiation at Shahid Beheshti University

4

Dear Kimia,

First of all, we are sorry to hear about your situation and hope that you and your family are safe.

For the package installation, do not worry if you cannot install CuPy — OpenTPS can also run on systems without a GPU. Although faster, a GPU is thus not required to optimize plans. As for the GPU specifications, it will really depend on your plan parameters — i.e., if you have a high number of beamlets, you will need a GPU with enough RAM.

Regarding the ARM64 compatibility, MCsquare has not been compiled yet for Macs; it only supports Windows and Linux. (You might get around that using a virtual machine.)

Regards,
Eliot Peeters