get_bg_esti

Herror ::get_bg_esti_params ( const HTuple &BgEstiHandle, double *Syspar1, double *Syspar2, char *GainMode, double *Gain1, double *Gain2, char *AdaptMode, double *MinDiff, long *StatNum, double *ConfidenceC, double *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 `->` HTuple.long
ID of the BgEsti data set.

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

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

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

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

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

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

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

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

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

`TimeC` (output_control)	real `->` double *
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 H_MSG_TRUE if all parameters are correct.

Possible Predecessors

::create_bg_esti

Possible Successors

::run_bg_esti

See also

::set_bg_esti_params

Module

Background estimation