fann_get_quickprop_mu — Funktion · PHP-Referenz

Signatur

fann_get_quickprop_mu(resource $ann): float

Beschreibung

fann_get_quickprop_mu liest den aktuellen Mu-Faktor aus einem mit der FANN-Bibliothek (Fast Artificial Neural Network) erstellten neuronalen Netz aus. Der Mu-Faktor ist ein Skalierungsfaktor, der beim Quickprop-Lernalgorithmus bestimmt, wie stark die Gewichtsänderungen skaliert werden dürfen.

Quickprop ist ein beschleunigter Backpropagation-Algorithmus, der quadratische Approximationen der Fehlerfläche verwendet, um schneller zum Minimum zu konvergieren. Der Mu-Wert wirkt dabei als Sicherheitsschranke: Er begrenzt, um welchen maximalen Faktor der vorherige Schritt skaliert werden darf. Ein typischer Standardwert ist 1.75.

Diese Funktion ist nützlich, um den aktuell konfigurierten Mu-Wert zu prüfen, bevor oder nachdem er mit fann_set_quickprop_mu verändert wurde. Sie wird vor allem beim Feintuning von Trainingsparametern in neuronalen Netzen eingesetzt.

Die FANN-Erweiterung muss installiert und aktiviert sein. Sie steht über die FANN PHP-Erweiterung zur Verfügung.

Parameter

Name	Typ	Default	Beschreibung
$ann Pflicht	resource		Eine gültige FANN-Ressource, die mit Funktionen wie `fann_create_standard` oder ähnlichen Erstellungsfunktionen erzeugt wurde.

Rückgabewert

Typ

float

Beschreibung

Gibt den aktuellen Mu-Faktor als Gleitkommazahl zurück. Im Fehlerfall wird false zurückgegeben.

Beispiele

Aktuellen Mu-Faktor eines neuronalen Netzes auslesen

<?php
// Neuronales Netz erstellen: 2 Eingaben, 1 versteckte Schicht mit 3 Neuronen, 1 Ausgabe
$ann = fann_create_standard(3, 2, 3, 1);

if ($ann) {
    // Standard-Mu-Faktor ausgeben
    $mu = fann_get_quickprop_mu($ann);
    echo "Aktueller Quickprop Mu-Faktor: " . $mu . PHP_EOL;

    fann_destroy($ann);
} else {
    echo "Fehler beim Erstellen des neuronalen Netzes." . PHP_EOL;
}

Aktueller Quickprop Mu-Faktor: 1.75

Mu-Faktor setzen und anschließend prüfen

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

if ($ann) {
    // Mu-Faktor anpassen
    fann_set_quickprop_mu($ann, 2.0);

    // Geänderten Wert auslesen und bestätigen
    $mu = fann_get_quickprop_mu($ann);
    echo "Neuer Quickprop Mu-Faktor: " . $mu . PHP_EOL;

    fann_destroy($ann);
}

Neuer Quickprop Mu-Faktor: 2

// Wichtig · Fallstricke

Hinweis: Der Mu-Faktor ist nur relevant, wenn als Trainingsalgorithmus FANN_TRAIN_QUICKPROP verwendet wird. Bei anderen Algorithmen wie FANN_TRAIN_RPROP oder FANN_TRAIN_BACKPROP hat dieser Wert keine Auswirkung auf das Training.

Zu hohe Mu-Werte können dazu führen, dass das Training instabil wird und die Gewichte divergieren. Es empfiehlt sich, den Standardwert von 1.75 nur mit Bedacht zu verändern.

Diese Funktion steht nur zur Verfügung, wenn die PHP-FANN-Erweiterung installiert ist (pecl install fann).

Siehe auch

fann_set_quickprop_mu fann_get_quickprop_decay fann_set_quickprop_decay fann_get_training_algorithm fann_set_training_algorithm fann_create_standard