マニュアル
cutmesh は、水密な STL の内部に八分木ベースの多面体メッシュを作り、OpenFOAM の
constant/polyMesh を直接書き出すメッシャーです。八分木のセルを STL で直接切断(カットセル)して壁面を作ります。
設定はすべて 1 つの JSON ファイル(meshDict.json)に書きます。
開発中のプロトタイプです。メッシュ品質は checkMesh と同じ式の自前チェックで確認していますが、OpenFOAM 本体での検証は限られています。
使う前に手元で checkMesh を実行してください。
インストール
必要なもの: Python 3.9 以上、numpy、scipy(断面図を描くなら matplotlib)。メッシュ生成に OpenFOAM は要りません。
git clone https://github.com/mmer547/cutmesh.git
cd cutmesh
pip install -e . # オフライン環境では --no-build-isolation(要 wheel)
python tools/build_rust.py # 任意: Rust 拡張のビルド(約 4 倍速くなる)
インストールしない場合は、リポジトリの直下から python -m cutmesh で実行するか、PYTHONPATH にリポジトリのディレクトリを通してください。
使い方
cutmesh meshDict.json [-case DIR] [-noCheck] # python -m cutmesh でも同じ
| オプション | 意味 |
|---|---|
-case DIR | 出力先のケースディレクトリ(meshDict の case より優先) |
-noCheck | 生成後の品質チェックを省く(大きなメッシュで約 1 割速くなる) |
最小限の meshDict.json(STL の内部だけのメッシュ):
{
"domain": "model.stl",
"baseCellSize": 0.01,
"surfaceRefinement": { "default": 2 },
"patchTypes": { "inlet": "patch", "outlet": "patch" },
"case": "case"
}
case/constant/polyMesh が書き出され、続けて品質チェックの結果がログに出ます。パス(domain など)は
meshDict.json のあるディレクトリからの相対パスです。STL の solid 名がそのままパッチ名になり、patchTypes に書かないパッチは wall になります。
ログの見方:
[ 63.15s] leak check (1.55s, peak 3.82 GB)— 各段階の終了時刻・所要時間・メモリのピークREPAIR: ...— 入力 STL を自動で直した内容(設定と入力の検査)WARNING: ...— 直さずに見つけた問題(開いた辺、リーク、体積の不一致など)- 最後の
checkMesh-style report— 非直交性・歪度・体積などの品質
攪拌槽の例題は examples/stirred_tank にあります。画像つきの説明は 実行例 を見てください。
cd examples/stirred_tank
python make_geometry.py # サンプル STL を生成
cutmesh meshDict.json # → case/constant/polyMesh, case/constant/MRFProperties
python run.py # 断面図も欲しい場合 → slice_z.png, slice_y.png
meshDict.json
_ または // で始まるキーはコメントとして無視されます。知らないキーは警告されます(綴りの誤りで設定が黙って無視されないように)。
フォームで作ることもできます: meshDict 作成(STL の solid 名と大きさを読み、入力をその場で検査します)。エディターの補完には JSON Schema が使えます。
基本
| キー | 意味 | 既定値 |
|---|---|---|
domain | 流体領域の STL(閉曲面、複数 solid 可。solid 名がパッチ名)。ASCII・バイナリどちらも可 | 必須 |
baseCellSize | レベル 0 のセルの辺長 [m]。レベル L のセルは baseCellSize / 2^L | 必須 |
case | 出力先のケースディレクトリ | . |
patchTypes | パッチ名 → タイプ(wall, patch など) | すべて wall |
padding | STL の外接箱の周りに足すベースセルの数 | 1 |
rotatingZones | 回転ゾーンのリスト(回転ゾーン) | [] |
baseMesh | ベースメッシュ(円筒ベースメッシュ) | 直交格子 |
addLayers | 境界層の設定(境界層) | なし |
細分化
| キー | 意味 | 既定値 |
|---|---|---|
surfaceRefinement | solid 名 → 細分化レベル。default で既定値 | {} |
featureLevel | 特徴線(鋭角エッジ)の近くの細分化レベル(null = 表面の最大レベル) | null |
featureAngle | 特徴線を抽出する角度 [deg] | 30 |
refinementRegions | 体積の細分化領域 [{"cylinder": {...}, "level": n}] | [] |
bufferLayers | レベルの遷移ごとのバッファセルの数。1 にするとセル数が減る | 2 |
gapRefinement | {"thickness": t, "level": L}: 流体の厚みが t 未満の所(スロットの先端、狭い流路)の壁を L まで細分化 | なし |
autoGapRefinement | {"cellsAcross": n, "maxLevel": L}(true で既定値): 壁から法線方向に向かいの壁までの隙間の幅 w を測り、隙間に n 個のセルが入るレベル(上限 L)まで壁を細分化する。厚さを指定せずに、溝・スリット・狭い隙間がつぶれるのを防ぐ | n = 3、L = 表面レベルの最大 + 2 |
スナップと統合
| キー | 意味 | 既定値 |
|---|---|---|
snapTolerance | 節点を表面へ寄せる距離(セル辺長比)。スライバーセルを防ぐ | 0.3 |
featureSnapTolerance | 特徴線(STL の鋭角エッジ・円筒の縁)へ寄せる距離(セル辺長比) | 0.5 |
featureSnapMax | 実験的: この距離まで特徴線へ寄せ、八分木セルが壊れる所だけ取り消す。一部のカットセルが反転するため既定では無効 | 0.5 |
concaveSnapMax | 凹の鋭角エッジでは、固体側の節点をこの距離までエッジ上へ寄せる | 0.75 |
hangingSnap | 表面へ届かないぶら下がり節点の扱い("free": 表面へ直接投影、"constrained": 動かさない) | "free" |
featureCaps | 凸の鋭角部でカット面を特徴線に沿わせる("domain" / "zone" / "both" / false) | "domain" |
exactFeatureCut | 凸の鋭角エッジの近くのセルを、STL の平面で直接切る。格子に沿わないエッジがギザギザにならない(featureCaps が "domain" か "both" のときだけ働く) | true |
mergeRatio | 元の六面体の体積比でこれ未満のカットセルを隣のセルに統合する | 0.25 |
mergeMaxNonOrtho | 統合後の非直交角の上限 [deg] | 65 |
mergeWallFaces | 1 つのセルの、ほぼ同一平面の壁面の断片を 1 つの面にまとめる | true |
薄い形状
| キー | 意味 | 既定値 |
|---|---|---|
fillThinGaps | 中に流体があるのに角の頂点がどれも流体にないセル(格子の面の間を通る薄い隙間)を分割する回数。0 で無効(直交格子のみ) | 2 |
fillThinWalls | 中に固体の薄い壁があるのに角の頂点がどれも固体にないセルを分割する回数。壁が消えて両側の流体がつながるのを防ぐ(直交格子のみ) | 3 |
thinCutCells | 壁で切られて流体が少ししか残らず、隣に細かいセルがあるセルを分割する回数(直交格子のみ) | 2 |
thinCutFraction | thinCutCells の対象にする流体の割合 | 0.35 |
minRegionVolume | 流体の本体とつながっていない領域のうち、体積が全体のこの割合未満のものを削除する(それ以上は警告) | 1e-3 |
検査と出力
| キー | 意味 | 既定値 |
|---|---|---|
checkLeaks | 流体が固体の壁を越えてつながっていないかを検査し、見つかれば場所をログに出す | true |
strictInput | STL に開いた辺・非多様体の辺があるとき、警告ではなくエラーで止める | false |
volumeCheckTolerance | メッシュの体積と STL の体積の差がこの割合を超えたら警告する | 0.05 |
writeFormat | polyMesh の形式: "binary" または "ascii"(書き出し形式) | "binary" |
writeMRFProperties | 回転ゾーンがあるとき constant/MRFProperties の雛形を書く("ami": true のゾーンは除く) | true |
openfoam | スライディングメッシュの書き方: "com"(openfoam.com / ESI)、"org10"・"org11"・"org12"(openfoam.org)(スライディングメッシュ) | "com" |
writeDynamicMeshDict | "ami": true のゾーンがあるとき constant/dynamicMeshDict を書く | true |
amiExactRims | "ami": true のゾーンの界面を、ゾーンの縁(円筒の上下の縁)にぴったり沿わせる(縁の外側のセルを 2 つに切る)(スライディングメッシュ) | true |
回転ゾーン(rotatingZones)
MRF やスライディングメッシュ(AMI)用の回転領域を円筒で指定します。円筒は八分木のカットで切断されるので、 円筒面そのものがメッシュの内部面になります(生成後にセル中心でゾーンを選ぶ方式ではありません)。 界面は粗いセルでも厳密に円筒面上にあるので、界面のために細分化する必要がありません。
"rotatingZones": [
{ "name": "rotor",
"cylinder": { "point1": [0, 0, 0.06], "point2": [0, 0, 0.14], "radius": 0.07 },
"surfaceLevel": 2, "volumeLevel": 2, "omega": 31.416, "nonRotatingPatches": [] }
]
| キー | 意味 |
|---|---|
name | ゾーン名(cellZone 名、faceZone は <name>_interface) |
cylinder | 円筒: 軸の両端 point1・point2 と半径 radius |
stl, origin, axis | 円筒の代わりに閉じた STL で与える(examples/stirred_tank/meshDict_stlRotor.json) |
surfaceLevel / volumeLevel | ゾーンの面 / 内部の細分化レベル |
omega | 角速度 [rad/s](MRFProperties に書く) |
nonRotatingPatches | ゾーン内でも回転させないパッチ |
wallProximity | {"distance": d, "level": L}: ゾーンの面のうち STL から d 以内の部分だけを L まで細分化する。界面を壁すれすれに置く(狭い隙間の中に置く)場合に、ゾーン面全体を細かくせずに済む |
ami | true にすると、界面をスライディングメッシュ用の 2 つのパッチに分け、dynamicMeshDict を書く(スライディングメッシュ) |
conforming | false にすると界面をメッシュに沿わせず、セル中心が円筒内にあるセルを cellZone にする(MRF 用。AMI には使えない)。界面が狭い隙間の中にあって沿わせられない場合に使う |
出力: cellZones(回転領域)、faceZones(<name>_interface: 円筒界面、向きつき)、
constant/MRFProperties の雛形。複数のゾーンを置けます(重ならないこと)。
狭い隙間の中に界面を置く場合(ローター・ステーターなど): 界面と両側の壁の間にそれぞれ 1 セル以上入るよう、
wallProximity の level を「隙間の半分 ≧ セル寸法」になるように選びます。隙間が狭いほどセル数が急に増えます
(実行例: ローター・ステーター)。
スライディングメッシュ(AMI)
回転ゾーンに "ami": true を付けると、界面の内部面を、回転側のセルが持つ面と静止側のセルが持つ面の 2 つのパッチに分け、
界面の点を回転側だけ複製して切り離します(OpenFOAM の createBaffles と mergeOrSplitBaffles -split / splitBaffles をまとめて行うのと同じ)。
境界層は分ける前に付けます。あわせて constant/dynamicMeshDict(cellZone の剛体回転)を書きます。このゾーンは MRFProperties には書きません。
"rotatingZones": [
{ "name": "rotor",
"cylinder": { "point1": [0, 0, 0.06], "point2": [0, 0, 0.14], "radius": 0.07 },
"surfaceLevel": 2, "volumeLevel": 2, "omega": 31.416,
"ami": true }
],
"openfoam": "com"
書き方は OpenFOAM の配布元によって違うので、openfoam で選びます。
openfoam | パッチ(回転側 / 静止側) | dynamicMeshDict | OpenFOAM での手順 |
|---|---|---|---|
"com"(既定) | <name>_AMI1 / <name>_AMI2、型 cyclicAMI | dynamicMotionSolverFvMesh + solidBody | そのまま使える |
"org10"・"org11"・"org12" | <name>_nonCouple1 / <name>_nonCouple2、型 patch | mover { type motionSolver; ... } | createNonConformalCouples -overwrite <name>_nonCouple1 <name>_nonCouple2 でつなぐ |
- 界面は回転軸まわりの回転面である必要があります(円筒は常に可)。STL で与えたゾーンが回転面でない、または
origin・axisがずれていると警告します。 "conforming": falseのゾーンには使えません。複数のゾーンは、openfoam.com ではmultiSolidBodyMotionSolver、openfoam.org ではmotionSolverListで書きます。- 既存のメッシュは
python -m cutmesh.amiで後から変換できます(コマンドとオプション)。 - ゾーンの縁(円筒の上下の縁)の外側のカットセルは縁を回り込み、その界面の面は縁で折れ曲がります。OpenFOAM は面を中心で扱うので、そのままでは縁が面取りされ、回すと回転側と静止側が合いません。
amiExactRims(既定 true)では、縁を横切る辺に縁の点を入れ、縁の外側のセルを折れた面の一方の平面で 2 つに切って、界面を縁にぴったり沿わせます。 切ると悪いセルになる所はそのまま残し、ログに数を出します。python -m cutmesh.amiはゾーンの形を知らないので、この処理はしません。
書き方は各配布元のチュートリアル(openfoam.com: interFoam/RAS/mixerVesselAMI、openfoam.org 10〜12: mixerVessel2D)に合わせています。
examples/stirred_tank/meshDict_ami.json(約 10 万セル、層流で 90° 回転)で、openfoam.com v2606 の pimpleFoam と OpenFOAM-13 の foamRun("org12" の書き方のまま)は最後まで回ることを確かめました。
OpenFOAM-12 では、このメッシュでも縁のない円筒ゾーンでも、回し始めると cyclicFvPatch::makeWeights の浮動小数点例外で止まりました(同じメッシュが OpenFOAM-13 では回るので、OpenFOAM-12 側の問題とみています)。
円筒ベースメッシュ(baseMesh)
回転機械向けに、八分木の根を直交格子の代わりに軸まわりの同心ブロックにできます。 ブロックの配置(中心の正方形・リングの半径・分割数)は自動で決まるので、最小限の指定は次だけです。
"baseMesh": { "type": "cylindrical", "origin": [0, 0, 0], "axis": [0, 0, 1] }
| キー | 意味 | 既定値 |
|---|---|---|
origin, axis | 回転軸(原点と方向) | [0,0,0], [0,0,1] |
zRange | 軸方向の範囲 [z0, z1](origin からの距離) | STL の範囲 ± baseCellSize |
nz / dz | 軸方向の分割数 / 幅(全ブロック共通) | dz = baseCellSize |
rOuter | 最外ブロックの外半径(自動配置) | STL の半径 + 2/3 × cellSize |
cellSize | 自動配置の目標寸法(半径方向・周方向のセル幅) | baseCellSize と dz の小さい方 |
core, blocks | ブロックを手で指定する場合(下記)。両方書くか、両方書かない | 自動配置 |
maxSizeRatio | ブロック境界をまたぐセル寸法の比の上限 | 2.5 |
自動配置(core と blocks を書かない場合)
- 中心に 2×2 の小さな正方形(半幅
cellSizeの 0.5〜0.95 倍)を置き、半径がその 2 倍の円へつなぐ O グリッドのリング(周方向 8 分割)で囲む。その外側は、半径がおよそ 1.5625 倍ずつ広がる同心リングでrOuterまで埋める。 - 各リングの
nThetaは、リングの中ほどで周方向の幅がcellSizeになる 4 の倍数、半径方向の幅は1.15 × cellSize以下。どの辺もbaseCellSizeの 1.3 倍を超えないので、細分化で余分なレベルが入らない。 - 周方向を向いていないセルは中心の 4 つと最初のリングだけ(軸に軸・ハブなどの固体があれば、多くはその中に入る)。
- STL(領域とゾーン)の軸まわりの円筒(軸・ハブ・槽の壁・翼の先端の円など)と、軸が同じ円筒の回転ゾーン・細分化領域の半径を調べ、その面が層の厚さの 1/3 の位置に来るように半径方向の節点を置く。細分化でセルを半分にしても面はいつもセルの 1/3(または 2/3)の位置にあるので、面に沿って薄いカットセルができない。中心の正方形の大きさも、内側の円筒(軸)が辺の中央から同じように離れるように選ぶ。
- 決まった配置(調べた円筒の半径も)はログに出る。
"core": ..., "blocks": [...]の形なので、そのまま手動指定の出発点にできる(節点が等間隔でないブロックはradiiに半径方向の節点nr + 1個を持つ)。
手動指定
"core": { "halfWidth": 0.0375, "n": 6 },
"blocks": [
{ "rOuter": 0.06, "nr": 2 },
{ "rOuter": 0.10, "nr": 3, "nTheta": 38 },
{ "rOuter": 0.155, "nr": 4 }
]
coreは中心の正方形ブロック(半幅halfWidth、一辺の分割数n)、blocksは外側へ並ぶ同心ブロック(外半径rOuter、半径方向の分割数nr、周方向の分割数nTheta)。- 最初のブロックは正方形から円へつなぐ O グリッドで、
nThetaは4 × core.nに固定。2 番目以降のnThetaは任意(隣のブロックの整数倍でなくてよい)。radii(任意)で半径方向の節点(nr + 1個)を指定できる。 - 最外ブロックの
rOuterは STL の半径より大きくする(小さいと警告。STL は切り取られる)。
共通
- ブロックの境界では両側の面を重ね合わせて共有の面に分けるので、分割数の比が任意でも適合した多面体メッシュになる(AMI 不要)。
- 細分化のレベル L は目標寸法
baseCellSize / 2^Lとして扱う。細分化は 3 方向を同時に半分にするので、軸方向の幅dzより細いベースセルは断面方向に細かくなりすぎる。手動指定では各ブロックのセルが立方体に近くなるように分割数を選ぶ(自動配置はそうなっている)。
境界層(addLayers)
壁パッチにプリズム層を追加します。meshDict に書くと生成後に自動で追加され、既存のメッシュに後から追加することもできます (cutmesh 以外で作った polyMesh でも可)。
# meshDict.json に "addLayers": {...} を書く(例: examples/stirred_tank/meshDict_layers.json)
cutmesh examples/stirred_tank/meshDict_layers.json
# 既存のケースに追加
python -m cutmesh.layers CASE [layerDict.json] [-out CASE2] [-noCheck] [-ascii | -binary]
| キー | 意味 | 既定値 |
|---|---|---|
patches | 層を付けるパッチ名のリスト | type が wall の全パッチ |
nLayers | 層の数 | 3 |
expansionRatio | 壁から内側への層厚の比 | 1.2 |
finalLayerThickness | 最も内側の層の厚さ(relativeSizes なら局所セル寸法比) | 0.3 |
relativeSizes | 厚さを局所セル寸法に対する比で与える | true |
minThickness | 総厚がこれ未満の所は層を付けない | 0.05 |
maxNonOrtho | 非直交角 [deg] がこれを超えるセルは不正とみなし、そこで層を薄くする | 65 |
maxSkewness | 歪度がこれを超える面のセルは不正とみなす(null で無効) | 4 |
maxGapFraction | 総厚を、向かい合う壁までの距離のこの割合以下に抑える(0 で無効) | 0.3 |
maxThicknessSlope | 壁に沿った総厚の変化の上限(層の端を徐々に細らせる) | 0.5 |
このほか minNormalCos, wallNonOrthMargin, cornerStretch, mergeWallPoints,
concaveSlide, nRings, nSmooth, nIter, nCollapseIter があります(README の「境界層」)。
"addLayers": {} は既定値で層を追加します。狭い隙間がある形状では finalLayerThickness を 0.15 程度にすると、
目標の厚さに達する節点が大きく増えます。ログに、目標の厚さに達した壁節点・薄くなった節点・層なしの節点の割合が出ます。
書き出し形式(writeFormat)
polyMesh は既定でバイナリ(OpenFOAM の writeFormat binary と同じ形式)で書き出します。
大きなファイル(points・faces・owner・neighbour)がバイナリになり、
boundary・cellZones・faceZones は ASCII のままです。中身を目で確かめたいときや、
ASCII しか読めないツールに渡すときは "writeFormat": "ascii" にします。
| 約 69 万セル | ASCII | バイナリ |
|---|---|---|
| 書き出し | 4.3〜4.5 秒 | 0.14〜0.19 秒 |
| ファイルの大きさ | 122 MB | 80 MB |
| 読み込み(cutmesh) | 3.1 秒 | 0.18 秒 |
- ヘッダーは
format binary;、arch "LSB;label=32;scalar=64";。facesはfaceCompactList。 - ラベルが 32 ビットに収まらないメッシュは
label=64で書く(64 ビットラベルでビルドした OpenFOAM が必要)。 python -m cutmesh.layersは入力と同じ形式で書く(-ascii/-binaryで指定もできる)。
バイナリの形式は OpenFOAM のソースに合わせて書いていますが、OpenFOAM 本体で読めることはまだ確認していません。読めない場合は
"writeFormat": "ascii" にするか、OpenFOAM の foamFormatConvert で変換してください。
高速化(Rust 拡張)
最近点・内外判定・符号付き距離、回転ゾーンのカット、面とセルの重心と体積、境界層の平滑化などを Rust(BVH + rayon による並列化)で計算します。
Rust ツールチェーン(cargo)があれば次でビルドされ、cutmesh/_core が置かれます。無ければ Python/NumPy の処理で動きます(結果は同じ)。
python tools/build_rust.py # cargo build --release + パッケージへコピー
CUTMESH_NO_RUST=1 python -m cutmesh meshDict.json # Python の処理を強制(比較用)
| 例題 | Python | Rust 拡張あり |
|---|---|---|
| examples/stirred_tank | 26 秒 | 7 秒 |
| 別の実形状(55 万セル) | 162 秒 | 41 秒 |
| 同、境界層の追加(3 層) | 51 秒 | 27 秒 |
設定と入力の検査
メッシュを作り始める前に meshDict.json を検査します。
- エラーで止める(見つかった問題をまとめて 1 つのエラーにする): 必須キーがない、ファイルが見つからない、値の型・範囲が不正、
回転ゾーンの名前の重複・
cylinderとstlの両方/どちらもなし、回転ゾーンどうしの重なり、JSON として読めない。 - 警告(
WARNING: meshDict:): 知らないキー(近いキー名を示す)、surfaceRefinementなどにある名前が STL の solid にない。 cutmeshコマンドはこれらのエラーをトレースバックなしでERROR: ...と表示し、終了コード 1 を返します(引数の誤りは 2)。
入力 STL の自動修正: cutmesh が入力を直したときは、必ずログに REPAIR: で始まる行を出します。黙って直すことはしません。
| 修正 | 理由 |
|---|---|
| 面積 0 の三角形を除く | 法線が決まらず、特徴線や交点の計算を乱す |
| 重複した三角形は 1 枚だけ残す | 内外判定(光線の交差回数の偶奇)で交差が 2 回数えられ、内外が反転する |
| 重なった逆向きの三角形の対(厚さ 0 の膜)は 2 枚とも除く | 同上 |
REPAIR: domain STL: removed 20 zero-area triangles, 50 duplicated triangles (one copy kept) (1350 -> 1280 triangles)
直さずに WARNING: を出すもの: 開いた辺、非多様体の辺、向きの食い違う辺。問題がなければ
domain STL check: closed, consistently oriented, N triangles と出ます。メッシュの完成後には、メッシュの体積を STL の体積と比べます
(volume check: mesh ..., STL ... (+x%))。
コマンドとオプション
パスはリポジトリの直下から実行する場合のものです。pip install -e . をすれば cutmesh と python -m cutmesh.* はどこからでも使えます。
メッシュの生成: cutmesh
cutmesh meshDict.json [-case DIR] [-noCheck] # python -m cutmesh でも同じ
| オプション | 意味 |
|---|---|
-case DIR | 出力先のケースディレクトリ(meshDict の case より優先) |
-noCheck | 生成後の品質チェックを省く |
-h, --help | 使い方を表示する |
終了コード: 0 = 成功、1 = 設定や STL のエラー(ERROR: ... と表示)、2 = 引数の誤り。
境界層の追加: python -m cutmesh.layers
python -m cutmesh.layers CASE [layerDict.json] [-out CASE2] [-noCheck] [-ascii | -binary]
| 引数・オプション | 意味 |
|---|---|
CASE | 層を付けるメッシュのケース(CASE/constant/polyMesh) |
layerDict.json | 層の設定(境界層の表のキー)。meshDict を渡すと、その addLayers を使う。省略すると既定値 |
-out CASE2 | 書き出し先(省略すると CASE を上書き) |
-noCheck | 品質チェックを省く |
-ascii / -binary | 書き出し形式(省略すると入力と同じ) |
スライディングメッシュへの変換: python -m cutmesh.ami
python -m cutmesh.ami CASE [-zone NAME ...] [-openfoam com|org10|org11|org12] [-out CASE2] [-noDynamicMeshDict] [-ascii | -binary]
| 引数・オプション | 意味 |
|---|---|
CASE | cellZone NAME と faceZone NAME_interface を持つメッシュ(cutmesh が書いたもの) |
-zone NAME | 変換するゾーン(複数回指定できる。省略すると、faceZone の対があるゾーンすべて) |
-openfoam | 書き方(既定 com) |
-out CASE2 | 書き出し先(省略すると CASE を上書き) |
-noDynamicMeshDict | dynamicMeshDict を書かない(回転の設定は constant/MRFProperties から読む。変換したゾーンの項目は MRFProperties から取り除く) |
-ascii / -binary | 書き出し形式(省略すると入力と同じ) |
メッシュの確認
| コマンド | 内容 |
|---|---|
python -m cutmesh.diagnose meshDict.json [CASE] | 流体が固体の壁を越えてつながっていないかを調べる(checkLeaks と同じ検査)。CASE を省くと meshDict の case。見つかれば終了コード 1 |
python tools/edge_check.py meshDict.json [-case DIR] | STL の特徴線と円筒ゾーンの縁に沿って、最寄りのメッシュの辺までの距離を最小セル寸法比で表示する(捉えられていれば 0)。メッシュを作り直して測る。-case を付けるとそのメッシュも書き出す |
python benchmark/render_mesh.py CASE [-o OUT] [--title NAME] | 3D 図(overview.png: 壁面、cut.png: 内部の切り口と 3 断面)を描く。品質の悪いセルは赤。-o の既定は CASE の親ディレクトリ |
python benchmark/stl_check.py model.stl [...] [--json] | 入力 STL の診断(開いた辺、非多様体の辺、向きの不一致、重複・面積 0 の三角形、部品の数、体積) |
ベンチマーク: benchmark/run_bench.py
多数の STL をまとめて通し、判定(PASS / WARN / INVALID / ERROR)・セル数・品質・時間を一覧にします。1 ケースずつ別のプロセスで動くので、落ちても他のケースは続きます。
python benchmark/make_synthetic.py # 人工形状の STL を生成(初回だけ)
python benchmark/run_bench.py benchmark/suites/synthetic.json [オプション]
| オプション | 意味 |
|---|---|
-j N | N ケースを並列に走らせる(時間を比べるときは 1 にする) |
--only PATTERN | ケース名で絞る(ワイルドカード可。複数回指定できる) |
--cells-across N | 全ケースのベースセルを「外接箱の最長辺 / N」にする(既定 24) |
--set KEY=JSON | 全ケースの meshDict のキーを上書きする(例: --set addLayers='{"nLayers": 3}') |
--keep | 合格したケースの polyMesh も残す(既定では消す) |
--no-images | 画像を描かない |
--out DIR | 出力先(既定 benchmark/results/<スイート>-<日時>) |
--baseline FILE | 過去の結果と比べ、悪化があれば終了コード 1 |
--save-baseline | 結果を benchmark/baselines/<スイート>.json に保存する |
--timeout SEC | 1 ケースの時間の上限(既定 900 秒) |
--vol-tol X | 体積の差がこの割合を超えたら WARN(既定 0.01) |
--strict | checkMesh より厳しい判定(面の三角形分割の四面体)も WARN に数える |
スイート: synthetic.json(人工形状 26 個)、large.json(約 100 万セル・回転ゾーンなど、速さの確認用)、local.json(手元の実形状)。詳しくは benchmark/README.md。
そのほか
| コマンド | 内容 |
|---|---|
python tools/build_rust.py [--debug] | Rust 拡張をビルドしてパッケージに置く(cargo が必要) |
python examples/stirred_tank/make_geometry.py [--stator GAP_MM] | 攪拌槽の STL を生成する。--stator で翼の外側に隙間 GAP_MM の固定リングを付ける |
python examples/stirred_tank/run.py [meshDict] | 例題のメッシュを作って断面図(slice_z.png, slice_y.png)を描く |
python tools/make_docs_images.py [--only NAME ...] | このサイトの画像を作り直す |
CUTMESH_NO_RUST=1 | 環境変数。Rust 拡張があっても Python の処理を使う(比較用) |
既知の制約
- STL は水密(閉じた・向きの揃った)である必要がある。開いた辺・自己交差は直さない(開いた辺は警告、自己交差は体積チェックの警告で分かることが多い)。
- セルより薄い形状(薄翼・バッフル板)は、その厚さ程度まで細分化が必要。
- 壁と別の壁が交わる入隅や円筒の縁は、セル寸法程度で面取りされることがある。凸の鋭角エッジは厳密カットで捉えるが、凹のエッジや曲面と交わる所の近くでは面取りが残ることがある。
- 歪度 > 4 の境界面が少数残ることがある(checkMesh では 1 項目の失敗になる可能性がある)。
- メモリは 100 万セルあたり約 5 GB 使う。狭い隙間の中に回転ゾーンの界面を置くと、セル数とメモリが急に増える。
- 幾何の問い合わせと回転ゾーンのカットは Rust 拡張に移したが、STL のカット・セル統合・組み立ては Python のままで、時間の大半を占める。