Files
WQ_GUI/README-conda.md
2026-04-08 15:25:08 +08:00

153 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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