Patch 3.2.2

matRad's 3.2.2 patch fixes a number of issues with the new >=R2025 MATLAB Desktop and reported minor issues import/export, helper, and other minor functions. Apart from that it introduced some new flexibilities under the hood (single precision, raytracer vectorization) that do not expose changes on the outside, and can thus be sustainably tested before changing behavior in the next major release. Further, we now include a sphinx-built documentation versioned together with the source code that will be hosted on readthedocs.

Note: Most of the changes were actually already realized in patch 3.2.1 which, however, directly required a fixed by this release due to an issue with matRad_version that only occured on tagged commits.

Preliminary new features & Enhancements

• Dose engines can now optionally run calculations in single precision (default remains double). A new precision configuration property controls this
• GPU acceleration is available as an opt-in property for optimization. Helper functions for translating matRad data structures to/from GPU arrays were added.
• The Siddon raytracer is now implemented as a class with vectorized ray processing and optional single-precision forcing.
• Pencil beam engines now expose a traceOnDoseGrid switch (default false) to optionally retain radiological depth cubes on the dose grid.
• Performance improvements in matRad_cubeIndex2worldCoords.
• Improvements on the phantom builder to also accept mm coordinates for phantom definition
• Variance calculation from MC statistics can now be computed correctly
• matRad_plotSlice input parsing enhancements; fixed empty figure opening due to colormap array request.
• TOPAS now correctly support multiple alpha/beta values.
• Streamlined sequecing and 3D conformal calculations
• FRED interface updated with new test data, improved version compatibility, and the ability to force ijFormatVersion.
• DICOM import now imports passively scattered proton beams (gantry/couch angles)
• Optimizer instantiation reworked to allow more configuration options via propOpt.
• finalizeDose call in DoseEngines moved to calcDoseForward and calcDoseInfluence

Bug Fixes

• Fixed range-shifter handling issues in MC dose calculation interfaces
• Fix typo in RBE model fallback load path.
• Fix typo in addMUdataFromMachine.
• Correct DICOM attribute for SliceLocation.
• Fix slight dimension interpretation issue in cubeIndex2worldCoords.
• Fix scenario listing and the robustness field when serializing objectives to structs or displaying them in the CST.
• Multiple GUI fixes for MATLAB 2025 compatibility.
• GUI: fix missing plot handle; fix empty figure handles returned when GUI is globally disabled; fix plotSlice colormap issue; fix scrolling in the viewing widget under Octave (empty CurrentPoint).
• Drop numOfbeams as a required parameter (it can be inferred).

Documentation

• Full Sphinx / ReadTheDocs documentation build pipeline added (readthedocs.yml, GitHub Actions workflow, docs/ folder with images and rst structure).
• Docstrings updated to be sphinx-napoleon compatible across many files.
• Copyright notices updated to 2026.

Development & CI

• Standalone build step added to GitHub Actions workflows with matrix build (windows, linux, macos intel / silicon).
• Preliminary pre-commit hooks configured with miss_hit (MATLAB style checker) and codespell (not enforced yet)
• GitHub Actions workflow for documentation building (triggered on changes to docs/).
• Coverage report workflow made more tolerant to errors.
• MOcov submodule updated to include md5 fix.

Standalone

This release also adds a CI pipeline component for building the standalone (e.g., for educational purposes). The standalone only features the graphical user interface, and not all new features are accessible.

Check our new documentation for how to set-up matRad (as source code or standalone)

Patch 3.2.1

matRad patch 3.2.1 was directly superseded by patch 3.2.2.

Disclaimer & License

• DO NOT USE MATRAD CLINICALLY -
  Check LICENSE.md and README.md for more infos

Funding

This release has been supported through the following research grants:

• The German Research Foundation (DFG), Project No. 265744405 & 443188743
• The German Cancer Aid, Project No. 70113094
• The German Federal Ministry of Education and Research (BMBF), Project No. 01DN17048
• Mathworks Academic Research Support

Minor Release 3.2.0

matRad 3.2.0 introduces several improvements and updates across the codebase, including the addition of an interface to FRED MC (if installed), VHEE planning, enhancements to DICOM and DVH handling, updates to developer attribution, and example script improvements. We welcome four new contributors (check AUTHORS.txt) responsible for some of the changes listed below.

Main New Features

• FRED MC interface (if installed)
• VHEE planning with a Generic (unfocused) beam and a focused beam. The Generic beam can be forwarded to TOPAS as well.
• New matRad_plotSlice function with keyword / value synxtax for more intuitive plotting of slices

Fixes, Performance and User Experience

• DICOM Import/Export fixes
• various GUI fixes to reduce warnings / errors and usage in MATLAB Online
• Available Classes (e.g., dose engines) are now cached for faster loading
• New Examples
• Improved CI workflows

For details check CHANGELOG.md.

Standalone

In addition to the Matlab source code, this release also contains updated installers that can provide a standalone version (e.g., for educational purposes). The standalone only features the graphical user interface, and not all new features are accessible. We also have an experimental Docker Container.

Check our Wiki for how to set-up matRad (as source code or standalone): https://github.com/e0404/matRad/wiki/Setting-up-matRad

Disclaimer & License

• DO NOT USE MATRAD CLINICALLY -
  Check LICENSE.md and README.md for more infos

Funding

This release has been supported through the following research grants:

• The German Research Foundation (DFG), Project No. 265744405 & 443188743
• The German Cancer Aid, Project No. 70113094
• The German Federal Ministry of Education and Research (BMBF), Project No. 01DN17048
• Mathworks Academic Research Support

v3.1.0 - "Cleve"

Features

This major release finally combines multiple diverging developments over the last years:

• File Structure Overhaul
• Scenario Management and robust / 4D optimization
• Object-Oriented DoseEngines & new Monte Carlo interfaces
• Helium planning
• Extended biological modeling
• Widget-Based GUI
• DICOM Exporter and updated Importer
• Experimental Brachytherapy Module

Check CHANGELOG.md for more information.

Standalone

In addition to the Matlab source code, this release also contains updated installers that can provide a standalone version (e.g., for educational purposes). The standalone only features the graphical user interface, and not all new features are accessible. We also have an experimental Docker Container.

Check our Wiki for how to set-up matRad (as source code or standalone): https://github.com/e0404/matRad/wiki/Setting-up-matRad

Disclaimer & License

• DO NOT USE MATRAD CLINICALLY -
  Check LICENSE.md and README.md for more infos

Funding

This release has been supported through the following research grants:

• The German Research Foundation (DFG), Project No. 265744405 & 443188743
• The German Cancer Aid, Project No. 70113094
• The German Federal Ministry of Education and Research (BMBF), Project No. 01DN17048
• Mathworks Academic Research Support

Blaise v2.10.1 (Patch 1)

This patch fixes some bugs from v2.10.0 and introduces some minor new configuration possibilities. See ChangeLog.txt for more details.

In addition to the Matlab source code, this release also contains updated installers that can provide a standalone version (e.g., for educational purposes). The standalone only features the graphical user interface, and not all new features are accessible. We also have an experimental Docker Container.

Check our Wiki for how to set-up matRad (as source code or standalone): https://github.com/e0404/matRad/wiki/Setting-up-matRad

- DO NOT USE MATRAD CLINICALLY -
Check LICENSE.md and README.md for more infos

This release has been supported through the following research grants:

• Grant No. BA 2279/3-1 (Project No. 265744405) from the German Research Foundation (DFG)
• Grant No. 70113094 from the German Cancer Aid

Blaise v2.10.0

Second major release of matRad. A lot has changed in Blaise going from Alan!
Check the ChangeLog:
ChangeLog.txt

Have fun! If you find any issues or have questions about matRad feel free to post an Issue on GitHub or contact us at contact@matrad.org.

- DO NOT USE MATRAD CLINICALLY -
Check LICENSE.md and README.md for more infos.

This release has been supported with the following research grants:

• Grant No. BA 2279/3-1 (Project No. 265744405) from the German Research Foundation (DFG)
• Grant No. 70113094 from the German Cancer Aid

Alan

First official matRad release including

• new optimizer IPOPT for constrained optimization
• validated ray tracing
• validated pencil beam particle dose calcualtion
• DICOM import including dose and particle pencil beam scanning plan objects
• matRad standalone version
• improved GUI workflow
• many bug fixes and many new bugs...

Have fun and let us know what you think at contact@matrad.org...

- DO NOT USE MATRAD CLINICALLY -
Check LICENSE.md and README.md for more infos