set_sample_identifier_paramT_set_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam (Operator)
Name
set_sample_identifier_paramT_set_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam — Setzen bestimmter Parameter eines Sample-Identifikators.
Signatur
Beschreibung
Mit dem Operator set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParam können bestimmte
Parameter des Sample-Identifikators SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier gesetzt oder
geändert werden.
Das Konzept der samplebasierten Identifikation ist bei der Einleitung
zu Kapitel Identifizierung / Samplebasiert beschrieben.
Mit den folgenden Parametern kann das Verhalten des Sample-Identifikators
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier beeinflusst werden. Die Parameter und ihre Werte
können in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue übergeben werden. Die
folgenden Parameter können gesetzt werden:
- 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info":
-
Dieser Parameter legt fest, ob
Farbinformation für die Identifikation verwendet wird. Ist
'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info" auf 'true'"true""true""true""true" gesetzt, so wird
Farbinformation verwendet. In diesem Fall müssen die Bilder, die an
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier übergeben werden, RGB-Farbbilder sein.
Ist 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info" auf 'false'"false""false""false""false" gesetzt, wird keine
Farbinformation verwendet. Farbinformation sollte verwendet werden, wenn
die zu unterscheidenden Objekte unterschiedliche Farben haben und die
Beleuchtung einigermaßen gut kontrolliert werden kann. In diesem Fall wird
die Identifikation durch die Verwendung von Farbinformation robuster.
Es ist zu beachten, dass dieser Parameter, im Gegensatz zu dem generischen
Parameter 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info", der nur mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt werden kann, nur das Verhalten
des Operators apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier beeinflusst. Damit ist es
z.B. möglich, den Sample-Identifikator unter Verwendung von Textur und
Farbe zu trainieren, für die Identifikation bestimmter Objekte aber nur
die Texturinformation zu verwenden.
Werteliste: 'true'"true""true""true""true", 'false'"false""false""false""false"
Defaultwert: So lange '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" in
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info":
-
Dieser Parameter legt fest, ob
Texturinformation für die Identifikation verwendet wird. Ist
'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info" auf 'true'"true""true""true""true" gesetzt, so wird
Texturinformation verwendet. Ist 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info" auf
'false'"false""false""false""false" gesetzt, wird keine Texturinformation verwendet.
Normalerweise sollte 'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info" auf 'true'"true""true""true""true"
gesetzt sein, da die samplebasierte Identifikation nur mit texturierten
Objekten funktioniert. Es ist zu beachten, dass mindestens einer der
beiden generischen Parameter 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info" und
'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info" auf 'true'"true""true""true""true" gesetzt sein muss.
Es ist zu beachten, dass dieser Parameter, im Gegensatz zu dem generischen
Parameter 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info", der nur mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt werden kann, nur das Verhalten
des Operators apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier beeinflusst.
Werteliste: 'true'"true""true""true""true", 'false'"false""false""false""false"
Defaultwert: So lange '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" in
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method":
-
Siehe
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier für eine Beschreibung dieses Parameters.
Werteliste: 'none'"none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor",
'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step", '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" nicht explizit
mit diesem Operator gesetzt wird, wird der Wert verwendet, der mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value":
-
Siehe
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier für eine Beschreibung dieses Parameters.
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" nicht explizit
mit diesem Operator gesetzt wird, wird der Wert verwendet, der mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier gesetzt wurde.
- 'rating_method'"rating_method""rating_method""rating_method""rating_method":
-
Siehe apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier für
eine Beschreibung dieses Parameters, der ausschließlich von
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier verwendet wird.
Werteliste: 'distance'"distance""distance""distance""distance", 'score'"score""score""score""score",
'score_single'"score_single""score_single""score_single""score_single"
Defaultwert: 'score'"score""score""score""score"
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
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier (input_control) sample_identifier → HSampleIdentifier, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Sample-Identifikators.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control) attribute.name → HTupleHTupleHtuple (string) (string) (HString) (char*)
Parametername.
Defaultwert:
'rating_method'
"rating_method"
"rating_method"
"rating_method"
"rating_method"
Werteliste: '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", '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_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value → HTupleHTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Parameterwert.
Defaultwert:
'score_single'
"score_single"
"score_single"
"score_single"
"score_single"
Werteliste: 0.25, 0.5, 0.75, 1.0, 2, 3, 4, 'distance'"distance""distance""distance""distance", 'false'"false""false""false""false", 'image_area'"image_area""image_area""image_area""image_area", 'none'"none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor", 'score'"score""score""score""score", 'score_single'"score_single""score_single""score_single""score_single", 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step", 'true'"true""true""true""true"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParam den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier,
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Alternativen
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier
Siehe auch
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData,
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier,
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData,
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier,
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier,
get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParamGetSampleIdentifierParam,
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfo,
remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationData,
remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingData,
write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierWriteSampleIdentifier,
serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierSerializeSampleIdentifier,
deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifierDeserializeSampleIdentifier,
set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfo
Modul
Matching