# AIDLAB-HAR v3 — corrected EDF/CSV distribution

This archive is the raw-data companion to the AIDLAB-HAR Hugging Face package.

Permanent distribution URL: https://aidlab-production-datasets.s3.eu-central-1.amazonaws.com/AIDLAB-HAR-DATASET_v3.zip

## Contents

- `data/*.edf`: 180 recordings with seven synchronized channels at 50 Hz.
- `data/*.csv`: 130 annotation files using `timestamp_s,event`.
- `quality_intervals.csv`: invalid acceleration or quaternion intervals detected during preparation.
- `CLEANING_NOTES.md`: corrections relative to the immutable public source.
- `LICENSE`: Creative Commons Attribution 4.0 International.

## EDF channels

| Label | Dimension | Physical range |
|---|---|---:|
| `acceleration_x` | `g` | −8 to +8 |
| `acceleration_y` | `g` | −8 to +8 |
| `acceleration_z` | `g` | −8 to +8 |
| `quaternion_x` | `1` | −1 to +1 |
| `quaternion_y` | `1` | −1 to +1 |
| `quaternion_z` | `1` | −1 to +1 |
| `quaternion_w` | `1` | −1 to +1 |

The EDF start date `1985-01-01` is a required placeholder, not an acquisition date. Use sample-relative timing. The `SUBxx` value is a pseudonymous source code and must not be interpreted as a globally unique participant identifier.

## Annotation semantics

Events are `series_onset`, `series_offset`, `repetition_marker_onset`, and `repetition_marker_offset`. Repetition-marker intervals are short fiducial windows and do not represent complete movement cycles.

## Quality intervals

`quality_intervals.csv` uses half-open intervals `[start_sample, end_sample_exclusive)`.

- Acceleration is valid when all components are finite. A vector norm below `0.1 g`
  is treated as missing only when the simultaneous quaternion is invalid. This
  preserves plausible airborne/free-fall samples.
- Quaternion is valid when all components are finite and vector norm is in `[0.9, 1.1]`.

The Parquet distribution represents values inside invalid intervals as null. EDF cannot represent null samples portably, so original decoded values remain in the EDF files and the intervals are supplied separately.

## Source and citation

Immutable source: https://aidlab-production-datasets.s3.eu-central-1.amazonaws.com/AIDLAB-HAR-DATASET_v2.zip

SHA-256: `bc501d73ad636d9db29ca65525811b9d3a76f7257d1a0f5d9143ccb8bbbd63d7`

Please cite: Ł. Czekaj et al., “Real-Time Sensor-Based Human Activity Recognition for eFitness and eHealth Platforms,” Sensors 24(12), 3891, 2024. https://doi.org/10.3390/s24123891
