# 开始处理

导入图像、标记校准目标并配置项目设置后，您即可开始处理。本页面将指导您启动 Chloros 处理流程。

## 预处理检查清单

在点击“开始”按钮之前，请确认一切就绪：

* [ ] **文件已导入** - 所有图像均显示在文件浏览器中
* [ ] **目标图像已标记** - 已勾选校准图像的“目标”列
* [ ] **相机型号已检测** - “相机型号”列显示正确的相机信息
* [ ] **设置已配置** - 已检查并调整项目设置
* [ ] **已选择指数** - 已添加所需的多光谱指数（如需）
* [ ] **已选择导出格式** - 已选择适合您工作流的输出格式

{% hint style="info" %}
**提示**：在处理前，请在文件浏览器中点击查看几张图像，以确认它们已正确加载。
{% endhint %}

***

## 开始处理

### 查找“开始”按钮

“开始/播放”按钮位于 Chloros 的顶部标题栏中：

* 位置：窗口顶部中央
* 图标：**播放/开始按钮** <img src="https://1705307155-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6ABwztcllVnVPmRgKX9u%2Fuploads%2Fgit-blob-f2c979bf207de77595b954b2e024193c960e51e7%2Fimage%20(2)%20(1).png?alt=media" alt="" data-size="line">
* 状态：准备好处理时，按钮处于启用状态（亮起）

### 点击开始

1. 点击顶部标题栏中的 **播放/开始按钮**
2. 处理立即开始
3. 处理过程中，按钮变为禁用状态（灰色）
4. 进度条实时更新，显示处理状态

{% hint style="success" %}
**处理已启动**：点击后，Chloros 将自动处理所有步骤——目标检测、去拜耳化、校准、索引计算和导出。
{% endhint %}

***

## 了解处理模式

Chloros 根据您的许可证提供两种不同的处理模式：

### 免费模式（顺序处理）

**所有用户均可使用**

**工作原理：**

* 逐张顺序处理图像
* 单线程操作
* 内存占用较低

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

1.**目标检测** - 扫描校准目标 2. **处理** - 应用校准并导出图像**处理时间：**

* 比 Chloros+ 并行模式慢得多
* 适用于中小型数据集（< 200 张图像）

### Chloros+ 模式（并行处理）

**需 Chloros+ 许可证**

**工作原理：**

* 通过 [4 线程处理管道](https://mapir.gitbook.io/chloros/zh-tw/chu-li-jia-gou/processing-pipeline) 同时处理多张图像
* [动态计算适配](https://mapir.gitbook.io/chloros/zh-tw/chu-li-jia-gou/dynamic-compute-adaptation) 会根据您的硬件自动选择最佳策略
* 支持 NVIDIA 显卡（台式机和 Jetson）的 GPU（CUDA）加速
* 支持从 Jetson Nano（1 个工作线程）到配备 12GB+ GPU 的台式机（3-4 个工作线程）的扩展

**进度条显示 4 个阶段**（对应 4 个管道线程）：

1. **检测**（线程 1）- 查找校准目标
2. **分析**（线程 2）- 检查图像元数据并计算校准
3. **校准**（线程 3）- GPU 去拜耳化、暗角校正、索引计算
4. **导出**（线程 4）——保存处理后的图像和索引**进度条交互：**\* **将鼠标悬停**在进度条上，查看详细的 4 阶段下拉面板

* **点击**进度条，将下拉面板固定在当前位置
* **再次点击**以解除固定并隐藏面板**处理时间：**
* 比免费模式快得多
* 处理速度随 CPU 核心数增加而提升
* GPU 加速可进一步提高速度

{% hint style="info" %}
**Chloros+ 速度**：对于大型数据集，并行处理速度可达顺序模式的 5-10 倍。一个在免费模式下需 2 小时完成的 500 张图像项目，使用 Chloros+ 可能仅需 15-20 分钟即可完成。
{% endhint %}

***

## 处理过程中发生什么

### 第一阶段：目标检测

**Chloros 的作用：**

* 扫描已标记的目标图像（若无标记则扫描所有图像）
* 识别每个目标中的 4 个校准面板
* 从目标面板中提取反射率值
* 记录目标时间戳以安排校准

**耗时：** 1-30 秒（带标记目标），5-30+ 分钟（无标记）

### 阶段 2：去拜耳化（RAW 转换）

**Chloros 的功能：**

* 将 RAW 拜耳阵列数据转换为完整的 RGB 图像
* 应用高质量去马赛克算法
* 最大限度保留图像质量与细节

**耗时：** 取决于图像数量和 CPU 速度

### 第三阶段：校准

**Chloros 的功能：**\* **暗角校正**：消除边缘处的镜头暗角

* **反射率校准**：使用目标反射率值进行标准化
* 对所有波段/通道应用校正
* 根据时间戳为每张图像选用相应的校准目标

**耗时：** 占处理时间的大部分

### 第四阶段：指数计算

**Chloros 的功能：**

* 计算配置的多光谱指数（NDVI、NDRE 等）
* 对校准后的图像应用波段运算
* 为每个选定的指数生成指数图像

**耗时：** 每张图像几秒钟

### 第 5 阶段：导出

**Chloros 的功能：**

* 以选定格式保存校准后的图像
* 导出采用配置 LUT 颜色的指数图像
* 将文件写入相机型号子文件夹
* 保留原始文件名并添加后缀

**耗时：** 取决于导出格式和文件大小\*\*\*

## 处理行为

### 自动处理流程

启动后，整个流程将自动运行：

* 无需用户干预
* 所有配置步骤按顺序执行
* 实时显示进度更新

### 处理期间的计算机资源占用

**自由模式：**

* CPU 占用率相对较低（单线程）
* 计算机仍可响应其他任务
* 可安全最小化 Chloros 并使用其他应用程序

**Chloros+ 并行模式：**

* CPU 占用率高（多线程，最多 16 核）
* 启用 GPU 加速时：GPU 占用率高
* 处理期间计算机响应可能变慢
* 请避免启动其他占用大量 CPU 资源的任务

{% hint style="warning" %}
**性能提示**：为获得最佳 Chloros+ 性能，请关闭其他应用程序，让 Chloros 充分利用系统资源。
{% endhint %}

### 处理过程无法暂停

**重要限制：**

* 处理一旦开始，便无法暂停
* 您可以取消处理，但进度将丢失
* 部分结果不会被保存
* 若取消处理，必须从头开始

**规划提示：** 对于非常大的项目，请考虑分批处理或使用 CLI 以获得更好的控制。\*\*\*

## 监控处理过程

处理运行期间，您可以：

* **查看进度条** - 查看总体完成百分比
* **查看当前阶段** - 检测、分析、校准或导出
* **查看日志选项卡** - 查看详细的处理消息和警告
* **预览已完成的图像** - 某些导出文件可能在处理过程中显示

有关监控的详细信息，请参阅 [监控处理](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/monitoring-the-processing)。

***

## 取消处理

如果您需要停止处理：

### 如何取消

1. 找到 **停止/取消按钮**（处理过程中该按钮会替换“开始”按钮）
2. 点击“停止”按钮
3. 处理将立即停止
4. 部分结果将被丢弃

### 何时取消

**有效的取消理由：**

* 发现使用了错误的设置
* 忘记标记目标图像
* 导入的图像有误
* 系统运行过慢或无响应

**取消后：**

* 检查并修复任何问题
* 根据需要调整设置
* 从头开始重新处理
* 为了获得最佳体验，请完全关闭 Chloros 并重新启动

{% hint style="warning" %}
**无部分处理结果**：取消操作将丢弃所有进度。Chloros 不会保存部分处理过的图像。
{% endhint %}

***

## 处理时间估算

实际处理时间因以下因素而差异显著：

* 图像数量
* 图像分辨率
* 输入格式（RAW 与 JPG）
* 处理模式（免费版与 Chloros+）
* CPU 速度和核心数
* GPU 可用性（仅限 Chloros+）
* 需计算的索引数量
* 导出格式的复杂程度

### 粗略估算（Chloros+，1200万像素图像，现代CPU）

| 图像数量     | 免费模式     | Chloros+ (CPU) | Chloros+ (GPU) |
| -------- | -------- | -------------- | -------------- |
| 50 张图像   | 15-20 分钟 | 5-8 分钟         | 3-5 分钟         |
| 100 张图片  | 30-40 分钟 | 10-15 分钟       | 5-8 分钟         |
| 200 张图片  | 1-1.5 小时 | 20-30 分钟       | 10-15 分钟       |
| 500 张图像  | 2-3 小时   | 45-60 分钟       | 20-30 分钟       |
| 1000 张图像 | 4-6 小时   | 1.5-2 小时       | 40-60 分钟       |

{% hint style="info" %}
**首次运行**：由于 Chloros 需要构建缓存和配置文件，初始处理可能需要更长时间。后续处理类似数据集的速度会更快。
{% endhint %}

***

## 启动时的常见问题

### 启动按钮不可用（呈灰色）

**可能原因：**

* 未导入图像
* 后端未完全启动
* 之前的处理仍在运行
* 项目未完全加载

**解决方案：**

1. 等待后端完全初始化（检查主菜单图标）
2. 确认图像已在文件浏览器中导入
3. 若按钮仍处于禁用状态，请重启 Chloros
4. 检查调试日志中的错误信息

### 处理开始后立即失败

**可能原因：**

* 项目中没有有效图像
* 图像文件损坏
* 磁盘空间不足
* 内存（RAM）不足

**解决方案：**

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. 尝试处理较小的图像子集
4. 确认图像未损坏

### “未检测到目标”警告

**可能原因：**

* 忘记标记目标图像
* 目标图像中不包含可见目标
* 目标检测设置过于严格

**解决方案：**

1. 参阅 [选择目标图像](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/choosing-target-images)
2. 在“目标”列中标记相应的图像
3. 确认标记的图像中可见目标
4. 如有必要，调整目标检测设置

***

## 成功处理的提示

### 开始前

1. **先用少量样本测试** - 处理 10-20 张图像以验证设置
2. **检查可用磁盘空间** - 确保有 2-3 倍数据集大小的空闲空间
3. **关闭不必要的应用程序** - 释放系统资源
4. **验证目标图像** - 预览已标记的目标以确保质量
5. **保存项目** - 项目会自动保存，但建议手动保存

### 处理过程中

1. **避免系统休眠** - 禁用省电模式
2. **保持 Chloros 在前台运行** - 或至少确保其在任务栏中可见
3. **不时监控进度** - 检查是否有警告或错误
4. **不要运行其他占用资源的应用程序** - 特别是在 Chloros+ 并行模式下

### Chloros+ GPU 加速

如果使用 NVIDIA GPU 加速：

1. 将 NVIDIA 驱动程序更新至最新版本
2. 确保 GPU 拥有 4GB 及以上显存
3. 关闭占用大量 GPU 资源的应用程序（游戏、视频编辑）
4. 监控 GPU 温度（确保散热充足）

***

## 后续步骤

处理开始后：

1. **监控进度** - 参见 [监控处理过程](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/monitoring-the-processing)
2. **等待完成** - 处理过程将自动运行
3. **查看结果** - 参见 [处理完成](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/finishing-the-processing)

有关处理期间的操作指南，请参见 [监控处理过程](https://mapir.gitbook.io/chloros/zh-tw/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/monitoring-the-processing)。
