add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data (Operator)

Name

add_sample_identifier_preparation_dataT_add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data — Hinzufügen von Samples für die Vorbereitung eines Sample-Identifikators.

Signatur

add_sample_identifier_preparation_data(SampleImage : : SampleIdentifier, ObjectIdx, GenParamName, GenParamValue : ObjectSampleIdx)

Beschreibung

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data fügt einem bestehenden Sample-Identifikator Samples für die Vorbereitung hinzu. Dies ist eine Voraussetzung für die Vorbereitung des Sample-Identifikators mit dem Operator prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier.

Das Konzept der samplebasierten Identifikation ist bei der Einleitung zu Kapitel Identifizierung / Samplebasiert beschrieben.

Um die besten Identifikationsergebnisse zu erzielen, muss die interne Datenstruktur des Sample-Identifikators an die Art der Objekte angepasst werden, die unterschieden werden sollen. Hierfür sollten Samplebilder für alle zu unterscheidenden Arten von Objekten verwendet werden.

Mit jedem Aufruf von add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data werden dem Sample-Identifikator SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier die Merkmale eines Samplebildes SampleImageSampleImageSampleImageSampleImagesampleImagesample_image hinzugefügt. Die gesamten Vorbereitungsdaten bestehen aus den Merkmalen aller Samplebilder, die dem Sample-Identifikator mit mehreren Aufrufen von add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data hinzugefügt wurden. Die Vorbereitungsdaten sollten

alle Arten von Objekten, die unterschieden werden sollen und
alle unterschiedlichen Ansichten der Objekte, die bei der Anwendung des Sample-Identifikators auftreten können (in maximal 45°-Schritten abgetastet)

abdecken.

Die Domain des Samplebildes SampleImageSampleImageSampleImageSampleImagesampleImagesample_image sollte auf das im Bild sichtbare Objekt reduziert sein. Dies ist notwendig, um zu vermeiden, dass sich der SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier an den Hintergrund der Samplebilder anpasst.

Wenn die Vorbereitungsdaten die oben genannten Anforderungen nicht vollständig erfüllen, kann der Sample-Identifikator trotzdem damit vorbereitet werden. Allerdings kann die Qualität des Identifikationsergebnisses darunter leiden.

Es ist zu beachten, dass RGB-Farbbilder zur Vorbereitung verwendet werden müssen, wenn beim Anlegen des Sample-Identifikators mit dem Operator create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier der generische Parameter 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info""add_color_info" auf 'true'"true""true""true""true""true" gesetzt wurde.

Idealerweise sind die Bilder, die für die Vorbereitung und für das Training (siehe add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataadd_sample_identifier_training_data und train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifiertrain_sample_identifier) verwendet werden, identisch. Dies kann sehr einfach durch eine Wiederverwendung der Vorbereitungsdaten für das Training erreicht werden. Hierzu ist es allerdings notwendig, dass für jedes Samplebild der Objektindex in dem Parameter ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx angegeben wird. Wird die Wiederverwendung der Vorbereitungsdaten nicht gewünscht, kann ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx auf 'unknown'"unknown""unknown""unknown""unknown""unknown" gesetzt werden. Siehe prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifierprepare_sample_identifier für eine Beschreibung, wie die Vorbereitungsdaten für das Training des Sample-Identifikators wiederverwendet werden können.

Mit den folgenden generischen Parametern kann das Verhalten des Operators add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data beeinflusst werden. Diese Parameter und ihre Werte können in GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value übergeben werden. Die folgenden generischen Parameter können gesetzt werden:

'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 durch diesen Operator gesetzt wird, wird der Wert verwendet, der mit create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier oder set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param 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 durch diesen Operator gesetzt wird, wird der Wert verwendet, der mit create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifiercreate_sample_identifier oder set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParamset_sample_identifier_param gesetzt wurde.

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data gibt den Objektsampleindex für das in SampleImageSampleImageSampleImageSampleImagesampleImagesample_image übergebene Sample für die Vorbereitung zurück. Dieser Index kann z.B. verwendet werden, um das entsprechende Sample aus den Vorbereitungsdaten zu entfernen, falls der Sample-Identifikator mit einem anderen Satz von Vorbereitungsdaten vorbereitet werden soll.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Automatisch parallelisiert auf interner Datenebene.

Parameter

SampleImageSampleImageSampleImageSampleImagesampleImagesample_image (input_object) (multichannel-)image → object (byte)

Bild, das ein Objekt zeigt.

SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifiersample_identifier (input_control) sample_identifier → (handle)

Handle des Sample-Identifikators.

ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdxobject_idx (input_control) integer → (integer / string)

Index des im Bild SampleImageSampleImageSampleImageSampleImagesampleImagesample_image sichtbaren Objekts.

Defaultwert: 'unknown' "unknown" "unknown" "unknown" "unknown" "unknown"

Wertevorschläge: 'unknown'"unknown""unknown""unknown""unknown""unknown", 0, 1, 2, 3, 4, 5

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name-array → (string)

Generischer Parametername.

Defaultwert: []

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"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.value-array → (real / string / integer)

Generischer Parameterwert.

Defaultwert: []

Wertevorschläge: '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", 0.25, 0.5, 0.75, 1.0, 2, 3, 4

ObjectSampleIdxObjectSampleIdxObjectSampleIdxObjectSampleIdxobjectSampleIdxobject_sample_idx (output_control) integer → (integer)

Index des hinzugefügten Objektsamples.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_data den Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.