add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData (Operator)

Name

add_sample_identifier_preparation_dataT_add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData — 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_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData 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_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier.

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_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData werden dem Sample-Identifikator SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier die Merkmale eines Samplebildes SampleImageSampleImageSampleImageSampleImagesampleImage 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_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData 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 SampleImageSampleImageSampleImageSampleImagesampleImage sollte auf das im Bild sichtbare Objekt reduziert sein. Dies ist notwendig, um zu vermeiden, dass sich der SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier 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_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier der generische Parameter 'add_color_info'"add_color_info""add_color_info""add_color_info""add_color_info" auf '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_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData und train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier) 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 ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx angegeben wird. Wird die Wiederverwendung der Vorbereitungsdaten nicht gewünscht, kann ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx auf 'unknown'"unknown""unknown""unknown""unknown" gesetzt werden. Siehe prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier 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_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData beeinflusst werden. Diese Parameter und ihre Werte können in GenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue ü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":

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

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData gibt den Objektsampleindex für das in SampleImageSampleImageSampleImageSampleImagesampleImage ü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

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

Bild, das ein Objekt zeigt.

SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier (input_control) sample_identifier → (handle)

Handle des Sample-Identifikators.

ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx (input_control) integer → (integer / string)

Index des im Bild SampleImageSampleImageSampleImageSampleImagesampleImage sichtbaren Objekts.

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

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

GenParamNameGenParamNameGenParamNameGenParamNamegenParamName (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_value'"image_resize_value""image_resize_value""image_resize_value""image_resize_value"

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

Generischer 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

ObjectSampleIdxObjectSampleIdxObjectSampleIdxObjectSampleIdxobjectSampleIdx (output_control) integer → (integer)

Index des hinzugefügten Objektsamples.

Ergebnis

Sind die Parameterwerte korrekt, dann liefert add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.