inspect_clustered_componentsT_inspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components (Operator)
Name
inspect_clustered_componentsT_inspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components — überprüfen der im Training ermittelten starren Modellkomponenten.
Warnung
inspect_clustered_componentsinspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components ist veraltet und wird nur aus Gründen der
Rückwärtskompatibilität zur Verfügung gestellt.
Der Operator wird mit HALCON 26.11 entfernt.
Signatur
void InspectClusteredComponents(HObject* ModelComponents, const HTuple& ComponentTrainingID, const HTuple& AmbiguityCriterion, const HTuple& MaxContourOverlap, const HTuple& ClusterThreshold)
HRegion HComponentTraining::InspectClusteredComponents(const HString& AmbiguityCriterion, double MaxContourOverlap, double ClusterThreshold) const
HRegion HComponentTraining::InspectClusteredComponents(const char* AmbiguityCriterion, double MaxContourOverlap, double ClusterThreshold) const
HRegion HComponentTraining::InspectClusteredComponents(const wchar_t* AmbiguityCriterion, double MaxContourOverlap, double ClusterThreshold) const
(
Nur Windows)
Beschreibung
inspect_clustered_componentsinspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components erzeugt eine Repräsentation der
starren Modellkomponenten in Form von Konturregionen, auf Grundlage
des Trainingsergebnisses ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id. Die
resultierenden starren Modellkomponenten werden in Abhängigkeit des
Kriteriums zur Lösung der Mehrdeutigkeiten
AmbiguityCriterionAmbiguityCriterionAmbiguityCriterionambiguityCriterionambiguity_criterion, der maximalen Konturüberlappung
MaxContourOverlapMaxContourOverlapMaxContourOverlapmaxContourOverlapmax_contour_overlap und des Cluster-Schwellenwertes
ClusterThresholdClusterThresholdClusterThresholdclusterThresholdcluster_threshold berechnet (siehe
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components). Der Cluster-Schwellenwert beschreibt
zum Beispiel das Maß, in dem initiale Komponenten zu starren
Modellkomponenten zusammengefasst werden. Je größer der
Cluster-Schwellenwert gewählt wird, desto weniger Zusammenschlüsse
finden statt. Die ermittelten starren Modellkomponenten werden in
ModelComponentsModelComponentsModelComponentsmodelComponentsmodel_components zurückgeliefert.
Mit Hilfe von inspect_clustered_componentsinspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components ist es damit
möglich, nach einmaligem Trainieren der Komponenten mit
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components die Auswirkungen verschiedener Werte
der Parameter AmbiguityCriterionAmbiguityCriterionAmbiguityCriterionambiguityCriterionambiguity_criterion, MaxContourOverlapMaxContourOverlapMaxContourOverlapmaxContourOverlapmax_contour_overlap
und ClusterThresholdClusterThresholdClusterThresholdclusterThresholdcluster_threshold auf die Bildung der starren
Modellkomponenten abzuschätzen, ohne das komplette Training mehrmals
durchführen zu müssen. Sind die gewünschten Parameterwerte gefunden,
können diese effizient in das Trainingsergebnis mit
cluster_model_componentscluster_model_componentsClusterModelComponentsClusterModelComponentscluster_model_components übernommen werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
ModelComponentsModelComponentsModelComponentsmodelComponentsmodel_components (output_object) region(-array) → objectHRegionHObjectHObjectHobject *
Konturregionen der starren Modellkomponenten.
ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id (input_control) component_training → HComponentTraining, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Trainingsergebnisses.
AmbiguityCriterionAmbiguityCriterionAmbiguityCriterionambiguityCriterionambiguity_criterion (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Kriterium zur Lösung der Mehrdeutigkeiten.
Default:
'rigidity'
"rigidity"
"rigidity"
"rigidity"
"rigidity"
Werteliste:
'distance'"distance""distance""distance""distance", 'distance_orientation'"distance_orientation""distance_orientation""distance_orientation""distance_orientation", 'orientation'"orientation""orientation""orientation""orientation", 'rigidity'"rigidity""rigidity""rigidity""rigidity"
MaxContourOverlapMaxContourOverlapMaxContourOverlapmaxContourOverlapmax_contour_overlap (input_control) real → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Maximale Konturüberlappung gefundener initialer
Komponenten.
Default:
0.2
Wertevorschläge:
0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0
Minimale Schrittweite:
0.01
Empfohlene Schrittweite:
0.05
Restriktion:
0 <= MaxContourOverlap && MaxContourOverlap <= 1
ClusterThresholdClusterThresholdClusterThresholdclusterThresholdcluster_threshold (input_control) real → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Schwellenwert für das Zusammenfassen initialer
Komponenten.
Default:
0.5
Wertevorschläge:
0.0, 0.1, 0.2, 0.3, 0.4, 0.5, 0.6, 0.7, 0.8, 0.9, 1.0
Restriktion:
0 <= ClusterThreshold && ClusterThreshold <= 1
Ergebnis
Ist der Handle des Trainingsergebnisses gültig, dann liefert
inspect_clustered_componentsinspect_clustered_componentsInspectClusteredComponentsInspectClusteredComponentsinspect_clustered_components den Wert 2 (
H_MSG_TRUE)
.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Modul
Matching