set_dl_model_paramT_set_dl_model_paramSetDlModelParamSetDlModelParamset_dl_model_param (Operator)

Name

set_dl_model_paramT_set_dl_model_paramSetDlModelParamSetDlModelParamset_dl_model_param — Setzen der Parameter des Deep Learning-basierten Models.

Signatur

Beschreibung

set_dl_model_paramset_dl_model_paramSetDlModelParamSetDlModelParamSetDlModelParamset_dl_model_param setzt die Parameter und Hyperparameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name des Deep Learning-Modells DLModelHandleDLModelHandleDLModelHandleDLModelHandleDLModelHandledlmodel_handle auf die Werte in GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value.

Die Werte, die GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name annehmen kann, hängen vom Modelltyp ab: Es gibt Parameter, die für jedes Deep Learning-Modell gesetzt werden können, während andere nur für spezielle Modelle gesetzt werden können. Eine Beschreibung der spezifischen Parameter, deren Werte nur gesetzt aber nicht abgefragt werden können, ist weiter unten gegeben. Für alle anderen Parameter ist die spezifische Beschreibung in get_dl_model_paramget_dl_model_paramGetDlModelParamGetDlModelParamGetDlModelParamget_dl_model_param zu finden. In get_dl_model_paramget_dl_model_paramGetDlModelParamGetDlModelParamGetDlModelParamget_dl_model_param wird zudem ein Überblick darüber gegeben, für welche Modelltypen Parameter gesetzt und welche Operatoren dafür genutzt werden können.

Im Folgenden werden die Parameter aufgelistet, die mit set_dl_model_paramset_dl_model_paramSetDlModelParamSetDlModelParamSetDlModelParamset_dl_model_param gesetzt werden können. Dabei bezeichnen die folgenden Symbole den Modelltypen, für welchen der Parameter einflussreich gesetzt werden kann.

• 'Any': Jede Methode

• '3D-GPD': 'type'"type""type""type""type""type"='3d_gripping_point_detection'"3d_gripping_point_detection""3d_gripping_point_detection""3d_gripping_point_detection""3d_gripping_point_detection""3d_gripping_point_detection"

• 'AD': 'type'"type""type""type""type""type"='anomaly_detection'"anomaly_detection""anomaly_detection""anomaly_detection""anomaly_detection""anomaly_detection"

• 'CL': 'type'"type""type""type""type""type"='classification'"classification""classification""classification""classification""classification"

• 'DO': 'type'"type""type""type""type""type"='ocr_recognition'"ocr_recognition""ocr_recognition""ocr_recognition""ocr_recognition""ocr_recognition"

• 'GC-AD': 'type'"type""type""type""type""type"='gc_anomaly_detection'"gc_anomaly_detection""gc_anomaly_detection""gc_anomaly_detection""gc_anomaly_detection""gc_anomaly_detection"

• 'OD': 'type'"type""type""type""type""type"='detection'"detection""detection""detection""detection""detection"

• 'SE': 'type'"type""type""type""type""type"='segmentation'"segmentation""segmentation""segmentation""segmentation""segmentation"

• 'Gen': 'type'"type""type""type""type""type"='generic'"generic""generic""generic""generic""generic"

'adam_beta1'"adam_beta1""adam_beta1""adam_beta1""adam_beta1""adam_beta1": CL DO GC-AD OD SE Gen

Moment für den linearen Term im Adam Solver. Nur verfügbar für 'solver_type'"solver_type""solver_type""solver_type""solver_type""solver_type" = 'adam'"adam""adam""adam""adam""adam".

'adam_beta2'"adam_beta2""adam_beta2""adam_beta2""adam_beta2""adam_beta2": CL DO GC-AD OD SE Gen

Moment für den quadratischen Term im Adam Solver. Nur verfügbar für 'solver_type'"solver_type""solver_type""solver_type""solver_type""solver_type" = 'adam'"adam""adam""adam""adam""adam".

'adam_epsilon'"adam_epsilon""adam_epsilon""adam_epsilon""adam_epsilon""adam_epsilon": CL DO GC-AD OD SE Gen

Epsilon für die numerische Stabilität im Adam Solver. Nur verfügbar für 'solver_type'"solver_type""solver_type""solver_type""solver_type""solver_type" = 'adam'"adam""adam""adam""adam""adam".

'alphabet'"alphabet""alphabet""alphabet""alphabet""alphabet": DO

'alphabet_internal'"alphabet_internal""alphabet_internal""alphabet_internal""alphabet_internal""alphabet_internal": DO

'alphabet_mapping'"alphabet_mapping""alphabet_mapping""alphabet_mapping""alphabet_mapping""alphabet_mapping": DO

'anomaly_score_tolerance'"anomaly_score_tolerance""anomaly_score_tolerance""anomaly_score_tolerance""anomaly_score_tolerance""anomaly_score_tolerance": GC-AD

'backbone_docking_layers'"backbone_docking_layers""backbone_docking_layers""backbone_docking_layers""backbone_docking_layers""backbone_docking_layers": CL

Die Spezifikation der Docking Layer kann bei jedem Klassifikator erfolgen, auch ohne dass diese als Backbone eingelesen werden. Berücksichtigt wird diese Angabe jedoch nur für Backbones der Objektdetektion.

'batch_size'"batch_size""batch_size""batch_size""batch_size""batch_size": Any

'batch_size_multiplier'"batch_size_multiplier""batch_size_multiplier""batch_size_multiplier""batch_size_multiplier""batch_size_multiplier": CL DO GC-AD OD SE Gen

'batchnorm_momentum'"batchnorm_momentum""batchnorm_momentum""batchnorm_momentum""batchnorm_momentum""batchnorm_momentum": Any außer 3D-GPD

Wird diese Operation aufgerufen, so wird das Momentum aller Batchnormalisierungs-Layer des Netzwerks gesetzt. Die setztbaren Werte sind die gleichen, wie in create_dl_layer_batch_normalizationcreate_dl_layer_batch_normalizationCreateDlLayerBatchNormalizationCreateDlLayerBatchNormalizationCreateDlLayerBatchNormalizationcreate_dl_layer_batch_normalization für den Parameter MomentumMomentumMomentumMomentummomentummomentum beschrieben.

Falls das Netzwerk keinen solchen Layer hat, wird nichts getan und die Operation als erfolgreich betrachtet.

'bbox_heads_weight'"bbox_heads_weight""bbox_heads_weight""bbox_heads_weight""bbox_heads_weight""bbox_heads_weight", 'class_heads_weight'"class_heads_weight""class_heads_weight""class_heads_weight""class_heads_weight""class_heads_weight": OD

'class_ids'"class_ids""class_ids""class_ids""class_ids""class_ids": OD SE

'class_names'"class_names""class_names""class_names""class_names""class_names": CL OD SE

'class_weights'"class_weights""class_weights""class_weights""class_weights""class_weights": CL

'complexity'"complexity""complexity""complexity""complexity""complexity": AD

'device'"device""device""device""device""device": Any

'enable_resizing'"enable_resizing""enable_resizing""enable_resizing""enable_resizing""enable_resizing": Any außer 3D-GPD

Wird diese Operation aufgerufen, so werden gewisse Pooling-Layer des Netzwerks umgewandelt. Genauer gesagt werden alle nicht-globalen Pooling-Layer deren Ausgabe-Merkmalskarten mit Größe 1x1 in globale Pooling-Layer umgewandelt. So wird z.B. ein 'average pooling' (Vereinigung durch Mittelwert) in ein 'global average pooling' umgewandelt. Für weitere Informationen zu Pooling-Layern wird auf den „Solution Guide on Classification“ verwiesen.

Es gilt zu beachten, ist diese Operation einmal durchgeführt, kann sie nicht mehr rückgängig gemacht werden. Entsprechend ist nur der Wert 'true'"true""true""true""true""true" setzbar. Falls das Netzwerk keinen solchen Layer hat, wird nichts getan und die Operation als erfolgreich betrachtet.

'extract_feature_maps'"extract_feature_maps""extract_feature_maps""extract_feature_maps""extract_feature_maps""extract_feature_maps": CL

'freeze_backbone_level'"freeze_backbone_level""freeze_backbone_level""freeze_backbone_level""freeze_backbone_level""freeze_backbone_level": OD

'fuse_bn_relu'"fuse_bn_relu""fuse_bn_relu""fuse_bn_relu""fuse_bn_relu""fuse_bn_relu": Any außer 3D-GPD

Wird diese Operation aufgerufen, so werden Layer Paare, bestehend aus einem Batchnormalisierungs-Layer ohne Aktivierung und einem direkt verknüpften Activation-Layer mit Aktivierungsmodus ReLu, fusioniert. Um dies zu tun, darf die Ausgabe des Batchnormalisierungs-Layers nur vom Activation-Layer als Eingabe verwendet werden. Daraus entsteht ein Batchnormalisierungs-Layer mit ReLU-Aktivierung. Weitere Informationen zu Layern und möglichen Modi befinden sich im „Solution Guide on Classification“.

Es gilt zu beachten, ist diese Operation einmal durchgeführt, kann sie nicht mehr rückgängig gemacht werden. Entsprechend ist nur der Wert 'true'"true""true""true""true""true" setzbar. Falls das Netzwerk kein entsprechendes Layer Paar hat, wird nichts getan und die Operation als erfolgreich betrachtet.

Restriktion: Nicht anwendbar auf Leaky ReLU-Layer.

'fuse_conv_relu'"fuse_conv_relu""fuse_conv_relu""fuse_conv_relu""fuse_conv_relu""fuse_conv_relu": Any außer 3D-GPD

Wird diese Operation aufgerufen, so werden Layer Paare, bestehend aus einem Faltungs-Layer ohne Aktivierung und einem direkt verknüpften Activation-Layer mit Aktivierungsmodus ReLu, fusioniert. Um dies zu tun, darf die Ausgabe des Faltungs-Layers nur vom Activation-Layer als Eingabe verwendet werden. Daraus entsteht ein Faltungs-Layer mit ReLU-Aktivierung. Weitere Informationen zu Layern und möglichen Modi befinden sich im „Solution Guide on Classification“.

Es gilt zu beachten, ist diese Operation einmal durchgeführt, kann sie nicht mehr rückgängig gemacht werden. Entsprechend ist nur der Wert 'true'"true""true""true""true""true" setzbar. Falls das Netzwerk kein entsprechendes Layer Paar hat, wird nichts getan und die Operation als erfolgreich betrachtet.

Restriktion: Nicht anwendbar auf Leaky ReLU-Layer.

'gc_anomaly_networks'"gc_anomaly_networks""gc_anomaly_networks""gc_anomaly_networks""gc_anomaly_networks""gc_anomaly_networks": GC-AD

'gpu'"gpu""gpu""gpu""gpu""gpu": Any

'ignore_class_ids'"ignore_class_ids""ignore_class_ids""ignore_class_ids""ignore_class_ids""ignore_class_ids": SE

'image_dimensions'"image_dimensions""image_dimensions""image_dimensions""image_dimensions""image_dimensions": 3D-GPD AD CL DO GC-AD SE

'image_height'"image_height""image_height""image_height""image_height""image_height", 'image_width'"image_width""image_width""image_width""image_width""image_width": 3D-GPD AD CL DO GC-AD SE

'image_num_channels'"image_num_channels""image_num_channels""image_num_channels""image_num_channels""image_num_channels": AD CL DO GC-AD SE

'image_range_max'"image_range_max""image_range_max""image_range_max""image_range_max""image_range_max", 'image_range_min'"image_range_min""image_range_min""image_range_min""image_range_min""image_range_min": DO SE

'input_dimensions'"input_dimensions""input_dimensions""input_dimensions""input_dimensions""input_dimensions": AD CL DO SE Gen

'learning_rate'"learning_rate""learning_rate""learning_rate""learning_rate""learning_rate": CL DO GC-AD OD SE Gen

'mask_head_weight'"mask_head_weight""mask_head_weight""mask_head_weight""mask_head_weight""mask_head_weight": OD

Dieser Parameter ist nur verfügbar für Modelle mit 'instance_segmentation'"instance_segmentation""instance_segmentation""instance_segmentation""instance_segmentation""instance_segmentation"='true'"true""true""true""true""true".

'max_num_detections'"max_num_detections""max_num_detections""max_num_detections""max_num_detections""max_num_detections": OD

'max_overlap'"max_overlap""max_overlap""max_overlap""max_overlap""max_overlap": OD

'max_overlap_class_agnostic'"max_overlap_class_agnostic""max_overlap_class_agnostic""max_overlap_class_agnostic""max_overlap_class_agnostic""max_overlap_class_agnostic": OD

'meta_data'"meta_data""meta_data""meta_data""meta_data""meta_data": Any

'min_confidence'"min_confidence""min_confidence""min_confidence""min_confidence""min_confidence": OD

'momentum'"momentum""momentum""momentum""momentum""momentum": CL DO GC-AD OD SE Gen

Momentum für den SGD Solver.

Restriktion: Nur verfügbar für 'solver_type'"solver_type""solver_type""solver_type""solver_type""solver_type" = 'sgd'"sgd""sgd""sgd""sgd""sgd".

'optimize_for_inference'"optimize_for_inference""optimize_for_inference""optimize_for_inference""optimize_for_inference""optimize_for_inference": 3D-GPD CL DO GC-AD OD SE Gen

'patch_size'"patch_size""patch_size""patch_size""patch_size""patch_size": GC-AD

'runtime'"runtime""runtime""runtime""runtime""runtime": Any

'runtime_init'"runtime_init""runtime_init""runtime_init""runtime_init""runtime_init": Any

Wird 'runtime_init'"runtime_init""runtime_init""runtime_init""runtime_init""runtime_init" auf 'immediately'"immediately""immediately""immediately""immediately""immediately" gesetzt wird der GPU-Speicher initialisiert und das entsprechende Handle erzeugt. Andernfalls passiert das sobald es notwendig ist, was zu signifikant längeren Laufzeiten beim ersten Aufruf von apply_dl_modelapply_dl_modelApplyDlModelApplyDlModelApplyDlModelapply_dl_model oder train_dl_model_batchtrain_dl_model_batchTrainDlModelBatchTrainDlModelBatchTrainDlModelBatchtrain_dl_model_batch führen kann.

Wird die Netzwerkarchitektur nachträglich geändert, wird der GPU-Speicher reinitialisiert. Das kann zum Beispiel auftreten wenn 'batch_size'"batch_size""batch_size""batch_size""batch_size""batch_size", 'image_dimensions'"image_dimensions""image_dimensions""image_dimensions""image_dimensions""image_dimensions" oder 'input_dimensions'"input_dimensions""input_dimensions""input_dimensions""input_dimensions""input_dimensions" durch nachträgliches Aufrufen von set_dl_model_paramset_dl_model_paramSetDlModelParamSetDlModelParamSetDlModelParamset_dl_model_param geändert werden.

Zu beachten ist, dass dieser Parameter keine Auswirkungen hat, wenn:

• Eine CPU genutzt wird, also falls 'runtime'"runtime""runtime""runtime""runtime""runtime" auf 'cpu'"cpu""cpu""cpu""cpu""cpu" gesetzt ist.

• Eine AI²-Schnittstelle genutzt wird.

• Die Hardware-Einheit vorher mit 'device'"device""device""device""device""device" gesetzt wurde.

'solver_type'"solver_type""solver_type""solver_type""solver_type""solver_type": CL DO GC-AD OD SE Gen

'standard_deviation_factor'"standard_deviation_factor""standard_deviation_factor""standard_deviation_factor""standard_deviation_factor""standard_deviation_factor": AD

'type'"type""type""type""type""type": Gen

Dieser Parameter gibt den HALCON-spezifischen Modelltypen an.

Modelle des Typs 'generic'"generic""generic""generic""generic""generic" können sämtliche Modell-Funktionen erfüllen. Jedoch sind mehrere Deep-Learning-Prozeduren auf einen spezifischen 'type'"type""type""type""type""type" angewiesen. Der 'type'"type""type""type""type""type" kann von 'generic'"generic""generic""generic""generic""generic" auf folgende Werte gesetzt werden:

• 'classification'"classification""classification""classification""classification""classification"

• 'segmentation'"segmentation""segmentation""segmentation""segmentation""segmentation"

Beim Setzen des 'type'"type""type""type""type""type" wird überprüft, ob alle für Inferenz und Training erforderlichen Layer vorhanden sind. vorhanden sind. Fehlen solche Layer werden sie hinzugefügt.

'weight_prior'"weight_prior""weight_prior""weight_prior""weight_prior""weight_prior": CL DO GC-AD OD SE Gen

Achtung

Systemvoraussetzungen: cuDNN und cuBLAS sind notwendig, um 'gpu'"gpu""gpu""gpu""gpu""gpu" Parameter zu setzen, d.h. um den Parameter GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name 'runtime'"runtime""runtime""runtime""runtime""runtime" auf 'gpu'"gpu""gpu""gpu""gpu""gpu" zu setzen. Für weitere Details siehe „Installation Guide“, Abschnitt „Requirements for Deep Learning and Deep-Learning-Based Methods“.

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

Ergebnis

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

Vorgänger

read_dl_modelread_dl_modelReadDlModelReadDlModelReadDlModelread_dl_model, get_dl_model_paramget_dl_model_paramGetDlModelParamGetDlModelParamGetDlModelParamget_dl_model_param

Nachfolger

get_dl_model_paramget_dl_model_paramGetDlModelParamGetDlModelParamGetDlModelParamget_dl_model_param, apply_dl_modelapply_dl_modelApplyDlModelApplyDlModelApplyDlModelapply_dl_model, train_dl_model_batchtrain_dl_model_batchTrainDlModelBatchTrainDlModelBatchTrainDlModelBatchtrain_dl_model_batch, train_dl_model_anomaly_datasettrain_dl_model_anomaly_datasetTrainDlModelAnomalyDatasetTrainDlModelAnomalyDatasetTrainDlModelAnomalyDatasettrain_dl_model_anomaly_dataset

Siehe auch

get_dl_model_paramget_dl_model_paramGetDlModelParamGetDlModelParamGetDlModelParamget_dl_model_param

Modul

Foundation. Dieser Operator verwendet dynamische Lizensierung (siehe ``Installation Guide''). Welches der folgenden Module benötigt wird hängt von der Anwendung des Operators ab:
3D Metrology, OCR/OCV, Deep Learning Inference