実行例

どの図も、黒い線が STL の壁、赤い線が回転ゾーンの界面(faceZone)、灰色の線がセルの面です。 セル数と時間は、Rust 拡張ありで 4 コアのマシンで測った値です(品質チェックを含む)。図をクリックすると原寸で開きます。

図の上の「境界層あり」を選ぶと、同じ設定に境界層(全壁に 3 層、 "addLayers": { "nLayers": 3, "expansionRatio": 1.2, "finalLayerThickness": 0.3 })を加えたメッシュの図に替わります。 セル数・時間・品質も層を付けたメッシュの値になり、「目標の厚さ」は層を目標の厚さまで付けられた壁の節点の割合です。

攪拌槽(examples/stirred_tank)

直径 300 mm・高さ 300 mm の平底の槽に、直径 100 mm の 4 枚パドル翼(厚さ 6 mm)と、蓋まで伸びるシャフトを置いた形状です。 STL は python make_geometry.py で作ります(solid: tankWall, bottom, top, impeller, shaft)。

回転ゾーン(meshDict.json)

  • 102,430 セル
  • 14.1 秒
  • 直交格子 + 円筒の回転ゾーン

翼のまわりに半径 70 mm の円筒の回転ゾーンを置いた例です。円筒は八分木のカットで切断されるので、界面(赤)は粗いセルの所でも円筒面にぴったり乗ります。 翼(レベル 3)・シャフト(レベル 2)・回転ゾーンの内部(レベル 2)だけを細かくし、槽の壁はレベル 1 です。

実行コマンド

cd examples/stirred_tank
python make_geometry.py                     # tank.stl と rotor.stl を生成(リポジトリにも入っている)
cutmesh meshDict.json                       # → case/constant/polyMesh、case/constant/MRFProperties

よく使うオプションと確認の道具

cutmesh meshDict.json -case case_test       # 出力先を変える(meshDict の "case" より優先)
cutmesh meshDict.json -noCheck              # 最後の品質チェックを省く(大きなメッシュで約 1 割速い)
python run.py meshDict.json                 # メッシュを作って断面図 slice_z.png・slice_y.png を描く
python ../../benchmark/render_mesh.py case -o case_pictures    # 3D 図 overview.png・cut.png を描く
python -m cutmesh.diagnose meshDict.json case                  # 壁越しのリークがないかを検査する
python ../../tools/edge_check.py meshDict.json                 # 特徴線・円筒の縁を捉えられているか測る

スライディングメッシュ(AMI)にする場合

cutmesh meshDict_ami.json                   # 界面を cyclicAMI パッチ rotor_AMI1 / rotor_AMI2 に分け、
                                            # constant/dynamicMeshDict を書く → case_ami/
python -m cutmesh.ami case -out case_ami_later    # 作ったメッシュを後から変換する場合
    # openfoam.org では meshDict に "openfoam": "org12" を書き、OpenFOAM で
    # createNonConformalCouples -overwrite rotor_nonCouple1 rotor_nonCouple2 を実行する
攪拌槽のメッシュ。手前半分のセルを取り除いた 3D 図と、x・y・z の断面 攪拌槽のメッシュ。手前半分のセルを取り除いた 3D 図と、x・y・z の断面(境界層あり)
x < 0 のセルだけを残した 3D 図(切り口はベージュ)と、中央の 3 断面。境界層あり(meshDict_layers.json、163,633 セル、16.6 秒、目標の厚さ 97.7%)
翼の中央の高さの水平断面と、翼を通る鉛直断面 翼の中央の高さの水平断面と、翼を通る鉛直断面(境界層あり)
翼の中央の高さ(z = 0.10)の水平断面と、翼を通る鉛直断面(y = 0)。境界層あり(meshDict_layers.json)
壁面のメッシュを 2 方向から見た図。パッチごとに色分け
壁面のメッシュ(パッチごとに色分け)
meshDict.json
{
  "domain": "tank.stl",
  "baseCellSize": 0.0125,
  "surfaceRefinement": { "default": 1, "impeller": 3, "shaft": 2 },
  "featureLevel": 2,
  "bufferLayers": 2,
  "snapTolerance": 0.3,
  "mergeRatio": 0.25,
  "rotatingZones": [
    {
      "name": "rotor",
      "cylinder": { "point1": [0, 0, 0.06], "point2": [0, 0, 0.14], "radius": 0.07 },
      "surfaceLevel": 2,
      "volumeLevel": 2,
      "omega": 31.416
    }
  ],
  "patchTypes": { "top": "wall" },
  "case": "case"
}

円筒ベースメッシュ(meshDict_cylindrical.json)

  • 137,144 セル
  • 22 秒
  • 同心ブロックのベースメッシュ

八分木の根を、軸まわりの同心ブロックにした例です。ブロックの配置は自動(中心の 2×2 の正方形と、外へ広がる同心リング)で、正方形はハブの中に入るので、流体側のセルはほぼすべて周方向に並びます。回転ゾーンの界面や槽の壁に沿ったメッシュになります。 ブロックの境界では分割数の比が整数でなくても、面を重ね合わせて適合したメッシュにします。

実行コマンド

cd examples/stirred_tank
cutmesh meshDict_cylindrical.json           # → case_cylindrical/
python run.py meshDict_cylindrical.json     # 断面図も描く場合
円筒ベースメッシュの水平断面と、その中央の拡大 円筒ベースメッシュの水平断面と、その中央の拡大(境界層あり)
翼の中央の高さの水平断面と、回転ゾーンのまわりの拡大。境界層あり(199,076 セル、25 秒、目標の厚さ 87.0%)
baseMesh の設定
"baseMesh": {
  "type": "cylindrical",
  "origin": [0, 0, 0],
  "axis": [0, 0, 1],
  "nz": 24
}

ログに出る自動配置: 中心 2×2(半幅 11.9 mm)、半径 23.8 / 34.8 / 58.4 / 91.8 / 158.3 mm、周方向 8 / 16 / 24 / 36 / 64 分割。翼の先端(50.1 mm)・回転ゾーン(70 mm)・槽の壁(150 mm)は層の 1/3 の位置に来る。

境界層(meshDict_layers.json)

  • 163,633 セル
  • 16.6 秒
  • 全壁に 3 層

回転ゾーンの例に、すべての壁パッチへ 3 層のプリズム層を加えた例です。回転ゾーンの界面にかかる所では、層の側面も界面の円筒面に乗ったままです。

実行コマンド

cd examples/stirred_tank
cutmesh meshDict_layers.json                # 生成のあとに層を追加 → case_layers/

層だけを後から付ける場合(既存のメッシュに)

cutmesh meshDict.json                       # 層のないメッシュ → case/
python -m cutmesh.layers case meshDict_layers.json -out case_layers_later
    # 2 つ目の引数のファイルの "addLayers" を使う(省略すると既定値: 3 層)
    # -out: 書き出し先(省略すると入力のメッシュを上書き)
    # -noCheck: 品質チェックを省く / -ascii・-binary: 書き出し形式(既定は入力と同じ)
境界層つきの鉛直断面と、槽の底と側壁の角の拡大
鉛直断面(y = 0)と、槽の底と側壁の角の拡大
addLayers の設定
"addLayers": { "nLayers": 3, "expansionRatio": 1.2, "finalLayerThickness": 0.3 }

ローター・ステーター(狭い隙間の中の界面)

攪拌槽の翼のすぐ外側に、固定リング(ステーター)を置いた形状です。リングの内面は翼の先端の角から 1 mm 外にあり、 回転ゾーンの界面はその隙間の中央(翼から 0.5 mm)に置きます。界面と両側の壁の間にそれぞれセルが入るように、 wallProximity で壁に近い部分の界面だけを細かくし、autoGapRefinement で隙間に面した壁を細かくします。

STL は python make_geometry.py --stator 1 で作ります。リングの内面は solid statorInner、それ以外は stator です。

実行コマンド

cd examples/stirred_tank
python make_geometry.py --stator 1          # tank_stator_1mm.stl を生成(--stator の後は隙間の幅 [mm])
cutmesh meshDict_stator_1mm.json            # → case_stator_1mm/(約 60 万セル、約 2 分、メモリ 約 5 GB)
python -m cutmesh.diagnose meshDict_stator_1mm.json case_stator_1mm   # 隙間で壁越しにつながっていないか

隙間 0.5 mm の場合

python make_geometry.py --stator 0.5        # tank_stator_0.5mm.stl
cutmesh meshDict_stator.json                # 約 200 万セル。15 GB を超えるメモリが必要
翼と固定リングの水平断面、翼の先端の 2 mm 角の拡大、翼の上端の角の鉛直断面 翼と固定リングの水平断面、翼の先端の 2 mm 角の拡大、翼の上端の角の鉛直断面(境界層あり)
左: 翼の中央の高さの水平断面。中: 翼の先端の拡大(幅 2 mm)。右: 翼の先端の上端の角(鉛直断面)。界面(赤)の内側は回転ゾーン、外側は静止側。境界層あり(982,245 セル、169 秒、目標の厚さ 77.2%)。翼の先端と固定リングの間の隙間(中の図)には、層がほとんど付かない

隙間が狭いほどセル数が急に増えます。界面と壁の間(隙間の半分)に 1 セル以上入れるため、隙間の半分程度のセルが界面の全周に並びます。 この形状では、隙間 1 mm で約 60 万セル、隙間 0.5 mm で約 200 万セル(15 GB のメモリでは足りない)になります。 MRF で計算するなら、"conforming": false(セル中心で回転ゾーンを選ぶ)にすれば界面のための細分化が要りません(AMI には使えません)。

meshDict_stator_1mm.json
{
  "domain": "tank_stator_1mm.stl",
  "baseCellSize": 0.0125,
  "surfaceRefinement": { "default": 1, "impeller": 3, "shaft": 2, "stator": 3, "statorInner": 3 },
  "featureLevel": 2,
  "bufferLayers": 2,
  "snapTolerance": 0.3,
  "mergeRatio": 0.25,
  "autoGapRefinement": { "cellsAcross": 2, "maxLevel": 5 },
  "rotatingZones": [
    {
      "name": "rotor",
      "cylinder": { "point1": [0, 0, 0.074], "point2": [0, 0, 0.126], "radius": 0.05059 },
      "surfaceLevel": 3,
      "volumeLevel": 2,
      "wallProximity": { "distance": 0.001, "level": 5 },
      "omega": 31.416
    }
  ],
  "patchTypes": { "top": "wall" },
  "case": "case_stator_1mm"
}

隙間 0.5 mm の設定は examples/stirred_tank/meshDict_stator.json にあります(maxLevel・level を 6 にする)。

形状のテスト集(benchmark/)

ベンチマークの人工形状(python benchmark/make_synthetic.py で生成)から 5 つです。どれも外接箱の最長辺の 1/24 をベースセルにし、 表面をレベル 2 まで細かくしています。各図は、手前半分のセルを取り除いた 3D 図と、中央の 3 断面です。

実行コマンド(リポジトリの直下で)

python benchmark/make_synthetic.py          # 人工形状の STL を benchmark/data/synthetic/ に生成
python benchmark/run_bench.py benchmark/suites/synthetic.json --only sphere --only torus --keep --out benchmark/results/shapes
    # --only: ケース名で絞る(ワイルドカード可: "thin_*") / --keep: 合格したケースの polyMesh も残す
    # --out: 出力先 → benchmark/results/shapes/cases/sphere/ に case/constant/polyMesh、
    #        meshDict.json(使った設定)、overview.png・cut.png(画像)、log.txt(cutmesh のログ)
    #        benchmark/results/shapes/summary.md に判定・セル数・品質・時間の一覧

ほかのオプション

python benchmark/run_bench.py benchmark/suites/synthetic.json -j 4                  # 26 形状すべてを 4 並列で
python benchmark/run_bench.py benchmark/suites/synthetic.json --cells-across 48 --only cube_rotated   # 解像度を 2 倍に
python benchmark/run_bench.py benchmark/suites/synthetic.json --set addLayers='{"nLayers": 3}'      # 全ケースに境界層
python benchmark/run_bench.py benchmark/suites/synthetic.json --baseline benchmark/baselines/synthetic.json  # 基準と比べる
python benchmark/stl_check.py benchmark/data/synthetic/torus.stl                    # STL の診断だけ(開いた辺など)
球の内部のメッシュ 球の内部のメッシュ(境界層あり)
sphere — 滑らかな凸の曲面(75,612 セル、12.9 秒境界層あり、147,636 セル、15.5 秒、目標の厚さ 98.9%)
格子に対して傾いた立方体の内部のメッシュ 格子に対して傾いた立方体の内部のメッシュ(境界層あり)
cube_rotated — 格子に沿わない鋭いエッジ(下の「格子に沿わないエッジ」)。切り口の縁の小さな段は、セルを丸ごと残す描き方によるもので、壁の形ではない(53,564 セル、12.8 秒境界層あり、112,271 セル、15.4 秒、目標の厚さ 92.5%)
トーラスの内部のメッシュ トーラスの内部のメッシュ(境界層あり)
torus — 流体を貫く穴(39,008 セル、7.1 秒境界層あり、84,596 セル、9.0 秒、目標の厚さ 95.3%)
幅の狭い流路のメッシュ 幅の狭い流路のメッシュ(境界層あり)
thin_channels — セル 2 個分の幅の流路(46,244 セル、11.0 秒境界層あり、146,819 セル、14.4 秒、目標の厚さ 98.0%)
L 字形のメッシュ L 字形のメッシュ(境界層あり)
l_bracket — 凹のエッジ(71,439 セル、8.5 秒境界層あり、166,617 セル、10.9 秒、目標の厚さ 99.9%)

格子に沿わないエッジ(凸エッジの厳密カット)

エッジが八分木の格子に沿わない形では、エッジのすぐ横の頂点が両側の壁に寄せられ、エッジと頂点の間の流体がセルごとに欠けて、 エッジが鋸歯状になっていました。凸のエッジの近くのセルを STL の平面で直接切る処理(exactFeatureCut、既定で有効)で、 エッジに沿ったメッシュになります。下は cube_rotated の壁面を 2 方向から見た図です。

厳密カットなしの傾いた立方体の壁面。エッジに沿って欠けがあり、品質の悪いセルが赤く表示されている
厳密カットなし: エッジに沿って欠けが並ぶ(ずれは最大で最小セルの 0.79 倍、エッジの 16.5% で 0.2 倍超)。赤は品質の悪いセル
厳密カットありの傾いた立方体の壁面。エッジがまっすぐ
厳密カットあり: エッジに沿う(0.2 倍を超える所はエッジの 0.1%)。歪度 > 4 の面は 3 → 0

凸のエッジが凹のエッジや曲面と交わる所の近くでは、平面で切ると壊れたセルができることがあるので、従来のカットに戻します(そこには面取りが残ることがあります)。 円錐の底の縁のように、曲面と平面が交わるエッジは対象外です。

このほかにも、薄い壁・汚れた STL(重複した三角形、開いた辺、向きの混在)など 26 の形状で、失敗・警告・品質の低下を一覧にできます (benchmark/README.md)。

実用的な形状(benchmark/suites/showcase.json)

配管・ダクト・外部流れなど、実際の流れの問題に近い 8 つの形状です。どれも入口・出口を別の solid(パッチ)にした STL で、 python benchmark/make_synthetic.py で生成します。8 ケースとも、警告・品質フラグなしで PASS します (非直交性 > 70° と歪度 > 4 の面が 0、体積の誤差は STL の 0.3% 以内)。図は断面(黒: STL の壁、灰色: セルの面)です。

実行コマンド(リポジトリの直下で)

python benchmark/make_synthetic.py          # STL を benchmark/data/synthetic/ に生成(pipe_elbow.stl など)
python benchmark/run_bench.py benchmark/suites/showcase.json -j 4 --keep --out benchmark/results/showcase
    # → benchmark/results/showcase/cases/<名前>/case/constant/polyMesh と meshDict.json(使った設定)
python benchmark/run_bench.py benchmark/suites/showcase.json --only venturi --keep   # 1 つだけ

ケースごとの meshDict(baseCellSize・パッチごとの細分化レベル・patchTypes)は benchmark/suites/showcase.json にあります。cutmesh を直接使うなら、出力先の meshDict.json をそのまま cutmesh meshDict.json に渡せます。

円管の 90 度エルボの断面 円管の 90 度エルボの断面(境界層あり)
pipe_elbow — 直径 D の円管の 90° 曲がり(曲率半径 1.5 D)。左は曲がりを通る断面、右は出口側の管の横断面(27,869 セル、4.6 秒、最大非直交 53°境界層あり、59,363 セル、5.9 秒、目標の厚さ 98.6%、最大非直交 64°)
らせん管の壁面メッシュ 境界層つきのらせん管。手前半分のセルを取り除いた 3D 図と 3 断面
helical_coil — 2.5 巻きのらせん管(コイル式熱交換器)。壁面をパッチごとに色分け(青: inlet、橙: outlet)壁面では層が見えないので、手前半分のセルを取り除いた 3D 図と中央の 3 断面(98,359 セル、24 秒、最大非直交 62°境界層あり、223,504 セル、30 秒、目標の厚さ 90.4%、最大非直交 65°)
ベンチュリ管の縦断面とのどの拡大 ベンチュリ管の縦断面とのどの拡大(境界層あり)
venturi — ベンチュリ管: 余弦形の縮流でのど(0.4 D)へ、7° のディフューザーで戻る(24,484 セル、5.1 秒、最大非直交 58°境界層あり、50,311 セル、5.8 秒、目標の厚さ 93.3%、最大非直交 65°)
オリフィス板の縦断面と開口のエッジの拡大 オリフィス板の縦断面と開口のエッジの拡大(境界層あり)
orifice_pipe — 円管の中の鋭いエッジのオリフィス板(開口径 0.5 D、板厚 0.1 D)(19,376 セル、3.6 秒、最大歪度 1.4境界層あり、40,781 セル、4.2 秒、目標の厚さ 98.8%、最大歪度 2.6)
バックステップ流路の断面 バックステップ流路の断面(境界層あり)
backward_step — バックステップ流れ(拡大比 2)。側面は symmetry パッチ(19,440 セル、2.7 秒、最大非直交 25°境界層あり、40,752 セル、3.2 秒、目標の厚さ 100.0%、最大非直交 40°)
T 字合流ダクトの断面 T 字合流ダクトの断面(境界層あり)
t_junction — 正方形ダクトの T 字合流(枝管の幅は主管の半分)。入口は inletMain・inletBranch の 2 つ(15,736 セル、2.8 秒、最大非直交 25°境界層あり、38,392 セル、3.1 秒、目標の厚さ 100.0%、最大非直交 62°)
ピンの千鳥配列の水平断面と、ピンのまわりの拡大 ピンの千鳥配列の水平断面と、ピンのまわりの拡大(境界層あり)
pin_fins — ダクトを横切る 13 本のピンの千鳥配列(ピンフィン・管群)。ピンだけをレベル 3 に(63,287 セル、16.3 秒、最大非直交 39°境界層あり、144,293 セル、18.1 秒、目標の厚さ 93.4%、最大非直交 56°)
風洞の中の物体の縦断面と、物体まわりの拡大 風洞の中の物体の縦断面と、物体まわりの拡大(境界層あり)
body_in_tunnel — 風洞の中の鈍頭物体(丸めた先端、後端に 25° の傾斜、床からのすき間 0.05)。外部流れの例: 物体はレベル 4、床はレベル 1、風洞の側面と天井はレベル 0(92,311 セル、17.9 秒、最大非直交 58°境界層あり、154,852 セル、19.9 秒、目標の厚さ 98.7%、最大非直交 64°)
例: body_in_tunnel の meshDict
{
  "domain": "body_in_tunnel.stl",
  "baseCellSize": 0.08,
  "surfaceRefinement": { "default": 0, "floor": 1, "body": 4 },
  "patchTypes": { "inlet": "patch", "outlet": "patch", "walls": "symmetry" },
  "case": "case"
}

solid は inlet, outlet, floor, walls(風洞の側面と天井), body(法線は物体の内側=流体の外向き)です。

画像の作り方

このページの画像は、次のスクリプトで作り直せます(境界層なし・ありの両方で、Rust 拡張ありで約 15 分)。

python tools/make_docs_images.py                    # すべて → docs/images/
python tools/make_docs_images.py --only stator      # 一部だけ(tank, cylindrical, stator, shapes, showcase)
python tools/make_docs_images.py --variant plain    # 境界層なしの図だけ(layers: ありの図だけ。ファイル名の末尾が _layers)

手元のメッシュの画像は python benchmark/render_mesh.py CASE(3D 図と断面図)、または examples/stirred_tank/run.py の cutmesh.viz.plot_slice(断面図)で描けます。