## 填寫 TDR 定位紀錄

使用 `tdr-location-record.csv`，在同一列保留量測背景、時間讀值、距離估計與後續檢查。13 個欄位名稱應保持不變。檔案包含一列空白現場紀錄與一列獨立的教學示例，可用一般試算表軟體編輯。它不控制儀器、不自動計算結果，也不判定組件是否合格。

這份紀錄用於已隔離、確認無電且符合儀器接入條件的線纜。接入、校準與允許的訊號準位，應遵循儀器及組件文件。距離換算需要明確的參考面、適用的速度因子，以及路徑上可辨認的反射。

## 區分提供的兩列資料

| `record_type` 識別字串 | 該列的使用方式 |
| --- | --- |
| `BLANK_FIELD_RECORD` | 用於實際現場或台架資料的空白列。除列標籤外，其餘提供的值皆為空白。依實際設定填寫各欄，缺少的值維持空白。 |
| `ILLUSTRATIVE_NOT_MEASURED` | 教學用的構造示例。時間、VF 與距離描述的是本文假設，並非線纜或儀器的實測結果。此標籤應與示例一併保留。 |

空白欄位表示尚未填寫或資料缺少，不是零讀值、確認沒有延遲，或檢查通過。不要用示例值取代空白欄位。記錄實際量測時，填寫空白列，或複製它作為另一列紀錄，並保留足以辨認該次量測的試件與設定資訊。

## 13 個欄位

| 欄位 | 意義與記錄條件 |
| --- | --- |
| `record_type` | 區分空白現場紀錄範本與示例列。提供的識別字串為 `BLANK_FIELD_RECORD` 與 `ILLUSTRATIVE_NOT_MEASURED`。 |
| `specimen_and_revision` | 試件識別，以及該次設定依據的圖紙、線纜或組件版本。教學列使用 `teaching_example_A`。 |
| `test_mode` | 儀器模式與橫軸讀值的依據。教學列使用 `round_trip_time`。應寫明實際儀器報告往返時間，還是已換算為單程距離。 |
| `reference_plane` | 讀值起算的電氣原點。教學列使用 `instrument_port_with_known_adapter_delay`。記錄實際原點，以及已完成的校準或去嵌入。 |
| `termination` | 此筆紀錄的終端狀態與所採用的反射解釋。教學列使用 `assumed_single_identifiable_reflection`；這是假設，並非實測終端或已確認的故障。 |
| `raw_round_trip_ns` | 從記錄的參考面到所選反射再返回的原始往返時間，單位為 ns。示例值為 `40`。原始讀值與用於計算的補償後時間應分開保留。 |
| `known_adapter_round_trip_ns` | 從原始讀值中扣除的轉接段往返延遲，單位為 ns，且須另有已知依據。示例值為 `10`。記錄其依據，僅在參考面尚未補償同一區段時扣除。 |
| `velocity_factor` | 將剩餘時間換算為目標線纜沿線距離的無量綱 VF。示例值為 `0.66`。使用適用於目標線纜的值，不假設每個轉接件與線纜區段的 VF 都相同。 |
| `velocity_factor_source` | VF 的依據，例如相關線纜資料，或以同類型、已知長度線纜進行的核對。教學列使用 `assumed_for_example`。假設應保持為假設。 |
| `estimated_distance_m` | 手動記錄的計算距離，單位為 m，從已定義的線纜起點或參考面沿相關訊號路徑量起。示例值為 `2.96794533`。數值結果不代表量測假設已成立，也不確認故障。 |
| `candidate_location` | 與估計對應的實物線纜區段，包含參考起點與路徑。示例值為 `2.97 m along cable from cable start`。應沿線纜長度對應，不能直接對應為機櫃中的直線位置。 |
| `verification_result` | 後續檢查候選位置或原因的結果。教學列為 `arithmetic_only`，表示只示範算式。依實際情況記錄外觀、針位／導通、低阻或訊號完整性檢查。 |
| `limitation` | 解讀該列所需的假設、未解決條件或限制。示例值為 `No instrument control; no automatic acceptance; assumptions not measured`。 |

CSV 沒有儀器身分、端口或波形檔案的專用欄位，也未包含邊沿或頻率跨度設定及游標取點規則。量測時應填寫配套筆記，記錄這些資訊、實際接線與各段所採用的補償，並以試件／版本及對應的量測紀錄將筆記與 CSV 關聯。在筆記中辨明儀器端口、接入端與線纜端口。`reference_plane` 記錄時間零點，`termination` 記錄終端狀態；兩者都不能代替端口身分。CSV 與這些筆記一起，才能讓另一位工程師恢復接線與參數。

## 解讀 40 / 10 / 30 ns 算例

示例列假設從儀器端口看到的原始反射時間為 40 ns，已知轉接段貢獻 10 ns。因此，分配到目標線纜的往返時間為：

`Δt = 40 ns − 10 ns = 30 ns`

使用本文採用的真空光速與假設的目標線纜 VF：

`L = 0.299792458 m/ns × 0.66 × 30 ns ÷ 2 = 2.9679453342 m`

CSV 在 `estimated_distance_m` 中保留 `2.96794533`，在 `candidate_location` 中保留 `2.97 m along cable from cable start`。這些小數位代表算式結果，並非儀器精度規格。若將全部 40 ns 以相同假設 VF 換算，則得到 3.9572604456 m，約為 3.96 m。約 0.99 m 的差異來自參考面的處理。

只有在已知的 10 ns 貢獻仍包含於原始讀值時，才扣除它。若校準已將時間零點設於目標線纜起點，再次扣除會重複移除同一段。若儀器報告單程距離，就直接依該模式讀值，不將距離再除以 2。

## 保留假設與下一項檢查

本文公式假設所選時間代表從相同參考面通過目標區段的往返時間，且傳播速度近似均勻。對於混合介質，先在時域核對已知段，再換算剩餘的目標區段。多分支、多次反射或強衰減可能留下不只一個候選區段。

保留 VF 依據，以及時間或參考面的不確定性。距離精度與分開兩個鄰近反射的能力，是不同的判斷。反射變化本身不能辨認某個不良壓接，也不能確認絕緣性能；應採用能回答該項原因問題的檢查。

本文引用 Keysight FieldFox 的 Time Domain 說明，作為實作方式、參考面與響應分辨條件的依據；引用歷史 Tektronix 1502C 手冊 `070-7169-05`，說明傳播速度與距離的關係；並引用 Tektronix 的 TDR Test 說明，區分檢出與兩點分辨。依本文所述範圍使用這些來源。CSV 與這份欄位說明不提供目前特定儀器的操作指示或組件驗收限值。