Signatur
Beschreibung
fann_get_cascade_candidate_limit liest den aktuell gesetzten Kandidaten-Grenzwert (candidate limit) eines neuronalen Netzes aus, das mit der FANN-Bibliothek (Fast Artificial Neural Network) erstellt wurde. Dieser Wert ist ein Bestandteil des Cascade-Correlation-Trainingsalgorithmus.
Der Kandidaten-Grenzwert bestimmt, wie stark die Aktivierung eines Kandidaten-Neurons maximal werden darf. Ist der Ausgabewert eines Kandidatenneurons betragsmäßig größer als dieser Grenzwert, wird der Kandidat bei der Auswahl ignoriert. Dies verhindert, dass Neuronen mit extremen Ausgabewerten in das Netzwerk aufgenommen werden, was die Trainingsqualität negativ beeinflussen könnte.
Der Standardwert ist typischerweise 1000.0. Mit fann_set_cascade_candidate_limit lässt sich der Wert anpassen. Die Funktion ist nur verfügbar, wenn die PHP-Erweiterung fann installiert ist.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $ann Pflicht | resource | Eine gültige FANN-Netzwerk-Ressource, die zuvor mit einer der fann_create_*-Funktionen erzeugt wurde. |
Rückgabewert
false bei einem Fehler (z. B. ungültige Ressource).Beispiele
Kandidaten-Grenzwert eines FANN-Netzes auslesen
<?php
// Einfaches neuronales Netz erstellen: 2 Eingänge, 1 versteckte Schicht, 1 Ausgang
$ann = fann_create_standard(3, 2, 3, 1);
if ($ann) {
$candidateLimit = fann_get_cascade_candidate_limit($ann);
echo "Aktueller Kandidaten-Grenzwert: " . $candidateLimit . PHP_EOL;
fann_destroy($ann);
} else {
echo "Fehler beim Erstellen des Netzwerks." . PHP_EOL;
}Kandidaten-Grenzwert setzen und anschließend auslesen
<?php
$ann = fann_create_standard(3, 2, 3, 1);
if ($ann) {
// Neuen Kandidaten-Grenzwert setzen
fann_set_cascade_candidate_limit($ann, 500.0);
// Gesetzten Wert zur Überprüfung auslesen
$candidateLimit = fann_get_cascade_candidate_limit($ann);
echo "Neuer Kandidaten-Grenzwert: " . $candidateLimit . PHP_EOL;
fann_destroy($ann);
}// Wichtig · Fallstricke
Die fann-Erweiterung ist nicht standardmäßig in PHP enthalten und muss separat installiert werden (z. B. über PECL: pecl install fann). Der Kandidaten-Grenzwert ist nur für das Cascade-Correlation-Training relevant — bei anderen Trainingsalgorithmen hat dieser Wert keine Auswirkung. Ein zu niedrig gewählter Grenzwert kann dazu führen, dass kaum geeignete Kandidatenneuronen gefunden werden, was das Training erheblich verlangsamt oder erschwert.