Signatur
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
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;
}
?>
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);
}
?>
// 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').