O que é TCX e por que converter para CSV?
TCX (Training Center XML) é o formato XML da Garmin com GPS, FC, cadência, potência, distância e estrutura de voltas. Muitas plataformas ainda exportam TCX: Polar Flow, Fitbit, versões antigas do Garmin Connect. A conversão para CSV transforma a estrutura XML aninhada em linhas planas — uma linha por trackpoint. A conversão roda no navegador.
Comparado com a estrutura XML verbosa de TCX — que encadeia pontos de rastreamento dentro de voltas, voltas dentro de atividades, e usa elementos XML para cada campo — CSV é plano e compacto. Uma corrida de 30 minutos que produz um ficheiro TCX de 500 KB torna-se um CSV de 60–100 KB. Mais importante, CSV é imediatamente legível em qualquer aplicação de folha de cálculo sem análise de XML. A estrutura TCX é destilada em nomes de colunas: cada linha de ponto de rastreamento contém todas as suas métricas lado a lado, que é exatamente o que ferramentas estatísticas e de visualização de dados esperam.
Por Que Converter TCX para CSV?
CSV é a linguagem comum entre dispositivos de fitness e ferramentas de análise de dados. Se quere construir gráficos de treino personalizados em Excel, calcular limiar de lactato de potência em Python, executar uma regressão entre cadência e frequência cardíaca em R, ou alimentar os seus dados de treino num modelo de aprendizagem automática, CSV é o formato que precisa. Os ficheiros TCX são projetados para importação de plataforma — não para análise. Converter TCX para CSV é o primeiro passo em qualquer fluxo de trabalho de treino orientado por dados ou de auto-análise.
Para treinadores que trabalham com múltiplos atletas em diferentes plataformas (Polar, Garmin, Fitbit), TCX é frequentemente o denominador comum de exportação. Converter cada uma das exportações TCX de atleta para CSV permite análise consistente entre atletas num único folha de cálculo ou script, sem necessitar de acesso à API específica da plataforma ou código de análise específico do formato.
TCX para CSV — O que é exportado?
O ficheiro CSV contém uma linha por ponto de rastreio com colunas para carimbo de data/hora, latitude, longitude, altitude, distância, frequência cardíaca, cadência, potência, velocidade e temperatura (quando disponível).
Fontes TCX suportadas
- Polar Flow (exportar como TCX da página de atividade)
- Garmin Connect (exportar original → TCX)
- Arquivo de exportação Fitbit
- Garmin Training Center
- Qualquer aplicação que exporte TCX 2.0 padrão
Que Dados Aparecem no CSV?
A saída CSV tem uma linha por ponto de rastreamento TCX com estas colunas: timestamp (ISO 8601), latitude (graus decimais), longitude (graus decimais), altitude_m (metros acima do nível do mar), distance_m (cumulativa), heart_rate_bpm, cadence_rpm, power_w (da TCX ActivityExtension se presente), speed_ms (metros por segundo, de ActivityExtension) e temperature_c (raramente presente em TCX padrão). Colunas sem dados aparecem como células vazias — não zeros — permitindo-lhe distinguir dados em falta de valores genuinamente zero.
vs. Exportações CSV de Plataforma
Garmin Connect, Polar Flow e Fitbit oferecem alguma forma de exportação CSV, mas estas normalmente dão-lhe dados agregados — resumos diários ou médias por volta — em vez de dados brutos por ponto de rastreamento. Este conversor dá-lhe a resolução temporal completa do TCX original no seu intervalo de gravação nativo (1 segundo, 2 segundos ou variável com SmartRecording). Para análises como cálculo de curva de potência ou modelação de fadiga, essa resolução bruta é essencial.
Problemas Comuns
Se o CSV tem muitas colunas vazias, o TCX de origem provavelmente não tem campos opcionais. As exportações TCX do Polar Flow incluem tipicamente frequência cardíaca mas raramente potência ou cadência a menos que tenha usado um sensor compatível. As exportações TCX do Garmin são mais ricas mas podem omitir velocidade e potência de dispositivos mais antigos. Se precisa de campos que a exportação TCX da plataforma omite, tente solicitar uma exportação FIT se disponível — ficheiros FIT contêm um intervalo mais amplo de métricas, e o conversor FIT-para-CSV extrairá tudo o que estiver presente.
Dados de Desporto Adaptativo em Ficheiros TCX
Os ficheiros TCX de computadores de desporto em cadeira de rodas, unidades GPS de handbike e sistemas de sit-ski são analisados usando o mesmo padrão TCX 2.0 que qualquer outra atividade. Os dados de potência de medidores de potência de handcycle ligados a um Garmin Edge ou dispositivo semelhante aparecem na coluna power_w se o TCX foi exportado com dados de ActivityExtension. Treinadores que trabalham com atletas adaptativos podem aplicar a mesma análise de potência e carga de treino que para atletas sem deficiência — ajustada para os diferentes modelos de dispêndio energético aplicáveis ao desporto com potência de braço.
Perguntas Frequentes
Que intervalo de gravação o CSV usa?
O CSV preserva o intervalo de gravação original do ficheiro TCX. Se o seu dispositivo registou a cada 1 segundo (comum em dispositivos Garmin com SmartRecording desligado), cada linha representa 1 segundo. Se SmartRecording estava ligado, os pontos de rastreamento podem estar 2–10 segundos separados com espaçamento variável dependendo de mudanças de ritmo. A coluna timestamp no CSV mostra o tempo exato para cada linha, permitindo-lhe confirmar o intervalo.
Isto funciona com exportações TCX do Fitbit?
Sim. As exportações TCX do Fitbit seguem a especificação TCX 2.0 padrão e são totalmente suportadas. As exportações Fitbit incluem tipicamente frequência cardíaca e GPS mas não cadência ou potência. A coluna distance_m também pode estar ausente dos ficheiros TCX do Fitbit dependendo do tipo de atividade — estas aparecerão como células vazias na saída do CSV.