set_bg_esti_paramsT_set_bg_esti_paramsSetBgEstiParamsSetBgEstiParamsset_bg_esti_params (Operator)

Name

set_bg_esti_paramsT_set_bg_esti_paramsSetBgEstiParamsSetBgEstiParamsset_bg_esti_params — Ändert im Datensatz die Parameter.

Signatur

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

Beschreibung

Mit set_bg_esti_paramsset_bg_esti_paramsSetBgEstiParamsSetBgEstiParamsSetBgEstiParamsset_bg_esti_params werden die Parameter im Datensatz verändert. Die übergebenen Parameter sind identisch mit denen für create_bg_esticreate_bg_estiCreateBgEstiCreateBgEstiCreateBgEsticreate_bg_esti (Erklärung siehe dort).

Das Bildformat kann jedoch nicht geändert werden, hierfür muss ein neuer Datensatz angelegt werden, bei dem das Initialisierungsbild das gewünschte Format hat.

Soll das Hintergrundbild komplett ausgetauscht werden, so muss update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiUpdateBgEstiupdate_bg_esti verwendet werden. Es muss dann sowohl für das Eingabebild und auch für die Up-Date-Region das aktuelle Bild angegeben werden.

Achtung

Wenn GainModeGainModeGainModeGainModegainModegain_mode = 'frame'"frame""frame""frame""frame""frame" gewählt wurde, kann bei der Wahl von großen Werten für Gain1Gain1Gain1Gain1gain1gain_1 oder Gain2Gain2Gain2Gain2gain2gain_2 die Laufzeit sehr groß werden, da die Werte für die Gaintabelle mit einem eindimensionalen Optimierer (binäre Suche) bestimmt werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

BgEstiHandleBgEstiHandleBgEstiHandleBgEstiHandlebgEstiHandlebg_esti_handle (input_control) bg_estimation → (handle)

ID des BgEsti-Datensatzes.

Syspar1Syspar1Syspar1Syspar1syspar1syspar_1 (input_control) real → (real)

1. Parameter der Systemmatrix.

Defaultwert: 0.7

Wertevorschläge: 0.65, 0.7, 0.75

Typischer Wertebereich: 0.05 ≤ Syspar1 Syspar1 Syspar1 Syspar1 syspar1 syspar_1 ≤ 1.0

Empfohlene Schrittweite: 0.05

Syspar2Syspar2Syspar2Syspar2syspar2syspar_2 (input_control) real → (real)

2. Parameter der Systemmatrix.

Defaultwert: 0.7

Wertevorschläge: 0.65, 0.7, 0.75

Typischer Wertebereich: 0.05 ≤ Syspar2 Syspar2 Syspar2 Syspar2 syspar2 syspar_2 ≤ 1.0

Empfohlene Schrittweite: 0.05

GainModeGainModeGainModeGainModegainModegain_mode (input_control) string → (string)

Art der Gains.

Defaultwert: 'fixed' "fixed" "fixed" "fixed" "fixed" "fixed"

Werteliste: 'fixed'"fixed""fixed""fixed""fixed""fixed", 'frame'"frame""frame""frame""frame""frame"

Gain1Gain1Gain1Gain1gain1gain_1 (input_control) real → (real)

Kalmangain / Adaptionszeit für Vordergrund.

Defaultwert: 0.002

Wertevorschläge: 10.0, 20.0, 50.0, 0.1, 0.05, 0.01, 0.005, 0.001

Restriktion: 0.0 <= Gain1

Gain2Gain2Gain2Gain2gain2gain_2 (input_control) real → (real)

Kalmangain / Adaptionszeit für Hintergrund.

Defaultwert: 0.02

Wertevorschläge: 2.0, 4.0, 8.0, 0.5, 0.1, 0.05, 0.01

Restriktion: 0.0 <= Gain2

AdaptModeAdaptModeAdaptModeAdaptModeadaptModeadapt_mode (input_control) string → (string)

Adaption der Schwelle.

Defaultwert: 'on' "on" "on" "on" "on" "on"

Werteliste: 'off'"off""off""off""off""off", 'on'"on""on""on""on""on"

MinDiffMinDiffMinDiffMinDiffminDiffmin_diff (input_control) real → (real)

Schwelle, für Vordergrund / Hintergrund.

Defaultwert: 7.0

Wertevorschläge: 3.0, 5.0, 7.0, 9.0, 11.0

Empfohlene Schrittweite: 0.2

StatNumStatNumStatNumStatNumstatNumstat_num (input_control) integer → (integer)

Anzahl statistischer Datensätze.

Defaultwert: 10

Wertevorschläge: 5, 10, 20, 30

Typischer Wertebereich: 1 ≤ StatNum StatNum StatNum StatNum statNum stat_num

Empfohlene Schrittweite: 5

ConfidenceCConfidenceCConfidenceCConfidenceCconfidenceCconfidence_c (input_control) real → (real)

Konfidenzkonstante.

Defaultwert: 3.25

Wertevorschläge: 4.30, 3.25, 2.82, 2.62

Empfohlene Schrittweite: 0.01

Restriktion: 0.0 < ConfidenceC

TimeCTimeCTimeCTimeCtimeCtime_c (input_control) real → (real)

Abklingkonstante.

Defaultwert: 15.0

Wertevorschläge: 10.0, 15.0, 20.0

Empfohlene Schrittweite: 5.0

Restriktion: 0.0 < TimeC

Beispiel (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.
* Change parameter in dataset:
set_bg_esti_params(BgEstiHandle,0.7,0.7,'fixed', \
                    0.004,0.08,'on',9.0,10,3.25,20.0)
* Read the next image in sequence:
read_image(Image2,'xing/xing002')
* Estimate the background:
run_bg_esti(Image2,ForegroundRegion3,BgEstiHandle)
* Display the foreground region:
dev_display(ForegroundRegion3)
* etc.

Ergebnis

set_bg_esti_paramsset_bg_esti_paramsSetBgEstiParamsSetBgEstiParamsSetBgEstiParamsset_bg_esti_params liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind.

Vorgänger

create_bg_esticreate_bg_estiCreateBgEstiCreateBgEstiCreateBgEsticreate_bg_esti

Nachfolger

run_bg_estirun_bg_estiRunBgEstiRunBgEstiRunBgEstirun_bg_esti

Siehe auch

update_bg_estiupdate_bg_estiUpdateBgEstiUpdateBgEstiUpdateBgEstiupdate_bg_esti

Modul

Foundation

Operatoren