---
license: openrail
library_name: openmhc
pipeline_tag: time-series-forecasting
tags:
  - openmhc
  - wearables
  - time-series
  - imputation
---

# OpenMHC FEDformer

Reference checkpoint for [OpenMHC](https://github.com/AshleyLab/myheartcounts-dataset).
Window: daily (1440 minute), 19 sensor channels.

Wrapper around a [PyPOTS](https://github.com/WenjieDu/PyPOTS)-backed imputer trained on the OpenMHC imputation training split. Reconstructs masked sensor windows across 19 channels.

## Usage

```python
from openmhc.imputers import FEDformerImputer
import openmhc

imp = FEDformerImputer.from_release("hf://MyHeartCounts/openmhc-fedformer-imp")
results = openmhc.evaluate_imputation(imp, version="xs")
print(results.summary())
```

Requires the matching optional extras: `pip install 'openmhc[pypots,hf]'`.

Pin a specific revision with the `@` suffix:

```python
FEDformerImputer.from_release("hf://MyHeartCounts/openmhc-fedformer-imp@v1.1")
```

## Provenance

- Retrained 2026-06-02 with the `fourier_modes.json` sidecar — training-time
  stochastic Fourier basis indices (`mode_select="random"`) are now persisted
  and reloaded at inference so the model uses the same basis it was trained
  with. The pre-fix v1.0 bundle without the sidecar produced wrong
  reconstructions; **v1.1 is the version evaluated in the openmhc paper
  bootstrap**.
- Architecture hyperparameters are pinned in `openmhc_manifest.json`
  (`n_steps=1440, n_features=19, n_layers=2, d_model=512, n_heads=8,
  d_ffn=128, moving_avg_window_size=25, dropout=0.1, modes=32,
  mode_select="random", variant="Fourier"`).
- Files: `model.pypots` (PyPOTS checkpoint), `fourier_modes.json` (sidecar
  for random Fourier indices), `normalization_stats.json` (per-channel
  z-score stats), `openmhc_manifest.json` (spec v2).

## License

Released under the OpenRAIL license. See the OpenMHC repository for use
restrictions tied to the underlying data agreement.

## Citation

```bibtex
@misc{openmhc,
  title  = {OpenMHC: Accelerating the Science of Wearable Foundation Models},
  author = {OpenMHC team},
  url    = {https://github.com/AshleyLab/myheartcounts-dataset}
}
```