Appearance
decide — ตัดสินผล Pass / Fail ตามเงื่อนไข (Rule Engine)
โมดูล decide เป็นขั้นตอนสุดท้ายของกราฟการตรวจจับ ทำหน้าที่รวบรวมค่า Metric จากโมดูลก่อนหน้ามาตรวจสอบกับกฎ (Rules) ที่กำหนดไว้ เพื่อตัดสินว่าชิ้นงาน ผ่าน (Pass) หรือ ไม่ผ่าน (Fail) พร้อมระบุเหตุผลเมื่อไม่ผ่าน
1. การใช้งานใน Recipe
- Inputs: ไม่มีพอร์ตภาพ (
{}) — อ่านค่าจาก Metric ของขั้นตอนก่อนหน้าโดยตรงผ่านชื่อ<stepId>.<metricName> - Parameters:
logic(string, ค่าเริ่มต้น"all"): รูปแบบการรวมเงื่อนไข (ใน Phase 1 รองรับเฉพาะ"all"คือทุกกฎต้องเป็นจริงทั้งหมดจึงจะ Pass)rules(string, จำเป็นต้องระบุ): รายการกฎคั่นด้วยเครื่องหมายอัฒภาค (;)
- Outputs / Metrics:
pass(bool):trueเมื่อผ่านทุกเงื่อนไข,falseเมื่อมีอย่างน้อยหนึ่งเงื่อนไขไม่ผ่านreasons(string): ข้อความสรุปเหตุผลของกฎที่ไม่ผ่าน (ว่างเปล่าเมื่อ Pass)
json
{
"id": "judge",
"type": "decide",
"enabled": true,
"params": {
"logic": "all",
"rules": "fix.found == true; ring.count between 1 1; span.distanceMm between 4.8 5.2"
},
"inputs": {}
}2. ไวยากรณ์ของกฎ (Rule Syntax)
แต่ละประโยค (Clause) คั่นด้วย ; และประกอบด้วย <stepId>.<metricName> <operator> <value...>
| Operator | ความหมาย | ตัวอย่าง | ชนิดข้อมูลที่รองรับ |
|---|---|---|---|
== | เท่ากับ | fix.found == true | bool, int, double, string |
!= | ไม่เท่ากับ | ring.count != 0 | bool, int, double, string |
>= | มากกว่าหรือเท่ากับ | fix.score >= 0.75 | int, double |
<= | น้อยกว่าหรือเท่ากับ | ring.area <= 8000 | int, double |
between | อยู่ในช่วงปิด [min, max] | span.distanceMm between 4.8 5.2 | int, double |
3. หลักการทำงานภายในซอฟต์แวร์
อ้างอิงจาก src/tools/decide.cpp:
- Compile ครั้งเดียวตอน Load (
validateStep):- แยกข้อความ
rulesออกเป็นโครงสร้างCompiledClauseล่วงหน้า (ไม่ทำการ Parse String ซ้ำในทุก Cycle เพื่อความเร็วสูงสุด) - ตรวจสอบว่า
stepIdที่อ้างอิงต้องเป็น Step ก่อนหน้าที่เปิดใช้งาน (enabled: true) เท่านั้น - ตรวจสอบว่า
metricNameต้องเป็น Metric ที่โมดูลนั้นสร้างได้จริง และชนิดข้อมูล (Type) ต้องตรงกับค่าเปรียบเทียบ
- แยกข้อความ
- การประเมินผลตอน Run (
execute):- ดึงค่าจริงจาก
ToolContextมาเทียบกับCompiledClauseทีละข้อ - หากข้อใดไม่เป็นจริง จะบันทึกข้อความเหตุผล (เช่น
span.distanceMm=4.51 not between 4.8..5.2)
- ดึงค่าจริงจาก
กฎเหล็กด้านความปลอดภัย (Fail-Safe Invariants)
- เฉพาะ
decideเท่านั้น ที่สามารถกำหนดค่าCycleResult::pass = trueได้ Status::Okของโมดูลไม่ได้แปลว่าชิ้นงานผ่าน (Status::Okแปลว่าโปรแกรมทำงานจบโดยไม่เกิด Error)- หากเกิด Error ใดๆ ในกราฟ (เช่น กล้อง Timeout, ไม่พบ Fixture, ROI ออกนอกภาพ) ระบบจะหยุดทันทีและเรียก
IIoSink::setFailSafe()โดยไม่มีทางส่งสัญญาณ Pass ออกไปได้