---
library_name: braindecode
license: mit
tags:
- braindecode
- eeg
- motor-imagery
- foundation-model
---

# MIRepNet

Braindecode-format re-host of the official MIRepNet checkpoint released by
Liu et al. The checkpoint can be loaded directly through Braindecode's standard
Hugging Face integration:

```python
from braindecode.models import MIRepNet

model = MIRepNet.from_pretrained("braindecode/mirepnet-pretrained")

# Fine-tuning for another task replaces the released three-class head.
model = MIRepNet.from_pretrained(
    "braindecode/mirepnet-pretrained",
    n_outputs=4,
)
```

## Released configuration

- 45 channels in the order stored in `mirepnet_channels.json`
- 1,000 samples at 250 Hz
- 256-dimensional embedding
- 6 Transformer blocks with 8 heads
- 3-output supervised pretraining head

The paper's 8--30 Hz filtering, resampling, channel-template preparation, and
Euclidean alignment are preprocessing steps and are not performed by the model.

## Provenance and conversion

- Official code: https://github.com/staraink/MIRepNet at revision
  `edb80d7605f75ba8b72b417a124cc9db07385f72`
- Official checkpoint: https://huggingface.co/starself/MIRepNet at revision
  `9bac0439c0d3e9ffdb40ca675d61a51b439a446e`
- Source file: `MIRepNet.pth`, SHA-256
  `432288958007e344a5a84a9ffe9d0e5e5c0cb616aef86c85522375a3f4da9aaf`

All 109 downstream tensors were converted. The 34 pretraining-only tensors
(`mask_token`, `decoder.*`, and the upstream `embedding.chan_embed.weight`,
which is not used by the released forward pass) were intentionally omitted.
Against the official implementation, maximum absolute error was `2.38e-7` for
pooled features and `1.19e-7` for logits. The conversion is reproducible with
`convert_mirepnet_checkpoint.py`.

The source code and checkpoint are distributed under the MIT License. The
original copyright notice is preserved in `LICENSE`.

## Limitations

The official repository does not document the semantic ordering of the three
pretraining-head outputs. Replace the head with `n_outputs=...` and fine-tune it
for downstream use unless that label mapping has been independently verified.
Dataset licenses are separate from the checkpoint's MIT license.

## Citation

```bibtex
@article{LIU2026115966,
  title = {MIRepNet: A pipeline and pre-trained model for EEG-based motor imagery classification},
  journal = {Knowledge-Based Systems},
  volume = {343},
  pages = {115966},
  year = {2026},
  issn = {0950-7051},
  doi = {10.1016/j.knosys.2026.115966},
  url = {https://www.sciencedirect.com/science/article/pii/S0950705126006921},
  author = {Dingkun Liu and Zhu Chen and Jingwei Luo and Shijie Lian and Yuheng Chen and Shaojie Hou and Xiaolian Zhu and Dongrui Wu}
}
```