store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge (Operator)

Name

store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge — Store knowledge about automatic parallelization in file.

Warning

store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge is obsolete and is only provided for reasons of backward compatibility. New applications should use the operator write_aop_knowledgewrite_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledge to store optimization data for the automatic operator parallelization instead.

Signature

Description

store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge 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 calling the operator check_par_hw_potentialcheck_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential. There, HALCON stores the 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 store_par_knowledgestore_par_knowledgestore_par_knowledgeStoreParKnowledgeStoreParKnowledge it is possible to store this knowledge explicitly as an ASCII file. At this, FileNameFileNameFileNameFileNamefileName denotes the name of this file (incl. path and file extension). The stored knowledge can be read again later on by using load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge.

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

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

Possible Predecessors

check_par_hw_potentialcheck_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential

Possible Successors

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge

See also

load_par_knowledgeload_par_knowledgeload_par_knowledgeLoadParKnowledgeLoadParKnowledge, check_par_hw_potentialcheck_par_hw_potentialcheck_par_hw_potentialCheckParHwPotentialCheckParHwPotential

Module

Foundation