From 4f813fda67f675bdf818afac489322ba20520e5e Mon Sep 17 00:00:00 2001 From: Maxime Gillot Date: Thu, 28 Jul 2022 11:30:20 -0400 Subject: [PATCH] ToolTips and Readme changes --- ALI/Resources/UI/ALI.ui | 9 ++++ AMASSS/Resources/UI/AMASSS.ui | 6 +++ README.md | 94 +++++++++++++++++++++++++++++------ 3 files changed, 95 insertions(+), 14 deletions(-) diff --git a/ALI/Resources/UI/ALI.ui b/ALI/Resources/UI/ALI.ui index 4c3ea2a..ce1620d 100644 --- a/ALI/Resources/UI/ALI.ui +++ b/ALI/Resources/UI/ALI.ui @@ -251,6 +251,9 @@ + + Initiate download of a test scan (~ 100MB) using an URL opened in default system browser + Download test file @@ -258,6 +261,12 @@ + + Open a GitHub realease to download the trained models using an URL opened in default system browser + + + + Download latest models diff --git a/AMASSS/Resources/UI/AMASSS.ui b/AMASSS/Resources/UI/AMASSS.ui index 13a8ad0..8179c55 100644 --- a/AMASSS/Resources/UI/AMASSS.ui +++ b/AMASSS/Resources/UI/AMASSS.ui @@ -175,6 +175,9 @@ + + Initiate download of a test scan (~ 100MB) using an URL opened in default system browser + Download test scan @@ -182,6 +185,9 @@ + + Initiate download of the trained model (> 1GB) using an URL opened in default system browser + Download latest models diff --git a/README.md b/README.md index e33807c..543e949 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,59 @@ # Slicer Automated Dental Tools -_Authors: Maxime Gillot (University of Michigan), Baptiste Baquero (UoM)_ +--------------- -Extension Logo +Slicer automated dental tools is an extension for 3D Slicer for creating and executing simple modules (aka pipelines) via a GUI interface with no coding knowledge needed. + + +

+ Extension Logo +

+ +## Overview + Slicer automated dental tools is an extension perform automatic **segmentation** and **landmark identification** using machine learning tools. +## Features + + +* **Simple**: Perform time consuming task with a few clicks. +* **Automatic**: Automate important Dental and Cranio Facial analysis tasks. +* **Flexible**: The user can choose which models to use to perform the automated task. New models can be added easily. + + +## Modules + + +| Name | Description | +|------|-------------| +| [AMASSS](AMASSS) | Perform automatic segmentation of CBCT scan using the [AMASSS](https://github.com/Maxlo24/AMASSS_CBCT) algorithm. | +| [ALI-CBCT](ALI_CBCT) | Perform automatic landmark identification in CBCT using [ALI-CBCT](https://github.com/Maxlo24/ALI_CBCT) algorithm. | +| [ALI-IOS](ALI_IOS) | Perform automatic landmark identification in IOS using [ALI-IOS](https://github.com/baptistebaquero/ALIDDM) algorithm. | + -This extension will allow you to : -- segment CBCT scan using [AMASSS](https://github.com/Maxlo24/AMASSS_CBCT) -- Identify landmarks in CBCT using [ALI-CBCT](https://github.com/Maxlo24/ALI_CBCT) -- Identify landmarks in IOS using [ALI-IOS](https://github.com/baptistebaquero/ALIDDM) ## Requirements -``` -Slicer 5.1.0 or later -12GB of VRAM if possible -``` -### :warning: Warning +* In addition of the [Slicer System requirements](https://slicer.readthedocs.io/en/latest/user_guide/getting_started.html#system-requirements), for best performance, 12GB of memory is recommended. +* :warning: Trained networks are required to be manually downloaded. See requirements section specific to each module. + + + --- Exemples + # How to use the modules -On slicer, in the module selection table, a new option named **"Automated dental tools"** will allo you to choose between the modules : +On slicer, in the module selection table, a new module category named **"Automated dental tools"** will allo you to choose between the modules : - AMASSS (Automatic Multi-Anatomical Skull Structure Segmentation) - ALI (Automatic Landmark Identification) @@ -48,13 +70,21 @@ Both modules shares common features : - The "Prediction ID" field is for the user to choose what will appear on the output file name. ("Pred" by default) ---- +--------------- ## AMASSS Module Extension Logo AMASSS module will allow you to segment CBCT scan using [AMASSS](https://github.com/Maxlo24/AMASSS_CBCT) algortihm. + +### Prerequisites + +* Download the [trained models for AMASSS](https://github.com/Maxlo24/AMASSS_CBCT/releases/download/v1.0.1/ALL_NEW_MODELS.zip) using the `Download latest models` button in the module `Input section`. + + +### Module structure + **Input file:** The input has to be an oriented CBCT. It can be a single CBCT scan loaded on slicer or a folder containg CBCTs with the following extention: @@ -63,8 +93,12 @@ It can be a single CBCT scan loaded on slicer or a folder containg CBCTs with th .nii / .nii.gz .gipl / .gipl.gz ``` + +Available sample data for testing: [MG_test_scan.nii.gz](https://github.com/Maxlo24/AMASSS_CBCT/releases/download/v1.0.1/MG_test_scan.nii.gz) + **Load models:** The user has to indicate the path of the folder containing the [trained models for AMASSS](https://github.com/Maxlo24/AMASSS_CBCT/releases/download/v1.0.1/ALL_NEW_MODELS.zip). + **Segmentation selection:** @@ -93,6 +127,15 @@ ALI module as 2 modes that will allow the user to identify landmarks on: ### ALI-CBCT + +### Prerequisites + +* Download the [trained models for ALI-CBCT](https://github.com/Maxlo24/ALI_CBCT/releases/tag/v0.1-models) using the `Download latest models` button in the module `Input section`. + + +### Module structure + + **Input file:** The input has to be an oriented CBCT. It can be a single CBCT scan loaded on slicer or a folder containg CBCTs with the following extention: @@ -101,9 +144,12 @@ It can be a single CBCT scan loaded on slicer or a folder containg CBCTs with th .nii / .nii.gz .gipl / .gipl.gz ``` +Available sample data for testing: [MG_test_scan.nii.gz](https://github.com/Maxlo24/AMASSS_CBCT/releases/download/v1.0.1/MG_test_scan.nii.gz) + **Load models:** The user has to indicate the path of the folder containing the [trained models for ALI-CBCT](https://github.com/Maxlo24/ALI_CBCT/releases/tag/v0.1-models). + **Landmark selection:** Once the folder containing the trained models is loaded. The user can choose the landmark he want to identify with the table showing the available landmarks: ![SegTab](https://user-images.githubusercontent.com/46842010/180010603-37dce4c3-e7f8-4b3a-98a1-2874918320cb.png) @@ -112,6 +158,14 @@ Once the folder containing the trained models is loaded. The user can choose the ### ALI-IOS +### Prerequisites + +* Download the [trained models for ALI-IOS](https://github.com/baptistebaquero/ALIDDM/releases/tag/v1.0.3) using the `Download latest models` button in the module `Input section`. + + +### Module structure + + **Input file:** The input has to be an oriented IOS segmented with the [Universal Numbering System](https://en.wikipedia.org/wiki/Universal_Numbering_System). This segmentation can be automatically done using the [SlicerJawSegmentation](https://github.com/MathieuLeclercq/SlicerJawSegmentation) extention. @@ -120,12 +174,24 @@ The input can be a single IOS loaded on slicer or a folder containg IOS with the .vtk ``` +Available sample data for testing: [T1_01_L_segmented.vtk and T1_01_U_segmented.vtk](https://github.com/baptistebaquero/ALIDDM/releases/tag/v1.0.4) + **Load models:** The user has to indicate the path of the folder containing the [trained models for ALI-IOS](https://github.com/baptistebaquero/ALIDDM/releases/tag/v1.0.3). + **Landmark selection:** For the IOS landmarks, the user has to choose which tooth he need the landmakrs on by checking the label of the tooth on the left table. Once the folder containing the trained models is loaded. The user can choose the landmark he want to identify with the table on the right showing the available landmarks: ![LM_tab_ios](https://user-images.githubusercontent.com/46842010/180010083-4f7b6e31-edd3-41a2-a696-6a6a1a4d9260.png) + +# Acknowledgements + +_Authors: Maxime Gillot (University of Michigan), Baptiste Baquero (UoM),Lucia Cevidanes (UoM), Juan Carlos Prieto (UNC)_ + +Supported by NIDCR R01 024450, AA0F Grabber Family Teaching and Research Award and by Research Enhancement Award Activity 141 from the University of the Pacific, Arthur A. Dugoni School of Dentistry. + +# License +This software is licensed under the terms of the [Apache Licence Version 2.0](LICENSE).