plane_deviation plane_deviation PlaneDeviation PlaneDeviation plane_deviation (Operator)
Name
plane_deviation plane_deviation PlaneDeviation PlaneDeviation plane_deviation
— Calculate the deviation of the gray values from the approximating
image plane.
Signature
def plane_deviation (regions : HObject, image : HObject) -> Sequence[float]
def plane_deviation_s (regions : HObject, image : HObject) -> float
Description
The operator plane_deviation plane_deviation PlaneDeviation PlaneDeviation PlaneDeviation plane_deviation
calculates the deviation of
the gray values in Image Image Image Image image image
from the approximation of the
gray values through a plane. Contrary to the standard deviation in
case of intensity intensity Intensity Intensity Intensity intensity
slanted gray value planes also
receive the value zero. The gray value plane is calculated
according to gen_image_gray_ramp gen_image_gray_ramp GenImageGrayRamp GenImageGrayRamp GenImageGrayRamp gen_image_gray_ramp
.
If F is the area of the region,
,
,
and
the parameters of the
image plane, and (r',c') the center of the region, Deviation Deviation Deviation Deviation deviation deviation
is
defined by:
Attention
Note that the operator plane_deviation plane_deviation PlaneDeviation PlaneDeviation PlaneDeviation plane_deviation
only considers
the given Regions Regions Regions Regions regions regions
and ignores any previously set domain
of the input image Image Image Image Image image image
.
It should be noted that the calculation of Deviation Deviation Deviation Deviation deviation deviation
does
not follow the usual definition. It is defined to return the value
0.0 for an image with only one pixel.
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on tuple level.
Parameters
Regions Regions Regions Regions regions regions
(input_object) region(-array) →
object HRegion HObject HRegion Hobject
Regions, of which the plane deviation is to be
calculated.
Image Image Image Image image image
(input_object) singlechannelimage →
object HImage HObject HImage Hobject (byte / cyclic)
Gray value image.
Deviation Deviation Deviation Deviation deviation deviation
(output_control) real(-array) →
HTuple Sequence[float] HTuple Htuple (real) (double ) (double ) (double )
Deviation of the gray values within a region.
Complexity
If F is the area of the region the runtime complexity amounts to
O(F).
Result
The operator plane_deviation plane_deviation PlaneDeviation PlaneDeviation PlaneDeviation plane_deviation
returns the value 2 (H_MSG_TRUE) if
Image Image Image Image image image
is of the type 'byte' "byte" "byte" "byte" "byte" "byte" . The behavior in
case of empty input (no input images available) is set via the operator
set_system(::'no_object_result',<Result>:) set_system("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) SetSystem("no_object_result",<Result>) set_system("no_object_result",<Result>)
,
the behavior in case of empty region is set via
set_system(::'empty_region_result',<Result>:) set_system("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) SetSystem("empty_region_result",<Result>) set_system("empty_region_result",<Result>)
.
If necessary an exception is raised.
Alternatives
intensity intensity Intensity Intensity Intensity intensity
,
gen_image_gray_ramp gen_image_gray_ramp GenImageGrayRamp GenImageGrayRamp GenImageGrayRamp gen_image_gray_ramp
,
sub_image sub_image SubImage SubImage SubImage sub_image
See also
moments_gray_plane moments_gray_plane MomentsGrayPlane MomentsGrayPlane MomentsGrayPlane moments_gray_plane
Module
Foundation