diff --git a/App/Hi.Wpf.dll b/App/Hi.Wpf.dll
index a685790..2a24d93 100644
Binary files a/App/Hi.Wpf.dll and b/App/Hi.Wpf.dll differ
diff --git a/App/HiCbtr.dll b/App/HiCbtr.dll
index e5a4704..67105ec 100644
Binary files a/App/HiCbtr.dll and b/App/HiCbtr.dll differ
diff --git a/App/HiDisp.dll b/App/HiDisp.dll
index e580f04..df4458f 100644
Binary files a/App/HiDisp.dll and b/App/HiDisp.dll differ
diff --git a/App/HiGeom.dll b/App/HiGeom.dll
index 803bf3c..f9173ab 100644
Binary files a/App/HiGeom.dll and b/App/HiGeom.dll differ
diff --git a/App/HiLicense.dll b/App/HiLicense.dll
index 3e76199..9762505 100644
Binary files a/App/HiLicense.dll and b/App/HiLicense.dll differ
diff --git a/App/HiMech.dll b/App/HiMech.dll
index 59b84f1..06e939e 100644
Binary files a/App/HiMech.dll and b/App/HiMech.dll differ
diff --git a/App/HiNC-2025-win-desktop.deps.json b/App/HiNC-2025-win-desktop.deps.json
index ff03639..145e4e4 100644
--- a/App/HiNC-2025-win-desktop.deps.json
+++ b/App/HiNC-2025-win-desktop.deps.json
@@ -11,8 +11,8 @@
         "dependencies": {
           "AvalonEdit": "6.3.0.90",
           "FontAwesome.Sharp": "6.3.0",
-          "Hi.Wpf": "3.1.54",
-          "HiNc": "3.1.75",
+          "Hi.Wpf": "3.1.55",
+          "HiNc": "3.1.76",
           "Microsoft.Extensions.Configuration.Json": "9.0.0",
           "Microsoft.Extensions.DependencyInjection": "9.0.0",
           "Microsoft.Extensions.Hosting": "9.0.0",
@@ -1659,39 +1659,39 @@
         }
       },
       "Grpc.Tools/2.66.0": {},
-      "Hi.Wpf/3.1.54": {
+      "Hi.Wpf/3.1.55": {
         "dependencies": {
-          "HiDisp": "3.1.59"
+          "HiDisp": "3.1.60"
         },
         "runtime": {
           "lib/net9.0-windows7.0/Hi.Wpf.dll": {
-            "assemblyVersion": "3.1.54.0",
-            "fileVersion": "3.1.54.0"
+            "assemblyVersion": "3.1.55.0",
+            "fileVersion": "3.1.55.0"
           }
         }
       },
-      "HiCbtr/3.1.59": {
+      "HiCbtr/3.1.60": {
         "dependencies": {
-          "HiDisp": "3.1.59"
+          "HiDisp": "3.1.60"
         },
         "runtime": {
           "lib/net9.0/HiCbtr.dll": {
-            "assemblyVersion": "3.1.59.0",
-            "fileVersion": "3.1.59.0"
+            "assemblyVersion": "3.1.60.0",
+            "fileVersion": "3.1.60.0"
           }
         }
       },
-      "HiDisp/3.1.59": {
+      "HiDisp/3.1.60": {
         "dependencies": {
-          "HiGeom": "3.1.54",
+          "HiGeom": "3.1.55",
           "System.Configuration.ConfigurationManager": "9.0.10",
           "System.Drawing.Common": "9.0.10",
           "System.Resources.Extensions": "9.0.10"
         },
         "runtime": {
           "lib/net9.0/HiDisp.dll": {
-            "assemblyVersion": "3.1.59.0",
-            "fileVersion": "3.1.59.0"
+            "assemblyVersion": "3.1.60.0",
+            "fileVersion": "3.1.60.0"
           }
         },
         "native": {
@@ -1706,7 +1706,7 @@
           }
         }
       },
-      "HiGeom/3.1.54": {
+      "HiGeom/3.1.55": {
         "dependencies": {
           "Google.Protobuf": "3.28.3",
           "Grpc.AspNetCore": "2.66.0",
@@ -1717,8 +1717,8 @@
         },
         "runtime": {
           "lib/net9.0/HiGeom.dll": {
-            "assemblyVersion": "3.1.54.0",
-            "fileVersion": "3.1.54.0"
+            "assemblyVersion": "3.1.55.0",
+            "fileVersion": "3.1.55.0"
           }
         },
         "resources": {
@@ -1730,27 +1730,27 @@
           }
         }
       },
-      "HiLicense/3.1.54": {
+      "HiLicense/3.1.55": {
         "dependencies": {
-          "HiGeom": "3.1.54"
+          "HiGeom": "3.1.55"
         },
         "runtime": {
           "lib/net9.0/HiLicense.dll": {
-            "assemblyVersion": "3.1.54.0",
-            "fileVersion": "3.1.54.0"
+            "assemblyVersion": "3.1.55.0",
+            "fileVersion": "3.1.55.0"
           }
         }
       },
-      "HiMech/3.1.66": {
+      "HiMech/3.1.67": {
         "dependencies": {
           "CommandLineParser": "2.9.1",
-          "HiCbtr": "3.1.59",
+          "HiCbtr": "3.1.60",
           "Microsoft.CodeAnalysis.CSharp.Scripting": "4.14.0"
         },
         "runtime": {
           "lib/net9.0/HiMech.dll": {
-            "assemblyVersion": "3.1.66.0",
-            "fileVersion": "3.1.66.0"
+            "assemblyVersion": "3.1.67.0",
+            "fileVersion": "3.1.67.0"
           }
         },
         "resources": {
@@ -1765,20 +1765,20 @@
           }
         }
       },
-      "HiNc/3.1.75": {
+      "HiNc/3.1.76": {
         "dependencies": {
           "Google.Protobuf": "3.28.3",
           "Grpc.AspNetCore": "2.66.0",
           "Grpc.Net.Client": "2.66.0",
-          "HiLicense": "3.1.54",
-          "HiMech": "3.1.66",
-          "HiUniNc": "3.1.63",
+          "HiLicense": "3.1.55",
+          "HiMech": "3.1.67",
+          "HiUniNc": "3.1.64",
           "System.IO.Pipelines": "9.0.10"
         },
         "runtime": {
           "lib/net9.0/HiNc.dll": {
-            "assemblyVersion": "3.1.75.0",
-            "fileVersion": "3.1.75.0"
+            "assemblyVersion": "3.1.76.0",
+            "fileVersion": "3.1.76.0"
           }
         },
         "resources": {
@@ -1790,14 +1790,14 @@
           }
         }
       },
-      "HiUniNc/3.1.63": {
+      "HiUniNc/3.1.64": {
         "dependencies": {
-          "HiMech": "3.1.66"
+          "HiMech": "3.1.67"
         },
         "runtime": {
           "lib/net9.0/HiUniNc.dll": {
-            "assemblyVersion": "3.1.63.0",
-            "fileVersion": "3.1.63.0"
+            "assemblyVersion": "3.1.64.0",
+            "fileVersion": "3.1.64.0"
           }
         }
       },
@@ -2442,61 +2442,61 @@
       "path": "grpc.tools/2.66.0",
       "hashPath": "grpc.tools.2.66.0.nupkg.sha512"
     },
-    "Hi.Wpf/3.1.54": {
+    "Hi.Wpf/3.1.55": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-cYCjlGhyL1bpRDuD1uIKV96P8AaebRz850zn75kT6inM/RhAD9RgD5ANUnJpFMc7ZP8T6pJvsI9mfTUdjHy5Fw==",
-      "path": "hi.wpf/3.1.54",
-      "hashPath": "hi.wpf.3.1.54.nupkg.sha512"
+      "sha512": "sha512-aif4JEWfhih3uleCJceBLtHYZ3nsmAKdc/sSut4KpVsQpEJDlAb8GyCBcn+ZWVwh7gJGe2GmsBuu81KI//Ochg==",
+      "path": "hi.wpf/3.1.55",
+      "hashPath": "hi.wpf.3.1.55.nupkg.sha512"
     },
-    "HiCbtr/3.1.59": {
+    "HiCbtr/3.1.60": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-mbcoIwhznaUo3wYl7JGPqXmA6jDhbz3vm+sJHodQHlEngk4Gn4DdsJrwCtjAdqcYtAq0nLKAs7NmzBSM42jC5Q==",
-      "path": "hicbtr/3.1.59",
-      "hashPath": "hicbtr.3.1.59.nupkg.sha512"
+      "sha512": "sha512-3adQkSPUz32Bdp4ZCfS86zBTfoBFpBt6tqfJZ/jKxbJxasxmzX3iOAhoDNaOH7Ou/h074CSiYCESMwf83Cloxw==",
+      "path": "hicbtr/3.1.60",
+      "hashPath": "hicbtr.3.1.60.nupkg.sha512"
     },
-    "HiDisp/3.1.59": {
+    "HiDisp/3.1.60": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-zX+EQCx7it8cWAKZNNSCEVV65UxSvDks/nb85hJGZhq2bjNp4upth+daj19yVJFiB7J+8tGiovLZqfeRl6vurA==",
-      "path": "hidisp/3.1.59",
-      "hashPath": "hidisp.3.1.59.nupkg.sha512"
+      "sha512": "sha512-c5W29uGAUZz+Pb4Z71VBM40jE9ddvAPUDLdPB48QjH+H6UeS9RcXxLVRaxjUEDe94FDBq/dmh9WW8GwvI/DsGA==",
+      "path": "hidisp/3.1.60",
+      "hashPath": "hidisp.3.1.60.nupkg.sha512"
     },
-    "HiGeom/3.1.54": {
+    "HiGeom/3.1.55": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-BA9OLhuJEA27V93jeRfc67XCV/hzR2YCce1eSEk/1O7P3HINXm47WM0Aa9BHptMnDfr/DDsSdWqc7o/NUTcF2g==",
-      "path": "higeom/3.1.54",
-      "hashPath": "higeom.3.1.54.nupkg.sha512"
+      "sha512": "sha512-SzNJnS3bYqwsY+v6GHoA1EhdAII0uX2FLDYKDR4fvRzAI3L4yVHvy9n/N95qXAW7V+pDEpyA/2fqYxK3oYJOIw==",
+      "path": "higeom/3.1.55",
+      "hashPath": "higeom.3.1.55.nupkg.sha512"
     },
-    "HiLicense/3.1.54": {
+    "HiLicense/3.1.55": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-aMiceiCj3gPR1gAdHOPWsgUB5innBnzFCUktG2T4swyU3SFQFKeI92n4bRCed20UZX4qpr/GvgGPjEHbGIPSqQ==",
-      "path": "hilicense/3.1.54",
-      "hashPath": "hilicense.3.1.54.nupkg.sha512"
+      "sha512": "sha512-bIYFdnoTRNvYmBfGrFgdj4cDuZXUh81/3h+ZEqaoqsXKMh5q2B5Wm3qJYAWvcY1beSpFbfwwDTJj4Hu5zZIGcA==",
+      "path": "hilicense/3.1.55",
+      "hashPath": "hilicense.3.1.55.nupkg.sha512"
     },
-    "HiMech/3.1.66": {
+    "HiMech/3.1.67": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-VwXs/8kKDaZ8Xu+kyRX9Cex6/PlJ4HMKDkOjuCR6oHc5LtaYpvkODF171ViZxvQah0kiLHPc3DOTvK1SDn1JxA==",
-      "path": "himech/3.1.66",
-      "hashPath": "himech.3.1.66.nupkg.sha512"
+      "sha512": "sha512-yKZ3jK4hcuwPJjj6ZB3zphkil2TM6mh9zsAkkaNuHegznuriQs7ZV73023Xy2/K2ka421TakPQLXF+dNMkwD0A==",
+      "path": "himech/3.1.67",
+      "hashPath": "himech.3.1.67.nupkg.sha512"
     },
-    "HiNc/3.1.75": {
+    "HiNc/3.1.76": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-DPf6zShveGTsWgDPYZFoG+Ka5G7IYRGxhPOaaRXhYbMcYbjNDaoAG8plOgJq2LHB72jqFp+gkO19lYiKWkgzFQ==",
-      "path": "hinc/3.1.75",
-      "hashPath": "hinc.3.1.75.nupkg.sha512"
+      "sha512": "sha512-S5EuUxJIogijvVJNuHnlmV3RoF8PT0kw7eOsiS0b/YrDN6TGWFe3MXOghsQmMseyIzIoVfAMuVd2LJpFBkpTMA==",
+      "path": "hinc/3.1.76",
+      "hashPath": "hinc.3.1.76.nupkg.sha512"
     },
-    "HiUniNc/3.1.63": {
+    "HiUniNc/3.1.64": {
       "type": "package",
       "serviceable": true,
-      "sha512": "sha512-U887ylisdzWmT3s6dSOsOLQ2HAbcRJNaExWlqfd1Q81xpIoKPGJAK71OsgzdJ14IQB0NXkStHIY61q7NHDdEBA==",
-      "path": "hiuninc/3.1.63",
-      "hashPath": "hiuninc.3.1.63.nupkg.sha512"
+      "sha512": "sha512-yywDzJozfVJQyZcwkRusvfZnP+WkSMZoSjxwT7bsR4kf7HhmAu4Ko4qM7HRB5qp5Cz7GRnUdhQU0RK96juhxHw==",
+      "path": "hiuninc/3.1.64",
+      "hashPath": "hiuninc.3.1.64.nupkg.sha512"
     },
     "MathNet.Numerics/5.0.0": {
       "type": "package",
diff --git a/App/HiNC-2025-win-desktop.dll b/App/HiNC-2025-win-desktop.dll
index d2dadf3..4c2209e 100644
Binary files a/App/HiNC-2025-win-desktop.dll and b/App/HiNC-2025-win-desktop.dll differ
diff --git a/App/HiNC-2025-win-desktop.pdb b/App/HiNC-2025-win-desktop.pdb
index 4c6d9b8..f69efef 100644
Binary files a/App/HiNC-2025-win-desktop.pdb and b/App/HiNC-2025-win-desktop.pdb differ
diff --git a/App/HiNc.dll b/App/HiNc.dll
index da60fe8..fabe782 100644
Binary files a/App/HiNc.dll and b/App/HiNc.dll differ
diff --git a/App/HiUniNc.dll b/App/HiUniNc.dll
index b0478e9..2a35ec6 100644
Binary files a/App/HiUniNc.dll and b/App/HiUniNc.dll differ
diff --git a/App/en/HiGeom.resources.dll b/App/en/HiGeom.resources.dll
index 61ea80e..6ffa78d 100644
Binary files a/App/en/HiGeom.resources.dll and b/App/en/HiGeom.resources.dll differ
diff --git a/App/en/HiMech.resources.dll b/App/en/HiMech.resources.dll
index 1d591ca..462dee4 100644
Binary files a/App/en/HiMech.resources.dll and b/App/en/HiMech.resources.dll differ
diff --git a/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.RuntimeApi.html b/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.RuntimeApi.html
index 6a8b5be..fb63688 100644
--- a/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.RuntimeApi.html
+++ b/App/wwwroot/HiAPI-docsite/api/Hi.MachiningProcs.RuntimeApi.html
@@ -2547,6 +2547,40 @@ public double GetUniformContourTrayShiftAngle_deg(int toolId)</code></pre>
 
 
 
+  <a id="Hi_MachiningProcs_RuntimeApi_MapByActualTime_" data-uid="Hi.MachiningProcs.RuntimeApi.MapByActualTime*"></a>
+
+  <h3 id="Hi_MachiningProcs_RuntimeApi_MapByActualTime_System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_" data-uid="Hi.MachiningProcs.RuntimeApi.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode)">
+  MapByActualTime(string, CycleSamplingMode)
+  
+  </h3>
+
+  <div class="markdown level1 summary"></div>
+  <div class="markdown level1 conceptual"></div>
+
+  <div class="codewrapper">
+    <pre><code class="lang-csharp hljs">[JsAce(&quot;MapByActualTime($1timeShotRelFile)&quot;)]
+public void MapByActualTime(string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode = CycleSamplingMode.SpindleCycle)</code></pre>
+  </div>
+
+  <h4 class="section">Parameters</h4>
+  <dl class="parameters">
+    <dt><code>timeShotRelFile</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.string">string</a></dt>
+    <dd></dd>
+    <dt><code>cycleSamplingMode</code> <a class="xref" href="Hi.Mapping.StepTimeShotUtil.html">StepTimeShotUtil</a>.<a class="xref" href="Hi.Mapping.StepTimeShotUtil.CycleSamplingMode.html">CycleSamplingMode</a></dt>
+    <dd></dd>
+  </dl>
+
+
+
+
+
+
+
+
+
+
+
+
   <a id="Hi_MachiningProcs_RuntimeApi_Message_" data-uid="Hi.MachiningProcs.RuntimeApi.Message*"></a>
 
   <h3 id="Hi_MachiningProcs_RuntimeApi_Message_System_String_" data-uid="Hi.MachiningProcs.RuntimeApi.Message(System.String)">
diff --git a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
index 1628fbb..2b24224 100644
--- a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
+++ b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.StepTimeShotUtil.html
@@ -155,8 +155,8 @@ Class StepTimeShotUtil
 
   <a id="Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_" data-uid="Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime*"></a>
 
-  <h3 id="Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_Hi_CutterLocations_ClStrips_ClStrip_Hi_Common_Range_System_Int32__Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_String_Hi_Mapping_StepTimeShotUtil_GetTimeShotByFileDelegate_" data-uid="Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Common.Range{System.Int32},Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate)">
-  GetStepToShotsDictionaryByActualTime(ClStrip, Range&lt;int&gt;, CycleSamplingMode, string, GetTimeShotByFileDelegate)
+  <h3 id="Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_Hi_CutterLocations_ClStrips_ClStrip_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_String_Hi_Mapping_StepTimeShotUtil_GetTimeShotByFileDelegate_System_Collections_Generic_IDictionary_System_Int32_System_Collections_Generic_List_Hi_Mapping_ITimeShot___Hi_MachiningProcs_SessionMessageHost_System_Nullable_System_Threading_CancellationToken__" data-uid="Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate,System.Collections.Generic.IDictionary{System.Int32,System.Collections.Generic.List{Hi.Mapping.ITimeShot}},Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})">
+  GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, string, GetTimeShotByFileDelegate, IDictionary&lt;int, List&lt;ITimeShot&gt;&gt;, SessionMessageHost, CancellationToken?)
   
   </h3>
 
@@ -164,26 +164,24 @@ Class StepTimeShotUtil
   <div class="markdown level1 conceptual"></div>
 
   <div class="codewrapper">
-    <pre><code class="lang-csharp hljs">public static Dictionary&lt;int, List&lt;ITimeShot&gt;&gt; GetStepToShotsDictionaryByActualTime(ClStrip clStrip, Range&lt;int&gt; stepSection, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc)</code></pre>
+    <pre><code class="lang-csharp hljs">public static void GetStepToShotsDictionaryByActualTime(ClStrip clStrip, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc, IDictionary&lt;int, List&lt;ITimeShot&gt;&gt; dstStepToShotsDictionary, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken)</code></pre>
   </div>
 
   <h4 class="section">Parameters</h4>
   <dl class="parameters">
     <dt><code>clStrip</code> <a class="xref" href="Hi.CutterLocations.ClStrips.ClStrip.html">ClStrip</a></dt>
     <dd></dd>
-    <dt><code>stepSection</code> <a class="xref" href="Hi.Common.Range-1.html">Range</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>&gt;</dt>
-    <dd></dd>
     <dt><code>cycleSamplingMode</code> <a class="xref" href="Hi.Mapping.StepTimeShotUtil.html">StepTimeShotUtil</a>.<a class="xref" href="Hi.Mapping.StepTimeShotUtil.CycleSamplingMode.html">CycleSamplingMode</a></dt>
     <dd></dd>
     <dt><code>timeShotRelFile</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.string">string</a></dt>
     <dd></dd>
     <dt><code>getTimeShotByRelFileFunc</code> <a class="xref" href="Hi.Mapping.StepTimeShotUtil.html">StepTimeShotUtil</a>.<a class="xref" href="Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate.html">GetTimeShotByFileDelegate</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.collections.generic.dictionary-2">Dictionary</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>, <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.collections.generic.list-1">List</a>&lt;<a class="xref" href="Hi.Mapping.ITimeShot.html">ITimeShot</a>&gt;&gt;</dt>
+    <dt><code>dstStepToShotsDictionary</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.collections.generic.idictionary-2">IDictionary</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>, <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.collections.generic.list-1">List</a>&lt;<a class="xref" href="Hi.Mapping.ITimeShot.html">ITimeShot</a>&gt;&gt;</dt>
+    <dd></dd>
+    <dt><code>sessionMessageHost</code> <a class="xref" href="Hi.MachiningProcs.SessionMessageHost.html">SessionMessageHost</a></dt>
+    <dd></dd>
+    <dt><code>cancellationToken</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken">CancellationToken</a>?</dt>
     <dd></dd>
   </dl>
 
@@ -197,6 +195,7 @@ Class StepTimeShotUtil
 
 
 
+
   <a id="Hi_Mapping_StepTimeShotUtil_GetTimeShotByFile_" data-uid="Hi.Mapping.StepTimeShotUtil.GetTimeShotByFile*"></a>
 
   <h3 id="Hi_Mapping_StepTimeShotUtil_GetTimeShotByFile_System_String_System_Action_System_Int32__System_Nullable_System_Threading_CancellationToken__" data-uid="Hi.Mapping.StepTimeShotUtil.GetTimeShotByFile(System.String,System.Action{System.Int32},System.Nullable{System.Threading.CancellationToken})">
diff --git a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.TimeMapping.html b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.TimeMapping.html
index eb72a31..8919e69 100644
--- a/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.TimeMapping.html
+++ b/App/wwwroot/HiAPI-docsite/api/Hi.Mapping.TimeMapping.html
@@ -907,8 +907,8 @@ This method is thread-safe and can be called concurrently.</p>
 
   <a id="Hi_Mapping_TimeMapping_MapByActualTime_" data-uid="Hi.Mapping.TimeMapping.MapByActualTime*"></a>
 
-  <h3 id="Hi_Mapping_TimeMapping_MapByActualTime_Hi_Common_Range_System_Int32__System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_Nullable_System_Threading_CancellationToken__" data-uid="Hi.Mapping.TimeMapping.MapByActualTime(Hi.Common.Range{System.Int32},System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.Nullable{System.Threading.CancellationToken})">
-  MapByActualTime(Range&lt;int&gt;, string, CycleSamplingMode, CancellationToken?)
+  <h3 id="Hi_Mapping_TimeMapping_MapByActualTime_System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_Hi_MachiningProcs_SessionMessageHost_System_Nullable_System_Threading_CancellationToken__" data-uid="Hi.Mapping.TimeMapping.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})">
+  MapByActualTime(string, CycleSamplingMode, SessionMessageHost, CancellationToken?)
   
   </h3>
 
@@ -916,17 +916,17 @@ This method is thread-safe and can be called concurrently.</p>
   <div class="markdown level1 conceptual"></div>
 
   <div class="codewrapper">
-    <pre><code class="lang-csharp hljs">public void MapByActualTime(Range&lt;int&gt; stepSection, string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, CancellationToken? cancellationToken = null)</code></pre>
+    <pre><code class="lang-csharp hljs">public void MapByActualTime(string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken = null)</code></pre>
   </div>
 
   <h4 class="section">Parameters</h4>
   <dl class="parameters">
-    <dt><code>stepSection</code> <a class="xref" href="Hi.Common.Range-1.html">Range</a>&lt;<a class="xref" href="https://learn.microsoft.com/dotnet/api/system.int32">int</a>&gt;</dt>
-    <dd></dd>
     <dt><code>timeShotRelFile</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.string">string</a></dt>
     <dd></dd>
     <dt><code>cycleSamplingMode</code> <a class="xref" href="Hi.Mapping.StepTimeShotUtil.html">StepTimeShotUtil</a>.<a class="xref" href="Hi.Mapping.StepTimeShotUtil.CycleSamplingMode.html">CycleSamplingMode</a></dt>
     <dd></dd>
+    <dt><code>sessionMessageHost</code> <a class="xref" href="Hi.MachiningProcs.SessionMessageHost.html">SessionMessageHost</a></dt>
+    <dd></dd>
     <dt><code>cancellationToken</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken">CancellationToken</a>?</dt>
     <dd></dd>
   </dl>
diff --git a/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html b/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
index cd8cb6e..eaddb01 100644
--- a/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
+++ b/App/wwwroot/HiAPI-docsite/brief/dev-doc/release-note/index.html
@@ -87,6 +87,11 @@
         <article data-uid="">
           <h1 id="release-note">Release Note</h1>
 
+<h2 id="hinc-packages-version-3175">HiNc Packages Version 3.1.75</h2>
+<ul>
+<li>Add actual time tracking functionality (<a class="xref" href="../../../api/Hi.MachiningSteps.MachiningStep.html#Hi_MachiningSteps_MachiningStep_ActualTime_">ActualTime</a>)</li>
+<li>Various stability improvements and bug fixes</li>
+</ul>
 <h2 id="hinc-packages-version-3174">HiNc Packages Version 3.1.74</h2>
 <ul>
 <li>Rename class <code>MillingCutterOptLimit</code> to <a class="xref" href="../../../api/Hi.NcOpt.MillingCutterOptOption.html">MillingCutterOptOption</a></li>
diff --git a/App/wwwroot/HiAPI-docsite/index.json b/App/wwwroot/HiAPI-docsite/index.json
index d4ae31b..01c878d 100644
--- a/App/wwwroot/HiAPI-docsite/index.json
+++ b/App/wwwroot/HiAPI-docsite/index.json
@@ -1952,7 +1952,7 @@
   "api/Hi.MachiningProcs.RuntimeApi.html": {
     "href": "api/Hi.MachiningProcs.RuntimeApi.html",
     "title": "Class RuntimeApi | HiAPI-C# 2025",
-    "summary": "Class RuntimeApi Namespace Hi.MachiningProcs Assembly HiNc.dll Runtime API for machining operations. public class RuntimeApi : ICsScriptApi Inheritance object RuntimeApi Implements ICsScriptApi Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Properties DiffVisualRadius_mm Gets or sets the visual radius in millimeters for difference visualization. Controls the radius used for highlighting differences between workpiece states. [JsAce] public double DiffVisualRadius_mm { get; set; } Property Value double DispCacheMb Gets or sets the display cache size in megabytes. public long DispCacheMb { get; set; } Property Value long DispCache_Mb Gets or sets the display cache size in megabytes. [JsAce] public long DispCache_Mb { get; set; } Property Value long EnableAutoMapOnSelectionEnd Gets or sets whether to automatically map selections when they end. [JsAce] public bool EnableAutoMapOnSelectionEnd { get; set; } Property Value bool EnableCollisionDetection Gets or sets whether collision detection is enabled. [JsAce(DocContentHtml = \"Enable Collision Detection.\")] public bool EnableCollisionDetection { get; set; } Property Value bool EnablePauseOnCollision Obsoleted. Gets or sets whether to pause execution when a collision is detected. This property only has an effect if collision detection is enabled. public bool EnablePauseOnCollision { get; set; } Property Value bool EnablePauseOnFailure Gets or sets whether to pause on failure during execution. [JsAce(DocContentHtml = \"Enable Pause On Failure.\")] public bool EnablePauseOnFailure { get; set; } Property Value bool EnablePhysics Gets or sets whether milling force evaluation is enabled. [JsAce(DocContentHtml = \"Enable milling force evaluation.\")] public bool EnablePhysics { get; set; } Property Value bool EnableWearEffect Gets or sets whether tool wear effects are enabled in simulation. [JsAce] public bool EnableWearEffect { get; set; } Property Value bool FeedPerCycle Gets a new feed per cycle machining motion resolution instance. [JsAce] public FeedPerCycleMachiningMotionResolution FeedPerCycle { get; } Property Value FeedPerCycleMachiningMotionResolution FeedPerTooth Gets a new feed per tooth machining motion resolution instance. [JsAce] public FeedPerToothMachiningMotionResolution FeedPerTooth { get; } Property Value FeedPerToothMachiningMotionResolution Fixture [JsAce] public Fixture Fixture { get; set; } Property Value Fixture Global Global variables. [JsAce(\"Global[$1key]\")] public Dictionary<object, object> Global { get; } Property Value Dictionary<object, object> InitSpindleTemperature_C Gets or sets the initial spindle temperature in degrees Celsius. [JsAce(DocContentHtml = \"Spindle Temperature on initialization.\")] public double InitSpindleTemperature_C { get; set; } Property Value double JsAceCompletionProfileJsonArray Internal used. public static JsonArray JsAceCompletionProfileJsonArray { get; } Property Value JsonArray MachiningMotionResolution Gets or sets the machining motion resolution. [JsAce] public IMachiningMotionResolution MachiningMotionResolution { get; set; } Property Value IMachiningMotionResolution MachiningResolution Gets or sets the machining resolution in millimeters. For legacy compatable. [JsAce] [Obsolete] public double MachiningResolution { get; set; } Property Value double MachiningResolution_mm Gets or sets the machining resolution in millimeters. [JsAce] public double MachiningResolution_mm { get; set; } Property Value double MachiningSession public MachiningSession MachiningSession { get; } Property Value MachiningSession MapTask Task tracking the status of mapping operations. public Task MapTask { get; set; } Property Value Task MillingForceCycleDivisionNum Gets or sets the number of divisions per cycle for milling force calculation. This property should be set before milling force evaluation if TrainMillingPara(SampleFlag, string, double) is intended to be used. [JsAce] public static int MillingForceCycleDivisionNum { get; set; } Property Value int NcOptOption Gets or sets the NC optimization options. [JsAce] public NcOptOption NcOptOption { get; set; } Property Value NcOptOption OptEnableDepthCompensation Enables or disables depth compensation during optimization. [JsAce] public bool OptEnableDepthCompensation { get; set; } Property Value bool OptEnableFeedrate Gets or sets whether to enable feed rate optimization in NC optimization. [JsAce] public bool OptEnableFeedrate { get; set; } Property Value bool OptEnableForwardCompensation Enables or disables forward compensation during optimization. [JsAce] public bool OptEnableForwardCompensation { get; set; } Property Value bool OptEnableInterpolation Enables or disables reinterpolation for optimization. [JsAce] public bool OptEnableInterpolation { get; set; } Property Value bool OptEnableSideCompensation Enables or disables side compensation during optimization. [JsAce] public bool OptEnableSideCompensation { get; set; } Property Value bool OptExtendedPostDistance_mm Gets or sets the extended post-distance in millimeters for NC optimization. This is the distance after the current segment that will be considered for optimization. [JsAce] public double OptExtendedPostDistance_mm { get; set; } Property Value double OptExtendedPreDistance_mm Gets or sets the extended pre-distance in millimeters for NC optimization. This is the distance before the current segment that will be considered for optimization. [JsAce] public double OptExtendedPreDistance_mm { get; set; } Property Value double OptFeedrateAssignmentRatio Gets or sets the feedrate assignment ratio for optimization. If the feedrate change exceeds this ratio, the feedrate in the NC line will be updated. [JsAce] public double OptFeedrateAssignmentRatio { get; set; } Property Value double OptMaxAcceleration_mmds2 Maximum acceleration in mm/s² during optimization. Only takes effect on reinterpolated section. [JsAce(DocContentHtml = \"Only take effect on reinterpolated section.\")] public double OptMaxAcceleration_mmds2 { get; set; } Property Value double OptMaxFeedPerTooth_mm Gets or sets the maximum feed per tooth in millimeters for optimization. [JsAce] public double OptMaxFeedPerTooth_mm { get; set; } Property Value double OptMaxFeedrate_mmdmin Maximum feed rate in mm/min for cutting movements during optimization. [JsAce] public double OptMaxFeedrate_mmdmin { get; set; } Property Value double OptMaxJerk_mmds3 Maximum jerk in mm/s³ during optimization. Only takes effect on reinterpolated section. [JsAce(DocContentHtml = \"Only take effect on reinterpolated section.\")] public double OptMaxJerk_mmds3 { get; set; } Property Value double OptMinFeedPerTooth_mm Gets or sets the minimum feed per tooth in millimeters for optimization. [JsAce] public double OptMinFeedPerTooth_mm { get; set; } Property Value double OptMinFeedrate_mmdmin Minimum feed rate in mm/min for cutting movements during optimization. [JsAce] public double OptMinFeedrate_mmdmin { get; set; } Property Value double OptPreferedForce_N Preferred force in N for optimization. [JsAce] public double OptPreferedForce_N { get; set; } Property Value double OptRapidFeed_mmdmin Rapid feed rate in mm/min for non-cutting movements during optimization. [JsAce] public double OptRapidFeed_mmdmin { get; set; } Property Value double OptSpindlePowerSafetyFactor Safety factor for spindle power during optimization. [JsAce] public double OptSpindlePowerSafetyFactor { get; set; } Property Value double OptSpindlePowerUtilizationFactor Utilization factor for spindle power during optimization. It is the reciprocal of the spindle power safety factor. [JsAce] public double OptSpindlePowerUtilizationFactor { get; set; } Property Value double OptSpindleTorqueSafetyFactor [JsAce] public double OptSpindleTorqueSafetyFactor { get; set; } Property Value double OptSpindleTorqueUtilizationFactor Utilization factor for spindle torque during optimization. It is the reciprocal of the spindle torque safety factor. [JsAce] public double OptSpindleTorqueUtilizationFactor { get; set; } Property Value double OptThermalYieldSafetyFactor Safety factor for spindle torque during optimization. [JsAce] public double OptThermalYieldSafetyFactor { get; set; } Property Value double OptThermalYieldUtilizationFactor Utilization factor for thermal yield during optimization. It is the reciprocal of the thermal yield safety factor. [JsAce] public double OptThermalYieldUtilizationFactor { get; set; } Property Value double OptYieldingSafetyFactor Safety factor for yielding during optimization. [JsAce] public double OptYieldingSafetyFactor { get; set; } Property Value double OptYieldingUtilizationFactor Utilization factor for yielding during optimization. It is the reciprocal of the yielding safety factor. [JsAce] public double OptYieldingUtilizationFactor { get; set; } Property Value double ParaTemplateDimension Gets or sets the parameter template dimension (2D or 3D). [JsAce] public int ParaTemplateDimension { get; set; } Property Value int ScriptOptions ScriptOptions. public ScriptOptions ScriptOptions { get; set; } Property Value ScriptOptions SessionMessageHost Gets the session message host for displaying messages. [JsAce] public SessionMessageHost SessionMessageHost { get; } Property Value SessionMessageHost StepCount Gets the total number of milling steps. [JsAce] public int StepCount { get; } Property Value int Workpiece [JsAce] public Workpiece Workpiece { get; set; } Property Value Workpiece Methods AddTimeDataByFile(string, string, double, double) Adds time-based data from a file to the time mapping dictionary with specified time bounds in seconds. [JsAce(\"AddTimeDataByFile($1key, $2relFile, $3beginTime, $4endTime)\")] public bool AddTimeDataByFile(string key, string relFile, double beginTime, double endTime) Parameters key string Key to identify the data relFile string Relative path to the data file beginTime double Beginning time in seconds endTime double Ending time in seconds Returns bool True if the data was successfully added, false otherwise AddTimeDataByFile(string, string, string, string) Adds time-based data from a file to the time mapping dictionary with specified time bounds. [JsAce(\"AddTimeDataByFile($1key, $2relFile, $3beginTime, $4endTime)\")] public bool AddTimeDataByFile(string key, string relFile, string beginTimeText, string endTimeText) Parameters key string Key to identify the data relFile string Relative path to the data file beginTimeText string Beginning time as text (seconds or TimeSpan format) endTimeText string Ending time as text (seconds or TimeSpan format) Returns bool True if the data was successfully added, false otherwise AppendMessagesToFile(string, params string[]) Appends messages to a file, optionally filtered by tags. [JsAce(\"AppendMessagesToFile(\\\"dstRelFile\\\",flags)\")] public void AppendMessagesToFile(string dstRelFile, params string[] flags) Parameters dstRelFile string Destination relative file path flags string[] Optional flags to filter messages by tags BeginPreserve() Begin Preserve section in optimzation process. [JsAce(\"BeginPreserve()\")] public void BeginPreserve() BeginSelection(string, AnchorMode, IStepShift) Begin mark on current line. milling step() has not triggered yet. public void BeginSelection(string key, AnchorMode anchorMode = AnchorMode.LineBegin, IStepShift shift = null) Parameters key string Identifier key for the selection anchorMode AnchorMode Mode for anchoring the beginning of selection shift IStepShift Step shift to apply BeginSession() Begins a new machining session. public void BeginSession() ClearTimeMappingData() Clears all time mapping data. [JsAce] public void ClearTimeMappingData() Diff(double) Performs a difference analysis on the workpiece geometry to detect variations. [JsAce(\"Diff($1detectionRadius_mm)\")] public void Diff(double detectionRadius_mm) Parameters detectionRadius_mm double Radius for detecting differences EndPreserve() End Preserve section in optimzation process. [JsAce(\"EndPreserve()\")] public void EndPreserve() EndSelection(string, AnchorMode, IStepShift) End mark on current line for selection. public void EndSelection(string key, AnchorMode anchorMode = AnchorMode.LineEnd, IStepShift shift = null) Parameters key string Identifier key for the selection anchorMode AnchorMode Mode for anchoring the end of selection shift IStepShift Step shift to apply EndSession() Ends the current machining session. public void EndSession() ErrorMessage(string) Displays an error message in the message host. [JsAce(\"ErrorMessage($1message)\")] public void ErrorMessage(string message) Parameters message string The error message to display FixedPace(double, double) Creates a fixed machining motion resolution with specified parameters. [JsAce(\"FixedPace($1linearResolution_mm, $2rotaryResolution_deg)\")] public FixedMachiningMotionResolution FixedPace(double linearResolution_mm, double rotaryResolution_deg) Parameters linearResolution_mm double Linear resolution in millimeters rotaryResolution_deg double Rotary resolution in degrees Returns FixedMachiningMotionResolution A new fixed machining motion resolution instance GetMillingStep(int) Retrieves a milling step at the specified index. [JsAce(Snippet = \"GetMillingStep($1\\\"stepIndex\\\")\")] public MachiningStep GetMillingStep(int stepIndex) Parameters stepIndex int Index of the milling step to retrieve Returns MachiningStep The milling step at the specified index GetStickMachiningToolObservationHeight_mm(int) Gets the observation height in millimeters for the specified stick machining tool. [JsAce(\"GetStickMachiningToolObservationHeight_mm($1toolId)\")] public double GetStickMachiningToolObservationHeight_mm(int toolId) Parameters toolId int The ID of the tool Returns double The observation height in millimeters GetUniformContourTrayShiftAngle_deg(int) Gets the shift angle in degrees for the uniform contour tray of the specified tool. [JsAce(\"GetUniformContourTrayShiftAngle_deg($1toolId)\")] public double GetUniformContourTrayShiftAngle_deg(int toolId) Parameters toolId int The ID of the tool Returns double The shift angle in degrees LineSelection(string, AnchorMode, IStepShift, AnchorMode, IStepShift) Create a line selection from begin to end mark. public void LineSelection(string key, AnchorMode beginAnchorMode = AnchorMode.LineBegin, IStepShift beginShift = null, AnchorMode endAnchorMode = AnchorMode.LineEnd, IStepShift endShift = null) Parameters key string Identifier key for the selection beginAnchorMode AnchorMode Mode for anchoring the beginning of selection beginShift IStepShift Step shift to apply at beginning endAnchorMode AnchorMode Mode for anchoring the end of selection endShift IStepShift Step shift to apply at end Map(string, FileTimeSection, CycleSamplingMode?) Maps selection data to time section. public Task Map(string key, FileTimeSection fileTimeSection = null, StepTimeShotUtil.CycleSamplingMode? cycleSamplingMode = CycleSamplingMode.SpindleCycle) Parameters key string Identifier key for the selection fileTimeSection FileTimeSection File time section, or null to use the one associated with the key cycleSamplingMode StepTimeShotUtil.CycleSamplingMode? Cycle sampling mode Returns Task Task representing the asynchronous mapping operation Message(string) Displays a message in the message host. [JsAce(\"Message($1message)\")] public void Message(string message) Parameters message string The message to display OptCallPreferFuncIndexDictionary() [JsAce(\"OptCallPreferFuncIndexDictionary()\")] public Dictionary<Func<MillingPhysicsBrief, double>, double> OptCallPreferFuncIndexDictionary() Returns Dictionary<Func<MillingPhysicsBrief, double>, double> OptimizeToFiles(string) Optimizes NC files and saves results using the specified file template. [JsAce(Snippet = \"OptimizeToFiles(\\\"Output/Opt-[NcName]\\\")\", DocContentHtml = \"Optimize To Files by substitude template keywoard \\\"[NcName]\\\"\")] public void OptimizeToFiles(string relFileTemplate = \"Output/Opt-[NcName]\") Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder Pace() Controls the pace of machining operations during execution. [JsAce(\"Pace();\")] public void Pace() Pause() Pause Player [JsAce(DocContentHtml = \"Pause Player\")] public void Pause() PlayAct(IAct, IIndexedFileLine, CancellationToken?) Plays an act with pacing control. [JsAce] public void PlayAct(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to play. sourceCommand IIndexedFileLine The source command. cancellationToken CancellationToken? Cancellation token. PlayClTeleport(double, double, double, double, double, double) Plays a CL (cutter location) teleport operation. [JsAce] public void PlayClTeleport(double x, double y, double z, double i, double j, double k) Parameters x double X coordinate. y double Y coordinate. z double Z coordinate. i double I vector component. j double J vector component. k double K vector component. PlayCsvFile(string) Plays an Csv file with the specified relative path. [JsAce(\"PlayCsvFile($1\\\"csvFile\\\");\")] public void PlayCsvFile(string relFilePath) Parameters relFilePath string Relative path to the CSV file PlayNc(string, string) Plays NC code directly from a string, executing each action and pacing between them. [JsAce(Snippet = \"PlayNc($1\\\"ncCommand\\\",$2\\\"\\\"(Direct Command)\\\"\\\");\", DocContentHtml = \"Play NC. second parameter is the file name alternative shows in the log.\")] public void PlayNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string NC code as a string fileNameAlternative string Alternative name to display in logs PlayNcFile(string) Plays an NC file with the specified relative path. [JsAce(\"PlayNcFile($1\\\"ncFile\\\");\")] public void PlayNcFile(string relNcFilePath) Parameters relNcFilePath string Relative path to the NC file PlayToolingTeleport(int) Plays a tooling teleport operation. [JsAce] public void PlayToolingTeleport(int toolId) Parameters toolId int The tool ID to teleport. Preserve() Preserve one line NC code in optimzation process. [JsAce(\"Preserve()\")] public void Preserve() ProgressMessage(string) Displays a progress message in the message host. [JsAce(\"ProgressMessage($1message)\")] public void ProgressMessage(string message) Parameters message string The progress message to display ReTrainMillingPara(SampleFlag, string, double) Re-trains milling parameters using the specified sample flag. [JsAce(\"ReTrainMillingPara(Fx|Fy|Fz, $1dstFile)\")] public void ReTrainMillingPara(SampleFlag sampleFlag, string dstRelFile, double outlierRatio = 2) Parameters sampleFlag SampleFlag Sample flag indicating which components to train dstRelFile string Destination relative file path outlierRatio double Outlier ratio for data filtering ReadCsvByTimeInterpolation(string) Reads a CSV file and performs time-based interpolation to map data to milling steps. [JsAce(Snippet = \"ReadCsvByTimeInterpolation($1\\\"csvFile\\\")\")] public void ReadCsvByTimeInterpolation(string csvFile) Parameters csvFile string Path to the CSV file relative to the base directory ReadRuntimeGeom(string) Reads runtime geometry from a file. [JsAce(\"ReadRuntimeGeom($1\\\"srcFile\\\")\")] public void ReadRuntimeGeom(string relFile) Parameters relFile string Relative path to the input file RegisterStepVariable(string, string, string, string, Func<MachiningStep, object>) Registers a step variable for tracking during execution. [JsAce(Snippet = \"RegisterStepVariable(\\\"$1key\\\",\\\"$2name\\\",\\\"$3unit\\\",\\\"$4formatString\\\",\\\"$5variableFunc\\\")\", DocContentHtml = \"<p>Register Step Variable.</p> <p>\\\"unit\\\" is nullable</p> <p>\\\"formatString\\\" is nullable</p>\")] public void RegisterStepVariable(string key, string name, string unit, string formatString, Func<MachiningStep, object> variableFunc = null) Parameters key string Unique key to identify the variable name string Human-readable name of the variable unit string Physical unit of the variable (can be null) formatString string Format string for displaying the variable (can be null) variableFunc Func<MachiningStep, object> Function to compute the variable value from a milling step (can be null) RemoveFlyPiece() Removes any disconnected or “flying” pieces from the workpiece geometry. [JsAce] public void RemoveFlyPiece() Reset() Reset Player [JsAce(DocContentHtml = \"Reset Player\")] public void Reset() ResetRuntime() Clears internal buffers. [JsAce] public void ResetRuntime() RunNc(string, string) Runs NC code directly from a string. [JsAce(Snippet = \"RunNc($1\\\"ncCommand\\\",$2\\\"\\\"(Direct Command)\\\"\\\");\", DocContentHtml = \"Run NC. second parameter is the file name alternative shows in the log.\")] public IEnumerable<Action> RunNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string NC code as a string fileNameAlternative string Alternative name to display in logs Returns IEnumerable<Action> Enumerable sequence of actions to be executed RunNcFile(string) Runs an NC file with the specified relative path. [JsAce(\"RunNcFile($1\\\"ncFile\\\");\")] public IEnumerable<Action> RunNcFile(string relNcFilePath) Parameters relNcFilePath string Relative path to the NC file Returns IEnumerable<Action> Enumerable sequence of actions to be executed SetNcResolutionFeedPerCycle() Sets NC resolution to feed per cycle mode. public void SetNcResolutionFeedPerCycle() SetNcResolutionFeedPerTooth() Sets NC resolution to feed per tooth mode. public void SetNcResolutionFeedPerTooth() SetNcResolutionFixed(double, double) Sets NC resolution to fixed mode with specified resolution values. public void SetNcResolutionFixed(double linearResolution_mm, double rotaryResolution_deg) Parameters linearResolution_mm double Linear resolution in millimeters. rotaryResolution_deg double Rotary resolution in degrees. SetStickMachiningToolObservationHeight_mm(int, double) Sets the observation height in millimeters for the specified stick machining tool. [JsAce(\"SetStickMachiningToolObservationHeight_mm($1toolId,$2height_mm)\")] public void SetStickMachiningToolObservationHeight_mm(int toolId, double height) Parameters toolId int The ID of the tool height double The observation height in millimeters to set SetUniformContourTrayShiftAngle_deg(int, double) Sets the shift angle in degrees for the uniform contour tray of the specified tool. [JsAce(\"SetUniformContourTrayShiftAngle_deg($1toolId,$2angle_deg)\")] public void SetUniformContourTrayShiftAngle_deg(int toolId, double angle_deg) Parameters toolId int The ID of the tool angle_deg double The shift angle in degrees to set ShiftDistance_mm(double) Creates a distance shift object representing the specified distance in millimeters. public DistanceShift ShiftDistance_mm(double distanceShift_mm) Parameters distanceShift_mm double Distance shift in millimeters Returns DistanceShift Distance shift object ShiftTime_s(double) Creates a time shift object representing the specified time in seconds. public TimeShift ShiftTime_s(double seconds) Parameters seconds double Time in seconds Returns TimeShift Time shift object TrainMillingPara(SampleFlag, string, double) Trains milling parameters using the specified sample flag. [JsAce(\"TrainMillingPara(Fx|Fy|Fz, $1dstFile)\")] public void TrainMillingPara(SampleFlag sampleFlag, string dstRelFile, double outlierRatio = 2) Parameters sampleFlag SampleFlag Sample flag indicating which components to train dstRelFile string Destination relative file path outlierRatio double Outlier ratio for data filtering WarningMessage(string) Displays a warning message in the message host. [JsAce(\"WarningMessage($1message)\")] public void WarningMessage(string message) Parameters message string The warning message to display WriteRuntimeGeom(string) Writes the current runtime geometry to a file. [JsAce(\"WriteRuntimeGeom($1\\\"dstFile\\\")\")] public void WriteRuntimeGeom(string relFile) Parameters relFile string Relative path to the output file WriteRuntimeGeomToStl(string, double) Writes the current runtime geometry to an STL file. [JsAce(\"WriteRuntimeGeomToStl($1\\\"dstFile\\\",$2resolution_mm)\")] public void WriteRuntimeGeomToStl(string relFile, double resolution_mm = 0) Parameters relFile string Relative path to the output STL file resolution_mm double Resolution in millimeters (0 for default) WriteShotFiles(double, string) Writes time-series data to shot files with the specified resolution period (alternative parameter order). public void WriteShotFiles(double resolutionPeroid_ms, string relFileTemplate) Parameters resolutionPeroid_ms double Resolution period in milliseconds relFileTemplate string Template for output file path, can include [NcName] placeholder WriteShotFiles(string, double) Writes time-series data to shot files with the specified resolution period. [JsAce(Snippet = \"WriteShotFiles(\\\"Output/[NcName].shot.csv\\\",resolutionPeroid_ms)\", DocContentHtml = \"Write time series data by resolutionPeroid_ms\")] public void WriteShotFiles(string relFileTemplate = \"Output/[NcName].shot.csv\", double resolutionPeroid_ms = 1) Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder resolutionPeroid_ms double Resolution period in milliseconds WriteStepFiles(string) Writes step-series data to files with the specified file template. [JsAce(Snippet = \"WriteStepFiles(\\\"Output/[NcName].step.csv\\\")\", DocContentHtml = \"Write step series data.\")] public void WriteStepFiles(string relFileTemplate = \"Output/[NcName].step.csv\") Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder Events MachiningStepBuilt Gets or sets the action to configure steps during execution. The event will be cleared by the calling of ResetRuntime(). [JsAce(Snippet = \"MachiningStepBuilt+=($1preStep,$2curStep)=>{$3Command};\", DocContentHtml = \"Runtime Step Configuration action. preStep is the Previous Milling Step; curStep is the Current Milling Step. preStep is null if no previous step existed.\")] public event MachiningActRunner.MachiningStepBuiltDelegate MachiningStepBuilt Event Type MachiningActRunner.MachiningStepBuiltDelegate MachiningStepSelected Event that is triggered when a milling step is selected. The event will be cleared by the calling of ResetRuntime(). [JsAce(Snippet = \"MachiningStepSelected+=($1millingStep)=>{$2Command};\")] public event Action<MachiningStep> MachiningStepSelected Event Type Action<MachiningStep>"
+    "summary": "Class RuntimeApi Namespace Hi.MachiningProcs Assembly HiNc.dll Runtime API for machining operations. public class RuntimeApi : ICsScriptApi Inheritance object RuntimeApi Implements ICsScriptApi Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Properties DiffVisualRadius_mm Gets or sets the visual radius in millimeters for difference visualization. Controls the radius used for highlighting differences between workpiece states. [JsAce] public double DiffVisualRadius_mm { get; set; } Property Value double DispCacheMb Gets or sets the display cache size in megabytes. public long DispCacheMb { get; set; } Property Value long DispCache_Mb Gets or sets the display cache size in megabytes. [JsAce] public long DispCache_Mb { get; set; } Property Value long EnableAutoMapOnSelectionEnd Gets or sets whether to automatically map selections when they end. [JsAce] public bool EnableAutoMapOnSelectionEnd { get; set; } Property Value bool EnableCollisionDetection Gets or sets whether collision detection is enabled. [JsAce(DocContentHtml = \"Enable Collision Detection.\")] public bool EnableCollisionDetection { get; set; } Property Value bool EnablePauseOnCollision Obsoleted. Gets or sets whether to pause execution when a collision is detected. This property only has an effect if collision detection is enabled. public bool EnablePauseOnCollision { get; set; } Property Value bool EnablePauseOnFailure Gets or sets whether to pause on failure during execution. [JsAce(DocContentHtml = \"Enable Pause On Failure.\")] public bool EnablePauseOnFailure { get; set; } Property Value bool EnablePhysics Gets or sets whether milling force evaluation is enabled. [JsAce(DocContentHtml = \"Enable milling force evaluation.\")] public bool EnablePhysics { get; set; } Property Value bool EnableWearEffect Gets or sets whether tool wear effects are enabled in simulation. [JsAce] public bool EnableWearEffect { get; set; } Property Value bool FeedPerCycle Gets a new feed per cycle machining motion resolution instance. [JsAce] public FeedPerCycleMachiningMotionResolution FeedPerCycle { get; } Property Value FeedPerCycleMachiningMotionResolution FeedPerTooth Gets a new feed per tooth machining motion resolution instance. [JsAce] public FeedPerToothMachiningMotionResolution FeedPerTooth { get; } Property Value FeedPerToothMachiningMotionResolution Fixture [JsAce] public Fixture Fixture { get; set; } Property Value Fixture Global Global variables. [JsAce(\"Global[$1key]\")] public Dictionary<object, object> Global { get; } Property Value Dictionary<object, object> InitSpindleTemperature_C Gets or sets the initial spindle temperature in degrees Celsius. [JsAce(DocContentHtml = \"Spindle Temperature on initialization.\")] public double InitSpindleTemperature_C { get; set; } Property Value double JsAceCompletionProfileJsonArray Internal used. public static JsonArray JsAceCompletionProfileJsonArray { get; } Property Value JsonArray MachiningMotionResolution Gets or sets the machining motion resolution. [JsAce] public IMachiningMotionResolution MachiningMotionResolution { get; set; } Property Value IMachiningMotionResolution MachiningResolution Gets or sets the machining resolution in millimeters. For legacy compatable. [JsAce] [Obsolete] public double MachiningResolution { get; set; } Property Value double MachiningResolution_mm Gets or sets the machining resolution in millimeters. [JsAce] public double MachiningResolution_mm { get; set; } Property Value double MachiningSession public MachiningSession MachiningSession { get; } Property Value MachiningSession MapTask Task tracking the status of mapping operations. public Task MapTask { get; set; } Property Value Task MillingForceCycleDivisionNum Gets or sets the number of divisions per cycle for milling force calculation. This property should be set before milling force evaluation if TrainMillingPara(SampleFlag, string, double) is intended to be used. [JsAce] public static int MillingForceCycleDivisionNum { get; set; } Property Value int NcOptOption Gets or sets the NC optimization options. [JsAce] public NcOptOption NcOptOption { get; set; } Property Value NcOptOption OptEnableDepthCompensation Enables or disables depth compensation during optimization. [JsAce] public bool OptEnableDepthCompensation { get; set; } Property Value bool OptEnableFeedrate Gets or sets whether to enable feed rate optimization in NC optimization. [JsAce] public bool OptEnableFeedrate { get; set; } Property Value bool OptEnableForwardCompensation Enables or disables forward compensation during optimization. [JsAce] public bool OptEnableForwardCompensation { get; set; } Property Value bool OptEnableInterpolation Enables or disables reinterpolation for optimization. [JsAce] public bool OptEnableInterpolation { get; set; } Property Value bool OptEnableSideCompensation Enables or disables side compensation during optimization. [JsAce] public bool OptEnableSideCompensation { get; set; } Property Value bool OptExtendedPostDistance_mm Gets or sets the extended post-distance in millimeters for NC optimization. This is the distance after the current segment that will be considered for optimization. [JsAce] public double OptExtendedPostDistance_mm { get; set; } Property Value double OptExtendedPreDistance_mm Gets or sets the extended pre-distance in millimeters for NC optimization. This is the distance before the current segment that will be considered for optimization. [JsAce] public double OptExtendedPreDistance_mm { get; set; } Property Value double OptFeedrateAssignmentRatio Gets or sets the feedrate assignment ratio for optimization. If the feedrate change exceeds this ratio, the feedrate in the NC line will be updated. [JsAce] public double OptFeedrateAssignmentRatio { get; set; } Property Value double OptMaxAcceleration_mmds2 Maximum acceleration in mm/s² during optimization. Only takes effect on reinterpolated section. [JsAce(DocContentHtml = \"Only take effect on reinterpolated section.\")] public double OptMaxAcceleration_mmds2 { get; set; } Property Value double OptMaxFeedPerTooth_mm Gets or sets the maximum feed per tooth in millimeters for optimization. [JsAce] public double OptMaxFeedPerTooth_mm { get; set; } Property Value double OptMaxFeedrate_mmdmin Maximum feed rate in mm/min for cutting movements during optimization. [JsAce] public double OptMaxFeedrate_mmdmin { get; set; } Property Value double OptMaxJerk_mmds3 Maximum jerk in mm/s³ during optimization. Only takes effect on reinterpolated section. [JsAce(DocContentHtml = \"Only take effect on reinterpolated section.\")] public double OptMaxJerk_mmds3 { get; set; } Property Value double OptMinFeedPerTooth_mm Gets or sets the minimum feed per tooth in millimeters for optimization. [JsAce] public double OptMinFeedPerTooth_mm { get; set; } Property Value double OptMinFeedrate_mmdmin Minimum feed rate in mm/min for cutting movements during optimization. [JsAce] public double OptMinFeedrate_mmdmin { get; set; } Property Value double OptPreferedForce_N Preferred force in N for optimization. [JsAce] public double OptPreferedForce_N { get; set; } Property Value double OptRapidFeed_mmdmin Rapid feed rate in mm/min for non-cutting movements during optimization. [JsAce] public double OptRapidFeed_mmdmin { get; set; } Property Value double OptSpindlePowerSafetyFactor Safety factor for spindle power during optimization. [JsAce] public double OptSpindlePowerSafetyFactor { get; set; } Property Value double OptSpindlePowerUtilizationFactor Utilization factor for spindle power during optimization. It is the reciprocal of the spindle power safety factor. [JsAce] public double OptSpindlePowerUtilizationFactor { get; set; } Property Value double OptSpindleTorqueSafetyFactor [JsAce] public double OptSpindleTorqueSafetyFactor { get; set; } Property Value double OptSpindleTorqueUtilizationFactor Utilization factor for spindle torque during optimization. It is the reciprocal of the spindle torque safety factor. [JsAce] public double OptSpindleTorqueUtilizationFactor { get; set; } Property Value double OptThermalYieldSafetyFactor Safety factor for spindle torque during optimization. [JsAce] public double OptThermalYieldSafetyFactor { get; set; } Property Value double OptThermalYieldUtilizationFactor Utilization factor for thermal yield during optimization. It is the reciprocal of the thermal yield safety factor. [JsAce] public double OptThermalYieldUtilizationFactor { get; set; } Property Value double OptYieldingSafetyFactor Safety factor for yielding during optimization. [JsAce] public double OptYieldingSafetyFactor { get; set; } Property Value double OptYieldingUtilizationFactor Utilization factor for yielding during optimization. It is the reciprocal of the yielding safety factor. [JsAce] public double OptYieldingUtilizationFactor { get; set; } Property Value double ParaTemplateDimension Gets or sets the parameter template dimension (2D or 3D). [JsAce] public int ParaTemplateDimension { get; set; } Property Value int ScriptOptions ScriptOptions. public ScriptOptions ScriptOptions { get; set; } Property Value ScriptOptions SessionMessageHost Gets the session message host for displaying messages. [JsAce] public SessionMessageHost SessionMessageHost { get; } Property Value SessionMessageHost StepCount Gets the total number of milling steps. [JsAce] public int StepCount { get; } Property Value int Workpiece [JsAce] public Workpiece Workpiece { get; set; } Property Value Workpiece Methods AddTimeDataByFile(string, string, double, double) Adds time-based data from a file to the time mapping dictionary with specified time bounds in seconds. [JsAce(\"AddTimeDataByFile($1key, $2relFile, $3beginTime, $4endTime)\")] public bool AddTimeDataByFile(string key, string relFile, double beginTime, double endTime) Parameters key string Key to identify the data relFile string Relative path to the data file beginTime double Beginning time in seconds endTime double Ending time in seconds Returns bool True if the data was successfully added, false otherwise AddTimeDataByFile(string, string, string, string) Adds time-based data from a file to the time mapping dictionary with specified time bounds. [JsAce(\"AddTimeDataByFile($1key, $2relFile, $3beginTime, $4endTime)\")] public bool AddTimeDataByFile(string key, string relFile, string beginTimeText, string endTimeText) Parameters key string Key to identify the data relFile string Relative path to the data file beginTimeText string Beginning time as text (seconds or TimeSpan format) endTimeText string Ending time as text (seconds or TimeSpan format) Returns bool True if the data was successfully added, false otherwise AppendMessagesToFile(string, params string[]) Appends messages to a file, optionally filtered by tags. [JsAce(\"AppendMessagesToFile(\\\"dstRelFile\\\",flags)\")] public void AppendMessagesToFile(string dstRelFile, params string[] flags) Parameters dstRelFile string Destination relative file path flags string[] Optional flags to filter messages by tags BeginPreserve() Begin Preserve section in optimzation process. [JsAce(\"BeginPreserve()\")] public void BeginPreserve() BeginSelection(string, AnchorMode, IStepShift) Begin mark on current line. milling step() has not triggered yet. public void BeginSelection(string key, AnchorMode anchorMode = AnchorMode.LineBegin, IStepShift shift = null) Parameters key string Identifier key for the selection anchorMode AnchorMode Mode for anchoring the beginning of selection shift IStepShift Step shift to apply BeginSession() Begins a new machining session. public void BeginSession() ClearTimeMappingData() Clears all time mapping data. [JsAce] public void ClearTimeMappingData() Diff(double) Performs a difference analysis on the workpiece geometry to detect variations. [JsAce(\"Diff($1detectionRadius_mm)\")] public void Diff(double detectionRadius_mm) Parameters detectionRadius_mm double Radius for detecting differences EndPreserve() End Preserve section in optimzation process. [JsAce(\"EndPreserve()\")] public void EndPreserve() EndSelection(string, AnchorMode, IStepShift) End mark on current line for selection. public void EndSelection(string key, AnchorMode anchorMode = AnchorMode.LineEnd, IStepShift shift = null) Parameters key string Identifier key for the selection anchorMode AnchorMode Mode for anchoring the end of selection shift IStepShift Step shift to apply EndSession() Ends the current machining session. public void EndSession() ErrorMessage(string) Displays an error message in the message host. [JsAce(\"ErrorMessage($1message)\")] public void ErrorMessage(string message) Parameters message string The error message to display FixedPace(double, double) Creates a fixed machining motion resolution with specified parameters. [JsAce(\"FixedPace($1linearResolution_mm, $2rotaryResolution_deg)\")] public FixedMachiningMotionResolution FixedPace(double linearResolution_mm, double rotaryResolution_deg) Parameters linearResolution_mm double Linear resolution in millimeters rotaryResolution_deg double Rotary resolution in degrees Returns FixedMachiningMotionResolution A new fixed machining motion resolution instance GetMillingStep(int) Retrieves a milling step at the specified index. [JsAce(Snippet = \"GetMillingStep($1\\\"stepIndex\\\")\")] public MachiningStep GetMillingStep(int stepIndex) Parameters stepIndex int Index of the milling step to retrieve Returns MachiningStep The milling step at the specified index GetStickMachiningToolObservationHeight_mm(int) Gets the observation height in millimeters for the specified stick machining tool. [JsAce(\"GetStickMachiningToolObservationHeight_mm($1toolId)\")] public double GetStickMachiningToolObservationHeight_mm(int toolId) Parameters toolId int The ID of the tool Returns double The observation height in millimeters GetUniformContourTrayShiftAngle_deg(int) Gets the shift angle in degrees for the uniform contour tray of the specified tool. [JsAce(\"GetUniformContourTrayShiftAngle_deg($1toolId)\")] public double GetUniformContourTrayShiftAngle_deg(int toolId) Parameters toolId int The ID of the tool Returns double The shift angle in degrees LineSelection(string, AnchorMode, IStepShift, AnchorMode, IStepShift) Create a line selection from begin to end mark. public void LineSelection(string key, AnchorMode beginAnchorMode = AnchorMode.LineBegin, IStepShift beginShift = null, AnchorMode endAnchorMode = AnchorMode.LineEnd, IStepShift endShift = null) Parameters key string Identifier key for the selection beginAnchorMode AnchorMode Mode for anchoring the beginning of selection beginShift IStepShift Step shift to apply at beginning endAnchorMode AnchorMode Mode for anchoring the end of selection endShift IStepShift Step shift to apply at end Map(string, FileTimeSection, CycleSamplingMode?) Maps selection data to time section. public Task Map(string key, FileTimeSection fileTimeSection = null, StepTimeShotUtil.CycleSamplingMode? cycleSamplingMode = CycleSamplingMode.SpindleCycle) Parameters key string Identifier key for the selection fileTimeSection FileTimeSection File time section, or null to use the one associated with the key cycleSamplingMode StepTimeShotUtil.CycleSamplingMode? Cycle sampling mode Returns Task Task representing the asynchronous mapping operation MapByActualTime(string, CycleSamplingMode) [JsAce(\"MapByActualTime($1timeShotRelFile)\")] public void MapByActualTime(string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode = CycleSamplingMode.SpindleCycle) Parameters timeShotRelFile string cycleSamplingMode StepTimeShotUtil.CycleSamplingMode Message(string) Displays a message in the message host. [JsAce(\"Message($1message)\")] public void Message(string message) Parameters message string The message to display OptCallPreferFuncIndexDictionary() [JsAce(\"OptCallPreferFuncIndexDictionary()\")] public Dictionary<Func<MillingPhysicsBrief, double>, double> OptCallPreferFuncIndexDictionary() Returns Dictionary<Func<MillingPhysicsBrief, double>, double> OptimizeToFiles(string) Optimizes NC files and saves results using the specified file template. [JsAce(Snippet = \"OptimizeToFiles(\\\"Output/Opt-[NcName]\\\")\", DocContentHtml = \"Optimize To Files by substitude template keywoard \\\"[NcName]\\\"\")] public void OptimizeToFiles(string relFileTemplate = \"Output/Opt-[NcName]\") Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder Pace() Controls the pace of machining operations during execution. [JsAce(\"Pace();\")] public void Pace() Pause() Pause Player [JsAce(DocContentHtml = \"Pause Player\")] public void Pause() PlayAct(IAct, IIndexedFileLine, CancellationToken?) Plays an act with pacing control. [JsAce] public void PlayAct(IAct act, IIndexedFileLine sourceCommand = null, CancellationToken? cancellationToken = null) Parameters act IAct The act to play. sourceCommand IIndexedFileLine The source command. cancellationToken CancellationToken? Cancellation token. PlayClTeleport(double, double, double, double, double, double) Plays a CL (cutter location) teleport operation. [JsAce] public void PlayClTeleport(double x, double y, double z, double i, double j, double k) Parameters x double X coordinate. y double Y coordinate. z double Z coordinate. i double I vector component. j double J vector component. k double K vector component. PlayCsvFile(string) Plays an Csv file with the specified relative path. [JsAce(\"PlayCsvFile($1\\\"csvFile\\\");\")] public void PlayCsvFile(string relFilePath) Parameters relFilePath string Relative path to the CSV file PlayNc(string, string) Plays NC code directly from a string, executing each action and pacing between them. [JsAce(Snippet = \"PlayNc($1\\\"ncCommand\\\",$2\\\"\\\"(Direct Command)\\\"\\\");\", DocContentHtml = \"Play NC. second parameter is the file name alternative shows in the log.\")] public void PlayNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string NC code as a string fileNameAlternative string Alternative name to display in logs PlayNcFile(string) Plays an NC file with the specified relative path. [JsAce(\"PlayNcFile($1\\\"ncFile\\\");\")] public void PlayNcFile(string relNcFilePath) Parameters relNcFilePath string Relative path to the NC file PlayToolingTeleport(int) Plays a tooling teleport operation. [JsAce] public void PlayToolingTeleport(int toolId) Parameters toolId int The tool ID to teleport. Preserve() Preserve one line NC code in optimzation process. [JsAce(\"Preserve()\")] public void Preserve() ProgressMessage(string) Displays a progress message in the message host. [JsAce(\"ProgressMessage($1message)\")] public void ProgressMessage(string message) Parameters message string The progress message to display ReTrainMillingPara(SampleFlag, string, double) Re-trains milling parameters using the specified sample flag. [JsAce(\"ReTrainMillingPara(Fx|Fy|Fz, $1dstFile)\")] public void ReTrainMillingPara(SampleFlag sampleFlag, string dstRelFile, double outlierRatio = 2) Parameters sampleFlag SampleFlag Sample flag indicating which components to train dstRelFile string Destination relative file path outlierRatio double Outlier ratio for data filtering ReadCsvByTimeInterpolation(string) Reads a CSV file and performs time-based interpolation to map data to milling steps. [JsAce(Snippet = \"ReadCsvByTimeInterpolation($1\\\"csvFile\\\")\")] public void ReadCsvByTimeInterpolation(string csvFile) Parameters csvFile string Path to the CSV file relative to the base directory ReadRuntimeGeom(string) Reads runtime geometry from a file. [JsAce(\"ReadRuntimeGeom($1\\\"srcFile\\\")\")] public void ReadRuntimeGeom(string relFile) Parameters relFile string Relative path to the input file RegisterStepVariable(string, string, string, string, Func<MachiningStep, object>) Registers a step variable for tracking during execution. [JsAce(Snippet = \"RegisterStepVariable(\\\"$1key\\\",\\\"$2name\\\",\\\"$3unit\\\",\\\"$4formatString\\\",\\\"$5variableFunc\\\")\", DocContentHtml = \"<p>Register Step Variable.</p> <p>\\\"unit\\\" is nullable</p> <p>\\\"formatString\\\" is nullable</p>\")] public void RegisterStepVariable(string key, string name, string unit, string formatString, Func<MachiningStep, object> variableFunc = null) Parameters key string Unique key to identify the variable name string Human-readable name of the variable unit string Physical unit of the variable (can be null) formatString string Format string for displaying the variable (can be null) variableFunc Func<MachiningStep, object> Function to compute the variable value from a milling step (can be null) RemoveFlyPiece() Removes any disconnected or “flying” pieces from the workpiece geometry. [JsAce] public void RemoveFlyPiece() Reset() Reset Player [JsAce(DocContentHtml = \"Reset Player\")] public void Reset() ResetRuntime() Clears internal buffers. [JsAce] public void ResetRuntime() RunNc(string, string) Runs NC code directly from a string. [JsAce(Snippet = \"RunNc($1\\\"ncCommand\\\",$2\\\"\\\"(Direct Command)\\\"\\\");\", DocContentHtml = \"Run NC. second parameter is the file name alternative shows in the log.\")] public IEnumerable<Action> RunNc(string ncText, string fileNameAlternative = \"--\") Parameters ncText string NC code as a string fileNameAlternative string Alternative name to display in logs Returns IEnumerable<Action> Enumerable sequence of actions to be executed RunNcFile(string) Runs an NC file with the specified relative path. [JsAce(\"RunNcFile($1\\\"ncFile\\\");\")] public IEnumerable<Action> RunNcFile(string relNcFilePath) Parameters relNcFilePath string Relative path to the NC file Returns IEnumerable<Action> Enumerable sequence of actions to be executed SetNcResolutionFeedPerCycle() Sets NC resolution to feed per cycle mode. public void SetNcResolutionFeedPerCycle() SetNcResolutionFeedPerTooth() Sets NC resolution to feed per tooth mode. public void SetNcResolutionFeedPerTooth() SetNcResolutionFixed(double, double) Sets NC resolution to fixed mode with specified resolution values. public void SetNcResolutionFixed(double linearResolution_mm, double rotaryResolution_deg) Parameters linearResolution_mm double Linear resolution in millimeters. rotaryResolution_deg double Rotary resolution in degrees. SetStickMachiningToolObservationHeight_mm(int, double) Sets the observation height in millimeters for the specified stick machining tool. [JsAce(\"SetStickMachiningToolObservationHeight_mm($1toolId,$2height_mm)\")] public void SetStickMachiningToolObservationHeight_mm(int toolId, double height) Parameters toolId int The ID of the tool height double The observation height in millimeters to set SetUniformContourTrayShiftAngle_deg(int, double) Sets the shift angle in degrees for the uniform contour tray of the specified tool. [JsAce(\"SetUniformContourTrayShiftAngle_deg($1toolId,$2angle_deg)\")] public void SetUniformContourTrayShiftAngle_deg(int toolId, double angle_deg) Parameters toolId int The ID of the tool angle_deg double The shift angle in degrees to set ShiftDistance_mm(double) Creates a distance shift object representing the specified distance in millimeters. public DistanceShift ShiftDistance_mm(double distanceShift_mm) Parameters distanceShift_mm double Distance shift in millimeters Returns DistanceShift Distance shift object ShiftTime_s(double) Creates a time shift object representing the specified time in seconds. public TimeShift ShiftTime_s(double seconds) Parameters seconds double Time in seconds Returns TimeShift Time shift object TrainMillingPara(SampleFlag, string, double) Trains milling parameters using the specified sample flag. [JsAce(\"TrainMillingPara(Fx|Fy|Fz, $1dstFile)\")] public void TrainMillingPara(SampleFlag sampleFlag, string dstRelFile, double outlierRatio = 2) Parameters sampleFlag SampleFlag Sample flag indicating which components to train dstRelFile string Destination relative file path outlierRatio double Outlier ratio for data filtering WarningMessage(string) Displays a warning message in the message host. [JsAce(\"WarningMessage($1message)\")] public void WarningMessage(string message) Parameters message string The warning message to display WriteRuntimeGeom(string) Writes the current runtime geometry to a file. [JsAce(\"WriteRuntimeGeom($1\\\"dstFile\\\")\")] public void WriteRuntimeGeom(string relFile) Parameters relFile string Relative path to the output file WriteRuntimeGeomToStl(string, double) Writes the current runtime geometry to an STL file. [JsAce(\"WriteRuntimeGeomToStl($1\\\"dstFile\\\",$2resolution_mm)\")] public void WriteRuntimeGeomToStl(string relFile, double resolution_mm = 0) Parameters relFile string Relative path to the output STL file resolution_mm double Resolution in millimeters (0 for default) WriteShotFiles(double, string) Writes time-series data to shot files with the specified resolution period (alternative parameter order). public void WriteShotFiles(double resolutionPeroid_ms, string relFileTemplate) Parameters resolutionPeroid_ms double Resolution period in milliseconds relFileTemplate string Template for output file path, can include [NcName] placeholder WriteShotFiles(string, double) Writes time-series data to shot files with the specified resolution period. [JsAce(Snippet = \"WriteShotFiles(\\\"Output/[NcName].shot.csv\\\",resolutionPeroid_ms)\", DocContentHtml = \"Write time series data by resolutionPeroid_ms\")] public void WriteShotFiles(string relFileTemplate = \"Output/[NcName].shot.csv\", double resolutionPeroid_ms = 1) Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder resolutionPeroid_ms double Resolution period in milliseconds WriteStepFiles(string) Writes step-series data to files with the specified file template. [JsAce(Snippet = \"WriteStepFiles(\\\"Output/[NcName].step.csv\\\")\", DocContentHtml = \"Write step series data.\")] public void WriteStepFiles(string relFileTemplate = \"Output/[NcName].step.csv\") Parameters relFileTemplate string Template for output file path, can include [NcName] placeholder Events MachiningStepBuilt Gets or sets the action to configure steps during execution. The event will be cleared by the calling of ResetRuntime(). [JsAce(Snippet = \"MachiningStepBuilt+=($1preStep,$2curStep)=>{$3Command};\", DocContentHtml = \"Runtime Step Configuration action. preStep is the Previous Milling Step; curStep is the Current Milling Step. preStep is null if no previous step existed.\")] public event MachiningActRunner.MachiningStepBuiltDelegate MachiningStepBuilt Event Type MachiningActRunner.MachiningStepBuiltDelegate MachiningStepSelected Event that is triggered when a milling step is selected. The event will be cleared by the calling of ResetRuntime(). [JsAce(Snippet = \"MachiningStepSelected+=($1millingStep)=>{$2Command};\")] public event Action<MachiningStep> MachiningStepSelected Event Type Action<MachiningStep>"
   },
   "api/Hi.MachiningProcs.RuntimeController.html": {
     "href": "api/Hi.MachiningProcs.RuntimeController.html",
@@ -2092,12 +2092,12 @@
   "api/Hi.Mapping.StepTimeShotUtil.html": {
     "href": "api/Hi.Mapping.StepTimeShotUtil.html",
     "title": "Class StepTimeShotUtil | HiAPI-C# 2025",
-    "summary": "Class StepTimeShotUtil Namespace Hi.Mapping Assembly HiMech.dll Utility methods for working with time-based shots (measurements) and mapping them to machining steps. public static class StepTimeShotUtil Inheritance object StepTimeShotUtil Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Methods GetStepToShotsDictionaryByActualTime(ClStrip, Range<int>, CycleSamplingMode, string, GetTimeShotByFileDelegate) public static Dictionary<int, List<ITimeShot>> GetStepToShotsDictionaryByActualTime(ClStrip clStrip, Range<int> stepSection, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc) Parameters clStrip ClStrip stepSection Range<int> cycleSamplingMode StepTimeShotUtil.CycleSamplingMode timeShotRelFile string getTimeShotByRelFileFunc StepTimeShotUtil.GetTimeShotByFileDelegate Returns Dictionary<int, List<ITimeShot>> GetTimeShotByFile(string, Action<int>, CancellationToken?) Gets time shots from a file, reading and parsing force acceleration data. public static List<ITimeShot> GetTimeShotByFile(string file, Action<int> LineReaded, CancellationToken? cancellationToken = null) Parameters file string The file path to read time shots from. LineReaded Action<int> Action to call when a line is read, providing progress feedback with the current line number. cancellationToken CancellationToken? Optional cancellation token to cancel the reading operation. Returns List<ITimeShot> A list of time shots read from the file, or null if the file cannot be read or is invalid."
+    "summary": "Class StepTimeShotUtil Namespace Hi.Mapping Assembly HiMech.dll Utility methods for working with time-based shots (measurements) and mapping them to machining steps. public static class StepTimeShotUtil Inheritance object StepTimeShotUtil Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Methods GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, string, GetTimeShotByFileDelegate, IDictionary<int, List<ITimeShot>>, SessionMessageHost, CancellationToken?) public static void GetStepToShotsDictionaryByActualTime(ClStrip clStrip, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, string timeShotRelFile, StepTimeShotUtil.GetTimeShotByFileDelegate getTimeShotByRelFileFunc, IDictionary<int, List<ITimeShot>> dstStepToShotsDictionary, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken) Parameters clStrip ClStrip cycleSamplingMode StepTimeShotUtil.CycleSamplingMode timeShotRelFile string getTimeShotByRelFileFunc StepTimeShotUtil.GetTimeShotByFileDelegate dstStepToShotsDictionary IDictionary<int, List<ITimeShot>> sessionMessageHost SessionMessageHost cancellationToken CancellationToken? GetTimeShotByFile(string, Action<int>, CancellationToken?) Gets time shots from a file, reading and parsing force acceleration data. public static List<ITimeShot> GetTimeShotByFile(string file, Action<int> LineReaded, CancellationToken? cancellationToken = null) Parameters file string The file path to read time shots from. LineReaded Action<int> Action to call when a line is read, providing progress feedback with the current line number. cancellationToken CancellationToken? Optional cancellation token to cancel the reading operation. Returns List<ITimeShot> A list of time shots read from the file, or null if the file cannot be read or is invalid."
   },
   "api/Hi.Mapping.TimeMapping.html": {
     "href": "api/Hi.Mapping.TimeMapping.html",
     "title": "Class TimeMapping | HiAPI-C# 2025",
-    "summary": "Class TimeMapping Namespace Hi.Mapping Assembly HiMech.dll Provides mapping between machining steps and time-based measurements (shots), public class TimeMapping : IMakeXmlSource, IDisposable Inheritance object TimeMapping Implements IMakeXmlSource IDisposable Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Constructors TimeMapping(ClStrip, MachiningToolHouse, Func<string>) Initializes a new instance of the TimeMapping class with the specified CL strip and tool house. public TimeMapping(ClStrip clStrip, MachiningToolHouse millingToolHouse, Func<string> baseDirectoryGetter) Parameters clStrip ClStrip The cutter location strip containing the machining steps. millingToolHouse MachiningToolHouse The machining tool house containing available tools. baseDirectoryGetter Func<string> TimeMapping(XElement, Func<string>) Initializes a new instance of the TimeMapping class from XML data. public TimeMapping(XElement src, Func<string> baseDirectoryGetter) Parameters src XElement The XML element containing the mapping data. baseDirectoryGetter Func<string> Remarks This constructor supports legacy XML formats and automatically converts them to the current format. Legacy formats include: NcMapping with MarkIdToFileTimeSection element Entries with MarkID attributes Properties BaseDirectory Gets or sets the base directory for resolving file paths. All relative file paths in the mapping are resolved against this directory. public string BaseDirectory { get; } Property Value string BaseDirectoryGetter public Func<string> BaseDirectoryGetter { get; set; } Property Value Func<string> ClStrip Gets or sets the cutter location strip containing the machining steps. This is used as a reference for mapping time shots to machining steps. public ClStrip ClStrip { get; set; } Property Value ClStrip KeyToRelFileTimeSectionDictionary Gets or sets the dictionary mapping keys to file time sections. Each entry maps a unique identifier to a file time section that specifies which portion of a measurement file corresponds to a particular machining operation. public Dictionary<string, FileTimeSection> KeyToRelFileTimeSectionDictionary { get; set; } Property Value Dictionary<string, FileTimeSection> LineReaded Gets or sets the callback action that is invoked when a line is read from a measurement file. This can be used to track progress during file loading operations. public Action<int> LineReaded { get; set; } Property Value Action<int> Remarks The parameter passed to the action is the current line number being read. MillingToolHouse Gets or sets the machining tool house containing available tools. This is used to determine tool-specific parameters during mapping. public MachiningToolHouse MillingToolHouse { get; set; } Property Value MachiningToolHouse RelFileToTimeShotListDictionary Gets or sets the cache of time shot lists loaded from files. This is a thread-safe dictionary that maps file paths to tasks that load and parse the files. The cache prevents multiple reads of the same file and enables concurrent access. public ConcurrentDictionary<string, Task<List<ITimeShot>>> RelFileToTimeShotListDictionary { get; set; } Property Value ConcurrentDictionary<string, Task<List<ITimeShot>>> StepToTimeShotListDictionary Gets a concurrent dictionary mapping step indices to their corresponding time shot lists. This dictionary is populated during the mapping process. public ConcurrentDictionary<int, List<ITimeShot>> StepToTimeShotListDictionary { get; } Property Value ConcurrentDictionary<int, List<ITimeShot>> XName Gets the XML element name used for serialization. public static string XName { get; } Property Value string Remarks This name is used as the root element when serializing TimeMapping instances to XML. It matches the class name to maintain consistency between code and XML representation. Methods CallTimeShotByRelFile(string, CancellationToken?) Retrieves time shots from a file, using cached results if available. public List<ITimeShot> CallTimeShotByRelFile(string relFile, CancellationToken? cancellationToken = null) Parameters relFile string The relative path to the file containing time shots. cancellationToken CancellationToken? Optional token to cancel the loading operation. Returns List<ITimeShot> A list of time shots from the file. The results are cached for subsequent calls. If the file is already being loaded by another thread, waits for that operation to complete. Remarks This method is thread-safe and ensures each file is only read once, even with concurrent access. Any exceptions during file reading are captured and can be inspected through the task's exception property. Clear() Clears all mappings and data, including the key-to-file time section dictionary. public void Clear() ClearCache() Clears the cache of loaded time shot data, including file-to-time shot list and step-to-time shot list dictionaries. public void ClearCache() Dispose() Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. public void Dispose() Dispose(bool) protected virtual void Dispose(bool disposing) Parameters disposing bool GetShots(int) Gets the time shots associated with a specific step index. public List<ITimeShot> GetShots(int stepIndex) Parameters stepIndex int The index of the step to get shots for. Returns List<ITimeShot> A list of time shots associated with the specified step, or null if no shots are found. LoadTimeShotFiles(CancellationToken?) Loads all time shot files referenced in the KeyToFileTimeSectionMapping. public void LoadTimeShotFiles(CancellationToken? cancellationToken = null) Parameters cancellationToken CancellationToken? Optional cancellation token to cancel the operation. MakeXmlSource(string, string, bool) Creates an XML representation of the time mapping data. relFile is not used in current implementation. public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly) Parameters baseDirectory string The base directory for resolving relative paths relFile string The relative file path for the XML source exhibitionOnly bool if true, the extended file creation is suppressed. Returns XElement An XML element containing the complete time mapping data. Remarks The XML structure includes: A root TimeMapping element An Entrys element containing Entry elements Each Entry has a Key attribute and FileTimeSection child element Map(Range<int>, FileTimeSection, CycleSamplingMode, CancellationToken?) Maps the specified step section to time shots using the provided file time section and cycle sampling mode. This method is thread-safe and can be called concurrently. public void Map(Range<int> stepSection, FileTimeSection relFileTimeSection, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, CancellationToken? cancellationToken = null) Parameters stepSection Range<int> The range of step indices to process. relFileTimeSection FileTimeSection The file time section containing file path and time range. cycleSamplingMode StepTimeShotUtil.CycleSamplingMode The cycle sampling mode to use. cancellationToken CancellationToken? Optional cancellation token to cancel the operation. MapByActualTime(Range<int>, string, CycleSamplingMode, CancellationToken?) public void MapByActualTime(Range<int> stepSection, string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, CancellationToken? cancellationToken = null) Parameters stepSection Range<int> timeShotRelFile string cycleSamplingMode StepTimeShotUtil.CycleSamplingMode cancellationToken CancellationToken? WaitMapping() Waits for all mapping operations to complete. This method blocks until all concurrent mapping tasks have finished. public void WaitMapping()"
+    "summary": "Class TimeMapping Namespace Hi.Mapping Assembly HiMech.dll Provides mapping between machining steps and time-based measurements (shots), public class TimeMapping : IMakeXmlSource, IDisposable Inheritance object TimeMapping Implements IMakeXmlSource IDisposable Inherited Members object.Equals(object) object.Equals(object, object) object.GetHashCode() object.GetType() object.MemberwiseClone() object.ReferenceEquals(object, object) object.ToString() Extension Methods DuplicateUtil.TryDuplicate<TSelf>(TSelf, params object[]) InvokeUtil.SelfInvoke<TSrc>(TSrc, Action<TSrc>) InvokeUtil.SelfInvoke<TSrc, TDst>(TSrc, Func<TSrc, TDst>) ColorUtil.GetGloomyColor(object, double, double) NameUtil.GetSelectionName(object) StringUtil.GetPropertyStringIfToStringNotOverloaded(object, bool, bool) LockUtil.Lock(object) Constructors TimeMapping(ClStrip, MachiningToolHouse, Func<string>) Initializes a new instance of the TimeMapping class with the specified CL strip and tool house. public TimeMapping(ClStrip clStrip, MachiningToolHouse millingToolHouse, Func<string> baseDirectoryGetter) Parameters clStrip ClStrip The cutter location strip containing the machining steps. millingToolHouse MachiningToolHouse The machining tool house containing available tools. baseDirectoryGetter Func<string> TimeMapping(XElement, Func<string>) Initializes a new instance of the TimeMapping class from XML data. public TimeMapping(XElement src, Func<string> baseDirectoryGetter) Parameters src XElement The XML element containing the mapping data. baseDirectoryGetter Func<string> Remarks This constructor supports legacy XML formats and automatically converts them to the current format. Legacy formats include: NcMapping with MarkIdToFileTimeSection element Entries with MarkID attributes Properties BaseDirectory Gets or sets the base directory for resolving file paths. All relative file paths in the mapping are resolved against this directory. public string BaseDirectory { get; } Property Value string BaseDirectoryGetter public Func<string> BaseDirectoryGetter { get; set; } Property Value Func<string> ClStrip Gets or sets the cutter location strip containing the machining steps. This is used as a reference for mapping time shots to machining steps. public ClStrip ClStrip { get; set; } Property Value ClStrip KeyToRelFileTimeSectionDictionary Gets or sets the dictionary mapping keys to file time sections. Each entry maps a unique identifier to a file time section that specifies which portion of a measurement file corresponds to a particular machining operation. public Dictionary<string, FileTimeSection> KeyToRelFileTimeSectionDictionary { get; set; } Property Value Dictionary<string, FileTimeSection> LineReaded Gets or sets the callback action that is invoked when a line is read from a measurement file. This can be used to track progress during file loading operations. public Action<int> LineReaded { get; set; } Property Value Action<int> Remarks The parameter passed to the action is the current line number being read. MillingToolHouse Gets or sets the machining tool house containing available tools. This is used to determine tool-specific parameters during mapping. public MachiningToolHouse MillingToolHouse { get; set; } Property Value MachiningToolHouse RelFileToTimeShotListDictionary Gets or sets the cache of time shot lists loaded from files. This is a thread-safe dictionary that maps file paths to tasks that load and parse the files. The cache prevents multiple reads of the same file and enables concurrent access. public ConcurrentDictionary<string, Task<List<ITimeShot>>> RelFileToTimeShotListDictionary { get; set; } Property Value ConcurrentDictionary<string, Task<List<ITimeShot>>> StepToTimeShotListDictionary Gets a concurrent dictionary mapping step indices to their corresponding time shot lists. This dictionary is populated during the mapping process. public ConcurrentDictionary<int, List<ITimeShot>> StepToTimeShotListDictionary { get; } Property Value ConcurrentDictionary<int, List<ITimeShot>> XName Gets the XML element name used for serialization. public static string XName { get; } Property Value string Remarks This name is used as the root element when serializing TimeMapping instances to XML. It matches the class name to maintain consistency between code and XML representation. Methods CallTimeShotByRelFile(string, CancellationToken?) Retrieves time shots from a file, using cached results if available. public List<ITimeShot> CallTimeShotByRelFile(string relFile, CancellationToken? cancellationToken = null) Parameters relFile string The relative path to the file containing time shots. cancellationToken CancellationToken? Optional token to cancel the loading operation. Returns List<ITimeShot> A list of time shots from the file. The results are cached for subsequent calls. If the file is already being loaded by another thread, waits for that operation to complete. Remarks This method is thread-safe and ensures each file is only read once, even with concurrent access. Any exceptions during file reading are captured and can be inspected through the task's exception property. Clear() Clears all mappings and data, including the key-to-file time section dictionary. public void Clear() ClearCache() Clears the cache of loaded time shot data, including file-to-time shot list and step-to-time shot list dictionaries. public void ClearCache() Dispose() Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. public void Dispose() Dispose(bool) protected virtual void Dispose(bool disposing) Parameters disposing bool GetShots(int) Gets the time shots associated with a specific step index. public List<ITimeShot> GetShots(int stepIndex) Parameters stepIndex int The index of the step to get shots for. Returns List<ITimeShot> A list of time shots associated with the specified step, or null if no shots are found. LoadTimeShotFiles(CancellationToken?) Loads all time shot files referenced in the KeyToFileTimeSectionMapping. public void LoadTimeShotFiles(CancellationToken? cancellationToken = null) Parameters cancellationToken CancellationToken? Optional cancellation token to cancel the operation. MakeXmlSource(string, string, bool) Creates an XML representation of the time mapping data. relFile is not used in current implementation. public XElement MakeXmlSource(string baseDirectory, string relFile, bool exhibitionOnly) Parameters baseDirectory string The base directory for resolving relative paths relFile string The relative file path for the XML source exhibitionOnly bool if true, the extended file creation is suppressed. Returns XElement An XML element containing the complete time mapping data. Remarks The XML structure includes: A root TimeMapping element An Entrys element containing Entry elements Each Entry has a Key attribute and FileTimeSection child element Map(Range<int>, FileTimeSection, CycleSamplingMode, CancellationToken?) Maps the specified step section to time shots using the provided file time section and cycle sampling mode. This method is thread-safe and can be called concurrently. public void Map(Range<int> stepSection, FileTimeSection relFileTimeSection, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, CancellationToken? cancellationToken = null) Parameters stepSection Range<int> The range of step indices to process. relFileTimeSection FileTimeSection The file time section containing file path and time range. cycleSamplingMode StepTimeShotUtil.CycleSamplingMode The cycle sampling mode to use. cancellationToken CancellationToken? Optional cancellation token to cancel the operation. MapByActualTime(string, CycleSamplingMode, SessionMessageHost, CancellationToken?) public void MapByActualTime(string timeShotRelFile, StepTimeShotUtil.CycleSamplingMode cycleSamplingMode, SessionMessageHost sessionMessageHost, CancellationToken? cancellationToken = null) Parameters timeShotRelFile string cycleSamplingMode StepTimeShotUtil.CycleSamplingMode sessionMessageHost SessionMessageHost cancellationToken CancellationToken? WaitMapping() Waits for all mapping operations to complete. This method blocks until all concurrent mapping tasks have finished. public void WaitMapping()"
   },
   "api/Hi.Mapping.html": {
     "href": "api/Hi.Mapping.html",
@@ -5032,7 +5032,7 @@
   "brief/dev-doc/release-note/index.html": {
     "href": "brief/dev-doc/release-note/index.html",
     "title": "Release Note | HiAPI-C# 2025",
-    "summary": "Release Note HiNc Packages Version 3.1.74 Rename class MillingCutterOptLimit to MillingCutterOptOption Add physics simulation function for relief face collision depth detection (ReliefFaceCollidingDepth_mm) and optimization (EnableLimitByReliefAngle) Add UpdateNcOptOption function to step processing Fix step ordering bug from concurrent processing Fix ClStrip shrinking to zero issue"
+    "summary": "Release Note HiNc Packages Version 3.1.75 Add actual time tracking functionality (ActualTime) Various stability improvements and bug fixes HiNc Packages Version 3.1.74 Rename class MillingCutterOptLimit to MillingCutterOptOption Add physics simulation function for relief face collision depth detection (ReliefFaceCollidingDepth_mm) and optimization (EnableLimitByReliefAngle) Add UpdateNcOptOption function to step processing Fix step ordering bug from concurrent processing Fix ClStrip shrinking to zero issue"
   },
   "brief/dev-doc/system-requirements.html": {
     "href": "brief/dev-doc/system-requirements.html",
diff --git a/App/wwwroot/HiAPI-docsite/xrefmap.yml b/App/wwwroot/HiAPI-docsite/xrefmap.yml
index 229a264..6831291 100644
--- a/App/wwwroot/HiAPI-docsite/xrefmap.yml
+++ b/App/wwwroot/HiAPI-docsite/xrefmap.yml
@@ -79819,6 +79819,22 @@ references:
   isSpec: "True"
   fullName: Hi.MachiningProcs.RuntimeApi.Map
   nameWithType: RuntimeApi.Map
+- uid: Hi.MachiningProcs.RuntimeApi.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode)
+  name: MapByActualTime(string, CycleSamplingMode)
+  href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_MapByActualTime_System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_
+  commentId: M:Hi.MachiningProcs.RuntimeApi.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode)
+  name.vb: MapByActualTime(String, CycleSamplingMode)
+  fullName: Hi.MachiningProcs.RuntimeApi.MapByActualTime(string, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode)
+  fullName.vb: Hi.MachiningProcs.RuntimeApi.MapByActualTime(String, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode)
+  nameWithType: RuntimeApi.MapByActualTime(string, StepTimeShotUtil.CycleSamplingMode)
+  nameWithType.vb: RuntimeApi.MapByActualTime(String, StepTimeShotUtil.CycleSamplingMode)
+- uid: Hi.MachiningProcs.RuntimeApi.MapByActualTime*
+  name: MapByActualTime
+  href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_MapByActualTime_
+  commentId: Overload:Hi.MachiningProcs.RuntimeApi.MapByActualTime
+  isSpec: "True"
+  fullName: Hi.MachiningProcs.RuntimeApi.MapByActualTime
+  nameWithType: RuntimeApi.MapByActualTime
 - uid: Hi.MachiningProcs.RuntimeApi.MapTask
   name: MapTask
   href: api/Hi.MachiningProcs.RuntimeApi.html#Hi_MachiningProcs_RuntimeApi_MapTask
@@ -85967,15 +85983,15 @@ references:
   commentId: F:Hi.Mapping.StepTimeShotUtil.CycleSamplingMode.SpindleCycle
   fullName: Hi.Mapping.StepTimeShotUtil.CycleSamplingMode.SpindleCycle
   nameWithType: StepTimeShotUtil.CycleSamplingMode.SpindleCycle
-- uid: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Common.Range{System.Int32},Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate)
-  name: GetStepToShotsDictionaryByActualTime(ClStrip, Range<int>, CycleSamplingMode, string, GetTimeShotByFileDelegate)
-  href: api/Hi.Mapping.StepTimeShotUtil.html#Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_Hi_CutterLocations_ClStrips_ClStrip_Hi_Common_Range_System_Int32__Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_String_Hi_Mapping_StepTimeShotUtil_GetTimeShotByFileDelegate_
-  commentId: M:Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Common.Range{System.Int32},Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate)
-  name.vb: GetStepToShotsDictionaryByActualTime(ClStrip, Range(Of Integer), CycleSamplingMode, String, GetTimeShotByFileDelegate)
-  fullName: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip, Hi.Common.Range<int>, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, string, Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate)
-  fullName.vb: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip, Hi.Common.Range(Of Integer), Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, String, Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate)
-  nameWithType: StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(ClStrip, Range<int>, StepTimeShotUtil.CycleSamplingMode, string, StepTimeShotUtil.GetTimeShotByFileDelegate)
-  nameWithType.vb: StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(ClStrip, Range(Of Integer), StepTimeShotUtil.CycleSamplingMode, String, StepTimeShotUtil.GetTimeShotByFileDelegate)
+- uid: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate,System.Collections.Generic.IDictionary{System.Int32,System.Collections.Generic.List{Hi.Mapping.ITimeShot}},Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})
+  name: GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, string, GetTimeShotByFileDelegate, IDictionary<int, List<ITimeShot>>, SessionMessageHost, CancellationToken?)
+  href: api/Hi.Mapping.StepTimeShotUtil.html#Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_Hi_CutterLocations_ClStrips_ClStrip_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_String_Hi_Mapping_StepTimeShotUtil_GetTimeShotByFileDelegate_System_Collections_Generic_IDictionary_System_Int32_System_Collections_Generic_List_Hi_Mapping_ITimeShot___Hi_MachiningProcs_SessionMessageHost_System_Nullable_System_Threading_CancellationToken__
+  commentId: M:Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.String,Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate,System.Collections.Generic.IDictionary{System.Int32,System.Collections.Generic.List{Hi.Mapping.ITimeShot}},Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})
+  name.vb: GetStepToShotsDictionaryByActualTime(ClStrip, CycleSamplingMode, String, GetTimeShotByFileDelegate, IDictionary(Of Integer, List(Of ITimeShot)), SessionMessageHost, CancellationToken?)
+  fullName: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, string, Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate, System.Collections.Generic.IDictionary<int, System.Collections.Generic.List<Hi.Mapping.ITimeShot>>, Hi.MachiningProcs.SessionMessageHost, System.Threading.CancellationToken?)
+  fullName.vb: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(Hi.CutterLocations.ClStrips.ClStrip, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, String, Hi.Mapping.StepTimeShotUtil.GetTimeShotByFileDelegate, System.Collections.Generic.IDictionary(Of Integer, System.Collections.Generic.List(Of Hi.Mapping.ITimeShot)), Hi.MachiningProcs.SessionMessageHost, System.Threading.CancellationToken?)
+  nameWithType: StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(ClStrip, StepTimeShotUtil.CycleSamplingMode, string, StepTimeShotUtil.GetTimeShotByFileDelegate, IDictionary<int, List<ITimeShot>>, SessionMessageHost, CancellationToken?)
+  nameWithType.vb: StepTimeShotUtil.GetStepToShotsDictionaryByActualTime(ClStrip, StepTimeShotUtil.CycleSamplingMode, String, StepTimeShotUtil.GetTimeShotByFileDelegate, IDictionary(Of Integer, List(Of ITimeShot)), SessionMessageHost, CancellationToken?)
 - uid: Hi.Mapping.StepTimeShotUtil.GetStepToShotsDictionaryByActualTime*
   name: GetStepToShotsDictionaryByActualTime
   href: api/Hi.Mapping.StepTimeShotUtil.html#Hi_Mapping_StepTimeShotUtil_GetStepToShotsDictionaryByActualTime_
@@ -86229,15 +86245,15 @@ references:
   isSpec: "True"
   fullName: Hi.Mapping.TimeMapping.Map
   nameWithType: TimeMapping.Map
-- uid: Hi.Mapping.TimeMapping.MapByActualTime(Hi.Common.Range{System.Int32},System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.Nullable{System.Threading.CancellationToken})
-  name: MapByActualTime(Range<int>, string, CycleSamplingMode, CancellationToken?)
-  href: api/Hi.Mapping.TimeMapping.html#Hi_Mapping_TimeMapping_MapByActualTime_Hi_Common_Range_System_Int32__System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_System_Nullable_System_Threading_CancellationToken__
-  commentId: M:Hi.Mapping.TimeMapping.MapByActualTime(Hi.Common.Range{System.Int32},System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,System.Nullable{System.Threading.CancellationToken})
-  name.vb: MapByActualTime(Range(Of Integer), String, CycleSamplingMode, CancellationToken?)
-  fullName: Hi.Mapping.TimeMapping.MapByActualTime(Hi.Common.Range<int>, string, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, System.Threading.CancellationToken?)
-  fullName.vb: Hi.Mapping.TimeMapping.MapByActualTime(Hi.Common.Range(Of Integer), String, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, System.Threading.CancellationToken?)
-  nameWithType: TimeMapping.MapByActualTime(Range<int>, string, StepTimeShotUtil.CycleSamplingMode, CancellationToken?)
-  nameWithType.vb: TimeMapping.MapByActualTime(Range(Of Integer), String, StepTimeShotUtil.CycleSamplingMode, CancellationToken?)
+- uid: Hi.Mapping.TimeMapping.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})
+  name: MapByActualTime(string, CycleSamplingMode, SessionMessageHost, CancellationToken?)
+  href: api/Hi.Mapping.TimeMapping.html#Hi_Mapping_TimeMapping_MapByActualTime_System_String_Hi_Mapping_StepTimeShotUtil_CycleSamplingMode_Hi_MachiningProcs_SessionMessageHost_System_Nullable_System_Threading_CancellationToken__
+  commentId: M:Hi.Mapping.TimeMapping.MapByActualTime(System.String,Hi.Mapping.StepTimeShotUtil.CycleSamplingMode,Hi.MachiningProcs.SessionMessageHost,System.Nullable{System.Threading.CancellationToken})
+  name.vb: MapByActualTime(String, CycleSamplingMode, SessionMessageHost, CancellationToken?)
+  fullName: Hi.Mapping.TimeMapping.MapByActualTime(string, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, Hi.MachiningProcs.SessionMessageHost, System.Threading.CancellationToken?)
+  fullName.vb: Hi.Mapping.TimeMapping.MapByActualTime(String, Hi.Mapping.StepTimeShotUtil.CycleSamplingMode, Hi.MachiningProcs.SessionMessageHost, System.Threading.CancellationToken?)
+  nameWithType: TimeMapping.MapByActualTime(string, StepTimeShotUtil.CycleSamplingMode, SessionMessageHost, CancellationToken?)
+  nameWithType.vb: TimeMapping.MapByActualTime(String, StepTimeShotUtil.CycleSamplingMode, SessionMessageHost, CancellationToken?)
 - uid: Hi.Mapping.TimeMapping.MapByActualTime*
   name: MapByActualTime
   href: api/Hi.Mapping.TimeMapping.html#Hi_Mapping_TimeMapping_MapByActualTime_
diff --git a/App/zh-Hans/HiMech.resources.dll b/App/zh-Hans/HiMech.resources.dll
index 0226408..de75728 100644
Binary files a/App/zh-Hans/HiMech.resources.dll and b/App/zh-Hans/HiMech.resources.dll differ
diff --git a/App/zh-Hans/HiNc.resources.dll b/App/zh-Hans/HiNc.resources.dll
index 8a4508f..4f6504f 100644
Binary files a/App/zh-Hans/HiNc.resources.dll and b/App/zh-Hans/HiNc.resources.dll differ
diff --git a/App/zh-Hant/HiGeom.resources.dll b/App/zh-Hant/HiGeom.resources.dll
index e916c4d..efb1866 100644
Binary files a/App/zh-Hant/HiGeom.resources.dll and b/App/zh-Hant/HiGeom.resources.dll differ
diff --git a/App/zh-Hant/HiMech.resources.dll b/App/zh-Hant/HiMech.resources.dll
index 333aa87..868aaf8 100644
Binary files a/App/zh-Hant/HiMech.resources.dll and b/App/zh-Hant/HiMech.resources.dll differ
diff --git a/App/zh-Hant/HiNc.resources.dll b/App/zh-Hant/HiNc.resources.dll
index c11aa3f..c262e13 100644
Binary files a/App/zh-Hant/HiNc.resources.dll and b/App/zh-Hant/HiNc.resources.dll differ