UCoMX: Universal Complexity Metrics Extractor

UCoMX (Universal Complexity Metrics Extractor) is a novel software package designed to extract complexity metrics from DICOM-RT plan files of radiotherapy treatment plans. The tool is platform-agnostic, engineered to seamlessly operate with DICOM-RT plan files created using diverse commercially available TPSs across various treatment units. UCoMX is freely available and complemented by a dataset that can be used as reference for future comparisons. A detailed User's Manual is also provided.

Basic rules for a good use of UCoMX.
The UCoMX package provided in this repository is designed for use with Matlab. The functions are distributed in pcode format, meaning the source code is not visible or editable. This implies that while you can download and use the package, you are not permitted to modify any part of the software or redistribute modified versions. Any version of the software found outside this repository should be considered unofficial and reported to us unless otherwise specified.
UCoMX is a research tool, therefore its clinical use is strongly forbidden. The author do not take responsibilities of any improper use of the package. 

Do you need a compiled version?
A compiled version for Windows 10 and 11 is available in this repository. If you are using an older version of Windows, you may still try downloading and running the package, though compatibility is not guaranteed.

How to cite UCoMX?
If you make use of UCoMX in your scientific work, please cite it as: 

• Cavinato S, Scaggion A, Paiusco M. Technical note: A software tool to extract complexity metrics from radiotherapy treatment plans. Med Phys. 2024;1-11. https://doi.org/10.1002/mp.17365
• Samuele Cavinato & Alessandro Scaggion. (2024). UCoMX: Universal Complexity Metrics Extractor (1.0). Zenodo. https://doi.org/10.5281/zenodo.8276838
  
  

List of known bugs.

• v1.1 -  16 Jun 2025:
  - Please note that the pcode_before_r2022a might not function correctly in GUI mode, as it was designed for compatibility with older MATLAB versions.
• v1.0.1 -  2 Oct 2024:
  - Depending on your screen resolution, the GUI of the compiled software may extend beyond the top border of your screen. This should not affect the package's functionality. However, if it causes any issues in usage, please feel free to contact us.
  
  

List of solved bugs.

• v1.1 - 16 Jun 2025:
  - An issue with tongue-and-groove (TG) computation has been resolved, and the reference dataset has been updated accordingly.
  - Addressed an issue in previous versions that led to incorrect values for some complexity metrics in some MRIdian plans, caused by an automatic MLC storage mode selection problem. The reference dataset has been updated, and the required storage modes for MRIdian plans in the dataset are now specified in a dedicated file.
• v1.0.1 - 2 Oct 2024:
  - Issue resolved when reading a single plan using the TCoMX engine.

List of new features.

• v1.1 - 16 Jun 2025:
  - Users can now select the storage order of MLC leaf positions in the DICOM file directly from the "Configure Parameters" panel.
  - The user manual has been updated to reflect the new features.

Contacts.
For any question, do not hesitate to contact us at samuele.cavinato@iov.veneto.it and alessandro.scaggion@iov.veneto.it. Remember to add ucomx@iov.veneto.it in cc. 
If you encounter any issues while running the package, please provide as many details as possible, including a screenshot of the error. For the compiled version, you can send us the "ucomx_logfile.txt" file (it is automatically generated in the UCoMX folder the first time UCoMX is run, and updated with each execution).