Metadata-Version: 2.1
Name: discolight
Version: 0.2.0
Summary: Flashy, ravey and state-of-the-art image augmentations to boost the performance of deep convolutional neural networks
Home-page: https://github.com/datature/discolight
Author: Hongnan Gao, Ian Duncan, Keechin Goh
Author-email: discolight@datature.io
License: UNKNOWN
Description: ![Discolight Commit Tests](https://github.com/datature/discolight/workflows/Discolight%20Commit%20Tests/badge.svg?branch=master)
        [![Codacy Badge](https://app.codacy.com/project/badge/Grade/0ee00f7675c04c3184d7a95cbba9f28c)](https://www.codacy.com/gh/datature/discolight?utm_source=github.com&amp;utm_medium=referral&amp;utm_content=datature/discolight&amp;utm_campaign=Badge_Grade)
        [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/0ee00f7675c04c3184d7a95cbba9f28c)](https://www.codacy.com/gh/datature/discolight?utm_source=github.com&utm_medium=referral&utm_content=datature/discolight&utm_campaign=Badge_Coverage)
        # Discolight
        
        Flashy, ravey and state-of-the-art image augmentations to boost the
        performance of deep convolutional neural networks
        
        ## At a Glance
        
          - The library works with images in `HxWxC` (channels last) format.
          - Based on numpy, OpenCV, paperspace, imgaug and albumentation.
          - Diversified set of augmentations available.
          - Supports python 3.6-3.8
          - Supports transformations on images, and bounding boxes.
          - The library works with images in `HxWxC` format.
        
        ## Setup
        
        The easiest way to get started is to install the `discolight` package
        via pip:
        
        	$ pip install discolight
        
        Alternatively, if you have cloned this repository, you can run pip on
        the contents of the repository folder:
        
        	$ pip install .
        	
        ## Supported Augmentations
        
        <table style="width: 100%">
        <tr>
        	<td>&nbsp;</td>
        	<td><b>Sample<br/>Image</b></td>
        	<td><b>Augmented<br/>Image</b></td>
        	<td><b>Sample<br/>Image (Bounding<br/>Boxes)</b></td>
        	<td><b>Augmented<br/>Image (Bounding<br/>Boxes)</b></td>
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#ColorTemperature">ColorTemperature</a></b>
        <br/>
        Changes the color temperature of the input image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ColorTemperature-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ColorTemperature.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ColorTemperature-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ColorTemperature-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#GaussianNoise">GaussianNoise</a></b>
        <br/>
        Add gaussian noise to the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GaussianNoise-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GaussianNoise.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GaussianNoise-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GaussianNoise-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#GrayScale">GrayScale</a></b>
        <br/>
        Return a grayscale version of the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GrayScale-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GrayScale.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GrayScale-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/GrayScale-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#HorizontalFlip">HorizontalFlip</a></b>
        <br/>
        Horizontally flips the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/HorizontalFlip-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/HorizontalFlip.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/HorizontalFlip-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/HorizontalFlip-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#ImageCompression">ImageCompression</a></b>
        <br/>
        Apply a compression effect to the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ImageCompression-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ImageCompression.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ImageCompression-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ImageCompression-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#MotionBlur">MotionBlur</a></b>
        <br/>
        Add motionblur to a given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/MotionBlur-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/MotionBlur.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/MotionBlur-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/MotionBlur-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#RandomCrop">RandomCrop</a></b>
        <br/>
        Randomly crops the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomCrop-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomCrop.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomCrop-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomCrop-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#RandomEraser">RandomEraser</a></b>
        <br/>
        Randomly erase a rectangular area in the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomEraser-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomEraser.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomEraser-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomEraser-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#RandomHSV">RandomHSV</a></b>
        <br/>
        Randomly shift the color space of the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomHSV-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomHSV.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomHSV-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomHSV-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#RandomRotate">RandomRotate</a></b>
        <br/>
        Randomly rotate the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomRotate-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomRotate.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomRotate-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/RandomRotate-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Resize">Resize</a></b>
        <br/>
        Resize an image without preserving aspect ratio.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Resize-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Resize.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Resize-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Resize-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#ResizeMaintainAspectRatio">ResizeMaintainAspectRatio</a></b>
        <br/>
        Resize an image while preserving aspect ratio.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ResizeMaintainAspectRatio-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ResizeMaintainAspectRatio.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ResizeMaintainAspectRatio-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/ResizeMaintainAspectRatio-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Rotate">Rotate</a></b>
        <br/>
        Rotate the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Rotate-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Rotate.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Rotate-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Rotate-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#SaltAndPepperNoise">SaltAndPepperNoise</a></b>
        <br/>
        Add salt and pepper or RGB noise to the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/SaltAndPepperNoise-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/SaltAndPepperNoise.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/SaltAndPepperNoise-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/SaltAndPepperNoise-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Scale">Scale</a></b>
        <br/>
        Scale the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Scale-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Scale.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Scale-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Scale-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Sepia">Sepia</a></b>
        <br/>
        Returns a given image passed through the sepia filter.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sepia-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sepia.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sepia-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sepia-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Sequence">Sequence</a></b>
        <br/>
        Perform a sequence of augmentations on the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sequence-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sequence.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sequence-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Sequence-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Shear">Shear</a></b>
        <br/>
        Horizontally shear the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Shear-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Shear.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Shear-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Shear-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#Translate">Translate</a></b>
        <br/>
        Translate the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Translate-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Translate.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Translate-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/Translate-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        <tr>
        
        <td style="width: 20%">
        <b><a href="https://github.com/datature/discolight/blob/master/doc/discolight.md#VerticalFlip">VerticalFlip</a></b>
        <br/>
        Vertically flip the given image.
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/VerticalFlip-input.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/VerticalFlip.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/VerticalFlip-input-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        <td style="width: 20%; vertical-align: bottom">
        <img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/VerticalFlip-bboxes.jpg" width="100px" height="75px" style="display: block; width: 100%"/>
        </td>
        
        </tr>
        
        </table>
        
        ## Generating Augmented Images on the Command Line
        
        To augment a set of images with annotations, you must first prepare
        your input data and prepare YAML configuration file to describe the
        augmentations you want to perform:
        ```yaml
        input:
          images:
                loader: Directory
                options:
                  directory: ./sample_images # The base path of where the images are stored
        
          annotations:
                loader: FourCornersCSV
                options:
                  annotations_file: ./sample_images/annotations.csv # The CSV file with annotations
                  normalized: true
        output:
          images:
                writer: Directory
                options:
                  directory: ./output_folder
          annotations:
                writer: FourCornersCSV
                options:
                  annotations_file: ./output_folder/aug_annotations.csv
                  normalized: true
        augmentations:
          - name: GrayScale
                options:
                  probs: 0.5
          - name: Rotate
                options:
                  probs: 0.7
                  angle: 35
          - name: GaussianNoise
                options:
                  probs: 0.9
          - name: Shear
                options: {}
        save-original: true # Whether to save the original images to the output folder
        save-bbox: true # Whether bounding boxes should be drawn on the augmented images
        ```	
        The image and annotation loaders specify how the images and
        annotations should be loaded. The `FourCornersCSV` (so-named because
        it expects the bounding box to be specified with four coordinates)
        loader expects an input CSV file in the following format:
        ```csv
        	image_name,x_min,y_min,x_max,y_max,label
        	wheat1.jpg,0,0.799805,0.037109,0.94043,1
        	wheat1.jpg,0.064453,0.892578,0.181641,0.949219,1
        	...
        ```
        The chosen image loader will be used to load the images specified
        under the `image_name` column (for example, `wheat1.jpg`). In this
        case, the `Directory` image loader will fetch the images from the
        specified folder. For more information on available image and
        annotation loaders, see ![doc/discolight.md](doc/discolight.md).
        
        Now you can run Discolight:
        
        	$ discolight generate configuration.yml
        
        You can also pass your YAML configuration on standard input:
        
        	$ cat configuration.yml | discolight generate
        
        After generation is complete, the augmented images and annotations
        will be written out according to your configuration options. Here, we
        choose to save the annotations to a CSV file using the same
        four-corners format, and the augmented images will appear in the
        `output_folder/` directory.
        
        ## Library Functionality
        
        In addition to invoking Discolight from the command line, you can also
        invoke it as a library. First, construct the augmentation you want to
        apply to an image. For example, here is a simple augmentation
        sequence:
        ```python
        from discolight.disco import disco
        from discolight.annoations import BoundingBox
        from discolight.util.image import load_image, save_image
        
        seq = disco.Sequence(augmentations=[
        	disco.GaussianNoise(),
        	disco.RandomEraser(),
        	disco.Rotate(angle=35)
        ])
        ```	
        Then, load the image and specify your annotations:
        ```python
        image = load_image("path/to/image.jpg")
        
        annotations = [
        	# BoundingBox(x_min, y_min, x_max, y_max, class_idx)
        	BoundingBox(0, 819, 38, 963, 1),
        	BoundingBox(66, 914, 186, 972, 1),
        	BoundingBox(52, 526, 126, 645, 1),
        ]
        ```	
        Now, you can invoke `seq` as a function to apply your augmentation:
        ```python
        aug_img, aug_annotations = seq(image, annotations)
        ```
        If you have no annotations, you can also apply `seq` only to an image:
        ```python
        aug_img = seq(image)
        ```
        To save the augmented image, use the provided `save_image`
        function. You can optionally pass the augmented annotations (also an
        array of `BoundingBox` objects) to be drawn in red over the augmented
        image:
        ```python
        save_image("aug-with-bboxes.jpg", aug_img, annotations=aug_annotations)
        save_image("aug-no-bboxes.jpg", aug_img)
        ```
        If you prefer to perform additional operations on the image after
        augmentation, augmented images are OpenCV images in RGB format.
        
        ## Development
        
        To learn more about how to develop Discolight (e.g., adding additional
        augmentatations), see the guide in [doc/develop.md](https://github.com/datature/discolight/blob/master/doc/develop.md).
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.6, <3.9
Description-Content-Type: text/markdown
