test_equal_objtest_equal_objtest_equal_objTestEqualObjTestEqualObj (Operator)

Name

test_equal_objtest_equal_objtest_equal_objTestEqualObjTestEqualObj — Compare image objects regarding equality.

Signature

Description

The operator test_equal_objtest_equal_objtest_equal_objTestEqualObjTestEqualObj compares the regions and gray value components of all objects of the two input parameters. The n-th object in Objects1Objects1Objects1Objects1objects1 is compared to the n-th object in Objects2Objects2Objects2Objects2objects2 (for all n). If all corresponding regions are equal and the number of regions is also identical the parameter IsEqualIsEqualIsEqualIsEqualisEqual is set to TRUE, otherwise FALSE.

Attention

Image matrices and XLDs are not compared regarding their contents. Thus, two images or XLDs, respectively, are “equal” if they are located at the same place in the storage. By contrast, regions that are not located at the same place in the storage are compared regarding their actual contents. If the input parameters are empty and the behavior was set via the operator set_system(::'no_object_result','true':)set_system("no_object_result","true")set_system("no_object_result","true")SetSystem("no_object_result","true")SetSystem("no_object_result","true"), the parameter IsEqualIsEqualIsEqualIsEqualisEqual is set to TRUE, since all input (= empty set) is equal.

Parallelization

• Supports objects on compute devices.
• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Complexity

If F is the area of a region the runtime complexity is O(1) or O(sqrt(F)) if the result is TRUE and O(sqrt(F)) if the result is FALSE.

Result

The operator test_equal_objtest_equal_objtest_equal_objTestEqualObjTestEqualObj returns the value 2 (H_MSG_TRUE) if the parameters are correct. The behavior in case of empty input (no input objects available) is set via the operator set_system(::'no_object_result',<Result>:)set_system("no_object_result",<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>). If the number of objects differs an exception is raised. Else test_equal_objtest_equal_objtest_equal_objTestEqualObjTestEqualObj returns 2 (H_MSG_TRUE)

See also

test_equal_regiontest_equal_regiontest_equal_regionTestEqualRegionTestEqualRegion

Module

Foundation