Read and write access to common neuroimaging file formats, including: ANALYZE (plain, SPM99, SPM2 and later), GIFTI, NIfTI1, NIfTI2, CIFTI-2, MINC1, MINC2, AFNI BRIK/HEAD, ECAT and Philips PAR/REC. In addition, NiBabel also supports FreeSurfer’s MGH, geometry, annotation and morphometry files, and provides some limited support for DICOM.
NiBabel’s API gives full or selective access to header information (metadata), and image data is made available via NumPy arrays. For more information, see NiBabel’s documentation site and API reference.
To install NiBabel’s current release with
pip install nibabel
To install the latest development version, run:
pip install git+https://github.com/nipy/nibabel
When working on NiBabel itself, it may be useful to install in “editable” mode:
git clone https://github.com/nipy/nibabel.git pip install -e ./nibabel
Please send any questions or suggestions to the neuroimaging mailing list.
User Documentation (manual)
Tutorials (relevant tutorials on imaging)
API Documentation (comprehensive reference)
Developer Guidelines (for those who want to contribute)
Development Changelog (see what has changed)
DICOM concepts (details about implementing DICOM reading)
Index (access by keywords)
Search Page (online and offline full-text search)
See also the Developer documentation page for development discussions, release procedure and more.
NiBabel is free-software (beer and speech) and covered by the MIT License. This applies to all source code, documentation, examples and snippets inside the source distribution (including this website). Please see the appendix of the manual for the copyright statement and the full text of the license.
Download and Installation¶
Please find detailed download and installation instructions in the manual.
If you have problems installing the software or questions about usage, documentation or anything else related to NiBabel, you can post to the NiPy mailing list.
We recommend that anyone using NiBabel subscribes to the mailing list. The mailing list is the preferred way to announce changes and additions to the project. You can also search the mailing list archive using the mailing list archive search located in the sidebar of the NiBabel home page.