Metadata-Version: 2.1
Name: colonyscanalyser
Version: 0.2.1
Summary: An image analysis tool for measuring microorganism colony growth
Home-page: https://github.com/Erik-White/ColonyScanalyser/
Author: Erik White
Author-email: 
License: GPL-3.0
Description: [![PyPI version](https://badge.fury.io/py/colonyscanalyser.svg)](https://pypi.org/project/colonyscanalyser/) [![Known Vulnerabilities](https://snyk.io//test/github/Erik-White/ColonyScanalyser/badge.svg?targetFile=requirements.txt)](https://snyk.io//test/github/Erik-White/ColonyScanalyser?targetFile=requirements.txt) [![GitHub](https://img.shields.io/github/license/erik-white/colonyscanalyser?color=blue)](https://github.com/Erik-White/ColonyScanalyser/blob/master/LICENSE)
        
        # ColonyScanalyser
        
        An image analysis tool for measuring microorganism colony growth.
        
        ColonyScanalyser will analyse and collate statistical data from cell-culture plate images. It requires a series of images from a fixed point that show the development of microorganism colonies over time.
        
        <img align="right" src="docs/images/growth_curve_small.png">
        
        ColonyScanalyser can provide information on:
        * Colony growth lag time (time of appearance)
        * Bimodal lag time distribution (comparing lag times of two colonies)
        * Colony area growth over time
        
        By default, it will output a set of data and plots that summarize the information from all the plates in the image series. If you require further detail, such as plots of each individual plate, you can increase the `save_plots` command line argument.
        
        ## Getting Started
        
        * Install the [prerequisites](#prerequisites) and [package](#installing)
        * Locate your image series in a folder e.g. `\user\images\series1`
        * Run the analysis using ColonyScanalyser `scanalyser \user\images\series1`
        
        There are various command line arguments that can alter the way the package is run. To see a list of arguments and information on each, run the command `scanalyser --help`
        
        For example, to run the package 'silently' with no console output: `scanalyser \user\images\series1 --verbose 0`
        
        ### Prerequisites
        
        * [Python](https://www.python.org/) >=3.7
        * [Scikit-image](https://scikit-image.org/) >=0.15
        
        Optionally use a virtual environment, such as [Pipenv](https://github.com/pypa/pipenv).
        
        For testing:
        * [Pytest](https://pytest.org/)
        * [Pytest-cov](https://github.com/pytest-dev/pytest-cov/)
        
        ### Installing
        
        #### Using pip
        Install Scikit-image (unless already installed)
        ```
        pip install scikit-image
        ```
        
        Install ColonyScanalyser
        ```
        pip install colonyscanalyser
        ```
        
        #### From github (requires [git](https://git-scm.com/) install)
        ```
        git clone https://github.com/erik-white/colonyscanalyser.git
        cd colonyscanalyser
        pip install -e .
        ```
        
        ## Testing
        
        Install the package with the extra test packages:
        `pip install colonyscanalyser[test]`
        
        Run the tests:
        `pytest --cov colonyscanalyser`
        
        ## Contributing
        
        Please read [CONTRIBUTING.md](docs/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
        
        ## Versioning
        
        We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://github.com/erik-white/scanalyser/tags).
        
        ## License
        
        This project is licensed under the GPLv3 - see the [LICENSE](LICENSE) file for details
        
        ## Acknowledgments
        
        * Levin-Reisman et al. for [their work](https://www.ncbi.nlm.nih.gov/pubmed/20676109) developing the ScanLag technique
        * [Fabio Zanini](https://github.com/iosonofabio/) for his original attempts at a Python implementation
Platform: UNKNOWN
Requires-Python: >3.7
Provides-Extra: dev
Provides-Extra: test
