Tuning Accuracy and Performance
Adjust analysis settings when detections are missed, when the rule reacts to targets that are not there, or when the controller is slow.
| Symptom | What to do |
|---|---|
| Reacts to targets that are not there | Raise the confidence or threshold. |
| Misses targets that are there | Lower the confidence or threshold. |
| Everything is slow | Lower Detection FPS first, then Mode. |
Three performance settings: Mode, Detection FPS, GPU Acceleration
Analyses share the controller's computing resources. Three settings affect performance.
| Setting | Guidance |
|---|---|
| Mode | Fast is recommended for a Raspberry Pi, Accurate for a PC or Jetson. |
| Detection FPS | How many times per second the AI analyzes. The default is 5, or 1 for anomaly detection. |
| GPU Acceleration | Available for Object Detection, Face Recognition, and OCR. On integrated or older GPUs it can be slower than the CPU, so verify performance. |
Available modes depend on the analysis. Object Detection, Face Recognition, and Fire Detection offer Fast, Balanced, and Accurate; License Plate and Custom Anomaly offer Fast and Accurate.
QR/Barcode, OCR, and Custom Classification use a single model and have no Mode field. Fire Detection shows all three values but runs a single model, so the result is the same whichever you pick.
Display between analyses is interpolated, so a low Detection FPS does not look choppy. Running an accurate model five times per second generally gives better results than a fast model thirty times per second, at lower cost.
Detection zones: counting only part of the frame
Object conditions cover the whole frame by default. In the condition panel, draw a Detection Zone as a rectangle or polygon, and only detections inside it are counted.
A detected object is a box, so "inside" needs a definition. That is the Zone Trigger Point.
| Criterion | Use case |
|---|---|
| Bottom Center (Ground Point) | People and vehicles on the ground. Draw the zone on the floor. This is the default and fits most cases. |
| Box Center | Ceiling cameras, or targets that do not touch the ground. |
| Overlap Ratio | Counting entry once the box overlaps the zone by a set percentage. |
With Overlap Ratio at 100 percent, the entire box must be inside the zone. Very low values of 1 to 5 percent fire on an outstretched arm or a distant object partially overlapping the zone, which is rarely the intended behavior.