This commit is contained in:
maxime committed 2026-11-18 10:51:31 +01:00
1 parent 8e4ebca342
commit 58b630f2d5
112 files changed
+3172 -295

No files matched your search

+1 -59
View File
@@ -40,65 +40,7 @@ For the client, some varieties of a family (the `label` of the detectors' episod
## The phenomena
What has been labelled so far, one line each: **name**: what is seen; how to tell it from its neighbours. The hypotheses to weigh for a moment of a range; the cases, their bounds and descriptions come from the labels, through `precedents.py`. A phenomenon not in this list is labelled too, without forcing a cause.
### No data
- **A gap common to several stations**: the measurements missing at the same minutes on every station measuring then; a cause outside the stations, not established. Read the other stations before the station's metrics.
- **The station runs, the measurement is missing**: one station, powered and communicating (synchronization, image or `DB_not_uploaded` at the missing instant), misses a measurement.
- **The station goes silent on its own, for a long time**: no measurements, no images, no metrics, for hours or days, without the signature of a lack of energy.
- **The station shuts down for lack of energy**: the battery does not last the night; voltage below the knee before the gap, a restart with the solar charge.
- **Mains cut: the station runs on its battery**: a station on mains stops, or comes back on a drawn-down battery, until the mains return.
### Obstruction
- **A pass-by hides the targets for the length of one measurement**: a train, a vehicle, passers-by: the hidden targets rejected for one acquisition, back at the next; a reference behind it makes the whole base jump. Insects give the same signature: only the image tells.
- **A target left under the threshold latches onto a headlight, a reflection or another spot**: during a pass-by, one false point kept in the curve, without rejection; `dominance` rises on a recent camera.
- **A vehicle or machine that stays in front of the targets**: the same sensors hidden for hours or days, sometimes a reference; one label per parking.
- **An animal very close to the lens**: lit at night, it hides part or all of the scene for one or two measurements; a spider is not its web.
- **A plant shaken by the wind in front of a target**: one target, at times, on windy days; it grows over weeks.
- **An obstacle covers part of the spot**: an obstacle, or a mark on the glass in front of one spot, hides part of it for hours or weeks: the measured centre slides; the sliding is the artifact, the jump back is the return to normal.
### Visibility
- **Rain**: drops in front of the lens veil the spots during the hours of rain, at night above all; the references, higher up, may suffer less.
- **The soiled glass**: after rain, drop marks veil part of the scene durably; under a single spot, it is an obstacle (Obstruction).
- **Visibility drops over the whole scene, without an obstacle**: fog, condensation, a milky dawn: flux down on all sensors, `error_value` up, rejections; raw positions without a step.
- **Part of the scene goes dark at night**: the distant spots, or a few neighbours at the edge of the group, lose their light, nothing in front.
- **A reference loses its brightness, without an obstacle**: one or two references weaken and shrink, most often at night, then come back on their own; the centre does not move.
- **Atmospheric turbulence**: by day, air heated above a road, ballast or rails makes the spots tremble: a fast noise, `error_value` up. Without the `error_value` rising, an agitation of the pose is the camera heating (Thermal displacement).
- **The sun in the field or behind a spot**: the sun enters the field, or lights the background of a target or a reference as bright as it: rejections at the same hours on sunny days only.
- **A faint spot lost when the light is missing**: a faint target crosses its threshold at the change from night to day, under an overcast sky or in a noisy night image; its rejections come with the light, not every day (else Target issue).
### Target issue
- **A target rejected at all its measurements**: never accepted, whatever the weather.
- **A target right at the threshold, the whole batch**: its `error_value` keeps crossing the threshold, with many own rejections.
- **A target rejected every night or every day**: under the station's ordinary regime (floodlight, daylight), at the same hours, whatever the weather.
- **A target that degrades, and sometimes recovers**: seen worse and worse from a date on; back only after weeks, if ever, often at another level.
- **The configuration of a sensor has changed**: a sensor moved or reset: its curve changes with nothing moving in the image; the jump is not a Displacement.
### Thermal displacement
- **The camera moves through a thermal effect**: the pose follows the housing temperature, every day, the compensation erasing more or less of it; labelled only when the curves keep it beyond the noise.
- **The camera drifts away when the temperature of its housing drops, without a daily cycle**: sheltered (a building, a tunnel), it drifts in jerks with the housing temperature and comes back when it warms.
- **The structure expands and contracts with the temperature**: a structure that can move (a bridge) moves with its own slow rhythm, each target its amplitude, the references stable; two labels a day, expansion and contraction.
- **A rise over several days with the drop in temperature**: the temperature keeps falling for days and the structure keeps rising; it comes back at equal temperature (else Displacement).
### Displacement
- **A step of the camera that the compensation does not erase**: the camera moves at once and keeps its new position, and a remainder stays in the curves; a step that leaves nothing beyond the noise is not labelled.
- **The camera tilts little by little**: over weeks, the tilt rises and the compensation corrects some targets better than others; the targets do not move relative to each other.
- **A real movement of the structure**: targets shift and stay, with references and pose stable and a good image; if the camera and references moved too, the amplitude is not established.
- **A target or a small group jumps and stays shifted**: at once, to another level, without the camera moving or a visible cause.
- **A step taken during a measurement outage**: on resumption, targets do not find their previous level.
### Perturbation
- **The base changes without a reference lost**: all references kept, the distance between them changes a little; all targets shift together without moving in the image, then come back; a base that stays changed is a Displacement.
- **Targets move slowly, alone, then come back**: one or a few targets, hours or days, without a camera movement or an obstructed view.
- **A jolt of the camera, back at the next measurement**: the pose and the raw positions of all sensors jump together for one measurement, then come back; the compensation leaves a remainder for that point only.
- **A reference measured shifted alone, then back**: one reference shifted in the image without being rejected; the base changes and the targets jump according to their place in the image, then everything comes back.
- **A single point of one or a few targets, back at once**: one measurement, then back at the next; the references and the camera stay calm, nothing seen in front.
### Family of the cause
- **A reference dropped: the base changes**: one reference above its threshold, dropped: all targets jump together, the reprojection error at zero; the family is that of what hindered the reference.
- **Two references lost: the camera is blind**: two of three references dropped one after the other: every point of the range is invalid; the family of the cause.
- **A compensation on two references**: a station built with two, or having lost one for good: the slightest difference between them passes into all the targets; the family of what disturbs them.
- **A spider web in front of the lens**: Visibility when it veils the image, Obstruction when a thread hides a few spots; no signal at all is possible, only the images show it.
They are the cases: `auto/cases/` (`kind` phenomenon), listed by `python3 scripts/cases.py --list`, searched by `python3 scripts/cases.py "<what you see>"`. A phenomenon not among them is labelled too, without forcing a cause.
## What is not labeled