telenib

Read header of remote nifti according to nifti1 spec and nifti2 spec either gzipped or not.

Requirements

server must support RANGE request.

• requests
• nibabel

Why?

For large nifti files, it is often not feasible to download the full nifti file in order to access the header.

Installation

• via pip

pip install telenib

Usage

from telenib import get_nii_header
from nibabel import Nifti1Header, Nifti2Header

nii_url="https://nifti.nimh.nih.gov/nifti-1/data/avg152T1_RL_nifti.nii.gz"
tele_header = get_nii_header(nii_url)

assert isinstance(tele_header, Nifti1Header) or isinstance(tele_header, Nifti2Header)

One could also add any custom header

from telenib import get_nii_header

# from https://nifti.nimh.nih.gov/nifti-1/data
nii_url="https://my.example.co/my/dir/nii.nii.gz"
tele_header = get_nii_header(nii_url, headers={
    'Authorization': f'token my-secret-token'
})

print(tele_header)

License

MIT