Signatur
Beschreibung
trader_cdlhomingpigeon() ist Teil der PECL-Erweiterung Trader, die auf der TA-Lib (Technical Analysis Library) basiert. Die Funktion analysiert eine Reihe von Open-, High-, Low- und Close-Kursdaten und erkennt darin das sogenannte Homing Pigeon-Muster – ein bullisches Umkehrmuster aus zwei aufeinanderfolgenden Candlesticks.
Das Homing-Pigeon-Muster besteht aus zwei langen schwarzen (bearischen) Kerzen, wobei die zweite Kerze vollständig innerhalb des Körpers der ersten liegt. Dieses Muster deutet darauf hin, dass die Abwärtsdynamik nachlässt und eine mögliche Trendumkehr nach oben bevorstehen könnte.
Der Rückgabewert ist ein Array mit denselben Indizes wie die Eingabedaten. An jeder Position, an der das Muster erkannt wurde, steht der Wert 100 (bullisches Signal) oder -100 (bearisches Signal). Positionen ohne erkanntes Muster erhalten den Wert 0. Die ersten Einträge des Arrays können leer sein, da die Musterkennung mindestens zwei Datenpunkte benötigt.
Diese Funktion ist besonders nützlich in der technischen Analyse von Börsenkursen, wenn man automatisiert nach bullischen Umkehrsignalen in einem Abwärtstrend sucht.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $open Pflicht | array | Array der Eröffnungskurse (numerisch indiziert, chronologisch sortiert). | |
| $high Pflicht | array | Array der Tageshöchstkurse (numerisch indiziert, chronologisch sortiert). | |
| $low Pflicht | array | Array der Tagestiefstkurse (numerisch indiziert, chronologisch sortiert). | |
| $close Pflicht | array | Array der Schlusskurse (numerisch indiziert, chronologisch sortiert). |
Rückgabewert
100 (bullisch) oder -100 (bearisch) enthalten, an allen anderen Positionen 0. Im Fehlerfall (z. B. Arrays unterschiedlicher Länge oder fehlende Trader-Extension) wird false zurückgegeben.Beispiele
Homing-Pigeon-Muster in historischen Kursdaten erkennen
<?php
// Beispielhafte OHLC-Daten (chronologisch)
$open = [50.0, 48.0, 45.0, 43.0, 42.5];
$high = [51.0, 49.5, 46.0, 44.0, 43.5];
$low = [47.0, 45.0, 42.0, 41.5, 42.0];
$close = [47.5, 45.5, 42.5, 42.0, 42.3];
$result = trader_cdlhomingpigeon($open, $high, $low, $close);
if ($result === false) {
echo "Fehler bei der Musterkennung oder Trader-Extension nicht verfügbar.";
} else {
foreach ($result as $index => $signal) {
if ($signal !== 0) {
$typ = $signal > 0 ? 'Bullisch' : 'Bearisch';
echo "Homing-Pigeon-Muster erkannt an Index {$index}: {$typ} (Wert: {$signal})\n";
}
}
if (array_sum(array_map('abs', $result)) === 0) {
echo "Kein Homing-Pigeon-Muster in den Daten gefunden.\n";
}
}Mustererkennung über einen längeren Datensatz mit Ausgabe aller Signale
<?php
// Realitätsnähere Datenmenge aus einer CSV-Datei laden
$data = array_map('str_getcsv', file('kursdaten.csv'));
$open = array_column($data, 0);
$high = array_column($data, 1);
$low = array_column($data, 2);
$close = array_column($data, 3);
$signale = trader_cdlhomingpigeon($open, $high, $low, $close);
if (is_array($signale)) {
$treffer = array_filter($signale, fn($v) => $v !== 0);
echo "Gefundene Homing-Pigeon-Muster: " . count($treffer) . "\n";
foreach ($treffer as $idx => $wert) {
echo " Index $idx => Signal: $wert (Close: {$close[$idx]})\n";
}
} else {
echo "Fehler: Musterkennung fehlgeschlagen.\n";
}// Wichtig · Fallstricke
Voraussetzung: Die Funktion ist nur verfügbar, wenn die PECL-Erweiterung trader installiert und aktiviert ist (pecl install trader). Sie ist nicht Teil der PHP-Standardbibliothek.
Array-Längen: Alle vier Eingabe-Arrays müssen exakt dieselbe Länge haben, andernfalls gibt die Funktion false zurück oder liefert unerwartete Ergebnisse.
Rückgabe-Indizierung: Das Ergebnis-Array beginnt typischerweise nicht bei Index 0 mit einem gültigen Wert, da für die Erkennung mindestens 2 Datenpunkte nötig sind. Die ersten Einträge können fehlen oder 0 sein.
Interpretation: Ein Signal von 100 bedeutet ein erkanntes bullisches Homing-Pigeon-Muster. Dieses sollte stets im Kontext anderer Indikatoren und des übergeordneten Trends bewertet werden – keine Trading-Entscheidung allein auf Basis eines einzelnen Candlestick-Musters treffen.