print_nifti_metadata

qx_utilities.general.img.print_nifti_metadata(filename, info='list')

print_nifti_metadata <image_filename> [info=list]

Print metadata extension blocks from a NIfTI file.

Parameters

--filename (str):

The path to the NIfTI file (.nii or .nii.gz)

--info (str, default 'list'):

Which metadata to print.

Possible values: - 'list': List metadata blocks without content (default) - 'all': Print all metadata blocks with full content - 'cifti': Print CIFTI metadata (ecode 32) - 'qunex' or 'qx': Print QuNex metadata (ecode 64) - Numeric code (e.g., 32, 64, 2, etc.): Print metadata with that code

Notes

NIfTI files can contain metadata extension blocks after the header. This function inspects and displays the content of these blocks.

METADATA CODES:

Common NIfTI extension codes: - 0: Unknown private format - 2: DICOM format - 4: AFNI group format - 6: Comment - 8: XCEDE format - 10: Jiffy XML format - 12: Unused - 14: Unused - 16: Unused - 18: MIND_IDENT format - 20: B_VALUE extension - 22: SPHERICAL_DIRECTION extension - 24: DT_COMPONENT extension - 26: SHC_DEGREEORDER extension - 28: VOXBO extension - 30: CARET extension - 32: CIFTI extension (XML format) - 34: VARIABLE_FRAME_TIMING extension - 36: MATLAB workspace extension - 38: QUANTIPHYSE extension - 40: MRS extension - 42: PYTHON pickle extension - 64: QuNex extension

Examples

::

# List metadata blocks (default) print_nifti_metadata('bold1.dtseries.nii')

# Print all metadata with full content print_nifti_metadata('bold1.dtseries.nii', info='all')

# Print only CIFTI metadata print_nifti_metadata('bold1.dtseries.nii', info='cifti')

# Print only QuNex metadata print_nifti_metadata('bold1.nii', info='qunex')

# Print metadata with specific numeric code print_nifti_metadata('bold1.nii', info=32) # CIFTI print_nifti_metadata('bold1.nii', info=6) # Comment