Skip to content

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_estiT_run_bg_esti🔗

Short description🔗

run_bg_estirun_bg_estiRunBgEstiRunBgEstirun_bg_estiT_run_bg_esti — Estimate the background and return the foreground region.

Signature🔗

run_bg_esti( image PresentImage, out region ForegroundRegion, bg_estimation BgEstiHandle )run_bg_esti( PresentImage : ForegroundRegion : BgEstiHandle : )void RunBgEsti( const HObject& PresentImage, HObject* ForegroundRegion, const HTuple& BgEstiHandle )static void HOperatorSet.RunBgEsti( HObject presentImage, out HObject foregroundRegion, HTuple bgEstiHandle )def run_bg_esti( present_image: HObject, bg_esti_handle: HHandle ) -> HObject

Herror T_run_bg_esti( const Hobject PresentImage, Hobject* ForegroundRegion, const Htuple BgEstiHandle )

HRegion HImage::RunBgEsti( const HBgEsti& BgEstiHandle ) const

HRegion HBgEsti::RunBgEsti( const HImage& PresentImage ) const

HRegion HImage.RunBgEsti( HBgEsti bgEstiHandle )

HRegion HBgEsti.RunBgEsti( HImage presentImage )

Description🔗

run_bg_estiRunBgEsti adapts the background image stored in the BgEsti data set using a Kalman filter on each pixel and returns a region of the foreground (detected moving objects).

For every pixel an estimation of its gray value is computed using the values of the current data set and its stored background image and the current image (PresentImagepresentImagepresent_image). By comparison to the threshold (fixed or adaptive, see create_bg_estiCreateBgEsti) the pixels are classified as either foreground or background.

The background estimation processes only single-channel images. Therefore the background has to be adapted separately for every channel.

The background estimation should be used on half- or even quarter-sized images. For this, the input images (and the initialization image!) has to be reduced using zoom_image_factorZoomImageFactor. The advantage is a shorter run-time on one hand and a low-band filtering on the other. The filtering eliminates high frequency noise and results in a more reliable estimation. As a result the threshold (see create_bg_estiCreateBgEsti) can be lowered. The foreground region returned by run_bg_estiRunBgEsti then has to be enlarged again for further processing.

Attention🔗

The passed image (PresentImagepresentImagepresent_image) must have the same type and size as the background image of the current data set (initialized with create_bg_estiCreateBgEsti).

Execution information🔗

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🔗

PresentImagepresentImagepresent_image (input_object) singlechannelimage → object (byte / real)object (byte / real)HObject (byte / real)HImage (byte / real)HObject (byte / real)Hobject (byte / real)

Current image.

ForegroundRegionforegroundRegionforeground_region (output_object) region → objectobjectHObjectHRegionHObjectHobject *

Region of the detected foreground.

BgEstiHandlebgEstiHandlebg_esti_handle (input_control) bg_estimation → (handle)(handle)HTuple (HHandle)HBgEsti, HTuple (IntPtr)HHandleHtuple (handle)

ID of the BgEsti data set.

Example🔗

(HDevelop)


* Read image for initialization:
read_image(InitImage,'xing/init')
* Initialize BgEsti dataset with
* fixed gains and threshold adaption:
create_bg_esti(InitImage,0.7,0.7,'fixed',0.002,0.02, \
               'on',7.0,10,3.25,15.0,BgEstiHandle)
* Read the next image in sequence:
read_image(Image0,'xing/xing000')
* Estimate the background:
run_bg_esti(Image0,ForegroundRegion1,BgEstiHandle)
* Display the foreground region:
dev_display (ForegroundRegion1)
* Read the next image in sequence:
read_image(Image1,'xing/xing001')
* Estimate the background:
run_bg_esti(Image1,ForegroundRegion2,BgEstiHandle)
* Display the foreground region:
dev_display (ForegroundRegion2)
* etc.

Result🔗

run_bg_estiRunBgEsti returns 2 (H_MSG_TRUE) if all parameters are correct.

Combinations with other operators🔗

Combinations

Possible predecessors

create_bg_estiCreateBgEsti, update_bg_estiUpdateBgEsti

Possible successors

give_bg_estiGiveBgEsti, update_bg_estiUpdateBgEsti

See also

set_bg_esti_paramsSetBgEstiParams, create_bg_estiCreateBgEsti, update_bg_estiUpdateBgEsti, give_bg_estiGiveBgEsti

Module🔗

Foundation