HealthSensorApp/com.wiloc.healthsensorapp.data.health.hrv/HRVCalculator

HRVCalculator

Calculadora de Variabilidad de la Frecuencia Cardíaca (HRV) para análisis en tiempo real.

Esta clase implementa algoritmos estándar para el cálculo de métricas de HRV basadas en intervalos RR (IBI - Inter-Beat Intervals) obtenidos de dispositivos de monitoreo cardíaco. La HRV es un indicador clave del estado del sistema nervioso autónomo y se utiliza para evaluar estrés, recuperación y estado de salud general.

Fundamentos Científicos

La Variabilidad de la Frecuencia Cardíaca (HRV) mide las variaciones en tiempo entre latidos cardíacos consecutivos. Un corazón sano no late como un metrónomo, sino que presenta variaciones naturales controladas por el sistema nervioso autónomo (SNA).

Métricas Implementadas

RMSSD: Raíz cuadrada de la media de diferencias cuadradas entre intervalos NN consecutivos
SDNN: Desviación estándar de todos los intervalos NN
pNN50: Porcentaje de intervalos NN que difieren más de 50ms del anterior
HRV Score: Puntuación normalizada (0-100) basada en edad y condición física

Interpretación Clínica

Alta HRV: Indica buena adaptabilidad del SNA, mejor estado de salud
Baja HRV: Puede indicar estrés, fatiga, sobreentrenamiento o problemas de salud
Tendencias: Más importante que valores absolutos para monitoreo personal

Uso Típico

val calculator = HRVCalculator()
val ibiList = listOf(800, 820, 790, 810, 805) // ms
val analysis = calculator.processIBIData(ibiList)

analysis?.let { hrv ->
    println("RMSSD: ${hrv.rmssd}ms")
    println("Nivel de estrés: ${hrv.stressLevel}")
    println("Recomendaciones: ${calculator.getHRVRecommendations(hrv)}")
}

Constructors

HRVCalculator

constructor()

Types

Companion

object Companion

DataQuality

enum DataQuality : Enum<HRVCalculator.DataQuality>

Enumera los niveles de calidad de datos para análisis de HRV.

HRVAnalysis

data class HRVAnalysis(val timestamp: Long = System.currentTimeMillis(), val rmssd: Double, val sdnn: Double, val pnn50: Double, val meanRR: Double, val meanHR: Double, val hrvScore: Int, val stressLevel: HRVCalculator.StressLevel, val recoveryState: HRVCalculator.RecoveryState, val trend: HRVCalculator.HRVTrend, val dataQuality: HRVCalculator.DataQuality, val sampleCount: Int, val measurementDuration: Long)

Clase de datos que encapsula el resultado completo del análisis de HRV.

HRVTrend

enum HRVTrend : Enum<HRVCalculator.HRVTrend>

Enumera las posibles tendencias de HRV basadas en análisis histórico.

RecoveryState

enum RecoveryState : Enum<HRVCalculator.RecoveryState>

Enumera los posibles estados de recuperación basados en HRV.

StressLevel

enum StressLevel : Enum<HRVCalculator.StressLevel>

Enumera los posibles niveles de estrés basados en análisis de HRV.