From 7d89ff77d0d32b15692846a75315e455d71dd6ef Mon Sep 17 00:00:00 2001 From: Warren Date: Fri, 8 May 2026 13:50:10 +0800 Subject: [PATCH] docs: add purpose/use case for each visualization type --- .../API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs_v1.0/API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md b/docs_v1.0/API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md index 2f57966..70b103f 100644 --- a/docs_v1.0/API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md +++ b/docs_v1.0/API_V1.0.0/TRACE/TRACE_HEATMAP_SPEC_V1.0.0.md @@ -215,6 +215,8 @@ Y% ### V1: Face Thumbnail Timeline (臉孔縮圖時間軸) +**目的**: 快速瀏覽「誰在什麼時間出現」，不需要看影片就能掌握角色出場順序。 + 水平時間軸直接嵌入 sample 臉孔縮圖，一眼看出誰在什麼時候出現。 ``` @@ -228,6 +230,8 @@ Y% ### V2: Identity Swimlane (身分泳道圖) +**目的**: 對比多個角色的出場分布 — 誰是主角（出場時間長）、誰是配角（短暫出現）、哪些角色從未同時出現。 + 每列一個 identity，橫軸為時間，用 bar 顯示該 identity 哪些時段出現在畫面中。 ``` @@ -241,6 +245,8 @@ James Coburn ░░░░░░░░░░░░████░░░░░░ ### V3: Trace Duration Histogram (持續時間分布圖) +**目的**: 評估 face tracker 品質 — 好的 tracker 會產生少量長 trace（同一人從頭到尾），差的會產生大量短 trace（頻繁丟失重抓）。 + 顯示 trace 長度分布 — 大多數 trace 很短，少數很長。 ``` @@ -261,6 +267,8 @@ James Coburn ░░░░░░░░░░░░████░░░░░░ ### V4: Similarity Matrix (相似度矩陣) +**目的**: 自動發現「被鏡頭切斷的同一個人」— 同一演員在不同場景 reappear，trace 被打斷成多段，但 embedding 高度相似。可用來建議合併 trace。 + trace vs trace 的 embedding cosine similarity 熱力圖，找出「可能是同一人但被鏡頭切斷」的 traces。 ``` @@ -276,6 +284,8 @@ t5 0.89 0.11 0.09 0.10 1.00 ### V5: 3D Space-Time Cube (3D 時空立方體) +**目的**: MR/VR 空間重現 — 把影片中的移動軌跡變成 3D 空間中的路徑。適合展演、沉浸式回放。 + 將 trace 的 (x, y) 畫面位置 + 時間 t 以 3D 呈現，可旋轉視角。 ```