fix SoftNcRunner GM code normalization.

2026-05-06 13:21:19 +08:00
parent 0fe9497552
commit 2f57932000
1238 changed files with 69405 additions and 22511 deletions
@@ -6,7 +6,7 @@
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <meta name="title" content="Class CoolantHeatCondition | HiAPI-C# 2025 ">
      
-      <meta name="description" content="Represents the heat condition parameters for coolant in machining operations.">
+      <meta name="description" content="Represents the heat condition parameters for coolant in machining operations. Provides effective convection-coefficient lookups keyed by  — Flood uses the configured baseline ; Mist scales it by ; Off falls back to  (natural/forced air).">
      <link rel="icon" href="../img/HiAPI.favicon.ico">
      <link rel="stylesheet" href="../public/docfx.min.css">
      <link rel="stylesheet" href="../public/main.css">
@@ -97,7 +97,12 @@ Class CoolantHeatCondition
  <dl><dt>Assembly</dt><dd>HiMech.dll</dd></dl>
  </div>

-  <div class="markdown summary"><p>Represents the heat condition parameters for coolant in machining operations.</p>
+  <div class="markdown summary"><p>Represents the heat condition parameters for coolant in machining operations.
+Provides effective convection-coefficient lookups keyed by
+<a class="xref" href="Hi.Numerical.CoolantMode.html">CoolantMode</a> — Flood uses the configured baseline
+<a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_CoolantConvectionCoefficient_Wdm2K">CoolantConvectionCoefficient_Wdm2K</a>; Mist scales it by
+<a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_MistFloodConvectionRatio">MistFloodConvectionRatio</a>; Off falls back to
+<a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_OffConvectionCoefficient_Wdm2K">OffConvectionCoefficient_Wdm2K</a> (natural/forced air).</p>
 </div>
  <div class="markdown conceptual"></div>

@@ -255,7 +260,8 @@ Class CoolantHeatCondition
  
  </h3>

-  <div class="markdown level1 summary"><p>Gets or sets the coolant heat transfer coefficient in Watts per square meter per Kelvin.</p>
+  <div class="markdown level1 summary"><p>Gets or sets the coolant heat transfer coefficient (flood baseline)
+in Watts per square meter per Kelvin.</p>
 </div>
  <div class="markdown level1 conceptual"></div>

@@ -293,7 +299,8 @@ coolant: 1e3 (ref by &ldquo;Modeling heat transfer in die milling&rdquo;, 2014)<
  
  </h3>

-  <div class="markdown level1 summary"><p>Gets or sets the coolant heat transfer coefficient in Watts per square millimeter per Kelvin.</p>
+  <div class="markdown level1 summary"><p>Gets or sets the coolant heat transfer coefficient (flood baseline)
+in Watts per square millimeter per Kelvin.</p>
 </div>
  <div class="markdown level1 conceptual"></div>

@@ -382,6 +389,91 @@ coolant: 1e3 (ref by &ldquo;Modeling heat transfer in die milling&rdquo;, 2014)<



+  <a id="Hi_Physics_CoolantHeatCondition_MistFloodConvectionRatio_" data-uid="Hi.Physics.CoolantHeatCondition.MistFloodConvectionRatio*"></a>
+
+  <h3 id="Hi_Physics_CoolantHeatCondition_MistFloodConvectionRatio" data-uid="Hi.Physics.CoolantHeatCondition.MistFloodConvectionRatio">
+  MistFloodConvectionRatio
+  
+  </h3>
+
+  <div class="markdown level1 summary"><p>Convection-coefficient ratio of mist coolant (MQL) relative to flood
+coolant. Applied multiplicatively to
+<a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_CoolantConvectionCoefficient_Wdm2K">CoolantConvectionCoefficient_Wdm2K</a> when the current
+<a class="xref" href="Hi.Numerical.CoolantMode.html">CoolantMode</a> is <a class="xref" href="Hi.Numerical.CoolantMode.html#Hi_Numerical_CoolantMode_Mist">Mist</a>.</p>
+</div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public double MistFloodConvectionRatio { get; set; }</code></pre>
+  </div>
+
+
+
+
+
+  <h4 class="section">Property Value</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+  <h4 class="section" id="Hi_Physics_CoolantHeatCondition_MistFloodConvectionRatio_remarks">Remarks</h4>
+  <div class="markdown level1 remarks"><p>Default <code>0.5</code>. Industry handbooks place MQL at roughly half the
+heat removal of flood coolant — UNIST MQL Handbook: &ldquo;actual heat
+removal is generally about half of that removed by a flood coolant&rdquo;.
+Empirical milling / turning measurements on AISI 1045 steel give
+ΔT_flood ≈ 230 °C vs ΔT_mist ≈ 170 °C relative to dry (Mist ≈ 0.74
+of flood), while tool-life / surface-finish studies on aluminium and
+titanium range 0.4–0.8. The single-number <code>0.5</code> default is the
+conservative midpoint; projects that characterise their own MQL
+system should override via XML.</p>
+</div>
+
+
+
+
+  <a id="Hi_Physics_CoolantHeatCondition_OffConvectionCoefficient_Wdm2K_" data-uid="Hi.Physics.CoolantHeatCondition.OffConvectionCoefficient_Wdm2K*"></a>
+
+  <h3 id="Hi_Physics_CoolantHeatCondition_OffConvectionCoefficient_Wdm2K" data-uid="Hi.Physics.CoolantHeatCondition.OffConvectionCoefficient_Wdm2K">
+  OffConvectionCoefficient_Wdm2K
+  
+  </h3>
+
+  <div class="markdown level1 summary"><p>Gets or sets the convection coefficient when coolant is off
+(ambient air / forced blow-off), in Watts per square meter per Kelvin.</p>
+</div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public double OffConvectionCoefficient_Wdm2K { get; set; }</code></pre>
+  </div>
+
+
+
+
+
+  <h4 class="section">Property Value</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+  <h4 class="section" id="Hi_Physics_CoolantHeatCondition_OffConvectionCoefficient_Wdm2K_remarks">Remarks</h4>
+  <div class="markdown level1 remarks"><p>Natural convection in still air is ~5–25 W/(m²·K); forced air
+(shop blow-off / chip conveyor draft) falls in 10–500 W/(m²·K).
+Default <code>50</code> W/(m²·K) represents a mild forced-air environment
+typical of a running machine enclosure.</p>
+</div>
+
+
+
+
  <a id="Hi_Physics_CoolantHeatCondition_XName_" data-uid="Hi.Physics.CoolantHeatCondition.XName*"></a>

  <h3 id="Hi_Physics_CoolantHeatCondition_XName" data-uid="Hi.Physics.CoolantHeatCondition.XName">
@@ -418,6 +510,84 @@ coolant: 1e3 (ref by &ldquo;Modeling heat transfer in die milling&rdquo;, 2014)<
 </h2>


+  <a id="Hi_Physics_CoolantHeatCondition_GetEffectiveConvectionCoefficient_Wdm2K_" data-uid="Hi.Physics.CoolantHeatCondition.GetEffectiveConvectionCoefficient_Wdm2K*"></a>
+
+  <h3 id="Hi_Physics_CoolantHeatCondition_GetEffectiveConvectionCoefficient_Wdm2K_Hi_Numerical_CoolantMode_" data-uid="Hi.Physics.CoolantHeatCondition.GetEffectiveConvectionCoefficient_Wdm2K(Hi.Numerical.CoolantMode)">
+  GetEffectiveConvectionCoefficient_Wdm2K(CoolantMode)
+  
+  </h3>
+
+  <div class="markdown level1 summary"><p>Gets the effective convection coefficient for the given coolant mode
+in Watts per square meter per Kelvin.</p>
+<ul><li><a class="xref" href="Hi.Numerical.CoolantMode.html#Hi_Numerical_CoolantMode_Flood">Flood</a>: <a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_CoolantConvectionCoefficient_Wdm2K">CoolantConvectionCoefficient_Wdm2K</a></li><li><a class="xref" href="Hi.Numerical.CoolantMode.html#Hi_Numerical_CoolantMode_Mist">Mist</a>: <a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_CoolantConvectionCoefficient_Wdm2K">CoolantConvectionCoefficient_Wdm2K</a> × <a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_MistFloodConvectionRatio">MistFloodConvectionRatio</a></li><li><a class="xref" href="Hi.Numerical.CoolantMode.html#Hi_Numerical_CoolantMode_Off">Off</a> / <a class="xref" href="Hi.Numerical.CoolantMode.html#Hi_Numerical_CoolantMode_UnDefined">UnDefined</a>: <a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_OffConvectionCoefficient_Wdm2K">OffConvectionCoefficient_Wdm2K</a></li></ul>
+</div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public double GetEffectiveConvectionCoefficient_Wdm2K(CoolantMode mode)</code></pre>
+  </div>
+
+  <h4 class="section">Parameters</h4>
+  <dl class="parameters">
+    <dt><code>mode</code> <a class="xref" href="Hi.Numerical.CoolantMode.html">CoolantMode</a></dt>
+    <dd></dd>
+  </dl>
+
+  <h4 class="section">Returns</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+
+
+
+
+
+
+
+  <a id="Hi_Physics_CoolantHeatCondition_GetEffectiveConvectionCoefficient_Wdmm2K_" data-uid="Hi.Physics.CoolantHeatCondition.GetEffectiveConvectionCoefficient_Wdmm2K*"></a>
+
+  <h3 id="Hi_Physics_CoolantHeatCondition_GetEffectiveConvectionCoefficient_Wdmm2K_Hi_Numerical_CoolantMode_" data-uid="Hi.Physics.CoolantHeatCondition.GetEffectiveConvectionCoefficient_Wdmm2K(Hi.Numerical.CoolantMode)">
+  GetEffectiveConvectionCoefficient_Wdmm2K(CoolantMode)
+  
+  </h3>
+
+  <div class="markdown level1 summary"><p>Mode-dependent convection coefficient in Watts per square
+millimetre per Kelvin (direct input to the FEM layer). See
+<a class="xref" href="Hi.Physics.CoolantHeatCondition.html#Hi_Physics_CoolantHeatCondition_GetEffectiveConvectionCoefficient_Wdm2K_Hi_Numerical_CoolantMode_">GetEffectiveConvectionCoefficient_Wdm2K(CoolantMode)</a>.</p>
+</div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">public double GetEffectiveConvectionCoefficient_Wdmm2K(CoolantMode mode)</code></pre>
+  </div>
+
+  <h4 class="section">Parameters</h4>
+  <dl class="parameters">
+    <dt><code>mode</code> <a class="xref" href="Hi.Numerical.CoolantMode.html">CoolantMode</a></dt>
+    <dd></dd>
+  </dl>
+
+  <h4 class="section">Returns</h4>
+  <dl class="parameters">
+    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+
+
+
+
+
+
+
  <a id="Hi_Physics_CoolantHeatCondition_MakeXmlSource_" data-uid="Hi.Physics.CoolantHeatCondition.MakeXmlSource*"></a>

  <h3 id="Hi_Physics_CoolantHeatCondition_MakeXmlSource_System_String_System_String_System_Boolean_" data-uid="Hi.Physics.CoolantHeatCondition.MakeXmlSource(System.String,System.String,System.Boolean)">