yujing1997 / MedSAMSlicer

3D Slicer Plugin for Segment anything in medical images

MedSAM-Lite 3D Slicer Plugin

This is the official repository for 3D Slicer Plugin for MedSAM: Segment Anything in Medical Images.

output.mp4

Installation

You can watch a video tutorial of installation steps here.

1. Install 3D Slicer from its official website. The compatibility of our plugin has been tested with 3D Slicer >= 5.4.0
2. Download the specific version of the plugin from releases page and extract to your desired location.
3. In the Slicer App, select the Welcome to Slicer drop-down menu in the toolbar at the top and navigate to Developer Tools > Extension Wizard.
4. Click on select Extension and locate the MedSAM folder among the extracted files and directories at step 2. Accept if asked to add the new modules.
5. Now, from the Welcome to Slicer drop-down menu, under the Segmentation sub-menu, MedSAMLite option is added. By choosing it, you get to the final steps.
6. Choose a folder to install module dependencies and click on Install dependencies. It can take several minutes.
7. Restart 3D Slicer.

Upgrade

If you have version <= v0.02 installed: Remove all pre-existing files from both step#2 and step#6 and install the new version as instructed before.

If you have version > v0.02 installed: Use the Upgrade Module button at the top of the module interface to check for and install new updates.

Usage

You can watch a video guide for usage here.

1. From the Welcome to Slicer drop-down menu, under the Segmentation sub-menu, MedSAMLite option is added. By choosing it, you get to the final steps.
2. Load your image file.
3. From Prepare Data accordion menu you can choose from preset preprocessing methods (optional, but extremely helpful)
4. From Select the Region of Interest accordion menu, you can click on Attach ROI to select the region for segmentation.
5. From Start Segmentation accordion menu, click on Send Image button. It will send the whole 3D image to the backend of the module for process. It will take several minutes. You will need to do this step only once for each image. As long as the image is not changed (new preprocessing / cropping / etc.) you do not have to redo this step. Note For Windows Users. At this step, firewall might stop the backend and ask for the permission. Grant the permission. In some cases you might need to reboot your computer to update permissions.
6. Click on Segmentation button to get the segmentation results. You can replace your ROI or delete and re-attach it (step 4) as many times as you need and repeat step 6 without going over step 5 again.
7. In the same section, from the Segmentation and Source volume drop-down menus you can choose the right segmentation group and manually refine the segmentation results. You can also assign different color to each segmentation mask.