Size: 10243
Comment:
|
Size: 11246
Comment:
|
Deletions are marked like this. | Additions are marked like this. |
Line 25: | Line 25: |
Set(s) of MRI in NIFTI format == Slicer Procedures == |
Set(s) of MRI in NifTI format == Slicer == |
Line 33: | Line 33: |
* Segment the tissue of interest using the following detailed segmentation procedures can be segmented by manually painting over its boundaries or using automated or semi-automated algorithms available in the image segmentation & analysis software. | * Segment the tissue of interest using the detailed segmentation procedures described below. |
Line 35: | Line 35: |
* Save the segmented label map regularly to avoid losing tedious work through program crashes.ation in process should be saved in the relevant repository area specific to the specimen and segmentation results. The file format should be NIFTI and file naming convention should rely on tissue labeling described in ["Specifications/DataManagement"], e.g., oks001-fmb-01.nii, indicating the segmentation for femur bone of the Open Knee(s) - Specimen 1, the appended number indicates the segmentation label (to accommodate multiple segmentations of the same volume by others). * Segmented volume can be overlayed on other image sets to evaluate boundaries, however it only be further edited on image volumes with the same resolution as the image from which it was originally defined. |
* Save the segmented label map regularly to avoid losing tedious work through program crashes. The file should be saved in the NifTI (.nii) format and file naming convention should rely on tissue labeling described in ["Specifications/DataManagement"], e.g., oks001-fmb-01.nii, indicating the segmentation for femur bone of the Open Knee(s) - Specimen 1, the appended number indicates the segmentation label (to accommodate multiple segmentations of the same volume by others). * Segmented volume can be overlayed on other image sets to evaluate boundaries, however it can only be further edited when overlayed on MRIs with the same size/resolution as the MRI from which it was originally created. |
Line 44: | Line 44: |
* File -> Add Data -> [Select MRI file in NifTI format] * Open drop-down menu from toolbar for list of modules. * Select Editor to edit the labelmap (a volume representation of highlighted regions). * One can manually segment bones for every slice, or use Growth Cut Effect and Threshold Effect. |
* File -> Add Data (or Data icon button) * Click "Choose File(s) to add" button. * Select desired MRI(s) (.nii) * Click "Open". |
Line 49: | Line 49: |
* File -> DICOM, or click DCM icon * Click Import * Select directory containing DICOM image slices (.IMA) * Click 'Add link' * CLick 'OK' after images load * Select desired Series in DICOM Browser window * Click 'Load' |
* File -> DICOM, or click DCM icon. * Click "Import" button. * Select directory containing DICOM image slices (.IMA). * Click 'Add link'. * CLick 'OK' after images load. * Select desired Series in DICOM Browser window. * Click 'Load'. |
Line 65: | Line 65: |
* NOTE: Link 2D slice views in drop-down tack menu to ensure same label map is displayed in all views. * NOTE: In Editor, make sure 'Merge Volume' is set to label map if applying grow-cut or other editor methods. |
NOTES: * Link 2D slice views in drop-down tack menu to ensure same label map is displayed in all views. * In Editor module, make sure 'Merge Volume' is set to label map if applying grow-cut or other editor methods. |
Line 72: | Line 73: |
* Select/Check the desired segmented label map volume (NRRD, .nrrd) | * Select/Check the desired segmented label map volume (default type: NRRD, .nrrd) |
Line 81: | Line 82: |
* Select/Check the desired triangulated surface (VTK, .vtk) | * Select/Check the desired triangulated surface (default type: VTK, .vtk) |
Line 88: | Line 89: |
In any of the 2D slice viewer windows, using the default mouse cursor pointer tool, click and drag up/down and left/right to change contrast and brightness of MRI | Under the pin drop-down menu (under >> button) in any of the 2D slicer viewers: * Link viewers to ensure that they all display the same label map volumes. * Two label maps can be overlayed at one time over the MRI in order to compare segmented boundaries between two different structures. The label map you want to edit should be set as the Label Layer (icon in pin drop-down 2D viewer menu with an "L"). The other label map can be loaded as the Foreground Layer (icon with an "F"). * Change transparency of the label map in 2D viewers by changing the percent opacity by changing value near the eye (display/hide) icon: 0.0 (transparent) to 1.0 (opaque). * Click on button next to eye icon to switch to outline view. Change contrast/brightness of MRI using the default mouse cursor pointer ( tool by clicking and dragging up/down and left/right in any of the 2D viewers. |
Line 98: | Line 106: |
* From Modules drop-down menu, select Editor * If first time entering Editor Module, click Apply to select the default !GenericAnatomyColors to create a new Merge Volume NOTE: if not first time, make sure label map displayed (i.e. being edited) in 2D slice viewers is the same as the Merge Volume. |
* From the "Modules" drop-down menu, select "Editor" * If multiple MRI sets are loaded, make sure that the desired MRI to be segmented is selected as the Master Volume * If it is the first time entering Editor Module, click Apply to select the default !GenericAnatomyColors to create a new Merge Volume (i.e. label map, with the same size/resolution as the Master Volume) If not the first time, make sure the desired label map overlayed (i.e. being edited) in the 2D slice viewers is the same as the Merge Volume. |
Line 102: | Line 111: |
* Use Paint Effect (under 'Edit Selected Label Map' tab, top row of icons, 3rd icon from left) [with an appropriate/largest radius] to highlight anatomy of interest (foreground) using a specific label (e.g. label1). * Use Paint Effect to highlight area around anatomy of interest (background) with a different label (e.g. label2). * Use Paint Effect to "cap" boundaries of anatomy of interest (background) to prevent foreground leakage (before/after anatomy of interest appears). |
* Use the Paint Effect (under 'Edit Selected Label Map' tab, top row of icons, 3rd icon from left) [with an appropriate/largest radius] to highlight anatomy of interest (foreground) using a specific label (e.g. label1). * Use the Paint Effect to highlight area around anatomy of interest (background) with a different label (e.g. label2). * Use the Paint Effect to "cap" boundaries of anatomy of interest (background) to prevent foreground leakage (before/after anatomy of interest appears). |
Line 106: | Line 115: |
* Click Apply button. [window graphics will freeze until grow cut algorithm is complete. * Remove background label: |
* Click the "Apply" button (Slicer window graphics will freeze until the grow cut algorithm is complete). * Remove the background label: |
Line 110: | Line 119: |
* Click Apply button. | * Click the "Apply" button. |
Line 129: | Line 138: |
* To change transparency of label in views or switch label to outline view. * Hover over thumb tack in top left of view. * Select '>>' button. * Change percent opacity by changing value near eye icon: 0.0 (transparent) to 1.0 (opaque). * Click on button next to eye icon to switch to outline view. |
|
Line 206: | Line 210: |
Procedure for patellar ligament, quadriceps tendon (and any other applicable tissue): PHASE 1 (segment the ligament MRI): 1. Load sagittal ligament MRI. 1. Perform the Grow Cut segmentation procedure on desired tissue. 1. Modify the label map boundary manually if desired. PHASE 2 (segment the cartilage MRI): 1. Load cartilage MRI. 1. Overlay ligament MRI segmented label map over the cartilage MRI (as Foreground Layer). 1. Create new label map (Merge Volume) from cartilage MRI (set as Label Layer). 1. Manually segment the tissue using the ligament MRI label map bounaries as a guide. Procedure for ACL, PCL, LCL, etc.: Manual segment each tissue of interest on the cartilage MRI. |
|
Line 208: | Line 228: |
Tissue labels include ACL, PCL, LCL, PTL, QAT, etc. | Tissue labels: ACL, PCL, LCL, PTL, QAT, etc. |
Target Outcome
This specification targets at volumetric reconstruction of a tissue of interest, specifically the definition of the boundaries of the tissue,
- as an image volume, and
- as a surface representation.
Prerequisites
Previous Protocols
For more details, see ["Specifications/ExperimentationAnatomicalImaging"].
Protocols
Input
Set(s) of MRI in NifTI format
Slicer
Overview
- Download desired image volume for the desired specimen (NifTI, .nii).
- Load the desired image volume into Slicer.
- Segment the tissue of interest using the detailed segmentation procedures described below.
- NOTES:
- Save the segmented label map regularly to avoid losing tedious work through program crashes. The file should be saved in the NifTI (.nii) format and file naming convention should rely on tissue labeling described in ["Specifications/DataManagement"], e.g., oks001-fmb-01.nii, indicating the segmentation for femur bone of the Open Knee(s) - Specimen 1, the appended number indicates the segmentation label (to accommodate multiple segmentations of the same volume by others).
- Segmented volume can be overlayed on other image sets to evaluate boundaries, however it can only be further edited when overlayed on MRIs with the same size/resolution as the MRI from which it was originally created.
- After completion of the segmentation, the volume should be exported as an image volume (NIFTI) and a triangulated surface (without smoothing) in STL format, e.g. oks001-fmb-01.stl
Image/Data Input/Output Procedures
Load MRI data:
- NifTI:
File -> Add Data (or Data icon button)
- Click "Choose File(s) to add" button.
- Select desired MRI(s) (.nii)
- Click "Open".
- DICOM:
File -> DICOM, or click DCM icon.
- Click "Import" button.
- Select directory containing DICOM image slices (.IMA).
- Click 'Add link'.
- CLick 'OK' after images load.
- Select desired Series in DICOM Browser window.
- Click 'Load'.
Load segmented label map image data (NifTI):
File -> Add Data
- Click 'Choose File(s) to Add'
- Select Segmented label map image(s) (NifTI, .nii)
- Click 'Open'
- Click/check 'Show Options'
Click/check 'LabelMap'
- NOTES:
- Link 2D slice views in drop-down tack menu to ensure same label map is displayed in all views.
- In Editor module, make sure 'Merge Volume' is set to label map if applying grow-cut or other editor methods.
Save segmented label map (as NifTI):
File -> Save, or Save icon
- Deselect all modified/selected files in the 'File Name' field
- Select/Check the desired segmented label map volume (default type: NRRD, .nrrd)
- Set the 'File Format' to NifTI (.nii)
- Rename the label map volume as desired, see naming convention: ["Specifications/DataManagement"]
- Click 'Save'
Save triangulated surface (a.k.a. Slicer Model):
File -> Save, or Save icon
- Deselect all modified/selected files in the 'File Name' field
- Select/Check the desired triangulated surface (default type: VTK, .vtk)
- Set the 'File Format' to STL (.stl)
- Rename the triangulated surface as desired, see naming convention: ["Specifications/DataManagement"]
- Click 'Save'
Viewing Options
Under the pin drop-down menu (under >> button) in any of the 2D slicer viewers:
- Link viewers to ensure that they all display the same label map volumes.
- Two label maps can be overlayed at one time over the MRI in order to compare segmented boundaries between two different structures. The label map you want to edit should be set as the Label Layer (icon in pin drop-down 2D viewer menu with an "L"). The other label map can be loaded as the Foreground Layer (icon with an "F").
- Change transparency of the label map in 2D viewers by changing the percent opacity by changing value near the eye (display/hide) icon: 0.0 (transparent) to 1.0 (opaque).
- Click on button next to eye icon to switch to outline view.
Change contrast/brightness of MRI using the default mouse cursor pointer ( tool by clicking and dragging up/down and left/right in any of the 2D viewers.
Segmentation Procedures
Manual Segmentation
Insert Katie's instructions here!
Grow-Cut Segmentation
- From the "Modules" drop-down menu, select "Editor"
- If multiple MRI sets are loaded, make sure that the desired MRI to be segmented is selected as the Master Volume
If it is the first time entering Editor Module, click Apply to select the default GenericAnatomyColors to create a new Merge Volume (i.e. label map, with the same size/resolution as the Master Volume)
- If not the first time, make sure the desired label map overlayed (i.e. being edited) in the 2D slice viewers is the same as the Merge Volume.
- Perform the following steps on roughly equally-spaced slices in each image plane orientation as appropriate (coronal, sagittal, axial).
- Use the Paint Effect (under 'Edit Selected Label Map' tab, top row of icons, 3rd icon from left) [with an appropriate/largest radius] to highlight anatomy of interest (foreground) using a specific label (e.g. label1).
- Use the Paint Effect to highlight area around anatomy of interest (background) with a different label (e.g. label2).
- Use the Paint Effect to "cap" boundaries of anatomy of interest (background) to prevent foreground leakage (before/after anatomy of interest appears).
Select GrowCutEffect icon (under 'Edit Selected Label Map' tab, bottom row of icons, 3rd icon from left).
- Click the "Apply" button (Slicer window graphics will freeze until the grow cut algorithm is complete).
- Remove the background label:
Select ChangeLabelEffect (under 'Edit Selected Label Map' tab, bottom row of icons, 3rd icon from right).
- Select label2 as input and background [0] as output.
- Click the "Apply" button.
See figures below for example of segmentation using GrowthCut Effect with foreground (green) and background (yellow).
attachment:gc1.png attachment:gc2.png attachment:gc3.png attachment:gc4.png
For more information on Growth Cut Effect refer to the 3DSlicerWiki [http://www.slicer.org/slicerWiki/index.php/Modules:GrowCutSegmentation-Documentation-3.6].
- Tips and Shortcuts using 3DSlicer:
- In Editor Mode:
- 'c' to open list of labels, type # of label id and enter to switch labels quickly
- 'z' to undo
- 'y' to redo
- 'd' for Draw Effect
- 'p' for Paint Effect
- 'e' to erase from label
- arrow keys to move forward/background a slice
- In Editor Mode:
Image Processing Procedures
Label Map Smoothing
From the Modules drop-down menu, select 'Surface Models' -> 'Label Map Smoothing'
- Set Gaussian Smoothing Parameters, Sigma based on image resolution (e.g. 0.7 for cartilage MRI, resolution = 0.35 x 0.35 x 0.7 mm)
- From 'Input Volume' drop-down menu, select desired label map
- From 'Output Volume' drop-down menu, select 'Create and rename new Volume'
- Enter new name as desired, click 'OK'
- Click Apply
Generate Triangulated Surface from Label Map
From the Modules drop-down menu, select 'Surface Models' -> 'Model Maker'
- Under 'IO' tab, from 'Input Volume' drop-down menu, select desired Label Map
- In Model drop-down menu, either 'Create and rename new Hierarchy' (e.g. default 'Models'), or select an existing Model Hierarchy.
- NOTE: all models can be generated under the same or separate model hierarchies
- Under 'Create Model' tab, specify a desired 'Model Name' for the select Label Map.
- If no smoothing is desired, under 'Model Maker Parameters set 'Smooth' to zero.
- Click Apply button.
- From Editor:
Select the MakeModelEffect
- Set desired Label Map as the Merge Volume
- If no smoothing is desired, deselect 'smooth model'
- Click Apply button.
Tissue-Specific Procedures
Registration Markers
For Registration Marker segmentation, the following technique was used:
- Use the level tracing effect to fill in the registration markers in the beginning, middle, and end of it's respective appearances within the slices, for each view.
- Next fill in any gaps with the paint tool.
- Finally, on those slices, outline the area surrounding the markers with a different color and use the grow cut effect to fill in the segmentation (as described above).
Volume labels include bone type and marker location, e.g. REG-FM, where REG stands for registration, F for femur, M for medial. In result, potential labels are REG-FM, REG-FL, REG-FA, REG-FP, REG-TM, REG-TL, REG-TA, REG-TP, REG-PS, REG-PL, REG-PM.
Bones
INPUT: cartilage MRI
Bone segmenatation procedure:
- Perform Grow Cut segmentation procedure on desired bone
- Perform Label Map Smoothing to remove Grow Cut boundary noise
- Perform manual segmentation to more accurately define bone boundary
- Iteratively repeat last two steps until boundary is as desired NOTE: Cortical bone will appear black in MR images, so outer edge of black bone region defines the bone surface.
OUTPUT LABELS: FMB (femur), TBB (tibia), FBB (fibula), PTB (patella).
Cartilage
INPUT: cartilage MRI
Cartilage segmentation should be informed by bone segmentation, i.e. subtraction of bone volume to trim back surface of cartilage.
OUTPUT LABELS: FMC (femoral), TBC-M (medial tibial), TBC-L (lateral tibial), PTC (patellar).
Menisci
Menisci segmentation should be informed by cartilage segmentation, i.e. subtraction of menisci volume to match cartilage boundaries.
Tissue labels include MNS-M (medial), MNS-L (lateral).
Ligaments & Tendons
Procedure for patellar ligament, quadriceps tendon (and any other applicable tissue):
- PHASE 1 (segment the ligament MRI):
- Load sagittal ligament MRI.
- Perform the Grow Cut segmentation procedure on desired tissue.
- Modify the label map boundary manually if desired.
- Load cartilage MRI.
- Overlay ligament MRI segmented label map over the cartilage MRI (as Foreground Layer).
- Create new label map (Merge Volume) from cartilage MRI (set as Label Layer).
- Manually segment the tissue using the ligament MRI label map bounaries as a guide.
Procedure for ACL, PCL, LCL, etc.:
- Manual segment each tissue of interest on the cartilage MRI.
Ligament segmentation should be informed by bone segmentation, i.e. subtraction of bone volume to trim insertion areas.
Tissue labels: ACL, PCL, LCL, PTL, QAT, etc.
Output
- Volume of tissue of interest as a binary image aligned with original MRI coordinate system (raw, without filtering and smoothing)
- Surface representation of tissue of interest in STL format in MRI coordinate system (raw, without filtering and smoothing)