Arquivos: CSV, JSON e GPX sob demanda

Tudo o que o Marrow guarda, como um arquivo, quando você quiser. Esta página lista exatamente o que cada exportação contém para que uma planilha, um script ou um médico saiba o que está olhando.

Todos os guias do Marrow: MCP · Espelho autohospedado · Automações · Arquivos · Suporte

Onde ficam os botões

Exportar, Manual. Escolha um intervalo e um formato no topo. Cada seção abaixo gera um arquivo e o entrega à folha de compartilhamento, para que ele possa ir para o app Arquivos, AirDrop, Mail ou qualquer app que receba um arquivo. Nada é enviado para lugar nenhum.

Métricas diárias

Toda série do Apple Health que o Marrow acompanha, um valor por dia, em 30 dias, 90 dias, um ano ou tudo. Escolha métricas específicas ou leve todas.

• CSV (marrow-daily-DATE.csv): uma linha por dia, uma coluna por métrica, colunas em ordem alfabética, com a unidade armazenada em cada cabeçalho: date,active_energy (kcal),body_mass (kg),step_count (count),…
• CSV (longo) (marrow-daily-long-DATE.csv): date,metric,value,unit, uma linha por métrica por dia. O formato que o pandas, o R e as tabelas dinâmicas querem.
• JSON (marrow-daily-DATE.json): os mesmos totais diários do payload da automação.

Duas exportações dos mesmos dados são idênticas byte a byte, então os arquivos se comparam e se versionam sem ruído.

Diário de nutrição

Cada refeição registrada com o detalhe completo de nutrientes. Colunas do CSV: day,meal,name,grams,kcal,protein_g,carbs_g,fat_g,logged_at,extra, onde extra é o JSON de todos os outros nutrientes que o registro traz (fibras, açúcares, sódio, vitaminas…). O JSON aninha os registros dentro dos dias.

Registro de força

Cada série de trabalho (os aquecimentos ficam de fora) com repetições e carga, com a 1RM estimada, o progresso por exercício a cada sessão e o volume por grupo muscular. As cargas estão na unidade de Ajustes, Unidades e os nomes das colunas dizem qual: date,session,exercise,set,weight_lb,reps,est_1rm_lb,set_type (ou _kg), onde set_type é work, failure ou drop.

Sintomas e humor

Cada sintoma que você registrou no Apple Health, com a gravidade da Apple em palavras, e cada registro de Estado de Espírito com o grau de agradabilidade, os sentimentos que você escolheu e a que se referiam. CSV ou JSON, para acompanhamento ou para compartilhar com um médico. As mesmas séries também podem ser selecionadas na exportação de métricas diárias e nas automações.

Rotas de treino

Um arquivo GPX por treino que gravou GPS no intervalo selecionado. Abre no Strava, no Google Earth, no Komoot ou em qualquer ferramenta de mapas.

Unidades

Os arquivos de métricas mantêm as unidades que o Apple Health armazena (kg, m, mL, °C, kcal) e sempre as identificam, para que uma planilha ou um script nunca precise adivinhar. O próprio app mostra o que você escolheu em Ajustes, Unidades. Os arquivos de força também seguem essa escolha.

Solução de problemas

• Nenhuma refeição, série ou registro no intervalo selecionado. Cada seção exporta o intervalo escolhido no topo de Exportar, Manual (30 dias, 90 dias, 1 ano ou Tudo). Escolha um maior, ou confira antes se os dados estão no Marrow.
• Falta uma métrica ou a coluna dela está vazia. O Marrow só consegue exportar o que o Apple Health deixa ele ler. No app Saúde, toque na sua foto no canto superior direito, depois em Apps, Marrow, e ative o item. Depois, no Marrow, Ajustes, Acesso ao Apple Health, toque em Buscar de novo em Lendo do Apple Health.
• Nenhum treino com rota de GPS neste intervalo. Só os treinos que gravaram uma rota, como caminhadas, corridas e pedaladas ao ar livre, têm uma. Treinos em ambiente fechado nunca têm. Se você sabe que há rotas, confira se o Marrow pode ler Rotas de treino no app Saúde (Apps, Marrow).
• Não foi possível ler as rotas. O Apple Health devolveu um erro com essas palavras. Tente de novo e, se repetir, confira o acesso a Rotas de treino como acima.
• A folha de compartilhamento não tem onde guardar. Escolha Salvar em Arquivos para manter o arquivo no celular ou no iCloud Drive, ou envie por AirDrop para um Mac. Qualquer app que abra arquivos CSV, JSON ou GPX aparece na folha de compartilhamento depois de instalado.
• A planilha mostra uma única coluna longa. O arquivo é separado por vírgulas. Importe como CSV com delimitador vírgula em vez de abrir como texto simples. O CSV (longo) é mais fácil para tabelas dinâmicas.
• Os números parecem errados. Os arquivos de métricas mantêm as unidades armazenadas pelo Apple Health (kg, m, mL, °C, kcal) e dizem isso em cada cabeçalho. Os arquivos de força seguem Ajustes, Unidades.
• Você exporta a mesma coisa toda semana. Uma automação envia em horário programado com o app fechado.

Os passos app por app, inclusive Google Sheets e Strava, estão em conexões.

Quando escolher arquivos

Arquivos são a resposta certa para uma necessidade pontual: uma planilha, um médico, um notebook de ciência de dados, um backup. Se você se pegar exportando em horário fixo, uma automação faz o mesmo sem você, e um agente que quer consultar em vez de ler um arquivo deve usar o MCP.