info_smooth T_info_smooth InfoSmooth InfoSmooth info_smooth (Operator)
Name
info_smooth T_info_smooth InfoSmooth InfoSmooth info_smooth — Information on smoothing filter smooth_image smooth_image SmoothImage SmoothImage SmoothImage smooth_image .
Signature
def info_smooth (filter : str, alpha : float) -> Tuple[int, Sequence[int]]
Description
The operator info_smooth info_smooth InfoSmooth InfoSmooth InfoSmooth info_smooth returns an estimation of the
width of the smoothing filters used in routine smooth_image smooth_image SmoothImage SmoothImage SmoothImage smooth_image .
For this purpose the underlying continuous impulse answers of
Filter Filter Filter Filter filter filter are scanned until a filter coefficient is smaller
than five percent of the maximum coefficient (at the origin).
Alpha Alpha Alpha Alpha alpha alpha is the filter parameter (see smooth_image smooth_image SmoothImage SmoothImage SmoothImage smooth_image ).
Currently four filters are supported (parameter Filter Filter Filter Filter filter filter ):
'deriche1', 'deriche2', 'shen' and 'gauss'.
The gauss filter was conventionally implemented with filter masks
(the other three are recursive filters). In the case of the gauss
filter the filter coefficients (of the one-dimensional impulse
answer
) are returned
in Coeffs Coeffs Coeffs Coeffs coeffs coeffs in addition to the filter size.
For an explanation of the concept of smoothing filters see the introduction
of chapter Filters / Smoothing .
Attention
Note that filter operators may return unexpected results if
an image with a reduced domain is used as input. Please refer to the
chapter Filters .
Execution Information
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.
Parameters
Filter Filter Filter Filter filter filter (input_control) string → HTuple str HTuple Htuple (string) (string ) (HString ) (char* )
Name of required filter.
Default value:
'deriche2'
"deriche2"
"deriche2"
"deriche2"
"deriche2"
"deriche2"
List of values: 'deriche1' "deriche1" "deriche1" "deriche1" "deriche1" "deriche1" , 'deriche2' "deriche2" "deriche2" "deriche2" "deriche2" "deriche2" , 'gauss' "gauss" "gauss" "gauss" "gauss" "gauss" , 'shen' "shen" "shen" "shen" "shen" "shen"
Alpha Alpha Alpha Alpha alpha alpha (input_control) real → HTuple float HTuple Htuple (real) (double ) (double ) (double )
Filter parameter: small values effect strong
smoothing (reversed in case of 'gauss').
Default value: 0.5
Suggested values: 0.5, 1.0, 1.5, 2.0, 2.5, 3.0, 4.0, 5.0, 7.0, 10.0
Minimum increment: 0.01
Recommended increment: 0.1
Restriction: Alpha > 0.0
Size Size Size Size size size (output_control) integer → HTuple int HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
Width of filter is approx. size x size pixels.
Coeffs Coeffs Coeffs Coeffs coeffs coeffs (output_control) integer-array → HTuple Sequence[int] HTuple Htuple (integer) (int / long) (Hlong ) (Hlong )
In case of gauss filter: coefficients of the “positive”
half of the 1D impulse answer.
Example (HDevelop)
info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)
Example (C)
info_smooth('deriche2',0.5,Size,Coeffs);
smooth_image(Input,&Smooth,'deriche2',7);
Example (HDevelop)
info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)
Example (HDevelop)
info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)
Example (HDevelop)
info_smooth('deriche2',0.5,Size,Coeffs)
smooth_image(Input,Smooth,'deriche2',7)
Result
If the parameter values are correct the operator
info_smooth info_smooth InfoSmooth InfoSmooth InfoSmooth info_smooth returns the value 2 (H_MSG_TRUE ). Otherwise an
exception is raised.
Possible Predecessors
read_image read_image ReadImage ReadImage ReadImage read_image
Possible Successors
smooth_image smooth_image SmoothImage SmoothImage SmoothImage smooth_image
See also
smooth_image smooth_image SmoothImage SmoothImage SmoothImage smooth_image
Module
Foundation