เพิ่มประสิทธิภาพ cBot¶

คำสั่ง optimize จะค้นหาค่าพารามิเตอร์ต่าง ๆ ของ cBot เพื่อหาชุดค่าที่ให้ผลลัพธ์ดีตามเกณฑ์ที่คุณเลือก คำสั่งนี้ใช้การค้นหาแบบพันธุกรรมหรือแบบกริดเช่นเดียวกับแอป cTrader บนเดสก์ท็อป แต่สั่งงานผ่านเทอร์มินัลและไฟล์ JSON ที่ระบุการตั้งค่าพารามิเตอร์ คำสั่งนี้เป็นคำสั่งสำหรับการเพิ่มประสิทธิภาพ ซึ่งเทียบเคียงได้กับคำสั่งbacktesting ที่ใช้ทดสอบย้อนหลัง

ขอบเขตการทำงาน ¶

คำสั่ง optimize ใช้เพิ่มประสิทธิภาพพารามิเตอร์ของ cBot อินดิเคเตอร์และปลั๊กอินมีคำสั่งสำหรับจัดการโดยเฉพาะ (indicator calculate, indicator history, create, build) จึงไม่รวมอยู่ในการเพิ่มประสิทธิภาพนี้

ข้อกำหนดเบื้องต้น ¶

• ต้องติดตั้ง cTrader CLI แล้ว และสามารถลงชื่อเข้าใช้ได้
• ต้องส่งออก cBot เป็นไฟล์ .algo และบิลด์สำหรับ .NET 8
• มีไฟล์พารามิเตอร์ ที่กำหนดว่าจะค้นหาค่าของพารามิเตอร์ใดบ้าง

คำสั่ง optimize ¶

ctrader-cli optimize <path-to-algo-file> --params=<path-to-params-file> [options]

อาร์กิวเมนต์แรกคือพาธไปยังไฟล์ .algo ต้องระบุตัวเลือก --params ต้องกำหนดกรอบเวลาพื้นฐานผ่าน --timeframe หรือในไฟล์พารามิเตอร์ หากไม่ได้กำหนดไว้ทั้งสองแห่ง คำสั่งจะหยุดทำงานพร้อมแจ้งข้อผิดพลาด

ตัวเลือกการเพิ่มประสิทธิภาพ ¶

มีเพียง --params ที่จำเป็นต้องระบุ ตัวเลือกเสริมที่ใช้บ่อยในตัวอย่างด้านล่าง ได้แก่ --timeframe, --method, --criteria, --optres และ --passes-dir

ก่อนเริ่มใช้งาน ควรทำความเข้าใจตัวเลือกต่อไปนี้

• --method – genetic (ค่าเริ่มต้น) หรือ grid เลือก grid เมื่อมีชุดค่าพารามิเตอร์ไม่มากและต้องการทดสอบทุกชุด ส่วน genetic เหมาะเมื่อมีชุดค่าจำนวนมากและการค้นหาแบบมีทิศทางทำได้เร็วกว่า
• --cores – จำนวนเวิร์กเกอร์ที่ทำงานแบบขนานเพื่อเรียกใช้ขั้นตอน backtesting ของแต่ละรัน เวิร์กเกอร์แต่ละตัวใช้เธรด CPU หนึ่งเธรด ดังนั้นการทำงานจะใช้จำนวนเธรดใกล้เคียงกับค่าที่ระบุ ค่าที่ยอมรับคือจำนวนเต็มตั้งแต่ 1 ขึ้นไป ค่าเริ่มต้นเท่ากับครึ่งหนึ่งของจำนวนโปรเซสเซอร์บวกหนึ่ง ลดค่านี้บน VPS ขนาดเล็กเพื่อเหลือทรัพยากรสำหรับงานอื่น หรือเพิ่มค่าบนเครื่องเฉพาะเพื่อกระจายการค้นหาแบบพันธุกรรมไปยังเธรดมากขึ้น
• --auto-select-best – เลือกรันที่ให้ผลดีที่สุดโดยอัตโนมัติเมื่อการเพิ่มประสิทธิภาพเสร็จสิ้น เพื่อให้ไฟล์ .cbotset ที่มีค่าพารามิเตอร์ดีที่สุดพร้อมใช้งานโดยไม่ต้องทำขั้นตอนเพิ่มเติม

ไฟล์พารามิเตอร์ ¶

ไฟล์ที่ระบุด้วย --params เป็นออบเจ็กต์ JSON ที่มีอาร์เรย์ parameters ไฟล์นี้มีโครงสร้างเหมือนกับไฟล์ที่ส่งออกจากหน้าจอเพิ่มประสิทธิภาพของแอป cTrader บนเดสก์ท็อป จึงสามารถนำไฟล์ที่ส่งออกมาใช้ได้โดยตรง

{
  "parameters": [
    { "Name": "SlowPeriods",  "Optimize": true, "Min": "5",  "Max": "50", "Step": "5" },
    { "Name": "StopLossPips", "Optimize": true, "Min": "10", "Max": "60", "Step": "5" },
    { "Name": "MAType",       "Optimize": true, "Values": ["0", "1", "2"] },
    { "Name": "MySymbol",     "Optimize": true, "Values": ["EURUSD", "GBPUSD"] }
  ]
}

กฎของฟิลด์ ¶

• ต้องระบุ Name และค่าในฟิลด์นี้ต้องตรงกับชื่อพร็อพเพอร์ตีของ cBot เรียกใช้ ctrader-cli metadata <path-to-algo> เพื่อดูชื่อพร็อพเพอร์ตีที่ใช้ได้ หากไม่พบชื่อในข้อมูลเมตาของ cBot ระบบจะบันทึกลงล็อกและข้ามพารามิเตอร์นั้น แล้วเพิ่มประสิทธิภาพต่อด้วยพารามิเตอร์ที่เหลือ
• กำหนด Optimize เป็น true เพื่อรวมพารามิเตอร์นั้นในการค้นหา หากกำหนดเป็น false ค่าพารามิเตอร์จะคงที่
• พารามิเตอร์แบบช่วงค่า เช่น จำนวนเต็มและเลขทศนิยมชนิด double ต้องมี Min, Max และ Step หากต้องการค้นหาค่าต่าง ๆ
• พารามิเตอร์แบบเลือกจากค่าที่กำหนด เช่น ค่าประเภท enum และสัญลักษณ์ ต้องมีอาร์เรย์ Values ที่ไม่ว่าง หากต้องการค้นหาค่าต่าง ๆ
• ParameterType เป็นฟิลด์ที่ไม่จำเป็นต้องระบุ หากไม่ระบุ ระบบจะกำหนดชนิดของพารามิเตอร์จากข้อมูลเมตาของ cBot โดยจับคู่กับ Name

กำหนดค่าคงที่ให้พารามิเตอร์ ¶

หากต้องการคงค่าของพารามิเตอร์ ให้เพิ่มพารามิเตอร์นั้นพร้อม Optimize: false และค่า Value ที่ต้องการ:

{ "Name": "MAType",      "Value": "1", "Optimize": false },
{ "Name": "FastPeriods", "Value": "5", "Optimize": false }

เพิ่มประสิทธิภาพกรอบเวลาหลัก ¶

คำสั่ง optimize สามารถค้นหาค่ากรอบเวลาหลักหลายค่าได้ นอกเหนือจากพารามิเตอร์ของ cBot กรอบเวลาหลักกำหนดได้จากสองแหล่ง โดย --timeframe มีลำดับความสำคัญสูงกว่า

• --timeframe <tf> – ค่าเดียวจะกำหนดกรอบเวลาหลักให้คงที่ ส่วนหลายค่าที่คั่นด้วยจุลภาคจะให้ค้นหากรอบเวลาหลายค่า
• ไฟล์พารามิเตอร์ – ไฟล์ที่ส่งออกจากแอปเดสก์ท็อปมีพารามิเตอร์กรอบเวลาแบบสังเคราะห์สำหรับวัตถุประสงค์นี้อยู่แล้ว

กรอบเวลาพื้นฐานของข้อมูลจะใช้ค่าเดียวที่ระบุ ค่าที่กำหนดให้คงที่ หรือกรอบเวลาที่เล็กที่สุดจากค่าที่ค้นหา

ความเข้ากันได้ของกรอบเวลาและโหมดข้อมูล ¶

กรอบเวลาหลักที่ใช้ค้นหาหรือกำหนดให้คงที่ต้องโหลดได้ใน --data-mode ที่เลือก

เกณฑ์ ¶

แต่ละรายการใน --criteria จับคู่ดัชนีผลการดำเนินงานกับทิศทาง max หรือ min เช่น NetProfit:max ตารางด้านล่างแสดงชื่อดัชนีที่รองรับทั้งหมดพร้อมคำอธิบายว่าวัดค่าอะไร

หากต้องการเพิ่มกำไรสุทธิให้สูงสุดและลดการลดลงสูงสุดของอิควิตี้ให้น้อยที่สุด:

--criteria="NetProfit:max,MaxEquityDrawdownPercentages:min"

หากต้องการกำหนดการจัดอันดับด้วยตนเอง ให้ใช้ --fitness แทน เมธอด GetFitness ของ cBot จะส่งคืนคะแนน และระบบเพิ่มประสิทธิภาพจะเก็บรันที่มีค่าคะแนนสูงที่สุดไว้ --fitness และ --criteria ใช้ร่วมกันไม่ได้ ต้องเลือกใช้เพียงตัวเลือกเดียว

ตัวเลือกสภาพแวดล้อมการทดสอบ ¶

optimize ใช้ตัวเลือกสภาพแวดล้อมการทดสอบเดียวกับ backtest ตารางด้านล่างแสดงตัวเลือกที่ CLI เวอร์ชันปัจจุบันรองรับ สิ่งที่แต่ละตัวเลือกกำหนด และความแตกต่างระหว่างสองคำสั่งในกรณีที่เกี่ยวข้อง

ตัวอย่าง ¶

ctrader-cli optimize "C:/test/Sample Trend cBot.algo" \
  --params=C:/test/optimize-params.json \
  --account=1234567 --symbol=EURUSD --timeframe=h1,h2 \
  --start="01/01/2025" --end="01/02/2025" \
  --balance=100000 --data-mode=open --commission=30 --spread=2 \
  --method=grid \
  --criteria="NetProfit:max,MaxEquityDrawdownPercentages:min" \
  --auto-select-best \
  --optres=C:/test/result.optres \
  --passes-dir=C:/test/result-passes \
  --ctid=letstrade --pwd-file=C:/test/password.pwd

ผลลัพธ์ ¶

ระหว่างทำงาน optimize จะแสดงความคืบหน้าอย่างต่อเนื่องในเทอร์มินัล:

Progress | Loading EURUSD, h1 | 42.00 % |
Progress | Optimization | 37.50 % |

• สรุปผล – เมื่อเสร็จสิ้น cTrader CLI จะแสดงสรุปในเทอร์มินัล ซึ่งรวมจำนวนรันทั้งหมด เวลาที่ใช้ และรันที่ให้ผลดีที่สุดพร้อมสถิติ
• ไฟล์ผลลัพธ์ – เมื่อระบุ --optres cTrader CLI จะเขียนผลลัพธ์ทั้งหมดลงในไฟล์ JSON นามสกุล .optres ซึ่งแสดงข้อมูลของทุกรัน ไฟล์นี้ใช้รูปแบบเดียวกับผลการเพิ่มประสิทธิภาพในแอปเดสก์ท็อป จึงสามารถเปิดหรือนำเข้าในหน้าจอเพิ่มประสิทธิภาพของแอปได้
• รายงานแยกตามรัน – เมื่อระบุ --passes-dir cTrader CLI จะบันทึกไฟล์รายงานของแต่ละรันในไดเรกทอรีนั้น โดยมีโฟลเดอร์ย่อยหนึ่งโฟลเดอร์ต่อรัน และแต่ละโฟลเดอร์มีไฟล์ .html, .txt, .json และ .cbotset ไฟล์ .cbotset แสดงค่าพารามิเตอร์ที่ใช้จริงในการรันนั้น

หากไม่ได้ระบุทั้ง --optres และ --passes-dir การเพิ่มประสิทธิภาพจะเสร็จสิ้นและแสดงเฉพาะสรุปผล

ตรวจสอบว่าการเพิ่มประสิทธิภาพทำงานถูกต้อง ¶

หลังการทำงาน ให้ยืนยันว่าระบบได้ค้นหาค่าพารามิเตอร์ตามที่คุณต้องการ

1. เปิดไฟล์ .cbotset ของรันใดรันหนึ่งภายใต้ --passes-dir และตรวจสอบว่าพารามิเตอร์ที่เพิ่มประสิทธิภาพมีค่าเปลี่ยนไประหว่างรัน ขณะที่พารามิเตอร์ที่กำหนดให้คงที่หรือไม่ได้ระบุไว้ยังมีค่าเดิม
2. หากค้นหากรอบเวลาหลายค่า ให้ตรวจสอบค่า Chart.Period ในไฟล์ .cbotset ของแต่ละรัน ค่านั้นควรตรงกับกรอบเวลาที่คุณเลือก
3. เปิดไฟล์ .optres หรือนำเข้าไฟล์นี้ในหน้าจอเพิ่มประสิทธิภาพของแอปเดสก์ท็อปเพื่อตรวจสอบการกำหนดค่าและผลของทุกรันพร้อมกัน

การตรวจสอบความถูกต้องและข้อผิดพลาดที่พบบ่อย ¶

แต่ละแถวในตารางด้านล่างแสดงอาการ สาเหตุที่เป็นไปได้ รหัสสิ้นสุดการทำงานที่ cTrader CLI ส่งคืนเมื่อเกิดข้อผิดพลาด และขั้นตอนถัดไปที่ควรทำ เมื่อการตรวจสอบความถูกต้องล้มเหลว cTrader CLI จะส่งคืนรหัสสิ้นสุดการทำงานที่ไม่ใช่ศูนย์ ทำให้สคริปต์หยุดเมื่อพบข้อผิดพลาดแรกได้โดยไม่ต้องวิเคราะห์ข้อความ

รหัสสิ้นสุดการทำงานในตารางหมายถึงค่าที่ cTrader CLI ส่งกลับให้เชลล์ ไม่มีการเผยแพร่ตัวเลขรหัสที่แน่นอน ดังนั้น non-zero หมายถึงคำสั่งล้มเหลวโดยไม่มีรหัสเฉพาะ ส่วน unknown หมายถึงข้อผิดพลาดภายในที่ต้องเปลี่ยนบิลด์หรือติดต่อฝ่ายสนับสนุน