About Kalman filter

[Toach-2021]

Hello,

I have a very naive question, but how can I use Kalman filter for running inference with GUI?

When I run, I always get the error "Kalman filter requires target instance count".
I already prepared some predicted frames in the video.
I would appreciate any advice.

Thank you in advance.

[roomrys]

Hi @Toach-2021,

I wouldn't recommend using the Kalman Filters as they historically have not improved tracking, but if you would like to give them a try - then, I think the error message is telling you to set a Target Instance Count which would be the first input parameter under tracking named "Cull to Target Instance Count".

Thanks,
Liezl

[Toach-2021]

Dear Liezl,

Thank you very much for your comment!
I would like to try the Kalman filter to smooth out the tracking because inevitably some individuals would not be detected or their locations would be blurred...

About Target Instance Count, I'm sorry but I could not find that option...
Maybe I missed but I would appreciate if you could tell me how to set it.

Best,

[roomrys]

Hi @Toach-2021,

Apologies, I was writing from memory, but we recently made some changes to these parameters. There used to be a "Cull to Target Instance Count" parameter and "Target Number of Instances Per Frame" parameter that has now been replaced (in desired functionality) with "Max number of tracks" in #1447 - basically removing instances over a set limit earlier on in the tracking.

Although it looks like the variable names for these three parameters are different and although they have been removed from the GUI, the variables have not been refactored to reflect the preference for "Max number of Tracks".

sleap/sleap/config/pipeline_form.yaml

Lines 379 to 395 in 0b2fdd9

	# - type: text
	# text: '<b>Pre-tracker data cleaning</b>:'
	# - name: tracking.target_instance_count
	# label: Target Number of Instances Per Frame
	# type: optional_int
	# none_label: No target
	# default_disabled: true
	# range: 1,100
	# default: 1
	# - name: tracking.pre_cull_to_target
	# label: Cull to Target Instance Count
	# type: bool
	# default: false
	# - name: tracking.pre_cull_iou_threshold
	# label: Cull using IoU Threshold
	# type: double
	# default: 0.8

So, this is a GUI bug. I've created an issue to track this in #1583. However! Since there hasn't been changes to the variable names, using sleap-track through the CLI will work as intended. I could help you string together the command (given a screenshot of your GUI settings) if you need help. Alternatively, the GUI will output the sleap-track command that it is running (after you hit Run) in the terminal and you can copy/paste that command to tack on a --tracking.target_instance_count <the_max_number_of_instances_per_frame> and rerun it in the terminal (you will need to open a new terminal, activate the sleap environment, and then run the command via the terminal since the GUI will be using the currently open terminal).

Sorry about that,
Liezl