# 监控处理过程 处理开始后，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-hk/chu-li-jia-gou/processing-pipeline)。在支持 GPU 加速的系统上，第 3 线程（校准）将受益于 [动态计算自适应](https://mapir.gitbook.io/chloros/zh-hk/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. 点击左侧边栏中的 **调试日志** 图标 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-hk/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/finishing-the-processing) 2. **检查输出文件夹** - 确认所有文件均已正确导出 3. **查看调试日志** - 检查是否有警告或错误 4. **预览处理后的图像** - 使用图像查看器或外部软件 有关查看和使用处理结果的信息，请参阅 [完成处理](https://mapir.gitbook.io/chloros/zh-hk/tu-xiang-chu-li-tu-xing-yong-hu-jie-mian/finishing-the-processing)。