أنواع المعلمات في خوارزمية cTrader

في هذا المقال والفيديو المصاحب له، سنوضح كيف يمكنك إعلان واستخدام المعلمات القابلة للتخصيص في cBots والمؤشرات الخاصة بك. سنقوم بتطوير مؤشر بسيط ونوضح لك كيفية تكوين المعلمات من واجهة مستخدم cTrader. سنشرح أيضًا أنواع المعلمات التي يمكنك استخدامها في cBot أو مؤشر cTrader ونوضح كيفية إعلانها واستخدامها في الكود الخاص بك.

المعلمات القابلة للتخصيص

المعلمات القابلة للتخصيص هي قيم قابلة للتكوين يمكن تعيينها عند إضافة أو بدء أو استخدام خوارزمية. تسمح لك وللمستخدمين الآخرين بتخصيص سلوك cBots والمؤشرات والإضافات دون تعديل الكود المصدري.

كما تم شرحه سابقًا، يدعم cTrader أنواع المعلمات التالية:

• int
• double
• string
• bool
• DataSeries
• TimeFrame
• enum
• Color
• DateTime
• DateOnly
• TimeSpan
• Symbol
• Symbol[] (multi-symbol)
• Enum[] (multi-enum)
• TimeFrame[] (multi-period)

إنشاء مؤشر بسيط بمعلمات

لتوضيح كيفية استخدام المعلمات في المؤشرات المخصصة، سنقوم بإنشاء مؤشر جديد ونسميه Standard Deviation.

لحساب الانحراف المعياري، نحتاج أولاً إلى حساب المتوسط المتحرك للسعر. بعد ذلك، سنعلن عن المعلمات اللازمة لمؤشر المتوسط المتحرك بدءًا بفترة المتوسط المتحرك.

1

public int MaPeriod { get; set; }

يمكن لأي خاصية عامة لها أحد الأنواع المدعومة أن تصبح معلمة مؤشر. لتحويل خاصية MaPeriod إلى معلمة، كل ما علينا فعله هو إضافة الإعلان المطلوب.

1
2

[Parameter("MA Period")]
public int MaPeriod { get; set; }

تُرشد سمة Parameter cTrader لعرض هذه الخاصية كمعلمة في لوحة معلمات المؤشر باستخدام الاسم المحدد ("MA Period").

كما هو موضح أدناه، تسمح سمة Parameter أيضًا بتحديد بعض خصائص المعلمة مثل الاسم المعروض والقيمة الافتراضية والمجموعة التي سيتم وضع هذه المعلمة فيها والقيم القصوى والدنيا، بالإضافة إلى الخطوة التي ستتغير بها المعلمة عند الضغط على أسهم الأعلى والأسفل (للقيم الرقمية فقط).

1
2

[Parameter("SMA Period", DefaultValue = 14, Group = "MA", MaxValue = 100, MinValue = 1, Step = 1)]
public int MaPeriod { get; set; }

سنضيف الآن بقية المعلمات اللازمة لمؤشر المتوسط المتحرك. ستساعدنا معلمة MaType في تحديد نوع المتوسط المتحرك. إنها enum ستظهر كقائمة منسدلة في واجهة مستخدم cTrader.

1
2

[Parameter("MA Type", Group = "MA")]
public MovingAverageType MaType { get; set; }

ستمنح معلمة Source المستخدمين خيار تحديد مصدر البيانات لمؤشر المتوسط المتحرك لدينا. هذه المعلمة هي من نوع DataSeries.

1
2

[Parameter("Source", Group = "MA")]
public DataSeries Source { get; set; }

الآن بعد أن تم الإعلان عن المعلمات المطلوبة، سنقوم بتعريف وتهيئة المتوسط المتحرك لدينا.

1
2
3
4
5
6

private MovingAverage movingAverage;

protected override void Initialize()
{
    movingAverage = Indicators.MovingAverage(Source, MaPeriod, MaType);
}

في هذه المرحلة، نحن جاهزون لتنفيذ الحساب لمؤشر الانحراف المعياري لدينا. يحتوي قالب الكود الافتراضي بالفعل على خاصية Output التي يمكننا استخدامها لعرض نتائج الحساب.

1
2

[Output("Result", LineColor = "Orange")]
public IndicatorDataSeries Result { get; set; }

أخيرًا وليس آخرًا، سننفذ حساب الانحراف المعياري في طريقة Calculate().

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

public override void Calculate(int index)
{
    var average = movingAverage.Result[index];

    double sum = 0;

    for (var period = 0; period < MaPeriod; period++)
    {
        sum += Math.Pow(Source[index - period] - average, 2.0);
    }

    Result[index] = Math.Sqrt(sum / MaPeriod);
}

إذا أضفنا مؤشرنا إلى رسم بياني، يجب أن نرى جميع معلماتنا في نافذة Add instance.

إضافة معلمات إضافية

بعد اكتمال الانحراف المعياري لدينا، يمكننا أيضًا إضافة خط أفقي سيعمل كعتبة مرئية للمؤشر. لهذا الغرض سنحتاج إلى إضافة بعض المعلمات الإضافية.

الأولى ستكون معلمة منطقية تحدد ما إذا كان سيتم عرض خطنا أم لا.

1
2

[Parameter("Show Line", DefaultValue = true, Group = "Line")]
public bool ShowLine { get; set; }

ستسمح لنا معلمة LineLevel بتحديد مستوى السعر الذي يجب رسم الخط عنده.

1
2

[Parameter("Line Level", DefaultValue = 0.001, Step = 0.001, Group = "Line")]
public double LineLevel { get; set; }

سنضيف أيضًا معلمة تسمح باختيار لون الخط.

1
2

[Parameter("Line Color", DefaultValue = "Blue", Group = "Line")]
public Color LineColor { get; set; }

مع وجود جميع المعلمات الضرورية في مكانها، يمكننا كتابة كود لرسم الخط على الرسم البياني الذي تم إرفاق مؤشرنا به.

1
2
3
4

if (ShowLine)
{
    Chart.IndicatorAreas[0].DrawHorizontalLine("Line", LineLevel, LineColor);
}

إذا قمنا ببناء المؤشر مرة أخرى وإضافة مثيل جديد، سنتمكن من إخفاء/إظهار الخط ونقله لأعلى أو لأسفل واختيار اللون الذي نريده كلون للخط.

كما هو موضح في المثال أدناه، يمكن أيضًا استخدام المعلمات للتأكد من أن مؤشرنا يظهر فقط عند إضافته إلى الرسوم البيانية لإطار زمني محدد.

1
2

[Parameter("Timeframe")]
public TimeFrame TF { get; set; }

في طريقة Initialize()، سنتحقق من الإطار الزمني للرسم البياني الذي تم إرفاق مؤشرنا به. إذا لم يكن مساويًا لقيمة معلمة TF، فسنمنع عرض المؤشر.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

protected override void Initialize()
{
    if (TimeFrame != TF)
        return;

    movingAverage = Indicators.MovingAverage(Source, MaPeriod, MaType);

    if (ShowLine)
    {
        Chart.IndicatorAreas[0].DrawHorizontalLine("Line", LineLevel, LineColor);
    }
}

نأمل أن يكون هذا الدليل مفيدًا في فهم المعلمات وكيفية عملها في التداول الخوارزمي لـ cTrader.