انتقل إلى المحتوى

المعلمات القابلة للتخصيص في خوارزميات Python

عند تطوير روبوتات التداول بلغة Python، أو المؤشرات الفنية أو الإضافات، قد تحتاج إلى إضافة وتكوين معلمات قابلة للتخصيص. يشرح هذا المقال كيفية إعلان واستخدام المعلمات القابلة للتخصيص في خوارزمية Python لـ cTrader.

ملاحظة

يتضمن نموذج التنفيذ لخوارزميات Python في cTrader محرك .NET/C#، مما يتطلب إعلان جميع المعلمات القابلة للتخصيص داخل ملفات .cs. في كل مرة تقوم فيها بإنشاء خوارزمية Python في cTrader، يتم إنشاء ملف .cs لتلك الخوارزمية تلقائيًا وتخزينه في المجلد ذي الصلة.

الموقع

يعتمد موقع ملف .cs لخوارزمية Python على نوع الخوارزمية، سواء كانت cBot أو مؤشر أو إضافة، بالإضافة إلى اسم الخوارزمية.

  • بالنسبة لـ cBots: Documents/cAlgo/Sources/Robots/{cBot-name}/{cBot-name}/
  • بالنسبة للمؤشرات: Documents/cAlgo/Sources/Indicators/{Indicator-name}/{Indicator-name}/
  • بالنسبة للإضافات: Documents/cAlgo/Sources/Indicators/{Plugin-name}/{Plugin-name}/

يمكنك اتباع هذه التعليمات لتحديد موقع ملف .cs لخوارزمية Python:

  1. انقر بزر الماوس الأيمن على الخوارزمية في cTrader Windows أو Mac، ثم حدد إظهار في المجلد.

  2. انتقل عبر {name-of-algorithm}/{name-of-algorithm}، ثم حدد ملف .cs (ملف المصدر C#) من قائمة الملفات.

عادةً ما يكون لملف .cs نفس اسم الخوارزمية، مع إزالة جميع المسافات. على سبيل المثال، خوارزمية تسمى Amazing Aroon cBot ينتج عنها ملف AmazingArooncBot.cs.

نصيحة

في نفس المجلد، يمكنك الوصول إلى الكود الرئيسي لـ Python لخوارزميتك، المخزن في ملف .py مثل Amazing Aroon cBot_main.py. يتبع ملف Python اتفاقية تسمية بسيطة:

  • بالنسبة لـ cBots: cBot-name_main.py
  • بالنسبة للمؤشرات: Indicator-name_main.py
  • بالنسبة للإضافات: Plugin-name_main.py

المحتوى

افتح ملف .cs في أي محرر نصوص أو كود، مثل NotePad أو Visual Studio code ويجب أن ترى كودًا مشابهًا لهذا:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
using cAlgo.API;

namespace cAlgo.Robots;

[Robot(AccessRights = AccessRights.None, AddIndicators = true)]
public partial class AmazingArooncBot : Robot
{
    [Parameter("Volume (Lots)", DefaultValue = 0.01)]
    public double VolumeInLots { get; set; }

    [Parameter("Stop Loss (Pips)", DefaultValue = 10, MaxValue = 100, MinValue = 1, Step = 1)]
    public double StopLossInPips { get; set; }

    [Parameter("Take Profit (Pips)", DefaultValue = 10, MaxValue = 100, MinValue = 1, Step = 1)]
    public double TakeProfitInPips { get; set; }

    [Parameter("Label", DefaultValue = "AmazingArooncBot")]
    public string Label { get; set; }

    [Parameter("Periods", DefaultValue = 25, Group = "Aroon", MinValue = 2)]
    public int Periods { get; set; }
}

ملاحظة

سترى فئة فارغة إذا قمت بإنشاء cBot Python الخاص بك من الصفر دون استخدام قالب.

يمكن استخدام أي معلمة معلنة في ملف .cs في ملف Python الرئيسي، الذي يحتوي على الكود المعروض في محرر الكود. يوضح كود Python الرئيسي أدناه استخدام المعلمات القابلة للتخصيص:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
import clr

clr.AddReference("cAlgo.API")

# Import cAlgo API types
from cAlgo.API import *

# Import trading wrapper functions
from robot_wrapper import *

class AmazingArooncBot():
    def on_start(self):
        self.volumeInUnits = api.Symbol.QuantityToVolumeInUnits(api.VolumeInLots)
        self.aroon = api.Indicators.Aroon(api.Periods)

    def on_bar_closed(self):
        if self.aroon.Up.Last(0) > self.aroon.Down.Last(0) and self.aroon.Up.Last(1) < self.aroon.Down.Last(1):
            self.close_positions(TradeType.Sell)
            api.ExecuteMarketOrder(TradeType.Buy, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)
        elif self.aroon.Up.Last(0) < self.aroon.Down.Last(0) and self.aroon.Up.Last(1) > self.aroon.Down.Last(1):
            self.close_positions(TradeType.Buy)
            api.ExecuteMarketOrder(TradeType.Sell, api.SymbolName, self.volumeInUnits, api.Label, api.StopLossInPips, api.TakeProfitInPips)

    def get_bot_positions(self):
        return api.Positions.FindAll(api.Label)

    def close_positions(self, tradeType):
        for position in self.get_bot_positions():
            if position.TradeType != tradeType:
                continue
            api.ClosePosition(position)

المزايا

الميزة الرئيسية للمعلمات القابلة للتخصيص هي أنها تظهر كحقول قابلة للتحرير في واجهة المستخدم لجميع تطبيقات cTrader، بما في ذلك cTrader Windows وMac وWeb وMobile. يمكن تعديل القيم في هذه الحقول بسهولة لتناسب أي احتياج أو عملية، دون الحاجة إلى الوصول إلى كود المصدر للخوارزمية أو تعديله.

في متجر cTrader، غالبًا ما يستخدم البائعون المعلمات القابلة للتخصيص للتأكد من أن المشترين للخوارزميات قادرون على ضبط الخوارزميات لتناسب أهدافهم وسير عملهم.

Image title