Initial commit of WQ_GUI

README-conda.md

@@ -0,0 +1,152 @@
+# 水质参数反演分析系统 - 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. 系统是否满足硬件要求