Convertire GPX in TCX

Molti software registrano un’uscita in modo perfetto ed esportano solo GPX: app per telefono, vecchi ciclocomputer, logger open source, qualunque cosa tratti il percorso come geografia anziché come allenamento. Le piattaforme sull’altro lato — Garmin Connect, TrainingPeaks, la dashboard di un allenatore — sono costruite attorno ad attività, e un’attività ha un inizio, una durata, una distanza e una disciplina prima di avere una forma.

Questa conversione colma il divario. Prende la geometria che il GPX contiene e le mette attorno le dichiarazioni strutturali che un lettore TCX richiede, così il file viene importato come sessione anziché essere rifiutato o finire in una libreria di percorsi. Quello che non può fare è mettere nel file informazioni che il GPX non conteneva, e la differenza fra queste due cose è quasi tutto ciò che segue.

Training Center XML è rigido dove il GPX è permissivo. Ogni `<Lap>` deve dichiarare un `StartTime`, un `TotalTimeSeconds`, un `DistanceMeters`, un `<Intensity>` e un `<TriggerMethod>`, e ogni `<Activity>` deve dichiarare uno `Sport` da un elenco fisso. Un file che ne manchi anche solo uno non viene letto con indulgenza: Garmin Connect lo rifiuta, ed è il motivo abituale per cui un TCX assemblato a mano non si importa.

Ecco perché tutte e cinque vengono scritte. Intensity è impostato su `Active` e TriggerMethod su `Manual`, che sono i valori neutri e onesti per un file che non è mai stato segmentato da un dispositivo. L’Activity Id è impostato sul timestamp di inizio, come prevede lo schema. I restanti tre — inizio, durata e distanza — derivano dai trackpoint, e ciascuno ha un modo di andare storto di cui parlano le prossime sezioni.

Un GPX non memorizza la distanza da nessuna parte. Il numero scritto in `DistanceMeters` è prodotto percorrendo i trackpoint in ordine e sommando la distanza sul grande cerchio fra ciascuna coppia consecutiva, usando una Terra sferica di raggio 6 371 000 metri. Rispetto a un calcolo ellissoidale corretto è accurato entro poche parti per mille, ben al di sotto del rumore nell’input.

Due proprietà di quella somma vale la pena conoscerle. Ignora i dislivelli, il che conta meno di quanto l’istinto suggerisca: un percorso che sale di 1 000 metri su 40 chilometri è 40 012 metri lungo il pendio anziché 40 000, una differenza di tre centesimi di percento. Ciò che conta davvero è il tremore del ricevitore — ogni oscillazione fra due campioni si somma invece di annullarsi, quindi una traccia densamente registrata misura leggermente lungo, e la cifra del dispositivo, filtrata o rilevata da un sensore sulla ruota, è di solito il numero più piccolo e migliore.

TotalTimeSeconds è la differenza fra l’ora del primo e dell’ultimo trackpoint, in secondi, arrotondata a un intero. Per un’uscita registrata è il tempo trascorso, non il tempo in movimento: una sosta al bar di quaranta minuti a metà è dentro il totale, perché il file registra quando il ricevitore era in un punto e non se si stava muovendo.

La trappola è un GPX senza timestamp, che è l’aspetto di un percorso pianificato esportato da un route planner. Non c’è nulla da sottrarre, quindi la durata esce zero, e poiché un lap deve comunque dichiarare un orario di inizio viene scritto l’epoch — l’attività risulta datata 1 gennaio 1970 con una durata pari a nulla. È valido per lo schema ed è insensato come allenamento. Se il GPX è un piano anziché una registrazione, converte in un formato di percorso e caricarlo come course.

L’attributo Sport è scritto come `Other` su ogni attività. Lo schema TCX limita il valore a una breve enumerazione, un GPX non ha un campo che dica cosa fosse la registrazione, e indovinare dalla velocità media sarebbe una fabbricazione che per coincidenza risulta giusta il più delle volte — il tipo peggiore, perché è sbagliata in modo invisibile.

L’effetto pratico sono alcuni secondi di lavoro dopo l’importazione. Garmin Connect, Strava e TrainingPeaks consentono tutti di cambiare il tipo di un’attività in un secondo momento, e farlo ricalcola ciò che ne dipende. Vale la pena farlo anziché lasciare: i modelli di carico di allenamento, le zone di passo e il rilevamento dei record personali sono tutti agganciati alla disciplina, e una sessione archiviata come `Other` è silenziosamente esclusa dalla maggior parte di essi.

Un TCX può contenere frequenza cardiaca, cadenza, potenza e distanza per punto, e uno convertito non ne contiene nessuno. Dove un GPX portava la frequenza cardiaca in un blocco `<extensions>` — che molti orologi fanno, usando il namespace TrackPointExtension di Garmin — quei valori non vengono letti, quindi non ricompaiono nel TCX anche se il formato di destinazione avrebbe un posto dove metterli.

Si tratta di un limite genuino di questa conversione e vale la pena dirlo chiaramente, perché il cambio di formato fa sembrare che i dati di allenamento dovrebbero arrivare. Non arrivano. Se i dati dei sensori esistono nel GPX e servono nel TCX, la conversione da usare non è questa: riesportare la sessione da ciò che l’ha registrata, scegliendo TCX o FIT alla fonte, e i flussi escono attaccati ai punti fin dalla prima volta.

Ciascuna traccia diventa un’attività che contiene esattamente un lap, il quale copre l’intera registrazione. Il GPX non ha il concetto di lap — un confine `<trkseg>` segnala un’interruzione di segnale, non la pressione di un pulsante — quindi nella fonte non c’è nulla da mappare sulle divisioni di lap e nessuna ne viene inventata.

Per un’uscita a ritmo costante è una rappresentazione fedele. Per una seduta a intervalli appiattisce ciò che si è fatto: dodici ripetizioni arrivano come un unico sforzo continuo, e gli split di lap, le medie per lap e gli intervalli di recupero che un allenatore legge per primi sono assenti. La maggior parte delle piattaforme permette di suddividere manualmente un’attività dopo il caricamento, il che ricostruisce i confini ma non la frequenza cardiaca per lap che il dispositivo originale avrebbe sintetizzato.

Un allenamento non ha nozione di waypoint. Dove un GPX contiene tracce, i waypoint sono lasciati fuori dal TCX, perché non c’è un elemento che li conterrebbe e uno fabbricato romperebbe lo schema per ogni lettore.

Un GPX che contiene solo waypoint è trattato diversamente anziché essere rifiutato: i punti sono considerati un’unica traccia, nell’ordine in cui il file li elencava, quindi il risultato è un’attività valida che descrive "queste posizioni, in questa sequenza". Se sia significativo dipende interamente dal file. Una serie di capisaldi topografici si converte in un’attività che rivendica una distanza mai percorsa, e per quella fonte il CSV o il percorso GPX è la risposta onesta.

Un GPX che contiene più di un `<trk>` produce più di una `<Activity>` nel TCX, ciascuna con il proprio lap, la propria distanza calcolata e il proprio orario di inizio ricavato dal primo punto. I percorsi memorizzati come `<rte>` sono trattati come tracce allo stesso modo, ed è per questo che un file unito di una settimana di uscite in bicicletta si converte in una settimana di sessioni separate anziché in una sola implausibile.

Non ogni importatore gestisce un TCX multi-attività allo stesso modo. Alcuni lo separano automaticamente in voci distinte, altri prendono la prima e ignorano il resto. Se il caricamento torna con una sola sessione quando te ne aspettavi cinque, dividere il GPX prima della conversione è la soluzione affidabile, e permette anche di nominare ed etichettare correttamente ciascuna in ingresso.

Leggere il GPX e scrivere il TCX avvengono entrambi in questa scheda del browser, senza che alcuna richiesta porti il file verso un server — verificabile nel pannello di rete mentre una conversione è in corso. Il risultato verrà caricato altrove per costruzione, che è lo scopo della conversione, ma quella è una destinazione scelta dall’utente anziché due.

La distinzione vale la pena farla perché i file di allenamento sono dati sanitari e di localizzazione insieme. Un TCX convertito dice dove qualcuno è stato, minuto per minuto, per la durata della sessione, e sta per essere consegnato a una piattaforma con i propri termini di conservazione. Aggiungere un convertitore web gratuito davanti a tutto ciò è un secondo elaboratore senza alcun accordo alle spalle, ed è precisamente il passaggio che eseguire la conversione in locale rimuove.