Metadata-Version: 2.1
Name: aigarmic
Version: 1.0.0
Summary: Machine-learning assisted agar dilution MIC
License: GPL-3.0
Author: Alessandro Gerada
Requires-Python: >=3.9,<3.11
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Requires-Dist: imutils (>=0.5)
Requires-Dist: matplotlib (>=3.6)
Requires-Dist: numpy (>=1.26)
Requires-Dist: opencv-python (>=4.9)
Requires-Dist: pytest (>=8.1)
Requires-Dist: scikit-learn (>=1.4)
Requires-Dist: sphinx (>=7.2)
Requires-Dist: sphinx-argparse (>=0.4.0,<0.5.0)
Requires-Dist: tensorflow (>=2.11,<=2.15) ; platform_system != "Darwin" and platform_machine != "arm64"
Requires-Dist: tensorflow-macos (>=2.11,<=2.15) ; platform_system == "Darwin" and platform_machine == "arm64"
Description-Content-Type: text/markdown

# `AIgarMIC`

## Introduction

`AIgarMIC` is a Python package and collection of commandline scripts designed to facilitate the automation of agar dilution minimum inhibitory concentration image interpretation.

`AIgarMIC` has the following features:

* Automated image processing of agar dilution plates in the following format (note the use of an anchoring black grid to delineate colonies): 

![Example image 1](/readme_images/2.0.jpg)

* Flexible MIC calculation algorithm with ability to disregard inhibited growth
* Quality assurance metrics to ensure MIC predictions
* Pre-trained models and example datasets
* Scripts to support custom model training

## Documentation

The full documentation for `AIgarMIC` can be found at:

https://aigarmic.readthedocs.io/en/latest/

## Installation

To install `AIgarMIC`, follow the instructions below:

https://aigarmic.readthedocs.io/en/latest/installation.html

## Usage

To use `AIgarMIC`, follow one of the typical workflows described below:

https://aigarmic.readthedocs.io/en/latest/introduction.html#typical-workflows

## Author information

The lead developer of ``AIgarMIC`` is Alessandro Gerada (https://github.com/agerada/ and https://agerada.github.io/), 
University of Liverpool, UK (alessandro.gerada@liverpool.ac.uk).

## External links

The manuscript describing the validation of `AIgarMIC` can be found at: https://doi.org/10.1128/spectrum.04209-23.
Optional asset data is available at: https://10.17638/datacat.liverpool.ac.uk/2631.

## License

`AIgarMIC` is provided under the GNU General Public License v3.0. For more information, see the LICENSE file.

