DATA.md: targets.csv holds the references too, one line per sensor measured (after the repump of 2026-11-18)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
maximeandClaude Opus 5.5 committed 2026-11-18 10:03:10 +01:00
1 parent 7bb0f4e8d1
commit 7b2fb8fbfc
1 file changed
+2 -2
+2 -2
View File
@@ -27,8 +27,8 @@ What the files of a station folder are, and what each column means. How to read
## The targets
`targets.csv`, from the pumping: one line per sensor of the platform, `sensor_name`, `pattern_type`, `distance_mm` (from the camera) and `mm_per_px` (`distance_convertion_factor`, the factor of the dashboard's exports in mm), their current values. Read by `data.load_targets`, shown by `inventory.py` (sensor table).
- The references are not in it yet (pumped from the next pumping on): no distance, no mm for them. They are assumed fixed.
`targets.csv`, from the pumping: one line per sensor measured (targets and references), `sensor_name`, `pattern_type`, `distance_mm` (from the camera) and `mm_per_px` (`distance_convertion_factor`, the factor of the dashboard's exports in mm), their current values. Read by `data.load_targets`, shown by `inventory.py` (sensor table).
- The references are in it too (`pattern_type` `global_ref`…), with their distance when it is filled in; they are assumed fixed.
- `distance_mm` 1000: not filled in on the platform; the line is ignored.
- A name may have several lines (a target counted twice, an older configuration of the unit, another lens): when they disagree, `data.load_targets` keeps no value (`inventory.py`: `?(n)`) and that target has no mm; the distance stays when the lines agree on it.
- The distance says which targets are near and far. A far target moves few px for many mm: targets are compared with each other in mm, or in px with their distance. A camera that turns shifts every target by about the same px (the mm grow with the distance); a movement of the structure of the same mm gives px that shrink with the distance; a parallax shows between targets at different distances.