a phenotyping pipeline for python
Project description
Project status | Windows build | Linux build | OSX build | Coverage | Style |
---|---|---|---|---|---|
none |
Author: Moritz Lürig
License: LGPL
What is phenopype?
phenopype is a high throughput phenotyping pipeline for Python to support ecologists and evolutionary biologists in extracting high dimensional phenotypic data from digital images. phenopype integrates state-of-the-art computer vision functions (using opencv-python as the main backbone), the possibility for GUI-based interactions and a project management ecosystem to facilitate rapid data collection and reproducibility.
Why phenopype
phenopype is aiming to augment, rather than replace the utility of existing CV libraries for scientists measuring phenotypes. Put differently, phenopype does not intend to be an exhaustive library of granular image processing functions, like OpenCV, scikit-image or ImageJ, but instead, it is a set of wrappers and convenient management tools to allow biologists to get their data fast without having to fiddle with too much code.
Main features
(For a complete list check the API reference)
- image analysis workflow:
- preprocessing (automatic reference detection, colour and size correction, morphology operations)
- segmentation (thresholding, watershed, contour-filtering, foreground-background subtraction)
- measurement (pixel intensities, landmarks, shape features, texture features)
- visualization and export
- video analysis module for object tracking
- project management tools to organize images and data (automatic creation of project directory tree)
- customizable analysis-templates that allow anyone to reproduce all collected data with only a few lines of code (suitable for repositories like Dryad or OSF).
Getting started
- Read the Installation Instructions
- Download and run the Tutorials
- Have a look at the Examples
Important information
- phenopype currently does not work on macOS, as there are several issues with OpenCV's HighGUI module, as documented here and here - any help in making phenopype usable for macOS is most welcome !
- phenopype is currently undergoing review at pyOpenSci. In the process, phenopype was updated to version 2 which is not compatible with previous versions - read the instructions for installing past versions
Documentation
The full Documentation can be found here: https://mluerig.github.io/phenopype/
Contributions and feedback
Phenopype development is an ongoing process and contributions towards making it a more broadly applicable and user-friendly tool are most welcome. This can be in the form of feature requests (e.g. more functions from the OpenCV library) or by reporting bugs via the issue tracker. You can also get in touch with me directly if you have any suggestions for improvement.
How to cite phenopype
phenopype: a phenotyping pipeline for python (v2.0.0). 2021 Lürig, M. https://github.com/mluerig/phenopype
@misc{phenopype,
title={{phenopype: a phenotyping pipeline for Python}},
author={L{\"u}rig, Moritz},
year={2021},
url={https://github.com/mluerig/phenopype},
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file phenopype-2.0.0-py3-none-any.whl
.
File metadata
- Download URL: phenopype-2.0.0-py3-none-any.whl
- Upload date:
- Size: 78.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.3.0 pkginfo/1.7.0 requests/2.25.1 setuptools/52.0.0.post20210125 requests-toolbelt/0.9.1 tqdm/4.56.2 CPython/3.7.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3d605a04a950485ee3a8210aee3032e59439f2cf1dfe6fd2a5228a26aa21e8cd |
|
MD5 | 5e5740e9a4f31803d55a20c3c22309e8 |
|
BLAKE2b-256 | 8ab54594cf633923e765e61b59e6fa6dd3ca5eb2fe479d0bbc1eb24e46ac8dbf |