Komplexe Kerzenmuster

Überblick

Die Klasse ComplexCandlePattern ermöglicht das Erstellen komplexer Kerzenmuster, indem mehrere einfache Muster (ICandlePattern) zu einem Muster kombiniert werden. Beim Erkennen eines komplexen Musters wird jedes innere Muster nacheinander auf seinem Kerzensegment geprüft. Das Muster gilt nur dann als erkannt, wenn alle inneren Muster übereinstimmen.

ICandlePattern

Das Basisinterface für alle Kerzenmuster:

public interface ICandlePattern : IPersistable
{
    // Mustername
    string Name { get; }

    // Anzahl der Kerzen, die für die Erkennung erforderlich sind
    int CandlesCount { get; }

    // Prüft, ob das Muster auf den angegebenen Kerzen erkannt wird
    bool Recognize(ReadOnlySpan<ICandleMessage> candles);
}

Die Registry CandlePatternRegistry enthält eine Reihe integrierter Muster: Flat, White, Black, Hammer, BullishEngulfing, MorningStar, ThreeWhiteSoldiers und weitere.

ComplexCandlePattern

Die Klasse ComplexCandlePattern implementiert ICandlePattern und kombiniert mehrere innere Muster:

public class ComplexCandlePattern : ICandlePattern
{
    // Leeres Muster erstellen
    public ComplexCandlePattern() { }

    // Muster mit Namen und Satz innerer Muster erstellen
    public ComplexCandlePattern(string name, IEnumerable<ICandlePattern> inner);

    // Name des komplexen Musters
    public string Name { get; }

    // Innere Muster
    public IEnumerable<ICandlePattern> Inner { get; }

    // Gesamtzahl der Kerzen (Summe von CandlesCount für alle inneren Muster)
    public int CandlesCount { get; }
}

Beim Aufruf von Recognize wird das Kerzenarray entsprechend dem jeweiligen CandlesCount der inneren Muster in aufeinanderfolgende Segmente aufgeteilt. Wenn mindestens ein inneres Muster nicht übereinstimmt, gibt die Methode false zurück.

Beispiel: Erstellen eines komplexen Musters

using StockSharp.Algo.Candles.Patterns;

// Komplexes Muster erstellen: zuerst eine bärische Kerze, dann bullische Umschließung
var complex = new ComplexCandlePattern(
    "Aufwärtsumkehr",
    new ICandlePattern[]
    {
        CandlePatternRegistry.Black,            // 1 Kerze: bärisch
        CandlePatternRegistry.BullishEngulfing,  // 2 Kerzen: bullische Umschließung
    }
);

// Für die Erkennung sind 3 Kerzen erforderlich (1 + 2)
Console.WriteLine($"Benötigte Kerzen: {complex.CandlesCount}"); // 3

ICandlePatternProvider

Das Interface ICandlePatternProvider verwaltet Speicherung und Suche von Mustern:

public interface ICandlePatternProvider
{
    // Ereignisse für Erstellung, Ersetzung und Löschung von Mustern
    event Action<ICandlePattern> PatternCreated;
    event Action<ICandlePattern, ICandlePattern> PatternReplaced;
    event Action<ICandlePattern> PatternDeleted;

    // Speicher initialisieren
    ValueTask InitAsync(CancellationToken cancellationToken);

    // Alle verfügbaren Muster
    IEnumerable<ICandlePattern> Patterns { get; }

    // Muster nach Namen suchen
    bool TryFind(string name, out ICandlePattern pattern);

    // Muster entfernen
    bool Remove(ICandlePattern pattern);

    // Muster speichern (erstellen oder ersetzen)
    void Save(ICandlePattern pattern);
}

Implementierungen

• InMemoryCandlePatternProvider - speichert Muster im Arbeitsspeicher. Bei der Initialisierung lädt er alle integrierten Muster aus CandlePatternRegistry.All.
• CandlePatternFileStorage - speichert benutzerdefinierte Muster in einer Datei (JSON). Integrierte Muster aus InMemoryCandlePatternProvider sind auch über diesen Provider verfügbar.

Beispiel: Arbeiten mit ICandlePatternProvider

using StockSharp.Algo.Candles.Patterns;
using StockSharp.Configuration;

// Dateibasierten Musterspeicher erstellen
var executor = new ChannelExecutor();
var provider = new CandlePatternFileStorage(
    Paths.FileSystem,
    Paths.CandlePatternsFile,
    executor
);

// Initialisieren (lädt integrierte + benutzerdefinierte Muster aus der Datei)
await provider.InitAsync(CancellationToken.None);

// Ereignis für die Erstellung neuer Muster abonnieren
provider.PatternCreated += pattern =>
{
    Console.WriteLine($"Muster erstellt: {pattern.Name}");
};

// Komplexes Muster erstellen und speichern
var myPattern = new ComplexCandlePattern(
    "Mein Muster",
    new ICandlePattern[]
    {
        CandlePatternRegistry.Hammer,
        CandlePatternRegistry.White,
    }
);

provider.Save(myPattern);

// Muster nach Namen suchen
if (provider.TryFind("Mein Muster", out var found))
{
    Console.WriteLine($"Gefunden: {found.Name}, Kerzen: {found.CandlesCount}");
}

ExpressionCandlePattern

Für die Erstellung formelbasierter Muster wird ExpressionCandlePattern verwendet. Jede Kerze im Muster wird durch einen Ausdruck CandleExpressionCondition beschrieben; dabei stehen die folgenden Variablen zur Verfügung:

Variable	Beschreibung
O	Eröffnungskurs
H	Höchstkurs
L	Tiefstkurs
C	Schlusskurs
V	Volumen
B	Kerzenkörper
LEN	Kerzenlänge
BS	Unterer Schatten
TS	Oberer Schatten

Das Präfix p verweist auf die vorherige Kerze (pO, pC), pp auf die Kerze zwei Perioden zurück usw.

Alle integrierten Muster in CandlePatternRegistry werden mit ExpressionCandlePattern aufgebaut.