# 监控处理过程

处理开始后，Chloros 提供了多种方式来监控进度、检查问题以及了解数据集的处理情况。本页面将说明如何跟踪处理过程，并解读 Chloros 提供的信息。

## 进度条概述

顶部标题栏中的进度条显示实时处理状态和完成百分比。

### 免费模式进度条

对于未持有 Chloros+ 许可证的用户：

**两阶段进度显示：**

1.**目标检测** - 在图像中查找校准目标 2. **处理** - 应用校正并导出**进度条显示内容：**

* 总体完成百分比 (0-100%)
* 当前阶段名称
* 简单的水平条形可视化

### Chloros+ 进度条

针对拥有 Chloros+ 许可证的用户：

**4 阶段进度显示：**

1.**检测** - 查找校准目标 2. **分析** - 检查图像并准备处理流程 3. **校准** - 应用暗角和反射率校正 4. **导出** - 保存处理后的文件**交互功能：**\* **将鼠标悬停**在进度条上，查看展开的 4 阶段面板

* **点击**进度条，可冻结/固定展开的面板
* **再次点击**可解除冻结，鼠标移开时自动隐藏
* 每个阶段均显示独立进度（0-100%）

***

## 了解各个处理阶段

{% hint style="info" %}
**管道架构**：这 4 个 GUI 阶段对应于 [4 线程处理管道](https://mapir.gitbook.io/chloros/zh-tw/chu-li-jia-gou/processing-pipeline)。在支持 GPU 加速的系统上，第 3 线程（校准）将受益于 [动态计算自适应](https://mapir.gitbook.io/chloros/zh-tw/chu-li-jia-gou/dynamic-compute-adaptation)，该功能会根据您的具体硬件优化处理过程。
{% endhint %}

### 阶段 1：检测（目标检测）

**正在进行的操作：**

* Chloros 扫描勾选了“目标”复选框的图像
* 计算机视觉算法识别出 4 个校准面板
* 从每个面板中提取反射率值
* 记录目标时间戳以进行正确的校准调度

**耗时：**

* 已标记目标：10-60 秒
* 未标记目标：5-30+ 分钟（扫描所有图像）

**进度指示器：**

* 检测中：0% → 100%
* 已扫描图像数量
* 已发现目标数量

**注意事项：**

* 若目标标记正确，应能快速完成
* 若耗时过长，可能是目标未被标记
* 请检查调试日志中的“Target found”消息

### 第二阶段：分析

**正在进行的操作：**

* 读取图像EXIF元数据（时间戳、曝光设置）
* 根据目标时间戳确定校准策略
* 组织图像处理队列
* 准备并行处理工作者（仅限 Chloros+ 版本）

**耗时：** 5-30 秒**进度指示器：**

* 分析中：0% → 100%
* 快速阶段，通常很快完成

**注意事项：**

* 进度应平稳推进，无停顿
* 缺少元数据的警告将出现在调试日志中

### 第三阶段：校准

**正在进行的操作：**\* **去拜耳化**：将 RAW 拜耳阵列转换为 3 个通道

* **暗角校正**：消除镜头边缘变暗
* **反射率校准**：根据目标值进行标准化
* **指数计算**：计算多光谱指数
* 将每张图像通过完整处理流程进行处理

**耗时：** 占总处理时间的大部分（60-80%）**进度指示器：**

* 校准中：0% → 100%
* 当前正在处理的图像
* 已处理图像 / 总图像数

**处理行为：**\* **自由模式**：按顺序逐张处理图像

* **Chloros+ 模式**：最多可同时处理 16 张图像
* **GPU加速**：显著加快此阶段的处理速度**注意事项：**
* 图像计数应稳定增加
* 检查调试日志中的每张图像完成信息
* 注意有关图像质量或校准问题的警告

### 第4阶段：导出

**正在进行的操作：**

* 以选定格式将校准后的图像写入磁盘
* 导出带有 LUT 色彩的多光谱指数图像
* 创建相机型号子文件夹
* 保留原始文件名并添加相应后缀

**耗时：** 总处理时间的 10-20%**进度指示器：**

* 导出：0% → 100%
* 正在写入的文件
* 导出格式和目标位置

**需关注事项：**

* 磁盘空间警告
* 文件写入错误
* 所有配置输出是否完成

***

## 调试日志选项卡

调试日志提供有关处理进度及遇到的任何问题的详细信息。

### 访问调试日志

1. 点击左侧边栏中的 **调试日志** <img src="https://1705307155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6ABwztcllVnVPmRgKX9u%2Fuploads%2Fgit-blob-af0325f1269e4acd04df8c7f853a661bef5a12df%2Ficon_log.JPG?alt=media" alt="" data-size="line"> 图标
2. 日志面板打开，显示实时处理消息
3. 自动滚动以显示最新消息

### 理解日志消息

#### 信息消息（白色/灰色）

正常处理更新：

```
[INFO] Processing started
[INFO] Target detected in IMG_0015.RAW - 4 panels found
[INFO] Calibrating IMG_0234.RAW
[INFO] Exported NDVI image: IMG_0234_NDVI.tif
[INFO] Processing complete
```

#### 警告消息（黄色）

不影响处理流程的非关键问题：

```
[WARN] No GPS data found in IMG_0145.RAW
[WARN] Target image timestamp gap > 30 minutes
[WARN] Low contrast in calibration panel - results may vary
```

**操作：** 处理完成后查看警告，但不要中断处理

#### 错误消息 (Red)

可能导致处理失败的关键问题：

```
[ERROR] Cannot write file - disk full
[ERROR] Corrupted image file: IMG_0299.RAW
[ERROR] No targets detected - enable reflectance calibration or mark target images
```

**操作：** 停止处理，解决错误，然后重启

### 常见日志消息

| 消息                   | 含义                    | 所需操作           |
| -------------------- | --------------------- | -------------- |
| "在\[文件名]中检测到目标"      | 成功找到校准目标              | 无 - 正常         |
| "正在处理第 X 张图像（共 Y 张）" | 当前进度更新                | 无 - 正常         |
| "未找到目标"              | 未检测到校准目标              | 标记目标图像或禁用反射率校准 |
| "磁盘空间不足"             | 输出存储空间不足              | 释放磁盘空间         |
| "跳过损坏文件"             | 图像文件已损坏               | 从 SD 卡重新复制文件   |
| "已应用 PPK 数据"         | 已应用来自 .daq 文件的 GPS 校正 | 无 - 正常         |

### 复制日志数据

若需复制日志以进行故障排除或寻求支持：

1. 打开“调试日志”面板
2. 点击 **“复制日志”** 按钮（或右键点击 → 选择全部）
3. 粘贴到文本文件或电子邮件中
4. 如有需要，发送至 MAPIR 支持团队

***

## 系统资源监控

### CPU 使用率

**免费模式：**

* 1 个 CPU 核心处于 \~100%
* 其他核心空闲或可用
* 系统保持响应

**Chloros+ 并行模式：**

* 多个核心处于 80-100%（最多 16 个核心）
* 整体 CPU 利用率较高
* 系统响应可能变慢

**监控方法：**

* Windows 任务管理器 (Ctrl+Shift+Esc)
* 性能选项卡 → CPU 部分
* 查找 "Chloros" 或 "chloros-backend" 进程

### 内存 (RAM) 使用情况

**典型使用情况：**

* 小型项目（< 100 张图像）：2-4 GB
* 中型项目（100-500 张图像）：4-8 GB
* 大型项目（500+ 张图像）：8-16 GB
* Chloros+ 并行模式会占用更多内存

**若内存不足：**

* 处理更小的批次
* 关闭其他应用程序
* 若经常处理大型数据集，请升级内存

### GPU 使用情况（Chloros+ 配合 CUDA）

启用 GPU 加速时：

* NVIDIA GPU 显示高利用率（60-90%）
* 显存使用量增加（需 4GB+ 显存）
* 校准阶段速度显著提升

**监控方式：**

* NVIDIA 系统托盘图标
* 任务管理器 → 性能 → GPU
* GPU-Z 或类似监控工具

### 磁盘 I/O

**预期情况：**

* 分析阶段磁盘读取量高
* 导出阶段磁盘写入量高
* SSD 速度显著快于 HDD

**性能提示：**

* 尽可能将项目文件夹存放在 SSD 上
* 处理大型数据集时避免使用网络驱动器
* 确保磁盘空间充足（磁盘空间不足会影响写入速度）

***

## 处理过程中检测问题

### 警告信号

**进度停滞（5 分钟以上无变化）：**

* 检查调试日志中的错误
* 确认可用磁盘空间
* 通过任务管理器确认 Chloros 是否正在运行

**频繁出现错误信息：**

* 停止处理并审查错误
* 常见原因：磁盘空间不足、文件损坏、内存问题
* 请参阅下文的“故障排除”部分

**系统无响应：**

* Chloros+ 并行模式占用过多资源
* 考虑减少并发任务或升级硬件
* 自由模式对资源的消耗较小

### 何时停止处理

若出现以下情况，请停止处理：

* ❌ “磁盘已满”或“无法写入文件”错误
* ❌ 反复出现图像文件损坏错误
* ❌ 系统完全卡死（无响应）
* ❌ 发现配置了错误的设置
* ❌ 导入的图像文件有误

**如何停止：**

1. 点击**停止/取消按钮**（取代“开始”按钮）
2. 处理将停止，进度将丢失
3. 解决问题后从头开始

***

## 处理过程中的故障排除

### 处理速度非常慢

**可能原因：**

* 未标记目标图像（正在扫描所有图像）
* 使用 HDD 而非 SSD 存储
* 系统资源不足
* 配置了过多索引
* 访问网络驱动器

**解决方案：**

1. 若刚启动且处于检测阶段：取消操作，标记目标，重新启动
2. 未来改进：使用 SSD，减少索引数量，升级硬件
3. 处理大型数据集时，考虑使用 CLI 进行批处理

### “磁盘空间不足”警告

**解决方案：**

1. 立即释放磁盘空间
2. 将项目移至空间更大的磁盘
3. 减少待导出的索引数量
4. 使用 JPG 格式代替 TIFF（文件更小）

### 频繁出现“文件损坏”提示

**解决方案：**

1. 从 SD 卡重新复制图像以确保完整性
2. 检测 SD 卡是否存在错误
3. 从项目中移除损坏的文件
4. 继续处理剩余图像

### 系统过热 / 降频

**解决方案：**

1. 确保通风良好
2. 清理计算机通风口的灰尘
3. 降低处理负载（使用“Free”模式代替 Chloros+）
4. 选择一天中较凉爽的时间段进行处理

***

## 处理完成通知

处理完成时：

* 进度条达到 100%
* **“处理完成”** 消息出现在调试日志中
* “开始”按钮再次启用
* 所有输出文件均位于相机型号子文件夹中

***

## 后续步骤

处理完成后：

1. **查看结果** - 参见 [完成处理](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/finishing-the-processing)
2. **检查输出文件夹** - 确认所有文件均已正确导出
3. **查看调试日志** - 检查是否有警告或错误
4. **预览处理后的图像** - 使用图像查看器或外部软件

有关查看和使用处理结果的信息，请参阅 [完成处理](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/finishing-the-processing)。
