add_sample_identifier_preparation_dataT_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
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
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_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 →
objectHImageHImageHobject (byte)
Bild, das ein Objekt zeigt.
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier
(input_control) sample_identifier →
HSampleIdentifier, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Sample-Identifikators.
ObjectIdxObjectIdxObjectIdxObjectIdxobjectIdx
(input_control) integer →
HTupleHTupleHtuple (integer / string) (int / long / string) (Hlong / HString) (Hlong / char*)
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 →
HTupleHTupleHtuple (string) (string) (HString) (char*)
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 →
HTupleHTupleHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong)
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 →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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.
Vorgänger
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier
,
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Nachfolger
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier
Alternativen
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Siehe auch
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData
,
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier
,
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier
,
set_sample_identifier_paramset_sample_identifier_paramSetSampleIdentifierParamSetSampleIdentifierParamSetSampleIdentifierParam
,
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