Skip to main content

(Semi) Automated Image Processing

Project description

(Semi) Automated Image Processing with pyautocv

PyPI version fury.io DOI Stage Actions Codecov Travis Build license Documentation Status PyPI license Total Downloads Monthly Downloads Weekly Downloads Maintenance GitHub last commit GitHub issues GitHub issues-closed

Project Aims

The goal of pyautocv is to provide a simple computer vision(cv) workflow that enables one to automate or at least reduce the time spent in image (pre)-processing.

Installing the package

From PyPI

pip install pyautocv

From GitHub

pip install git+https://github.com/Nelson-Gon/pyautocv.git
#or
# clone the repo
git clone https://www.github.com/Nelson-Gon/pyautocv.git
cd pyautocv
python3 setup.py install

Example Usage

Note: Although these methods can be run via this script, the script is less flexible and might be useful for quick exploration but not extended analysis.

To run the script at the commandline, we can do the following

python -m pyautocv -d "images/cats" -s "png" -m "thresh_to_zero" -o "threshold" -mt 200 -t 100

Sample Result

Command Line Script

To perform edge detection

python -m pyautocv -d "images/biology" -s "jpg" -o "detect_edges" -m "sobel_vertical" -k 3

Bio Script

To smooth images

python -m pyautocv -d "images/houses" -s "jpg" -o "smooth" -m "gaussian" -k 5 5 --sigma 0.7

Houses Smooth

To get help

python -m pyautocv -h 

Further exploration is left to the user.


The following section shows how to use the more flexible class/methods approach

  • Image Gra(e)ying

To grey an image directory

from pyautocv.segmentation import Segmentation, gray_images, show_images

images_list=Segmentation("images/cats")
show_images(gray_images(images_list.read_images()), images_list.read_images(), number=2)

Grayed

  • Smoothing

To smooth a directory of images, we can use EdgeDetection's smooth method as follows

images_list=Segmentation("images/cats")
show_images(images_list.smooth(), images_list.read_images(),number=2)

This will give us

Smooth

The above uses default parameters including an rgb color mode. For biological images which are often in grayscale, one can set color_mode to gray as shown below. All other operations will remain the same.

images_list_gray_mode=Segmentation("images/dic", image_suffix ="tif", color_mode = "gray")
show_images(images_list_gray_mode.read_images(), images_list_gray_mode.threshold_images(), number = 4)

Result

Sample Gray

To use a different filter

images_list = Segmentation("images/cats")
show_images(images_list.read_images(), images_list.smooth(mask="median", kernel_shape=(7, 7)))

Cats-Median-Smooth

  • Edge Detection

To detect edges in a directory of images, we can use Segmentation's detect_edges.

show_images(images_list.read_images(), images_list.detect_edges(operator="roberts", mask="gaussian", sigma=0.8))

The above will give us the following result

Sample_colored

To use a different filter e.g Laplace,

show_images(images_list.read_images(), images_list.detect_edges(operator="laplace", mask="gaussian", sigma=0))

This results in

Laplace

  • Thresholding

To perform thresholding, we can use the method threshold_images.

to_threshold = Segmentation("images/biology")
show_images(to_threshold.read_images(),to_threshold.threshold_images())

Threshold

To use a different thresholding method.

show_images(to_threshold.read_images(),to_threshold.threshold_images(threshold_method="otsu"))

The above gives us:

otsu

For cat lovers, here's thresholding with inverse binary.

show_images(images_list.read_images(),images_list.threshold_images(threshold_method="binary_inverse"))

Result:

Cats

Thresholding applied to images of houses.

images_list=Segmentation("images/houses")
show_images(images_list.read_images(), images_list.threshold_images(threshold_method="thresh_to_zero"))

Threshold-Houses

images_list=Segmentation("images/potholes")
show_images(images_list.read_images(), images_list.threshold_images("binary"))

Potholes

These and more examples are available in example.py. Image sources are shown in sources.md. If you feel attribution was not made, please file an issue and cite the violating image.

Citation

Nelson Gonzabato(2021) pyautocv: (Semi) Automated Image Processing, https://github.com/Nelson-Gon/pyautocv.

@misc {Gonzabato2021,
author = {Gonzabato, N},
title = {pyautocv: (Semi) Automated Image Processing},
year = {2021},
publisher = {GitHub},
journal = {GitHub repository},
howpublished = {\url{https://github.com/Nelson-Gon/pyautocv}},
commit = {7fe2e0f7894e8be4588a22758e8097c247cd1cd9}

Thank you very much

“A language that doesn't affect the way you think about programming is not worth knowing.” ― Alan J. Perlis


References

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

pyautocv-0.3.1.tar.gz (17.0 MB view details)

Uploaded Source

Built Distribution

pyautocv-0.3.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file pyautocv-0.3.1.tar.gz.

File metadata

  • Download URL: pyautocv-0.3.1.tar.gz
  • Upload date:
  • Size: 17.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.6.13

File hashes

Hashes for pyautocv-0.3.1.tar.gz
Algorithm Hash digest
SHA256 ab2234a569fc4d150ca34e162c830c788577eb2a9705962b206d5a906ed32748
MD5 0b59f443e40dd6c65e588f8f77904901
BLAKE2b-256 5ec012ec72c04e299f89385b82df29f991a74aad5cdecf540d57d8325c693602

See more details on using hashes here.

File details

Details for the file pyautocv-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: pyautocv-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.4.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.6.13

File hashes

Hashes for pyautocv-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 26e2330d1b6ebaefa894a611eef37dd08a94d59171bb458f34658234ba41a786
MD5 c327bd3484b8e52b68199dffbc7c828c
BLAKE2b-256 22312ba62379bcc976d2642e200a5c2390586fe5f3384e0e0f7790d200eaf681

See more details on using hashes here.

Supported by

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