You can access the docs at https://sqlite4radiomics.rtfd.io and the paper at https://doi.org/10.1016/j.phro.2021.09.007
SQLite4Radiomics is an integration project of the popular PACS software Conquest DICOM with radiomics extraction package pyradiomics
These instructions will get you a copy of the project up and running on your local machine for usage and or development purposes. Make sure to check the Software User Manual included in the project.
Prior to using SQLite4Radiomics, we recommend to learn more about pyradiomics and The Image Biomarker Standardization Initiative. In order to understand how pyradiomics feature extraction is customized, please refer to pyradiomics customization. Once you have made yourself familiar with these sources, you are better equipped to run radiomic analyses and customize pyradiomics extraction settings by the Parameter file modifications according to your needs.
SQLite4Radiomics was originally written for Windows 10 platform. It should in principle, also work on windows 7/8/8.1. Other platforms are not fully supported.
Go to https://www.python.org/downloads/release/python-365/ and download the appropriate installer for your system. NOTE: Make sure that you choose the option during installation to add python to the Path.
Go to https://nodejs.org/en/ and download the appropriate installer for your system. Follow the necessary steps to install NodeJs.
- Clone the git repository with
git clone https://github.com/Maastro-CDS-Imaging-Group/SQLite4Radiomics.git
- Go to the folder
radiomicsfeatureextractionpipelineand run theSetup.batfile. This will make sure that:
-
The paths that Conquest uses, matches the current location on your machine
-
Creates the necessary virtual environment and installs the necessary python packages
-
Installs necessary node packages
You should see a command prompt window pop up and go through the installation of the necessary packages.
If when running this file, the command prompt window immediately closes after execution (no package installation could be seen), then check the Troubleshooting section below.
Go to the conquest folder and run ConquestDICOMServer.exe
When Conquest is running, go to the data folder and open the incoming folder within. Drop your DICOM files here while Conquest is running.
Run the Sqlite4Radiomics.bat file to start up the tool.
If you have python 2.x installed, this could lead to some problems when setting up the tool. If you get any errors when running Setup.bat, please find your python installation, usually at (or something similar):
C:\Users\username\AppData\Local\Programs\Python\Python36
(note that username should be the name of the profile on your machine)
In this folder there is a Python.exe file. Make a copy of this file and rename it to Python3.exe
In the folder where the Sqlite4Radiomics is located, there is a scripts folder. Within, you can find a batch file named venv-setup.bat.
Open this file in edit mode and substitute the py -3.6 with python3. Save and close the file. The Setup.bat file should now be able to run without any further complications.
If you modify the configuration file and something goes wrong, the terminal should show that an error has occurred. All that needs to be done is to restore your configuration file. This can be done either in the interface.
If this doesn’t work, go to backend\resources\backups where you should find the default and previous versions of the files that can be modified. Copy the file you need into the resources folder, rename it to the correct name and delete the bad file.
If your problem is not related to the above-mentioned reasons, it is advised that you “re-install” the tool or contact an IT specialist.
If you want to find your output csv files yourself instead of downloading them, these can be found in backend\out.
Similarly, log files can be found in backend\logs.
-
Angular - The frontend framework used, typescript base
-
DJango - The backend framework used, python based
-
Electron - Framework used for the desktop client, javascript based
-
Conquest DICOM - Database and DICOM
We will not be keeping active management of the master branch and therefore will not be handling pull requests, as the norm. You can, however, fork and work on your own version of the tool with any improvements or variations you see fit.
- Ivan Zhovannik - Initial idea, pipeline development, testing, and benchmarking - Radboudumc Radiation Oncology department & Maastro Clinic CDS Imaging group
- Suraj Pai - Pipeline development, testing, and benchmarking - Maastricht University & Maastro Clinic CDS Imaging group
- Talia Santos - GUI and production development - Radboudumc Radiation Oncology department & Fontys University of Applied Sciences
- Lars L.G. van Driel - Pipeline development - Radboudumc Radiation Oncology department & Fontys University of Applied Sciences
- Andre Dekker, Rianne Fijten, Alberto Traverso - Clinical support and medical imaging - Maastro Clinic Clinical Data Science
- Johan Bussink - Clinical support - Radboudumc Radiation Oncology department
- René Monshouwer - Principle Investigator - Radboudumc Radiation Oncology department
Ivan Zhovannik, Suraj Pai, Talia A. da Silva Santos, Lars L.G. van Driel, Andre Dekker, Rianne Fijten, Alberto Traverso, Johan Bussink, René Monshouwer, Radiomics integration into a picture archiving and communication system, Physics and Imaging in Radiation Oncology, Volume 20, 2021, Pages 30-33, ISSN 2405-6316, https://doi.org/10.1016/j.phro.2021.09.007. (https://www.sciencedirect.com/science/article/pii/S2405631621000579) Abstract: Radiomics is referred to as quantitative imaging of biomarkers used for clinical outcome prognosis or tumor characterization. In order to bridge radiomics and its clinical application, we aimed to build an integrated solution of radiomics extraction with an open-source Picture Archiving and Communication System (PACS). The integrated SQLite4Radiomics software was tested in three different imaging modalities and its performance was benchmarked in lung cancer open datasets RIDER and MMD with median extraction time of 10.7 (percentiles 25–75: 8.9–18.7) seconds per ROI in three different configurations. Keywords: Radiomics; Conquest DICOM; PACS
This project is licensed under the Apache License - see the LICENSE.md file for details
Copyright (c) 2020 University of Manchester. Developed by Marcel van Herk, Lambert Zijp and Jan Meinders; the Netherlands Cancer Institute; Radiotherapy Department; maintained by Marcel van Herk, University of Manchester.
Copyright (c) 1995 Regents of the University of California. All rights reserved. Developed by: Mark Oskin, [email protected]; University of California, Davis Medical Center; Department of Radiology with a Solaris port done and maintained by: Terry Rosenbaum; Michigan State University; Department of Radiology.
The contributors would like to thank
- The IBSI, 3D slicer and pyradiomics communities for providing valuable feedback on radiomics side of the project;
- Marcel van Herk for keeping the support of Conquest DICOM;
- plastimatch for making DICOM RT -> NRRD translation reproducible.