The DLL used to find a detection in one section of the frame, latch a crop
round it and vote on tracked boxes inside that crop. Measured on the field
recordings that was itself the main false-alarm source (the detector needs
context: a floodlight is fake_fire on the whole frame and fire on a tight
crop of the same lamp), and a PTZ tour broke the latch. ANSMIND's native
vision.fire_smoke node replaced it with a whole-frame-first verifier whose
cues are box-relative and carried by global motion, fire-only native zoom
re-checks, a look-alike filter and a ladder of gates measured on real and
false recordings.
The DLL now feeds that verifier, vendored verbatim from ANSMINDCORE dba11ac
(vendor/engine/fire_smoke.hpp, pure C++): ANSLIB runs the package's
detector on the whole frame at a low floor with class-agnostic NMS, the COCO
filter when there is a candidate to explain, and the detector again on the
few native crops the verifier plans; only confirmed tracks come back, as
fire/smoke CustomObjects with fs_seconds/fs_track/evidence in extraInfo.
Parameters: Sensitivity (slider onto low/balanced/high), SmokeSeconds,
DetectFire/DetectSmoke, ZoomChecks, MaxFps (6: evidence is per second of
scene), CandidateScore, MinObjectSize (49a53c3's knob, kept: a candidate
under that fraction of the frame is noise), ExclusiveROIs. Engines load
inside Initialize: a lazily loaded one faulted in ANSLIB's inference entry
on the first frame.
FireNSmokeDetection_Run replays a recording on the video's clock (parity
harness with firesmoke-run). Measured, same package, TensorRT:
15.9.9.0_9.51_real_smoke 63 alarms, first at 3.0 s (node: 56, 3.0 s)
15.9.9.51.10.51_real_smoke 113 alarms, first at 3.0 s (node: 126, 3.0 s)
8 KA false_* clips 0 alarms (node: 0)
Unit tests updated for the new parameter schema; 9/9 pass. The headless
checker from 49a53c3 builds unchanged against the new class.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
98 lines
5.3 KiB
Markdown
98 lines
5.3 KiB
Markdown
# ANSCustomFireNSmokeDetection
|
|
|
|
The ANSVIS Fire & Smoke custom model (`ANSCustomFireNSmokeDetection.dll` inside
|
|
the `ANS_FireSmoke_v2.0` package), judged by the **same verifier the ANSMIND
|
|
`vision.fire_smoke` node runs**. ANSVIS loads the DLL into its server; ANSMIND
|
|
runs either its native node or this DLL through `ans-custom-host` (the Custom
|
|
Model node). Since 2026-11-01 all three judge a scene identically.
|
|
|
|
## Why it was rewritten
|
|
|
|
The first generation found a detection in one section of the frame, latched a
|
|
crop round it and voted on tracked boxes inside that crop. Measured on the
|
|
field recordings, that was itself the main false-alarm source:
|
|
|
|
* the detector needs **context** — a floodlight is `fake_fire` on the whole
|
|
frame and `fire` on a tight crop of the same lamp;
|
|
* the active window lost the rest of the picture, and a PTZ tour broke the
|
|
latch (the camera moved, the crop did not);
|
|
* the colour / flicker / movement gates were hand-tuned on a few clips and
|
|
did not survive the Tay Son PTZ: lit mist, statues, radar domes, a red flag.
|
|
|
|
ANSMIND's node replaced that with a whole-frame-first verifier whose every cue
|
|
is box-relative and carried by global motion (PTZ-safe), native-resolution
|
|
zoom re-checks for fire only, a look-alike filter, and a ladder of physical
|
|
gates measured on real and false recordings (`static`, `rigid`, `plain-red`,
|
|
`lamp`, `glare`, `travelling`, `night-brief`, `unlocalised`, `in-haze`,
|
|
`featureless`, `grain`, ...). That verifier is `vendor/engine/fire_smoke.hpp`,
|
|
pure C++ with no OpenCV, vendored verbatim from ANSMINDCORE (see
|
|
`vendor/README.txt` for the commit; re-copy to sync, never edit here).
|
|
|
|
## What the DLL does per frame
|
|
|
|
1. ANSLIB runs the package's `detector.onnx` (YOLO11m: fire / fake_fire /
|
|
smoke / fake_smoke) on the **whole frame** at a low floor
|
|
(`CandidateScore`, 0.15), then class-agnostic NMS: fire and fake_fire on the
|
|
same flame are one candidate, and which the model preferred is the evidence.
|
|
2. When there is a candidate, ANSLIB runs `filter.onnx` (COCO) on the frame;
|
|
a candidate inside a vehicle or a small screen is explained away by the
|
|
verifier.
|
|
3. Each candidate gets its box-relative cues (`patchCues`: flame hue, white
|
|
core, plain red, contrast, 24x24 grey patch for the change statistics).
|
|
4. For the few small **fire** candidates the verifier picks (`ZoomChecks`),
|
|
the detector runs again on a native crop (3x the box, at least 320 px,
|
|
never more than half the frame); the crop's verdict may only boost.
|
|
5. `Verifier::update` tracks, gates and decides. Only **confirmed** tracks
|
|
come back, as `CustomObject`s with the package's `fire` / `smoke` class,
|
|
the track id, and `extraInfo = fs_seconds=..;fs_track=..;evidence=..;held=..`,
|
|
every frame while they last.
|
|
|
|
The detector is not run faster than `MaxFps` (6): evidence is per second of
|
|
scene, and between runs the last verdict is returned unchanged.
|
|
|
|
## Parameters (`ConfigureParameters`)
|
|
|
|
| Name | Type | Default | Meaning |
|
|
|---|---|---|---|
|
|
| `Sensitivity` | float 0..1 | 0.5 | How much evidence an alarm needs: under 0.34 = the node's `low`, over 0.66 = `high`, else `balanced`. The physical gates never move. |
|
|
| `SmokeSeconds` | float 0..600 | 0 | Seconds smoke must have been seen **at the place** before it may alarm (wildfire / PTZ landscapes: 20). |
|
|
| `DetectFire` / `DetectSmoke` | Boolean | true | Which families to watch. |
|
|
| `ZoomChecks` | float 0..8 | 2 | Native-resolution re-checks per frame (fire only). |
|
|
| `MaxFps` | float 1..30 | 6 | Detector rate ceiling in frames of scene time per second. |
|
|
| `CandidateScore` | float 0..1 | 0.15 | Detector floor for a candidate; the alarm threshold is the verifier's evidence, never this. |
|
|
| `MinObjectSize` | float 0..10 | 0.03 | Minimum candidate box size as a percentage of the frame area; smaller boxes are noise. |
|
|
| `ExclusiveROIs` | rectangles | none | Candidates touching one are dropped. |
|
|
|
|
The threshold ANSVIS opens the model with is not an alarm threshold either;
|
|
a confirmed alarm is reported at least at that confidence so no downstream
|
|
score filter can drop it.
|
|
|
|
## Build
|
|
|
|
```
|
|
cmake -S . -B build-vs -G "Visual Studio 18 2026" -A x64 # from the repo root
|
|
cmake --build build-vs --config Release --target ANSCustomFireNSmokeDetection FireNSmokeDetection_Run FireNSmokeDetection_Tests
|
|
```
|
|
|
|
Links `ANSLIB` (`C:\ProgramData\ANSCENTER\Shared`) and `opencv_world4130`
|
|
(`C:\ANSLibs\opencv`). The DLL and the harnesses load the ANS Runtime Engine's
|
|
DLLs from `C:\ProgramData\ANSCENTER\Shared`, so put that folder on `PATH` to
|
|
run them.
|
|
|
|
## Replay harness (parity with ANSMIND's `firesmoke-run`)
|
|
|
|
```
|
|
set PATH=C:\ProgramData\ANSCENTER\Shared;%PATH%
|
|
build-vs\bin\Release\FireNSmokeDetection_Run.exe <model dir> <video> [--max-fps 6] [--sensitivity 0.5] [--smoke-seconds 0] [--start S] [--end S] [--log]
|
|
```
|
|
|
|
Feeds the recording on the **video's** clock (`SetFrameClock`, a harness-only
|
|
method outside the plugin contract) and prints each alarm once. The model
|
|
dir is the decrypted package folder (`detector.onnx`, `detector.names`,
|
|
`filter.onnx`, `filter.names`, `Categories/`); hand it a backslash path —
|
|
ANSCORE's engine-path code splits on `/` only. The first run on a GPU builds
|
|
TensorRT engines (minutes); they cache beside the models.
|
|
|
|
`ANSCUSTOM_FS_LOG=1` (or `--log`) prints the verifier's per-track cue line
|
|
per frame to stderr, the same line the ANSMIND node logs with `ANSMIND_FS_LOG`.
|