get_bg_esti

get_bg_esti_params ( : : BgEstiHandle : Syspar1, Syspar2, GainMode, Gain1, Gain2, AdaptMode, MinDiff, StatNum, ConfidenceC, TimeC )

Return the parameters of the data set.

get_bg_esti_params returns the parameters of the data set. The returned parameters are the same as in create_bg_esti and set_bg_esti_params (see these for an explanation).

Parameters

`BgEstiHandle` (input_control)	bg_estimation `->` integer
ID of the BgEsti data set.

`Syspar1` (output_control)	real `->` real
1. system matrix parameter.

`Syspar2` (output_control)	real `->` real
2. system matrix parameter.

`GainMode` (output_control)	string `->` string
Gain type.

`Gain1` (output_control)	real `->` real
Kalman gain / foreground adaptation time.

`Gain2` (output_control)	real `->` real
Kalman gain / background adaptation time.

`AdaptMode` (output_control)	string `->` string
Threshold adaptation.

`MinDiff` (output_control)	real `->` real
Foreground / background threshold.

`StatNum` (output_control)	integer `->` integer
Number of statistic data sets.

`ConfidenceC` (output_control)	real `->` real
Confidence constant.

`TimeC` (output_control)	real `->` real
Constant for decay time.

Example

/* read Init-Image:*/
read_image(InitImage,'Init_Image') 
/* 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(Image1,'Image_1') 
/* estimate the Background: */
run_bg_esti(Image1,Region1,BgEstiHandle) 
/* display the foreground region: */
disp_region(Region1,WindowHandle)  
/* read the next image in sequence: */
read_image(Image2,'Image_2') 
/* estimate the Background: */
run_bg_esti(Image2,Region2,BgEstiHandle) 
/* display the foreground region: */
disp_region(Region2,WindowHandle) 
/* etc. */
/* change only the gain parameter in dataset: */
get_bg_esti_params(BgEstiHandle,par1,par2,par3,par4,
                   par5,par6,par7,par8,par9,par10) 
set_bg_esti_params(BgEstiHandle,par1,par2,par3,0.004,
                   0.08,par6,par7,par8,par9,par10) 
/* read the next image in sequence: */
read_image(Image3,'Image_3') 
/* estimate the Background: */
run_bg_esti(Image3,Region3,BgEstiHandle) 
/* display the foreground region: */
disp_region(Region3,WindowHandle)  
/* etc. */

Result

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

Parallelization Information

get_bg_esti_params is reentrant and processed without parallelization.

Possible Predecessors

create_bg_esti

Possible Successors

run_bg_esti

See also

set_bg_esti_params

Module

Foundation