X-Y 分布画像出力

格子座標 (X, Y) と任意の値（Value）を使い、ステップごとの分布を画像として出力する GUI ツールです。ROI（回転矩形）で切り抜いた範囲のみを対象に、プレビュー確認と一括出力が行えます。

X-Y 分布画像出力

使い方（最短）

  1. Value を選択
  2. プレビュー対象 step を選択
  3. ROI を決定（編集キャンバス or 数値入力）
  4. スケール（自動/手動）を決める
  5. 出力範囲（開始/終了/間引き）を決める
  6. 現在のステップを出力 または 指定ステップをまとめて出力

対象と前提

項目 内容
入力 ランチャーで指定した プロジェクトフォルダ / .ipro / CSV フォルダ（Result_*.csv）
Value DataSource が提供する任意の列（例: ZB, U, V, HS）。GUI のコンボボックスから 1 つ選択
座標 CGNS / CSV に含まれるノード座標 (X, Y) を使用
ROI 中心 (Cx, Cy)、幅、高さ、角度（度単位）で表される回転矩形。編集キャンバスまたは数値入力で指定

注意: 境界データは描画対象外です。格子点のみを前提としています。

画面構成（概要）

  1. 左パネル
  2. 入力/出力パス表示（ランチャーで指定済み）
  3. Value 選択、プレビュー対象ステップ、色設定、スケール設定
  4. ROI 数値入力 (Cx/Cy/W/H/Angle)、解像度倍率、出力オプション

  5. 出力ステップ範囲、余白、フォントサイズ、出力ボタン

  6. 右上: プレビュー

  7. Matplotlib ベース。ROI ローカル座標で描画し、出力オプションを反映
  8. bbox_inches="tight" 相当の枠を破線で表示

  9. ROI が未確定または範囲外の場合はステータスメッセージを表示

  10. 右下: 編集キャンバス（全体表示）

  11. 全体＋10%余白を表示
  12. ROI をドラッグで移動、ハンドルでスケーリング・回転
  13. Ctrl + マウスホイール でズーム可能。操作ヒント/現在の設定をオーバーレイ表示

基本ワークフロー

  1. Value を選択
    初期読み込み後に利用可能な列がコンボボックスへ設定されます。

  2. プレビュー対象ステップを指定
    step Spinbox でプレビュー用の単一ステップを選択します（出力範囲とは独立）。

  3. ROI を決定
    編集キャンバスまたは数値入力で ROI を指定します。全体表示 ボタンでドメイン全体へリセット可能です。

  4. ROI 未確定時はプレビューに「ROI 確定待ち」が表示されます。

  5. 数値入力は Enter またはフォーカスアウトで確定します。

  6. 色とスケールを設定

  7. 色: 「最小/最大の2色」「虹色（iRIC風）」「色相回転」から選択
  8. スケール: 自動（全ステップ）（ROI 内全ステップの min/max をバックグラウンド計算）または 手動（数値入力）（vmin/vmax を入力）

  9. 手動の場合は範囲スライダーでも調整できます。自動計算値を範囲として保持します。

  10. 解像度・出力オプションを調整

  11. 解像度倍率（倍率）は推定格子間隔を基準に dx/dy をスケーリング

  12. 目盛り、枠線、カラーバー、タイトル、カラーバー名、フォントサイズ、余白(in)、出力倍率 を指定可能

  13. 出力ステップ範囲を設定

  14. 開始/終了ステップと間引き数を入力またはレンジスライダーで指定

  15. 範囲外の値は自動で補正されます。

  16. 出力を実行

  17. 現在のステップを出力: プレビュー中のステップのみ PNG 出力
  18. 指定ステップをまとめて出力: 指定範囲（開始/終了/skip）で連続出力。進捗バーとログを表示します。

プレビューと出力の挙動

  • プレビューは出力処理と同じ描画処理を用いますが、操作中は負荷軽減のため解像度を自動で下げます。
  • ROI ドラッグ中は再描画を抑え、リリース時に確定値で描画します。
  • カラーマップは matplotlib の pcolormesh(shading="gouraud") を使用。ROI 外は NaN としてクリップされ、透明表示になります。
  • 自動（全ステップ） スケールは ROI 確定後にバックグラウンドで再計算され、完了までは暫定値で描画します。
  • 出力画像は step_XXXX.png の形式で保存され、桁数は総ステップ数に合わせて自動決定します。

出力オプション詳細

オプション 説明
タイトル 任意文字列。空なら非表示
目盛り チェックでオン/オフ
枠線 チェックでオン/オフ
カラーバー チェックでオン/オフ
カラーバー名 任意文字列。空なら非表示
タイトル / 目盛 / CBラベル フォントサイズ 個別に指定
余白(in) bbox_inches="tight" に追加する余白。プレビューと出力で共通
出力倍率 プレビューの DPI を倍率変更して出力解像度を調整

よくあるエラーと対処

症状 原因 / 対処
「入力データに利用可能な変数が見つかりません」 入力ファイルに Value 列が無い。入力を確認
「ROI 内に点がありません」 ROI が空領域を指している。ROI を調整
「ROI 内の Value が全て NaN/Inf」 データ範囲外。ROI や Value を変更
スケール計算中でプレビューが更新されない 自動（全ステップ） の計算が進行中。完了を待つか手動に切り替え

参考情報