HALCON Website / HALCON Operator-Referenz / Identifizierung / Samplebasiert
KlassenKlassenKlassenKlassen | | | | Operatoren

add_sample_identifier_preparation_dataT_add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData (Operator)

Name

add_sample_identifier_preparation_dataT_add_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataadd_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)

Herror T_add_sample_identifier_preparation_data(const Hobject SampleImage, const Htuple SampleIdentifier, const Htuple ObjectIdx, const Htuple GenParamName, const Htuple GenParamValue, Htuple* ObjectSampleIdx)

Herror add_sample_identifier_preparation_data(Hobject SampleImage, const HTuple& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue, Hlong* ObjectSampleIdx)

Hlong HImage::AddSampleIdentifierPreparationData(const HSampleIdentifier& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

Hlong HSampleIdentifier::AddSampleIdentifierPreparationData(const HImage& SampleImage, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

void AddSampleIdentifierPreparationData(const HObject& SampleImage, const HTuple& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ObjectSampleIdx)

Hlong HImage::AddSampleIdentifierPreparationData(const HSampleIdentifier& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

Hlong HImage::AddSampleIdentifierPreparationData(const HSampleIdentifier& SampleIdentifier, Hlong ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

Hlong HSampleIdentifier::AddSampleIdentifierPreparationData(const HImage& SampleImage, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

Hlong HSampleIdentifier::AddSampleIdentifierPreparationData(const HImage& SampleImage, Hlong ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const

void HOperatorSetX.AddSampleIdentifierPreparationData(
[in] IHUntypedObjectX* SampleImage, [in] VARIANT SampleIdentifier, [in] VARIANT ObjectIdx, [in] VARIANT GenParamName, [in] VARIANT GenParamValue, [out] VARIANT* ObjectSampleIdx)

Hlong HImageX.AddSampleIdentifierPreparationData(
[in] IHSampleIdentifierX* SampleIdentifier, [in] VARIANT ObjectIdx, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

Hlong HSampleIdentifierX.AddSampleIdentifierPreparationData(
[in] IHImageX* SampleImage, [in] VARIANT ObjectIdx, [in] VARIANT GenParamName, [in] VARIANT GenParamValue)

static void HOperatorSet.AddSampleIdentifierPreparationData(HObject sampleImage, HTuple sampleIdentifier, HTuple objectIdx, HTuple genParamName, HTuple genParamValue, out HTuple objectSampleIdx)

int HImage.AddSampleIdentifierPreparationData(HSampleIdentifier sampleIdentifier, HTuple objectIdx, HTuple genParamName, HTuple genParamValue)

int HImage.AddSampleIdentifierPreparationData(HSampleIdentifier sampleIdentifier, int objectIdx, HTuple genParamName, HTuple genParamValue)

int HSampleIdentifier.AddSampleIdentifierPreparationData(HImage sampleImage, HTuple objectIdx, HTuple genParamName, HTuple genParamValue)

int HSampleIdentifier.AddSampleIdentifierPreparationData(HImage sampleImage, int objectIdx, HTuple genParamName, HTuple genParamValue)

Beschreibung

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData 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_identifierPrepareSampleIdentifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifier.

Das Konzept der samplebasierten Identifikation ist bei dem Operator create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier 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_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData werden dem Sample-Identifikator SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier die Merkmale eines Samplebildes SampleImageSampleImageSampleImageSampleImageSampleImagesampleImage 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_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData hinzugefügt wurden. Die Vorbereitungsdaten sollten

abdecken.

Die Domain des Samplebildes SampleImageSampleImageSampleImageSampleImageSampleImagesampleImage sollte auf das im Bild sichtbare Objekt reduziert sein. Dies ist notwendig, um zu vermeiden, dass sich der SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier 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_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier 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_dataAddSampleIdentifierTrainingDataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData und train_sample_identifiertrain_sample_identifierTrainSampleIdentifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifier) 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 ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx angegeben wird. Wird die Wiederverwendung der Vorbereitungsdaten nicht gewünscht, kann ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx auf 'unknown'"unknown""unknown""unknown""unknown""unknown" gesetzt werden. Siehe prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifier 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_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData beeinflusst werden. Diese Parameter und ihre Werte können in GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue ü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_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier 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_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier oder set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam 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_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier 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_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier oder set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam gesetzt wurde.

add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData gibt den Objektsampleindex für das in SampleImageSampleImageSampleImageSampleImageSampleImagesampleImage ü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.

Parallelisierung

Parameter

SampleImageSampleImageSampleImageSampleImageSampleImagesampleImage (input_object)  (multichannel-)image → objectHImageHImageHImageHImageXHobject (byte)

Bild, das ein Objekt zeigt.

SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier (input_control)  sample_identifier → HSampleIdentifier, HTupleHTupleHSampleIdentifier, HTupleHSampleIdentifierX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Handle des Sample-Identifikators.

ObjectIdxObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*) (Hlong / BSTR) (Hlong / char*)

Index des im Bild SampleImageSampleImageSampleImageSampleImageSampleImagesampleImage sichtbaren Objekts.

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

Werteliste: 0, 1, 2, 3, 4, 5, 'unknown'"unknown""unknown""unknown""unknown""unknown"

GenParamNameGenParamNameGenParamNameGenParamNameGenParamNamegenParamName (input_control)  attribute.name-array → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

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"

GenParamValueGenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control)  attribute.value-array → HTupleHTupleHTupleVARIANTHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong) (double / BSTR / Hlong) (double / char* / Hlong)

Generischer Parameterwert.

Defaultwert: []

Werteliste: 0.25, 0.5, 0.75, 1.0, 2, 3, 4, '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", 'subsampling_step'"subsampling_step""subsampling_step""subsampling_step""subsampling_step""subsampling_step"

ObjectSampleIdxObjectSampleIdxObjectSampleIdxObjectSampleIdxObjectSampleIdxobjectSampleIdx (output_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Index des hinzugefügten Objektsamples.

Ergebnis

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

Vorgänger

create_sample_identifiercreate_sample_identifierCreateSampleIdentifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifier, read_sample_identifierread_sample_identifierReadSampleIdentifierread_sample_identifierReadSampleIdentifierReadSampleIdentifier

Nachfolger

prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifier

Alternativen

read_sample_identifierread_sample_identifierReadSampleIdentifierread_sample_identifierReadSampleIdentifierReadSampleIdentifier

Siehe auch

add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData, train_sample_identifiertrain_sample_identifierTrainSampleIdentifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifier, apply_sample_identifierapply_sample_identifierApplySampleIdentifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifier, set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParam, get_sample_identifier_paramget_sample_identifier_paramGetSampleIdentifierParamget_sample_identifier_paramGetSampleIdentifierParamGetSampleIdentifierParam, get_sample_identifier_object_infoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoget_sample_identifier_object_infoGetSampleIdentifierObjectInfoGetSampleIdentifierObjectInfo, remove_sample_identifier_preparation_dataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataremove_sample_identifier_preparation_dataRemoveSampleIdentifierPreparationDataRemoveSampleIdentifierPreparationData, remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingData, write_sample_identifierwrite_sample_identifierWriteSampleIdentifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifier, serialize_sample_identifierserialize_sample_identifierSerializeSampleIdentifierserialize_sample_identifierSerializeSampleIdentifierSerializeSampleIdentifier, deserialize_sample_identifierdeserialize_sample_identifierDeserializeSampleIdentifierdeserialize_sample_identifierDeserializeSampleIdentifierDeserializeSampleIdentifier, clear_sample_identifierclear_sample_identifierClearSampleIdentifierclear_sample_identifierClearSampleIdentifierClearSampleIdentifier, set_sample_identifier_object_infoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoset_sample_identifier_object_infoSetSampleIdentifierObjectInfoSetSampleIdentifierObjectInfo

Modul

Matching

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH