Start · Sprachen · PHP · Referenz · fann_get_rprop_decrease_factor

fann_get_rprop_decrease_factor

Funktion

Liefert den Verminderungsfaktor (Decrease Factor), der beim RPROP-Training eines neuronalen Netzes verwendet wird.

Kategorie: misc

Signatur

fann_get_rprop_decrease_factor(resource $ann): float

Beschreibung

fann_get_rprop_decrease_factor gibt den aktuell konfigurierten Verminderungsfaktor für den RPROP-Lernalgorithmus (Resilient Backpropagation) zurück. Dieser Faktor bestimmt, um wie viel die Schrittweite (Step Size) eines Gewichts reduziert wird, wenn sich das Vorzeichen des Gradienten zwischen zwei aufeinanderfolgenden Trainingsiterationen ändert – was auf eine Überschreitung des Optimums hindeutet.

RPROP ist ein adaptiver Gradientenabstiegs-Algorithmus, der die Größe der Gewichtsänderungen individuell für jedes Gewicht anpasst. Der Verminderungsfaktor liegt typischerweise zwischen 0 und 1 (Standard: 0.5). Ein kleinerer Wert führt zu aggressiveren Korrekturen, während ein Wert nahe 1 das Training weniger reaktionsfähig macht.

Diese Funktion ist nützlich, wenn man die aktuellen Trainingsparameter eines neuronalen Netzes auslesen und ggf. protokollieren oder anpassen möchte. Der zugehörige Setter ist fann_set_rprop_decrease_factor.

Die Funktion gehört zur FANN-Erweiterung (Fast Artificial Neural Network Library) für PHP und setzt voraus, dass diese Erweiterung installiert und aktiviert ist.

Parameter

Name Typ Default Beschreibung
$ann Pflicht resource Eine gültige FANN-Ressource, die zuvor mit fann_create_standard oder einer ähnlichen Funktion erstellt wurde.

Rückgabewert

Typ
float
Beschreibung
Gibt den aktuellen RPROP-Verminderungsfaktor als Gleitkommazahl zurück. Im Fehlerfall (ungültige Ressource) wird false zurückgegeben.

Beispiele

Verminderungsfaktor eines neuronalen Netzes ausgeben

<?php
// Erstelle ein einfaches vorwärtsgekoppeltes neuronales Netz
// mit 2 Eingaben, 3 versteckten Neuronen und 1 Ausgabe
$ann = fann_create_standard(3, 2, 3, 1);

if ($ann) {
    $decreaseFactor = fann_get_rprop_decrease_factor($ann);
    echo "RPROP Verminderungsfaktor: " . $decreaseFactor . PHP_EOL;

    fann_destroy($ann);
} else {
    echo "Fehler beim Erstellen des neuronalen Netzes." . PHP_EOL;
}
?>
RPROP Verminderungsfaktor: 0.5

Verminderungsfaktor setzen und zurücklesen

<?php
$ann = fann_create_standard(3, 2, 4, 1);

if ($ann) {
    // Neuen Verminderungsfaktor setzen
    fann_set_rprop_decrease_factor($ann, 0.6);

    // Gesetzten Wert zur Überprüfung auslesen
    $factor = fann_get_rprop_decrease_factor($ann);
    echo "Gesetzter RPROP Verminderungsfaktor: " . $factor . PHP_EOL;

    fann_destroy($ann);
}
?>
Gesetzter RPROP Verminderungsfaktor: 0.6

// Wichtig · Fallstricke

Hinweis: Der RPROP-Verminderungsfaktor sollte einen Wert zwischen 0 (exklusiv) und 1 (exklusiv) haben. Werte außerhalb dieses Bereichs können das Training destabilisieren oder zum Stillstand bringen. Der Standardwert ist 0.5.

Diese Funktion steht nur zur Verfügung, wenn die FANN-Erweiterung (php-fann) kompiliert und geladen ist. Auf vielen Standardinstallationen ist sie nicht aktiviert; überprüfe dies mit extension_loaded('fann').