This commit is contained in:
2026-09-09 17:35:23 +08:00
parent 2a98ae7556
commit 161af68fe3
1271 changed files with 58251 additions and 98639 deletions
@@ -143,10 +143,35 @@
</code></pre>
<p>The time format is <code>&lt;hours&gt;:&lt;minutes&gt;:&lt;seconds&gt;.&lt;fractional seconds&gt;</code>. Additional fields (e.g., <code>CH1</code>, <code>CH2</code>) may be included and will be available after mapping.</p>
<h3 id="controller-data-format-for-two-layer-mapping">Controller Data Format (for Two-Layer Mapping)</h3>
<p>The controller CSV must contain at least <code>FileNo</code>, <code>LineNo</code>, and <code>ActualTime</code>:</p>
<pre><code class="lang-csv">FileNo,LineNo,ActualTime,MC.X,MC.Y,MC.Z,...
1,6,00:00:00.030,0,0,0.37,...
<p>The controller CSV must contain <code>FileNo</code>, <code>LineNo</code> and <strong>one of three time columns</strong>:</p>
<pre><code class="lang-csv">FileNo,LineNo,ActualTimecode,ActualDateTime,MC.X,MC.Y,MC.Z,...
1,6,00:00:00.030,2026-03-16 15:57:45.559000,0,0,0.37,...
</code></pre>
<table>
<thead>
<tr>
<th>Time column</th>
<th>What it carries</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>ActualTimecode</code></td>
<td>The run-relative timecode written by <a class="xref" href="../api/Hi.MachiningProcs.SessionShell.html#Hi_MachiningProcs_SessionShell_WriteStepFiles_">WriteStepFiles</a><small>(API)</small>. <code>ActualDateTime</code>, the absolute controller instant, rides beside it and is optional.</td>
</tr>
<tr>
<td><code>ActualTime</code></td>
<td>The legacy single column, still read. A bare timecode cell is used as-is; an absolute date-time cell is rebased through the mapping anchor's converter.</td>
</tr>
<tr>
<td><code>EndTimecode</code></td>
<td>The simulated end timecode, used as a fallback when neither of the above parses. Files written before that rename carry <code>AccumulatedTime</code>, which is also accepted.</td>
</tr>
</tbody>
</table>
<p>A header row with none of the three is refused by name rather than mapped to nothing. <strong>A file this
product exported carries the first pair</strong>, not the legacy column — which is why a step file plays
back and maps without editing its headers.</p>
<hr>
<h2 id="2-configure-time-mapping">2. Configure Time Mapping</h2>
<h3 id="strategy-a-one-to-one-mapping-mapsinglebycsvfile">Strategy A: One-to-One Mapping (MapSingleByCsvFile)</h3>
@@ -309,8 +334,8 @@ WriteStepFiles(&quot;Output/[NcName].step.csv&quot;);
<ul>
<li><a class="xref" href="force-training.html">Workflow: Milling Force Parameter Training</a> — using mapped data for coefficient training</li>
<li><a class="xref" href="basic-simulation.html">Workflow: Basic Machining Simulation</a> — basic simulation setup</li>
<li><a class="xref" href="../manual/runtime/step.html">Step</a> — step data model</li>
<li><a class="xref" href="../manual/runtime/session-shell.html">Glossary: SessionShell Quick-Reference</a> — SessionShell quick-reference</li>
<li><a class="xref" href="../technique/scripting/step.html">Step</a> — step data model</li>
<li><a class="xref" href="../technique/scripting/session-shell.html">SessionShell</a> — SessionShell quick-reference</li>
<li><a class="xref" href="examples/mapping-demo.html">Example Project: Mapping Controller and Sensor Data to Simulated NC Toolpaths and Updating Milling Coefficients</a> — mapping demo example project</li>
<li><a class="xref" href="examples/milling-training-dynamometer.html">Example Project: Training Milling Coefficients with a Dynamometer</a> — dynamometer training example project</li>
</ul>