Conversor online gratuito de TCX para CSV

Plataformas de fitness e planilhas frequentemente precisam de dados de treino TCX em formato tabular para análise, filtragem ou arquivamento de longo prazo. A conversão para CSV expõe pontos de trajeto individuais, como hora, coordenadas, elevação, frequência cardíaca, cadência e distância, em aplicativos que não leem arquivos de treino baseados em XML.

O que é o formato TCX

TCX, ou Training Center XML, é um formato XML originalmente associado ao Garmin Training Center. Ele armazena dados estruturados de fitness, incluindo atividades, voltas, pontos de trajeto, carimbos de data e hora, coordenadas GPS, altitude, distância, velocidade, frequência cardíaca e cadência.

Relógios e computadores para ciclismo da Garmin geralmente exportam arquivos TCX. Garmin Connect, Strava, TrainingPeaks, GoldenCheetah e outros aplicativos de treino também podem criá-los ou exportá-los. Normalmente, você encontra TCX depois de baixar uma atividade de corrida, ciclismo, caminhada ou multiesportiva de um serviço de fitness.

O que é o formato CSV

CSV armazena registros como linhas e campos como colunas separadas por vírgulas. Programas de planilha, como Microsoft Excel, LibreOffice Calc e Google Sheets, podem abri-lo, assim como bancos de dados, softwares estatísticos, Python, R e ferramentas de linha de comando.

CSV é útil quando você precisa classificar ou filtrar amostras, calcular médias, traçar uma rota, combinar várias atividades ou importar dados de treino para softwares que não oferecem suporte a TCX. Ele geralmente é menor e mais fácil de inspecionar do que XML, mas não preserva a estrutura aninhada de atividade, volta e extensão do TCX, a menos que esses valores sejam transformados em colunas.

Como converter TCX para CSV

Usando o conversor online integrado

1. Abra o conversor de TCX para CSV em 101convert.com.
2. Envie o arquivo .tcx.
3. Escolha CSV como formato de saída e inicie a conversão.
4. Baixe o arquivo .csv resultante e abra-o em uma planilha ou programa de análise de dados.

Esse método não exige a instalação de software. Verifique as colunas de saída antes da análise, pois diferentes arquivos TCX contêm diferentes campos opcionais.

Usando um script Python localmente

Para processamento repetível ou dados de treino confidenciais, salve o seguinte como tcx_to_csv.py:

import csv
import sys
import xml.etree.ElementTree as ET

source = sys.argv[1]
target = sys.argv[2]
root = ET.parse(source).getroot()
fields = [
    "time", "latitude", "longitude", "altitude_m", "distance_m",
    "heart_rate_bpm", "cadence_rpm", "speed_m_s"
]

def value(parent, name):
    element = parent.find(f".//{{*}}{name}")
    return "" if element is None else element.text or ""

with open(target, "w", newline="", encoding="utf-8") as output:
    writer = csv.DictWriter(output, fieldnames=fields)
    writer.writeheader()
    for point in root.findall(".//{*}Trackpoint"):
        position = point.find("./{*}Position")
        latitude = ""
        longitude = ""
        if position is not None:
            latitude = value(position, "LatitudeDegrees")
            longitude = value(position, "LongitudeDegrees")
        heart_rate = point.find("./{*}HeartRateBpm/{*}Value")
        cadence = point.find("./{*}Cadence")
        speed = point.find("./{*}Extensions//{*}Speed")
        writer.writerow({
            "time": value(point, "Time"),
            "latitude": latitude,
            "longitude": longitude,
            "altitude_m": value(point, "AltitudeMeters"),
            "distance_m": value(point, "DistanceMeters"),
            "heart_rate_bpm": "" if heart_rate is None else heart_rate.text or "",
            "cadence_rpm": "" if cadence is None else cadence.text or "",
            "speed_m_s": "" if speed is None else speed.text or ""
        })

Execute-o com:

python tcx_to_csv.py workout.tcx workout.csv

O script usa pesquisas XML independentes de namespace, portanto funciona com versões comuns de namespace TCX. Ele cria uma linha por Trackpoint; valores de resumo armazenados apenas no nível da atividade ou da volta não são incluídos.

Considerações sobre qualidade e compatibilidade

• Campos opcionais: Os arquivos TCX podem não incluir GPS, frequência cardíaca, cadência, velocidade ou distância para alguns ou todos os pontos. Células CSV vazias representam valores ausentes, não zero.
• Unidades: O TCX geralmente armazena altitude e distância em metros, coordenadas em graus decimais, velocidade em metros por segundo e cadência em revoluções por minuto. Converta as unidades após a importação se sua análise exigir milhas, pés, quilômetros por hora ou outro sistema.
• Valores de tempo: Os carimbos de data e hora normalmente são valores ISO 8601 e podem incluir um deslocamento UTC ou o sufixo UTC Z. Preserve o carimbo de data e hora original até converter deliberadamente os fusos horários.
• Extensões de frequência cardíaca: Alguns dispositivos colocam dados específicos do fabricante dentro de Extensions. Um conversor básico pode omitir potência, dinâmica de corrida, temperatura, velocidade vertical ou métricas de ciclismo do lado esquerdo/direito.
• Várias atividades: Um arquivo TCX pode conter várias atividades e voltas. Uma exportação contendo apenas pontos de trajeto pode não manter os limites de atividade ou de volta; adicione esses campos se análises posteriores dependerem deles.
• Configurações regionais: As caixas de diálogo de importação de CSV podem interpretar vírgulas, pontos decimais ou datas de acordo com as configurações regionais. Se as colunas aparecerem em um único campo, selecione vírgula como delimitador e UTF-8 como codificação.