topology_correction¶
-
nighres.shape.
topology_correction
(image, shape_type, connectivity='wcs', propagation='object->background', minimum_distance=1e-05, topology_lut_dir=None, save_data=False, overwrite=False, output_dir=None, file_name=None)[source]¶ Topology correction
Corrects the topology of a binary image, a probability map or a levelset surface to spherical with a fast marching technique [1].
Parameters: - image (niimg) – Image representing the shape of interest
- shape_type ({'binary_object','probability_map','signed_distance_function'}) – Which type of image is used as input
- connectivity ({'wcs','6/18','6/26','18/6','26/6'}) – What connectivity type to use (default is wcs: well-composed surfaces)
- propagation ({'object->background','background->object'}) – Which direction to use to enforce topology changes (default is ‘object->background’ )
- minimum_distance (float, optional) – Minimum distance to impose between successive voxels (default is 1e-5)
- topology_lut_dir (str, optional) – Path to directory in which topology files are stored (default is stored in TOPOLOGY_LUT_DIR)
- save_data (bool, optional) – Save output data to file (default is False)
- overwrite (bool, optional) – Overwrite existing results (default is False)
- output_dir (str, optional) – Path to desired output directory, will be created if it doesn’t exist
- file_name (str, optional) – Desired base name for output files with file extension (suffixes will be added)
Returns: Dictionary collecting outputs under the following keys (suffix of output files in brackets)
- corrected (niimg): Corrected image (output file suffix _tpc-img)
- object (niimg): Corrected binary object (output file suffix _tpc-obj)
Return type: Notes
Original Java module by Pierre-Louis Bazin
References
[1] Bazin and Pham (2007). Topology correction of segmented medical images using a fast marching algorithm doi:10.1016/j.cmpb.2007.08.006