Start · Sprachen · PHP · Referenz · fann_get_cascade_min_out_epochs

fann_get_cascade_min_out_epochs

Funktion

Gibt die minimale Anzahl der Ausgabe-Epochen (Output-Epochen) zurück, die beim Cascade-Correlation-Training verwendet werden.

seit PHP 5.0.0 Kategorie: misc

Signatur

fann_get_cascade_min_out_epochs(resource $ann): int

Beschreibung

fann_get_cascade_min_out_epochs() liefert die aktuell eingestellte minimale Anzahl von Ausgabe-Epochen für das Cascade-Correlation-Lernverfahren eines neuronalen Netzes. Dieser Wert bestimmt, wie viele Trainingsiterationen mindestens auf die Ausgabe-Verbindungen angewendet werden, bevor der Algorithmus prüft, ob das Training der Ausgabeschicht beendet werden kann.

Cascade-Correlation ist ein konstruktives Lernverfahren, das schrittweise neue verdeckte Neuronen zum Netzwerk hinzufügt. Der Trainingsablauf ist dabei in zwei Phasen unterteilt: Das Training der Kandidatenneuronen (Input-Phase) und das Training der Ausgabe-Verbindungen (Output-Phase). Der Parameter für minimale Ausgabe-Epochen steuert die Output-Phase.

Ein höherer Wert für die minimalen Ausgabe-Epochen kann zu einer stabileren Konvergenz führen, verlängert jedoch die Trainingszeit. Der Standardwert beträgt typischerweise 50. Mit fann_set_cascade_min_out_epochs() lässt sich dieser Wert anpassen.

Diese Funktion gehört zur FANN-Erweiterung (Fast Artificial Neural Network) und setzt voraus, dass die FANN-Bibliothek installiert und das Netz korrekt initialisiert wurde.

Parameter

Name Typ Default Beschreibung
$ann Pflicht resource Eine gültige FANN-Netzwerk-Ressource, die zuvor mit Funktionen wie fann_create_standard() oder fann_create_from_file() erzeugt wurde.

Rückgabewert

Typ
int
Beschreibung
Gibt die minimale Anzahl der Ausgabe-Epochen als Ganzzahl zurück. Im Fehlerfall (ungültige Ressource) wird false zurückgegeben.

Beispiele

Minimale Ausgabe-Epochen eines Netzes auslesen

<?php
// Neuronales Netz erstellen
$ann = fann_create_standard(3, 2, 3, 1);

if ($ann) {
    // Minimale Ausgabe-Epochen auslesen
    $min_out_epochs = fann_get_cascade_min_out_epochs($ann);
    echo "Minimale Ausgabe-Epochen: " . $min_out_epochs . PHP_EOL;

    fann_destroy($ann);
} else {
    echo "Fehler beim Erstellen des Netzes." . PHP_EOL;
}
?>
Minimale Ausgabe-Epochen: 50

Minimale Ausgabe-Epochen lesen und anpassen

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

if ($ann) {
    $aktuell = fann_get_cascade_min_out_epochs($ann);
    echo "Aktueller Wert: " . $aktuell . PHP_EOL;

    // Wert auf 100 erhöhen für stabileres Training
    fann_set_cascade_min_out_epochs($ann, 100);

    $neu = fann_get_cascade_min_out_epochs($ann);
    echo "Neuer Wert: " . $neu . PHP_EOL;

    fann_destroy($ann);
}
?>
Aktueller Wert: 50 Neuer Wert: 100

// Wichtig · Fallstricke

Diese Funktion steht nur zur Verfügung, wenn PHP mit der FANN-Erweiterung kompiliert wurde (ext/fann). Ohne diese Erweiterung führt der Aufruf zu einem fatalen Fehler. Überprüfe die Verfügbarkeit mit function_exists('fann_get_cascade_min_out_epochs').

Der Wert der minimalen Ausgabe-Epochen sollte stets kleiner oder gleich dem Wert der maximalen Ausgabe-Epochen (fann_get_cascade_max_out_epochs()) sein, da andernfalls das Training nicht korrekt funktioniert.