Skip to content
forked from stardist/stardist

Code for MICCAI 2018 paper "Cell Detection with Star-convex Polygons" (Uwe Schmidt, Martin Weigert, Coleman Broaddus, and Gene Myers)

License

Notifications You must be signed in to change notification settings

Gvaihir/stardist

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StarDist

The code in this repository implements object detection with star-convex polygons as described in the paper:

Uwe Schmidt, Martin Weigert, Coleman Broaddus, and Gene Myers.
Cell Detection with Star-convex Polygons.
International Conference on Medical Image Computing and Computer-Assisted Intervention (MICCAI), Granada, Spain, September 2018.

Please cite the paper if you are using this code in your research.

@inproceedings{schmidt2018,
  author    = {Uwe Schmidt and Martin Weigert and Coleman Broaddus and Gene Myers},
  title     = {Cell Detection with Star-Convex Polygons},
  booktitle = {Medical Image Computing and Computer Assisted Intervention - {MICCAI} 
  2018 - 21st International Conference, Granada, Spain, September 16-20, 2018, Proceedings, Part {II}},
  pages     = {265--273},
  year      = {2018},
  doi       = {10.1007/978-3-030-00934-2\_30},
}

Installation

This package requires Python 3.5 (or newer) and can be installed with pip:

pip install stardist

Notes

  • Depending on your Python installation, you may need to use pip3 instead of pip.
  • Since this package relies on a C++ extension, you could run into compilation problems (see Troubleshooting below). We currently do not provide pre-compiled binaries.
  • StarDist uses the deep learning library Keras, which requires a suitable backend (we only tested TensorFlow).

Usage

We provide several Jupyter notebooks that illustrate how this package can be used.

Troubleshooting

Installation requires Python 3.5 (or newer) and a working C++ compiler. We have only tested GCC (macOS, Linux), Clang (macOS), and Visual Studio (Windows 10). Please open an issue if you have problems that are not resolved by the information below.

If available, the C++ code will make use of OpenMP to exploit multiple CPU cores for substantially reduced runtime on modern CPUs. This can be important to prevent the function star_dist (utils.py) from slowing down model training.

macOS

Although Apple provides the Clang C/C++ compiler via Xcode, it does not come with OpenMP support. Hence, we suggest to install the OpenMP-enabled GCC compiler, e.g. via Homebrew with brew install gcc. After that, you can install the package like this (adjust names/paths as necessary):

CC=/usr/local/bin/gcc-8 CXX=/usr/local/bin/g++-8 pip install stardist

Windows

Please install the Build Tools for Visual Studio 2017 from Microsoft to compile extensions for Python 3.5 and 3.6 (see this for further information). During installation, make sure to select the Visual C++ build tools. Note that the compiler comes with OpenMP support.

About

Code for MICCAI 2018 paper "Cell Detection with Star-convex Polygons" (Uwe Schmidt, Martin Weigert, Coleman Broaddus, and Gene Myers)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 81.7%
  • Python 18.3%