[work in progress...]
A lightweight Python library for reading & writing BrainVoyager file formats.
bvbabel is a spiritual successor of Jochen Weber's Neuroelf's xff function, Thomas Emmerling's unmerged Nibabel pull request, and Hester Breman's earlier efforts around 2005. I have been inspired by these earlier projects, but ended up implementing from scratch based on BrainVoyager file formats documentation.
File format support overview
| File format | Read | Write | Create | Test data |
|---|---|---|---|---|
| FMR & STC | Yes | Yes | Yes | No |
| DMR | Yes | No | No | No |
| GLM | wip... | No | No | Yes |
| GTC | Yes | Yes | No | No |
| MSK | Yes | Yes | No | No |
| MTC | Yes | Yes | Yes | Yes |
| OBJ | No | Yes | No | No |
| POI | Yes | Yes | No | Yes |
| PRT | Yes | Yes | No | No |
| ROI | Yes | No | No | No |
| SRF | Yes | wip... | No | Yes |
| SMP | Yes | Yes | Yes | Yes |
| SSM | Yes | No | No | No |
| SDM | Yes | Yes | Yes | Yes |
| TRF | No | No | No | No |
| V16 | Yes | Yes | Yes | No |
| VMP | Yes | Yes | Yes | Yes |
| VMR | Yes | Yes | Yes | Yes |
| VOI | Yes | Yes | No | Yes |
| VTC | Yes | Yes | Yes | Yes |
Dependencies
| Required | Package | Tested version |
|---|---|---|
| Yes | Python 3 | 3.7.8 |
| Yes | NumPy | 1.17.2 |
| No | NiBabel | 3.2.0 |
Installation
- Clone the latest release and unzip it.
- Change directory in your command line:
cd /path/to/bvbabel - Install bvbabel:
python setup.py install - Once the installation is complete, you can have a look ant try using some of the example scripts at the examples folder.
BrainVoyager documentation
License
This project is licensed under MIT.
Contributors
Omer Faruk Gulban @ofgulban
Hester Breman @nausikaa8
Jorie van Haren @jorievanharen
Judith Eck @ju-ec
Assunta Ciarlo @assuntaciarlo
Caroline Brockhaus @carbrock
Chengran Li @ChengranAA
Acknowledgments
This project is fully supported by Brain Innovation (Maastricht, NL).
