train_sample_identifierT_train_sample_identifierTrainSampleIdentifierTrainSampleIdentifier (Operator)
Name
train_sample_identifierT_train_sample_identifierTrainSampleIdentifierTrainSampleIdentifier — Trainieren eines Sample-Identifikators.
Signatur
Beschreibung
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier führt das Training des Sample-Identifikators
SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier durch. Hierzu werden die Trainingsdaten verwendet,
die mit add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData gesetzt wurden.
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 (siehe
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData).
Zum Training des Sample-Identifikators SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier müssen
diesem zuerst alle relevanten Samplebilder der zu unterscheidenden Objekte
mit add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData hinzugefügt werden.
Alternativ dazu können die Vorbereitungsdaten wiederverwendet 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. Dann wird das Training des
Sample-Identifikators durch den Aufruf des Operators
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier durchgeführt.
Das Training selbst läuft sehr schnell ab und es benötigt auch nur wenig
Speicher. Daher ist es sehr gut möglich, den SampleIdentifierSampleIdentifierSampleIdentifierSampleIdentifiersampleIdentifier
neu zu trainieren, z.B., wenn neue Objekte hinzugefügt oder bestehende
Objekte gelöscht werden sollen.
Um einen bestehenden Sample-Identifikator mit neuen Objekten neu zu
trainieren, müssen ihm lediglich die relevanten Samplebilder mit dem
Operator add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData hinzugefügt werden.
Anschließend kann der Sample-Identifikator mit dem Operator
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier neu trainiert werden. Bestehende Objekte
können mit dem Operator remove_sample_identifier_training_dataremove_sample_identifier_training_dataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingDataRemoveSampleIdentifierTrainingData
entfernt werden. Anschließend kann der Sample-Identifikator mit dem
Operator train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier neu trainiert werden.
Das Training des Sample-Identifikators kann nur dann durchgeführt
werden, wenn der Sample-Identifikator Trainingsdaten für mindestens
zwei unterschiedliche Trainingsobjekte enthält.
Die generischen Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamName und GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue sind
lediglich für eine mögliche zukünftige Verwendung vorhanden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
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*)
Parametername.
Defaultwert: []
Werteliste: []
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue (input_control) attribute.value-array → HTupleHTupleHtuple (real / string / integer) (double / string / int / long) (double / HString / Hlong) (double / char* / Hlong)
Parameterwert.
Defaultwert: []
Werteliste: []
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
train_sample_identifiertrain_sample_identifierTrainSampleIdentifierTrainSampleIdentifierTrainSampleIdentifier den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine
Fehlerbehandlung durchgeführt.
Vorgänger
add_sample_identifier_training_dataadd_sample_identifier_training_dataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingDataAddSampleIdentifierTrainingData
Nachfolger
apply_sample_identifierapply_sample_identifierApplySampleIdentifierApplySampleIdentifierApplySampleIdentifier,
write_sample_identifierwrite_sample_identifierWriteSampleIdentifierWriteSampleIdentifierWriteSampleIdentifier
Alternativen
read_sample_identifierread_sample_identifierReadSampleIdentifierReadSampleIdentifierReadSampleIdentifier
Siehe auch
create_sample_identifiercreate_sample_identifierCreateSampleIdentifierCreateSampleIdentifierCreateSampleIdentifier,
add_sample_identifier_preparation_dataadd_sample_identifier_preparation_dataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationDataAddSampleIdentifierPreparationData,
prepare_sample_identifierprepare_sample_identifierPrepareSampleIdentifierPrepareSampleIdentifierPrepareSampleIdentifier,
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,
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