Skip to main content

Small, fast and simple Python CLI image converter for CNNs.

Project description

Rudi

If you want to train a CNN, the custom dataset must be a collection of images of the same aspect ratio, extension, etc. This script is gonna do that for you. Rudi is a command line tool for converting and augmenting your dataset of images.

Installation

Install Python3 and then run the following command:

pip install rudi

or clone the repo firs

git clone https://github.com/liashchynskyi/rudi
cd rudi

and run python setup.py install or pip install .

Usage

Imgur

Convert a dataset

For example, you have a basic tree of the root directory (the script will also work if the root containt only images without other dirs).

root    
в””в”Ђв”Ђв”Ђclass1
в”‚   в”‚   image_c1.png
в”‚   в”‚   image_c2.png
в”‚   в””в”Ђв”Ђв”Ђsubdirectory    
в””в”Ђв”Ђв”Ђclass2
    в”‚   image_c1.png
    в”‚   image_c2.png

Just run rudi convert --help Imgur

Let's convert images in current directory to jpg format and set new aspect ratio to 224px.

rudi convert -t jpg --target-size=224 ./

Output images will be saved in output dir of the root.

Dataset augmentation

Command: rudi augment --help Imgur

There are a few supported operations:

  • flip - random image flipping followed by -p option
  • rotate - random image rotation followed by -p,-mlr and -mrr options
  • distortion - random image distortion followed by -p,-mg and -gwh options
  • skew - random image skewing followed by -p option and constant magnitude value of 0.7
  • zoom - random image zooming followed by -p,-minf and -maxf options

Output images will be saved in output dir of the root.

Changelog

  • 1.0.1
    • Fixed problem when converting images. Now if image is placed in subdirectory then that subdir also will be created in output dir.

Donate

Just put a star on this repository рџЊћ Thanks!

made by @liashchynskyi

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rudi-1.0.1.tar.gz (4.1 kB view details)

Uploaded Source

File details

Details for the file rudi-1.0.1.tar.gz.

File metadata

  • Download URL: rudi-1.0.1.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.18.4 setuptools/39.1.0 requests-toolbelt/0.9.1 tqdm/4.19.5 CPython/3.6.7

File hashes

Hashes for rudi-1.0.1.tar.gz
Algorithm Hash digest
SHA256 26aad6cb098796bd0a2730cb463e80c66d0ce6d114a8198e053757772417ab5d
MD5 caae2f8fa2aaddd64bb6d238c6eb7451
BLAKE2b-256 2697568b5a9cb33553bd9c8a739ec77af639c702f854997c6449e60674be71ab

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page