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_aopOptimizeAopOptimizeAopoptimize_aop Abhängigkeiten des Laufzeitverhaltens von der Hardware und Eingabeparametern ermittelt werden. Der Operator get_aop_infoget_aop_infoGetAopInfoGetAopInfoget_aop_info liest Elemente dieser Informationen, während diese durch den Operator set_aop_infoset_aop_infoSetAopInfoSetAopInfoset_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_infoQueryAopInfoQueryAopInfoquery_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 OperatorNameOperatorNameOperatorNameoperatorNameoperator_name übergeben wird, definieren IndexNameIndexNameIndexNameindexNameindex_name und IndexValueIndexValueIndexValueindexValueindex_value die letzteren beiden Indizes. IndexNameIndexNameIndexNameindexNameindex_name erhält dabei die Indexkennung, IndexValueIndexValueIndexValueindexValueindex_value den Indexwert, wie sie von query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoquery_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 OperatorNameOperatorNameOperatorNameoperatorNameoperator_name, dem Tupel ['iconic_type','iconic_type']["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"] für IndexNameIndexNameIndexNameindexNameindex_name und dem Tupel ['byte','uint2']["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"] für IndexValueIndexValueIndexValueindexValueindex_value alle Operatoren adressiert, die Byte oder UINT2 Bilder verarbeiten.

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

'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"

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_channel'"split_channel""split_channel""split_channel""split_channel", 'split_domain'"split_domain""split_domain""split_domain""split_domain" und 'split_partial'"split_partial""split_partial""split_partial""split_partial".

Achtung

set_aop_infoset_aop_infoSetAopInfoSetAopInfoset_aop_info verändert die AOP-Systemwissensbasis. Diese Änderungen werden ebenfalls durch write_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledgewrite_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_knowledgeReadAopKnowledgeReadAopKnowledgeread_aop_knowledge den Wert 2 ( H_MSG_TRUE) . Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.

Modul

Foundation