参照との検証 — Validating against a reference¶
英語 | 日本語
このギャラリーの検証は「正しいと主張する」仕組みではなく、「どんな証拠があるかを表示する」仕組みである。このページはその語彙 — 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 誤差を自分で印字する。
- T3: 絵が出る。「多孔質っぽい」だけならここまで。
- T2: 参照(解析解や公刊値)に対する単点比較を 1 つ測って記録する。
- T1: このケースの Darcy 抵抗は
closures.hppの係数クロージャなので、モジュールゲート ctestclosures(native/CMakeLists.txt のorheo-test-closures)を継承する。現在の登録がまさにここ —tier: T1, gate_kind: module, gate_name: closures(gallery_index.json)。 - 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 の出力に現れる — 参照との一致を主張する全ページが、この機構の上に載っている。