Metadata-Version: 2.1
Name: discolight
Version: 0.3.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
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
Requires-Dist: yamale (>=3.0.1)
Requires-Dist: numpy (>=1.19.0)
Requires-Dist: opencv-python (>=4.3.0.36)
Requires-Dist: scikit-image (>=0.17.2)
Requires-Dist: Pillow (>=7.2.0)
Requires-Dist: Jinja2 (>=2.11.2)
Requires-Dist: tqdm (>=4.47.0)
Requires-Dist: defusedxml (>=0.6.0)

![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#OneOf">OneOf</a></b>
<br/>
Perform a randomly selected augmentation on the given image.
</td>

<td style="width: 20%; vertical-align: bottom">
<img src="https://raw.githubusercontent.com/datature/discolight/master/doc/images/OneOf-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/OneOf.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/OneOf-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/OneOf-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).

