load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge (Operator)

Name

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge — Load knowledge about automatic parallelization from file.

Warning

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge is obsolete and is only provided for reasons of backward compatibility. New applications should use the operator read_aop_knowledgeread_aop_knowledgeread_aop_knowledgeReadAopKnowledgeReadAopKnowledge to load optimization data for the automatic operator parallelization instead.

Signature

Description

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge supports the automatic parallelization of HALCON operators, which is used to better utilize multiprocessor hardware in order to speed up the processing of operators. To parallelize the processing of operators automatically HALCON needs some specific knowledge about the used hardware. This hardware-specific knowledge can be obtained by using the operator check_par_hw_potentialcheck_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential. In the normal case, HALCON stores this knowledge in a specific file in the HALCON installation directory (Linux/UNIX) or within the “registry” (Windows). This enables HALCON to use the knowledge again later on. With load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge it is possible to load this knowledge explicitly from an ASCII file. At this, FileNameFileNameFileNameFileNamefileName denotes the name of this file (incl. path and file extension). The file must conform to a specific syntax and must have been stored beforehand by using store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge. While reading the file load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge checks whether its content was written for the currently used computer and whether the contained parallelization information regards the currently used HALCON version (and revision). If this is the case, load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge adopts the information so that it will also be used with further HALCON sessions. Otherwise, the information is ignored and load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge returns an appropriate error message.

Parallelization

• Multithreading type: exclusive (runs in parallel only with independent operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

Result

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge returns 2 (H_MSG_TRUE) if all parameters are correct.

Possible Predecessors

store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge

See also

store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge, check_par_hw_potentialcheck_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential

Module

Foundation