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

El artículo presenta circStudio, un paquete de Python que unifica el preprocesamiento, el análisis y la modelización matemática de los datos de actigrafía en un solo marco flexible para facilitar flujos de trabajo reproducibles en biología circadiana, ciencia del sueño y salud digital.

Lo esencial

¡Hola! Imagina que tu cuerpo tiene un reloj interno muy sofisticado, un "director de orquesta" biológico que decide cuándo debes estar despierto, cuándo dormir y cómo reaccionar a la luz. Este reloj se llama ritmo circadiano.

Hasta ahora, para entender cómo funciona este reloj en la vida real, los científicos usaban unos dispositivos llamados actígrafos (parecidos a relojes inteligentes o pulseras de actividad). Estos dispositivos graban todo: cuánto te mueves, cuánta luz ves y la temperatura de tu piel.

El problema es que analizar estos datos era como intentar armar un rompecabezas gigante usando piezas de tres cajas diferentes:

1. Una caja para limpiar los datos (quitar el "ruido").
2. Otra caja para medir cosas (como cuántas horas dormiste).
3. Y una tercera caja muy compleja para simular matemáticamente cómo reacciona tu reloj interno a la luz.

Hacer todo esto requería ser un experto en programación y saltar de un programa a otro, lo cual era lento y propenso a errores.

La solución: circStudio

Aquí es donde entra circStudio. Piensa en circStudio como un "cuchillo suizo" digital o una caja de herramientas todo-en-uno para científicos que estudian el sueño y el ritmo biológico.

Es un programa gratuito hecho en Python (un lenguaje de programación) que hace tres cosas mágicas en un solo lugar:

1. El Traductor (Limpieza de datos):
   Imagina que los datos de los relojes son como cartas escritas en diferentes idiomas y con manchas de café. circStudio tiene "traductores" (adaptadores) que entienden el formato de casi cualquier marca de reloj. Luego, usa un "filtro mágico" para limpiar las manchas: si el reloj se cayó y marcó cero actividad, o si la persona se quitó el reloj para ducharse, el programa sabe ignorar esos momentos o rellenar los huecos de forma inteligente, como un editor de texto que repara frases rotas.

2. El Contador (Análisis):
   Una vez que los datos están limpios, circStudio actúa como un contador muy preciso. Puede decirte cosas como:

   • ¿Qué tan regular es tu sueño? (¿Te acuestas siempre a la misma hora o es un caos?).
   • ¿Qué tan fuerte es tu ritmo diario? (¿Hay una gran diferencia entre tus horas de máxima energía y tus horas de sueño profundo?).
   • Todo esto se calcula con un solo clic, sin necesidad de escribir fórmulas matemáticas complicadas.

3. El Simulador (Modelado matemático):
   Esta es la parte más futurista. circStudio tiene un "laboratorio virtual" dentro. Puedes decirle: "Oye, esta persona vio mucha luz azul por la noche". Entonces, el programa corre una simulación matemática (como un videojuego de física) para predecir cómo reaccionó el reloj interno de esa persona.

   • ¿Se confundió su reloj?
   • ¿Cuándo se produjo la melatonina (la hormona del sueño)?
   • ¿Cómo cambió su presión de sueño?
     Es como tener un "gemelo digital" de tu ritmo biológico para probar hipótesis sin tener que hacer experimentos reales con personas.

Un ejemplo de la vida real: Los submarinistas

Los autores del artículo probaron este programa con un caso muy interesante: tripulantes de un submarino.

Imagina vivir en un submarino durante semanas. No hay sol, no hay noche, solo luces artificiales y turnos de trabajo que cambian constantemente. Es un caos para el reloj biológico.
Usando circStudio, los investigadores pudieron:

1. Cargar los datos de los relojes de los marineros.
2. Limpiar los datos automáticamente.
3. Descubrir que los marineros con un sueño más "desordenado" (menos regular) tenían un ritmo circadiano más débil.

Básicamente, el programa les permitió ver la conexión entre "dormir mal" y "tener un reloj interno desajustado" de una manera rápida y clara, algo que antes habría tomado semanas de trabajo manual.

En resumen

circStudio es como un puente que conecta los datos crudos de tu reloj inteligente con la comprensión profunda de cómo funciona tu cuerpo.

• Antes: Tenías que ser un programador experto y usar tres programas distintos para entender tu sueño.
• Ahora: Con circStudio, tienes una sola herramienta que limpia, mide y simula tu ritmo biológico, haciendo que la ciencia del sueño sea más accesible, rápida y divertida para todos.

Es una herramienta diseñada para que los científicos se concentren en las respuestas (¿por qué dormimos así?) en lugar de perderse en los problemas técnicos (¿cómo limpio estos datos?).

Resumen técnico

Resumen Técnico: Introducción de circStudio

1. El Problema
La actigrafía es un método no invasivo y rentable para monitorear ritmos conductuales (actividad locomotora, exposición a la luz y temperatura) en condiciones del mundo real. Sin embargo, el análisis de estos datos enfrenta varias limitaciones críticas:

• Fragmentación de herramientas: Las funcionalidades de preprocesamiento, cálculo de métricas y modelado matemático suelen estar distribuidas en paquetes de software separados (por ejemplo, pyActigraphy para datos y circadian para modelos), lo que limita la interoperabilidad y aumenta la carga de programación.
• Dependencia de software propietario: Muchos dispositivos de actigrafía utilizan formatos de archivo propietarios y software de análisis cerrado, lo que restringe el rango de enfoques analíticos y dificulta la generalización de resultados entre estudios.
• Falta de integración: No existía un paquete unificado en Python que permitiera un flujo de trabajo fluido desde los datos crudos hasta la modelización matemática de los ritmos circadianos.

2. Metodología
Los autores desarrollaron circStudio, un paquete de Python diseñado como un marco unificado para el procesamiento de datos de actigrafía y la modelización matemática de ritmos circadianos.

• Arquitectura: El paquete se construyó sobre la base de código de pyActigraphy, pero con una reorganización arquitectónica significativa. Se divide en dos módulos principales:
  • io: Maneja la entrada/salida de archivos y el preprocesamiento.
  • analysis: Proporciona funcionalidades para el análisis de datos.
• Diseño Modular: Se separó la clase Raw (responsable de la lectura y preprocesamiento de señales) de las funciones de cálculo de métricas. Esto permite a los usuarios definir pipelines de preprocesamiento personalizados y aplicar métricas de circStudio a otras series temporales (como la temperatura corporal).
• Adaptadores de Formato: Incluye clases adaptadoras para convertir formatos de archivo propietarios comunes (ej. ActTrust) en objetos estandarizados (Raw), facilitando la carga de datos.
• Integración de Modelos: Incorpora modelos matemáticos de ritmos circadianos del paquete Arcascope (como Forger, Jewett, Hannay, Breslow y Skeldon), permitiendo simular la respuesta del sistema circadiano a patrones de luz.
• Flujo de Trabajo: El proceso típico implica: carga de datos -> preprocesamiento (enmascaramiento de inactividad, imputación de valores faltantes, suavizado) -> extracción de características (métricas) -> modelado matemático -> visualización.

3. Contribuciones Clave

• Unificación de Funcionalidades: circStudio es el primer paquete que integra preprocesamiento flexible, cálculo de métricas estándar (IS, SRI, RA, M10, etc.) y modelado matemático avanzado en un solo entorno de Python.
• Flexibilidad y Personalización: Al desacoplar el preprocesamiento del cálculo de métricas, permite a los investigadores implementar pipelines personalizados y aplicar el paquete a datos distintos a la actividad locomotora.
• Soporte para Modelos Complejos: Implementa y facilita el uso de modelos complejos de ecuaciones diferenciales (ej. osciladores Van der Pol refinados) para predecir marcadores fisiológicos como el inicio de la melatonina en luz tenue (DLMO) y la presión de sueño.
• Herramientas de Preprocesamiento Avanzado: Ofrece funciones robustas para enmascarar periodos de inactividad espurios, imputar valores faltantes basándose en promedios diarios, y binarizar o suavizar señales.
• Código Abierto y Reproducible: Al ser un paquete de código abierto, fomenta la reproducibilidad y la colaboración comunitaria, superando las limitaciones del software propietario.

4. Resultados y Validación

• Caso de Estudio (Misión Submarina): Los autores aplicaron circStudio a datos de una misión militar submarina para investigar la relación entre la regularidad del sueño (SRI) y la amplitud relativa (RA).
  • Se identificó una correlación positiva moderada entre SRI y RA ($\rho = 0.422, p = 0.025$).
  • Se encontró una correlación negativa entre SRI y la actividad durante las 5 horas menos activas del día (L5) ($\rho = -0.514, p = 0.025$).
  • Estos resultados validan la hipótesis de que la irregularidad del sueño se asocia con una menor robustez del ritmo circadiano, mediada por una mayor actividad nocturna.
• Funcionalidad Técnica: El paquete demostró capacidad para procesar archivos crudos, calcular métricas complejas y ejecutar simulaciones de modelos (como el modelo Skeldon23 para la presión de sueño) de manera eficiente.

5. Significado e Impacto

• Avance en la Ciencia del Sueño y Cronobiología: circStudio proporciona una base flexible para investigaciones en biología de los ritmos circadianos, ciencia del sueño y salud digital, permitiendo transiciones eficientes de datos de wearables a resultados fisiológicos interpretables.
• Facilitación de Aplicaciones de Salud: Al ofrecer herramientas de análisis de nivel de investigación de forma accesible, facilita el desarrollo de aplicaciones orientadas a la salud.
• Futuro: El paquete sienta las bases para futuros desarrollos, como algoritmos automáticos para detectar periodos de no uso y potencialmente una interfaz gráfica de usuario (GUI) para ampliar su accesibilidad. Además, algunas funcionalidades podrían ser retrocompatibles con pyActigraphy.

En conclusión, circStudio representa un paso significativo hacia la estandarización y la interoperabilidad en el análisis de datos de actigrafía, eliminando barreras técnicas para la investigación avanzada en ritmos biológicos.