処理の監視
処理が開始されると、Chlorosでは、進捗状況の監視、問題の確認、およびデータセットの処理状況を把握するためのいくつかの方法が提供されます。このページでは、処理の追跡方法と、Chlorosが提供する情報の解釈方法について説明します。
進捗バーの概要
上部ヘッダーにある進捗バーには、リアルタイムの処理状況と完了率が表示されます。
フリーモードの進捗バー
Chloros+ ライセンスをお持ちでないユーザーの場合：
2段階の進捗表示：
1.ターゲット検出 - 画像内のキャリブレーションターゲットを検出 2. 処理 - 補正の適用とエクスポートプログレスバーに表示される情報：
全体の完了率（0～100%）
現在のステージ名
シンプルな水平バーによる視覚化
Chloros+のプログレスバー
Chloros+ライセンスをお持ちのユーザー向け：
4段階の進行状況表示：
1.検出 - キャリブレーションターゲットの検出 2. 解析 - 画像の検証とパイプラインの準備 3. キャリブレーション - ヴィネット補正および反射率補正の適用 4. エクスポート - 処理済みファイルの保存インタラクティブ機能：* プログレスバーにカーソルを合わせると、4段階の詳細パネルが表示されます
プログレスバーをクリックすると、展開されたパネルが固定されます
再度クリックすると、固定が解除され、マウスが離れると自動的に非表示になります
各段階の進捗状況（0～100%）が個別に表示されます
各処理段階の解説
パイプラインアーキテクチャ：これらの4つのGUIステージは、4スレッド処理パイプラインに対応しています。GPUアクセラレーションが有効なシステムでは、スレッド3（キャリブレーション）がダイナミック・コンピュート・アダプテーションの恩恵を受け、お使いのハードウェアに合わせて処理が最適化されます。
ステージ1: 検出 (ターゲット検出)
処理内容:
Chloros は、「ターゲット」チェックボックスがオンになっている画像をスキャンします
コンピュータビジョンアルゴリズムが4つのキャリブレーションパネルを識別します
各パネルから反射率値が抽出されます
適切なキャリブレーションスケジューリングのために、ターゲットのタイムスタンプが記録されます
所要時間:
ターゲットがマークされている場合: 10～60秒
ターゲットがマークされていない場合: 5～30分以上（すべての画像をスキャン）
進行状況インジケーター:
検出中: 0% → 100%
スキャンされた画像数
検出されたターゲットの数
確認事項：
ターゲットが適切にマークされていれば、すぐに完了するはずです
時間がかかりすぎる場合は、ターゲットがマークされていない可能性があります
デバッグログで「Target found」メッセージを確認してください
ステージ2：分析
処理内容：
画像のEXIFメタデータ（タイムスタンプ、露出設定）の読み取り
ターゲットのタイムスタンプに基づいてキャリブレーション戦略を決定
画像処理キューの整理
並列処理ワーカーの準備（Chloros+ のみ）
所要時間： 5～30秒進行状況インジケーター：
分析中：0% → 100%
高速なステージであり、通常はすぐに完了します
確認事項：
停止することなく着実に進行しているか
メタデータが欠落している場合の警告がデバッグログに表示されます
ステージ3：キャリブレーション
処理内容：* デベイヤー処理：RAWのベイヤー配列を3チャンネルに変換
ヴィネット補正：レンズの周辺減光を除去
反射率キャリブレーション：目標値に基づいて正規化
インデックス計算：マルチスペクトルインデックスの算出
各画像をフルパイプラインで処理
所要時間： 処理時間全体の大部分（60～80%）進行状況インジケーター:
キャリブレーション中: 0% → 100%
現在処理中の画像
処理完了画像数 / 総画像数
処理動作:* フリーモード: 画像を1枚ずつ順次処理
Chloros+ モード: 最大16枚の画像を同時に処理
GPU アクセラレーション：この段階の処理を大幅に高速化します確認事項：
画像数の着実な減少
デバッグログで画像ごとの完了メッセージを確認
画像品質やキャリブレーションに関する警告
ステージ 4：エクスポート
処理内容：
キャリブレーション済みの画像を、選択した形式でディスクに書き込み
LUTカラーを使用したマルチスペクトルインデックス画像のエクスポート
カメラモデルごとのサブフォルダの作成
適切な拡張子を付加して元のファイル名を保持
所要時間: 処理時間全体の10～20%進行状況インジケーター:
エクスポート中: 0% → 100%
書き込み中のファイル
エクスポート形式と保存先
確認すべき点：
ディスク容量の警告
ファイル書き込みエラー
設定されたすべての出力が完了したか
デバッグログタブ
デバッグログには、処理の進捗状況や発生した問題に関する詳細情報が表示されます。
デバッグログへのアクセス
左サイドバーの デバッグログ
アイコンをクリックしますログパネルが開き、リアルタイムの処理メッセージが表示されます
最新のメッセージを表示するために自動的にスクロールします
ログメッセージの理解
情報メッセージ（白/灰色）
通常の処理の更新：
警告メッセージ（黄色）
処理を停止させない軽微な問題：
対応： 処理終了後に警告を確認してください。処理を中断しないでください
エラーメッセージ (Red)
処理の失敗につながる可能性のある重大な問題：
対応: 処理を停止し、エラーを解決してから再起動してください
一般的なログメッセージ
"[filename]にターゲットを検出"
キャリブレーションターゲットが正常に検出されました
なし - 正常
"Y枚中X枚目の画像を処理中"
現在の進行状況の更新
なし - 正常
"ターゲットが見つかりません"
キャリブレーションターゲットが検出されませんでした
ターゲット画像にマークを付けるか、反射率キャリブレーションを無効にする
"ディスク容量不足"
出力用のストレージ容量が不足しています
ディスクの空き容量を確保してください
"破損したファイルをスキップ"
画像ファイルが破損しています
SDカードからファイルを再コピーしてください
"PPKデータを適用"
.daqファイルからのGPS補正が適用されました
なし - 正常
ログデータのコピー
トラブルシューティングやサポートのためにログをコピーするには：
デバッグログパネルを開く
**「ログをコピー」**ボタンをクリックする（または右クリック → すべて選択）
テキストファイルまたはメールに貼り付ける
必要に応じて 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+ 並列モードではより多くの RAM を消費します
メモリ不足の場合：
処理するバッチのサイズを小さくする
他のアプリケーションを閉じる
定期的に大規模なデータセットを処理する場合は、RAMを増設する
GPU使用量（CUDA対応のChloros+）
GPUアクセラレーションが有効な場合：
NVIDIA GPUの使用率が上昇（60～90%）
VRAMの使用量が増加します（4GB以上のVRAMが必要です）
キャリブレーション段階が大幅に高速化されます
監視方法：
NVIDIAのシステムトレイアイコン
タスクマネージャー → パフォーマンス → GPU
GPU-Zなどの監視ツール
ディスクI/O
想定される動作：
分析段階ではディスクの読み取りが活発
エクスポート段階ではディスクへの書き込みが活発
SSDはHDDよりも大幅に高速
パフォーマンスのヒント:
可能であれば、プロジェクトフォルダにはSSDを使用する
大容量のデータセットにはネットワークドライブを避ける
ディスクの空き容量が不足していないことを確認する（書き込み速度に影響する）
処理中の問題の検出
警告サイン
進行状況が停滞する（5分以上変化がない場合）：
デバッグログでエラーを確認する
ディスクの空き容量を確認する
タスクマネージャーで Chloros が実行中であることを確認する
エラーメッセージが頻繁に表示される：
処理を停止し、エラーを確認する
一般的な原因：ディスク容量不足、ファイルの破損、メモリの問題
以下の「トラブルシューティング」セクションを参照
システムが応答しなくなる場合：
Chloros+ 並列モードがリソースを過剰に消費している
同時実行タスクの削減またはハードウェアのアップグレードを検討してください
フリーモードはリソース消費が少なくて済みます
処理を停止すべき場合
以下の症状が見られた場合は処理を停止してください：
❌ 「ディスク容量不足」または「ファイルへの書き込み不可」エラー
❌ 画像ファイルの破損エラーが繰り返し発生する場合
❌ システムが完全にフリーズ（応答なし）している場合
❌ 設定が間違っていたことに気づいた場合
❌ 間違った画像をインポートした場合
停止方法：
1.停止/キャンセルボタン（開始ボタンの代わりに表示されます）をクリックします 2. 処理が停止し、進行状況は失われます 3. 問題を修正し、最初から再実行してください
処理中のトラブルシューティング
処理が非常に遅い
考えられる原因:
ターゲット画像が選択されていない（すべての画像をスキャンしている）
SSDではなくHDDを使用している
システムリソースが不足している
インデックス設定数が多すぎる
ネットワークドライブへのアクセス
解決策:
処理を開始したばかりで「検出中」の段階の場合：キャンセルし、ターゲットをマークして再起動
今後の対策：SSDを使用する、インデックス数を減らす、ハードウェアをアップグレードする
大規模なデータセットのバッチ処理にはCLIの使用を検討する
「ディスク容量不足」の警告
解決策：
直ちにディスク容量を空ける
プロジェクトを空き容量の多いドライブに移動する
エクスポートするインデックスの数を減らす
TIFFの代わりにJPG形式を使用する（ファイルサイズが小さくなる）
「ファイルが破損しています」というメッセージが頻繁に表示される
解決策:
整合性を確保するため、SDカードから画像を再度コピーする
SDカードのエラーをチェックする
プロジェクトから破損したファイルを削除する
残りの画像の処理を続行する
システムの過熱 / スロットリング
解決策:
十分な通気性を確保する
コンピュータの通気口からほこりを掃除する
処理負荷を軽減する（Chloros+の代わりにFreeモードを使用する）
1日のうち比較的涼しい時間帯に処理を行う
処理完了通知
処理が完了すると：
進行状況バーが100%に達する
**「処理完了」**というメッセージがデバッグログに表示される
開始ボタンが再び有効になる
すべての出力ファイルがカメラモデルのサブフォルダ内にある
次の手順
処理が完了したら：
結果を確認する - 処理の完了を参照
出力フォルダを確認 - すべてのファイルが正しくエクスポートされているか確認してください
デバッグログを確認 - 警告やエラーがないか確認してください
処理済み画像をプレビュー - 画像ビューアまたは外部ソフトウェアを使用してください
処理結果の確認および使用方法については、処理の完了を参照してください。
最終更新