From 4336f1a0de46618455c6028ff649db60c1928294 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Wed, 29 Mar 2023 08:11:14 +0000 Subject: [PATCH 01/37] Update README.md --- README.md | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index b2746c4..da618f7 100644 --- a/README.md +++ b/README.md @@ -1,5 +1,18 @@ -# NAISR -NAISR: A 3D Neural Additive Model for Interpretable Shape Representation +# NAISR: A 3D Neural Additive Model for Interpretable Shape Representation +
+This is the official implenmentation for, +**NAISR: A 3D Neural Additive Model for Interpretable Shape Representation.** +Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer. https://arxiv.org/abs/2303.09234 -Codes on the way... +## Cite this work +``` +@article{jiao2023naisr, + title={NAISR: A 3D Neural Additive Model for Interpretable Shape Representation}, + author={Jiao, Yining and Zdanski, Carlton and Kimbell, Julia and Prince, Andrew and Worden, Cameron and Kirse, Samuel and Rutter, Christopher and Shields, Benjamin and Dunn, William and Mahmud, Jisan and others}, + journal={arXiv preprint arXiv:2303.09234}, + year={2023} +} + +## Model +Instructions on the way... From 636cec0368a8816b2ec2f31bb2289b7be25846e4 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Wed, 29 Mar 2023 08:11:53 +0000 Subject: [PATCH 02/37] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index da618f7..991ea89 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,8 @@
This is the official implenmentation for, + + **NAISR: A 3D Neural Additive Model for Interpretable Shape Representation.** Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer. https://arxiv.org/abs/2303.09234 From 7abe38d9b477c535decbea2c4028a53ddb4c666a Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Wed, 29 Mar 2023 08:40:46 +0000 Subject: [PATCH 03/37] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 991ea89..56f708d 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,8 @@ This is the official implenmentation for, **NAISR: A 3D Neural Additive Model for Interpretable Shape Representation.** Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer. https://arxiv.org/abs/2303.09234 +Codes to be revised.. + ## Cite this work ``` @article{jiao2023naisr, From dfb6b3ac86d80fb12bb65e7a424e0e85f04544e3 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Wed, 29 Mar 2023 08:42:23 +0000 Subject: [PATCH 04/37] Update README.md --- README.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 56f708d..b2a7a47 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,10 @@ Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samu Codes to be revised.. +## Usage + +Instructions on the way... + ## Cite this work ``` @article{jiao2023naisr, @@ -18,5 +22,4 @@ Codes to be revised.. year={2023} } -## Model -Instructions on the way... + From a25caaaf3b0190a31233b6a221a449c50ee8f026 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Wed, 29 Mar 2023 08:42:43 +0000 Subject: [PATCH 05/37] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index b2a7a47..98b994b 100644 --- a/README.md +++ b/README.md @@ -9,6 +9,8 @@ Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samu Codes to be revised.. +## Installation + ## Usage Instructions on the way... From 739a6196f37a121cbc542502a1728109dd7f4485 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Fri, 22 Mar 2024 13:07:42 -0400 Subject: [PATCH 06/37] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 98b994b..86edacf 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ This is the official implenmentation for, **NAISR: A 3D Neural Additive Model for Interpretable Shape Representation.** Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer. https://arxiv.org/abs/2303.09234 -Codes to be revised.. +An update is coming soon ## Installation From 548e9217f072623e5437a172ed8f08fcfd65ff1c Mon Sep 17 00:00:00 2001 From: Yining Jiao Date: Tue, 23 Apr 2024 12:06:21 -0400 Subject: [PATCH 07/37] Create NAISRicon.svg --- NAISRicon.svg | 1 + 1 file changed, 1 insertion(+) create mode 100644 NAISRicon.svg diff --git a/NAISRicon.svg b/NAISRicon.svg new file mode 100644 index 0000000..959a07d --- /dev/null +++ b/NAISRicon.svg @@ -0,0 +1 @@ + \ No newline at end of file From b91f2067143ce8cc8ec4dfde81674951f41e4def Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 12:12:13 -0400 Subject: [PATCH 08/37] Update README.md --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 86edacf..7f6cea0 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,11 @@ +# NAISR: A 3D Neural Additive Model for Interpretable Shape Representation +Pytorch implementation for our `ICLR 2024 Spotlight` paper
+[NAISR: A 3D Neural Additive Model for Interpretable Shape Representation](https://arxiv.org/abs/2303.09234), ICLR 2024.
+Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer.
+UNC-Chapel Hill +#### [Paper](https://arxiv.org/abs/2303.09234) | [Project Page](https://uncbiag.github.io/NAISR/) | [Demos](https://colab.research.google.com/drive/1OudGynEydIXpAgfA9lvi5d0L86kK-uwg?usp=sharing) + + # NAISR: A 3D Neural Additive Model for Interpretable Shape Representation
From e9f4406ae6c6c68cc39993bc53f76220a6e766e3 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 12:13:08 -0400 Subject: [PATCH 09/37] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 7f6cea0..a3002d2 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# NAISR: A 3D Neural Additive Model for Interpretable Shape Representation +# NAISR: A 3D Neural Additive Model for Interpretable Shape Representation Pytorch implementation for our `ICLR 2024 Spotlight` paper
[NAISR: A 3D Neural Additive Model for Interpretable Shape Representation](https://arxiv.org/abs/2303.09234), ICLR 2024.
Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer.
From 89af98e8a3cf9191c4c1c7a0296de3e4eea56fc5 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 12:36:26 -0400 Subject: [PATCH 10/37] Update README.md --- README.md | 69 ++++++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 56 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index a3002d2..b8d0961 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,78 @@ # NAISR: A 3D Neural Additive Model for Interpretable Shape Representation + Pytorch implementation for our `ICLR 2024 Spotlight` paper
[NAISR: A 3D Neural Additive Model for Interpretable Shape Representation](https://arxiv.org/abs/2303.09234), ICLR 2024.
Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer.
UNC-Chapel Hill + #### [Paper](https://arxiv.org/abs/2303.09234) | [Project Page](https://uncbiag.github.io/NAISR/) | [Demos](https://colab.research.google.com/drive/1OudGynEydIXpAgfA9lvi5d0L86kK-uwg?usp=sharing) -# NAISR: A 3D Neural Additive Model for Interpretable Shape Representation
-This is the official implenmentation for, - +Please cite as: +``` +@inproceedings{ +jiao2024naisr, +title={\texttt{NAISR}: A 3D Neural Additive Model for Interpretable Shape Representation}, +author={Yining Jiao and Carlton Jude ZDANSKI and Julia S Kimbell and Andrew Prince and Cameron P Worden and Samuel Kirse and Christopher Rutter and Benjamin Shields and William Alexander Dunn and Jisan Mahmud and Marc Niethammer}, +booktitle={The Twelfth International Conference on Learning Representations}, +year={2024}, +url={https://openreview.net/forum?id=wg8NPfeMF9} +} +``` -**NAISR: A 3D Neural Additive Model for Interpretable Shape Representation.** -Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer. https://arxiv.org/abs/2303.09234 An update is coming soon + ## Installation +The code is tested with ``python=3.9``, ``torch=2.1.0``, ``torchvision=0.15.2``. +``` +git clone https://github.com/uncbiag/NAISR +cd NAISR +``` +Now, create a new conda environment and install required packages accordingly. +``` +conda create -n naisr python=3.9 +conda activate naisr +pip install -r requirements.txt + +## Getting Started +First, download three model weights: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). These weights will be automatically saved to the ``weights`` folder. +``` +python download.py +``` +``` +Run interactive GUI with the downloaded weights. The ``assets`` contains images for demo. +``` +./run_demo.sh +``` + +We train and test our method on three datasets: DAVIS, COCO+LVIS, and HQSeg-44K. + +| Dataset | Description | Download Link | +|-----------|----------------------------------------------|:------------------------------------:| +|DAVIS | 345 images with one object each (test) | [DAVIS.zip (43 MB)][DAVIS] | +|HQSeg-44K | 44320 images (train); 1537 images (val) | [official site][HQSeg] | +|COCO+LVIS* | 99k images with 1.5M instances (train) | [original LVIS images][LVIS] +
[combined annotations][COCOLVIS_annotation] | + -## Usage Instructions on the way... + + + + ## Cite this work ``` -@article{jiao2023naisr, - title={NAISR: A 3D Neural Additive Model for Interpretable Shape Representation}, - author={Jiao, Yining and Zdanski, Carlton and Kimbell, Julia and Prince, Andrew and Worden, Cameron and Kirse, Samuel and Rutter, Christopher and Shields, Benjamin and Dunn, William and Mahmud, Jisan and others}, - journal={arXiv preprint arXiv:2303.09234}, - year={2023} +@inproceedings{ +jiao2024naisr, +title={\texttt{NAISR}: A 3D Neural Additive Model for Interpretable Shape Representation}, +author={Yining Jiao and Carlton Jude ZDANSKI and Julia S Kimbell and Andrew Prince and Cameron P Worden and Samuel Kirse and Christopher Rutter and Benjamin Shields and William Alexander Dunn and Jisan Mahmud and Marc Niethammer}, +booktitle={The Twelfth International Conference on Learning Representations}, +year={2024}, +url={https://openreview.net/forum?id=wg8NPfeMF9} } - - +``` From 6862fb56649bba9c376b1d1b8db5f50649730f91 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 12:47:14 -0400 Subject: [PATCH 11/37] Update README.md --- README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index b8d0961..bb955de 100644 --- a/README.md +++ b/README.md @@ -49,16 +49,19 @@ Run interactive GUI with the downloaded weights. The ``assets`` contains images ./run_demo.sh ``` -We train and test our method on three datasets: DAVIS, COCO+LVIS, and HQSeg-44K. +We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pedeatric Airway. -| Dataset | Description | Download Link | -|-----------|----------------------------------------------|:------------------------------------:| -|DAVIS | 345 images with one object each (test) | [DAVIS.zip (43 MB)][DAVIS] | -|HQSeg-44K | 44320 images (train); 1537 images (val) | [official site][HQSeg] | -|COCO+LVIS* | 99k images with 1.5M instances (train) | [original LVIS images][LVIS] +
[combined annotations][COCOLVIS_annotation] | +| Dataset | Description | Dataset Link | Model Download Link | +|-----------|----------------------------------------------|:------------------------------------:|:------------------------------------:| +|Starman | simulated 2D Starman shapes | [simulation code)][Starman] | +|ADNI Hippocampus | 1632 hippocampus from ADNI | [official site][ADNI] | +|Pedeatric Airway | 357 pediatric airway shapes | NA | +[ADNI]: https://ida.loni.usc.edu/login.jsp?project=ADNI +[Starman]: + Instructions on the way... From c06fc7b396583477f8d02891e71b9a8810ec7730 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 13:16:31 -0400 Subject: [PATCH 12/37] Update README.md --- README.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index bb955de..b391fe4 100644 --- a/README.md +++ b/README.md @@ -51,16 +51,20 @@ Run interactive GUI with the downloaded weights. The ``assets`` contains images We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pedeatric Airway. -| Dataset | Description | Dataset Link | Model Download Link | +| Dataset | Description | Dataset Link | Model Link | |-----------|----------------------------------------------|:------------------------------------:|:------------------------------------:| -|Starman | simulated 2D Starman shapes | [simulation code)][Starman] | -|ADNI Hippocampus | 1632 hippocampus from ADNI | [official site][ADNI] | -|Pedeatric Airway | 357 pediatric airway shapes | NA | +|Starman | simulated 2D Starman shapes | [simulation code)][StarmanData] | [weights][StarmanModel] | +|ADNI Hippocampus | 1632 hippocampus from ADNI | [official site][ADNIData] | [weights][ADNIModel] | +|Pedeatric Airway | 357 pediatric airway shapes | NA | [weights][AirwayModel] | -[ADNI]: https://ida.loni.usc.edu/login.jsp?project=ADNI -[Starman]: +[ADNIData]: https://ida.loni.usc.edu/login.jsp?project=ADNI +[StarmanData]: + +[ADNIModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_adni.pth +[StarmanModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_starman.pth +[AirwayModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_pediatric_airway.pth Instructions on the way... From fb9761ac4b1a80ebff0d79c338548a0ce6bb0b77 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 13:18:09 -0400 Subject: [PATCH 13/37] Update README.md --- README.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index b391fe4..97df119 100644 --- a/README.md +++ b/README.md @@ -37,13 +37,14 @@ Now, create a new conda environment and install required packages accordingly. conda create -n naisr python=3.9 conda activate naisr pip install -r requirements.txt +``` ## Getting Started First, download three model weights: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). These weights will be automatically saved to the ``weights`` folder. ``` python download.py ``` -``` + Run interactive GUI with the downloaded weights. The ``assets`` contains images for demo. ``` ./run_demo.sh From 5dcb26a56da6fa43813afa7a5001d5eeee3cf6b8 Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 13:43:32 -0400 Subject: [PATCH 14/37] Update README.md --- README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 97df119..4f443cf 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # NAISR: A 3D Neural Additive Model for Interpretable Shape Representation -Pytorch implementation for our `ICLR 2024 Spotlight` paper
-[NAISR: A 3D Neural Additive Model for Interpretable Shape Representation](https://arxiv.org/abs/2303.09234), ICLR 2024.
+Pytorch implementation for our `NAISR` paper
+[NAISR: A 3D Neural Additive Model for Interpretable Shape Representation](https://arxiv.org/abs/2303.09234), ICLR 2024 Spotlight.
Yining Jiao, Carlton Zdanski, Julia Kimbell, Andrew Prince, Cameron Worden, Samuel Kirse, Christopher Rutter, Benjamin Shields, William Dunn, Jisan Mahmud, Marc Niethammer.
UNC-Chapel Hill @@ -39,7 +39,13 @@ conda activate naisr pip install -r requirements.txt ``` +>[!NOTE] +>For the three datasets used in `NAISR` paper, we provided this [Colab demo](https://colab.research.google.com/drive/1OudGynEydIXpAgfA9lvi5d0L86kK-uwg) to investigate the shapes learned with `NAISR`.
+We also provide the instructions on this page to apply `NAISR` to your customized shape analysis questions. + ## Getting Started + +First First, download three model weights: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). These weights will be automatically saved to the ``weights`` folder. ``` python download.py @@ -50,7 +56,9 @@ Run interactive GUI with the downloaded weights. The ``assets`` contains images ./run_demo.sh ``` -We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pedeatric Airway. + + +We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pediatric Airways. | Dataset | Description | Dataset Link | Model Link | |-----------|----------------------------------------------|:------------------------------------:|:------------------------------------:| From da80e3b2770fa4fae3934453f0ee5acd249dc36a Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 13:55:28 -0400 Subject: [PATCH 15/37] Update README.md --- README.md | 51 ++++++++++++++++++++++++++++++++++----------------- 1 file changed, 34 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 4f443cf..8429588 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,10 @@ url={https://openreview.net/forum?id=wg8NPfeMF9} An update is coming soon +>[!NOTE] +>For the three datasets used in `NAISR` paper, we provided this [Colab demo](https://colab.research.google.com/drive/1OudGynEydIXpAgfA9lvi5d0L86kK-uwg) to investigate the shapes learned with `NAISR`.
+We also provide the instructions on this page to apply `NAISR` to your customized shape analysis questions. + ## Installation The code is tested with ``python=3.9``, ``torch=2.1.0``, ``torchvision=0.15.2``. @@ -39,14 +43,31 @@ conda activate naisr pip install -r requirements.txt ``` ->[!NOTE] ->For the three datasets used in `NAISR` paper, we provided this [Colab demo](https://colab.research.google.com/drive/1OudGynEydIXpAgfA9lvi5d0L86kK-uwg) to investigate the shapes learned with `NAISR`.
-We also provide the instructions on this page to apply `NAISR` to your customized shape analysis questions. -## Getting Started +## Data and Model Weights +We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pediatric Airways. + +| Dataset | Description | Dataset Link | Model Link | +|-----------|----------------------------------------------|:------------------------------------:|:------------------------------------:| +|Starman | simulated 2D Starman shapes | [simulation code)][StarmanData] | [weights][StarmanModel] | +|ADNI Hippocampus | 1632 hippocampus from ADNI | [official site][ADNIData] | [weights][ADNIModel] | +|Pedeatric Airway | 357 pediatric airway shapes | NA | [weights][AirwayModel] | + + + +[ADNIData]: https://ida.loni.usc.edu/login.jsp?project=ADNI +[StarmanData]: + +[ADNIModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_adni.pth +[StarmanModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_starman.pth +[AirwayModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_pediatric_airway.pth + -First -First, download three model weights: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). These weights will be automatically saved to the ``weights`` folder. +## Visualization of Existing Shape Space +To get the shape space like the following figures for the three datasets used in the paper, one just need to apply the model weights with the following command, + +First, download the `NAISR model weights`: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). +These weights will be automatically saved to the ``weights`` folder. ``` python download.py ``` @@ -58,22 +79,18 @@ Run interactive GUI with the downloaded weights. The ``assets`` contains images -We train and test our method on three datasets: Starman, ADNI Hippocampus, and Pediatric Airways. -| Dataset | Description | Dataset Link | Model Link | -|-----------|----------------------------------------------|:------------------------------------:|:------------------------------------:| -|Starman | simulated 2D Starman shapes | [simulation code)][StarmanData] | [weights][StarmanModel] | -|ADNI Hippocampus | 1632 hippocampus from ADNI | [official site][ADNIData] | [weights][ADNIModel] | -|Pedeatric Airway | 357 pediatric airway shapes | NA | [weights][AirwayModel] | +## Customize +### Data Preprocessing +### Training + +### Testing + +### Application - Visualization of Your Shape Space -[ADNIData]: https://ida.loni.usc.edu/login.jsp?project=ADNI -[StarmanData]: -[ADNIModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_adni.pth -[StarmanModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_starman.pth -[AirwayModel]: https://github.com/uncbiag/NAISR/releases/download/naisr_weights_v0/naisr_weights_pediatric_airway.pth Instructions on the way... From efb32927958432e2eb8f0b3d8a7cf0b4916deefb Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 14:59:06 -0400 Subject: [PATCH 16/37] Update README.md --- README.md | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 66 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 8429588..12ba801 100644 --- a/README.md +++ b/README.md @@ -74,7 +74,7 @@ python download.py Run interactive GUI with the downloaded weights. The ``assets`` contains images for demo. ``` -./run_demo.sh +python evolution_shapematrix.py -examples/hippocampus/naigsr_0920_base.json ``` @@ -83,6 +83,71 @@ Run interactive GUI with the downloaded weights. The ``assets`` contains images ## Customize ### Data Preprocessing +#### Alignment with Rigid Transformation +The shapes to explore need to be registered with a rigid transformation (translation + rotation). +If paired point clouds are available, we recommend to use ; otherwise, we recommend to use ICP to register the point clouds. +In our case, we use airway landmarks to learn the rigid transformation; and ICP algorithms to register the point clouds of the hippocampi. + +#### SDF Extraction + +### +```json + { + "Description" : [ "This experiment learns a shape representation for starman dataset." ], + "Device":0, + "DataSource": {"train": "/home/jyn/NAISR/examples/starman/2dshape_train_with_temp.csv", + "test": "/home/jyn/NAISR/examples/starman/2dshape_test_with_temp.csv"}, + "Split": null, + "Network": "DeepNAIGSR", + "NumEpochs": 300, + "LoggingRoot": "/playpen-raid/jyn/NAISR/log", + "ExperimentName": "DeepNAIGSR_STARMAN3D_0222_256_base", + + "EpochsTilCkpt": 10, + "StepsTilSummary": 1000, + "UseLBFGS": false, + "DoublePrecision": false, + "CheckpointPath": "", + "CodeLength": 256, + + "AdditionalSnapshots" : [ 50, 100, 200, 300, 400, 500 ], + "LearningRateSchedule" : [ + { + "Type": "Step", + "Initial": 0.00005, + "Interval": 1000, + "Factor": 0.5 + }, + { + "Type": "Step", + "Initial": 0.001, + "Interval": 1000, + "Factor": 0.5 + }], + "SamplesPerScene" : 750, + "BatchSize": 64, + "DataLoaderThreads": 4, + "ClampingDistance": 1, + + "Articulation": true, + "NumAtcParts": 1, + "TrainWithParts": false, + "Class": "starman", + "Attributes": ["cov_1", "cov_2"], + "TemplateAttributes": {"cov_1": 0, "cov_2": 0}, + "Backbone": "siren", + "PosEnc": false, + "InFeatures": 2, + "HiddenFeatures": 256, + "HidenLayers": 6, + "OutFeatures": 1, + "Loss": { + "whether_sdf": true, + "whether_normal_constraint": true, + "whether_inter_constraint": true, + "whether_eikonal": true, + "whether_code_regularization": true} +``` ### Training ### Testing From ae28d489320b9d8d80ba5605e8601c2e39d1b6ba Mon Sep 17 00:00:00 2001 From: Yining Jiao <44992829+jiaoyining@users.noreply.github.com> Date: Tue, 23 Apr 2024 15:00:17 -0400 Subject: [PATCH 17/37] Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 12ba801..8ea1aed 100644 --- a/README.md +++ b/README.md @@ -66,8 +66,7 @@ We train and test our method on three datasets: Starman, ADNI Hippocampus, and P ## Visualization of Existing Shape Space To get the shape space like the following figures for the three datasets used in the paper, one just need to apply the model weights with the following command, -First, download the `NAISR model weights`: vitb_sax1 (408M), vitb_sax2 (435M), and vitb_sax2_ft (435M). -These weights will be automatically saved to the ``weights`` folder. +First, download the `NAISR model weights`. These weights will be automatically saved to the ``checkpoints`` folder. ``` python download.py ``` From b3e68d882970923882156297944d0c4f28c8200d Mon Sep 17 00:00:00 2001 From: Yining Jiao Date: Wed, 24 Apr 2024 10:42:08 -0400 Subject: [PATCH 18/37] Create workspace.xml --- .idea/workspace.xml | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 .idea/workspace.xml diff --git a/.idea/workspace.xml b/.idea/workspace.xml new file mode 100644 index 0000000..02cb1fa --- /dev/null +++ b/.idea/workspace.xml @@ -0,0 +1,24 @@ + + + + + + + + + + + + + + \ No newline at end of file From e0b6c73f8a529a373aa5ca0b320cbc0300d5333a Mon Sep 17 00:00:00 2001 From: Yining Jiao Date: Wed, 24 Apr 2024 10:53:26 -0400 Subject: [PATCH 19/37] a --- visualizer.py | 1 - 1 file changed, 1 deletion(-) diff --git a/visualizer.py b/visualizer.py index b403183..521ef80 100755 --- a/visualizer.py +++ b/visualizer.py @@ -16,7 +16,6 @@ from naisr import diff_operators import pickle -import pymeshfix as pmf import pandas as pd From 10366ab6f1df48eac463760ab0e7710d1b25ab78 Mon Sep 17 00:00:00 2001 From: Yining Jiao Date: Wed, 24 Apr 2024 11:13:58 -0400 Subject: [PATCH 20/37] Update workspace.xml --- .idea/workspace.xml | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/.idea/workspace.xml b/.idea/workspace.xml index 02cb1fa..a6f839d 100644 --- a/.idea/workspace.xml +++ b/.idea/workspace.xml @@ -4,7 +4,9 @@