levelset_fusion

nighres.shape.levelset_fusion(levelset_images, correct_topology=True, topology_lut_dir=None, save_data=False, overwrite=False, output_dir=None, file_name=None)[source]

Levelset fusion

Creates an average levelset surface representations from a collection of levelset surfaces, with same avearage volume and (optionally) spherical topology

Parameters:
  • levelset_images (niimg) – List of levelset images to combine.
  • correct_topology (bool, optional) – Corrects the average shape to ensure correct topology (default is True)
  • 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)

  • result (niimg): Levelset representation of combined surface (_lsf-avg)

Return type:

dict

Notes

Original Java module by Pierre-Louis Bazin

Examples using nighres.shape.levelset_fusion