set_aop_infoset_aop_infoSetAopInfoSetAopInfoset_aop_info (Operator)

Name

set_aop_infoset_aop_infoSetAopInfoSetAopInfoset_aop_info — 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_aopOptimizeAopOptimizeAopOptimizeAopoptimize_aop Abhängigkeiten des Laufzeitverhaltens von der Hardware und Eingabeparametern ermittelt werden. Der Operator get_aop_infoget_aop_infoGetAopInfoGetAopInfoGetAopInfoget_aop_info liest Elemente dieser Informationen, während diese durch den Operator set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfoset_aop_info 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_infoQueryAopInfoQueryAopInfoQueryAopInfoquery_aop_info 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 OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name übergeben wird, definieren IndexNameIndexNameIndexNameIndexNameindexNameindex_name und IndexValueIndexValueIndexValueIndexValueindexValueindex_value die letzteren beiden Indizes. IndexNameIndexNameIndexNameIndexNameindexNameindex_name erhält dabei die Indexkennung, IndexValueIndexValueIndexValueIndexValueindexValueindex_value den Indexwert, wie sie von query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoQueryAopInfoquery_aop_info 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 OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name, 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 IndexNameIndexNameIndexNameIndexNameindexNameindex_name und dem Tupel ['byte','uint2']["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"] für IndexValueIndexValueIndexValueIndexValueindexValueindex_value alle Operatoren adressiert, die Byte oder UINT2 Bilder verarbeiten.

set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfoset_aop_info setzt die in InfoValueInfoValueInfoValueInfoValueinfoValueinfo_value übergebenen Informationswerte in dem spezifizierten AOP-Sets. Die Art der Information kann mit dem Parameter InfoNameInfoNameInfoNameInfoNameinfoNameinfo_name 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_infoSetAopInfoSetAopInfoSetAopInfoset_aop_info verändert die AOP-Systemwissensbasis. Diese Änderungen werden ebenfalls durch write_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledgeWriteAopKnowledgewrite_aop_knowledge gespeichert. Es wird empfohlen eine Backup-Datei zu halten bevor das Systemwissen geändert wird.

Ausführungsinformationen

• 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_knowledgeReadAopKnowledgeReadAopKnowledgeReadAopKnowledgeread_aop_knowledge den Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Modul

Foundation