# Statistics Documentation by Type

This document outlines the various statistical metrics collected, grouped by their type, and details their corresponding JSON structures for different time spans.

## STRESSORS

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: AWAKE


```json
{
  "duration": <Double|null>, // Total time under stress (in milliseconds)
  "recovery": <Double|null>, // Average recovery time (in milliseconds)
  "frequency": <Double|null> // Count of detected stressors
}
```

## STRESS_FREQUENCY

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: AWAKE


```json
{
  "sentence": <String|null> // Descriptive sentence for STRESS_FREQUENCY
}
```

## INTENSE_ACTIVITY

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: AWAKE


```json
{
  "value": <Double|null> // Total Intense Activity duration (in milliseconds)
}
```

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: AWAKE


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: AWAKE


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: AWAKE


```json
{
  "sentence": <String|null> // Descriptive sentence for INTENSE_ACTIVITY
}
```

## RESTING_HEART_RATE

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: AWAKE


```json
{
  "value": <Double|null> // Resting Heart Rate (in bpm)
}
```

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: AWAKE


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: AWAKE


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: AWAKE


```json
{
  "sentence": <String|null> // Descriptive sentence for RESTING_HEART_RATE
}
```

## HRV

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: SLEEP


```json
{
  "value": <Double|null> // Heart Rate Variability (raw value)
}
```

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: SLEEP


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: SLEEP


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: SLEEP


```json
{
  "sentence": <String|null> // Descriptive sentence for HRV
}
```

## STRESS_DURATION

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: AWAKE


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: AWAKE


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: AWAKE


```json
{
  "sentence": <String|null> // Descriptive sentence for STRESS_DURATION
}
```

## STRESS_RECOVERY

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: AWAKE


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: AWAKE


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: AWAKE


```json
{
  "sentence": <String|null> // Descriptive sentence for STRESS_RECOVERY
}
```

## SLEEP_DURATION

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: SLEEP


```json
{
  "value": <Double|null>, // Total Sleep Duration (in milliseconds, converted from hours)

}
```

### Typical Range Values

`timeSpan`: ONE_MONTH

`timeFilter`: SLEEP


```json
{
  "typicalRaw": {
    "value": <Double|null>,      // Typical Mean (Raw)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Raw)
    "upperStd": <Double|null>    // Typical Upper Deviation (Raw)
  },
  "typicalSmoothed": {
    "value": <Double|null>,      // Typical Mean (Smoothed)
    "lowerStd": <Double|null>,   // Typical Lower Deviation (Smoothed)
    "upperStd": <Double|null>    // Typical Upper Deviation (Smoothed)
  }
}
```

### Descriptive Values

`timeSpan`: TWO_WEEKS

`timeFilter`: SLEEP


```json
{
  "sentence": <String|null> // Descriptive sentence for SLEEP_DURATION
}
```

## SLEEP_REGULARITY

### Daily Summarized Values

`timeSpan`: ONE_DAY

`timeFilter`: SLEEP


```json
{
  "sleeps": [
    {
      "start": "<String>",   // Bedtime (ISO8601 format)
      "end": "<String>",     // Wake Time (ISO8601 format)
      "awakenings": [
        {
          "start": "<String>",
          "end": "<String>"
        }
      ],
      "showStages": <Bool> // Indicates if detailed sleep stages should be shown
    }
  ]
}
```

### Y-Axis Range Values

`timeSpan`: SIX_MONTHS

`timeFilter`: SLEEP


```json
{
  "overviewYAxis": {
    "min": <Double|null>, // Minimum Y-axis value (sent in milliseconds for time metrics)
    "max": <Double|null>  // Maximum Y-axis value (sent in milliseconds for time metrics)
  }
}
```

### Descriptive Values

`timeSpan`: ONE_MONTH

`timeFilter`: SLEEP


```json
{
  "sentence": <String|null> // Descriptive sentence for SLEEP_REGULARITY
}
```