fann_get_cascade_min_cand_epochs — Funktion · PHP-Referenz

Signatur

fann_get_cascade_min_cand_epochs(resource $ann): int

Beschreibung

fann_get_cascade_min_cand_epochs liest den aktuell eingestellten Wert für die minimale Anzahl der Trainings-Epochen aus, die für Kandidaten-Neuronen während des Cascade-Correlation-Trainings (Cascade2) durchgeführt werden müssen, bevor ein Kandidat ausgewählt werden kann.

Beim Cascade-Correlation-Algorithmus werden Kandidaten-Neuronen in einem separaten Pool trainiert. Der Parameter min_cand_epochs legt die Untergrenze der Trainingszyklen für diese Kandidaten fest. Er verhindert, dass ein Kandidat zu früh – also bevor er ausreichend trainiert wurde – in das Netz eingefügt wird.

Der Standardwert ist 50. Mit fann_set_cascade_min_cand_epochs kann dieser Wert angepasst werden. Ein zu kleiner Wert kann dazu führen, dass unzureichend trainierte Neuronen ins Netz übernommen werden; ein zu großer Wert erhöht die Trainingszeit erheblich.

Diese Funktion gehört zur FANN-Erweiterung (Fast Artificial Neural Network Library) und setzt eine gültige, mit fann_create_standard oder ähnlichen Funktionen erstellte Netzwerk-Ressource voraus.

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

int

Beschreibung

Gibt die minimale Anzahl der Kandidaten-Epochen als ganzzahligen Wert zurück. Im Fehlerfall (ungültige Ressource) wird false zurückgegeben.

Beispiele

Aktuellen Wert auslesen und ausgeben

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

if ($ann) {
    $minEpochs = fann_get_cascade_min_cand_epochs($ann);
    echo "Minimale Kandidaten-Epochen: " . $minEpochs . PHP_EOL;
    fann_destroy($ann);
} else {
    echo "Fehler beim Erstellen des Netzwerks." . PHP_EOL;
}
?>

Minimale Kandidaten-Epochen: 50

Wert setzen und anschließend verifizieren

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

if ($ann) {
    // Minimale Kandidaten-Epochen auf 100 setzen
    fann_set_cascade_min_cand_epochs($ann, 100);

    // Gesetzten Wert auslesen und prüfen
    $minEpochs = fann_get_cascade_min_cand_epochs($ann);
    echo "Gesetzter Wert: " . $minEpochs . PHP_EOL;

    fann_destroy($ann);
}
?>

Gesetzter Wert: 100

// Wichtig · Fallstricke

Erweiterung erforderlich: Diese Funktion ist nur verfügbar, wenn die FANN-Erweiterung (ext/fann) installiert und aktiviert ist. Sie ist nicht Bestandteil der PHP-Standardinstallation.

Nur für Cascade-Training: Dieser Parameter hat nur Auswirkungen, wenn das Netzwerk mit fann_cascadetrain_on_data oder fann_cascadetrain_on_file trainiert wird. Beim normalen Backpropagation-Training wird er ignoriert.

Der Wert muss kleiner oder gleich dem Wert von fann_get_cascade_max_cand_epochs sein, da sonst unerwartetes Verhalten auftreten kann.

Siehe auch

fann_set_cascade_min_cand_epochs fann_get_cascade_max_cand_epochs fann_set_cascade_max_cand_epochs fann_cascadetrain_on_data fann_create_standard