load_par_knowledge [HALCON Operator-Referenz / Version 12.0.2]

load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge — Lade das Wissen zur automatischen Parallelisierung aus Datei.

Warnung

Signatur

load_par_knowledge( : : FileName : )

Herror load_par_knowledge(const char* FileName)

Herror T_load_par_knowledge(const Htuple FileName)

Herror load_par_knowledge(const HTuple& FileName)

void LoadParKnowledge(const HTuple& FileName)

static void HSystem::LoadParKnowledge(const HString& FileName)

static void HSystem::LoadParKnowledge(const char* FileName)

void HOperatorSetX.LoadParKnowledge([in] VARIANT FileName)

void HSystemX.LoadParKnowledge([in] BSTR FileName)

static void HOperatorSet.LoadParKnowledge(HTuple fileName)

static void HSystem.LoadParKnowledge(string fileName)

Beschreibung

load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge wird verwendet, um die automatische Parallelisierung von HALCON-Operatoren zu unterstützen. HALCON verwendet intern einen Parallelisierungsmechanismus, um Mehrprozessorarchitekturen besser zu nutzen und die Bearbeitungsdauer von Operatoren zu verkürzen. Um diese Parallelisierung automatisch durchführen zu können, benötigt HALCON spezielles Wissen über die verwendete Hardware bzw. über deren Potential, die verschiedenen HALCON-Operatoren parallel zu verarbeiten. Dieses Wissen ist rechnerspezifisch und kann mit dem Operator check_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential trainiert bzw. erlernt werden. HALCON speichert dieses Wissen in der „Registry“ (unter Windows) bzw. in einer Datei im HALCON-Installationsverzeichnis (unter Linux/OS X), so dass das einmal erworbene Wissen bei jeder weiteren Verwendung von HALCON auf demselben Rechner zur Verfügung steht. load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge ermöglicht es nun, dieses intern in HALCON verwendete Wissen aus einer speziellen ASCII-Datei einzulesen, die zuvor mit dem Operator store_par_knowledgestore_par_knowledgeStoreParKnowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge geschrieben wurde. Der Name der Datei (inkl. Pfad und „Extension“) muss beim Aufruf von load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge in FileNameFileNameFileNameFileNameFileNamefileName übergeben werden. Beim Einlesen der Datei wird überprüft, ob die Informationen in der Datei auf dem gegenwärtig verwendeten Rechner erzeugt wurden und ob sie für die gegenwärtig verwendete HALCON-Version (und -Revision) gelten. Ist dies der Fall, wird die Information übernommen und resident gespeichert. Anderenfalls wird die Information ignoriert und eine entsprechende Fehlermeldung zurückgegeben.

Parallelisierung

Parameter

FileNameFileNameFileNameFileNameFileNamefileName (input_control) filename.read → (string)

Name der Datei des Parallelisierungswissens.

Defaultwert: '' "" "" "" "" ""

Ergebnis

Sind die Parameterwerte korrekt, dann liefert load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge den Wert 2 (H_MSG_TRUE).

load_par_knowledgeload_par_knowledgeLoadParKnowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge (Operator)

Name