orisys-tech/orisys-sensor-design
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: give the multi-view design and geometry facts one home each

Browse Source 
Two workspace documents described the multi-view ownership decision by
overlapping each other and had both gone stale: neither matched the shipped
code, and the architecture document was referenced by nothing at all. They are
archived in the workspace, and this repo now carries the parts that belong to
it.

New: docs/geometry-measurements.md. Measured properties of the r01 sensing
surface, the sensing camera, the UV layouts, the printed cell pitch and the
runtime unroll domain - topology (1032 v / 1974 t), 355.77 mm2 area with 38.1%
near-vertical wall, the off-origin centroid, 94.5% inward-facing normals, the
0.516 x 0.714 mm measured pitch against a wrong 0.205 x 0.3556 mm nominal cell,
75.6% runtime coverage, and incidence over that region (p50 55.6 deg, invariant
to adding views). Merge-mode agreement is included, with an explicit note that
these values are camera-specific and expire when a camera moves - the Xynova
surface already needs 70 deg where r01 ships 62 deg.

Wiring:
- README.md points at the measurements and says they expire.
- design-parameters.md section 4 keeps the key semantics and now links to the
  workspace record for rationale and to the measurements for data, instead of
  restating either.
- design.yaml: replace a self-referential comment pointing back at the same
  document with the keys location and the rationale location.

No behaviour change: the YAML edit is a comment, and no source file is touched.
This commit is contained in:
ykcheungab
2026-09-30 16:29:39 +08:00
parent 1de4431657
commit e7618faed4
4 changed files with 160 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+5
View File
@@ -8,6 +8,11 @@ For the full long-term workflow see `docs/workflow/sensor-design-workflow.md` in
workspace root (`D:\orisys_ws\docs\workflow\sensor-design-workflow.md`).
This repository intentionally implements a **minimal v1** for a small team.
Measured properties of the geometry and cameras — topology, surface area, normals, incidence,
cell pitch, and the runtime unroll domain — are in
[`docs/geometry-measurements.md`](docs/geometry-measurements.md). The multi-view ownership design
and the optics model both depend on them, and they expire when a camera moves.
## Two buckets (daily work)
| Bucket | Where | Contents |