XDRT (XDR Tools)¶
XDRT is a python toolkit to work with the XDR file format used e.g. by Elekta to store cone-beam CT images and as reconstructed by XVI. The reading of complete XVI reconstruction folders is also supported, exporting to either an ITK supported format or DICOM, recovering metadata from the XVI files.
Free software: Apache Software License 2.0. Decompression library is public domain, but has a different license.
Documentation: https://docs.aiforoncology.nl/xdrt/.
Installation instructions: https://docs.aiforoncology.nl/xdrt/installation.html.
Features¶
Utilities to read (compressed) 3D and 4D XDR files in python.
Ability to read XVI files and link planning scans with cone-beam CT scans.
xdr2imgcommand line utility to convert xdr images to ITK supported formats.xvi2imgcommand line utility converts a fraction (reconstruction) to ITK supported formats.xvi2dcmcommand line utility converts a fraction (reconstruction) to dicom.
How to use¶
The package needs to compile the decompression library, which can be done with:
python setup.py install or with pip install git+https://github.com/NKI-AI/xdrt.git
or from PyPi using pip install xdrt. Detailed installation instructions are available in
the documentation.
The command line program
xdr2img image.xdr image.nrrdconverts images from XDR to any ITK supported format. For more details checkxdr2img --help.The command line program
xvi2imgreads XVI files and combined with the XDR files, writes to a new directory and image format. For more details checkxvi2img --help.
Work in progress¶
This package is work in progress, if you have an image which is not properly parsed
by xdrt, create an issue with the image and expected output.
The following is not yet supported:
Origin is not yet always properly parsed.
Only
uniformgrids are currently supported.
Create an issue if this is an urgent issue for you.