[AZ-961] accuracy_report: rename tlog_path -> ground_truth_path

ReportContext.tlog_path was widened in-place by AZ-959 to mean
"ground-truth source path" without renaming, leaving the rendered
report's "- Tlog: <csv_path>" line cosmetically wrong for CSV
runs. This rename + label fix completes the cleanup.

- helpers/accuracy_report.py: field rename + docstring update +
  rendered line now reads "- Ground truth: <path>" for both
  inputs.
- replay_api/app.py: kwarg updated, AZ-959 inline comment about
  the overload removed (field name now carries the intent).
- tests/unit/test_az699_report_writer.py: fixture updated, two
  new symmetric tests assert the canonical label for tlog AND
  csv inputs (AC-2).
- tests/e2e/replay/_e2e_orchestrator.py +
  test_derkachi_real_tlog.py: kwarg updated.

Tests: 62/62 green across test_az699_report_writer.py,
test_az700_render_map.py, test_az701_replay_api.py.

CSV-replay-input chain (AZ-959 + AZ-960 + AZ-961) is now coherent:
- API accepts (video, csv) with XOR validation
- /static/example-csv serves the AZ-896 reference doc
- Runner dispatches --imu vs --tlog argv
- Report renders with source-agnostic "Ground truth:" label
- Map renders from CSV truth via gps-denied-render-map dispatch

Bookkeeping: AZ-961 spec moved todo/ → done/, dep-table preamble
eighth bump documents the rename + summarises the cycle-4 CSV
chain, state.md records batch 7 complete.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-05-29 12:55:57 +03:00
parent 7f590582cc
commit a3dc8e2636
8 changed files with 41 additions and 13 deletions
@@ -49,7 +49,8 @@ class ReportContext:
Attributes:
run_date_utc: ISO-8601 date (YYYY-MM-DD) at which the run
executed — drives the report filename.
tlog_path: Real tlog the runner consumed.
ground_truth_path: Ground-truth source the runner consumed
either a binary tlog (AZ-697) or an AZ-896 schema CSV.
video_path: Video clip the runner consumed.
calibration_acquisition_method: Provenance of the camera
calibration (e.g. ``"factory-sheet"`` for AZ-702 or
@@ -63,7 +64,7 @@ class ReportContext:
"""
run_date_utc: str
tlog_path: Path
ground_truth_path: Path
video_path: Path
calibration_acquisition_method: str
clip_duration_s: float
@@ -141,7 +142,7 @@ def render_report(
lines.append("")
lines.append("## Run context")
lines.append("")
lines.append(f"- Tlog: `{context.tlog_path}`")
lines.append(f"- Ground truth: `{context.ground_truth_path}`")
lines.append(f"- Video: `{context.video_path}`")
lines.append(
f"- Calibration acquisition method: {context.calibration_acquisition_method}"
+1 -5
View File
@@ -237,11 +237,7 @@ class SubprocessReplayRunner:
)
context = ReportContext(
run_date_utc=datetime.utcnow().date().isoformat(),
# tlog_path is widened to "ground-truth source" in cycle-4
# (tlog or csv depending on which input drove the run);
# ReportContext field rename deferred to AZ-699 follow-up
# to keep AZ-959 scope minimal.
tlog_path=gt_source_path,
ground_truth_path=gt_source_path,
video_path=inputs.video_path,
calibration_acquisition_method=calibration_method,
clip_duration_s=clip_duration_s,