Skip to content

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 == truebool, int, double, string
!=ไม่เท่ากับring.count != 0bool, int, double, string
>=มากกว่าหรือเท่ากับfix.score >= 0.75int, double
<=น้อยกว่าหรือเท่ากับring.area <= 8000int, double
betweenอยู่ในช่วงปิด [min, max]span.distanceMm between 4.8 5.2int, double

3. หลักการทำงานภายในซอฟต์แวร์ ​

อ้างอิงจาก src/tools/decide.cpp:

  1. Compile ครั้งเดียวตอน Load (validateStep):
    • แยกข้อความ rules ออกเป็นโครงสร้าง CompiledClause ล่วงหน้า (ไม่ทำการ Parse String ซ้ำในทุก Cycle เพื่อความเร็วสูงสุด)
    • ตรวจสอบว่า stepId ที่อ้างอิงต้องเป็น Step ก่อนหน้าที่เปิดใช้งาน (enabled: true) เท่านั้น
    • ตรวจสอบว่า metricName ต้องเป็น Metric ที่โมดูลนั้นสร้างได้จริง และชนิดข้อมูล (Type) ต้องตรงกับค่าเปรียบเทียบ
  2. การประเมินผลตอน 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 ออกไปได้