get_aop_info — Return AOP information for operators.
HALCON supports a mechanism to optimize the behavior of automatic operator parallelization (AOP) for a given hardware of a machine. The information for this optimization can be determined by the operator optimize_aop and can also be partly modified by the operator set_aop_info.
To address specific AOP information, the operator's optimization data is indexed within a 3-ary hierarchy that can be obtained by query_aop_info. The three hierarchy stages are indexed by the operator name, passed in OperatorName, 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 IndexName and IndexValue. IndexName holds the dimension identifier whereas IndexValue holds the index value as retured in query_aop_info.
get_aop_info returns the specific information parts of an operator's AOP knowledge in InfoValue if exactly one index per stage was set. The scope of information is specified by InfoName and supports following values:
returns the maximum allowed thread number. If no optimization data is stored, InfoValue contains -1. In case the specified operator does not support automatic parallelization, 1 is returned.
returns all allowed data split levels of the automatic parallelization for this operator, the specified iconic type and parameter value. Possible levels are 'split_tuple', 'split_channel', 'split_domain', and 'split_partial'. If no split level is supported or every level was switched off for the indexed operator an empty string '' is returned. Use get_operator_info to query all split levels generally supported by an operator.
returns the stored model type. Possible values are 'threshold', 'linear', and 'mlp' (see also the description of operator optimize_aop). If no optimization data is stored, an empty string is returned.
Operator to get information for
Suggested values: 'mean_image', 'opening_circle', 'find_shape_model'
Further index stages
Default value: ['iconic_type','parameter:0']
Further index values
Number of elements: IndexName == IndexValue
Default value: ['byte','']
Scope of information
Default value: 'max_threads'
Suggested values: 'max_threads', 'split_level', 'model'
Value of information
get_aop_info returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.