Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/waikato-ufdl/wai-annotations-imgaug

Image augmentation stream processors for the wai.annotations conversion library.
https://github.com/waikato-ufdl/wai-annotations-imgaug

filters image-annotation image-augmentation processing python3

Last synced: about 1 month ago
JSON representation

Image augmentation stream processors for the wai.annotations conversion library.

Host: GitHub
URL: https://github.com/waikato-ufdl/wai-annotations-imgaug
Owner: waikato-ufdl
License: apache-2.0
Created: 2020-06-16T01:36:04.000Z (over 4 years ago)
Default Branch: master
Last Pushed: 2024-04-09T04:17:22.000Z (9 months ago)
Last Synced: 2024-11-15T21:06:42.501Z (about 1 month ago)
Topics: filters, image-annotation, image-augmentation, processing, python3
Language: Python
Homepage: https://ufdl.cms.waikato.ac.nz/wai-annotations-manual/
Size: 96.7 KB
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.rst
- License: LICENSE

Awesome Lists containing this project

README

# wai-annotations-imgaug
Image augmentation stream processors for the [wai.annotations](https://github.com/waikato-ufdl/wai-annotations)
conversion library.

The manual is available here:

https://ufdl.cms.waikato.ac.nz/wai-annotations-manual/

## Plugins
### CROP
Crops images.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
CROP:
Crops images.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: crop [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-f PERCENT_FROM] [-t PERCENT_TO] [-s SEED] [-a] [-T THRESHOLD] [-u]

optional arguments:
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-f PERCENT_FROM, --from-percent PERCENT_FROM
the minimum percent to crop from images
-t PERCENT_TO, --to-percent PERCENT_TO
the maximum percent to crop from images
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
-u, --update-size
whether to update the image size after the crop operation or scale back to original size
```

### FLIP
Flips images either left-to-right, up-to-down or both.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
FLIP:
Flips images either left-to-right, up-to-down or both.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: flip [-d DIRECTION] [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-s SEED] [-a] [-T THRESHOLD]

optional arguments:
-d DIRECTION, --direction DIRECTION
the direction to flip, available options: lr, ud, lrud
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
```

### GAUSSIAN-BLUR
Applies gaussian blur to images.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
GAUSSIAN-BLUR:
Applies gaussian blur to images.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: gaussian-blur [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-s SEED] [-a] [-f SIGMA_FROM] [-t SIGMA_TO] [-T THRESHOLD]

optional arguments:
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-f SIGMA_FROM, --from-sigma SIGMA_FROM
the minimum sigma for the blur to apply to the images
-t SIGMA_TO, --to-sigma SIGMA_TO
the maximum sigma for the blur to apply to the images
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
```

### HSL-GRAYSCALE
Turns RGB images into fake grayscale ones by converting them to HSL and then using the L channel for all channels. The brightness can be influenced and varied even.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
HSL-GRAYSCALE:
Turns RGB images into fake grayscale ones by converting them to HSL and then using the L channel for all channels. The brightness can be influenced and varied even.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: hsl-grayscale [-f FACTOR_FROM] [-t FACTOR_TO] [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-s SEED] [-a] [-T THRESHOLD]

optional arguments:
-f FACTOR_FROM, --from-factor FACTOR_FROM
the start of the factor range to apply to the L channel to darken or lighten the image (<1: darker, >1: lighter)
-t FACTOR_TO, --to-factor FACTOR_TO
the end of the factor range to apply to the L channel to darken or lighten the image (<1: darker, >1: lighter)
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
```

### LINEAR-CONTRAST
Applies linear contrast to images.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
LINEAR-CONTRAST:
Applies linear contrast to images.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: linear-contrast [-f ALPHA_FROM] [-t ALPHA_TO] [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-s SEED] [-a] [-T THRESHOLD]

optional arguments:
-f ALPHA_FROM, --from-alpha ALPHA_FROM
the minimum alpha to apply to the images
-t ALPHA_TO, --to-alpha ALPHA_TO
the maximum alpha to apply to the images
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
```

### ROTATE
Rotates images randomly within a range of degrees or by a specified degree. Specify seed value and force augmentation to be seeded to generate repeatable augmentations.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
ROTATE:
Rotates images randomly within a range of degrees or by a specified degree. Specify seed value and force augmentation to be seeded to generate repeatable augmentations.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: rotate [-f DEGREE_FROM] [-t DEGREE_TO] [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-s SEED] [-a] [-T THRESHOLD]

optional arguments:
-f DEGREE_FROM, --from-degree DEGREE_FROM
the start of the degree range to use for rotating the images
-t DEGREE_TO, --to-degree DEGREE_TO
the end of the degree range to use for rotating the images
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
```

### SCALE
Scales images randomly within a range of percentages or by a specified percentage. Specify seed value and force augmentation to be seeded to generate repeatable augmentations.

#### Domain(s):
- **Image Classification Domain, Image Object-Detection Domain**

#### Options:
```
SCALE:
Scales images randomly within a range of percentages or by a specified percentage. Specify seed value and force augmentation to be seeded to generate repeatable augmentations.

Domain(s): Image Object-Detection Domain, Image Classification Domain

usage: scale [-m IMGAUG_MODE] [--suffix IMGAUG_SUFFIX] [-k] [-f PERCENTAGE_FROM] [-t PERCENTAGE_TO] [-s SEED] [-a] [-T THRESHOLD] [-u]

optional arguments:
-m IMGAUG_MODE, --mode IMGAUG_MODE
the image augmentation mode to use, available modes: replace, add
--suffix IMGAUG_SUFFIX
the suffix to use for the file names in case of augmentation mode add
-k, --keep-aspect
whether to keep the aspect ratio
-f PERCENTAGE_FROM, --from-percentage PERCENTAGE_FROM
the start of the percentage range to use for scaling the images
-t PERCENTAGE_TO, --to-percentage PERCENTAGE_TO
the end of the percentage range to use for scaling the images
-s SEED, --seed SEED
the seed value to use for the random number generator; randomly seeded if not provided
-a, --seed-augmentation
whether to seed the augmentation; if specified, uses the seeded random generator to produce a seed value from 0 to 1000 for the augmentation.
-T THRESHOLD, --threshold THRESHOLD
the threshold to use for Random.rand(): if equal or above, augmentation gets applied; range: 0-1; default: 0 (= always)
-u, --update-size
whether to update the image size after the scaling operation or use original size
```

### SUB-IMAGES
Extracts sub-images (incl their annotations) from the images coming through, using the defined regions.

#### Domain(s):
- **Image Classification Domain**
- **Image Object-Detection Domain**

#### Options:
```
usage: sub-images [-p] [-s REGION_SORTING] [-r REGIONS [REGIONS ...]]

optional arguments:
-p, --include-partial
whether to include only annotations that fit fully into a region or also partial ones (default: False)
-s REGION_SORTING, --region-sorting REGION_SORTING
how to sort the supplied region definitions: none|x-then-y|y-then-x (default: none)
-r REGIONS [REGIONS ...], --regions REGIONS [REGIONS ...]
the regions (X,Y,WIDTH,HEIGHT) to crop and forward with their annotations (default: [])
```