This commit is contained in:
2025-12-07 17:27:49 +08:00
parent 2d953f0e27
commit 4108420559
24 changed files with 169 additions and 138 deletions
@@ -1040,38 +1040,6 @@ public bool OptEnableFeedrate { get; set; }</code></pre>
<a id="Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog_" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*"></a>
<h3 id="Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog">
OptEnableFlatProcLog
</h3>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">[JsAce]
public static bool OptEnableFlatProcLog { 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.boolean">bool</a></dt>
<dd></dd>
</dl>
<a id="Hi_MachiningProcs_RuntimeApi_OptEnableForwardCompensation_" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableForwardCompensation*"></a>
<h3 id="Hi_MachiningProcs_RuntimeApi_OptEnableForwardCompensation" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableForwardCompensation">
@@ -1171,6 +1139,38 @@ public bool OptEnableSideCompensation { get; set; }</code></pre>
<a id="Hi_MachiningProcs_RuntimeApi_OptEnableSituStepAdjustmentLog_" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*"></a>
<h3 id="Hi_MachiningProcs_RuntimeApi_OptEnableSituStepAdjustmentLog" data-uid="Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog">
OptEnableSituStepAdjustmentLog
</h3>
<div class="markdown level1 summary"></div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">[JsAce]
public static bool OptEnableSituStepAdjustmentLog { 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.boolean">bool</a></dt>
<dd></dd>
</dl>
<a id="Hi_MachiningProcs_RuntimeApi_OptExtendedPostDistance_mm_" data-uid="Hi.MachiningProcs.RuntimeApi.OptExtendedPostDistance_mm*"></a>
<h3 id="Hi_MachiningProcs_RuntimeApi_OptExtendedPostDistance_mm" data-uid="Hi.MachiningProcs.RuntimeApi.OptExtendedPostDistance_mm">
@@ -324,19 +324,19 @@ Class NcOptProc
<a id="Hi_NcOpt_NcOptProc_EnableFlatProcLog_" data-uid="Hi.NcOpt.NcOptProc.EnableFlatProcLog*"></a>
<a id="Hi_NcOpt_NcOptProc_EnableSituStepAdjustmentLog_" data-uid="Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog*"></a>
<h3 id="Hi_NcOpt_NcOptProc_EnableFlatProcLog" data-uid="Hi.NcOpt.NcOptProc.EnableFlatProcLog">
EnableFlatProcLog
<h3 id="Hi_NcOpt_NcOptProc_EnableSituStepAdjustmentLog" data-uid="Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog">
EnableSituStepAdjustmentLog
</h3>
<div class="markdown level1 summary"><p>Enable create log file for building situ (independent) FlatExtendedStep process.</p>
<div class="markdown level1 summary"><p>Enable create log file for building situ (independent) StepOptContext process.</p>
</div>
<div class="markdown level1 conceptual"></div>
<div class="codewrapper">
<pre><code class="lang-csharp hljs">public static bool EnableFlatProcLog { get; set; }</code></pre>
<pre><code class="lang-csharp hljs">public static bool EnableSituStepAdjustmentLog { get; set; }</code></pre>
</div>
@@ -87,13 +87,24 @@
<article data-uid="">
<h1 id="release-note">Release Note</h1>
<h2 id="hinc-packages-version-3188">HiNc Packages Version 3.1.88</h2>
<ul>
<li>Rename optimization log API for clarity (see <a href="../../user-guide/zh-Hant/script/NcOptimization/index.html#%E5%84%AA%E5%8C%96%E6%97%A5%E8%AA%8C">優化日誌</a>):
<ul>
<li><code>OptEnableFirstSituProcLog</code>&lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*&gt;</li>
<li><code>OptEnableNcEmbeddedLog</code><a class="xref" href="../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableEmbeddedLog_">OptEnableEmbeddedLog</a></li>
</ul>
</li>
<li>Improve <code>.flatproc.log</code> output to maintain step order during parallel computation</li>
<li>Various stability improvements and bug fixes</li>
</ul>
<h2 id="hinc-packages-version-3186">HiNc Packages Version 3.1.86</h2>
<ul>
<li>Re-build <a class="xref" href="../../../api/Hi.NcOpt.NcOptProc.html">NcOptProc</a> with stricter optimization logics.</li>
<li>Re-build <a class="xref" href="../../../api/Hi.NcOpt.NcOptProc.html">NcOptProc</a> with stricter optimization logics</li>
<li>Add optimization logging features (see <a href="../../user-guide/zh-Hant/script/NcOptimization/index.html#%E5%84%AA%E5%8C%96%E6%97%A5%E8%AA%8C">優化日誌</a>):
<ul>
<li><code>.flatproc.log</code> file output for optimization process analysis.</li>
<li>Embedded log comments in optimized NC file marking source lines with <code>(src)</code> suffix.</li>
<li><code>.flatproc.log</code> file output for optimization process analysis</li>
<li>Embedded log comments in optimized NC file marking source lines with <code>(src)</code> suffix</li>
</ul>
</li>
<li>Fix cutting depth and width accuracy by bounding-box method with workpiece surface</li>
@@ -242,11 +242,31 @@ N0170 X-4.125 Y45.875
<h2 id="優化日誌">優化日誌</h2>
<p>優化過程提供兩種日誌功能,方便分析與除錯。</p>
<h3 id="優化過程日誌檔">優化過程日誌檔</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog_">OptEnableFlatProcLog</a><small>(API)</small>:啟用優化過程日誌檔輸出。預設為真。</p>
<p>&lt;xref:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*&gt;<small>(API)</small>:啟用優化過程日誌檔輸出。預設為真。</p>
<p>啟用後,優化過程會為每個NC檔輸出一個 <code>.flatproc.log</code> 檔案,記錄各步階的優化條件經<a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptExtendedPreDistance_mm">OptExtendedPreDistance_mm</a><small>(API)</small><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptExtendedPostDistance_mm">OptExtendedPostDistance_mm</a><small>(API)</small>展開後獨立優化計算的資訊(不包含步階間的交互關係,如加減速)。</p>
<p>日誌檔案內容依步階順序輸出(即使平行計算時也會保持順序),每行包含:</p>
<ul>
<li>原始NC行位置與步階索引</li>
<li>各項優化限制的計算結果,例如:
<ul>
<li><code>FrtByPreferedForce_mm</code>: 依目標力計算的每刃進給</li>
<li><code>FrtByYieldingStressRatio_mm</code>: 依降伏應力比計算的每刃進給</li>
<li><code>FrtBySpindleTorqueRatio_mm</code>: 依主軸扭力比計算的每刃進給</li>
<li><code>FrtBySpindlePowerRatio_mm</code>: 依主軸功率比計算的每刃進給</li>
<li><code>FrtByThermalYieldingRatio_mm</code>: 依熱降伏比計算的每刃進給</li>
<li><code>FrtByReliefAngle_mm</code>: 依餘隙角碰撞計算的每刃進給</li>
</ul>
</li>
</ul>
<h3 id="嵌入式日誌註解">嵌入式日誌註解</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableEmbeddedLog_">OptEnableEmbeddedLog</a><small>(API)</small>:啟用嵌入式日誌註解。預設為真。</p>
<p>啟用後,優化後的NC檔中會在原始NC行後方加上 <code>(src)</code> 後綴,方便對照原始NC碼與優化後的NC碼。</p>
<p>啟用後,優化後的NC檔中會在NC行後方加上 <code>(src(...))</code> 註解,包含:</p>
<ul>
<li><code>LineNo</code>: 原始NC檔的行號</li>
<li><code>StepIndex</code>: 對應的步階索引</li>
</ul>
<p>例如:<code>G01 X10.0 Y20.0 F500 (src(LineNo: 140, StepIndex: 256))</code></p>
<p>此功能方便對照原始NC碼與優化後的NC碼,並可追蹤每行NC碼對應的步階資訊。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
File diff suppressed because one or more lines are too long
+25 -25
View File
@@ -80143,19 +80143,6 @@ references:
isSpec: "True"
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableFeedrate
nameWithType: RuntimeApi.OptEnableFeedrate
- uid: Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog
name: OptEnableFlatProcLog
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog
commentId: P:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog
nameWithType: RuntimeApi.OptEnableFlatProcLog
- uid: Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog*
name: OptEnableFlatProcLog
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableFlatProcLog_
commentId: Overload:Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog
isSpec: "True"
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableFlatProcLog
nameWithType: RuntimeApi.OptEnableFlatProcLog
- uid: Hi.MachiningProcs.RuntimeApi.OptEnableForwardCompensation
name: OptEnableForwardCompensation
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableForwardCompensation
@@ -80195,6 +80182,19 @@ references:
isSpec: "True"
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableSideCompensation
nameWithType: RuntimeApi.OptEnableSideCompensation
- uid: Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog
name: OptEnableSituStepAdjustmentLog
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableSituStepAdjustmentLog
commentId: P:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog
nameWithType: RuntimeApi.OptEnableSituStepAdjustmentLog
- uid: Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog*
name: OptEnableSituStepAdjustmentLog
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptEnableSituStepAdjustmentLog_
commentId: Overload:Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog
isSpec: "True"
fullName: Hi.MachiningProcs.RuntimeApi.OptEnableSituStepAdjustmentLog
nameWithType: RuntimeApi.OptEnableSituStepAdjustmentLog
- uid: Hi.MachiningProcs.RuntimeApi.OptExtendedPostDistance_mm
name: OptExtendedPostDistance_mm
href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_OptExtendedPostDistance_mm
@@ -113455,19 +113455,19 @@ references:
isSpec: "True"
fullName: Hi.NcOpt.NcOptProc.EnableEmbeddedLog
nameWithType: NcOptProc.EnableEmbeddedLog
- uid: Hi.NcOpt.NcOptProc.EnableFlatProcLog
name: EnableFlatProcLog
href: api/Hi.NcOpt.NcOptProc.html#Hi_NcOpt_NcOptProc_EnableFlatProcLog
commentId: P:Hi.NcOpt.NcOptProc.EnableFlatProcLog
fullName: Hi.NcOpt.NcOptProc.EnableFlatProcLog
nameWithType: NcOptProc.EnableFlatProcLog
- uid: Hi.NcOpt.NcOptProc.EnableFlatProcLog*
name: EnableFlatProcLog
href: api/Hi.NcOpt.NcOptProc.html#Hi_NcOpt_NcOptProc_EnableFlatProcLog_
commentId: Overload:Hi.NcOpt.NcOptProc.EnableFlatProcLog
- uid: Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog
name: EnableSituStepAdjustmentLog
href: api/Hi.NcOpt.NcOptProc.html#Hi_NcOpt_NcOptProc_EnableSituStepAdjustmentLog
commentId: P:Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog
fullName: Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog
nameWithType: NcOptProc.EnableSituStepAdjustmentLog
- uid: Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog*
name: EnableSituStepAdjustmentLog
href: api/Hi.NcOpt.NcOptProc.html#Hi_NcOpt_NcOptProc_EnableSituStepAdjustmentLog_
commentId: Overload:Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog
isSpec: "True"
fullName: Hi.NcOpt.NcOptProc.EnableFlatProcLog
nameWithType: NcOptProc.EnableFlatProcLog
fullName: Hi.NcOpt.NcOptProc.EnableSituStepAdjustmentLog
nameWithType: NcOptProc.EnableSituStepAdjustmentLog
- uid: Hi.NcOpt.NcOptProc.MakeXmlSource(System.String,System.String,System.Boolean)
name: MakeXmlSource(string, string, bool)
href: api/Hi.NcOpt.NcOptProc.html#Hi_NcOpt_NcOptProc_MakeXmlSource_System_String_System_String_System_Boolean_