getDimensions: Get Dimensions from a Neuroimaging File

In neuroSCC: Bridging Simultaneous Confidence Corridors and PET Neuroimaging

Get Dimensions from a Neuroimaging File

Description

Extracts voxel dimension information from a NIfTI or similar neuroimaging file. This function is designed to work with neuroCleaner, but it can also be used independently to inspect image dimensions.

Usage

getDimensions(file)

Arguments

file	A NIfTI file object or a file path pointing to a NIfTI image.

Details

The function accepts either a file path or a preloaded nifti object. If a file path is provided, it uses oro.nifti::readNIfTI() to load the image. This function ensures consistent dimension extraction across the neuroSCC pipeline.

Value

A named list with the following elements

• xDim – Number of voxels along the X axis.

• yDim – Number of voxels along the Y axis.

• zDim – Number of slices along the Z axis.

• dim – Total number of voxels in a 2D slice (calculated as xDim * yDim).

Examples

# Get the file path for a sample NIfTI file
niftiFile <- system.file("extdata", "syntheticControl1.nii.gz", package = "neuroSCC")

# Extract dimensions from the NIfTI file
dimensions <- getDimensions(niftiFile)

# Display the extracted dimensions
print(dimensions)

neuroSCC documentation built on April 4, 2025, 3:50 a.m.