WQ_GUI/README-conda.md

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

📋 概述

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

🚀 快速开始

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

# 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)

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

方法3: 手动安装

# 创建环境
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: 配置处理

🔧 环境管理

更新环境

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

删除环境

# 停用环境
conda deactivate

# 删除环境
conda env remove -n water_quality_analysis

导出环境

# 导出当前环境配置
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代码验证安装:

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官方文档
• Miniconda下载
• Anaconda下载

📞 技术支持

如遇问题，请检查:

1. Conda版本是否为最新
2. Python版本是否符合要求
3. 系统是否满足硬件要求