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

Description

Set the parameters for the detection algorithms.

typedef struct {
u8 mode;
u8 debugCode;
u8 threshold;
u8 manualThreshold;
u8 manualWatchFrames;
u8 suspScore;
u8 reserved;
u8 modeUpperByte;
u16 minTemperature;
u16 maxTemperature;
u8 cameraIndex;
u8 classSensitivity;

See SLATrackingPositions_t for results. See also SLACoordinateReportingMode_t.
NOTE: Applied to the Command Camera.

Detection Modes

Multiple modes of automatic moving target indication are available, depending on the security bits enabled.

Vehicle Medium Moving Target Indication

This mode works best when finding moving vehicles in a moving scene. It works well from a moving aerial platform for finding vehicles that are typically 10 to 100 pixels long in the scene. It does not work as well at finding very small, very large, slow or erratically moving objects. Available with SLA Baseline Detection Application Bits(App Bits).

Staring Small Moving Target Indication

This mode works well for a ground camera that is either stationary or moves then stares for an extended time at a scene. It can find objects that are small and move at slow, fast or varying rates or that temporarily stop. Available with SLA Baseline Detection Application Bits(App Bits).

Aerial Small Moving Target Indication

This mode works from a moving platform and can find small and slow, fast or erratically moving objects. It is capable of handling scene motion with frame to frame perspective change. It will lose objects that stop moving. This mode takes the most compute resource and is the most likely to run at less than full frame rate if other processing is also enabled(such as network video output). Available with SLA Enhanced Detection Application Bits(App Bits).

Anomaly Detection

This mode works from a moving or stationary platform and finds objects that are unique anomalies or outliers in the scene based on color and / or intensity.This mode doesn't require objects to be moving to be detected. Available with SLA Baseline Detection Application Bits (App Bits).

Maritime Detection

This mode works from a moving or stationary platform and finds objects in a maritime environment such as ships or life jackets. Available with SLA Enhanced Detection Application Bits(App Bits).

Radiometric Detection(SR)

This mode works from a moving or stationary platform and finds objects within a specified temperature range. This mode doesn't require objects to be moving to be detected. Available with SLA Baseline Detection Application Bits (App Bits).

Blob Detection

This mode works from a moving or stationary platform and finds objects that are light or dark compared to their surroundings. This mode doesn't require objects to be moving to be detected. Available with SLA Baseline Detection Application Bits (App Bits).

Drone Medium Moving Target Indication

This mode works best when finding drones in a moving or stationary scene. It works well from a moving or stationary platform for finding drones that are typically 10 to 100 pixels long in the scene. Available with SLA Enhanced Detection Application Bits(App Bits).

Gas Leak Detection

This mode enhances moving gasses such as those visible with specialized cameras that are sensitive in the methane absorption band looking for Gas Leaks. Available with SLA Gas Detection Application Bits(App Bits).
Set the gas color with SLASetSystemValue_t.

Denoise Mask

This mode works with denoise video enhancement to mask of denoising where there are moving objects in the scene. Available with SLA Baseline Detection Application Bits(App Bits).
Enable denoise with SLASetVideoEnhancementParameters_t.

Parameter Details

Detection Mode

Bit Option
0 1 = Disable all (other bits ignored)
1 1 = Reset Detect – will clear all tracks, except in Vehicle mode the primary track will persist
2 Reserved SightLine internal use only.
3 Reserved SightLine internal use only.
4 Vehicle Medium Moving Target Indication – for use on a mobile platform
NOTE : if enabled, tracking mode will be set to vehicle (see SLASetTrackingParameters_t).
5 Staring Camera Small Moving Target Indication – for use with a fixed camera or a ground mounted camera that moves then `stares'
6 Aerial Platform Small Moving Target Indication – for use with an aerial moving camera
7 Anomaly Detection in color and/or intensity histogram – for use on a mobile or fixed platform
8 Maritime Detect for use on a mobile or fixed platform to detect objects at sea
9 Radiometric Detect – for use on a mobile or fixed platform to detect objects within a specified temperature range
10 Blob Detect – for use on a mobile or fixed platform to detect objects that are either light or dark compared to their surroundings
11 Drone – Medium Moving Target Indication For Drones - for use on a mobile or stationary platform, NOTE : if enabled, tracking mode will be set to drone tracking.
12 Gas – Gas Leak Detection - for use on a mobile or stationary platform with a specialized gas leak detection camera.
13 Reserved
14 Reserved
15 With Classification – Only Applicable for Drone Mode - filter out false positives with neural network classifier. Classification results can be read using SLATrackingPositionsExtended_t. For more information on running the classifier without filtering out false positives see SLASetTrackingParameters_t.

Message ID 0x2D

Byte Offset Name Description
4modeDetection Mode LSB – See byte 11 for MSB
For each bit: 0 disables feature, 1 enables feature. NOTE: choose only one of bits 4-11
0 = Don't change motion modes
5debugCodeDebug Flags
Bit Option
0 Debug display – required to visualize any of the following options
1 Threshold – display points above threshold as white (not used in vehicle, or drone modes)
2 Peaks – display peaks in cyan (not used in vehicle, drone or gas modes)
3 Blobs – display blobs in yellow (not used in vehicle or drone or gas modes)
4 History – display history of where peaks or blobs were found (not used in vehicle, drone, anomaly, radiometric, blob, maritime or gas modes)
5 Indices – display index number next to each blob or peak (not used in vehicle, or drone modes)
6 Dimensions – Displays dimensions next to each blob or peak (not used in vehicle, drone, anomaly, radiometric, blob, maritime or gas modes)
7 Reserved
6threshold

Sensitivity - The moving target indication sensitivity refers to the algorithm's threshold for deciding whether a particular candidate target is a moving target or a false positive.

ValueDescription
0Manual mode (use manualThreshold, manualWatchFrames, and suspScore directly)
1Highest sensitivity - more false detects, faster detection, less missed detections.
10Lowest sensitivity - less false detects, slower detection, more missed detections.

7manualThresholdThreshold (not used vehicle, drone, or radiometric modes). This is an advanced parameter. It controls the threshold at which potential moving targets are generated. This is ignored unless the sensitivity parameter is set to 0. In the SLACurrentDetectionParameters_t message this will be filled with the value calculated based on the sensitivity.
8manualWatchFramesWatch frames (not used vehicle, drone, or gas modes). This is an advanced parameter. After a potential moving target is generated by the moving target indication system, it is watched by the system for a number of frames. This controls the number of frames the system watches a moving target before displaying it. This is ignored unless the sensitivity parameter is set to 0. In the SLACurrentDetectionParameters_t message this will be filled with the value calculated based on the sensitivity.
9suspScore

Suspicious Score - (not used in vehicle, drone, anomaly, radiometric, blob, maritime or gas modes).
This is an advanced parameter. It controls the level at which we consider a track '''suspicious'''. Valid range is 1-10. Setting this value higher will result in more false positives. This is ignored unless the sensitivity parameter is set to 0. In the SLACurrentDetectionParameters_t message this will be filled with the value calculated based on the sensitivity.

ValueDescription
1Good for people
3-5Source Coordinates – OR this flag (set bit 6 to 1) with any of the modify modes
10Track can move very erratically

10reservedNOTE: Detection frame step has been deprecated as of 3.3. Instead, use the capture frame step found in SLASetAcquisitionParameters_t. If you used the detection frame step previously, it will now default to a value of 0.
11modeUpperByteDetection Mode MSB – combines with Detection Mode LSB above
12-13minTemperatureMinimum temperature value for a detection when running in radiometric detect mode.
14-15maxTemperatureMaximum temperature value for a detection when running in radiometric detect mode.
16cameraIndexCamera to apply settings to. If not present, applies to command camera.
17classSensitivityClassifier sensitivity - (only used in Drone Mode with Classification).
If not present or 0 the classification sensitivity is derived from the threshold. A valid range is 1-10.
ValueDescription
0Manual mode (use threshold to derive classSensitivity)
1Highest sensitivity - more likely to classify object as drone, as a result more false detections
10Lowest sensitivity - less likely to classify object as drone, as a result less false detection