# VollSeg
3D segmentation tool for irregular shaped cells
![Segmentation](https://github.com/kapoorlab/VollSeg/blob/main/images/Seg_compare-big.png)
[![Build Status](https://travis-ci.com/kapoorlab/vollseg.svg?branch=master)](https://travis-ci.com/github/kapoorlab/vollseg)
[![PyPI version](https://img.shields.io/pypi/v/vollseg.svg?maxAge=2591000)](https://pypi.org/project/vollseg/)
## Installation
This package can be installed by
`pip install --user vollseg`
If you are building this from the source, clone the repository and install via
```bash
git clone https://github.com/kapoorlab/vollseg/
cd vollseg
pip install --user -e .
# or, to install in editable mode AND grab all of the developer tools
# (this is required if you want to contribute code back to NapaTrackMater)
pip install --user -r requirements.txt
```
### Pipenv install
Pipenv allows you to install dependencies in a virtual environment.
```bash
# install pipenv if you don't already have it installed
pip install --user pipenv
# clone the repository and sync the dependencies
git clone https://github.com/kapoorlab/vollseg/
cd vollseg
pipenv sync
# make the current package available
pipenv run python setup.py develop
# you can run the example notebooks by starting the jupyter notebook inside the virtual env
pipenv run jupyter notebook
```
Access the `example` folder and run the cells.
## Algorithm
![Algorithm](https://github.com/kapoorlab/VollSeg/blob/main/images/Seg_pipe-git.png)
Schematic representation showing the segmentation approach used in VollSeg. First, we input the raw fluorescent image in 3D (A) and preprocess it to remove noise. Next, we obtain the star convex approximation to the cells using Stardist (B) and the U-Net prediction labelled via connected components (C). We then obtain seeds from the centroids of labelled image in B, for each labelled region of C in order to create bounding boxes and centroids. If there is no seed from B in the bounding box region from U-Net, we add the new centroid (in yellow) to the seed pool (D). Finally, we do a marker controlled watershed in 3D using skimage implementation on the probability map shown in (E) to obtain final cell segmentation result shown in (F). All images are displayed in Napari viewer with 3D display view.
## Example
To try the provided notebooks we provide an example dataset of MDA231 human breast carcinoma cells infected with a pMSCV vector including the GFP sequence, embedded in a collagen matrix from Dr. R. Kamm. Dept. of Biological Engineering, Massachusetts Institute of Technology, Cambridge MA (USA)[tracking challenge](http://celltrackingchallenge.net/3d-datasets/), download the hyperstacks of the Raw, instance and semantic segmentation masks from [here](https://drive.google.com/drive/folders/1ze8KsrFI0-UTrsMnAPomiyf4sN8aCm__?usp=sharing). Pretrained model weights for denoising done via noise to void, segmentation done via U-Net and Stardist are also in the directory. For training the networks use this notebook in [Colab](https://github.com/kapoorlab/VollSeg/blob/main/examples/Train/ColabTrainModel.ipynb). To train a denoising model using noise to void use this [notebook](https://github.com/kapoorlab/VollSeg/blob/main/examples/Train/ColabN2VTrain.ipynb)
## Docker
A Docker image can be used to run the code in a container. Once inside the project's directory, build the image with:
~~~bash
docker build -t voll .
~~~
Now to run the `track` command:
~~~bash
# show help
docker run --rm -it voll
~~~
## Requirements
- Python 3.7 and above.
## License
Under MIT license. See [LICENSE](LICENSE).
## Authors
- Varun Kapoor <randomaccessiblekapoor@gmail.com>
- Claudia Carabaña
- Mari Tolonen
PyPI 官网下载 | vollseg-1.9.1.tar.gz
版权申诉
79 浏览量
2022-01-17
08:29:10
上传
评论
收藏 27KB GZ 举报
挣扎的蓝藻
- 粉丝: 13w+
- 资源: 15万+
最新资源
- 毕设项目:通用作业批改管理系统(含源代码+毕设文档+ASP.NET)
- 数据库管理工具:dbeaver-ce-24.0.5-x86-64-setup.exe
- 数据库管理工具:dbeaver-ce-24.0.5-stable.x86-64.rpm
- 数据库管理工具:dbeaver-ce-24.0.5-macos-x86-64.dmg
- 数据库管理工具:dbeaver-ce-24.0.5-macos-aarch64.dmg
- MPU6050基于STM32 HAL的驱动程序
- 基于 stm32“蓝色药丸”的简单 cdc 到 gpio 控制器
- 编程实战:基于ASP.NET技术的图书馆管理信息系统(含源代码+文档+任务书)
- 织梦网站标题和内容body文字自动转unicode码插件
- 数据库管理工具:dbeaver-ce-24.0.4-x86-64-setup.exe
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈