Skip to content

Commit

Permalink
Updates and add Markups III
Browse files Browse the repository at this point in the history
  • Loading branch information
smrolfe committed May 22, 2022
1 parent 9fb9c4c commit 828b04d
Show file tree
Hide file tree
Showing 15 changed files with 20 additions and 19 deletions.
16 changes: 8 additions & 8 deletions Markups_1/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ Markups can be interacted with through the `Markups module` or the `Markups Tool
### Markup types
Currently, there are seven types of markups available in the Slicer application, listed below. For additional details on each see the [Markups module documentation](https://slicer.readthedocs.io/en/latest/user_guide/modules/markups.html).

**Fiducial:**
A container that can contain multiple points.
**Point list:**
A container that can contain multiple control points.

**Lines:**
Two points, placed sequentially, creating a line between them.
Expand Down Expand Up @@ -49,7 +49,7 @@ Markups can also be accessed and manipulated using the `Markups` module.

* New markups can be created using the buttons in the **Create** menu, at the top of the `Markups` module.
* To add new points to an existing node, select the node from list in the `Markups` module, and use the **Place point** button.
* In practice, you should create markup nodes for different sets (e.g., Skull_LMs, Mandible_LMs, etc). Any set of landmarks that you will analyze indepedently should have its own MarkupFiducial node.
* In practice, you should create markup nodes for different sets (e.g., Skull_LMs, Mandible_LMs, etc). Any set of landmarks that you will analyze indepedently should have its own Point List node.

<img src="./images/organize.png">

Expand All @@ -66,19 +66,19 @@ Markups can also be accessed and manipulated using the `Markups` module.

### The Control Points menu

* In the **Control Points** menu there is a menu with buttons to operate on all/highlighted subsets of points and a table to adjust visibility, labels, and position of the fiducials points individually.
* In the **Control Points** menu there is a menu with buttons to operate on all/highlighted subsets of points and a table to adjust visibility, labels, and position of the control points individually.

<img src="./images/ControlPointsMenu.png">

* Because there is no undo for markups actions, when you are actively landmarking, we suggest setting the lock icon so that you don't accidentally grab an already placed LM and modify it.
* You can copy/paste/delete control points across fiducial nodes by highlighting the rows (use ctrl to select multiple rows), as if in a regular spreadsheet.
* You can copy/paste/delete control points across point lists by highlighting the rows (use ctrl to select multiple rows), as if in a regular spreadsheet.
* The status of the position can be in the following states: Placed, Unset, Skipped, and Edit. The position status of an individual point can be toggled in the control points table or in the right-click context menu. Additional information on these position states is covered in the Markups Template tutorial.
* You can right click and use **Click to Jump Slicess** option to see where the fiducial is in slice views. This is a very useful feature, if you are landmarking directly on the 3D volume (e.g., a CT scan) as oppose to a 3D model.
* You can right click and use **Click to Jump Slicess** option to see where the control point is in slice views. This is a very useful feature, if you are landmarking directly on the 3D volume (e.g., a CT scan) as oppose to a 3D model.

<img src="./images/JumpSlices.png">

* The **Advanced** section of the **Control Points** menu allows you to move highlighted control points up or down in the list, or add a new uninitialized fiducial point to the list. You will find this feature useful when you miss a landmark in the sequence, and place it later.
* The **Name Format** field allows you to modify the fiducial labels in bulk. Current convention of %N-%d means that landmarks are named by the node name (e.g., MarkupsFiducial) followed by the (-) sign and the number indicating the sequence they are landmarked. If you want a shorted label, you can just switch to %d and hit apply to rename the existing ones. The subsequent fiducials will follow this format.
* The **Advanced** section of the **Control Points** menu allows you to move highlighted control points up or down in the list, or add a new uninitialized control point to the list. You will find this feature useful when you miss a landmark in the sequence, and place it later.
* The **Name Format** field allows you to modify the control point labels in bulk. Current convention of %N-%d means that landmarks are named by the node name (e.g., MarkupsFiducial) followed by the (-) sign and the number indicating the sequence they are landmarked. If you want a shorted label, you can just switch to %d and hit apply to rename the existing ones. The subsequent control points will follow this format.
<img src="./images/ControlPoints.png">
----

Expand Down
Binary file removed Markups_1/images/ControlPoints.png
Binary file not shown.
Binary file removed Markups_1/images/Display.png
Binary file not shown.
Binary file removed Markups_1/images/FiducialPersistence.png
Binary file not shown.
Binary file modified Markups_1/images/InteractionHandles.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_1/images/JumpSlices.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_1/images/MarkupTypes.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_1/images/Measurements.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed Markups_1/images/MouseModes.png
Binary file not shown.
Binary file modified Markups_1/images/organize.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_2/images/curveOnMesh.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_2/images/measures.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_2/images/newCurve.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified Markups_2/images/resampleOptions.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
23 changes: 12 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,18 +9,19 @@ These tutorials show how to use SlicerMorph (and other relevant Slicer) modules
4. #### [**SkyscanReconImport:** How to import output from Bruker/Skyscan MicroCT](https://github.com/SlicerMorph/Tutorials/tree/main/SkyscanReconImport)
5. #### [**MorphoSourceImport**: How to quickly query and import open-access 3D models from MorphoSource](https://github.com/SlicerMorph/Tutorials/tree/main/MorphoSourceImport)
6. #### [**Export File:** This feature is now a core Slicer feature. Right click on any object in the Data module and choose "Export File".](https://discourse.slicer.org/t/multiple-node-export-now-supported/21681)
18. #### [**Animator:** How to create keyframe-based animations of microCT scans](https://github.com/SlicerMorph/Tutorials/tree/main/Animator)
7. #### [**Animator:** How to create keyframe-based animations of microCT scans](https://github.com/SlicerMorph/Tutorials/tree/main/Animator)

7. #### [**Markups-I:** Introduction markup types, UI, settings:](https://github.com/SlicerMorph/Tutorials/tree/main/Markups_1)
8. #### [**Markups-II:** Resampling Semi-landmarks on curves](https://github.com/SlicerMorph/Tutorials/tree/main/Markups_2)
9. #### [**Patch-based Semi-Landmarking tutorial:**](https://github.com/SlicerMorph/Tutorials/tree/main/CreateSemiLMPatches)
10. #### [**Creating a template of Pseudo-landmarks via PseudoLMGenerator:**](https://github.com/SlicerMorph/Tutorials/tree/main/PseudoLMGenerator)
11. #### [**MarkupEditor:** How to subset/edit dense landmark sets](https://github.com/SlicerMorph/Tutorials/tree/main/MarkupsEditor)
12. #### [**MergeMarkups:** Merging fix and semiLMs or separate curve semiLMs for analysis](https://github.com/SlicerMorph/Tutorials/tree/main/MergeMarkups)
13. #### [**ALPACA:** Automated Landmarking through Point cloud Alignment and Correspondence Analysis](https://github.com/SlicerMorph/Tutorials/tree/main/ALPACA)
14. #### [**GPA-I:** Basics of GPA: Setting the analysis, exploring the morphospace](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_1)
15. #### [**GPA-II:** 3D interactive visualization of morphospace and exporting animations](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_2)
16. #### [**GPA-III:** Exporting data/results for R](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_3#readme)
8. #### [**Markups-I:** Introduction markup types, UI, settings:](https://github.com/SlicerMorph/Tutorials/tree/main/Markups_1)
9. #### [**Markups-II:** Resampling Semi-landmarks on curves](https://github.com/SlicerMorph/Tutorials/tree/main/Markups_2)
10. #### [**Markups-II:** Resampling Semi-landmarks on curves](https://github.com/SlicerMorph/Tutorials/tree/main/Markups_2)
11. #### [**Patch-based Semi-Landmarking tutorial:**](https://github.com/SlicerMorph/Tutorials/tree/main/CreateSemiLMPatches)
12. #### [**Creating a template of Pseudo-landmarks via PseudoLMGenerator:**](https://github.com/SlicerMorph/Tutorials/tree/main/PseudoLMGenerator)
13. #### [**MarkupEditor:** How to subset/edit dense landmark sets](https://github.com/SlicerMorph/Tutorials/tree/main/MarkupsEditor)
14. #### [**MergeMarkups:** Merging fix and semiLMs or separate curve semiLMs for analysis](https://github.com/SlicerMorph/Tutorials/tree/main/MergeMarkups)
15. #### [**ALPACA:** Automated Landmarking through Point cloud Alignment and Correspondence Analysis](https://github.com/SlicerMorph/Tutorials/tree/main/ALPACA)
16. #### [**GPA-I:** Basics of GPA: Setting the analysis, exploring the morphospace](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_1)
17. #### [**GPA-II:** 3D interactive visualization of morphospace and exporting animations](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_2)
18. #### [**GPA-III:** Exporting data/results for R](https://github.com/SlicerMorph/Tutorials/tree/main/GPA_3#readme)
19. #### [**Auto3Dgm:** An automated procedure for placing landmarks](https://toothandclaw.github.io/how-to-use/)


Expand Down

0 comments on commit 828b04d

Please sign in to comment.