The DICOM import
Even though DICOM data is supposed to be highly standardized it still features substantial variation. Consequently it is very difficult for us to eliminate all bugs in matRad's DICOM import. As of June 2015 we have a beta version included in matRad which has been thoroughly tested using data from our center(s). We would like to remind all users to take utmost care when running a matRad DICOM import and double check the imported ct data in the ct-struct and the imported structure sets in the cst-cell array. If you do find any bugs, help us improve matRad's DICOM import and drop us a line.
As of now, all *.dcm files need to be located in the same folder (no subfolders) for the import to work. That includes all ct-images and the structure file(s). If you wish to include a treatment plan and resulting dose cubes in your import, the treatment plan files and dose series files need to be located in the same folder. It is possible to have DICOM data for multiple patients in this folder, as you are able to specify a patient, ct-series, structure set and treatment plan later during the import. The dose series files enable you to directly import the corresponding dose distribution to your treatment plan.
To start the import, you first need to add the matRad folder dicomImport to your path. You can do so either by right-click → Add to Path or by typing addpath(genpath('dicomImport')) in your Command Window. genpath also adds HLUT library-subfolder to your path.
Now you have access to the matRad-functions designated for the DICOM import. To start the GUI you can simply type matRad_importDicomGUI in your Command Window. If you already work with matRad and have matRadGUI open, you can also start the import GUI with the Load DICOM button.
You should see something like this:
Now you can choose your patient directory. Simply click the Browse button and navigate to the desired directory. After choosing a folder, it will directly be analyzed for different patients, image series, structure sets, treatment plans and dose series.
The result will look something like this:
Now you can choose your patient, image series, structure set, RT plan and dose series. If there are serveral dose cubes referring to the same plan, you can decide to import just one, several or all dose cubes. In the bottom left corner you can see the resolution of the chosen image series. You can adjust these values to interpolate a cube with a new resolution. Downsampling the CT makes sense in order to restrict matRad's memory usage. If your image series contains non-equally spaced slices, you have to specify a resolution. Another option is to use the resolution of the dose grid by activating the check box Use RT Dose grid after choosing a dose series. Now you can click on Import and will see a waitbar pop-up.
Your command window will show you the following output:
If you import steering information from a proton or carbon treatment plan, you have to specify the base data of your machine as this information is not saved in the DICOM files. Therefore, you will see a pop-up window in which you can choose the correct base data for the beam quality you use. If you import steering information from a photon treatment plan, the generic photon base data will be selected automatically.
After the import has finished, a 'Save as'-dialogue will open to save the imported data in a *.mat file.
Now you can use this patient data set just like the ones provided with matRad.
