14 KiB
The label families
One label, one anomaly, one family (D-109 to D-111, D-119). An anomaly is what shows up on corr_x and corr_y: the curves move (a peak, a jump, a drift, noise) or are missing (a gap). The family says the cause of what is seen on the corrected curves, or of what is missing from them, and what the client should conclude. Its key, its very name, goes in the family field of the label; the labeling tool offers it in its Category menu. Each family has its detector, in detectors/scripts/ (D-119): the category of a detector event is its family.
| Key | Detector | What happens | For the client |
|---|---|---|---|
Visibility |
visibility.py |
things are harder to see: a diffuse nuisance between the camera and the scene. The image is faint or blurred (rain, fog, condensation, light, dirty lens: the spots are fainter or blurrier), or it shakes (turbulence: hot air, above a road or in the sun, makes the spots shake, a fast noise on the curves). The description says which is seen | do not trust the curves over the range; it is not a movement |
Obstruction |
visibility.py (brief), target_issue.py (target obscured) |
an object hides one or a few targets, for a moment or for a long time (train, vehicle, plant, snow on the target) | ignore the curve of the hidden targets over the range |
Thermal displacement |
thermal_displacement.py |
a component (the structure, the camera and its mount) moves with temperature; it is always labeled, whether the corrected curves show it or the camera compensates it (D-117); the direction does not matter | normal, nothing to do |
Displacement |
displacement.py |
a lasting jump, a slow drift, and anything that changes the corrected curves without an established cause (rule D-074: do not alarm the client, hide nothing) | to check: look at the images, monitor |
Target issue |
target_issue.py |
a constantly problematic target: rejected almost always, badly oriented, badly installed, badly configured, dirty | act on the target; ignore its curve |
No data |
no_data.py |
no measurement for any sensor, all curves missing (acquisition, power, transmission); the cause, if the metrics or the images show it, otherwise not established | the curves are missing over the range; the cause says whether to act |
The boundaries
- Visibility or Obstruction: the nuisance is judged by its extent, not by the light. The whole scene hindered (rain, fog, underexposed image, milky dawn, sun in the field) is Visibility; a few targets hidden by an object, the rest intact, are Obstruction, even if the object is lit (machine, headlights, light of a parked vehicle). A spider web goes by what it does: a thread that hides a target, Obstruction; the web that veils the image, Visibility.
- Obstruction, whatever the duration: an obstacle that stays (parked vehicle, machine, plant, animal or insects against the lens, mark on the glass in front of a single spot) is Obstruction.
- A hindered reference (phenomena: "A reference dropped", "Two references lost"): the family of its cause. A passage in front of a reference that makes the base jump is Obstruction when the object is seen, or deduced from a passage signature; a reference right at its threshold, with nothing in front of it, is not a passage: Visibility, or Displacement without a cause. The description says it is a reference, and that the targets move together because of it.
- A jump then the return: the family of its cause, seen on the images. A passing vehicle, and its reflection, are Obstruction (a reflection on the roadway lasting only one measurement is a vehicle: read the measurement before and the one after); the reflection of the sun on the fixed scene is Visibility. Without an established cause: Displacement.
- Thermal displacement or Displacement: what follows the temperature of the housing and comes back with it (same position at equal temperature), even over several days, or whose thermal cause the expert gives, is Thermal displacement; what follows it only as a trend, without coming back at equal temperature, and what the temperature does not explain, are Displacement.
- Thermal displacement or Visibility: curves that follow the scale and rotation of the camera with the housing temperature, the
error_valueat its level or rising only a little, nothing on the images, several targets moving apart in opposite directions through the rest of the compensation, are Thermal displacement. References moving apart from each other and from the targets, anerror_valuerising on most sensors, an episode with sharp edges, or a nuisance seen on the images, are Visibility, even at the temperature trough. The two can coexist: two labels. A daytime agitation, the pose shaking without theerror_valuerising, is not turbulence. - A gap: curves missing because targets are rejected are in the family of the cause of the rejection (Visibility, Obstruction, Target issue); all curves missing, no measurement: No data. The cause of a No data can be outside the station: a gap at the same minutes on several stations is a common cause (transmission or reception), not an outage. The station is running if a synchronization falls at the missing instant, if the image of that instant exists, or if
DB_not_uploadedrises then falls. - Target issue or episode of another family: a Target issue requires rejections specific to the target (outside the episodes shared with its neighbors) almost every day of the range, also on covered or rainy days, under the station's normal regime (the floodlight at night, daylight). A reference rejected like this every day is one, even if its entries and exits do not make the targets jump: the compensation loses it every day. Rejections that come only with a condition seen on the images (sun, rain, night of poor visibility) are episodes of the family of that condition, one label each time. An
error_valueright at the threshold, with few own rejections, is not a Target issue: first count the own rejections of each target and each reference, day by day. - Target issue or Displacement: a changed configuration (moved sensors, changed starting position, setting) is Target issue; the jump that results is not a Displacement.
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_uploadedat 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;
dominancerises 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_valueup, 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_valueup. Without theerror_valuerising, 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_valuekeeps 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 even when fully compensated.
- 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 a remainder passes into the curves; a step that leaves nothing 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.
- 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.
- 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.
- Targets move slowly, alone, then come back: one or a few targets, hours or days, without a camera movement or an obstructed view.
- 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.
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.
What is not labeled
- What touches neither
corr_xnorcorr_y: anerror_valuethat rises without effect on them; a camera step well compensated, even on two references, as long as thecorrkeep nothing of it (if some remains, the label bounds the step and concludes "the camera moves"). Thermal movement, on the other hand, is always labeled (D-117). - The station's intended configuration (targets that are twins of their references: the same prism serves as target and reference; they are named with their reference in its labels).
- The expert can say so with the key
None(labeling tool: "None (curves untouched)"): such a label is not counted.