PixFlow: Image Processing Toolkit

Simple, lightweight, and easy-to-use image processing toolkit in Python.
Resize images, transfer histograms, and detect structural differences with just a few lines of code.

🖼️ Description

PixFlow is a Python package designed to simplify common image processing tasks, including:

• Image resizing
• Histogram matching between images
• Structural difference detection (SSIM)
• Image reading and saving
• Plotting images and histograms

Built on top of scikit-image, matplotlib, and numpy.

📦 Features

• 🔸 Image reading and saving — Supports formats like .jpg, .png, etc.
• 🔸 Image resizing — Resizes by relative proportion.
• 🔸 Histogram matching — Adjusts the tones of one image to match another.
• 🔸 Structural difference detection (SSIM) — Detects and visualizes structural differences between images.
• 🔸 Plot utilities:
  • Display single images
  • Compare multiple images side by side
  • Plot RGB histograms

🚀 Installation

Install from PyPI:

bash pip install pixflow

Or install locally from the repository:

bash git clone https://github.com/A-Chioquetta/pixflow.git cd pixflow pip install -e .

🔧 Dependencies

• numpy
• matplotlib
• scikit-image

These will be automatically installed with pip install pixflow.
Or install manually with:

bash pip install -r requirements.txt

🛠️ Usage Example

```python from pixflow import ( readimage, saveimage, resizeimage, transferhistogram, finddifference, plotimage, plotresult, plothistogram )

Read images

image1 = readimage('flor1.jpg') image2 = readimage('flor2.jpg') image3 = readimage('flor1alterada.jpg')

Resize

resized = resizeimage(image1, proportion=0.5) plotimage(resized, title="Resized Image")

Histogram matching

matched = transferhistogram(image1, image2) plotresult(image1, image2, matched, title="Histogram Matching")

Structural difference (SSIM)

difference = finddifference(image1, image3) plotresult(image1, image3, difference, title="Structural Difference")

Histogram plot

plot_histogram(image1)

Save resized image

saveimage(resized, 'resizedimage.jpg') ```

🗂️ Project Structure

pixflow/ ├── pixflow/ │ ├── processing/ │ ├── utils/ │ └── __init__.py ├── examples/ ├── tests/ ├── README.md ├── setup.py ├── LICENSE.txt └── requirements.txt

📄 License

This project is licensed under the MIT License.

🔗 Links

• PyPI: https://pypi.org/project/pixflow/
• GitHub: https://github.com/A-Chioquetta/pixflow