set_aop_infoset_aop_infoSetAopInfoSetAopInfo (Operator)

Name

set_aop_infoset_aop_infoSetAopInfoSetAopInfo — Set AOP information for operators.

Signature

Description

HALCON supports a mechanism to adapt the behavior of automatic parallelization of image processing operators (AOP) to the machine's hardware capability. The information for this adaption can be obtained by the operator optimize_aopoptimize_aopOptimizeAopOptimizeAopOptimizeAop and can also be partly read by the operator set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfo.

To address specific AOP information the operator's optimization data is indexed within a 3-ary hierarchy that can be obtained by query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoQueryAopInfo. The three hierarchy stages are indexed by the operator name, passed in OperatorNameOperatorNameOperatorNameOperatorNameoperatorName, the iconic type, and a parameter string value denoting a special mode or method supported by the indexed operator. The latter two indices are passed by IndexNameIndexNameIndexNameIndexNameindexName and IndexValueIndexValueIndexValueIndexValueindexValue. IndexNameIndexNameIndexNameIndexNameindexName holds the dimension identifier whereas IndexValueIndexValueIndexValueIndexValueindexValue addresses the index as retured in query_aop_infoquery_aop_infoQueryAopInfoQueryAopInfoQueryAopInfo. It is also possible to address multiple indices on the same stage to set a specific information value to multiple knowledge sets. Omitting an index name or passing an empty string as index value addresses this stage in all. E.g., passing ''"""""""" to OperatorNameOperatorNameOperatorNameOperatorNameoperatorName, the tuple ['iconic_type','iconic_type']["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"]["iconic_type","iconic_type"] to IndexNameIndexNameIndexNameIndexNameindexName, and the tuple ['byte','uint2']["byte","uint2"]["byte","uint2"]["byte","uint2"]["byte","uint2"] to IndexValueIndexValueIndexValueIndexValueindexValue addresses all operators processing byte or uint2 images.

set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfo sets the specific information parts of an operator's AOP knowledge passed in InfoValueInfoValueInfoValueInfoValueinfoValue. The scope of information is specified by InfoNameInfoNameInfoNameInfoNameinfoName and supports the following:

'max_threads'"max_threads""max_threads""max_threads""max_threads"

sets the maximum allowed thread number this operator is allowed to run with the specified iconic type and parameter value.

'split_level'"split_level""split_level""split_level""split_level"

sets the allowed data split levels of the automatic parallelization for this operator, the specified iconic type and parameter value. Possible levels are '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", and 'split_partial'"split_partial""split_partial""split_partial""split_partial".

Attention

set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfo modifies the AOP system knowledge. These modifications will also be stored by write_aop_knowledgewrite_aop_knowledgeWriteAopKnowledgeWriteAopKnowledgeWriteAopKnowledge. It is advisable to have a backup knowledge file before modifying the system knowledge.

Execution Information

• 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

set_aop_infoset_aop_infoSetAopInfoSetAopInfoSetAopInfo returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Module

Foundation