Assistance Required for Running OpenTPS Sample Case on macOS

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

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