Operator Reference

HALCON Operator Reference / Filters / Wiener Filter
ClassesClasses | | Operators

simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion (Operator)

simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion — Simulation of (linearly) motion blur.

Signature

simulate_motion(Image : MovedImage : Blurring, Angle, Type : )

Herror simulate_motion(const Hobject Image, Hobject* MovedImage, double Blurring, const Hlong Angle, const Hlong Type)

Herror T_simulate_motion(const Hobject Image, Hobject* MovedImage, const Htuple Blurring, const Htuple Angle, const Htuple Type)

void SimulateMotion(const HObject& Image, HObject* MovedImage, const HTuple& Blurring, const HTuple& Angle, const HTuple& Type)

HImage HImage::SimulateMotion(double Blurring, Hlong Angle, Hlong Type) const

static void HOperatorSet.SimulateMotion(HObject image, out HObject movedImage, HTuple blurring, HTuple angle, HTuple type)

HImage HImage.SimulateMotion(double blurring, int angle, int type)

def simulate_motion(image: HObject, blurring: float, angle: int, type: int) -> HObject

Description

simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion simulates blurring caused by a relative motion between the object and the camera during exposure. The simulated motion moves along an even. AngleAngleAngleangleangle fixes its direction by specifying the angle between the motion direction and the x-axis (anticlockwise, measured in degrees). Simulation is done by a convolution of the image with a blurring specific impulse response. The convolution is realized by multiplication in the Fourier domain. simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion offers five prototypes of impulse responses conforming to different acceleration behaviors. TypeTypeTypetypetype allows to choose one of the following PSF prototypes:

  1. reverse ramp (crude model for acceleration)

  2. reverse trapezoid (crude model for high acceleration)

  3. square pulse (exact model for constant velocity), this is default

  4. forward trapezoid (crude model for deceleration)

  5. forward ramp (crude model for high deceleration)

(default value is 3.)

The simulated blurring affects all part of the image uniformly. BlurringBlurringBlurringblurringblurring controls the extent of blurring. It specifies the number of pixels (lying one after another) that are affected by the blurring. This number is determined by velocity of the motion and exposure time. If BlurringBlurringBlurringblurringblurring is a negative number, an adequate blurring in reverse direction is simulated. If AngleAngleAngleangleangle is a negative number, it is interpreted clockwise. If AngleAngleAngleangleangle exceeds 360 or falls below -360, it is transformed modulo(360) in an adequate number between [0..360] resp. [-360..0].

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.
  • Automatically parallelized on channel level.

Parameters

ImageImageImageimageimage (input_object)  (multichannel-)image(-array) → objectHImageHObjectHObjectHobject (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)

image to be blurred.

MovedImageMovedImageMovedImagemovedImagemoved_image (output_object)  image → objectHImageHObjectHObjectHobject * (real)

motion blurred image.

BlurringBlurringBlurringblurringblurring (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

extent of blurring.

Default: 20.0

Suggested values: 5.0, 10.0, 20.0, 30.0, 40.0

AngleAngleAngleangleangle (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Angle between direction of motion and x-axis (anticlockwise).

Default: 0

Suggested values: 0, 45, 90, 180, 270

TypeTypeTypetypetype (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

impulse response of motion blur.

Default: 3

List of values: 1, 2, 3, 4, 5

Result

simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion returns 2 ( H_MSG_TRUE) if all parameters are correct. If the input is empty simulate_motionsimulate_motionSimulateMotionSimulateMotionsimulate_motion returns with an error message.

Possible Predecessors

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotiongen_psf_motion, gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotiongen_psf_motion

Possible Successors

simulate_defocussimulate_defocusSimulateDefocusSimulateDefocussimulate_defocus, wiener_filterwiener_filterWienerFilterWienerFilterwiener_filter, wiener_filter_niwiener_filter_niWienerFilterNiWienerFilterNiwiener_filter_ni

See also

gen_psf_motiongen_psf_motionGenPsfMotionGenPsfMotiongen_psf_motion, simulate_defocussimulate_defocusSimulateDefocusSimulateDefocussimulate_defocus, gen_psf_defocusgen_psf_defocusGenPsfDefocusGenPsfDefocusgen_psf_defocus

References

Anil K. Jain:Fundamentals of Digital Image Processing, Prentice-Hall International Inc., Englewood Cliffs, New Jersey, 1989
M. Lückenhaus:“Grundlagen des Wiener-Filters und seine Anwendung in der Bildanalyse”; Diplomarbeit; Technische Universität München, Institut für Informatik; Lehrstuhl Prof. Radig; 1995.
Kha-Chye Tan, Hock Lim, B. T. G. Tan:“Restoration of Real-World Motion-Blurred Images”;S. 291-299 in: CVGIP Graphical Models and Image Processing, Vol. 53, No. 3, May 1991

Module

Foundation

ClassesClasses | | Operators