fann_get_cascade_weight_multiplier — Funktion · PHP-Referenz

Signatur

fann_get_cascade_weight_multiplier(resource $ann): float

Beschreibung

fann_get_cascade_weight_multiplier liest den aktuellen Gewichtsmultiplikator eines FANN-Neuronalen Netzes aus. Dieser Wert wird beim Cascade-Correlation-Algorithmus eingesetzt und bestimmt, wie stark die Gewichte der Kandidaten-Neuronen beim Hinzufügen zur Netzwerkstruktur skaliert werden.

Beim Cascade-Correlation-Training werden neue Neuronen schrittweise in das Netz integriert. Bevor ein Kandidaten-Neuron vollständig in das Netz aufgenommen wird, werden seine Gewichte mit dem Gewichtsmultiplikator multipliziert. Ein typischer Standardwert ist 0.4. Kleinere Werte stabilisieren das Training, während größere Werte die initiale Stärke der neuen Verbindungen erhöhen.

Diese Funktion gehört zur FANN-Erweiterung (Fast Artificial Neural Network Library) für PHP. Sie ist besonders nützlich, wenn man das Verhalten des Cascade-Trainings analysieren oder protokollieren möchte, bevor Parameter angepasst werden.

Zum Setzen des Gewichtsmultiplikators kann die Funktion fann_set_cascade_weight_multiplier verwendet werden.

Parameter

Name	Typ	Default	Beschreibung
$ann Pflicht	resource		Eine gültige FANN-Netzwerk-Ressource, die zuvor mit einer der `fann_create_*`-Funktionen erstellt wurde.

Rückgabewert

Typ

float

Beschreibung

Gibt den aktuellen Gewichtsmultiplikator als Gleitkommazahl zurück. Im Fehlerfall (z. B. bei einer ungültigen Ressource) wird false zurückgegeben.

Beispiele

Gewichtsmultiplikator eines FANN-Netzes auslesen

<?php
// Einfaches Feedforward-Netz erstellen: 2 Eingabe-, 3 versteckte, 1 Ausgabe-Neuron
$ann = fann_create_standard(3, 2, 3, 1);

if ($ann) {
    $multiplier = fann_get_cascade_weight_multiplier($ann);
    echo "Aktueller Gewichtsmultiplikator: " . $multiplier . PHP_EOL;
    fann_destroy($ann);
} else {
    echo "Fehler beim Erstellen des neuronalen Netzes." . PHP_EOL;
}
?>

Aktueller Gewichtsmultiplikator: 0.4

Gewichtsmultiplikator auslesen und anpassen

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

if ($ann) {
    $vorher = fann_get_cascade_weight_multiplier($ann);
    echo "Gewichtsmultiplikator vorher: " . $vorher . PHP_EOL;

    // Neuen Wert setzen
    fann_set_cascade_weight_multiplier($ann, 0.5);

    $nachher = fann_get_cascade_weight_multiplier($ann);
    echo "Gewichtsmultiplikator nachher: " . $nachher . PHP_EOL;

    fann_destroy($ann);
}
?>

Gewichtsmultiplikator vorher: 0.4 Gewichtsmultiplikator nachher: 0.5

// Wichtig · Fallstricke

Hinweis: Die FANN-Erweiterung ist nicht standardmäßig in PHP enthalten und muss separat installiert bzw. kompiliert werden. Stellen Sie sicher, dass die Erweiterung geladen ist (extension=fann.so bzw. fann.dll).

Der Gewichtsmultiplikator wirkt sich nur beim Cascade-Correlation-Training aus. Bei anderen Trainingsverfahren (z. B. Backpropagation mit Standard-Netzen) hat dieser Parameter keine Bedeutung. Werte außerhalb des sinnvollen Bereichs (typischerweise 0.1 bis 1.0) können das Training destabilisieren.

Siehe auch

fann_set_cascade_weight_multiplier fann_get_cascade_candidate_limit fann_get_cascade_num_candidate_groups fann_create_standard fann_cascadetrain_on_data