Digital Image Processing

About

This repository contains projects made for Digital Image Processing and Analysis course
during summer semester of 3rd year of Data Engineering and Analysis on AGH UST.

Setup

Create new conda environment from environment.yml

conda env create digital-image --file=environment.yml

Or from requirements.txt

conda create -n digital-image -f requirements.txt

Main

You can use the main.py script on top of this project to choose one program and run it. See help for all options.

python main.py --help

Fractals

This program generates a fractal using affine transformations from image or draws points.

• drawing.py - It uses turtle package for drawing of each point.
• generator.py - generates a fractal from specified image.
• plots.py - plot for generated fractal.
• transformations.py is the Affine Transformation class which has 4 transformation matrices and a method to get each matrix randomly.
• utils.py - function to load and save image and MAX_ITERATIONS constant.

To generate fractal from an image:

python fractals/main.py --path <path to image>

To draw each point in a loop:

python fractals/main.py

Kirsch

This program filtrates an image using kirsch operators and plots the results using matplotlib.`

• filtration.py - here is the main filtration functions
• operators.py - here is a class with kirsch operators
• plots.py - here is a function for plotting the results
• utils.py - loading and saving the image and other utilities

Tu run the program use

python kirsch/main.py --path <path to image>

Closing

This program performs binary on greyscale closing on input image.

• closing - inside this package there are binary and mono morphology functions
• element.py - here is class with structural element
• plots.py - here is a function for plotting results
• utils.py - functions to load and save an image and check its type

To run this program you must specify path. You can specify radius for the structural element otherwise program will use default value of 5.

python closing/main.py --path <path to image> --radius <radius>

Distances

This program creates a heatmap of geodetic distances within a binary image.

• element.py - here is class with structural element
• geodetic.py - here is the main function that creates the heatmap
• logical.py - logical image dilation
• plots.py - here is a function for plotting the results
• utils.py - here are the functions to load and save the image

To run this program you must specify path. You can specify radius for the structural element and x and y coordinates otherwise the program will use default values.

python distances/main.py --path <path to image> --radius <radius> --x <x> --y <y>