SightLine Applications Command, Control, and Script API  v3.5
List of all members
SLASetAdvancedDetectionParameters_t Struct Reference

Description

Perform advanced control of the MTI parameters.

typedef struct {
s16 minVel8;
s16 maxVel8;
s16 reserved1;
s16 minWide;
s16 maxWide;
s16 minHigh;
s16 maxHigh;
u8 hideOverlapTrks;
u8 nFramesBack;
u8 mergeRadius;
u8 mergeDirTol;
u8 useRegistration;
u8 detUpdateRate;
u8 surroundSize;
u8 reserved3;
u16 bgTimeConst;
u8 bgEdgePenalty6;
u8 bgResetConf;
u8 bgResetOff;
u8 bgResetAng;
u8 bgResetFrames;
u8 bgWarpConf;
u8 bgWarpOff;
u8 bgWarpAng;
u8 bgWarpFrames;
u8 maxTrackFrames;
u8 debugFiltering;
u8 downsample;
u8 maxTelemTrks;
u8 maxKlvTrks;
u8 cameraIndex;
u8 blocksHigh;
u8 blocksWide;
u8 maxDisplayTrks;
u8 ellipsePadding;
u8 closeFilter;
u8 detDirection;

These parameters apply to all modes except where explicitly stated otherwise.
NOTE: Applied to the Command Camera.

Message ID 0x76

Byte Offset Name Description
4-5minVel8Minimum target velocity (256*pixels/frame) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
6-7maxVel8Maximum target velocity (256*pixels/frame) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
8-9reserved1Reserved, previously used for maxmimum acceleration detected, which was removed in version 3.5
10-11minWideMinimum target width (pixels) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
12-13maxWideMaximum target width (pixels) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
14-15minHighMinimum target height (pixels) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
16-17maxHighMaximum target height (pixels) (-1 = not set)
(not used in vehicle, person, drone or gas modes)
18hideOverlapTrks1 = Hide targets that overlap with object tracks – these will not be displayed or reported in telemetry; 0 = Don't hide
(not used in vehicle, person, drone, anomaly, or gas mode)
19nFramesBackNumber of frames to go back in time to compare frames in MTI difference mode, default 15. Parameter only applies to aerial and gas modes.
Aerial: (5 to 15) Use 15 for small slow moving object detection and smaller numbers for faster larger objects.
Gas: (2 to 15) Use 5 for a moving camera. Increase for fixed camera for more sensitivity or decrease for less enhancement.
20mergeRadiusMaximum distance between targets at which they can be merged into a single target (0 to 255 pixels), 0 = automatic, default = 0, typical is 10 to 25
(not used in vehicle, person, drone, anomaly, radiometric, blob, maritime or gas mode)
21mergeDirTolMaximum angle heading difference between targets at which they can be merged (0 to 180 degrees), default = 45 degrees
(not used in vehicle, person, drone, anomaly, radiometric, blob, maritime or gas mode)
22useRegistrationUse registration information to track detections from frame to frame
(not used in vehicle, person, drone, aerial, staring or gas mode)
23detUpdateRateRate we update the background model for detection algorithms, 0-255. Larger values put more emphasis to the current frame.
(not used in vehicle, person, drone, aerial, radiometric, blob, staring or gas mode)
24surroundSizeBlob Detection: size of surround for high pass processing default = 25. Range = 7-79 (odd numbers) (applies only to blob mode)
NOTE: Default changed from 7 to 25 in version 3.5
25reserved3Reserved
26-27bgTimeConstTime constant (in frames) at which frames are averaged into the background model (at the default value of 600, the background will mostly be replaced after about 20 seconds
(applies only to staring mode)
28bgEdgePenalty6Penalty to apply to edges in background model mode – typical values are 0 (no edge penalty) to 64 (full edge penalty), default 64
(applies only to staring mode)
29bgResetConfReset background model if registration confidence falls below this value; 0 to 100, default 40
30bgResetOffReset background model if the registration column or row offset exceeds this value; 0 to 255, default 100
31bgResetAngReset background model if the registration angle in degrees exceeds this value; 0 to 180, default 1
32bgResetFramesReserved Allows for recovery from temporary bad frames or temporary large motion, but resets when there is a large amount of motion.
33bgWarpConfWarp the background model if registration confidence falls below this value; 0 to 100, default 85
(applies only to staring mode)
34bgWarpOffWarp the background model if the registration column or row offset exceeds this value; 0 to 255, default 32
(applies only to staring mode)
35bgWarpAngWarp the background model if the registration angle in degrees exceeds this value; 0 to 180, default 1
(applies only to staring mode)
36bgWarpFramesReserved Allows for ignoring a small number of bad frames or temporary large motion, but warps when there is a significant amount of motion.
37maxTrackFramesNumber of frames to keep tracking once target has disappeared, 1 to 254; 0 = automatic, 255 = don't drop (not used in vehicle, person, or drone modes)
38debugFilteringDebug flags to help user understand filtering based on size,velocity, and acceleration.
Bit Description
0-3 0 = No debug drawing, 1 = Show Size (high,wide), 2 = Show Velocity, 3 = Show Acceleartion
(Not yet implemented)
4 Reserved
5 Reserved SightLine internal use only.
6 1 = Show tracks that don't make it in telemetry or klv in orange. 0 = Show tracks in default color set by user. See maxTelemTrks and maxKlvTrks.
7 1 = Show filtered tracks in red. 0 = Don't show filtered tracks: NOTE: When enabling this, filtered tracks also appear in telemetry and KLV streams but will have confidence of 0.
39downsampleSelect the amount of downsampling that will be applied to the capture image (not used in anomaly mode)
NOTE: Hardware limitations exist based on the platform, algorithm, and frame size.
BitsDescription
0-6
ValueDescription
0none
12x2
24x4
38x8
4-127Reserved
7automatically determine based on frame size.
40maxTelemTrksMaximum number of MTI tracks reported in SLATrackingPositions_t, default 10.
If the total number of tracks is greater than maxTelemTrks, then the reported tracks are chosen based on which tracks have the highest confidence.
41maxKlvTrksMaximum number of MTI tracks reported in the KLV data, default 10.
If the total number of tracks is greater than maxKlvTrks, then the reported tracks are chosen based on which tracks have the highest confidence.
42cameraIndexCamera Index
43blocksHighNumber of vertical blocks to use for region based processing, range 1 to 16, default 1. (applies only to blob mode)
44blocksWideNumber of horizontal blocks to use for region based processing, range 1 to 16, default 1. (applies only to blob mode)
45maxDisplayTrksMaximum number of MTI tracks displayed, default 100. (not used in vehicle, person, or drone modes)
If the total number of tracks is greater than maxDisplayTrks, then the displayed tracks are chosen based on which tracks have the highest confidence.
46ellipsePaddingPadding added to the estimated target size when drawing overlays. Range 0 to 100, default is 5. (not used in vehicle, person, or drone modes)
47closeFilterAdditional filtering step done after main detection processing.
0 = default based on algorithm - see below.
1 = None (Default for Maritime, Gas, and Anomaly)
2 = 3x3 (Default for Aerial, Staring, Vehicle, Drone, and Person)
3 = 5x5 (Default for Blob, and Radiometric)
48detDirectionLimit detection to bright or dark objects or find all. (applies only to blob mode)
1 = Find bright objects only
2 = Find dark objects only
3 = Find all objects (default)