# 水质参数反演分析系统 - Conda环境安装指南

## 📋 概述

本项目提供完整的Conda环境配置，支持一键安装所有依赖包。

## 🚀 快速开始

### 方法1: 使用环境配置文件 (推荐)

```bash
# 1. 克隆或下载项目
# 2. 进入项目目录
cd fengzhuang

# 3. 创建Conda环境 (自动安装所有依赖)
conda env create -f environment.yml

# 4. 激活环境
conda activate water_quality_analysis

# 5. 运行程序
python src/gui/water_quality_gui.py
```

### 方法2: 使用批处理脚本 (Windows)

```cmd
# 双击运行或在命令行执行
scripts\setup_conda_env.bat
```

### 方法3: 手动安装

```bash
# 创建环境
conda create -n water_quality_analysis python=3.8

# 激活环境
conda activate water_quality_analysis

# 安装依赖包
conda install -c conda-forge --file requirements-conda.txt
```

## 📦 依赖包说明

### 核心依赖

- **Python 3.8+**: 运行环境
- **PyQt5**: GUI界面框架
- **NumPy, SciPy, Pandas**: 科学计算基础库
- **Scikit-learn**: 机器学习算法
- **XGBoost, LightGBM**: 梯度提升算法

### 地理空间处理

- **GDAL**: 地理数据处理
- **Rasterio**: 栅格数据处理
- **GeoPandas**: 地理数据分析
- **Shapely**: 几何运算
- **PyProj**: 坐标系转换

### 图像和可视化

- **OpenCV**: 计算机视觉
- **Pillow**: 图像处理
- **Matplotlib, Seaborn**: 数据可视化
- **Spectral**: 光谱数据处理

### 工具库

- **Joblib**: 并行计算
- **PyWavelets**: 小波变换
- **TQDM**: 进度条
- **PyYAML**: 配置处理

## 🔧 环境管理

### 更新环境

```bash
# 更新所有包到最新版本
conda env update -f environment.yml
```

### 删除环境

```bash
# 停用环境
conda deactivate

# 删除环境
conda env remove -n water_quality_analysis
```

### 导出环境

```bash
# 导出当前环境配置
conda env export > environment_export.yml
```

## 🐛 故障排除

### 常见问题

1. **Conda命令找不到**
   - 确保已安装Miniconda或Anaconda
   - 重启命令行窗口

2. **包安装失败**
   - 检查网络连接
   - 尝试更换conda源: `conda config --add channels conda-forge`

3. **环境激活失败**
   - Windows: 使用 `conda activate water_quality_analysis` (非 `activate`)
   - Linux/Mac: 确保conda已正确初始化

4. **PyQt5显示问题**
   - Linux: 安装系统依赖 `sudo apt-get install qt5-default`
   - Mac: 确保XQuartz已安装

### 验证安装

运行以下Python代码验证安装:

```python
import numpy as np
import pandas as pd
import matplotlib.pyplot as plt
import sklearn
import PyQt5
import gdal
import rasterio
import geopandas

print("所有依赖包安装成功!")
```

## 📚 相关链接

- [Conda官方文档](https://docs.conda.io/)
- [Miniconda下载](https://docs.conda.io/en/latest/miniconda.html)
- [Anaconda下载](https://www.anaconda.com/products/distribution)

## 📞 技术支持

如遇问题，请检查:
1. Conda版本是否为最新
2. Python版本是否符合要求
3. 系统是否满足硬件要求