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