Modelica 標準ライブラリ 4.1.0 で見つかった不整合¶
英語 | 日本語
OpenRheo の 1 次元モデルでは、Modelica 標準ライブラリ(MSL)4.1.0(BSD-3)を C++ に移植している。移植の結果を OpenModelica 1.27.1 で解いた MSL 4.1.0 と照合する過程で、MSL の文書や規格と食い違う箇所が 6 つ見つかった。このページはその記録である(2026-11-20)。
- 対象は MSL のタグ v4.1.0(コミット 8ae3d35)である。行番号はそのファイルのものである。
- どの項目も、移植の誤りではないことを確かめてある。移植を MSL と同じ挙動にすると、OpenModelica の結果と流体で相対 3e-14 以下、水で 1.5e-12 以下で一致する。
- OpenRheo の既定は、文書・文献・規格どおりに直した挙動である。設定で MSL 4.1.0 と同じ挙動にも切り替えられる。
- まだ MSL の開発元には報告していない。報告や確認に使っていただいてかまわない。
一覧¶
| 番号 | 場所 | 内容 | 影響 |
|---|---|---|---|
| Q1 | Fluid.Dissipation:曲がりの圧力損失 |
層流域で損失係数が 2 倍になる | 層流の曲がりの Δp が 2 倍 |
| Q2 | Fluid.Dissipation:曲がり 2 種 |
相対粗さをもう一度直径(m)で割っている | 乱流で Δp が最大 +17 %(曲面)、+24.7 %(角)。相似な曲がりでも寸法で値が変わる |
| Q3 | Fluid.Dissipation:弁の形状 |
Cv→Av の換算係数が 2 か所で違う | 既定値で Av→Cv→Av が 2.4 % ずれる |
| D1 | Media.Water.IF97_Utilities:領域 2 |
理想気体部の係数の 9 桁目が抜けている | h で最大 4.1e-8、cp で最大 3.4e-7。IAPWS の検証表 36 項目のうち 30 項目が合わない |
| D2 | Media.Water.IF97_Utilities:領域 5 |
1997 年版の式のまま(現行は R7-97(2012)) | 相対 1e-6〜4e-6。適用範囲は 10 MPa まで |
| D3 | Media.Water.IF97_Utilities:waterBaseProp_dT |
領域 5 で g5 でなく g2 を呼んでいる |
1073.15 K を超える (d, T) の状態がすべて assert で止まる |
流体(Modelica/Fluid/Dissipation.mo)¶
Q1:曲がりの層流域で損失が 2 倍になる¶
- 場所:
PressureLoss.Bend.dp_curvedOverall_DPの 3043–3049 行(CF_fri)、dp_curvedOverall_MFLOWの 3219–3225 行(CF_3)。 - コード:
CF_fri = 1 + SMOOTH(Re_lam_max, Re_lam_leave, Re)*min(1.4, …) + SMOOTH(Re_lam_leave, Re_lam_max, Re)。 - 食い違い:2 つ目の
SMOOTHの項は Re ≤ Re_lam_leave で 1 になるので、層流域でCF_fri = 2になり、損失係数が 2 倍になる。文書(7985 行)には「Re ≤ 6.5e3 の層流域では粗さによる補正はない」(Idelchik 2006, p.336)とある。 - 確認:Re < 1e3 では、MSL の Δp は直した値のちょうど 2 倍だった。
- OpenRheo の既定:この項を除き、ζ = A2/Re + A1·B1 とする。
Q2:曲がりの粗さが直径で 2 回割られている¶
- 場所:
dp_curvedOverall_DPの 3038 行、dp_curvedOverall_MFLOWの 3211 行、dp_edgedOverall_DPの 3360 行、dp_edgedOverall_MFLOWの 3496・3507・3513・3561 行。 - コード:
lambda_FRI_rough = 0.25/(log10(k/(3.7*d_hyd) + 5.74/Re^0.9))^2で、k = K/d_hydはすでに相対粗さである。 - 食い違い:文書(7953 行)の式は絶対粗さ K を使う
0.25*(lg(K/(3.7*d_hyd) + 5.74/Re^0.9))^-2(Miller 1984, eq. 8.4)である。コードでは相対粗さを直径(m 単位の数値)でもう一度割るので、次元が合わない。直径 1 m 未満では粗さの効果が大きく、1 m を超えると小さく出る。 - 例:k/d = 1e-2、R0/d = 2、Re = 1e6 で、d = 0.05 m では ζ = 0.356、d = 1 m では 0.268 になる。形が相似なら本来は同じ値になる。
- 確認:Re > 1e5 で、MSL の Δp は直した値より、曲面の曲がりで最大 17 %、角の曲がりで最大 24.7 % 大きかった(d = 0.1 m、K = 5e-5 m)。
- OpenRheo の既定:
k/3.7とし、K/d が同じなら寸法によらず同じ ζ にする。
Q3:弁の Cv→Av の換算係数が 2 つある¶
- 場所:
PressureLoss.Valve.dp_severalGeometryOverall_DPの 5911 行と_MFLOWの 6020 行はAv = Cv*24e-6。一方、レコードの既定値dp_severalGeometryOverall_IN_con.Cv = Av/24.6e-6(6111 行)は別の係数を使う。 - 影響:既定値で Av → Cv → Av と換算すると 2.4 % ずれる。なお
Fluid.Valves.BaseClasses.PartialValve.Cv2Av = 24.0e-6(Valves.mo 544 行)は一貫している。 - OpenRheo の既定:両方に IEC 60534 の値 2.4027e-5 m²(1 US gal/min あたり)を使う。
水と蒸気(Modelica/Media/Water/IF97_Utilities.mo)¶
D1:領域 2 の理想気体部の係数¶
IAPWS R7-97(2012) の Table 10 の係数 n_i^o が、9 桁目が抜けて残りの桁がずれた値になっている。
| 係数(J_i^o) | MSL 4.1.0 | IAPWS R7-97(2012) | 相対誤差 |
|---|---|---|---|
| n1^o (0) | -9.6927686002170 | -9.6927686500217 | 5.1e-9 |
| n2^o (1) | 10.0866556801800 | 10.086655968018 | 2.8e-9 |
| n3^o (-5) | -0.0056087911830200 | -0.0056087911283020 | 9.8e-9 |
| n4^o (-4) | 0.071452738814550 | 0.071452738081455 | 1.0e-8 |
| n5^o (-3) | -0.40710498239280 | -0.40710498223928 | 3.8e-10 |
| n6^o (-2) | 1.42408197144400 | 1.4240819171444 | 3.8e-8 |
| n7^o (-1) | -4.3839511194500 | -4.3839511319450 | 2.9e-9 |
| n8^o (2) | -0.284086326077200 | -0.28408632460772 | 5.2e-9 |
| n9^o (3) | 0.0212684635330700 | 0.021268463753307 | 1.0e-8 |
- 現れる場所:
BaseIF97.Basic.g2(1994–1998、2034–2036、2056 行)、g2metastable(2161–2164、2177–2178、2186 行。脚注の準安定の n1^o・n2^o は正しい)、g2pitau(2557–2558 行)、Regions.slowerofp2(557、584 行)、Isentropic.hofpT2(4556–4558 行)、Isentropic.handsofpT2(4644–4650 行)。係数そのものと、その微分の倍数(J n、J(J-1) n)を合わせて 80 個の数値がある。 - 影響:比体積は変わらない(τ の微分だけが変わる)。IAPWS の Table 15・18 に対して、h と u は 1.8e-5〜1.4e-4 kJ/kg(相対 4.1e-8 以下)、s は相対 3.3e-8 以下、w は 2.5e-8 以下、cp は 1.3e-7 以下ずれる。公表値の 9 桁目の半単位を超えるので、36 項目のうち 30 項目が合わない。ReferenceMoistAir の水蒸気の部分にも約 1e-9 で伝わる。
D2:領域 5 の基本式が 1997 年版¶
- 場所:
BaseIF97.Basic.g5(2339 行)とg5pitau(2602 行)。残差項が 5 つの 1997 年版で、適用範囲はdata.PLIMIT5 = 10.0e6(58 行)である。 - 現行:IAPWS R7-97(2012) の式 (32)–(34) と Table 37・38(残差項 6 つ、50 MPa まで)。
- 影響:Table 42 の状態(1500 K、0.5 MPa)で、MSL の値は v で +1.9e-6、h で -1.0e-6、s で -4.6e-7、cp で +3.0e-6、w で +3.5e-6 ずれる。Table 42 の残り 2 状態(30 MPa)は MSL の適用範囲の外である。
- これは誤りというより、古い版の式が使われているという点である。
D3:waterBaseProp_dT の領域 5 で g2 を呼んでいる¶
- 場所:7967 行の
g := BaseIF97.Basic.g2(aux.p, T);。領域 5 のpofdt125の反復の後にある。 - 影響:
g2は T ≤ 1073.15 K を assert で確かめるので、領域 5 の (d, T) の状態はすべて「IF97 medium function g2: the input temperature … is higher than 1073.15 K」で止まる。setState_dTX、p_dT、h_dTなど、1073.15 K を超える*_dTの関数が使えない。 - OpenRheo の既定:
g5を呼ぶ。反復と整合し、p(0.7222559 kg/m³, 1500 K) = 0.5 MPa を 1e-8 で再現する。
意図して MSL のままにした点¶
- 領域 1・2 で T(p,h) と T(p,s) は IF97 の後退式で求め、反復しない。往復の誤差は後退式の許容誤差(|ΔT| ≤ 25 mK)以内である。
- 流体の Moody 線図の遷移域で、順方向と逆方向のスプラインが Re で最大 8.5 % 違う。MSL の文書が認めている近似なので、そのままにした。
確かめ方¶
- 移植した関数を MSL と同じ挙動に切り替え、OpenModelica 1.27.1 で解いた MSL 4.1.0 の結果と比べた(Miyabi の無料キューで実行)。
- 流体は 20 関数・302 行、水は oracle の全列で一致した。そのうえで、直した挙動が文書・文献(Idelchik、Miller、IEC 60534)と IAPWS の検証表(全桁)に合うことを確かめた。
- 切り替えの名前:流体は
msl_quirks(既定 false)、水はif97_variant()(既定Iapws、Msl_4_1_0で MSL と同じ)。