reshalfahsi / ggb

Implementation of GGB color space

GGB Color Space

This package is implementation of GGB color space from Development of a Robust Algorithm for Detection of Nuclei and Classification of White Blood Cells in Peripheral Blood Smear Image.

Installation

Install GGB

This package could be installed via PyPI.

pip3 install ggb

or manually:

python3 setup.py install

Building Docker Image

Dockerfile is also provided in this project. To build the image:

cd docker/
bash docker.build.sh

or pull it directly from Docker Hub:

docker pull reshalfahsi/ggb

Building the Documentation

The documentations to this package could be built using Sphinx.

cd docs/
pip3 install -r requirements.txt
make html

The HTML pages are in docs/build/html.

Quick Demo

This package supports various computer vision libraries such as OpenCV and PIL. Complete examples for these computer vision libraries are provided in here. For the short example in Python3:

# import the package and its necessary components
from ggb import GGB, ColorSpace

# we are using OpenCV
import cv2

import urllib.request as urllib
import numpy as np

# load image from internet
req = urllib.urlopen('https://github.com/reshalfahsi/GGB/raw/master/docs/img/leukocytes.png')
arr = np.asarray(bytearray(req.read()), dtype=np.uint8)
img = cv2.imdecode(arr, -1)
    
# convert to GGB Color
ggb_image = GGB(image=img, input_color=ColorSpace.BGR).process()

# show the result    
ggb_image.show()

# save the image to OpenCV format
img = ggb_image.write()

This package also could be run through CLI:

ggb /path/to/image --output /path/to/output

Result

Leukocytes

Fundus

Car