diff --git a/DATA.md b/DATA.md index c4a460c..fa226aa 100644 --- a/DATA.md +++ b/DATA.md @@ -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.