355 lines
9.9 KiB
Markdown
355 lines
9.9 KiB
Markdown
# BRDF_GUI 项目交接文档
|
||
|
||
---
|
||
|
||
## 1. 项目概述
|
||
|
||
### 1.1 项目基本信息
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| **项目名称** | BRDF_GUI |
|
||
| **项目类型** | 高光谱图像处理软件 |
|
||
| **主要功能** | BRDF（双向反射分布函数）校正 |
|
||
| **开发语言** | Python 3.9+ |
|
||
| **GUI框架** | PyQt5 |
|
||
| **许可证** | GNU GPL v3.0 |
|
||
|
||
### 1.2 项目背景
|
||
本项目是一个用于遥感数据BRDF校正的综合性工具集，主要处理高光谱图像中的观测和光照几何效应，支持从机载（AVIRIS、AVIRIS-NG）和星载传感器获取的数据。
|
||
|
||
### 1.3 核心功能模块
|
||
1. **ocbrdf** - 水体/海洋BRDF校正模块（基于EUMETSAT/OLCI算法）
|
||
2. **Flexbrdf (HyTools)** - 陆地BRDF校正和通用高光谱图像处理库
|
||
3. **GUI** - 基于PyQt5的图形用户界面
|
||
|
||
---
|
||
|
||
## 2. 项目结构
|
||
|
||
```
|
||
BRDF_GUI/
|
||
├── .idea/ # PyCharm配置目录
|
||
├── GUI/ # GUI应用程序
|
||
│ ├── brdf_gui.py # 主GUI程序 (1303行)
|
||
│ └── DESIGN.md # UI设计规范文档
|
||
├── ocbrdf/ # 海洋BRDF校正模块
|
||
│ ├── ocbrdf_main3.py # 主BRDF校正模块 (908行)
|
||
│ ├── brdf_model_O25.py # O25 BRDF模型
|
||
│ ├── brdf_model_M02.py # Morel et al. (2002)模型
|
||
│ ├── brdf_model_M02SeaDAS.py # SeaDAS变体
|
||
│ ├── brdf_model_L11.py # Lee et al. (2011)模型
|
||
│ ├── brdf_utils.py # 工具函数
|
||
│ ├── Raman.py # 拉曼散射校正
|
||
│ ├── aviris.py # AVIRIS数据处理
|
||
│ └── src/ # 其他源文件
|
||
├── Flexbrdf/ # HyTools库（陆地BRDF）
|
||
│ ├── setup.py # 包安装配置
|
||
│ ├── README.md # 英文文档
|
||
│ ├── hytools/ # 核心库包
|
||
│ │ ├── base.py # 主类
|
||
│ │ ├── brdf/ # BRDF校正模块
|
||
│ │ ├── io/ # 输入输出模块
|
||
│ │ ├── topo/ # 地形校正
|
||
│ │ ├── glint/ # 镜面反射校正
|
||
│ │ ├── masks/ # 掩膜工具
|
||
│ │ └── transform/ # 光谱变换
|
||
│ ├── scripts/ # 命令行脚本
|
||
│ └── examples/ # 示例和教程
|
||
└── requirements.txt # 项目依赖
|
||
```
|
||
|
||
---
|
||
|
||
## 3. 技术栈与依赖
|
||
|
||
### 3.1 核心技术
|
||
| 技术 | 版本 | 用途 |
|
||
|------|------|------|
|
||
| Python | 3.9+ | 主要开发语言 |
|
||
| PyQt5 | - | GUI框架 |
|
||
| NumPy | >=1.21.0 | 数值计算 |
|
||
| xarray | >=0.20.0 | 多维数据数组处理 |
|
||
| rasterio | >=1.2.0 | 地理空间栅格IO |
|
||
| spectral | >=0.22.0 | ENVI文件处理 |
|
||
| Ray | >=2.0.0 | 分布式并行处理 |
|
||
| scikit-learn | >=1.0.0 | 机器学习工具 |
|
||
| SciPy | >=1.7.0 | 科学计算 |
|
||
| pandas | >=1.3.0 | 数据处理 |
|
||
| matplotlib | >=3.5.0 | 可视化 |
|
||
| h5py/h5netcdf | >=3.0.0 | HDF5和NetCDF支持 |
|
||
|
||
### 3.2 安装依赖
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
---
|
||
|
||
## 4. 模块详细说明
|
||
|
||
### 4.1 ocbrdf模块（水体BRDF校正）
|
||
|
||
#### 功能描述
|
||
专门用于水体/海洋高光谱数据的BRDF校正，支持多种BRDF模型。
|
||
|
||
#### 核心文件
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `ocbrdf_main3.py` | 主校正引擎，读取ENVI BSQ文件，处理xarray数据集 |
|
||
| `brdf_model_O25.py` | O25模型（EUMETSAT BRDF4OLCI 2024） |
|
||
| `brdf_model_M02.py` | Morel et al. (2002)模型，使用f/Q查找表 |
|
||
| `brdf_model_L11.py` | Lee et al. (2011)模型，使用QAA v6反演 |
|
||
| `brdf_utils.py` | 多项式求解器、坐标处理等工具函数 |
|
||
| `Raman.py` | 拉曼散射校正 |
|
||
| `aviris.py` | AVIRIS数据IO工具 |
|
||
|
||
#### 数据要求
|
||
- **输入格式**: ENVI BSQ, xarray Dataset
|
||
- **必需波段**: 442nm, 490nm, 560nm, 665nm（根据模型不同有所变化）
|
||
- **输出**: 标准化遥感反射率(nrrs)、BRDF校正因子、不确定性估计
|
||
|
||
#### 关键算法参数
|
||
- **角度约定**: OLCI约定，相对方位角(raa=0表示太阳和观测在同一侧)
|
||
- **LUT路径**: 期望在模块位置相对的`BRDF_LUTs/BRDF_{model}.nc`路径
|
||
|
||
### 4.2 Flexbrdf/HyTools模块（陆地BRDF校正）
|
||
|
||
#### 功能描述
|
||
通用高光谱图像处理库，支持BRDF、地形和镜面反射校正。
|
||
|
||
#### 核心算法
|
||
| 类型 | 算法 |
|
||
|------|------|
|
||
| BRDF校正 | FlexBRDF、Universal BRDF |
|
||
| 地形校正 | SCS、SCS+C、Cosine、C、Mod-Minnaert |
|
||
| 镜面反射校正 | Hochberg 2003、Hedley 2005、Gao 2021 |
|
||
|
||
#### 数据格式支持
|
||
- ENVI格式
|
||
- NEON AOP HDF5
|
||
- NetCDF（EMIT、AVIRIS-NG）
|
||
|
||
#### 核心文件
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `hytools/base.py` | HyTools主类，高光谱数据IO和处理 |
|
||
| `hytools/brdf/flex.py` | FlexBRDF算法实现 |
|
||
| `hytools/brdf/kernels.py` | Ross Thick、Li Dense、Roujean核函数 |
|
||
| `hytools/io/envi.py` | ENVI文件读写 |
|
||
| `hytools/io/neon.py` | NEON AOP HDF5支持 |
|
||
| `hytools/io/netcdf.py` | NetCDF格式支持 |
|
||
|
||
#### 并行处理
|
||
- 使用Ray进行分布式计算
|
||
- `no_ray/`目录包含单进程版本脚本
|
||
|
||
### 4.3 GUI模块
|
||
|
||
#### 功能描述
|
||
基于PyQt5的图形用户界面，提供BRDF校正工作流的可视化操作。
|
||
|
||
#### 主要功能
|
||
- 掩膜条件编辑器（7种掩膜类型）
|
||
- ndi: 归一化差异指数掩膜
|
||
- ancillary: 辅助数据掩膜
|
||
- neon_edge: NEON边缘掩膜
|
||
- kernel_finite: 核函数有限性掩膜
|
||
- water: 水体掩膜
|
||
- external: 外部掩膜
|
||
- band: 波段掩膜
|
||
- BRDF配置界面
|
||
- JSON配置生成
|
||
- 文件选择对话框
|
||
- 暗色主题UI（NVIDIA设计风格）
|
||
|
||
#### 设计规范
|
||
- 主色调: 深灰色背景 + 绿色(#76b900)强调色
|
||
- 工业风格字体
|
||
- 参见 `GUI/DESIGN.md`
|
||
|
||
---
|
||
|
||
## 5. 配置说明
|
||
|
||
### 5.1 JSON配置系统
|
||
项目使用基于JSON的配置系统进行批处理。
|
||
|
||
#### 配置文件示例位置
|
||
```
|
||
Flexbrdf/examples/configs/
|
||
├── aviris.json
|
||
├── brdf_glint_correct_config.json
|
||
├── glint_correct_config.json
|
||
├── topo_brdf_glint_correct_config.json
|
||
└── ...
|
||
```
|
||
|
||
#### 配置生成脚本
|
||
```
|
||
Flexbrdf/scripts/configs/
|
||
├── image_correct_json_generate.py
|
||
├── image_correct_json_generate_gui.py
|
||
├── trait_estimate_json_generate.py
|
||
└── plsr_model_format_v0_1.py
|
||
```
|
||
|
||
### 5.2 环境要求
|
||
- **输入数据**: 高光谱图像（ENVI、HDF5或NetCDF格式）
|
||
- **辅助数据**: 太阳/传感器几何角度（SZA、SAA、VZA、VAA、RAA）
|
||
- **可选数据**: 地形数据（坡度、坡向）用于地形校正
|
||
- **查找表**: BRDF LUT以NetCDF格式存储（需单独获取）
|
||
|
||
---
|
||
|
||
## 6. 使用说明
|
||
|
||
### 6.1 安装步骤
|
||
|
||
1. **克隆/解压项目**
|
||
```bash
|
||
cd BRDF_GUI
|
||
```
|
||
|
||
2. **安装依赖**
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
3. **安装HyTools包（可选）**
|
||
```bash
|
||
cd Flexbrdf
|
||
pip install -e .
|
||
```
|
||
|
||
### 6.2 运行方式
|
||
|
||
#### GUI模式
|
||
```bash
|
||
python GUI/brdf_gui.py
|
||
```
|
||
|
||
#### 命令行模式（ocbrdf）
|
||
```bash
|
||
python ocbrdf/ocbrdf_main3.py --config config.json
|
||
```
|
||
|
||
#### 命令行模式（FlexBRDF）
|
||
```bash
|
||
cd Flexbrdf
|
||
python scripts/flex_main.py --config config.json
|
||
```
|
||
|
||
### 6.3 常用脚本
|
||
|
||
| 脚本 | 功能 |
|
||
|------|------|
|
||
| `image_correct.py` | 图像校正 |
|
||
| `brdf_correct_bip.py` | BRDF校正（BIP格式） |
|
||
| `rad2reflectance.py` | 辐射度转反射率 |
|
||
| `neon2envi.py` | NEON格式转ENVI |
|
||
| `transform.py` | 光谱变换 |
|
||
| `trait_estimate.py` | 性状估计 |
|
||
|
||
---
|
||
|
||
## 7. 开发团队与版权
|
||
|
||
### 7.1 核心开发者
|
||
- **HyTools**: Adam Chlus (JPL), Zhiwei Ye, Ting Zheng, Natalie Queally, Evan Greenberg, Philip Townsend (威斯康星大学麦迪逊分校)
|
||
- **ocbrdf**: 基于EUMETSAT BRDF4OLCI研究（合同号 RB_EUM-CO-21-4600002626-JIG）
|
||
|
||
### 7.2 许可证
|
||
GNU General Public License v3.0
|
||
|
||
### 7.3 引用信息
|
||
参见 `Flexbrdf/CITATION.cff`
|
||
|
||
---
|
||
|
||
## 8. 文档资源
|
||
|
||
### 8.1 中文文档
|
||
- `Flexbrdf/examples/FlexBRDF_tutorial.md` - FlexBRDF中文教程
|
||
|
||
### 8.2 英文文档
|
||
- `Flexbrdf/README.md` - 库文档和基本使用
|
||
- `Flexbrdf/docs/` - Sphinx API文档
|
||
|
||
### 8.3 设计文档
|
||
- `GUI/DESIGN.md` - UI设计规范
|
||
|
||
---
|
||
|
||
## 9. 重要注意事项
|
||
|
||
### 9.1 BRDF LUT路径
|
||
ocbrdf模块期望在以下位置找到BRDF查找表：
|
||
```
|
||
BRDF_LUTs/BRDF_{model}.nc
|
||
```
|
||
（相对于模块位置）
|
||
|
||
### 9.2 角度约定
|
||
- 使用OLCI约定
|
||
- 相对方位角(raa)=0表示太阳和观测在同一侧
|
||
|
||
### 9.3 并行处理
|
||
- FlexBRDF使用Ray进行分布式计算
|
||
- 如不需要并行，可使用`no_ray/`目录下的单进程脚本
|
||
|
||
### 9.4 数据格式兼容性
|
||
- 确保输入数据格式正确（ENVI BSQ、HDF5或NetCDF）
|
||
- 几何角度数据必须正确配准
|
||
|
||
### 9.5 内存要求
|
||
- 高光谱数据体积大，确保有足够的系统内存
|
||
- 建议使用分块处理大文件
|
||
|
||
---
|
||
|
||
## 10. 常见问题与解决方案
|
||
|
||
### Q1: 找不到BRDF查找表
|
||
**解决方案**: 确保`BRDF_LUTs/`目录存在，并包含对应的`.nc`文件
|
||
|
||
### Q2: GUI启动失败
|
||
**解决方案**: 检查PyQt5是否正确安装：`pip install PyQt5`
|
||
|
||
### Q3: 内存不足错误
|
||
**解决方案**: 使用分块处理脚本或增加系统内存
|
||
|
||
### Q4: 角度数据格式错误
|
||
**解决方案**: 检查输入的角度数据是否符合OLCI约定
|
||
|
||
---
|
||
|
||
## 11. 后续开发建议
|
||
|
||
### 11.1 可能的改进方向
|
||
1. 添加更多BRDF模型支持
|
||
2. 优化大文件处理性能
|
||
3. 增强GUI的批量处理能力
|
||
4. 添加更多可视化功能
|
||
5. 支持更多传感器类型
|
||
|
||
### 11.2 维护建议
|
||
1. 定期更新依赖包版本
|
||
2. 保持与最新Python版本兼容
|
||
3. 持续完善文档
|
||
4. 添加更多单元测试
|
||
|
||
---
|
||
|
||
## 12. 联系方式
|
||
|
||
如有问题，请参考：
|
||
- 项目文档：`Flexbrdf/README.md`
|
||
- 中文教程：`Flexbrdf/examples/FlexBRDF_tutorial.md`
|
||
- API文档：`Flexbrdf/docs/`
|
||
|
||
---
|
||
|
||
**文档生成日期**: 2026年4月10日
|
||
**文档版本**: v1.0
|
||
**项目状态**: 交接完成
|