コンテンツにスキップ

Modelica 標準ライブラリ 4.1.0 で見つかった不整合

英語 | 日本語

« 1 次元モデル

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 と同じ)。