dissector 0.0.4

This package contains methods for medical image segmentation.

Dissector

(Badges to be updated soon.)

fair-software.eu recommendations
code repository
license
community registry
citation
howfairis
Other best practices
Documentation
Build
Citation data consistency
Link checker

How to use dissector

Dissector is is an open-source python library which contains methods for medical image segmentation and the evaluation of medical image segmentation. The module for evaluation contains methods to compare a segmentation to a 'ground truth' segmentation. This module should be run in it's own dedicated environment, which can be made in conda (see yaml environment_evaluation), pip or uv. Currently it has only been tested in conda, but the requirements are loose.
The metrics beyond the expected (hausdorf, jaccard, fp, fn, dice) implemented are : boundary intersection over union, binary cross entropy (for comparing two binary segmentation masks). Please note at present a much more robust group of metrics can be created with libraries like MONAI (metrics doc link). Metrics here are implemented for convenience i.e. no need to load pytorch, have lot of GPU space or cry as dependancies clash. Images can be extracted from DICOM files or used directly (nifti or arrays). The long term goal of the dissector project is to compare existing segmentation methods to a to be released state of the art method currently being built but not publicly released yet. This new method exploits the various types of noise in different MRI sequences...so computer science enthousiasts can probably guess the kind of model on the way. The primary authors are Candace Makeda H. Moore and Morris Alper.

The project setup is documented in project_setup.md. Feel free to remove this document (and/or the link to this document) if you don't need it.

Installation

To install dissector from GitHub repository, do:

git clone [e-mail]:drcandacemakedamoore/dissector.git
cd dissector
python -m pip install .

Instructions for uv and conda soon to come...

Documentation

One source should be https://drcandacemakedamoore.github.io/dissector/. Pypi and build the docs may take longer. Until then it should be online and buid in your docs/_build folder.

Contributing

If you want to contribute to the development of dissector, have a look at the contribution guidelines.

Credits

This package was created with Copier and the NLeSC/python-template.

Generative AI disclosure

This package has some code created with the aid of generative AI.