# 08_histogram_equalization_gui

**Repository Path**: xiao_pacai/08_histogram_equalization_gui

## Basic Information

- **Project Name**: 08_histogram_equalization_gui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 直方图均衡化教学软件

本项目是一个 Python GUI 课程设计示例，用 PyQt5 实现数字图像处理中“直方图均衡化”的教学演示。软件包含图像显示区、代码区和操作区，支持本地图像加载、处理结果保存、步骤切换、参数化动态预览和辅助分析图形显示。

## 功能点

- 本地图像加载与当前处理结果保存
- 至少 6 个独立教学步骤：导入图像、灰度化、直方图统计、CDF 计算、全局直方图均衡化、参数化动态预览
- 每一步同步显示相关 Python 算法代码
- 图像显示区展示原始图像、中间结果、直方图、CDF、LUT 等辅助分析图
- 操作区包含“上一步”“下一步”按钮，启动时“上一步”禁用，最后一步“下一步”禁用
- 可调参数：直方图箱数、均衡强度
- 大图加载后使用预览图进行教学显示与分析，减少切换步骤和拖动参数时的卡顿；保存时按原图尺寸重新计算结果
- 后台算法模块可独立单元测试

## 项目结构

```text
.
├── main.py
├── gui/
│   └── main_window.py
├── src/
│   └── image_processing.py
├── scripts/
│   └── generate_assets.py
├── tests/
│   └── test_image_processing.py
├── assets/
│   ├── sample_low_contrast.png
│   └── sample_gradient.png
├── requirements.txt
└── README.md
```

## 运行方法

```bash
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python scripts/generate_assets.py
python main.py
```

## 测试方法

```bash
python -m unittest discover -s tests
```

也可以使用 pytest：

```bash
pytest
```