Jenis parameter dalam algo cTrader

Dalam artikel ini dan video yang berkaitan, kami akan menunjukkan cara anda boleh mengisytiharkan dan menggunakan parameter yang boleh disesuaikan dalam cBot dan indikator anda. Kita akan membangunkan indikator ringkas dan menunjukkan kepada anda cara mengkonfigurasi parameter daripada antara muka pengguna cTrader. Kita juga akan menerangkan jenis parameter yang boleh anda gunakan dalam cBot atau indikator cTrader dan menggambarkan bagaimana ia diisytiharkan dan digunakan dalam kod anda.

Parameter yang boleh disesuaikan

Parameter yang boleh disesuaikan ialah nilai yang boleh dikonfigurasi semasa menambah, memulakan atau menggunakan algoritma. Ia membolehkan anda dan pengguna lain menyesuaikan tingkah laku cBot, indikator dan plugin tanpa mengubah suai kod sumber.

Seperti yang telah diterangkan sebelum ini, cTrader menyokong jenis parameter berikut:

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

Cipta indikator ringkas dengan parameter

Untuk menunjukkan bagaimana anda boleh menggunakan parameter dalam indikator tersuai, kita akan mencipta indikator baharu dan menamakan ia Standard Deviation.

Untuk mengira sisihan piawai, kita perlu mengira purata bergerak harga terlebih dahulu. Seterusnya, kita akan mengisytiharkan parameter yang diperlukan untuk indikator purata bergerak bermula dengan tempoh purata bergerak.

1

public int MaPeriod { get; set; }

Sebarang sifat awam yang mempunyai salah satu jenis yang disokong boleh menjadi parameter indikator. Untuk mengubah sifat MaPeriod kita menjadi parameter, yang perlu kita lakukan hanyalah menambah pengisytiharan yang diperlukan.

1
2

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

Atribut Parameter mengarahkan cTrader untuk memaparkan sifat ini sebagai parameter dalam panel parameter indikator menggunakan nama yang ditentukan ("MA Period").

Seperti yang ditunjukkan di bawah, atribut Parameter juga membolehkan anda menentukan beberapa sifat parameter seperti nama yang dipaparkan, nilai lalai, kumpulan di mana parameter ini akan diletakkan, nilai maksimum dan minimum, serta langkah yang akan berubah apabila anak panah atas dan bawah ditekan (hanya untuk nilai berangka).

1
2

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

Kita kini akan menambah parameter selebihnya yang diperlukan untuk indikator purata bergerak. Parameter MaType akan membantu kita menentukan jenis purata bergerak. Ia adalah enum yang akan muncul sebagai menu lungsur dalam antara muka pengguna cTrader.

1
2

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

Parameter Source akan memberi pengguna pilihan untuk menentukan sumber data untuk indikator purata bergerak kita. Parameter ini adalah jenis DataSeries.

1
2

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

Sekarang parameter yang diperlukan telah diisytiharkan, kita akan menentukan dan memulakan purata bergerak kita.

1
2
3
4
5
6

private MovingAverage movingAverage;

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

Pada ketika ini, kita bersedia untuk melaksanakan pengiraan untuk sisihan piawai kita. Templat kod lalai sudah mengandungi sifat Output yang boleh kita gunakan untuk memaparkan hasil pengiraan.

1
2

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

Akhir sekali, kita akan melaksanakan pengiraan sisihan piawai dalam kaedah 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);
}

Jika kita menambah indikator kita pada carta, kita sepatutnya dapat melihat semua parameter kita dalam tetingkap Tambah tika.

Tambah parameter tambahan

Dengan sisihan piawai kita yang telah siap, kita juga boleh menambah garis mendatar yang akan berfungsi sebagai ambang visual untuk indikator. Untuk tujuan ini kita perlu menambah beberapa parameter lagi.

Yang pertama akan menjadi parameter boolean yang akan menentukan sama ada garis kita akan ditunjukkan atau tidak.

1
2

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

Parameter LineLevel akan membolehkan kita menentukan tahap harga di mana garis harus dilukis.

1
2

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

Kita juga akan menambah parameter yang membolehkan pemilihan warna garis.

1
2

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

Dengan semua parameter yang diperlukan tersedia, kita boleh menulis kod untuk melukis garis pada carta di mana indikator kita dilampirkan.

1
2
3
4

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

Jika kita membina indikator itu sekali lagi dan menambah tika baharu, kita akan dapat menyembunyikan/menunjukkan garis, menggerakkannya ke atas atau ke bawah dan memilih warna pilihan kita sebagai warna garis.

Seperti yang ditunjukkan dalam contoh di bawah, parameter juga boleh digunakan untuk memastikan indikator kita hanya ditunjukkan apabila ditambah pada carta untuk tempoh masa tertentu.

1
2

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

Dalam kaedah Initialize() kita akan memeriksa tempoh masa carta di mana indikator kita dilampirkan. Jika ia tidak sama dengan nilai parameter TF, kita akan menghalang indikator daripada dipaparkan.

 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);
    }
}

Kami berharap panduan ini telah membantu dalam memahami parameter dan cara ia berfungsi dalam dagangan algoritma cTrader.