trader_sinh — Funktion · PHP-Referenz

Signatur

trader_sinh(array $real): array|false

Beschreibung

trader_sinh ist Teil der PHP-TRADER-Erweiterung, die technische Analyse-Funktionen aus der TA-Lib-Bibliothek bereitstellt. Die Funktion wendet die mathematische Formel des hyperbolischen Sinus (sinh(x) = (e^x − e^−x) / 2) auf jedes Element des übergebenen Arrays an und gibt ein neues Array mit den berechneten Werten zurück.

Typischerweise wird trader_sinh im Bereich der Finanzdatenanalyse eingesetzt, wenn Transformationen von Zeitreihendaten benötigt werden. Sie kann jedoch überall dort nützlich sein, wo eine vektorisierte Berechnung des hyperbolischen Sinus über ein Array von Gleitkommazahlen erforderlich ist.

Die Funktion arbeitet auf dem gesamten Eingabe-Array auf einmal, was sie effizienter macht als eine manuelle Schleife über die Werte. Die Indizierung des Rückgabe-Arrays entspricht derjenigen des Eingabe-Arrays.

Parameter

Name	Typ	Default	Beschreibung
$real Pflicht	array		Ein Array von Gleitkommazahlen (z. B. Schlusskurse oder andere numerische Zeitreihenwerte), für das der hyperbolische Sinus berechnet werden soll.

Rückgabewert

Typ

array|false

Beschreibung

Gibt ein Array mit den berechneten hyperbolischen Sinus-Werten zurück. Die Schlüssel entsprechen denen des Eingabe-Arrays. Bei einem Fehler (z. B. ungültige Eingabe) wird false zurückgegeben.

Beispiele

Hyperbolischen Sinus eines Datenarrays berechnen

<?php
// Beispiel-Array mit numerischen Werten (z. B. normierte Preisabweichungen)
$data = [0.0, 0.5, 1.0, 1.5, 2.0];

$result = trader_sinh($data);

if ($result !== false) {
    foreach ($result as $index => $value) {
        printf("sinh(%.1f) = %.6f\n", $data[$index], $value);
    }
} else {
    echo "Fehler bei der Berechnung.\n";
}

sinh(0.0) = 0.000000 sinh(0.5) = 0.521095 sinh(1.0) = 1.175201 sinh(1.5) = 2.129279 sinh(2.0) = 3.626860

Verwendung mit Finanzzeitreihen

<?php
// Simulierte tägliche Renditen einer Aktie
$returns = [-0.02, 0.01, 0.03, -0.01, 0.05];

$sinhValues = trader_sinh($returns);

if ($sinhValues !== false) {
    echo "Transformierte Renditen (sinh):\n";
    print_r($sinhValues);
} else {
    echo "Berechnung fehlgeschlagen.\n";
}

Transformierte Renditen (sinh): Array ( [0] => -0.020001333... [1] => 0.010000167... [2] => 0.030004500... [3] => -0.010000167... [4] => 0.050020835... )

// Wichtig · Fallstricke

Voraussetzung: Die TRADER-Erweiterung (pecl install trader) muss installiert und in der php.ini aktiviert sein (extension=trader). Ohne diese Erweiterung ist die Funktion nicht verfügbar.

Bei sehr großen Eingabewerten kann sinh schnell sehr große Ergebnisse liefern (exponentielles Wachstum), was zu numerischen Überläufen führen kann. Bei finanzmathematischen Anwendungen empfiehlt es sich, die Eingabewerte vorher zu normieren.

Nicht-numerische Werte im Eingabe-Array können zu false als Rückgabewert führen. Das Array sollte daher vor der Übergabe validiert werden.

Siehe auch

trader_cosh trader_tanh trader_sin trader_asin