## Compilare una scheda di localizzazione TDR

Usa `tdr-location-record.csv` per conservare in un'unica riga il contesto di misura, la lettura temporale, la stima della distanza e la verifica successiva. Mantieni invariati i nomi delle 13 colonne. Il file contiene una riga vuota per i dati reali e un esempio didattico separato; si può modificare con un normale foglio di calcolo. Non controlla uno strumento, non calcola automaticamente i risultati e non determina se un componente supera la verifica.

Usa la scheda per un cavo isolato, confermato privo di tensione e verificato rispetto alle condizioni di collegamento dello strumento. Segui i documenti dello strumento e del componente per collegamento, calibrazione e livelli di segnale ammessi. La conversione in distanza richiede un piano di riferimento definito, un fattore di velocità adatto e una riflessione identificabile lungo il percorso.

## Distinguere le due righe fornite

| Valore di `record_type` | Come usare la riga |
| --- | --- |
| `BLANK_FIELD_RECORD` | Riga vuota per dati reali sul campo o al banco. A parte l'etichetta della riga, tutti i valori forniti sono vuoti. Compila i campi in base alla configurazione effettiva e lascia vuoti i valori mancanti. |
| `ILLUSTRATIVE_NOT_MEASURED` | Esempio didattico costruito. Tempi, VF e distanza descrivono le ipotesi dell'articolo, non risultati misurati sul cavo o sullo strumento. Conserva questa etichetta con l'esempio. |

Un campo vuoto è un valore non compilato o mancante. Non rappresenta una lettura pari a zero, un'assenza di ritardo confermata o una verifica superata. Non sostituire i campi vuoti con i valori dell'esempio. Per registrare una misura effettiva, compila la riga vuota o copiala in un'altra riga di registrazione e conserva informazioni sufficienti sul campione e sulla configurazione per identificare quella misura.

## Le 13 colonne

| Colonna | Significato e condizione di registrazione |
| --- | --- |
| `record_type` | Distingue il modello vuoto per i dati reali dalla riga illustrativa. I valori forniti sono `BLANK_FIELD_RECORD` e `ILLUSTRATIVE_NOT_MEASURED`. |
| `specimen_and_revision` | Identificativo del campione e revisione del disegno tecnico, del cavo o dell'assemblaggio che definisce la configurazione registrata. La riga didattica usa `teaching_example_A`. |
| `test_mode` | Modalità dello strumento e base della lettura sull'asse orizzontale. La riga didattica usa `round_trip_time`. Indica se lo strumento effettivo riporta il tempo di andata e ritorno o lo ha già convertito in distanza di sola andata. |
| `reference_plane` | Origine elettrica da cui viene presa la lettura. La riga didattica usa `instrument_port_with_known_adapter_delay`. Registra l'origine effettiva e l'eventuale calibrazione o de-embedding già eseguito. |
| `termination` | Stato di terminazione e interpretazione della riflessione usata per questa registrazione. La riga didattica usa `assumed_single_identifiable_reflection`; è un'ipotesi, non una terminazione misurata o un guasto confermato. |
| `raw_round_trip_ns` | Tempo grezzo di andata e ritorno in ns dal piano di riferimento registrato alla riflessione selezionata e ritorno. L'esempio contiene `40`. Conserva la lettura grezza separatamente dal tempo compensato usato nel calcolo. |
| `known_adapter_round_trip_ns` | Ritardo di andata e ritorno in ns, noto in modo indipendente, del segmento di adattamento da rimuovere dalla lettura grezza. L'esempio contiene `10`. Registra la sua base e sottrailo soltanto se lo stesso segmento non è già stato compensato al piano di riferimento. |
| `velocity_factor` | VF adimensionale usato per convertire il tempo rimanente in distanza lungo il cavo in esame. L'esempio contiene `0.66`. Usa il valore applicabile a quel cavo, anziché presumere che ogni adattatore e segmento di cavo abbia lo stesso VF. |
| `velocity_factor_source` | Base del VF, per esempio le informazioni sul cavo pertinente o una verifica con una lunghezza nota dello stesso tipo di cavo. La riga didattica usa `assumed_for_example`. Mantieni un'ipotesi come tale. |
| `estimated_distance_m` | Distanza calcolata e registrata manualmente in m, dall'inizio del cavo definito o dal piano di riferimento lungo il percorso del segnale pertinente. L'esempio contiene `2.96794533`. Un risultato numerico non convalida le ipotesi di misura e non conferma un guasto. |
| `candidate_location` | Tratto fisico del cavo corrispondente alla stima, con la sua origine di riferimento e il suo percorso. L'esempio contiene `2.97 m along cable from cable start`. Riporta la stima lungo il cavo, anziché su una posizione in linea retta all'interno di un armadio. |
| `verification_result` | Esito della verifica successiva usata per valutare la posizione candidata o la causa. La riga didattica contiene `arithmetic_only`, che indica che viene dimostrato soltanto il calcolo. Registra l'effettiva verifica applicabile: ispezione visiva, piedinatura/continuità, bassa resistenza o integrità del segnale. |
| `limitation` | Ipotesi, condizioni irrisolte o limiti necessari per interpretare la riga. L'esempio contiene `No instrument control; no automatic acceptance; assumptions not measured`. |

Il CSV non ha campi dedicati all'identità dello strumento, alle porte o ai file delle forme d'onda. Omette anche le impostazioni del fronte o dell'intervallo di frequenza e le regole di selezione del cursore. Registra questi dettagli, il cablaggio effettivo e la compensazione applicata a ogni segmento in note complementari al momento della misura. Collega le note al CSV tramite campione/revisione e la corrispondente registrazione di misura. Identifica nelle note la porta dello strumento, l'estremità di collegamento e la porta del cavo. `reference_plane` registra il tempo zero e `termination` lo stato di terminazione; nessuno dei due sostituisce l'identità delle porte. Insieme, il CSV e queste note consentono a un altro ingegnere di ricostruire il cablaggio e i parametri.

## Leggere l'esempio 40 / 10 / 30 ns

La riga illustrativa ipotizza un tempo grezzo di riflessione di 40 ns dalla porta dello strumento e un contributo noto dell'adattatore di 10 ns. Il tempo di andata e ritorno attribuito al cavo in esame è quindi:

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

Usando la velocità della luce nel vuoto adottata nell'articolo e il VF ipotizzato per il cavo in esame:

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

Il CSV conserva questo valore come `2.96794533` in `estimated_distance_m` e come `2.97 m along cable from cable start` in `candidate_location`. Queste cifre decimali rappresentano il calcolo, non una specifica di accuratezza dello strumento. Convertendo tutti i 40 ns con lo stesso VF ipotizzato si otterrebbero invece 3.9572604456 m, circa 3.96 m. La differenza di circa 0.99 m deriva dal trattamento del piano di riferimento.

Sottrai i 10 ns soltanto se sono il contributo noto ancora presente nella lettura grezza. Se la calibrazione ha già posto il tempo zero all'inizio del cavo in esame, sottrarli nuovamente rimuoverebbe lo stesso segmento due volte. Se lo strumento riporta una distanza di sola andata, leggi direttamente quella modalità anziché dividere la distanza per 2.

## Conservare le ipotesi e la verifica successiva

La formula dell'articolo presuppone che il tempo selezionato rappresenti l'andata e il ritorno dallo stesso piano di riferimento attraverso il segmento in esame, con una velocità di propagazione approssimativamente uniforme. Per mezzi diversi, verifica i segmenti noti nel dominio del tempo prima di convertire il segmento rimanente da localizzare. Diramazioni multiple, riflessioni multiple o forte attenuazione possono lasciare più di un tratto candidato.

Conserva la base del VF e qualsiasi incertezza sul tempo o sul piano di riferimento. L'accuratezza della distanza e la capacità di separare due riflessioni vicine sono valutazioni diverse. Una variazione della riflessione da sola non identifica una crimpatura difettosa e non conferma le prestazioni dell'isolamento; usa la verifica che risponde alla specifica domanda sulla causa.

L'articolo cita la documentazione Time Domain del FieldFox di Keysight per le condizioni di implementazione, piano di riferimento e risoluzione della risposta; il manuale storico del Tektronix 1502C `070-7169-05` per la relazione tra velocità di propagazione e distanza; e la spiegazione TDR Test di Tektronix per il rilevamento e la risoluzione di due punti. Usa queste fonti negli ambiti indicati nell'articolo. Il CSV e questa guida ai campi non forniscono istruzioni operative attuali specifiche per uno strumento né limiti di accettazione dei componenti.