Introducing circStudio, a Python package for preprocessing, analyzing and modeling actigraphy data

O artigo apresenta o circStudio, um pacote Python que unifica o pré-processamento, a análise e a modelagem matemática de dados de actigrafia em um único framework, facilitando fluxos de trabalho reprodutíveis e a geração de resultados fisiológicos interpretáveis para pesquisas em biologia circadiana, ciência do sono e saúde digital.

O essencial

Imagine que o nosso corpo é como uma orquestra gigante, onde cada instrumento (seus órgãos, células e hormônios) toca em um ritmo perfeito de 24 horas. Esse ritmo é o nosso relógio biológico. Quando tudo está sincronizado, dormimos bem e temos energia. Mas, quando o ritmo se quebra (como em turnos de trabalho noturno ou viagens longas), a saúde pode sofrer.

Para entender como essa "orquestra" está tocando, os cientistas usam um método chamado atigrafia. É como se fosse um "relógio inteligente" ou uma pulseira que fica no pulso da pessoa o dia todo, anotando cada movimento, a luz que ela vê e a temperatura do corpo.

O problema é que, até agora, analisar esses dados era como tentar montar um quebra-cabeça onde as peças estavam espalhadas em caixas diferentes:

• Uma caixa para limpar os dados sujos (preparação).
• Outra para calcular estatísticas (análise).
• E uma terceira para simular como o relógio biológico reage à luz (modelagem matemática).

Isso tornava o trabalho dos pesquisadores lento, confuso e difícil de repetir.

A Solução: O "circStudio"

É aqui que entra o circStudio, o protagonista deste artigo. Pense nele como um "Estúdio de Gravação Tudo-em-Um" para o ritmo circadiano.

Em vez de ter que comprar três softwares diferentes e aprender três linguagens diferentes, o circStudio é um único pacote de computador (feito na linguagem Python) que faz tudo isso em um só lugar.

Aqui está como ele funciona, usando analogias do dia a dia:

1. O Tradutor Universal (Adaptadores):
   Imagine que cada marca de relógio inteligente fala uma língua diferente (formatos de arquivo diferentes). O circStudio tem "tradutores" embutidos. Você joga o arquivo bruto do relógio, e ele o traduz automaticamente para uma linguagem que o computador entende, sem você precisar fazer nada.

2. A Limpeza de Dados (Pré-processamento):
   Às vezes, o relógio cai do pulso ou a pessoa fica parada demais, criando "buracos" ou dados errados na gravação. O circStudio age como um filtro de café inteligente: ele remove os grãos estragados (dados inválidos), preenche os buracos com o que seria esperado (baseado nos outros dias) e deixa o "café" (os dados) pronto para ser bebido.

3. O Analista de Ritmo (Cálculo de Métricas):
   Depois de limpar, o circStudio calcula indicadores importantes. É como um treinador pessoal que olha para seus dados e diz: "Você tem uma rotina muito regular?" ou "Sua energia cai muito à noite?". Ele calcula índices como a "Regularidade do Sono" e a "Amplitude Relativa" (o contraste entre o dia ativo e a noite de descanso).

4. O Simulador de Futuro (Modelagem Matemática):
   Esta é a parte mais mágica. O circStudio não apenas olha para o passado; ele tenta prever o futuro do seu relógio biológico. Ele usa fórmulas matemáticas complexas (como as criadas por cientistas famosos) para simular: "Se essa pessoa continuar recebendo essa quantidade de luz, como ficará a produção de melatonina (o hormônio do sono) dela amanhã?". É como um "simulador de voo" para o sono humano.

O Caso Real: O Submarino

Para provar que funciona, os autores usaram o circStudio para estudar militares em uma missão de submarino. Em submarinos, não há sol nem noite, e as pessoas dormem em turnos estranhos.
Usando o "Estúdio", eles descobriram uma conexão interessante: quando os marinheiros tinham um sono muito irregular (o ritmo quebrado), a diferença entre o dia ativo e a noite de descanso diminuía. Ou seja, o "contraste" do ritmo biológico deles estava se apagando.

Por que isso é importante?

Antes do circStudio, um pesquisador precisava ser um programador experiente para juntar todas essas peças. Agora, o circStudio é como um kit de ferramentas de "Faça Você Mesmo" para a ciência do sono.

• Para pesquisadores: Economiza tempo e permite focar na descoberta científica, não na programação.
• Para a saúde: Facilita a criação de aplicativos e ferramentas que podem ajudar pessoas com distúrbios do sono a entenderem seus ritmos biológicos.

Em resumo, o circStudio é a ponte que conecta os dados brutos de um relógio no pulso até uma compreensão profunda de como nosso corpo funciona, tudo em uma única caixa de ferramentas fácil de usar.

Resumo técnico

Título: Introdução do circStudio: Um pacote Python para pré-processamento, análise e modelagem de dados de actigrafia

1. O Problema

A actigrafia é um método não invasivo e de baixo custo para monitorar ritmos comportamentais (atividade locomotora, exposição à luz e temperatura) em condições reais. No entanto, a análise desses dados enfrenta desafios significativos:

• Fragmentação de Ferramentas: As funcionalidades de pré-processamento, cálculo de métricas e modelagem matemática de ritmos circadianos estão frequentemente distribuídas em pacotes de software separados (ex: pyActigraphy para análise de dados e circadian para modelagem), o que limita a interoperabilidade e aumenta a sobrecarga de programação.
• Dependência de Software Proprietário: Muitos dispositivos de actigrafia utilizam formatos de arquivo proprietários e software de análise fechado, restringindo o acesso dos pesquisadores a abordagens analíticas avançadas e dificultando a generalização de resultados entre estudos.
• Falta de Integração: Não existia, até o momento, um pacote unificado em Python que suportasse todo o fluxo de trabalho, desde o pré-processamento de dados brutos até a simulação de modelos fisiológicos complexos.

2. Metodologia e Arquitetura

O circStudio é um pacote Python desenvolvido para unificar o processamento de dados de actigrafia e a modelagem matemática de ritmos circadianos em um único framework.

• Base e Reestruturação: O pacote foi construído sobre a base de código do pyActigraphy, mas com uma reorganização arquitetural significativa para reduzir a duplicação de código e aumentar a flexibilidade.
• Estrutura Modular: O pacote é organizado em dois módulos principais:
  • io: Responsável por operações de entrada/saída de arquivos e pré-processamento.
  • analysis: Fornece funcionalidades para análise de dados e modelagem.
• Classe Raw: Diferente do pyActigraphy, onde o cálculo de métricas estava acoplado à classe de leitura de dados, o circStudio desacopla essas funções. A classe Raw é usada exclusivamente para pré-processamento de sinal (leitura, mascaramento, limpeza), permitindo que os usuários definam pipelines personalizados e apliquem métricas a outros tipos de séries temporais (ex: temperatura corporal).
• Adaptadores de Arquivo: Inclui classes adaptadoras para converter formatos proprietários comuns (como arquivos .atr do ActTrust e .awd) em objetos Raw padronizados.
• Pré-processamento Avançado: Oferece ferramentas para:
  • Remover segmentos inválidos no início/fim ou durante a gravação.
  • Criar máscaras para períodos de inatividade espúria (ex: não-uso do dispositivo).
  • Imputação de dados faltantes (usando a média dos horários correspondentes em outros dias).
  • Suavização de sinais e binarização.
• Modelagem Matemática: Integra modelos circadianos de ponta (reutilizando equações e parâmetros do pacote circadian da equipe Arcascope), incluindo:
  • Modelos Forger, Jewett e Hilaire07 (baseados em osciladores Van der Pol).
  • Modelos HannaySP e HannayTP (focados na interpretabilidade fisiológica da amplitude do ritmo no núcleo supraquiasmático).
  • Modelo Breslow13 (simulação da trajetória de melatonina em diferentes compartimentos fisiológicos).
  • Modelo Skeldon23 (predição da trajetória de pressão de sono com feedback entre componentes contínuos e discretos).

3. Principais Contribuições

• Unificação de Fluxo de Trabalho: Permite que os pesquisadores transitem eficientemente de dados brutos de wearables para saídas circadianas fisiologicamente interpretáveis em um único ambiente.
• Cálculo de Métricas Padronizadas: Implementa funções independentes para métricas comuns como Estabilidade Interdiária (IS), Índice de Regularidade do Sono (SRI), Amplitude Relativa (RA), e atividade média nas 10 horas mais ativas (M10).
• Simulação de Resposta Circadiana: Permite simular a resposta do sistema circadiano a padrões de exposição à luz, incluindo a estimativa de marcadores de fase como o Início da Melatonina sob Luz Fraca (DLMO).
• Visualização Interativa: Fornece métodos de plotagem para visualizar séries temporais de atividade/luz, estados do modelo e métricas derivadas.
• Documentação e Tutorials: Oferece uma documentação extensa com tutoriais interativos cobrindo desde a instalação até análises avançadas (Análise Cosinor, Análise de Flutuação Detrended, etc.).

4. Resultados e Aplicação Prática

O artigo demonstra a utilidade do pacote através de um estudo de caso aplicado a uma missão militar em submarino:

• Cenário: Investigação da relação entre a regularidade do sono e a amplitude relativa (RA) em um ambiente de turnos irregulares.
• Execução: Os autores utilizaram o circStudio para processar arquivos de actigrafia brutos, calcular o SRI, a RA e a atividade durante os 5 períodos menos ativos (L5).
• Descobertas: Foi observada uma correlação positiva moderada entre SRI e RA ($\rho = 0.422$) e uma correlação negativa entre SRI e L5 ($\rho = -0.514$).
• Interpretação: Os resultados sugerem que a redução na regularidade do sono está associada a uma menor robustez do ritmo circadiano, possivelmente mediada por níveis elevados de atividade noturna. Isso valida o uso do pacote para explorar rapidamente relações biologicamente significativas em dados do mundo real.

5. Significado e Impacto

O circStudio representa um avanço significativo para a pesquisa em cronobiologia, ciência do sono e saúde digital:

• Reprodutibilidade: Facilita a criação de fluxos de trabalho reprodutíveis e abertos, reduzindo a dependência de software proprietário.
• Acessibilidade: Torna ferramentas de pesquisa de ponta (como modelos matemáticos complexos de ritmos circadianos) acessíveis a uma comunidade mais ampla de pesquisadores através de uma sintaxe Python intuitiva.
• Fundação para Futuro Desenvolvimento: Estabelece uma base flexível para o desenvolvimento de aplicações orientadas à saúde e pipelines de análise personalizados.
• Futuro: Os autores planejam expandir o pacote para incluir algoritmos automáticos de detecção de períodos de não-uso e, potencialmente, desenvolver uma interface gráfica (GUI) para ampliar ainda mais o acesso a pesquisadores não especializados em programação.

Em resumo, o circStudio preenche uma lacuna crítica no ecossistema de análise de dados de wearables, integrando pré-processamento, métricas comportamentais e modelagem fisiológica em uma única ferramenta robusta e de código aberto.