工作流程:感測器資料映射¶
本工作流程說明如何將外部感測器資料(動力計、智慧刀把、加速規)映射至仿真刀具路徑,使仿真步能索引到實際量測資料。
flowchart TD
Prepare["準備感測器 CSV 資料"]
Configure["設定時間映射"]
Simulate["執行仿真"]
Map["將資料映射至仿真步"]
View["檢視映射結果"]
Synth["沒有控制器日誌?<br>由仿真時間軸<br>合成控制器表"]
Prepare --> Configure --> Simulate --> Map --> View
Simulate -.-> Synth -.-> Map
概覽¶
資料映射將外部感測器量測與仿真加工步建立關聯。映射後,每個步皆可參照真實的力、力矩、加速度資料,用於:
- 檢視加工狀態
- 訓練銑削係數(見 銑削力參數訓練)
- 校正銑削係數
- 比較仿真與量測力
依資料量與用途,映射可分為 一對一(每步映射至一筆資料)或 一對多(每步映射至多筆來自高取樣率感測器的資料)。
映射本身只是幾個 SessionShell 呼叫。在網頁應用程式中,兩個檔案映射各自是一種任務命令,其餘的呼叫放進「腳本」命令——見從網頁應用程式進行感測器資料映射;控制器沒有寫下日誌時,由仿真自己的時間軸代替它——見沒有控制器日誌時的感測器資料映射。欄位帶著廠商自己標題的檔案,照原樣就能映射,只要在命令上指名那些標題;只有單位與讀取器不同時,才需要轉換出一份副本——見廠商提供的檔案。
1. 準備感測器 CSV 資料¶
感測器資料格式¶
感測器檔是序列映射器讀取的檔案——策略 C、策略 D,以及兩層串聯的第二層都讀它。它需要一行標頭,包含一個時間欄位與它所帶的通道:
| 通道 | 接受的標頭 | 單位 |
|---|---|---|
| 時間 | ActualTime、ActualDateTime、TimeTag 或 Time——依上列順序,檔案裡有的第一個就是被讀取的那一個 |
見下文 |
| 力(動力計) | Fx、Fy、Fz,或 Workpiece.Fx、Workpiece.Fy、Workpiece.Fz |
N |
| 力矩(智慧刀把) | Mx、My、Mz,或 Holder.Mx、Holder.My、Holder.Mz |
N·m |
| 加速度 | Ax、Ay、Az |
g——以 g 為單位讀取;產品中沒有任何步屬性或圖表使用這個通道 |
時間儲存格有三種形式。單純的數字是秒。<時>:<分>:<秒>.<小數秒> 是時間碼——記錄器以這種方式寫出它的時鐘時,就是一天中的時刻。帶有日期的儲存格是絕對時刻,透過專案的映射錨點重新基準化:錨點只設定一次,設為專案中任何一次轉換所遇到的第一個絕對時刻當天的 00:00,因此同一天的錄製資料也會變成一天中的時刻。錨點隨專案儲存,而且不會被 ClearTimeMappingData() 清除;在某一天設定了錨點、現在要映射另一天錄製資料的專案,需要在執行前於腳本中寫 MappingAnchorDateTime = null;,或指定一個明確的值。
不論機器的語言設定為何,數字一律以句點作為小數點讀取——與產品寫出數字的方式相同;匯出 11,5 這種寫法的記錄器,檔案需要先轉換。
檔案沒有帶的通道讀成 NaN。其他任何欄位都會被這個讀取器忽略——它只保留時間、力、力矩與加速度,其餘一概不留。要以自訂欄位送到步上的欄位,應放在下方的控制器檔(其額外欄位會嵌入步中),或放在直接播放的 CSV 裡(策略 B)。
控制器資料格式(兩層映射)¶
控制器 CSV 須含 FileNo、LineNo,以及三個時間欄位其中之一:
FileNo,LineNo,ActualTimecode,ActualDateTime,MC.X,MC.Y,MC.Z,...
1,6,00:00:00.030,2026-03-16 15:57:45.559000,0,0,0.37,...
| 時間欄位 | 內容 |
|---|---|
ActualTimecode |
由 WriteStepFiles (API) 寫出、相對於本次運行的時間碼。ActualDateTime(控制器的絕對時刻)伴隨其旁,為選用。 |
ActualTime |
舊有的單一欄位,目前仍會讀取。若儲存格是單純的時間碼,即直接採用;若是絕對日期時間,則透過映射錨點的轉換器重新基準化。 |
EndTimecode |
仿真的結束時間碼,在上述兩者都無法解析時作為後備。該次更名之前寫出的檔案帶的是 AccumulatedTime,同樣被接受。 |
標頭列若三者皆無,會被指名拒絕,而不是映射成空無一物。本產品匯出的檔案帶的是前面那一對,而非舊有的單一欄位 —— 這也是為什麼步檔案不必編輯標頭就能回放並映射。
FileNo 與 LineNo 都從 1 起算。FileNo 依播放進入檔案的順序編號:主程式是 1,它呼叫的第一個副程式是 2,而每一次呼叫都自成一個檔案——被呼叫兩次的副程式,第二次呼叫時會取得新的編號。計數器在每次重置時重新起算,所以每次執行的編號都相同。LineNo 是該檔案內的行號。
多列可以帶相同的 (FileNo, LineNo)。此時該行各步的時間,由第一列的時間線性插值到最後一列的時間,頭尾兩步保留列本身的時間;一行只有一列時,該行的每一步都標上那一個時間。其他每個欄位——機械座標 MC.X … MC.C 除外——都會成為步變數:它的值嵌入該行的每一步、以同樣方式插值,並以欄位標題註冊(無單位、格式 G4),所以映射一完成,圖表、刀具路徑著色與「步屬性」就能選它。映射之前已用 RegisterStepVariable (API) 以自己的名稱、單位與格式註冊過的欄位,保留那份註冊。與內建步屬性同名的欄位(Feedrate_mmdmin、ToolId …),以及在保留的 MC. 前綴下的欄位(MC.C 以外的軸),不會映射:步保留自己的值,映射會在一則工作階段訊息中列出這些欄位;要映射它,請在 CSV 表頭改掉欄名。本產品寫出的步檔案帶的內建屬性都是模擬值,所以把它映射回來,只會加上其餘的欄位。
欄位標題可以設定¶
上面兩張表中的標頭是預設值,不是對檔案的要求。每個映射呼叫都接受一份設定,指名檔案自己的標題,讀取器查找的每個欄位各一個——控制器檔用 MapSingleCsvConfig (API),感測器檔用 MapSeriesCsvConfig (API):
MapSingleByCsvFile("Mapping/controller.csv", new MapSingleCsvConfig {
FileNoTag = "ProgramNo", LineNoTag = "BlockNo", ActualTimeTag = "Timestamp" });
MapSeriesByCsvFile("Mapping/sensor.csv",
new MapSeriesCsvConfig { TimeTag = "Clock", MzTag = "Tq" });
只有不同的欄位需要指名;沒動的標籤保留預設值,清空的標籤也會回到預設值。
| 檔案 | 標籤 | 預設標題 |
|---|---|---|
| 控制器 | FileNoTag、LineNoTag |
FileNo、LineNo |
| 控制器 | ActualTimecodeTag、ActualDateTimeTag |
ActualTimecode、ActualDateTime |
| 控制器 | ActualTimeTag |
ActualTime |
| 控制器 | SimTimeTag |
EndTimecode——只有在這個標籤保持此預設值時,才會一併接受 AccumulatedTime |
| 控制器 | MachineCoordinatePrefix |
MC.——機械座標欄位是這個前綴加上 X、Y、Z、A、B、C |
| 感測器 | TimeTag |
ActualTime,其次 ActualDateTime、TimeTag、Time |
| 感測器 | FxTag、FyTag、FzTag |
Fx … 或 Workpiece.Fx … |
| 感測器 | MxTag、MyTag、MzTag |
Mx … 或 Holder.Mx … |
| 感測器 | AxTag、AyTag、AzTag |
Ax、Ay、Az |
兩種檔案有兩條規則不同。在控制器檔中,標籤單純取代標題,三個時間來源保持原本的順序——只有一個時間欄位的日誌,就把它指名在 ActualTimeTag 來映射,其儲存格可以是時間碼,也可以是帶日期的時刻。在感測器檔中,保持預設值的標籤保留上表該列接受的每一個標頭,該通道也仍是選用的;改過的標籤則會被精確查找,檔案必須帶有它:標頭列裡沒有它,就會被拒絕並指出該標題,因此打錯的標題不會被當成錄製資料其實沒有的通道。
設定中指名的控制器欄位會被取用;其他每個欄位仍以自己的標題嵌入步中——與內建步屬性同名的欄位除外,見上文——所以改標籤永遠不會改掉自訂欄位的名稱。
2. 設定時間映射¶
策略 A:一對一映射(MapSingleByCsvFile)¶
MapSingleByCsvFile 讀取上述控制器格式的檔案,並使用時間插值將每一列資料映射至一個仿真步。
策略 B:以 PlayCsvFile 一對一映射¶
PlayCsvFile 可直接由 CSV 驅動仿真,每一列成為一個步。播放不當作指令讀取的每個欄位都會帶到該列的步上,並註冊成步變數,圖表就能選它;與內建步屬性同名、或在保留的 MC. 前綴下的欄位不帶,播放會在工作階段訊息中列出這些欄位一次。
策略 C:一對多全域映射(MapSeriesByCsvFile)¶
對高取樣率資料,先以一對一映射建立 ActualTime,再映射時間序列:
PlayNcFile("NC/file1.nc");
MapSingleByCsvFile("Data/controller.csv"); // 建立 ActualTime
MapSeriesByCsvFile("Data/sensor.csv"); // 映射高取樣率資料
策略 D:一對多局部映射(以錨點為基準)¶
用於把錄製資料映射至 NC 路徑的特定段落,段落的兩端以錨點定在程式本身之中。
步驟 1 — 為錄製資料的時間窗命名。 每個鍵把一個檔案與它的一段時間窗配成一對;這段時間窗會被線性地拉伸到錨點所選取的步上,§4 的提示所描述的漂移就是這樣修正的。
ClearTimeMappingData();
AddTimeDataByFile("lineA", "Mapping/sensor1.csv", "18:25:51.7100", "18:26:12.9910");
AddTimeDataByFile("lineB", "Mapping/sensor1.csv", "18:26:30.5750", "18:27:12.2880");
時間窗的兩端可以是秒、時間碼或帶日期的時刻。表中已有的鍵不會被取代——該呼叫會傳回 false。
步驟 2 — 在 NC 程式中以錨點定出段落。 錨點是寫在程式自己註解裡的 C# 呼叫。執行器的註解語法先把註解從單節取出——Fanuc 家族控制器(Fanuc、Mazak、Syntec)用括號,Siemens 用 ; 到行尾,Heidenhain 用 //、; 或括號——接著腳本語法用兩個標記把腳本從註解文字取出:@@ 是在該單節運動之前執行的腳本,@@^ 是在之後執行的。這兩個標記是該語法的設定,而不是固定字元——見 NC 碼中的腳本命令。
G01 X13. F20 (@@LineSelection("lineA", FirstTouch, ShiftTime_s(2), LineEnd, ShiftDistance_mm(-1));)
G01 X25. F10 (@@LineSelection("lineB", FirstTouch, null, LastTouch, null);)
段落跨越多行時,以 BeginSelection 在第一行的運動之前開啟它,以 EndSelection 在最後一行的運動之後關閉它:
G01 Z-0.2 F1500 (@@BeginSelection("region1", FirstTouch, null);)
...
G01 X10. Y10. (@@^EndSelection("region1", LineEnd, null);)
括號註解從該行第一個 ( 延伸到最後一個 ),所以呼叫裡的括號不成問題——但要讓錨點成為該行唯一的括號文字,因為同一行的第二則註解會被吞進腳本裡。在 Siemens 上,同一個錨點寫在 ; 之後:
呼叫裡的名稱——FirstTouch、LineEnd、ShiftTime_s、null——都是 SessionShell 的。內嵌腳本與腳本命令編譯時用同一組參考與命名空間引用 (using),所以腳本命令能呼叫的,錨點也都能呼叫。有五條規則決定錨點是否真的做了它看起來在做的事:
FirstTouch從開始錨點起順向搜尋。 首次接觸的搜尋從錨點所在那一行開始的步起,順著程式往下找到結束錨點,所以開始錨點可以放在段落的第一條進給行上,而不必放在真正碰到胚料的那一行。LastTouch則以同樣方式從結束錨點起逆向往回找。搜尋找不到任何接觸步的段落什麼也不映射,而且沒有任何訊息說明。- 一個鍵在重置之前只開啟、關閉一次,而且只在同一支程式之內。 對已經關閉的鍵再下一次
EndSelection,或對應的BeginSelection從未執行過的EndSelection,會在該行結束時丟出例外;本次執行會在那一行回報Line-End--Exception,該段落不會被映射。會把同一段落播放兩次的程式需要兩個鍵。還沒有被結束錨點關閉的開始錨點,會在工作階段開始播放下一支程式時被丟棄——任務的下一個「程式檔案」,或腳本命令的下一個PlayNcFile——所以一個鍵的兩個錨點要放在同一支程式與它呼叫的副程式裡。 - 重置會清除錨點,停止則不會。 持有這些選取範圍的宿主會在工作階段重置時被清空,每一步的映射樣本也一起清空;步驟 1 的鍵 → 時間窗對照表與映射錨點日期則不會,這就是為什麼腳本以
ClearTimeMappingData()開頭。「停止」之後不按「重置」就再按「開始」時,任務會在同一個工作階段上再播一次:被停下的那次執行已經關閉的鍵,保留那次執行選取的段落,重播到它的EndSelection時回報Line-End--Exception;被停下的那次執行還開著的鍵——它停在這個鍵的兩個錨點之間——會在重播開始時被丟棄,於是由重播自己的BeginSelection與EndSelection配成一對。要把程式再映射一次,先按「重置」再按「開始」。 - 錨點本身不需要任何授權功能——但 3.2.7 到 3.2.31 的套件只在有
NcComposition時才執行它們:沒有這個授權功能時,第一個內嵌腳本會回報一次Script--NotLicensed,其後的每一個都被靜默跳過,於是錨點什麼也沒選取,什麼也沒映射。之後的套件無條件執行它們,一如 3.1。 - 編譯不過的錨點會在它所屬的步回報
Script-Compile--Error;任務的編譯檢查只涵蓋腳本命令,不涵蓋程式中的註解。
錨點旗標:
| 旗標 | 說明 |
|---|---|
LineBegin |
該行的運動起始點 |
LineEnd |
該行的運動結束點 |
FirstTouch |
第一個接觸工件的點 |
LastTouch |
最後一個接觸工件的點 |
偏移選項:
| 偏移 | 說明 |
|---|---|
null |
無偏移 |
ShiftTime_s(<秒>) |
時間偏移(正值為順向,往較晚的時刻) |
ShiftDistance_mm(<毫米>) |
距離偏移(正值為順向,沿路徑前進) |
Warning
;@… 是前一代執行器的標記。在 Siemens 上,或在 Fanuc 家族控制器的括號內,帶著它的註解只是普通註解,錨點什麼也不做;在 Fanuc 家族控制器上裸寫時,它是殘留文字,建置另外會發出 UnparsedText--Remaining 警告。不論哪一種,建置都會對每個 NC 檔發出一次 CsScript-Marker--Legacy 警告,指出檔名與第一個 ;@ 後面接著呼叫或指派的行。請在控制器的註解內把標記改寫成 @@:Fanuc 家族控制器與 Heidenhain 寫成 (@@…),Siemens 寫成 ;@@…。
有兩種回報表示所用的建置早於錨點能在 SoftNc 執行器上運作之時。帶錨點的步回報 Script-Run--Exception("BeginSelection has to be used in Command Source File"),是執行器還沒有發布選取呼叫所依賴的行邊界:錨點已被解析並執行,卻什麼也沒映射。帶錨點的行回報 Syntax-Build--Exception、而執行變成一連串快移,則是更舊的版本:帶標記的單節失去了運動字語,被當成先前模態的快移播放。在這兩種建置上,都改用兩層串聯來映射——真實的控制器日誌,或合成的控制器表(見沒有控制器日誌時的感測器資料映射)。
選取結束時自動映射¶
EnableMapOnSelectionEnd 控制選取結束時是否自動映射(預設:true):
清除映射資料¶
策略 D 的鍵 → 時間窗對照表與映射錨點隨專案儲存,重置後仍然保留;每一步的映射樣本與程式中的錨點則不會——下一次執行會重建它們。加入之前先清除對照表,重新執行時才不會發現自己的鍵已經被佔用:
錨點日期不在它清除的範圍內——見感測器資料格式。
3. 執行仿真¶
為何要解譯 NC 而非直接播放 CSV?
系統 NC 解譯器產生的仿真路徑比直接控制器 CSV 回放更準確;後者取樣解析度有限,會扭曲刀具路徑。
4. 映射資料¶
仿真後,套用步驟 2 選定的映射策略。兩層串聯方式:
// 第一層:控制器資料 → 仿真步(透過 FileNo/LineNo → ActualTime)
MapSingleByCsvFile("Data/controller.csv");
// 第二層:感測器資料 → 仿真步(透過 ActualTime → 感測器讀值)
MapSeriesByCsvFile("Data/sensor.csv");
串聯之所以可行:
- 仿真步與控制器資料共享
FileNo/LineNo錨點 - 控制器資料與感測器資料共享
ActualTime錨點 - 串聯後,仿真步即可索引感測器資料
第二個呼叫逐一走過第一個呼叫標上時間的步,把每一步與它結束之後一個週期內的樣本配對——預設的 SpindleCycle 取樣模式下是主軸轉一圈,FluteCycle 下是一個刀刃的弧段。時間窗內沒有任何樣本的步——在錄製範圍之外,或落在資料中斷處——保持未映射,並計入只發出一次的 Map-ShotGap--StepsSkipped 警告。
Tip
由於工具機加減速行為,仿真時間與實際時間在較長時段會發散。以錨點為基準的線性投影可修正此漂移。
5. 檢視映射結果¶
映射後,每一步都帶著它的樣本。在網頁應用程式中,它們出現在三個地方——所選步的感測器週期圖、由樣本推導的步屬性,以及本次執行的訊息——詳見結果出現在哪裡;映射得到的步屬性若是「視覺指標時序圖」所檢視的鍵,也會在 3D 場景中為工件著色。
從腳本匯出映射結果:
完整兩層映射範例¶
// 配置解析度
MachiningResolution_mm = 0.125;
EnablePhysics = true;
// 清除既有映射資料
ClearTimeMappingData();
// 用 NC 解譯器產生準確路徑的仿真
PlayNcFile("NC/machining.nc");
// 映射控制器資料(含 FileNo、LineNo、ActualTime)
MapSingleByCsvFile("Data/controller.csv");
// 映射高取樣率感測器資料(含 ActualTime 與力/力矩)
MapSeriesByCsvFile("Data/sensor.csv");
// 匯出結果
WriteStepFiles("Output/[NcName].step.csv");
從網頁應用程式¶
在網頁應用程式中,兩個檔案映射是任務命令「CSV 一對一映射」(Map Single By CSV File)與 「CSV 一對多映射」(Map Series By CSV File),放在「程式檔案」之後、同一個「清單」裡,上面其他的呼叫則放進「腳本」命令。映射樣本接著出現在所選步的感測器週期圖、由樣本推導的步屬性,以及本次執行的訊息中。從網頁應用程式進行感測器資料映射說明任務的形狀、建構它的 HTTP 路由,以及每一項結果出現在哪裡。
沒有控制器日誌時¶
控制器沒有寫下日誌時,由仿真自己的時間軸代替串聯的第一層:步檔案或一個透過 HTTP 的時序圖請求給每一步它的 FileNo、LineNo 與仿真的結束時間,而兩個時鐘之間的偏移量——加到這張表上,或設為映射錨點、改為平移錄製資料——讓各步與錄製資料對齊。偏移量是以一條仿真序列與量測序列的互相關找出來的,而不是只看一個峰值;延遲沿著記錄逐漸增大時,要為記錄的每一段各用一個偏移量、各自寫進表上該段的列,或改用真實的日誌。沒有控制器日誌時的感測器資料映射說明這些步驟、它們的條件,以及在信任檔案之前要問廠商什麼。
廠商提供的檔案¶
感測器檔很少帶著 §1 的標頭送來,而它也不必如此:映射命令(或呼叫的設定,見 §1 欄位標題可以設定)會指名廠商自己的標題,所以檔案照原樣就能映射。真正要做的,是判斷廠商的哪些欄位可以名副其實地指名為讀取器所賦予的通道。
- 時間。 把廠商的時間欄位指名為「時間欄位」(
TimeTag);其儲存格可以是秒、hh:mm:ss.fff或帶日期的時刻,如 §1 所述。保留廠商記錄時所用的時鐘——偏移量由控制器表吸收。 - 扭矩。 繞刀軸的軸向扭矩是「繞 Z 軸力矩欄位」(
MzTag),單位 N·m。它就是扭矩步屬性拿來比較的通道。 - 彎矩。 「繞 X 軸力矩欄位」/「繞 Y 軸力矩欄位」是以觀測點為參考的彎矩,單位 N·m。只有在廠商說明了它們的單位與所參照的點時,才把廠商的彎矩通道指名到這裡:參考高度未知的彎矩,是一個沒有任何東西會回報的倍率誤差,而原始應變讀數也不是力矩。否則就讓這兩個標籤保持預設值——檔案沒帶的通道讀成 NaN,扭矩照樣會映射。
HiNC 的 Mx 是繞 X 軸的彎矩(見智慧刀把頁的〈Mx、My 與 Mz 的意義〉);廠商所謂的「bending X」可能是朝 X 彎、也就是繞 Y 軸的彎矩——先用推刀檢查確定,再在這裡指名欄位。只有「CSV 一對多映射」(
MapSeriesByCsvFile)會讀這些標籤;AddTimeDataByFile與線上安裝角估計讀的是內建名稱(Mx、Holder.Mx、Spindle.Mx與Time),所以照這些標頭轉換出來的副本,在每一條路徑上都能用。 - 其他所有欄位——樣本計數器、狀態旗標、廠商自己計算的欄位——不論叫什麼名字,都會被這個讀取器捨棄。
- 單位不是標題。 指名一個欄位並不會轉換它:以 N·mm 為單位的扭矩,或以 kN 為單位的力,仍然必須在檔案的轉換副本中重新縮放。把廠商的原始檔保留在它旁邊。
- 從報告推得的增益是最後手段。 檔案帶的是原始計數,而手邊唯一的校正是一份報告中的極值(「峰值扭矩 12 N·m」)時,用報告的極值除以原始資料的極值,會得到一個只能重現那一個數字的增益。只有在廠商無法提供校正時才使用它,並把它當作一項假設記在專案的 README 中,連同它所依據的報告與原始極值,以便校正資料送到時換掉它(專案建構 §7)。
一份四列的廠商檔——Time 以秒為單位,兩個未說明參考點的彎矩通道,一個以 N·m 為單位的扭矩:
Time,BendX,BendY,Tq
0.000,-0.031,0.108,0.412
0.001,0.044,-0.045,0.398
0.002,0.012,0.061,0.421
0.003,-0.027,0.019,0.405
只要指名一個標題就能照原樣映射——Time 本來就是接受的時間標頭,而彎矩通道在參考點確知之前保持不指名:
在「CSV 一對多映射」命令上,就是把「繞 Z 軸力矩欄位」設為 Tq。
延伸閱讀¶
- 銑削力參數訓練 — 使用映射資料訓練係數
- 基礎仿真 — 基礎仿真設置
- 從網頁應用程式進行感測器資料映射 — 任務中的映射命令、透過 HTTP 建構它的路由,以及映射後的資料顯示在哪裡
- 沒有控制器日誌時的感測器資料映射 — 以仿真時間軸作為控制器表,以及用相關性找出它的偏移量
- 專案建構 — 記錄假設
- 其他命令 — 兩個映射命令,以及其餘呼叫所放進的「腳本」命令
- 觀看執行:時序圖 — 沿著執行畫出映射步屬性的視覺指標時序圖
- 智慧刀把 — 彎矩通道所參照的觀測點
- NC 碼中的腳本命令 — 撰寫錨點所用的
@@/@@^標記 - 步 (Step) — 步的資料模型
- SessionShell — SessionShell 快速參考
- 串聯映射範例 — 映射示範範例專案
- 動力計訓練範例 — 動力計訓練範例專案