步 (Step)¶
什麼是步?¶
MachiningStep(Hi.MachiningSteps.MachiningStep (API))是 HiNC 仿真中的單一計算單位。預設情況下,一個步對應一個主軸轉,但此間隔可透過 基礎仿真 工作流程設定。
每個步包含兩個連續步間(從前一步到當前步)的 時間區間 資料。由於這代表時段而非瞬時,許多欄位用前綴表示簡化形式:平均(Avg)、極值(Min、Max)、區間(Delta)、絕對值最大(MaxAbs)。
註冊自訂步變數¶
專案可以在執行頁面定義自己的步變數,每個都是一條對步的公式——見步變數——每次播放都讀得到。腳本則為它所在的工作階段註冊變數,並寫入用公式算會很慢的值,例如這一步之前所有步的總和:公式得在每一步重讀之前所有的步。
除了預設屬性外,可使用 RegisterStepVariable (API) 註冊自訂步變數:
RegisterStepVariable(
"ChipVolume", // key
"Chip Volume", // display name
"mm3", // unit
"F2", // format string
(step) => step.ChipVolume_mm3 // value function
);
PlayNcFile("NC/file1.nc");
參數:
- key:唯一識別碼
- name:顯示名稱(UI 中可見)
- unit:物理單位(可為 null),一個
PhysicsUnit的名稱,例如mm3。ratio是相對於一個極限或一個整體的比值,100% 就是 1(函式對 82% 傳回 0.82);percent是本身已是百分比的值(它傳回 82):不論格式字串為何,「步屬性」與圖表都把這兩種值印成小數兩位的百分比,82.00%(比值先乘以 100),不到 0.01% 的印成<0.01%;步檔案保存的是函式傳回的值本身 - formatString:.NET 數值格式字串(可為 null)
- variableFunction:由步計算值的 lambda(可為 null)
變數在每次被讀取時才由步計算——不論是圖表、刀具路徑著色、「步屬性」或步檔案——而且不會存在步上。以同一個鍵寫在步上的值(見索引器存取)優先於函式。任何數值都讀成數值(int、float、decimal 之類;bool 讀成 1 或 0);其他型別,或函式在某一步拋出例外,該步就讀不到值,每個變數在本工作階段第一次拋出的例外會出現在工作階段訊息中。
同一個鍵再註冊一次,會以新的定義取代。與內建步屬性同名的鍵(Feedrate_mmdmin …)或與 HiNC 的內建著色樹同名的鍵(MachiningState、MachiningStateGeometry;工程面向著色)、在保留的 MC. 前綴下的鍵,或專案已用來定義步變數或著色樹的鍵(步變數,不論它的公式編不編得過;著色樹(英文,未鏡像),不論那棵樹註冊與否)不會註冊;單位清單沒有列的單位,顯示時不帶單位;這些情形各在工作階段訊息中提示一次。專案定義那個鍵之前就註冊的變數會先擱著,專案的變數或樹刪除或改名後再回來。註冊只在本工作階段有效:「重置」之後的工作階段一開始沒有這些變數,所以要在任務的腳本裡、播放之前註冊。
註冊後的變數會出現在 UI——在「步顯示偏好設定」對話框的 Custom 之下,讓「步屬性」可以列出它們,也在「視覺指標時序圖」的屬性選單中,而這張圖顯示的屬性也是刀具路徑的上色依據——以及 WriteStepFiles (API) 的輸出檔中。
索引器存取¶
使用 MachiningStep (API) 的索引器可在步上讀寫自訂資料:
SessionStepBuilt += (preStep, curStep) => {
if (curStep != null)
curStep["MyCustomField"] = someCalculation();
};
索引器只讀得到寫在步上的值。以函式註冊的變數,是在圖表、「步屬性」或步檔案讀取時才計算,所以對這種變數用 step["key"] 會讀到 null。寫上去的值是一個數值或一個字串。任何數值不論當初以什麼型別寫入,讀回來都是 double(int、float、decimal 之類;bool 讀成 1 或 0;NaN 讀回仍是 NaN),字串則讀回字串本身,所以不論腳本以哪種數值型別寫入,專案的公式都用 step["key"] as double? 讀取寫在步上的數值。寫入 null 會把這個鍵從步上拿掉。其他型別的值不會儲存,工作階段訊息會為每個鍵提示一次。
寫上去的值存在這次執行的步驟快取 (step cache) 裡——也就是執行把步結果寫進去的那個資料庫檔——每一步、每個鍵各一筆資料列,而不是記憶體中步的一個欄位。它在本工作階段內一直保留,每當這一步被讀取時就讀回來:不論是圖表、刀具路徑著色、「步屬性」、步檔案,或任務裡後面某個命令中的 step["key"]。重新計算步驟物理量時,寫上去的值保持寫入時的樣子,並在一則工作階段訊息中點名它們的鍵:由播放時的物理量導出的值不會被重算。
一次寫入的代價取決於它發生的時機。在 SessionStepBuilt 的處理器裡寫入不多花任何代價:值隨著這一步自己的資料列、在同一個交易 (transaction) 裡寫出;而 preStep["key"]——讀處理器剛才寫在前一步上的鍵——讀的是記憶體,不是檔案。播放之後,每一次 step["key"] = value 都是對步驟快取的一次寫入——一筆資料列、一個交易——而且每次寫入都會把這個鍵的圖表與著色標成過時。事後要填很多步的腳本,例如在對 GetMachiningStep(i) 的迴圈裡,應該把要寫的值收集成 StepVariableWrite (API) 記錄(步索引、鍵、值),再以一次呼叫交給 WriteStepVariables (API):每 4,096 筆寫入一個交易,圖表與著色每批只標成過時一次,而不是每筆寫入一次。ReadStepVariables (API) 以一次讀取把一個鍵在一段步範圍內的值讀回來——從起始索引起,到結束索引之前、不含結束索引——結果是一個從步索引到值的字典;沒有值的步沒有項目。播放之後單獨讀一次 step["key"] 是讀一筆資料列;從來沒有寫過任何值的鍵則完全不讀。
// After the play: collect the writes, then hand them over in one call
// (one transaction per 4,096 writes) instead of writing step["key"] step by step.
var writes = new List<StepVariableWrite>();
for (int i = 0; i < StepCount; i++)
{
var step = GetMachiningStep(i);
if (step != null)
writes.Add(new StepVariableWrite(i, "MyCustomField", someCalculation(step)));
}
WriteStepVariables(writes);
// Read the key back over a range: step index -> value (a double or a string)
var values = ReadStepVariables("MyCustomField", 0, StepCount);
讀一步物理量的代價,同樣取決於它發生的時機。在 SessionStepBuilt 的處理器裡,curStep 的物理量讀的是記憶體,不是檔案:剛建好的這一步還帶著它的結果。播放之後,一步的物理量——ChipThickness_mm、ChipVolume_mm3、StressRatio、MaxSpindleTorqueRatio、MaxSpindlePowerRatio、ThermalStressRatio,以及溫度、磨耗等其他由這一步兩份物理摘要承載的屬性(逐轉的力陣列由 TryGetMillingForceLuggage 另外讀取)——讀的是步驟快取裡這一步的結果資料列。BreakageProbability_percent 在讀取時由應力比與刀具當下的材料算出:這次播放出來的步,它讀的是播放時留在記憶體裡的應力比,不讀資料列;只有其他的步(例如正在回顧的錄下播放)才讀資料列。以 GetMachiningStep(i) 取得的步,第一次讀它的某個物理量時,會把它前後幾百步的結果資料列一次讀進來,執行緒會留著這些資料列,直到步驟快取再被寫入為止,所以這一步其他的物理量,以及接著讀的前後各步,都不必再讀檔:對每一步的迴圈,不論每步讀幾個物理量,每步只花幾微秒。要一次取得每一步的物理量,就用 WriteStepFiles (API) 把步匯出(見步輸出檔):它一次讀一段步的資料列。
註冊著色樹¶
RegisterStepColorTree (API) 為本工作階段註冊一棵著色樹:一個類別型的步屬性,它在一步上的值,是那一步落進的葉的編號,每片葉一個顏色。樹怎麼把各步分到各片葉、葉怎麼著色,見著色樹(英文,未鏡像)。在「視覺指標時序圖」選擇它之後,刀具路徑與切削面就依葉著色。
RegisterStepColorTree(new StepColorTree
{
Key = "Load",
Nodes =
[
new StepColorLeaf
{
Name = "Rapid",
When = StepColorCondition.All(new StepColorTerm("IsRapid", StepColorOp.Eq, 1))
},
new StepColorLeaf { Name = "Cutting" } // no When: every step that reaches it
]
});
PlayNcFile("NC/file1.nc");
鍵的規則和上面的 RegisterStepVariable 一樣:內建步屬性或內建著色樹的鍵、MC. 之下的鍵,或專案已用來定義步變數或著色樹的鍵,都不會註冊;同一個鍵在本工作階段再註冊一次,會以新的定義取代。樹在註冊時就被複製並編譯,所以之後再改那個樹物件,在重新註冊之前都不會生效。沒有編號的節點從樹的 NextId 起編號——樹沒有給任何編號時,依樹的順序編成 1、2、3…,腳本每次執行都是同樣的號碼。沒有鍵、有條件項沒有鍵、有比較沒有門檻值、有編號重複或超出範圍,或用了本版本不認得的比較或條件連接的樹,都不會註冊;只有警告的樹——例如清單裡沒有收下每一步的節點——照原樣註冊。每個拒絕與每個警告都在工作階段訊息中提示一次;條件裡指名、卻對不上任何步屬性的鍵,會在播放後提示。沒有 Hue_deg 的葉會有一個自己的色相。樹和註冊的變數一樣,工作階段結束就不見。它出現在「步顯示偏好設定」對話框的 Engineering View 之下——那是每一棵著色樹的分類——以及「視覺指標時序圖」的屬性選擇器與步檔案裡——值是葉的編號。
存取步資料¶
GetMachiningStep¶
GetMachiningStep (API) 依索引取得步;對沒有步的位置——播放還沒建好的、「停止」丟掉的、或建置失敗的——回 null:
var step = GetMachiningStep(100);
if (step != null)
{
Message($"ToolId={step.ToolId}, Force={step.MaxAbsForce_N} N");
}
StepCount¶
StepCount (API) 回傳 strip 上的位置數——自上次「重置」起每送出一步一個,沒有步的位置也算在內:
迭代全部步¶
for (int i = 0; i < StepCount; i++)
{
var step = GetMachiningStep(i);
if (step == null)
continue; // a position without a step
// process step...
}
步輸出檔¶
步可由 WriteStepFiles (API) 匯出為 CSV:
CSV 包含所有預設屬性與已註冊的自訂變數。檔案可由 PlayCsvFile (API) 讀回。
波形級資料(次步時間解析)可使用 WriteShotFiles (API):
訓練後動態註冊變數¶
執行 TrainMillingPara (API) 或 ReTrainMillingPara (API) 後,訓練區內的步會自動註冊兩個額外步變數:
| 變數 | 說明 |
|---|---|
TrainingErrRatio |
每步仿真與量測之間的誤差指標:是一個比值,「步屬性」與圖表以百分比顯示它(步檔案保存比值本身) |
AngleOffset_deg |
量測與仿真資料的刀具旋轉相位差,單位為度 |