set_sample_identifier_paramT_set_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param (Operator)
Name
set_sample_identifier_paramT_set_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param — Setzen bestimmter Parameter eines Sample-Identifikators.
Signatur
Beschreibung
Mit dem Operator set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param können bestimmte
Parameter des Sample-Identifikators SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier 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
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier beeinflusst werden. Die Parameter und ihre Werte
können in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value übergeben werden. Die
folgenden Parameter können gesetzt werden:
- 'use_color_info'"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""use_color_info" auf 'true'"true""true""true""true""true" gesetzt, so wird
Farbinformation verwendet. In diesem Fall müssen die Bilder, die an
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier übergeben werden, RGB-Farbbilder sein.
Ist 'use_color_info'"use_color_info""use_color_info""use_color_info""use_color_info""use_color_info" auf 'false'"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""add_color_info", der nur mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier gesetzt werden kann, nur das Verhalten
des Operators apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier 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""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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier gesetzt wurde.
- 'use_texture_info'"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""use_texture_info" auf 'true'"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""use_texture_info" auf
'false'"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""use_texture_info" auf 'true'"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""use_color_info" und
'use_texture_info'"use_texture_info""use_texture_info""use_texture_info""use_texture_info""use_texture_info" auf 'true'"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""add_texture_info", der nur mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier gesetzt werden kann, nur das Verhalten
des Operators apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier beeinflusst.
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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier 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""image_resize_value" nicht explizit
mit diesem Operator gesetzt wird, wird der Wert verwendet, der mit
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier gesetzt wurde.
- 'rating_method'"rating_method""rating_method""rating_method""rating_method""rating_method":
-
Siehe apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier für
eine Beschreibung dieses Parameters, der ausschließlich von
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier verwendet wird.
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"
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
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier (input_control) sample_identifier → HSampleIdentifier, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Sample-Identifikators.
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Parametername.
Defaultwert:
'rating_method'
"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_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"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value → HTupleUnion[float, int, str]HTupleHtuple (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"
"score_single"
Werteliste: 0.25, 0.5, 0.75, 1.0, 2, 3, 4, 'distance'"distance""distance""distance""distance""distance", 'false'"false""false""false""false""false", 'image_area'"image_area""image_area""image_area""image_area""image_area", 'none'"none""none""none""none""none", 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor""scale_factor", 'score'"score""score""score""score""score", 'score_single'"score_single""score_single""score_single""score_single""score_single", 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step", 'true'"true""true""true""true""true"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param den Wert TRUE. Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier,
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifierread_sample_identifier
Alternativen
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier
Siehe auch
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data,
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier,
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataadd_sample_identifier_training_data,
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier,
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifierapply_sample_identifier,
get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParamGetSampleIdentifierParamget_sample_identifier_param,
get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfoget_sample_identifier_object_info,
remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationDataremove_sample_identifier_preparation_data,
remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataremove_sample_identifier_training_data,
write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierWriteSampleIdentifierwrite_sample_identifier,
serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifierSerializeSampleIdentifierserialize_sample_identifier,
deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifierDeserializeSampleIdentifierdeserialize_sample_identifier,
set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoset_sample_identifier_object_info
Modul
Matching