Metadata-Version: 2.1
Name: pyimg-process
Version: 1.3.4
Summary: A simple package for image processing
Home-page: https://github.com/jonamelibia/pyimg-process
Download-URL: https://github.com/jonamelibia/pyimg-process/archive/refs/tags/1.3.4.tar.gz
Author: Mikel Agirrebeitia & Jon Amelibia
Author-email: jon.amelibia@alumni.mondragon.edu
License: MIT
Keywords: Image proceessing,Easy to use,Simple
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# pyimg-process

The **pyimg-process** package is a Python library that provides simple and expressive manual image processing techniques. It aims to provide an easy toolkit for begginer users in order to develop their image treatment projects. It is already well on its way towards this goal.


## Main Features

Here are some of the implemented features: 

- Easy way to read, write and display images
- Image resizing to any dimension
- RGB to grayscale conversion
- Image blurring and sharpening methods
- Image filtering by thresholding
- Visualization of the histogram of the image
- Inverse image obtention

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install pyimage.

```bash
pip install pyimg-process
```

## Usage

```python
import pyimg_process

# loads 'image' from 'path'
img = pyimg_process.Methods.read_image('path','image')

# converts img to grayscale
gray = pyimg_process.Methods.grayscale(img)

# sharpen img with a 100x100 kernel
sharp = pyimg_process.Methods.sharpen(img, 100)

# displays both images
pyimg_process.Methods.show_image(img)
pyimg_process.Methods.show_image(gray)
pyimg_process.Methods.show_image(sharp)
```
![Original image](https://github.com/jonamelibia/pyimg-process/blob/main/examples/cat_resized.png?raw=true "Original image")
![Image on grayscale](https://github.com/jonamelibia/pyimg-process/blob/main/examples/cat_grayscale.png?raw=true "Image on grayscale")
![Image sharpened](https://github.com/jonamelibia/pyimg-process/blob/main/examples/cat_sharpened.png?raw=true "Image sharpened")

## Dependencies
- [NumPy](https://numpy.org/) - Adds support for large, multi-dimensional arrays, matrices and high-level mathematical functions to operate on these arrays
- [Matplotlib](https://matplotlib.org) - Matplotlib is a comprehensive library for creating static, animated, and interactive visualizations in Python. Matplotlib makes easy things easy and hard things possible.
- [OpenCV](https://docs.opencv.org/4.x/d6/d00/tutorial_py_root.html) - OpenCV provides a real-time optimized Computer Vision library, tools, and hardware.

## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

## License
[MIT](https://choosealicense.com/licenses/mit/)
