Repository files navigation

Code
Tests
PyPI
Packages
License & DOI

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 supportsFreeSurfer'sMGH, geometry, annotation andmorphometry files, and provides some limited support forDICOM.

NiBabel's API gives full or selective access to header information (metadata),and image data is made available via NumPy arrays. For more information, seeNiBabel'sdocumentation site andAPI reference.

To install NiBabel'scurrent release withpip, run:

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.gitpip install -e ./nibabel

For more information on previous releases, see therelease archive ordevelopment changelog.

During development, we recommend usingtox to run nibabel tests:

git clone https://github.com/nipy/nibabel.gitcd nibabeltox

To test an installed version of nibabel, install the test dependenciesand runpytest:

pip install nibabel[test]pytest --pyargs nibabel

For more information, consult thedeveloper guidelines.

Please send any questions or suggestions to theneuroimaging mailing list.

NiBabel is licensed under the terms of theMIT license.Some code included with NiBabel is licensed under theBSD license.For more information, please see theCOPYING file.

NiBabel releases have aZenodoDigital Object Identifier (DOI) badge atthe top of the release notes. Click on the badge for more information.