Skip to content

OpenGATE/GateTools

Repository files navigation

Build status PyPI

Tools for GATE simulations.

Install with : pip install gatetools

Clone the repository with git clone --recursive https://github.com/OpenGATE/GateTools.git (or git submodule update --init to update) then cd GateTools, then pip install -e .

Example of usage:

gt_gate_info
gt_image_convert input.dcm -o output.mhd
gt_image_convert input.mhd -o output_float.mhd -p float
gt_image_arithm *.mhd -o output.mhd -O sum
gt_gamma_index dose.mhd gate-DoseToWater.mhd -o gamma.mhd --dd 2 --dta 2.5 -u "%" -T 0.2

Use the flag -h to get print the help of each tool. Here is the current list of command line tools.

Tool Comment
gt_affine_transform Resample (resize, rotate) an image
gt_dicom_info Print tag values of a dicom file
gt_dicom_rt_pbs2gate Convert Dicom RT proton plan for Gate
gt_dicom_rt_struct_to_image Turn Dicom RT Struct contours into mask image
gt_dvh Create Dose Volume Histogram
gt_gamma_index Compute gamma index between images
gt_gate_info Display info about current Gate/G4 version
gt_hausdorff Compute Hausdorff distance
gt_image_arithm Pixel- or voxel-wise arithmetic operations
gt_image_convert Convert image file format (dicom, mhd, hdr, nii ... )
gt_image_crop Crop an image
gt_image_gauss Blur an image using gaussian filter
gt_image_resize Resize an image
gt_image_statistics Statistics of an image
gt_image_to_dicom_rt_struct Convert mask image to Dicom RTStruct
gt_image_uncertainty Compute statistical uncertainty
gt_merge_root Merge root files
gt_morpho_math Compute morphological operation
gt_phsp_convert Convert a phase space file from root to npy
gt_phsp_info Display information about a phase space file
gt_phsp_merge Merge two phase space files (output in npy only)
gt_phps_peaks Try to detect photopeaks (experimental)
gt_phsp_plot Plot marginal distributions form a phase space file
gt_write_dicom Convert image (mhd, nii, ...) to dicom
gt_digi_mac_converter Convert old digitizer macros to the new commands (Gate9.3)

All tools are also available to be use within your own Python script with, for example:

import gatetools as gt
gt.image_convert(inputImage, pixeltype)

Tests: run

python -m unittest gatetools -v
python -m unittest gatetools.phsp -v

Classes and function documentation. Use the following command to open a browser for documentation (it is still not very convenient ; will be improved later).

pydoc -b

For developers, please have a look at the readme_dev.md file.