Skip to content

TCoMX is a library for the extraction of complexity metrics from helical tomotherapy RTPLAN files.

License

Notifications You must be signed in to change notification settings

SamueleCavinato/TCoMX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

!!! NEW PACKAGE AND NEW REPOSITORY ON ZENODO !!!

Dear Users,

We are excited to announce that TCoMX has been integrated into a more comprehensive software package called UCoMX (Universal Complexity Metrics Extractor). This package also includes complexity metrics for VMAT and IMRT plans, making it an increasingly universal tool that should meet the needs of a growing number of users. You can download the UCoMX package at: https://doi.org/10.5281/zenodo.8276837. Additionally, we encourage you to have a look to the related Technical Note published on Medical Physics: https://doi.org/10.1002/mp.17365. Please note that this GitHub repository will no longer be maintained, and the TCoMX version hosted here will not receive further updates. We would like to take this opportunity to thank all the users who have downloaded and used TCoMX in their work over the past two years. We are confident that the availability of UCoMX will help expand the user community and make the evaluation of treatment plan complexity even more accessible.

Stay tuned for more updates!

TCoMX - version v1.0 - OBSOLETE VERSION

TCoMX (Tomotherapy Complexity Metrics EXtractor) is a newly developed Matlab® (The Mathworks Inc, Natick, MA, USA) library for the automatic extraction of a wide set of complexity metrics from the DICOM RT-plan files of helical tomotherapy (HT) treatments. It was developed at the Medical Physics Department of the Veneto Instute of Oncology (IOV-IRCCS). The current version of TCoMX (v1.0) allows the extraction of all the different complexity metrics proposed in the literature,some of them with customisable parameters. TCoMX is compatible with DICOM RT-PLAN files generated using both RayStation (RaySearch Laboratories, Stockholm, Sweden) and Precision (Accuray, Sunnyvale, CA) TPSs. It was developed entirely on Matlab® R2020b. The backward compatibility with previous Matlab® releases was checked up to version R2018a. Compatibility with older versions should be guaranteed but needs to be verified. The library was developed on Linux Ubuntu 20.04.1 LTS and the compatibility with Windows 10 was verified. The compatibility with other versions of the two operating systems as well as with other operating systems needs to be investigated. A reference dataset composed by 18 anonymized DICOM RT- PLAN files (9 Precision, 9 RayStation) is also provided in this repository. We refer to the TCoMX_UserManual in this repository for any detail concerning its functioning.

Aim

TCoMX was realized in order to provide common tool to be used across the different institutions. A strong effort was done to make the library accessible to any type of user, even to non expert programmers. Furthermore, no fees are needed to use it because we believe that science is based on the free sharing of knowledge and on making tools accessible to everyone. For this reason, TCoMX is released under a GNU GPL v3 licence that allow you to use and modify it, as well as to distribute new versions of the library by following two simple rules (1) give to the others the same freedom you received from us (2) state all the changes you perform (please find all the technical details in the LICENCE file). However, in the same spirit of sharing knowledge, we warmly encourage the authors that are interested in adding new interesting and useful features to the library to contact us in order to set up a collaboration and keep this repository always updated. Finally, we are fully available to help you in the installation and/or execution of the library as well as to solve possible bugs that might arise.

How to cite

Please cite the library in your works as:

Cavinato, S, Fusella, M, Paiusco, M, Scaggion, A. Quantitative assessment of helical tomotherapy plans complexity. J Appl Clin Med Phys. 2022;e13781. https://doi.org/10.1002/acm2.13781

and

Cavinato S, Scaggion A. TCoMX: Tomotherapy Complexity Metrics EXtractor. ArXiv211215056 Phys. Published online December 30, 2021. Accessed January 7, 2022. http://arxiv.org/abs/2112.15056

and, if you want, by adding the link to this repository: https://github.com/SamueleCavinato/TCoMX

If you need other citation formats, you can refer to https://aapm.onlinelibrary.wiley.com/doi/10.1002/acm2.13781 and to the updated version of the TCoMX User Manual at http://arxiv.org/abs/2112.15056

Results

We are planning to add a secion "Results" to the TCoMX User Manual in order to collect all the relevant findings obtained using TCoMX, with the reference to the work were they are published. Therefore, if you publish some results obtained using TCoMX and you want us to add them to dedicated section in the TCoMX User Manual, do not hesitate to contact us. This might also help you to gain visibility.

Correspondences

Please send any correspondence to [email protected] or [email protected].

Footnotes

TCoMX is intended for research use only. The clinical use of TCoMX is strongly forbidden. The authors don't take responsabilities of any improper use of the tools contained in this repository and of all the material related to it.

About

TCoMX is a library for the extraction of complexity metrics from helical tomotherapy RTPLAN files.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages