コンテンツにスキップ

参照との検証 — Validating against a reference

英語 | 日本語

« Home

このギャラリーの検証は「正しいと主張する」仕組みではなく、「どんな証拠があるかを表示する」仕組みである。このページはその語彙 — tier、gate、measured、audit — を、1 つのケースが段位を登る実例つきで説明する。

段位 T0–T3 — 証拠の強さの表示

tier 意味 要求される証拠
T0 解析解との比較、収束の証拠つき L2 誤差 + 収束次数(例: poiseuille の L2 と次数)
T1 公刊参照、自動 ctest ゲートつき ゲート名と許容値
T2 公刊参照、単点の手動比較 測定値と rel. err、なければ「未計測」
T3 デモ / 定性のみ その旨を明記

段位は「正しさ」の格付けではない。同じ正しい計算でも、収束次数まで測れば T0、単点なら T2 になる — 測られた証拠の強さだけを表示する。現在の内訳は T0 が 9、T1 が 9、T2 が 50、T3 が 3 で、Index の By tier 軸と Validation status から引ける。

ゲート direct / module — なぜ module ゲートがあるか

ゲートは ctest の golden テストで、2 種類ある。direct はベンチマーク実体そのものを ctest が回すもので、現在 cavity3d_d3q27_ghia の 1 件だけ。module はケースが使う物理モジュールのゲートを継承するもので、28 ケースがこれに当たる(closures、thermal_ddf、two_phase_laplace、free_surface などのゲート名で束ねられる)。残り 42 ケースはゲートなし。

module ゲートが存在する理由は合成アーキテクチャそのものにある: ケースは openrheo_amr/*.hpp モジュールの合成で書かれるから、物理はモジュール側で1 回検証すれば、それを差した全ケースが検証を継承する。ページの 🧩 バッジはこの継承の表示であり、どのモジュールがどのゲートを持つかは Models の表になっている。

measure-then-pin — 数字の載せ方

ページに載る比較値は「実行して、記録して、初めて印字される」。手順は: ケースを走らせ、QoI を cases.json の measured ブロックに value / rel_err / ref / provenance の 4 点セットで記録する(実例: advection-diffusion2d の "provenance": "harvest N=128")。ページ生成はこの記録から値と rel. err を印字し、記録がないケースは「未計測」と表示したまま公開する — 設計文書の言葉で「publish with 未計測 rows visible — that IS the honesty story」。値だけが書かれて出所のない数字は、この wiki には存在しない。

正直ルールは欠陥報告ではなく仕様である

  • cylinder2d の Schäfer–Turek 比較は St は参照帯内、Cd_max は +8.7%(Cl_max +10.7%)で、この超過は隠されずノートの結果節に理由(階段状マスクの実効直径誤差)ごと公開されている。「合う量と合わない量が分かれる理由」まで書くのが結果節の仕事である。
  • forest-cylinder-st の Cd が DFG 帯を 7.55% 外れた件も、設計時点で「⚠ と 1 行の診断つきで公開。隠さない、黙って再実行しない」と決められている(wiki-design.md)。
  • Known issues は空でないことが正常。落ちた実行・打ち切られた実行は、その旨を明記した上でページになる。
  • artefact のない節は省略される。偽造されることはない(生成器の家風、wiki_pages.py)。

ケースが段位を登る — porous-poiseuille2d を実例に

porous_poiseuille2d(Brinkman 多孔質チャネル)は登り方の見本である。ソースヘッダにある通り、参照はコードではなく厳密解 — Brinkman 方程式の cosh 分布 u(y) = (GK/ν)[1 − cosh((y−H/2)/√K)/cosh(H/(2√K))] — で、ケースは Darcy 数ごとの L2 誤差を自分で印字する。

  1. T3: 絵が出る。「多孔質っぽい」だけならここまで。
  2. T2: 参照(解析解や公刊値)に対する単点比較を 1 つ測って記録する。
  3. T1: このケースの Darcy 抵抗は closures.hpp の係数クロージャなので、モジュールゲート ctest closures(native/CMakeLists.txt の orheo-test-closures)を継承する。現在の登録がまさにここ — tier: T1, gate_kind: module, gate_name: closures(gallery_index.json)。
  4. T0 に登るには、解析解があるだけでは足りない — 格子を細分して収束次数を測定し、証拠として添える必要がある。

「解析解つきなのに T1」なのは欠陥ではなく、段位が測定済みの証拠だけを数える、という規則の帰結である。

ドリフト検知 — 検証が古びたことを知る仕組み

wiki_pages.py の設計通り、ページは 3 層でできている: derived(表・コマンド。毎ビルド再生成され、古びられない)、measured(図・数値。実行時 commit を記録した 1 回の run に釘付けされ、run_id と実行日がページに印字される)、authored-once(散文。執筆時に読んだソースの source_sha に釘付け)。ソースが動けば wiki_pages.py audit が該当ノートと、evidence に挙げたファイルが新しい commit を持つ _page ノートを列挙する。つまり「検証が古い」ことは黙って起きず、必ず audit の出力に現れる — 参照との一致を主張する全ページが、この機構の上に載っている。