Bacteriophage plaque size measurement tool
Project description
Bacteriophage plaques size tool
This tool that is written in Python 3 takes Petri dish images as input and measures the sizes of the bacteriophage round and oval-shaped plaques.
#Installation
There are two options to install the tool: ##1) Installation using pip The following command should be exectuted:
pip install plaque-size-tool
Prerequisites
-
Python 3.6 or higher should be installed in the system:
For Python 3 installation, please navigate to https://www.python.org/downloads/. The detailed instructions for download and installation are provided at https://wiki.python.org/moin/BeginnersGuide/Download.
-
PIP should be installed in the system:
pip should be already installed if you are using Python 2 >=2.7.9 or Python 3 >=3.4 downloaded from python.org. If it is not installed, please navigate to https://pip.pypa.io/en/stable/installing/ for the instructions.
Install dependencies
Run following command in the root of the project:
pip install -r requirements.txt
Usage
The tool supports TIF, TIFF, JPG, JPEG and PNG image formats.
Run the tool
To run the tool, use one of the following options. Output will be placed into ./out
directory of the project
on a file
If it's required to analyze a single file, run the following command:
python plaque_size_tool.py -i <path_to_the_file> [-p plate_size] [-small]
on a directory
If it's required to analyze multiple files, put all files in the directory. Then run the following command:
python plaque_size_tool.py -d <path_to_the_directory> [-p plate_size] [-small]
Additional options
-p plate_size - (Optional) Petri dish size (mm)
-small - (Optional) Use on plates with small plaques (less than 2.5 mm)
Output
The tool produces 2 output files:
out_<file_name>.ext - an image with valid plaques circled with green colour, where <ext> is an extension of the original file
data-green-<file_name>.csv - a CSV file with detected plaques parameters:
INDEX_COL - the ID of the plaque that corresponds to the ID on the output image
AREA_PXL - Area of a plaque in pixels
PERIMETER - Perimeter of a plaque in pixels
AREA_MM2 - Area of a plaque in millimiters if plate size is specified
AREA_MM2 - Area of a plaque in millimiters squared if plate size is specified
DIAMETER_MM - Diameter of a plaque in millimiters if plate size is specified
Notes
This tool was tested on grey images in TIF format made using a Bio-Rad GelDoc system with the Exposure parameter equal to 0.750 sec. The tool can automatically adjust brightness and contrast of images for processing. If you are experiencing any issues with your images (for example, overprocessing), please email to ellina.trofimova@hdr.mq.edu.au with a copy to ellina.trofimova@gmail.com
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
Built Distribution
Hashes for plaque_size_tool-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8caa6a4add64217f44981cb3a98085eb68376849ef1ca9d804efe343dd41cc67 |
|
MD5 | 1ee762eb4deb68b02f1d0d62205dc4a9 |
|
BLAKE2b-256 | 10588e9b1addbd8a91ab2b25275a5344df8c86e5edd6f4a772dce33a9ed3faf7 |