Skip to main content

a generalist algorithm for anatomical segmentation

Project description

cellpose-napari cellpose

Documentation Status tests codecov PyPI version PyPI - Downloads Python version License Contributors website GitHub stars GitHub forks

a napari plugin for anatomical segmentation of general cellular images


This napari plugin was generated with Cookiecutter using with @napari's cookiecutter-napari-plugin template.

The plugin code was written by Carsen Stringer, and the cellpose code was written by Carsen Stringer and Marius Pachitariu. To learn about Cellpose, read the paper or watch this talk.

For support with the plugin, please open an issue. For support with cellpose, please open an issue on the cellpose repo.

If you use this plugin please cite the paper: ::

  @article{stringer2021cellpose,
  title={Cellpose: a generalist algorithm for cellular segmentation},
  author={Stringer, Carsen and Wang, Tim and Michaelos, Michalis and Pachitariu, Marius},
  journal={Nature Methods},
  volume={18},
  number={1},
  pages={100--106},
  year={2021},
  publisher={Nature Publishing Group}
  }

cellpose-napari_plugin

Installation

Install an Anaconda distribution of Python -- Choose Python 3 and your operating system. Note you might need to use an anaconda prompt if you did not add anaconda to the path.

Install napari with pip: pip install napari[all]. Then install cellpose-napari via [pip]:

pip install cellpose-napari

Or install the plugin inside napari in the plugin window.

If install fails in your base environment, create a new environment:

  1. Download the environment.yml file from the repository. You can do this by cloning the repository, or copy-pasting the text from the file into a text document on your local computer.
  2. Open an anaconda prompt / command prompt with conda for python 3 in the path
  3. Change directories to where the environment.yml is and run conda env create -f environment.yml
  4. To activate this new environment, run conda activate cellpose-napari
  5. You should see (cellpose-napari) on the left side of the terminal line.

If you have issues with cellpose installation, see the cellpose docs for more details, and then if the suggestions fail, open an issue.

Upgrading software

You can upgrade the plugin with

pip install cellpose-napari --upgrade

and you can upgrade cellpose with

pip install cellpose --upgrade

GPU version (CUDA) on Windows or Linux

If you plan on running many images, you may want to install a GPU version of torch (if it isn't already installed).

Before installing the GPU version, remove the CPU version:

pip uninstall torch

Follow the instructions here to determine what version to install. The Anaconda install is recommended along with CUDA version 10.2. For instance this command will install the 10.2 version on Linux and Windows (note the torchvision and torchaudio commands are removed because cellpose doesn't require them):

conda install pytorch cudatoolkit=10.2 -c pytorch

When upgrading GPU Cellpose in the future, you will want to ignore dependencies (to ensure that the pip version of torch does not install):

pip install --no-deps cellpose --upgrade

Installation of github version

Follow steps from above to install the dependencies. In the github repository, run pip install -e . and the github version will be installed. If you want to go back to the pip version of cellpose-napari, then say pip install cellpose-napari.

Running the software

Open napari with the cellpose-napari dock widget open

napari -w cellpose-napari

There is sample data in the File menu, or get started with your own images!

Detailed usage documentation.

Contributing

Contributions are very welcome. Tests are run with pytest.

License

Distributed under the terms of the BSD-3 license, "cellpose-napari" is free and open source software.

Dependencies

cellpose-napari relies on the following excellent packages (which are automatically installed with conda/pip if missing):

cellpose relies on the following excellent packages (which are automatically installed with conda/pip if missing):

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cellpose-napari-0.1.4.tar.gz (7.3 MB view details)

Uploaded Source

Built Distribution

cellpose_napari-0.1.4-py3-none-any.whl (11.6 kB view details)

Uploaded Python 3

File details

Details for the file cellpose-napari-0.1.4.tar.gz.

File metadata

  • Download URL: cellpose-napari-0.1.4.tar.gz
  • Upload date:
  • Size: 7.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for cellpose-napari-0.1.4.tar.gz
Algorithm Hash digest
SHA256 ef87dfb9e1dcbe13bb91dc6533f017468497a5ba530545bd5c44a5a4df7c8cca
MD5 d58c7e6ea3ac60308975690f476c0c07
BLAKE2b-256 c59bcbcf959faf9b8de481da1028d5427ec042f0f402dd00da5cb473d1c2e9e0

See more details on using hashes here.

File details

Details for the file cellpose_napari-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: cellpose_napari-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 11.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.10.0

File hashes

Hashes for cellpose_napari-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a79dcc58acb092b9360cbddde2596f06991cee14a2009cd765574eb5e1e8d0c0
MD5 75cbe89ee1f80f32aade0c90cc38c44f
BLAKE2b-256 67aa03c29acf0e81313339b910e1b05d6a523660d1c41fc4bc6a9def853b15c4

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page