|
Download README.md from braindecode/jungmae-pretrained: direct link, hf CLI and curl.
- Browser
- Download file 2.5 kB
-
https://huggingface.co/braindecode/jungmae-pretrained/resolve/main/README.md
- Command line
-
hf download hf://braindecode/jungmae-pretrained/README.md
-
curl -L -o README.md https://huggingface.co/braindecode/jungmae-pretrained/resolve/main/README.md
2.5 kB
| license: other | |
| library_name: braindecode | |
| tags: | |
| - braindecode | |
| - pytorch | |
| - safetensors | |
| - fnirs | |
| - masked-autoencoder | |
| - foundation-model | |
| # JungMAE (pretrained encoder, GeoNIRS release) | |
| Weights of the masked-autoencoder fNIRS foundation model of Jung, Lee and An (2025), as | |
| implemented and trained by the GeoNIRS authors (Li et al., 2026), for | |
| [`braindecode.models.JungMAE`](https://braindecode.org/stable/generated/braindecode.models.JungMAE.html). | |
| They are the encoder of `checkpoint/jung_mae.pt` of | |
| [GeoNIRS/GeoNIRS](https://github.com/GeoNIRS/GeoNIRS/tree/81f8995e5c3aa6b70e55812b194fc04e4e7ea5b7/checkpoint) | |
| at commit `81f8995`, converted by `convert.py`. | |
| ```python | |
| from braindecode.models import JungMAE | |
| model = JungMAE.from_pretrained( | |
| "braindecode/jungmae-pretrained", n_chans=40, n_outputs=2, n_times=60 | |
| ) | |
| features = model(x, return_features=True)["features"] | |
| ``` | |
| The classification head (`final_layer`) is not part of the release: it reads | |
| `n_chans * n_patches * embed_dim` features, so `from_pretrained` builds it for your montage and | |
| `n_outputs`. Fine-tune or linear-probe before use. | |
| ## Intended input | |
| The inputs of the GeoNIRS paper (Appendix B.1): HbO and HbR in µmol/L resampled to 5 Hz, each | |
| chromophore z-scored per recording over all its valid channels and time points. | |
| ## Changes from the original release | |
| `convert.py` unwraps the `{"model", "model_config", ...}` payload (its configuration equals the | |
| class defaults), drops the pretraining decoder (input projection, mask token, layers, prediction | |
| layer) and writes the encoder with `save_pretrained`. No value is changed: the encoder gives the | |
| features of the original file bit for bit on CPU in float32. | |
| ## License and citation | |
| The source repository has no licence file; the weights are by the GeoNIRS authors. Please cite | |
| the method and the release: | |
| ```bibtex | |
| @inproceedings{jung2025mae, | |
| author = {Jung, Euijin and Lee, Hyunmin and An, Jinung}, | |
| title = {{fNIRS} Foundation Model for Few-Shot Based {fNIRS} Classification}, | |
| booktitle = {2025 13th International Conference on Brain-Computer Interface (BCI)}, | |
| year = {2025}, | |
| doi = {10.1109/BCI65088.2025.10931275}, | |
| } | |
| @article{li2026geonirs, | |
| author = {Li, Zongsheng and Zhu, Shengyuan and Zhang, Zimo and Li, Hanyao and Wang, Shengming and Liu, Quanying}, | |
| title = {{GeoNIRS}: Geometry-Aware Pretraining for Heterogeneous {fNIRS} Representation Learning}, | |
| journal = {arXiv preprint arXiv:2610.17845}, | |
| year = {2026}, | |
| } | |
| ``` | |