Name
apply_sample_identifierT_apply_sample_identifierApplySampleIdentifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifier — Identifizieren von Objekten mit einem Sample-Identifikator.
Herror apply_sample_identifier(Hobject Image, const HTuple& SampleIdentifier, const HTuple& NumResults, const HTuple& RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, Hlong* ObjectIdx, double* Rating)
Herror apply_sample_identifier(Hobject Image, const HTuple& SampleIdentifier, const HTuple& NumResults, const HTuple& RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ObjectIdx, HTuple* Rating)
HTuple HImage::ApplySampleIdentifier(const HSampleIdentifier& SampleIdentifier, const HTuple& NumResults, const HTuple& RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Rating) const
HTuple HSampleIdentifier::ApplySampleIdentifier(const HImage& Image, const HTuple& NumResults, const HTuple& RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Rating) const
void ApplySampleIdentifier(const HObject& Image, const HTuple& SampleIdentifier, const HTuple& NumResults, const HTuple& RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ObjectIdx, HTuple* Rating)
HTuple HImage::ApplySampleIdentifier(const HSampleIdentifier& SampleIdentifier, Hlong NumResults, double RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Rating) const
Hlong HImage::ApplySampleIdentifier(const HSampleIdentifier& SampleIdentifier, Hlong NumResults, double RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, double* Rating) const
HTuple HSampleIdentifier::ApplySampleIdentifier(const HImage& Image, Hlong NumResults, double RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* Rating) const
Hlong HSampleIdentifier::ApplySampleIdentifier(const HImage& Image, Hlong NumResults, double RatingThreshold, const HTuple& GenParamName, const HTuple& GenParamValue, double* Rating) const
void HOperatorSetX.ApplySampleIdentifier(
[in] IHUntypedObjectX* Image, [in] VARIANT SampleIdentifier, [in] VARIANT NumResults, [in] VARIANT RatingThreshold, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* ObjectIdx, [out] VARIANT* Rating)
VARIANT HImageX.ApplySampleIdentifier(
[in] IHSampleIdentifierX* SampleIdentifier, [in] Hlong NumResults, [in] double RatingThreshold, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* Rating)
VARIANT HSampleIdentifierX.ApplySampleIdentifier(
[in] IHImageX* Image, [in] Hlong NumResults, [in] double RatingThreshold, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* Rating)
static void HOperatorSet.ApplySampleIdentifier(HObject image, HTuple sampleIdentifier, HTuple numResults, HTuple ratingThreshold, HTuple genParamName, HTuple genParamValue, out HTuple objectIdx, out HTuple rating)
HTuple HImage.ApplySampleIdentifier(HSampleIdentifier sampleIdentifier, int numResults, double ratingThreshold, HTuple genParamName, HTuple genParamValue, out HTuple rating)
int HImage.ApplySampleIdentifier(HSampleIdentifier sampleIdentifier, int numResults, double ratingThreshold, HTuple genParamName, HTuple genParamValue, out double rating)
HTuple HSampleIdentifier.ApplySampleIdentifier(HImage image, int numResults, double ratingThreshold, HTuple genParamName, HTuple genParamValue, out HTuple rating)
int HSampleIdentifier.ApplySampleIdentifier(HImage image, int numResults, double ratingThreshold, HTuple genParamName, HTuple genParamValue, out double rating)
apply_sample_identifierapply_sample_identifierApplySampleIdentifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifier identifiziert das Objekt im Bild
ImageImageImageImageImageimage mit dem gegebenen Sample-Identifikator
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier und liefert den entsprechenden Objektindex in
ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx zurück.
Das Konzept der samplebasierten Identifikation ist bei dem Operator
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier beschrieben.
Der Operator apply_sample_identifierapply_sample_identifierApplySampleIdentifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifier kann nur ein Objekt pro
Suchbild identifizieren. Das bedeutet, dass das in ImageImageImageImageImageimage übergebene
Suchbild, oder genauer gesagt dessen Domain, nur ein Objekt enthalten darf.
Der Parameter NumResultsNumResultsNumResultsNumResultsNumResultsnumResults gibt die Anzahl von Hypothesen an, die
zurückgegeben werden. Die Hypothesen sind dabei nach ihrer Bewertung
sortiert. Wenn der generische Parameter 'apply_rating_threshold'"apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold"
auf 'true'"true""true""true""true""true" gesetzt ist (siehe unten), werden nur solche Hypothesen
zurück gegeben, deren Bewertung besser als der in RatingThresholdRatingThresholdRatingThresholdRatingThresholdRatingThresholdratingThreshold
angegebenen Schwellwert ist.
Der Objektindex des identifizierten Objekts wird in ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx
zurückgegeben und die entsprechende Bewertung in RatingRatingRatingRatingRatingrating. Wenn
NumResultsNumResultsNumResultsNumResultsNumResultsnumResults auf einen Wert größer als 1 gesetzt ist, werden
die Objektindizes und die Bewertungen der besten NumResultsNumResultsNumResultsNumResultsNumResultsnumResults
Hypothesen in ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx und RatingRatingRatingRatingRatingrating zurückgegeben.
Mit den folgenden generischen Parametern kann das Verhalten des
Sample-Identifikators SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier beeinflusst werden. Die
Parameter und ihre Werte können in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und
GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue übergeben werden. Die folgenden generischen
Parameter können gesetzt werden:
- 'rating_method'"rating_method""rating_method""rating_method""rating_method""rating_method":
-
Dieser Parameter legt fest, welche
Bewertungsmethode für die Identifikation der Objekte verwendet wird. Es
stehen drei unterschiedliche Bewertungsmethoden zur Auswahl:
- 'distance'"distance""distance""distance""distance""distance"
-
Die Bewertung wird aufgrund der Distanz
zwischen den Merkmalen im Suchbild und den trainierten Samplebildern
durchgeführt. Die Bewertungen liegen zwischen 0.0 und
2.0. Sind Suchbild und Samplebild identisch, so wird eine
Bewertung von 0.0 im Parameter RatingRatingRatingRatingRatingrating zurückgegeben. Je
stärker sich die Bilder unterscheiden, desto höher wird die Bewertung. Bei
dieser Bewertungsmethode werden die Rohdaten der Bewertung zurückgegeben.
Diese Bewertungsmethode hat den Vorteil, dass die Bewertung nur von den
Samples für das Training abhängt, die für das identifizierte Objekt
trainiert wurden. Die Bewertungen der beiden anderen Bewertungsmethoden
hängen auch von allen übrigen Samples für das Training ab.
- 'score'"score""score""score""score""score"
-
Die Bewertung basiert auf einer komplizierten
Kombination der einzelnen Auswertungen für Textur und Farbe. Die
Bewertungen liegen zwischen 0.0 und 1.0. Höhere Werte
bedeuten eine bessere Übereinstimmung. Wird sowohl Textur als auch Farbe
verwendet, liefert diese Bewertungsmethode die besten Ergebnisse und
sollte daher in diesem Fall auch verwendet werden. Ein Nachteil dieser
Bewertungsmethode ist, dass die Bewertungen von Trainingsbildern
typischerweise deutlich unter 1.0 liegt. Außerdem muss ein
passender Schwellwert für jede Anwendung gesondert bestimmt werden.
- 'score_single'"score_single""score_single""score_single""score_single""score_single"
-
Die Bewertung basiert auf einer einfachen
Kombination der einzelnen Auswertungen für Textur und Farbe. Die
Bewertungen liegen zwischen 0.0 und 1.0. Höhere Werte
bedeuten eine bessere Übereinstimmung. Wird sowohl Textur wie auch Farbe
verwendet, liefert die Bewertungsmethode 'score'"score""score""score""score""score" bessere
Ergebnisse. Der Vorteil der Bewertungsmethode 'score_single'"score_single""score_single""score_single""score_single""score_single" ist,
dass sie für Trainingsbilder die Bewertung 1.0 liefert. Daher
sollte diese Methode angewendet werden, wenn nur Textur oder nur Farbe für
die Identifikation verwendet werden. Bei dieser Bewertungsmethode ist es
auch leichter einen passenden Schwellwert festzulegen, als bei der
Bewertungsmethode 'score'"score""score""score""score""score".
Es ist zu beachten, dass die Wahl der Bewertungsmethode nicht nur die
(Zahlenwerte der) Bewertung beeinflusst, die im Parameter RatingRatingRatingRatingRatingrating
zurückgegeben wird, sondern auch die eigentliche Identifikation der
Objekte.
Werteliste: 'distance'"distance""distance""distance""distance""distance", 'score'"score""score""score""score""score",
'score_single'"score_single""score_single""score_single""score_single""score_single"
Defaultwert: 'score'"score""score""score""score""score"
- 'apply_rating_threshold'"apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold":
-
Dieser Parameter legt fest, ob
der in RatingThresholdRatingThresholdRatingThresholdRatingThresholdRatingThresholdratingThreshold übergebene Schwellwert angewendet wird,
oder nicht. Wenn 'apply_rating_threshold'"apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold" auf 'true'"true""true""true""true""true"
gesetzt ist, wird der Schwellwert angewendet.
Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"
Defaultwert: 'true'"true""true""true""true""true"
- 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info""use_color_info":
-
Siehe
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam für eine Beschreibung dieses
Parameters.
Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"
Defaultwert: So lange 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info""use_color_info" nicht gesetzt
wird, wird der Wert verwendet, der mit 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" in
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info""use_texture_info":
-
Siehe
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam für eine Beschreibung dieses
Parameters.
Werteliste: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"
Defaultwert: So lange 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info""use_texture_info" nicht gesetzt
wird, wird der Wert verwendet, der mit 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info""add_texture_info" in
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method":
-
Siehe
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier für eine Beschreibung dieses Parameters.
Werteliste: 'none'"none""none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor",
'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step", 'image_area'"image_area""image_area""image_area""image_area""image_area"
Defaultwert: Wenn 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method" nicht explizit
mit diesem Operator gesetzt wird, wird der Wert verwendet, der mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier oder mit
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam gesetzt wurde.
- 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value":
-
Siehe
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier für eine Beschreibung dieses Parameters.
Es ist hierbei zu beachten, dass die zu identifizierenden Objekte in den
Suchbildern in etwa in derselben Größe erscheinen, wie in den Samples für
das Training.
Wertevorschläge: 0.25, 0.5, 1.0,
2, 3, 4
Defaultwert: Wenn 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value" nicht explizit
mit diesem Operator gesetzt wird, wird der Wert verwendet, der mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier oder mit
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam gesetzt wurde.
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Automatisch parallelisiert auf interner Datenebene.
Bild, das das zu identifizierende Objekt zeigt.
Handle des Sample-Identifikators.
Anzahl der Hypothesen, die zurückgegeben werden.
Defaultwert: 1
Werteliste: 1, 2, 3, 4, 5, 10
Schwellwert für die Bewertung.
Defaultwert: 0.0
Werteliste: 0.05, 0.1, 0.15, 0.2
Generischer Parametername.
Defaultwert: []
Werteliste: 'apply_rating_threshold'"apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold""apply_rating_threshold", 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method""image_resize_method", 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value""image_resize_value", 'rating_method'"rating_method""rating_method""rating_method""rating_method""rating_method", 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info""use_color_info", 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info""use_texture_info"
Generischer Parameterwert.
Defaultwert: []
Werteliste: 'distance'"distance""distance""distance""distance""distance", 'false'"false""false""false""false""false", 'score'"score""score""score""score""score", 'score_single'"score_single""score_single""score_single""score_single""score_single", 'true'"true""true""true""true""true"
Index des identifizierten Objekts.
Bewertung des identifizierten Objekts.
Sind die Parameterwerte korrekt, dann liefert
apply_sample_identifierapply_sample_identifierApplySampleIdentifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifier den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
train_sample_identifiertrain_sample_identifierTrainSampleIdentifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifier,
read_sample_identifierread_sample_identifierReadSampleIdentifierread_sample_identifierReadSampleIdentifierReadSampleIdentifier
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData
create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier,
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData,
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifier,
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam,
get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParam,
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfo,
remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationData,
remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingData,
write_sample_identifierwrite_sample_identifierWriteSampleIdentifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifier,
serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifier,
deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifier,
clear_sample_identifierclear_sample_identifierClearSampleIdentifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifier,
set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfo
Matching