cie-utils 0.2.0

Image processing based on CIELAB color space.

🌈 cie-utils

Advanced image processing in Python using the CIELAB color space.

---

cie-utils is a Python library for image preprocessing and color analysis using the perceptually uniform CIELAB color space.

---

✨ Features

✅ RGB ➡️ LAB / Lch conversion
✅ CLAHE, PCA, false color filters
✅ Background removal via pixel std deviation
✅ Cluster-based segmentation: KMeans, GaussianMixture, Agglomerative
✅ Histogram, PDF, and scatter plot visualization
✅ CSV export of processed image stats
✅ Clean and modular structure for reuse

---

📦 Installation

From PyPI

pip install cie-utils

From GitHub

pip install git+https://github.com/jarh1992/cie-utils.git

From local source (for development)

# Using Poetry (recommended for development)
poetry install

# Or using pip
pip install .

---

🧪 Example Usage

from cie-utils import normalize_img, rgb2lab

lab_img = rgb2lab(normalize_img(img, ref_img))

---

🧰 Development & Code Style

This project uses:

• 🖤 black for code formatting
• 🔠 isort for import sorting
• 🧼 flake8 for linting
• ✅ pytest for testing
• 🧪 pre-commit hooks enabled in .pre-commit-config.yaml

To install dev dependencies:

pip install -e .[dev]
pre-commit install

---

📚 Documentation

Documentation is automatically generated with Sphinx and hosted via GitHub Pages at:

👉 https://jarh1992.github.io/cie-utils/

---

📝 License

MIT License. See LICENSE for details.