Metadata-Version: 2.4
Name: heifetslab-unravel
Version: 1.0.0b10
Summary: UNRAVEL: UN-biased high-Resolution Analysis and Validation of Ensembles using Light sheet images
Author-email: Daniel Ryskamp Rijsketic <danrijs@stanford.edu>, Austen Brooks Casey <abcasey@stanford.edu>, Boris Dov Heifets <bheifets@stanford.edu>
Maintainer-email: Daniel Ryskamp Rijsketic <danrijs@stanford.edu>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/b-heifets/UNRAVEL
Project-URL: Documentation, https://b-heifets.github.io/UNRAVEL/
Keywords: neuroscience,image analysis,light sheet microscopy,brain mapping,data analysis,voxel-wise analysis,cell density quantification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
Description-Content-Type: text/markdown
Requires-Dist: aicspylibczi<4.0.0,>=3.1.2
Requires-Dist: antspyx<1.0.0,>=0.4.2
Requires-Dist: connected_components_3d<4.0.0,>=3.12.3
Requires-Dist: czifile<2020.0.0,>=2019.7.2
Requires-Dist: dask<2024.0.0,>=2023.4.1
Requires-Dist: fslpy<4.0.0,>=3.18.2
Requires-Dist: h5py<4.0.0,>=3.8.0
Requires-Dist: lxml<5.0.0,>=4.9.3
Requires-Dist: matplotlib<4.0.0,>=3.7.1
Requires-Dist: nibabel<6.0.0,>=5.2.1
Requires-Dist: numpy==1.24.4
Requires-Dist: opencv_python<5.0.0,>=4.7.0.72
Requires-Dist: openpyxl<4.0.0,>=3.1.2
Requires-Dist: pandas<2.0.0,>=1.5.3
Requires-Dist: rich<14.0.0,>=13.7.1
Requires-Dist: rich_argparse<2.0.0,>=1.4.0
Requires-Dist: scipy<2.0.0,>=1.13.1
Requires-Dist: seaborn<1.0.0,>=0.13.2
Requires-Dist: setuptools>=77.0.0
Requires-Dist: statsmodels<1.0.0,>=0.14.0
Requires-Dist: termcolor<3.0.0,>=2.4.0
Requires-Dist: tifffile<2024.0.0,>=2023.8.30
Requires-Dist: zarr<3.0.0,>=2.14.2
Provides-Extra: dev
Requires-Dist: myst-parser; extra == "dev"
Requires-Dist: python-cfonts; extra == "dev"
Requires-Dist: pydata_sphinx_theme; extra == "dev"
Requires-Dist: sphinx; extra == "dev"
Requires-Dist: sphinx-autobuild; extra == "dev"
Requires-Dist: sphinx-togglebutton; extra == "dev"
Requires-Dist: sphinx-design; extra == "dev"
Requires-Dist: sphinxcontrib-mermaid; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"

[![UNRAVEL Logo](https://raw.githubusercontent.com/b-heifets/UNRAVEL/main/unravel/docs/_static/UNRAVEL_logo.png)](https://b-heifets.github.io/UNRAVEL/)

### UN-biased high-Resolution Analysis and Validation of Ensembles using Light sheet images
* UNRAVEL is a [Python](https://www.python.org/) package & command line tool for the analysis of brain-wide imaging data, automating: 
    * Registration of brain-wide images to a common atlas space
    * Quantification of cell/label densities across the brain
    * Voxel-wise analysis of fluorescent signals and cluster correction
    * Validation of hot/cold spots via cell/label density quantification at cellular resolution
* UNRAVEL can be installed via [PyPI](https://pypi.org/project/heifetslab-unravel/): ``pip install heifetslab-unravel``
* [Initial UNRAVEL publication](https://www.nature.com/articles/s41386-023-01613-4)
* UNRAVEL was developed by [the Heifets lab](https://heifetslab.stanford.edu/) and [TensorAnalytics](https://sites.google.com/view/tensoranalytics/home?authuser=0)
* Additional support/guidance was provided by: 
    * [The Shamloo lab](https://med.stanford.edu/neurosurgery/research/shamloo.html)
    * [The Malenka lab](https://profiles.stanford.edu/robert-malenka)
    * [The Stanford-based P50 center funded by NIDA](https://med.stanford.edu/nidap50.html)

---

### *Please see [UNRAVEL documentation](https://b-heifets.github.io/UNRAVEL/) for guides on [installation](https://b-heifets.github.io/UNRAVEL/installation.html) and [analysis](https://b-heifets.github.io/UNRAVEL/guide.html)*

---

[<img src="https://raw.githubusercontent.com/b-heifets/UNRAVEL/main/unravel/docs/_static/Heifets_lab_logo.png" alt="Heifets Lab" width="500">](https://heifetslab.stanford.edu/)




### UNRAVEL visualizer
* [UNRAVEL visualizer](https://heifetslab-unravel.org/) is a web-based tool for visualizing and exploring 3D maps output from UNRAVEL
* [UNRAVEL visualizer GitHub repo](https://github.com/MetaCell/cfos-visualizer/)
* Developed by [MetaCell](https://metacell.us/) with support from the [Heifets lab](https://heifetslab.stanford.edu/)

[![UNRAVEL visualizer](https://raw.githubusercontent.com/b-heifets/UNRAVEL/main/unravel/docs/_static/UNRAVEL_visualizer.png)](https://heifetslab-unravel.org/)

### Contact us
If you have any questions, suggestions, or are interested in collaborations and contributions, please reach out to us. 

### Developers
* **Daniel Ryskamp Rijsketic** (developer and maintainer) - [danrijs@stanford.edu](mailto:danrijs@stanford.edu)
* **Austen Casey** (developer) - [abcasey@stanford.edu](mailto:abcasey@stanford.edu)
* **MetaCell** (UNRAVEL visualizer developers) - [info@metacell.us](mailto:info@metacell.us)
* **Boris Heifets** (PI) - [bheifets@stanford.edu](mailto:bheifets@stanford.edu)

### Additional contributions from
* **Mehrdad Shamloo** (PI) - [shamloo@stanford.edu](mailto:shamloo@stanford.edu)
* **Daniel Barbosa** (early contributer and guidance) - [Dbarbosa@pennmedicine.upenn.edu](mailto:Dbarbosa@pennmedicine.upenn.edu)
* **Wesley Zhao** (guidance) - [weszhao@stanford.edu](mailto:weszhao@stanford.edu)
* **Nick Gregory** (guidance) - [ngregory@stanford.edu](mailto:ngregory@stanford.edu)

### Main dependencies
* [Allen Institute for Brain Science](https://portal.brain-map.org/)
* [FSL](https://fsl.fmrib.ox.ac.uk/fsl/fslwiki)
* [fslpy](https://git.fmrib.ox.ac.uk/fsl/fslpy)
* [ANTsPy](https://github.com/ANTsX/ANTsPy)
* [Ilastik](https://www.ilastik.org/)
* [nibabel](https://nipy.org/nibabel/)
* [numpy](https://numpy.org/)
* [scipy](https://www.scipy.org/)
* [pandas](https://pandas.pydata.org/)
* [cc3d](https://pypi.org/project/connected-components-3d/)
* Registration and warping workflows were inspired by [MIRACL](https://miracl.readthedocs.io/en/latest/)
* We warped this [LSFM/iDISCO+ average template brain](https://pubmed.ncbi.nlm.nih.gov/33063286/) to Allen brain atlas space (CCFv3) and refined alignment. 

### Support is welcome for
* Analysis of new datasets
* Development of new features
* Maintenance of the codebase
* Guidance of new users
