Skip to content

Latest commit

 

History

History
66 lines (32 loc) · 2.85 KB

Usecase_walkthrough.md

File metadata and controls

66 lines (32 loc) · 2.85 KB
Raw

Running ShapeWorks in Slicer

template use case for the WIP Shapeworks Slicer extention https://github.com/dcwhite/SlicerSegmentMesher/tree/shapeworks-runner

This version is for segmented images, but can be extended to other datatypes

Data

This usecase will use the ellipsoid dataset, found within the github repo. An explaination of the equivalent workflow is found here.

Envisioned workflow

Load data into Slicer

Open Slicer and in the welcome module (default window) choose the AddData option. Using the dialogue window, select the 9 ellipsoid segmentations from the ShapeWorks usecases. before importing the volumes, switch the data type from Volume to Segmentation for each of the files.

segmentations can be edited in slicer before sending to ShapeWorks using the Segment Editor module

Running ShapeWorks in the Extension

Open the ShapeWorks Extension. Select from the list of Segmentations the ones to include in the shape model (all 9 ellipsoid segmentations).

Choose a project file path and name, if the file exists, it will populate the parameters of the UI from the project file, but it will be overwritten when shapeworks is run. the file path is where the data will be saved

choose the parameters to use for each of phases: groom, and optimize

click "groom"

This should save the data to the project path and create or modify the project file, which should look like the one provided with the example. The Extention should then launch Shapeworks, essentially with the system command:

shapeworks groom --name="project_file --progress"

Hopefully, it should be easy enough to track the progress, or we can include the printouts like in the Cleaver Extension.

The extension will catch when Shapeworks finishes the groom stage, which will allow the optimize step to be run

The groomed files found in the groom folder should be send back to Slicer. -- maybe?

Modify the optimize parameters as appropriate.

click "optimize"

This should modify the project file as approptiat, run the system command

shapeworks optimize --name="project_file --progress"

more info about the command line tools in ShapeWorks are found here

The extention should then show the specificity, generalization, and compactness plots and send the particles back to slicer

This can be done manually with https://discourse.slicer.org/t/how-to-replace-markups-with-np-array-in-application-markupstomodel/25000/8