get_training_componentsT_get_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components (Operator)
Name
get_training_componentsT_get_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components — Liefert die initialen Komponenten oder die Modellkomponenten in einem
bestimmten Bild zurück.
Warnung
get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components ist veraltet und wird nur aus Gründen der
Rückwärtskompatibilität zur Verfügung gestellt.
Signatur
void GetTrainingComponents(HObject* TrainingComponents, const HTuple& ComponentTrainingID, const HTuple& Components, const HTuple& Image, const HTuple& MarkOrientation, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Score)
HRegion HComponentTraining::GetTrainingComponents(const HTuple& Components, const HTuple& Image, const HString& MarkOrientation, HTuple* Row, HTuple* Column, HTuple* Angle, HTuple* Score) const
HRegion HComponentTraining::GetTrainingComponents(const HString& Components, const HString& Image, const HString& MarkOrientation, double* Row, double* Column, double* Angle, double* Score) const
HRegion HComponentTraining::GetTrainingComponents(const char* Components, const char* Image, const char* MarkOrientation, double* Row, double* Column, double* Angle, double* Score) const
HRegion HComponentTraining::GetTrainingComponents(const wchar_t* Components, const wchar_t* Image, const wchar_t* MarkOrientation, double* Row, double* Column, double* Angle, double* Score) const
(
Nur Windows)
static void HOperatorSet.GetTrainingComponents(out HObject trainingComponents, HTuple componentTrainingID, HTuple components, HTuple image, HTuple markOrientation, out HTuple row, out HTuple column, out HTuple angle, out HTuple score)
HRegion HComponentTraining.GetTrainingComponents(HTuple components, HTuple image, string markOrientation, out HTuple row, out HTuple column, out HTuple angle, out HTuple score)
HRegion HComponentTraining.GetTrainingComponents(string components, string image, string markOrientation, out double row, out double column, out double angle, out double score)
def get_training_components(component_training_id: HHandle, components: Union[str, int], image: Union[str, int], mark_orientation: str) -> Tuple[HObject, Sequence[float], Sequence[float], Sequence[float], Sequence[float]]
def get_training_components_s(component_training_id: HHandle, components: Union[str, int], image: Union[str, int], mark_orientation: str) -> Tuple[HObject, float, float, float, float]
Beschreibung
get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components liefert alle initialen Komponenten
(wenn ComponentsComponentsComponentscomponentscomponents = 'initial_components'"initial_components""initial_components""initial_components""initial_components") oder
alle Modellkomponenten (wenn ComponentsComponentsComponentscomponentscomponents =
'model_components'"model_components""model_components""model_components""model_components") in Form von Konturregionen in
TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components sowie in numerischer Form
zurück. Alternativ dazu können durch direkte Angabe des Index einer
initialen Komponente alle deren gefundenen Lagen (d.h. vor
Auflösung der Mehrdeutigkeiten in train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components)
erhalten werden.
Die Lage der zurückgelieferten Komponenten entspricht deren Lage im
Modellbild (wenn ImageImageImageimageimage = 'model_image'"model_image""model_image""model_image""model_image" oder
ImageImageImageimageimage = 0) oder in einem Trainingsbild (wenn
ImageImageImageimageimage >= 1). Um die Komponenten in der
Lage zu erhalten, in der sie im iten Trainingsbild gefunden
wurden, muss ImageImageImageimageimage auf i gesetzt werden. Darüber
hinaus kann es bei rotationssymmetrischen Komponenten hilfreich
sein, deren Orientierung im jeweiligen Bild zu markieren. Dies kann
erreicht werden, indem MarkOrientationMarkOrientationMarkOrientationmarkOrientationmark_orientation auf 'true'"true""true""true""true"
gesetzt wird. In diesem Fall wird die Konturregion der jeweiligen
Komponente an ihrem Referenzpunkt durch einen Pfeil ergänzt, der in
die Referenzrichtung zeigt. Die Referenzrichtung einer Komponente
ergibt sich aus deren Orientierung im Modellbild und wird
beschrieben durch einen vom Referenzpunkt horizontal nach rechts
zeigenden Pfeil.
Zusätzlich zu den Konturregionen wird auch die Lage und die
Bewertung aller gefundenen Komponenten in RowRowRowrowrow,
ColumnColumnColumncolumncolumn, AngleAngleAngleangleangle und ScoreScoreScorescorescore zurückgeliefert
(siehe find_shape_modelfind_shape_modelFindShapeModelFindShapeModelfind_shape_model). Wurde für ComponentsComponentsComponentscomponentscomponents
'initial_components'"initial_components""initial_components""initial_components""initial_components" bzw. 'model_components'"model_components""model_components""model_components""model_components"
gewählt, so enthalten die Tupel TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components,
RowRowRowrowrow, ColumnColumnColumncolumncolumn, AngleAngleAngleangleangle und ScoreScoreScorescorescore
immer die gleiche Anzahl an Elementen wie initiale Komponenten
bzw. Modellkomponenten in ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id enthalten
sind. Wurde eine Komponente im Bild nicht gefunden, so wird für
TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components eine leere Region und für die
Ausgabe-Steuerparameter jeweils 0 als Wert
zurückgeliefert. Wurde für ComponentsComponentsComponentscomponentscomponents dagegen der Index
einer initialen Komponente übergeben, so enthalten die genannten
Tupel genauso viele Elemente wie Matches der jeweiligen initialen
Komponente im Bild gefunden wurden.
Der Operator get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components kann dazu genutzt
werden, das Ergebnis ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id des mit
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components durchgeführten Trainings zu
visualisieren. Damit ist es möglich, die Eignung der Trainingsbilder
einzuschätzen oder auch die Parameterwahl von
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components zu überprüfen. Eventuell kann es
sinnvoll sein, mit einem veränderten Satz von Trainingsbildern oder
nach Justieren der Parameter das Training mit
train_model_componentstrain_model_componentsTrainModelComponentsTrainModelComponentstrain_model_components erneut durchzuführen.
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
TrainingComponentsTrainingComponentsTrainingComponentstrainingComponentstraining_components (output_object) region(-array) → objectHRegionHObjectHObjectHobject *
Konturregionen der initialen Komponenten oder der
Modellkomponenten.
ComponentTrainingIDComponentTrainingIDComponentTrainingIDcomponentTrainingIDcomponent_training_id (input_control) component_training → HComponentTraining, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Trainingsergebnisses.
ComponentsComponentsComponentscomponentscomponents (input_control) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Art der zurückgelieferten Komponenten oder Index
der initialen Komponente.
Default:
'model_components'
"model_components"
"model_components"
"model_components"
"model_components"
Wertevorschläge:
'model_components'"model_components""model_components""model_components""model_components", 'initial_components'"initial_components""initial_components""initial_components""initial_components", 0, 1, 2, 3, 4, 5
ImageImageImageimageimage (input_control) string → HTupleUnion[str, int]HTupleHtuple (string / integer) (string / int / long) (HString / Hlong) (char* / Hlong)
Bild, für das die Komponenten zurückgeliefert
werden sollen.
Default:
'model_image'
"model_image"
"model_image"
"model_image"
"model_image"
Wertevorschläge:
'model_image'"model_image""model_image""model_image""model_image", 0, 1, 2, 3, 4, 5, 6, 7, 8
MarkOrientationMarkOrientationMarkOrientationmarkOrientationmark_orientation (input_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Markieren der Komponentenorientierung.
Default:
'false'
"false"
"false"
"false"
"false"
Werteliste:
'false'"false""false""false""false", 'true'"true""true""true""true"
RowRowRowrowrow (output_control) point.y(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Zeilenkoordinate der gefundenen Instanz aller
initialen Komponenten oder Modellkomponenten.
ColumnColumnColumncolumncolumn (output_control) point.x(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Spaltenkoordinate der gefundenen Instanz aller
initialen Komponenten oder Modellkomponenten.
AngleAngleAngleangleangle (output_control) angle.rad(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Rotationswinkel der gefundenen Instanz aller
initialen Komponenten oder Modellkomponenten.
ScoreScoreScorescorescore (output_control) real(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)
Bewertung der gefundenen Instanz aller
initialen Komponenten oder Modellkomponenten.
Ergebnis
Ist der Handle des Trainingsergebnisses gültig, dann liefert
get_training_componentsget_training_componentsGetTrainingComponentsGetTrainingComponentsget_training_components den Wert 2 (
H_MSG_TRUE)
.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Modul
Matching