HiNC-Deploy/HiNC-2025-win-desktop-Deploy
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

tune

Browse Source
This commit is contained in:
iamboss
2025-12-05 16:33:37 +08:00
parent dbbe3303b3
commit 9de88d2db0
163 changed files with 5633 additions and 2293 deletions
Download Patch File Download Diff File Expand all files Collapse all files
App/wwwroot/HiAPI-docsite/brief/user-guide/zh-Hant/script/Mapping/index.html
+72 -9
View File
@@ -84,7 +84,7 @@
<nav id="breadcrumb"></nav>
</div>
<article data-uid="">
<article data-uid="Cmd-Mapping">
<h1 id="資料映射">資料映射</h1>
<p>資料映射指，將外部資料對應於仿真路徑，使得仿真步(<a class="xref" href="../../output/simulation-step-output.html">仿真步輸出資訊（Simulation Step Output）</a>)可以索引外部資料。</p>
@@ -94,25 +94,58 @@
<p>依據資料大小、應用情境不同，資料映射有多種形式。
資料映射可以一對一與一對多。</p>
<p>以資料量區分，<strong>仿真步</strong>對應<strong>外部資料</strong>可以一對一與一對多。</p>
<p>一對一的資料映射方式見<a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>，適用控制器資料。<a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>可以與一對多的資料映射協同使用。</p>
<p>一對多的形式則由本章節說明，適用智慧刀把、加速規、測力計等高採樣率資料，齊資料量皆數十倍於仿真步數量。</p>
<h3 id="一對一映射">一對一映射</h3>
<p>一對一映射指每個仿真步對應一個外部資料點，資料量與仿真步數量相同或相近。</p>
<p>一對一的資料映射方式：</p>
<ul>
<li><a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>：適用控制器資料，每個步階對應一個CSV資料行</li>
<li><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_ReadCsvByTimeInterpolation_">ReadCsvByTimeInterpolation</a><small>(API)</small>：使用時間插值將CSV資料映射到加工步階</li>
</ul>
<h3 id="一對多映射">一對多映射</h3>
<p>一對多映射指每個仿真步對應多個外部資料點，外部資料量遠大於仿真步數量（通常數十倍以上）。</p>
<p>一對多的形式適用智慧刀把、加速規、測力計等高採樣率資料。</p>
<p>一對多的資料映射可以直接<a href="#%E5%B0%8D%E6%87%89%E7%9C%9F%E5%AF%A6%E5%8A%A0%E5%B7%A5%E6%99%82%E9%96%93%E5%85%A8%E5%B1%80%E6%98%A0%E5%B0%84">對應真實加工時間全局映射</a>，也可以對<a href="#%E6%8C%87%E5%AE%9A%E6%95%B8%E6%8E%A7%E8%B7%AF%E5%BE%91%E5%8F%8A%E6%99%82%E9%96%93%E5%B1%80%E9%83%A8%E6%98%A0%E5%B0%84">指定數控路徑及時間局部映射</a>。</p>
<p>一對多的資料映射的格式見<a href="#%E5%A4%96%E9%83%A8%E8%B3%87%E6%96%99%E6%AA%94%E6%A1%88%E6%A0%BC%E5%BC%8F">外部資料檔案格式</a>。</p>
<h2 id="對應真實加工時間全局映射">對應真實加工時間全局映射</h2>
<p>需使用<a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>作為前置，以獲取真實加工時間，csv檔案中須包含<code>ActualTime</code>欄位(<a class="xref" href="../../../../../api/Hi.MachiningSteps.MachiningStep.html#Hi_MachiningSteps_MachiningStep_ActualTime">ActualTime</a>)。然後使用<code>MapByActualTime</code>(<a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_MapByActualTime_">MapByActualTime</a>)映射外部資料。</p>
<h2 id="一對一映射-1">一對一映射</h2>
<h3 id="playcsvfile">PlayCsvFile</h3>
<p><a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a> 可以與一對多的資料映射協同使用，詳見 <a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>。</p>
<h3 id="readcsvbytimeinterpolation">ReadCsvByTimeInterpolation</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_ReadCsvByTimeInterpolation_">ReadCsvByTimeInterpolation</a><small>(API)</small> 讀取CSV檔案並使用時間插值將資料映射到加工步階。每個仿真步對應一個外部資料點（透過時間插值計算）。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">ReadCsvByTimeInterpolation(&lt;CSV檔案路徑&gt;);
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 讀取CSV檔案並映射到步階
PlayNcFile(&quot;NC/file1.nc&quot;);
ReadCsvByTimeInterpolation(&quot;Data/sensor.csv&quot;);
</code></pre>
</div>
<div class="NOTE">
<h5>Note</h5>
<p>此方法使用時間插值方式將CSV資料映射到加工步階，適用於需要將外部感測器資料對應到仿真步階的場景。每個仿真步會對應一個透過時間插值計算的外部資料點。</p>
</div>
<h2 id="一對多映射-1">一對多映射</h2>
<h3 id="對應真實加工時間全局映射">對應真實加工時間全局映射</h3>
<p>需使用<a class="xref" href="../PlayCsvFile/play-csv-file.html">執行CSV檔</a>作為前置，以獲取真實加工時間，csv檔案中須包含<code>ActualTime</code>欄位(<a class="xref" href="../../../../../api/Hi.MachiningSteps.MachiningStep.html#Hi_MachiningSteps_MachiningStep_ActualTime">ActualTime</a><small>(API)</small>)。然後使用<a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_MapByActualTime_">MapByActualTime</a><small>(API)</small>映射外部資料。</p>
<p>此方法為一對多映射，每個仿真步會對應多個外部資料點。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code>MapByActualTime(&lt;檔案名&gt;);
</code></pre>
</div>
<h2 id="指定數控路徑及時間局部映射">指定數控路徑及時間局部映射</h2>
<h3 id="指定數控路徑及時間局部映射">指定數控路徑及時間局部映射</h3>
<p>資料映射需設定：指定輸入資料、指定NC路徑。</p>
<p>此方法為一對多映射，每個仿真步會對應多個外部資料點。</p>
<figure class="alert text-bg-light">
<img src="Mapping%20Overview%20Example.png" alt="Mapping Overview Example">
<figcaption>資料映射圖例</figcaption>
</figure>
<h3 id="指定輸入資料">指定輸入資料</h3>
<h4 id="指定輸入資料">指定輸入資料</h4>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
@@ -137,7 +170,7 @@ AddTimeDataByFile( &quot;lineB&quot;, &quot;Mapping/sensor1.csv&quot;, &quot;18:
PlayNcFile(&quot;NC/file1.nc&quot;)
</code></pre>
</div>
<h3 id="指定nc路徑">指定NC路徑</h3>
<h4 id="指定nc路徑">指定NC路徑</h4>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
@@ -282,6 +315,36 @@ X25. F10 (;@LineSelection(&quot;lineB&quot;, FirstTouch, null, LastTouch, null);
...
</code></pre>
</div>
<h2 id="其他設置">其他設置</h2>
<h3 id="自動映射設定">自動映射設定</h3>
<p><a class="xref" href="../../../../../api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_EnableAutoMapOnSelectionEnd">EnableAutoMapOnSelectionEnd</a><small>(API)</small> 設定是否在選擇結束時自動執行映射。</p>
<div class="NOTE">
<h5>Note</h5>
<p><strong>指令格式</strong></p>
<pre><code class="lang-csharp">EnableAutoMapOnSelectionEnd = true; // 或 false
</code></pre>
</div>
<div class="TIP">
<h5>Tip</h5>
<p><strong>指令範例</strong></p>
<pre><code class="lang-csharp">// 啟用自動映射
EnableAutoMapOnSelectionEnd = true;
BeginSelection(&quot;region1&quot;);
// ... NC 代碼 ...
EndSelection(&quot;region1&quot;); // 自動執行映射
// 停用自動映射
EnableAutoMapOnSelectionEnd = false;
BeginSelection(&quot;region2&quot;);
// ... NC 代碼 ...
EndSelection(&quot;region2&quot;); // 不自動執行映射
Map(&quot;region2&quot;); // 手動執行映射
</code></pre>
</div>
<div class="NOTE">
<h5>Note</h5>
<p>預設值為 <code>true</code>。當設為 <code>true</code> 時，<code>EndSelection</code> 會自動執行對應的 <code>Map</code> 操作。</p>
</div>
</article>