Signatur
Beschreibung
fann_get_cascade_num_candidate_groups liefert die aktuelle Anzahl der Kandidatengruppen, die während des Cascade-Correlation-Trainings eingesetzt werden. Cascade Correlation ist ein spezieller Trainingsalgorithmus, bei dem schrittweise neue Neuronen zum Netzwerk hinzugefügt werden, um die Fehlerrate zu minimieren.
Die Kandidatengruppen legen fest, wie viele verschiedene Gruppen von Kandidatenneuronen gleichzeitig trainiert werden. Eine höhere Anzahl an Kandidatengruppen kann die Qualität der hinzugefügten Neuronen verbessern, erhöht jedoch auch den Rechenaufwand. Der Standardwert ist in der Regel 2.
Diese Funktion wird typischerweise in Kombination mit fann_set_cascade_num_candidate_groups und anderen Cascade-bezogenen Einstellungen verwendet, um das Trainingsverhalten des neuronalen Netzes zu konfigurieren und zu überwachen.
Die FANN-Erweiterung (Fast Artificial Neural Network) muss dafür installiert und aktiviert sein. Ab PHP 8.0 wurde die prozeduale API durch eine objektorientierte Variante ergänzt.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $ann Pflicht | resource | Eine FANN-Netzwerk-Ressource, die zuvor mit einer Funktion wie fann_create_standard erstellt wurde. |
Rückgabewert
false zurückgegeben.Beispiele
Aktuelle Kandidatengruppen abfragen
<?php
// Erstellt ein einfaches neuronales Netz mit 2 Eingängen, 1 versteckter Schicht und 1 Ausgang
$ann = fann_create_standard(3, 2, 3, 1);
if ($ann) {
$num_groups = fann_get_cascade_num_candidate_groups($ann);
echo "Anzahl der Kandidatengruppen: " . $num_groups . PHP_EOL;
fann_destroy($ann);
} else {
echo "Fehler beim Erstellen des neuronalen Netzes." . PHP_EOL;
}Kandidatengruppen setzen und überprüfen
<?php
$ann = fann_create_standard(3, 2, 4, 1);
if ($ann) {
// Anzahl der Kandidatengruppen auf 4 erhöhen
fann_set_cascade_num_candidate_groups($ann, 4);
// Gesetzten Wert zurücklesen
$num_groups = fann_get_cascade_num_candidate_groups($ann);
echo "Gesetzte Kandidatengruppen: " . $num_groups . PHP_EOL;
fann_destroy($ann);
}// Wichtig · Fallstricke
Hinweis: Diese Funktion ist nur verfügbar, wenn die FANN-Erweiterung (php-fann) installiert und geladen ist. Sie steht nicht in der Standard-PHP-Installation zur Verfügung und muss separat kompiliert oder als Paket installiert werden.
Die Anzahl der Kandidatengruppen beeinflusst direkt die Trainingszeit und die Netzwerkqualität beim Cascade-Correlation-Training. Ein zu hoher Wert kann zu deutlich längeren Trainingszeiten führen, ohne dass eine proportionale Verbesserung der Genauigkeit erzielt wird.