protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfprotect_ocr_trainf (Operator)
Name
protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfprotect_ocr_trainf — Schützen von Trainingsdaten.
Signatur
void ProtectOcrTrainf(const HTuple& TrainingFile, const HTuple& Password, const HTuple& TrainingFileProtected)
static void HRegion::ProtectOcrTrainf(const HString& TrainingFile, const HTuple& Password, const HString& TrainingFileProtected)
static void HRegion::ProtectOcrTrainf(const HString& TrainingFile, const HString& Password, const HString& TrainingFileProtected)
static void HRegion::ProtectOcrTrainf(const char* TrainingFile, const char* Password, const char* TrainingFileProtected)
static void HRegion::ProtectOcrTrainf(const wchar_t* TrainingFile, const wchar_t* Password, const wchar_t* TrainingFileProtected)
(Nur Windows)
Beschreibung
Das Erlangen von Trainingsdaten für einen OCR-Klassifikator kann ein
komplizierter und langwieriger Vorgang sein. Trainingsdaten sind demnach
wertvoll und es kann notwendig sein, deren Verwendung zu schützen. Das
grundlegende Konzept hierfür ist, dass geschützte OCR-Trainingsdaten
weder sichtbar sind, noch modifiziert werden können und dass
sichergestellt ist, dass deren Verwendung, z.B. für das Trainieren eines
Klassifikators, durch ein Benutzerpasswort geschützt ist.
Das Vorgehen in HALCON ist, dass OCR-Trainingsdaten zunächst auf die
übliche Weise erlangt und in eine ungeschützte OCR-Trainingsdatei
geschrieben werden. Anschließend wird eine neue Datei erzeugt, die
die mit einem Benutzerpasswort geschützten Trainingsdaten enthält.
Geschützte Trainingsdaten können mit speziellen Operatoren verarbeitet
werden, wobei für das Verwenden der Daten das korrekte Benutzerpasswort
bekannt sein muss.
Dabei ist zu beachten, dass Daten in geschützten
OCR-Trainingsdateien weder sichtbar sind, noch in irgendeiner Art und
Weise modifiziert werden können, d.h. es ist wichtig, dass die
ungeschützten Trainingsdateien mit den Originaldaten auch
nach dem Schützen vorhanden bleiben.
Geschützte OCR-Trainingsdateien können für das Trainieren von
MLP-Klassifikatoren und SVM-Klassifikatoren verwendet werden.
protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfProtectOcrTrainfprotect_ocr_trainf schützt die OCR-Trainingsdaten in der Datei
TrainingFileTrainingFileTrainingFileTrainingFiletrainingFiletraining_file und schreibt diese in die geschützte Trainingsdatei
TrainingFileProtectedTrainingFileProtectedTrainingFileProtectedTrainingFileProtectedtrainingFileProtectedtraining_file_protected. Das Schützen der Daten erfolgt über das
Benutzerpasswort PasswordPasswordPasswordPasswordpasswordpassword. Dasselbe Passwort muss später bei
der Verwendung der geschützten Trainingsdaten angegeben werden, z.B.
bei den Operatoren trainf_ocr_class_mlp_protectedtrainf_ocr_class_mlp_protectedTrainfOcrClassMlpProtectedTrainfOcrClassMlpProtectedTrainfOcrClassMlpProtectedtrainf_ocr_class_mlp_protected oder
read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedread_ocr_trainf_names_protected. Leere Passworte (oder Passworte,
die den leeren String beinhalten) sind nicht erlaubt. Falls genau ein
Passwort PasswordPasswordPasswordPasswordpasswordpassword übergeben wird, werden alle Ausgabedateien
TrainingFileProtectedTrainingFileProtectedTrainingFileProtectedTrainingFileProtectedtrainingFileProtectedtraining_file_protected mit diesem Passwort geschützt, ansonsten
muss die Anzahl der Passworte gleich der Anzahl der Ein- und
Ausgabedateien sein, und die Ausgabedatei an Position n wird mit dem Passwort
an Position n geschützt.
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
TrainingFileTrainingFileTrainingFileTrainingFiletrainingFiletraining_file (input_control) filename.read → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Namen der Trainingsdateien.
Defaultwert:
''
""
""
""
""
""
Dateiendung: .trf, .otr
PasswordPasswordPasswordPasswordpasswordpassword (input_control) string(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Passworte zum Schützen der Trainingsdateien.
TrainingFileProtectedTrainingFileProtectedTrainingFileProtectedTrainingFileProtectedtrainingFileProtectedtraining_file_protected (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Namen der geschützten Trainingsdateien.
Dateiendung: .trf
Ergebnis
Sind die Parameter korrekt, dann liefert
protect_ocr_trainfprotect_ocr_trainfProtectOcrTrainfProtectOcrTrainfProtectOcrTrainfprotect_ocr_trainf den Wert 2 (H_MSG_TRUE).
Andernfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
write_ocr_trainfwrite_ocr_trainfWriteOcrTrainfWriteOcrTrainfWriteOcrTrainfwrite_ocr_trainf,
append_ocr_trainfappend_ocr_trainfAppendOcrTrainfAppendOcrTrainfAppendOcrTrainfappend_ocr_trainf,
concat_ocr_trainfconcat_ocr_trainfConcatOcrTrainfConcatOcrTrainfConcatOcrTrainfconcat_ocr_trainf
Nachfolger
read_ocr_trainf_names_protectedread_ocr_trainf_names_protectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedReadOcrTrainfNamesProtectedread_ocr_trainf_names_protected,
trainf_ocr_class_mlp_protectedtrainf_ocr_class_mlp_protectedTrainfOcrClassMlpProtectedTrainfOcrClassMlpProtectedTrainfOcrClassMlpProtectedtrainf_ocr_class_mlp_protected,
trainf_ocr_class_svm_protectedtrainf_ocr_class_svm_protectedTrainfOcrClassSvmProtectedTrainfOcrClassSvmProtectedTrainfOcrClassSvmProtectedtrainf_ocr_class_svm_protected,
select_feature_set_trainf_mlp_protectedselect_feature_set_trainf_mlp_protectedSelectFeatureSetTrainfMlpProtectedSelectFeatureSetTrainfMlpProtectedSelectFeatureSetTrainfMlpProtectedselect_feature_set_trainf_mlp_protected,
select_feature_set_trainf_svm_protectedselect_feature_set_trainf_svm_protectedSelectFeatureSetTrainfSvmProtectedSelectFeatureSetTrainfSvmProtectedSelectFeatureSetTrainfSvmProtectedselect_feature_set_trainf_svm_protected
Siehe auch
select_feature_set_trainf_mlpselect_feature_set_trainf_mlpSelectFeatureSetTrainfMlpSelectFeatureSetTrainfMlpSelectFeatureSetTrainfMlpselect_feature_set_trainf_mlp
Modul
OCR/OCV