add_sample_identifier_training_dataT_add_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData (Operator)
Name
add_sample_identifier_training_dataT_add_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData — Hinzufügen von Samples für das Training eines Sample-Identifikators.
Signatur
void AddSampleIdentifierTrainingData(const HObject& SampleImage, const HTuple& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* ObjectSampleIdx)
Hlong HImage::AddSampleIdentifierTrainingData(const HSampleIdentifier& SampleIdentifier, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const
Hlong HImage::AddSampleIdentifierTrainingData(const HSampleIdentifier& SampleIdentifier, Hlong ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const
Hlong HSampleIdentifier::AddSampleIdentifierTrainingData(const HImage& SampleImage, const HTuple& ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const
Hlong HSampleIdentifier::AddSampleIdentifierTrainingData(const HImage& SampleImage, Hlong ObjectIdx, const HTuple& GenParamName, const HTuple& GenParamValue) const
static void HOperatorSet.AddSampleIdentifierTrainingData(HObject sampleImage, HTuple sampleIdentifier, HTuple objectIdx, HTuple genParamName, HTuple genParamValue, out HTuple objectSampleIdx)
int HImage.AddSampleIdentifierTrainingData(HSampleIdentifier sampleIdentifier, HTuple objectIdx, HTuple genParamName, HTuple genParamValue)
int HImage.AddSampleIdentifierTrainingData(HSampleIdentifier sampleIdentifier, int objectIdx, HTuple genParamName, HTuple genParamValue)
int HSampleIdentifier.AddSampleIdentifierTrainingData(HImage sampleImage, HTuple objectIdx, HTuple genParamName, HTuple genParamValue)
int HSampleIdentifier.AddSampleIdentifierTrainingData(HImage sampleImage, int objectIdx, HTuple genParamName, HTuple genParamValue)
Beschreibung
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData fügt einem bestehenden
Sample-Identifikator Samples für das Training hinzu. Dies ist eine
Voraussetzung für das Training des Sample-Identifikators mit dem Operator
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier.
Das Konzept der samplebasierten Identifikation ist bei der Einleitung
zu Kapitel Identifizierung / Samplebasiert beschrieben.
Um Objekte identifizieren zu können, muss der Sample-Identifikator
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier mit einem repräsentativen Satz von Samplebildern
der zu unterscheidenden Objekte trainiert werden. Diese Samplebilder müssen
dem Sample-Identifikator SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier mit dem Operator
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData hinzugefügt werden.
Mit jedem Aufruf von add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData werden dem
Sample-Identifikator SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier die Merkmale eines
Samplebildes SampleImageSampleImageSampleImageSampleImagesampleImage hinzugefügt. Die gesamten Trainingsdaten
bestehen aus den Merkmalen aller Samplebilder, die dem Sample-Identifikator
mit mehreren Aufrufen von add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData
hinzugefügt wurden. Die Trainingsdaten müssen
-
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
der SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier auf den Hintergrund der Samplebilder trainiert
wird.
Es ist zu beachten, dass es, im Gegensatz zu den Vorbereitungsdaten,
unbedingt notwendig ist, dass die Trainingsdaten den oben genannten
Anforderungen entsprechen. Andernfalls kann der Sample-Identifikator die
Objekte, für die die relevanten Samplebilder fehlen, nicht identifizieren.
Es ist auch zu beachten, dass RGB-Farbbilder für das Training 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 (siehe
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData und
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier) und für das Training verwendet werden,
identisch. 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_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData 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_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData gibt den Objektsampleindex des
Samples für das Training, das in SampleImageSampleImageSampleImageSampleImagesampleImage übergeben wurde,
zurück. Dieser Index kann z.B. verwendet werden, um das entsprechende Sample
aus den Trainingsdaten zu entfernen, falls der Sample-Identifikator mit
einem anderen Satz von Trainingsdaten trainiert 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.
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_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData den Wert 2 (H_MSG_TRUE). Gegebenenfalls
wird eine Fehlerbehandlung durchgeführt.
Vorgänger
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier,
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Nachfolger
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier
Alternativen
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Siehe auch
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier,
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData,
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