Metadata-Version: 2.1
Name: ggb
Version: 1.1.2
Summary: GGB Color Space in Python
Home-page: https://github.com/reshalfahsi/ggb
Author: Resha Dwika Hefni Al-Fahsi
Author-email: resha.alfahsi@gmail.com
License: MIT
Description: # GGB Color Space
        
        [![PyPI](https://badge.fury.io/py/ggb.svg)](https://badge.fury.io/py/ggb)
        [![license](https://img.shields.io/github/license/mashape/apistatus.svg?maxAge=2592000)](https://github.com/reshalfahsi/ggb/blob/master/LICENSE)
        [![TravisCI](https://api.travis-ci.com/reshalfahsi/ggb.svg?branch=master)](https://travis-ci.com/github/reshalfahsi/ggb)
        [![Docker](https://img.shields.io/docker/pulls/reshalfahsi/ggb.svg)](https://hub.docker.com/r/reshalfahsi/ggb)
        [![Codecov](https://codecov.io/github/reshalfahsi/ggb/coverage.svg?branch=master&precision=2)](https://codecov.io/github/reshalfahsis/ggb?branch=master)
        
        
        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](https://link.springer.com/content/pdf/10.1007%2Fs10916-018-0962-1.pdf).
        
        
        ## Installation
        
        ### Install GGB
        
        This package could be installed via [PyPI](https://pypi.org/project/ggb/).
        
            pip3 install ggb
        
        or manually:
        
            python3 setup.py install
        
        
        ### Building Docker Image
        
        `Dockerfile` is also provided in this project. To build the image:
        
        ```bash
        cd docker/
        bash docker.build.sh
        ```
        
        
        or pull it directly from [Docker Hub](https://hub.docker.com/r/reshalfahsi/ggb):
        
            docker pull reshalfahsi/ggb
        
        
        ### Building the Documentation
        
        The documentations to this package could be built using [Sphinx](www.sphinx-doc.org).
        
        ```bash
        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 example for these computer vision libraries provided in [here](https://github.com/reshalfahsi/ggb/tree/master/examples). For the short example in Python3:
        
        
        ```python
        # 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()
        ```
        
        
        ## Result
        
        ### Leukocytes
        ![alt text](https://github.com/reshalfahsi/GGB/raw/master/docs/img/GGB_RGB_LEUKOCYTES.jpg)
        
        ### Fundus
        ![alt text](https://github.com/reshalfahsi/GGB/raw/master/docs/img/GGB_RGB_FUNDUS.jpg)
        
        ### Car
        ![alt text](https://github.com/reshalfahsi/GGB/raw/master/docs/img/GGB_RGB_TESLA.jpg)
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
Provides-Extra: tests
