121 lines
3.3 KiB
Markdown
121 lines
3.3 KiB
Markdown
|
# 采样点地图功能使用说明
|
|||
|
|
|
|||
|
|
## 功能概述
|
|||
|
|
|
|||
|
|
本系统新增了采样点地图生成功能，可以在高光谱假彩色影像上标注采样点位置，并添加专业的地图要素。
|
|||
|
|
|
|||
|
|
## 主要功能
|
|||
|
|
|
|||
|
|
### 1. SamplingPointMap 类 (`src/postprocessing/point_map.py`)
|
|||
|
|
|
|||
|
|
**核心功能：**
|
|||
|
|
- 读取高光谱影像并生成假彩色RGB图像
|
|||
|
|
- 读取CSV文件中的采样点坐标（前两列为**纬度、经度**）
|
|||
|
|
- 在影像上标注红色采样点
|
|||
|
|
- 添加**指北针**、**比例尺**和**图例**
|
|||
|
|
- 支持地理坐标转换
|
|||
|
|
|
|||
|
|
### 2. Visualization Reports 集成 (`src/postprocessing/visualization_reports.py`)
|
|||
|
|
|
|||
|
|
**新增方法：**
|
|||
|
|
- `generate_sampling_point_map()`：生成采样点地图
|
|||
|
|
- `generate_all_visualizations()`：生成所有可视化结果
|
|||
|
|
|
|||
|
|
### 3. GUI 集成 (`src/gui/water_quality_gui.py`)
|
|||
|
|
|
|||
|
|
**可视化分析页面新增：**
|
|||
|
|
- 复选框："生成采样点地图"
|
|||
|
|
- 按钮："📍 生成采样点地图"
|
|||
|
|
- 按钮："👁️ 查看采样点地图"
|
|||
|
|
|
|||
|
|
## 使用方法
|
|||
|
|
|
|||
|
|
### 1. 通过GUI使用
|
|||
|
|
|
|||
|
|
1. 打开**可视化分析**页面
|
|||
|
|
2. 勾选"生成采样点地图"
|
|||
|
|
3. 点击"📍 生成采样点地图"按钮
|
|||
|
|
4. 系统会自动：
|
|||
|
|
- 查找高光谱影像文件（.dat, .bsq, .tif等）
|
|||
|
|
- 查找 `4_processed_data` 文件夹中的CSV文件
|
|||
|
|
- 生成带采样点的地图
|
|||
|
|
- 保存至 `9_visualization/sampling_maps/` 目录
|
|||
|
|
|
|||
|
|
### 2. 编程调用
|
|||
|
|
|
|||
|
|
```python
|
|||
|
|
from src.postprocessing.point_map import SamplingPointMap
|
|||
|
|
from src.postprocessing.visualization_reports import WaterQualityVisualization
|
|||
|
|
|
|||
|
|
# 方法1：直接使用SamplingPointMap
|
|||
|
|
map_generator = SamplingPointMap(output_dir="./point_maps")
|
|||
|
|
map_path = map_generator.create_sampling_point_map(
|
|||
|
|
hyperspectral_path="path/to/hyperspectral.dat",
|
|||
|
|
csv_path="path/to/sampling_points.csv",
|
|||
|
|
point_color='red',
|
|||
|
|
point_size=100,
|
|||
|
|
show_north_arrow=True,
|
|||
|
|
show_scale_bar=True,
|
|||
|
|
show_legend=True
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
# 方法2：通过VisualizationReports
|
|||
|
|
viz = WaterQualityVisualization(output_dir="./9_visualization")
|
|||
|
|
map_path = viz.generate_sampling_point_map(
|
|||
|
|
hyperspectral_path="path/to/hyperspectral.dat",
|
|||
|
|
csv_path="path/to/sampling_points.csv"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
# 方法3：生成所有可视化
|
|||
|
|
results = viz.generate_all_visualizations(work_dir="./work_dir")
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## CSV文件格式要求
|
|||
|
|
|
|||
|
|
CSV文件必须满足以下格式：
|
|||
|
|
- **前两列**分别为**纬度**和**经度**
|
|||
|
|
- 使用**逗号分隔**
|
|||
|
|
- 必须包含有效的数值
|
|||
|
|
|
|||
|
|
**示例：**
|
|||
|
|
```csv
|
|||
|
|
latitude,longitude,parameter1,parameter2
|
|||
|
|
31.2345,121.4567,25.5,3.2
|
|||
|
|
31.2350,121.4570,26.1,3.5
|
|||
|
|
31.2360,121.4580,24.8,2.9
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 输出目录结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
work_dir/
|
|||
|
|
├── 1_water_mask/
|
|||
|
|
│ └── hsi_preview.png # 高光谱预览图
|
|||
|
|
├── 4_processed_data/
|
|||
|
|
│ └── processed_data.csv # 处理后的数据
|
|||
|
|
├── 9_visualization/
|
|||
|
|
│ ├── glint_deglint_previews/ # 掩膜和耀斑缩略图
|
|||
|
|
│ └── sampling_maps/ # 采样点地图
|
|||
|
|
│ └── hyperspectral_sampling_map.png
|
|||
|
|
└── ...
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 地图要素
|
|||
|
|
|
|||
|
|
- **红色圆点**：采样点位置
|
|||
|
|
- **指北针**：指示北方
|
|||
|
|
- **比例尺**：显示实际距离
|
|||
|
|
- **图例**：说明采样点数量
|
|||
|
|
- **标题**：清晰的地图标题
|
|||
|
|
|
|||
|
|
## 依赖库
|
|||
|
|
|
|||
|
|
- GDAL (地理坐标转换)
|
|||
|
|
- matplotlib (绘图)
|
|||
|
|
- pandas (CSV处理)
|
|||
|
|
- numpy (数值计算)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**注意**：确保工作目录中包含高光谱影像文件和处理后的CSV文件。
|