create_sample_identifierT_create_sample_identifierCreateSampleIdentifierCreateSampleIdentifier (Operator)
Name
create_sample_identifierT_create_sample_identifierCreateSampleIdentifierCreateSampleIdentifier
— Anlegen eines neuen Sample-Identifikators.
Signatur
Beschreibung
Der Operator create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier
legt einen neuen
Sample-Identifikator an. Alternativ dazu kann ein bereits verfügbarer
Sample-Identifikator mit dem Operator read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
von
Datei eingelesen werden.
Das Konzept der samplebasierten Identifikation ist bei der Einleitung
zu Kapitel Identifizierung / Samplebasiert beschrieben.
Wenn Farbinformation für die Identifikation verwendet werden soll, ist es
notwendig, dies explizit anzugeben. Dies erfolgt durch das Setzen des
generischen Parameters 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info" auf 'true'"true""true""true""true".
Mit den generischen Parametern kann das Verhalten des Sample-Identifikators
beeinflusst werden. Typischerweise muss hierbei aber nur der Parameter
'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info" berücksichtigt werden. Die generischen Parameter
und ihre Werte können in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
übergeben werden. Die folgenden generischen Parameter können gesetzt werden:
- 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info":
-
Dieser Parameter legt fest, ob
Farbinformation für die Identifikation verwendet wird. Ist
'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info" auf 'true'"true""true""true""true" gesetzt, so wird
Farbinformation verwendet. In diesem Fall müssen alle Bilder, die für die
Vorbereitung und das Training des Sample-Identifikators verwendet werden,
RGB-Farbbilder sein. Ist 'add_color_info'"add_color_info""add_color_info""add_color_info""add_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.
Werteliste: 'true'"true""true""true""true", 'false'"false""false""false""false"
Defaultwert: 'false'"false""false""false""false"
- 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info":
-
Dieser Parameter legt fest, ob
Texturinformation für die Identifikation verwendet wird. Ist
'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info" auf 'true'"true""true""true""true" gesetzt, so wird
Texturinformation verwendet. Ist 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info" auf
'false'"false""false""false""false" gesetzt, wird keine Texturinformation verwendet.
Normalerweise sollte 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_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 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info" und
'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info" auf 'true'"true""true""true""true" gesetzt sein muss.
Werteliste: 'true'"true""true""true""true", 'false'"false""false""false""false"
Defaultwert: 'true'"true""true""true""true"
- 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method":
-
Um die Identifikation zu
beschleunigen werden die Bilder intern auf eine vorgegebene Größe oder mit
einem bestimmten Faktor skaliert. Ist 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method" auf
'none'"none""none""none""none" gesetzt, so wird diese Skalierung nicht durchgeführt. Für
den Parameter 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor" kann ein konstanter
Skalierungsfaktor angegeben werden und für 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step"
eine konstante Schrittweite für die Unterabtastung (der inverse
Skalierungsfaktor). Für 'image_area'"image_area""image_area""image_area""image_area" kann eine feste Größe für
das interne, skalierte Bild angegeben werden. Die entsprechenden Werte
können mit 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value" gesetzt werden (siehe unten).
Um den Identifikationsprozess zu beschleunigen, sollte ein Wert gewählt
werden, der zu einem kleineren internen Bild führt, also ein kleinerer
Skalierungsfaktor oder eine kleinere Bildgröße bzw. eine größere
Schrittweite für die Unterabtastung. Wenn die zu unterscheidenden Objekte
hochfrequente Textur aufweisen, wird die Identifikation möglicherweise
bessere Ergebnisse liefern, wenn eine größere interne Bildgröße verwendet
wird, da ansonsten die Textur bei der Verkleinerung des Bildes verloren
gehen kann.
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: 'image_area'"image_area""image_area""image_area""image_area"
- 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value":
-
Mit diesem Parameter wird die
Skalierungsmethode (siehe 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method") parametrisiert.
Wenn für 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method" der Wert 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor"
gesetzt ist, wird mit 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value" der Skalierungsfaktor
festgelegt. Wenn für 'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method" der Wert
'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step" gesetzt ist, wird mit
'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value" die Schrittweite für die Unterabtastung,
also der inverse Skalierungsfaktor, festgelegt. Wenn für
'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method" der Wert 'image_area'"image_area""image_area""image_area""image_area" gesetzt ist,
wird mit 'image_resize_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value" die Größe des internen, skalierten
Bildes festgelegt. Diese Größe wird in Megapixeln, d.h., in Millionen
Pixel angegeben.
Wertevorschläge: 0.25, 0.5, 1.0,
2, 3, 4
Defaultwert: Der Defaultwert hängt von der mit
'image_resize_method'"image_resize_method""image_resize_method""image_resize_method""image_resize_method" gewählten Methode ab. Er beträgt
-
0.5 für 'scale_factor'"scale_factor""scale_factor""scale_factor""scale_factor",
-
2.0 für 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step" und
-
0.5 für 'image_area'"image_area""image_area""image_area""image_area".
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.
Dieser Operator liefert ein Handle zurück. Es ist zu beachten, dass der Zustand einer Instanz dieses Handletyps durch bestimmte Operatoren geändert werden kann, obwohl das Handle als Eingabeparameter in diesen Operatoren verwendet wird.
Parameter
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
(input_control) attribute.name-array →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Parametername.
Defaultwert: []
Werteliste: 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info", 'add_texture_info'"add_texture_info""add_texture_info""add_texture_info""add_texture_info", '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"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
(input_control) attribute.value-array →
HTupleHTupleHtuple (string / real / integer) (string / double / int / long) (HString / double / Hlong) (char* / double / Hlong)
Parameterwert.
Defaultwert: []
Wertevorschläge: '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", 0.25, 0.5, 0.75, 1.0, 2, 3, 4, 'true'"true""true""true""true", 'false'"false""false""false""false"
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier
(output_control) sample_identifier →
HSampleIdentifier, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Sample-Identifikators.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier
den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Nachfolger
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData
,
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParam
Alternativen
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Siehe auch
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
,
clear_sample_identifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifierClearSampleIdentifier
,
set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfo
Modul
Matching