set_aop_infoset_aop_infoSetAopInfoset_aop_infoSetAopInfoSetAopInfo (Operator)

Name

set_aop_infoset_aop_infoSetAopInfoset_aop_infoSetAopInfoSetAopInfo — Verändert Information über HALCONs automatische Operator-Parallelisierung.

Signatur

Beschreibung

HALCON unterstützt einen Mechanismus, um das Verhalten der automatischen Parallelisierung von Operatoren (AOP) an Mehrprozessorarchitekturen anzupassen und Operatoren zu beschleunigen. Dazu können für jeden Operator, der sich auf Tupel-, Kanal- oder Domain-Ebene parallelisieren lässt, mit Hilfe von optimize_aopoptimize_aopOptimizeAopoptimize_aopOptimizeAopOptimizeAop Abhängigkeiten des Laufzeitverhaltens von der Hardware und Eingabeparametern ermittelt werden. Der Operator get_aop_infoget_aop_infoGetAopInfoget_aop_infoGetAopInfoGetAopInfo liest Elemente dieser Informationen, während diese durch den Operator set_aop_infoset_aop_infoSetAopInfoset_aop_infoSetAopInfoSetAopInfo verändert werden können.

Um die operatorspezifischen Informationen adressieren zu können, sind die Daten in einer 3-stufigen Hierarchie indizierbar, die sich mit query_aop_infoquery_aop_infoQueryAopInfoquery_aop_infoQueryAopInfoQueryAopInfo abfragen lässt. Durch ein Tripel von Indexkennungen lässt sich so jeweils ein AOP-Set an Optimierungsdaten indizieren. Die drei Indizierungsstufen setzen sich durch den Operatornamen, den ikonischen Bildtyp und optional einen Parameterstring zusammen, der einen speziellen Modus oder Methode des Operators spezifiziert. Während der Operatorname OperatorNameOperatorNameOperatorNameOperatorNameOperatorNameoperatorName übergeben wird, definieren IndexNameIndexNameIndexNameIndexNameIndexNameindexName und IndexValueIndexValueIndexValueIndexValueIndexValueindexValue die letzteren beiden Indizes. IndexNameIndexNameIndexNameIndexNameIndexNameindexName erhält dabei die Indexkennung, IndexValueIndexValueIndexValueIndexValueIndexValueindexValue den Indexwert, wie sie von query_aop_infoquery_aop_infoQueryAopInfoquery_aop_infoQueryAopInfoQueryAopInfo zurückgegeben werden. Es ist möglich mehrere Indexkennungen der gleichen Stufe anzugeben, um die spezifizierte Information bei mehreren AOP-Sets zu speichern. Die gesamte Indexstufe kann adressiert werden, wenn eine Indexkennung ausgelassen oder für einen Indexwert ein leerer String übergeben wird. Beispielsweise werden durch eine leeren String für OperatorNameOperatorNameOperatorNameOperatorNameOperatorNameoperatorName, dem Tupel ['iconic_type','iconic_type']["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"] für IndexNameIndexNameIndexNameIndexNameIndexNameindexName und dem Tupel ['byte','uint2']["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"] für IndexValueIndexValueIndexValueIndexValueIndexValueindexValue alle Operatoren adressiert, die Byte oder UINT2 Bilder verarbeiten.

set_aop_infoset_aop_infoSetAopInfoset_aop_infoSetAopInfoSetAopInfo setzt die in InfoValueInfoValueInfoValueInfoValueInfoValueinfoValue übergebenen Informationswerte in dem spezifizierten AOP-Sets. Die Art der Information kann mit dem Parameter InfoNameInfoNameInfoNameInfoNameInfoNameinfoName mit einem der folgenden Werten spezifiziert werden:

'max_threads'"max_threads""max_threads""max_threads""max_threads""max_threads"

setzt die größte zulässige Threadanzahl, mit der der Operator mit dem entsprechenden ikonischen Datentyp und Parameterwert parallelisiert werden darf.

'split_level'"split_level""split_level""split_level""split_level""split_level"

setzt die erlaubten Parallelisierungsebenen für die indizierten AOP-Sets. Mögliche Werte sind 'split_tuple'"split_tuple""split_tuple""split_tuple""split_tuple""split_tuple", 'split_channel'"split_channel""split_channel""split_channel""split_channel""split_channel", 'split_domain'"split_domain""split_domain""split_domain""split_domain""split_domain" und 'split_partial'"split_partial""split_partial""split_partial""split_partial""split_partial".

Achtung

set_aop_infoset_aop_infoSetAopInfoset_aop_infoSetAopInfoSetAopInfo verändert die AOP-Systemwissensbasis. Diese Änderungen werden ebenfalls durch write_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledge gespeichert. Es wird empfohlen eine Backup-Datei zu halten bevor das Systemwissen geändert wird.

Parallelisierung

• Multithreading-Typ: exclusive (läuft parallel nur zu unabhängigen Operatoren).
• Multithreading-Bereich: local (kann nur von dem Thread aufgerufen werden, in dem die Fenster-, Modell- oder Tool-Instanz erzeugt wurde).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Ergebnis

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

Modul

Foundation