## 填写 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 和字段指南不提供当前具体仪器的操作指令或组件验收限值。