Sovereign 8s.is mirror of standardgalactic/Adaptive_Image_Enhancement
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-08-20 19:39:14 +05:30
cidnet Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
input Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
methods Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
output Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
results Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
retinex Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
.gitignore Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
cidnet_boat.png Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
evaluate.py Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
he.py Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
image_resize.py Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
metrics.py Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
README.md Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
requirements.txt Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30
test_cidnet.py Initial upload of AIEQVM project 2026-08-20 19:39:14 +05:30

Image Enhancement Comparison Framework

Overview

The Image Enhancement Comparison Framework is a standalone benchmarking framework for evaluating classical, deep learning, and quantum-assisted image enhancement algorithms using a unified evaluation pipeline.

The framework automatically processes a set of input images, applies multiple enhancement methods, computes objective image quality metrics, and saves both the enhanced images and evaluation results.


Features

  • Classical image enhancement methods

    • Histogram Equalization (HE)
    • Contrast Limited Adaptive Histogram Equalization (CLAHE)
  • Deep learning methods

    • RetinexFormer
    • CIDNet
  • Quantum-assisted methods

    • Adaptive Image Enhancement through Quantum Variance Maximization (AIEQVM)
  • Automatic computation of image quality metrics

  • Automatic generation of

    • Enhanced images
    • CSV summary
    • Excel summary

Directory Structure

ImageEnhancementComparison/
│
├── input/                     # Input images
│
├── output/                    # Generated results
│   ├── HE/
│   ├── CLAHE/
│   ├── RetinexFormer/
│   ├── CIDNet/
│   └── AIEQVM/
│
├── methods/                   # Wrapper classes for enhancement methods
│
├── retinex/                   # RetinexFormer implementation and weights
│
├── cidnet/                    # CIDNet implementation and weights
│
├── evaluate.py                # Main evaluation script
├── metrics.py                 # Image quality metrics
├── requirements.txt
└── README.md

Installation

Install all required packages.

pip install -r requirements.txt

Input Images

Place all test images inside the input/ directory.

Example:

input/
    Boat.png
    Lena.png
    Cloth.png
    Peppers.png

Supported image formats include

  • PNG
  • JPG
  • JPEG
  • BMP
  • TIFF

Running the Framework

Execute

python evaluate.py

The framework automatically

  1. Reads every image from the input folder.
  2. Applies all enabled enhancement methods.
  3. Computes evaluation metrics.
  4. Saves enhanced images.
  5. Generates CSV and Excel reports.

Output

After execution, the following structure is generated.

output/
│
├── HE/
├── CLAHE/
├── RetinexFormer/
├── CIDNet/
├── AIEQVM/
│
├── metrics_summary.csv
└── metrics_summary.xlsx

Image Quality Metrics

The framework computes the following objective metrics.

Metric Description
Variance Image contrast
CII Contrast Improvement Index
Entropy Information content
PSNR Peak Signal-to-Noise Ratio
SSIM Structural Similarity Index
NIQE Natural Image Quality Evaluator
BRISQUE Blind/Referenceless Image Spatial Quality Evaluator
LPIPS Learned Perceptual Image Patch Similarity

Adding a New Enhancement Method

Create a new wrapper inside the methods/ directory.

Each enhancement method should implement

enhanced_rgb, enhanced_Y, original_Y = enhancer.enhance(image_rgb)

where

  • image_rgb is the RGB input image
  • enhanced_rgb is the enhanced RGB image
  • enhanced_Y is the luminance channel of the enhanced image
  • original_Y is the luminance channel of the original image

After creating the wrapper,

  1. Import the class in evaluate.py.
  2. Instantiate the class.
  3. Add it to the METHODS dictionary.

No further changes are required.


Notes

  • CIDNet is loaded from the locally stored model.safetensors file.
  • RetinexFormer uses locally stored pretrained weights.
  • No internet connection is required after the pretrained models are available locally.

Citation

If you use this framework in your research, please cite the corresponding publications describing the enhancement methods and evaluation metrics.


License

This framework is intended for academic research and educational purposes.