subcortex-visualization 0.1.11__tar.gz → 0.1.12__tar.gz

{subcortex_visualization-0.1.11/subcortex_visualization.egg-info → subcortex_visualization-0.1.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: subcortex_visualization
-Version: 0.1.11
+Version: 0.1.12
 Summary: A package to visualize subcortical brain data in two dimensions.
 Author: Annie G. Bryant
 Author-email: "Annie G. Bryant" <anniegbryant@gmail.com>
@@ -25,27 +25,34 @@ Dynamic: license-file
 
 # Subcortical data visualization in 2D
 
+This python package currently includes the following six subcortical atlases for data visualization in two-dimensional vector graphics:
+
+<img src="images/all_atlas_showcase.png" width="100%">
+
+More information about these atlases, including the process of rendering the surfaces and tracing the outlines for each, can be found in the [`atlas_info/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/atlas_info) directory.
+
+
 ## 🙋‍♀️ Motivation
 
 This Python package was created to generate two-dimensional subcortex images in the style of the popular [`ggseg` package](https://github.com/ggseg/ggseg) in R.
-We based our vector graphic outlines on the three-dimensional subcortical meshes provided as part of the [ENIGMA toolbox](https://github.com/MICA-MNI/ENIGMA); more information on this powerful resource can be found in [Larivière, S., et al. *Nat Methods* (2021)](https://doi.org/10.1038/s41592-021-01186-4). 
+We based our vector graphic outlines on the three-dimensional subcortical meshes either (1) provided as part of the [ENIGMA toolbox](https://github.com/MICA-MNI/ENIGMA) for the aseg atlas or (2) meshes generated in-house using rendering software from [Chris Rorden's lab](https://github.com/neurolabusc) (either [nii2mesh](https://github.com/neurolabusc/nii2mesh) or [Surf Ice](https://github.com/neurolabusc/surf-ice); check out [`custom_segmentation_pipeline/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/custom_segmentation_pipeline) for more information).
 
-The below graphic summarizes the transformation from 3D volumetric meshes to 2D surfaces, starting from the ENIGMA toolbox ('aseg' atlas, left) or a custom-rendered mesh from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master) generated by Ye Tian ('S1' granularity level, right).
+The below graphic summarizes the transformation from 3D volumetric meshes to 2D surfaces, starting from the ENIGMA toolbox ('aseg' atlas, left) or a custom-rendered mesh from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master) as published in [Tian et al. (2020)]()https://www.nature.com/articles/s41593-020-00711-6 -- ('S1' granularity level, right).
 
-<img src="images/aseg_and_Tian_S1_3D_to_2D_schematic.png" width="90%">
+<img src="images/aseg_and_Melbourne_S1_3D_to_2D_schematic.png" width="90%">
 
 
 While `ggseg` offers subcortical plotting with the `aseg` atlas, it is [not currently possible](https://github.com/ggseg/ggseg/issues/104) to show data from all seven subcortical regions (accumbens, amygdala, caudate, hippocampus, pallidum, putamen, thalamus) in the same figure.
-There is currently no other software available to visualize the Melbourne Subcortex Atlas segmentation in 2D with real data, hence development here (currently detail levels S1 and S2 are available in this package, as described below).
+Moreover, there is currently no other software available to visualize any of the other above subcortical/thalamic atlases in 2D with real data, hence development here.
 
 
 ## 🖥️ Installation
 
 The package can be installed from GitHub in two ways.
-First, you can install directly with pip:
+First, you can install directly with pip from the [PyPI repository](https://pypi.org/project/subcortex-visualization/):
 
 ```bash
-pip install git+https://github.com/anniegbryant/subcortex_visualization.git#egg=subcortex_visualization
+pip install subcortex-visualization
 ```
 
 If you would like to make your own modifications before installing, you can also clone this repository first and then install from your local version:
@@ -124,29 +131,23 @@ plot_subcortical_data(subcortex_data=example_continuous_data, atlas='aseg',
 <img src="images/example_aseg_subcortex_normdist.png" width="80%">
 
 
-### 🧠 Usage with different levels of granularity in the Melbourne Subcortex Atlas
-
-We currently offer two levels of detail from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master): S1 (total of 16 regions) and S2 (total of 32 regions).
-Here's a schematic overview of the conversion from 3D to 2D for these two segmentations:
-
-<img src="images/Tian_S1_and_S2_3D_to_2D_schematic.png" width="90%">
-
 ## 💡 Want to generate your own mesh and/or parcellation?
 
-This package provides three popular subcortical atlases as a starting point: the `aseg` segmentation into seven regions per hemisphere from the FreeSurfer `recon-all` pipeline, and two segmentation levels (`S1` and `S2`) from Ye Tian's segmentations as part of the Melbourne Subcortical Atlas.
+This package provides six subcortical atlases as a starting point.
 The workflow can readily be extended to your favorite segmentation atlas, though! 
 We have a dedicated folder for a custom segmentation pipeline that will walk you through the two key steps:  
-1. Rendering a series of triangulated surface meshes from your parcellation atlas (starting from a .nii.gz volume), using the [`nii2mesh`](https://github.com/neurolabusc/nii2mesh) software developed by Chris Rorden; and 
+1. Rendering a series of triangulated surface meshes from your parcellation atlas (starting from a .nii.gz volume), using either the [`nii2mesh`](https://github.com/neurolabusc/nii2mesh) or [`surfice_atlas`](https://github.com/neurolabusc/surfice_atlas) software, both developed by Chris Rorden; and 
 2. Tracing the outline of each region in the rendered mesh in vector graphic editing software (we use Inkscape in the tutorial as a powerful and free option), to yield a two-dimensional image of your atlas in scalable vector graphic (.svg) format.
 
 Check out the walkthrough in the [`custom_segmentation_pipeline/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/custom_segmentation_pipeline) folder for more information on how to render your own volumetric segmentation with an interactive mesh and convert to a two-dimensional vector graphic that can be integrated with this package.
 
 ## 🙏 Acknowledgments
 
-Thank you very much to [Ye Tian](https://github.com/yetianmed), [Chris Rorden](https://github.com/rordenlab), and [Sid Chopra](https://github.com/sidchop) for their suggestions and continued development of open tools for neuroimaging visualization that enabled development of this project!
+Thank you very much to [Chris Rorden](https://github.com/rordenlab), [Ye Tian](https://github.com/yetianmed), and [Sid Chopra](https://github.com/sidchop) for their suggestions and continued development of open tools for neuroimaging visualization that enabled development of this project!
 
 ## ❓📧 Questions, comments, or suggestions always welcome!
 
 Please feel free to ask questions, report bugs, or share suggestions by creating an issue or by emailing me (Annie) at ([anniegbryant@gmail.com](mailto:anniegbryant@gmail.com)) 😊
 
 As an [open-source tool](https://opensource.guide/how-to-contribute/), pull requests are always welcome from the community, too.
+If you create your own custom vector graphic for your segmentation atlas of choice, feel free to create a pull request to incorporate and be acknowledged.

{subcortex_visualization-0.1.11 → subcortex_visualization-0.1.12}/README.md

@@ -1,26 +1,33 @@
 # Subcortical data visualization in 2D
 
+This python package currently includes the following six subcortical atlases for data visualization in two-dimensional vector graphics:
+
+<img src="images/all_atlas_showcase.png" width="100%">
+
+More information about these atlases, including the process of rendering the surfaces and tracing the outlines for each, can be found in the [`atlas_info/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/atlas_info) directory.
+
+
 ## 🙋‍♀️ Motivation
 
 This Python package was created to generate two-dimensional subcortex images in the style of the popular [`ggseg` package](https://github.com/ggseg/ggseg) in R.
-We based our vector graphic outlines on the three-dimensional subcortical meshes provided as part of the [ENIGMA toolbox](https://github.com/MICA-MNI/ENIGMA); more information on this powerful resource can be found in [Larivière, S., et al. *Nat Methods* (2021)](https://doi.org/10.1038/s41592-021-01186-4). 
+We based our vector graphic outlines on the three-dimensional subcortical meshes either (1) provided as part of the [ENIGMA toolbox](https://github.com/MICA-MNI/ENIGMA) for the aseg atlas or (2) meshes generated in-house using rendering software from [Chris Rorden's lab](https://github.com/neurolabusc) (either [nii2mesh](https://github.com/neurolabusc/nii2mesh) or [Surf Ice](https://github.com/neurolabusc/surf-ice); check out [`custom_segmentation_pipeline/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/custom_segmentation_pipeline) for more information).
 
-The below graphic summarizes the transformation from 3D volumetric meshes to 2D surfaces, starting from the ENIGMA toolbox ('aseg' atlas, left) or a custom-rendered mesh from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master) generated by Ye Tian ('S1' granularity level, right).
+The below graphic summarizes the transformation from 3D volumetric meshes to 2D surfaces, starting from the ENIGMA toolbox ('aseg' atlas, left) or a custom-rendered mesh from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master) as published in [Tian et al. (2020)]()https://www.nature.com/articles/s41593-020-00711-6 -- ('S1' granularity level, right).
 
-<img src="images/aseg_and_Tian_S1_3D_to_2D_schematic.png" width="90%">
+<img src="images/aseg_and_Melbourne_S1_3D_to_2D_schematic.png" width="90%">
 
 
 While `ggseg` offers subcortical plotting with the `aseg` atlas, it is [not currently possible](https://github.com/ggseg/ggseg/issues/104) to show data from all seven subcortical regions (accumbens, amygdala, caudate, hippocampus, pallidum, putamen, thalamus) in the same figure.
-There is currently no other software available to visualize the Melbourne Subcortex Atlas segmentation in 2D with real data, hence development here (currently detail levels S1 and S2 are available in this package, as described below).
+Moreover, there is currently no other software available to visualize any of the other above subcortical/thalamic atlases in 2D with real data, hence development here.
 
 
 ## 🖥️ Installation
 
 The package can be installed from GitHub in two ways.
-First, you can install directly with pip:
+First, you can install directly with pip from the [PyPI repository](https://pypi.org/project/subcortex-visualization/):
 
 ```bash
-pip install git+https://github.com/anniegbryant/subcortex_visualization.git#egg=subcortex_visualization
+pip install subcortex-visualization
 ```
 
 If you would like to make your own modifications before installing, you can also clone this repository first and then install from your local version:
@@ -99,29 +106,23 @@ plot_subcortical_data(subcortex_data=example_continuous_data, atlas='aseg',
 <img src="images/example_aseg_subcortex_normdist.png" width="80%">
 
 
-### 🧠 Usage with different levels of granularity in the Melbourne Subcortex Atlas
-
-We currently offer two levels of detail from the [Melbourne Subcortex Atlas](https://github.com/yetianmed/subcortex/tree/master): S1 (total of 16 regions) and S2 (total of 32 regions).
-Here's a schematic overview of the conversion from 3D to 2D for these two segmentations:
-
-<img src="images/Tian_S1_and_S2_3D_to_2D_schematic.png" width="90%">
-
 ## 💡 Want to generate your own mesh and/or parcellation?
 
-This package provides three popular subcortical atlases as a starting point: the `aseg` segmentation into seven regions per hemisphere from the FreeSurfer `recon-all` pipeline, and two segmentation levels (`S1` and `S2`) from Ye Tian's segmentations as part of the Melbourne Subcortical Atlas.
+This package provides six subcortical atlases as a starting point.
 The workflow can readily be extended to your favorite segmentation atlas, though! 
 We have a dedicated folder for a custom segmentation pipeline that will walk you through the two key steps:  
-1. Rendering a series of triangulated surface meshes from your parcellation atlas (starting from a .nii.gz volume), using the [`nii2mesh`](https://github.com/neurolabusc/nii2mesh) software developed by Chris Rorden; and 
+1. Rendering a series of triangulated surface meshes from your parcellation atlas (starting from a .nii.gz volume), using either the [`nii2mesh`](https://github.com/neurolabusc/nii2mesh) or [`surfice_atlas`](https://github.com/neurolabusc/surfice_atlas) software, both developed by Chris Rorden; and 
 2. Tracing the outline of each region in the rendered mesh in vector graphic editing software (we use Inkscape in the tutorial as a powerful and free option), to yield a two-dimensional image of your atlas in scalable vector graphic (.svg) format.
 
 Check out the walkthrough in the [`custom_segmentation_pipeline/`](https://github.com/anniegbryant/subcortex_visualization/tree/main/custom_segmentation_pipeline) folder for more information on how to render your own volumetric segmentation with an interactive mesh and convert to a two-dimensional vector graphic that can be integrated with this package.
 
 ## 🙏 Acknowledgments
 
-Thank you very much to [Ye Tian](https://github.com/yetianmed), [Chris Rorden](https://github.com/rordenlab), and [Sid Chopra](https://github.com/sidchop) for their suggestions and continued development of open tools for neuroimaging visualization that enabled development of this project!
+Thank you very much to [Chris Rorden](https://github.com/rordenlab), [Ye Tian](https://github.com/yetianmed), and [Sid Chopra](https://github.com/sidchop) for their suggestions and continued development of open tools for neuroimaging visualization that enabled development of this project!
 
 ## ❓📧 Questions, comments, or suggestions always welcome!
 
 Please feel free to ask questions, report bugs, or share suggestions by creating an issue or by emailing me (Annie) at ([anniegbryant@gmail.com](mailto:anniegbryant@gmail.com)) 😊
 
-As an [open-source tool](https://opensource.guide/how-to-contribute/), pull requests are always welcome from the community, too.
+As an [open-source tool](https://opensource.guide/how-to-contribute/), pull requests are always welcome from the community, too.
+If you create your own custom vector graphic for your segmentation atlas of choice, feel free to create a pull request to incorporate and be acknowledged.

{subcortex_visualization-0.1.11 → subcortex_visualization-0.1.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "subcortex_visualization"
-version = "0.1.11"
+version = "0.1.12"
 authors = [
   { name="Annie G. Bryant", email="anniegbryant@gmail.com" },
 ]

{subcortex_visualization-0.1.11 → subcortex_visualization-0.1.12}/setup.py

@@ -10,7 +10,7 @@ install_requires = [
 
 setup(
     name='subcortex_visualization',
-    version='0.1.11',
+    version='0.1.12',
     description='Visualize subcortical brain data from SVG templates',
     author='Annie G. Bryant',
     packages=find_packages(),