Skip to content

Output Directory Structure

Target Audience

Neuroimaging researchers interpreting pipeline outputs.

The pipeline creates a structured output hierarchy under <path>/<subject_id>/. This page describes the full directory layout and the key files produced at each location.


Top-Level Layout

<path>/<subject_id>/
├── raw/
│   └── anatMRI/
│       ├── T1/
│       │   ├── T1_orig.nii.gz          # original input copy
│       │   └── T1_orig_defaced.nii.gz  # defaced original (if --nodefacing not set)
│       └── T2/
│           ├── T2_orig.nii.gz
│           └── T2_orig_defaced.nii.gz
├── analysis/
│   └── anatMRI/
│       ├── T1/
│       │   ├── preproc/
│       │   ├── processed/
│       │   ├── temp/                   # removed after pipeline completes
│       │   └── log/
│       └── T2/
│           ├── preproc/
│           ├── processed/
│           └── temp/
└── log/

T1 Preprocessed Outputs (analysis/anatMRI/T1/preproc/)

Sub-folder Key Files Description
reg/ T1_2_std.mat T1 → MNI linear affine matrix
reg/ std_2_T1.mat MNI → T1 inverse affine
reg/ T1_2_std_warp_field.nii.gz T1 → MNI non-linear warp (RegType 2/3)
reg/ T1_2_std_warp_coeff.nii.gz FNIRT warp coefficients (RegType 2 only)
reg/ std_2_T1_warp_field.nii.gz MNI → T1 inverse warp
bias/ T1_brain_bias.nii.gz FAST-estimated bias field
SIENAX/ report.sienax Brain volume report (mm³)
qc/ (optional) Quality control outputs

T1 Processed Outputs (analysis/anatMRI/T1/processed/)

Sub-folder Key Files Description
data/ T1.nii.gz Cropped, reoriented T1 (not bias-corrected)
data/ T1_brain.nii.gz Skull-stripped T1
data/ T1_brain_mask.nii.gz Binary brain mask
data/ T1_unbiased.nii.gz Bias-corrected whole-head T1
data/ T1_unbiased_brain.nii.gz Bias-corrected skull-stripped T1
data2std/ T1_2_std.nii.gz T1 in MNI152 space (linear)
data2std/ T1_2_std_brain_lin.nii.gz Brain-only T1 in MNI (linear)
data2std/ T1_2_std_warped.nii.gz T1 in MNI152 space (non-linear)
data2std/ T1_2_std_brain_warped.nii.gz Brain-only T1 in MNI (non-linear)
seg/tissue/sing_chan/ T1_pve_CSF.nii.gz CSF partial volume estimate
seg/tissue/sing_chan/ T1_pve_GM.nii.gz Grey matter partial volume estimate
seg/tissue/sing_chan/ T1_pve_WM.nii.gz White matter partial volume estimate
seg/tissue/sing_chan/ T1_{CSF,GM,WM}_mask.nii.gz Thresholded binary tissue masks
seg/tissue/sing_chan/ T1_pveseg.nii.gz FAST hard segmentation (integer labels)
seg/tissue/multi_chan/ T1_pve_{CSF,GM,WM}.nii.gz Joint T1+T2 FAST segmentation (if T2 provided)
seg/sub/ T1_subcort_seg.nii.gz FIRST subcortical segmentation (if --subseg)
FreeSurfer/ Full recon-all output FreeSurfer subject directory (if --freesurfer)
FastSurfer/ Full FastSurfer output FastSurfer subject directory (if --fastsurfer)

T2 Outputs (analysis/anatMRI/T2/)

Path Key Files Description
processed/data/ T2.nii.gz T2 aligned to T1 native space
processed/data/ T2_brain.nii.gz Skull-stripped T2
processed/data/ T2_unbiased.nii.gz Bias-corrected T2
processed/data2std/ T2_2_std.nii.gz T2 in MNI space (linear)
processed/data2std/ T2_2_std_warped.nii.gz T2 in MNI space (non-linear)
preproc/reg/ T2_2_std.mat T2 → MNI affine
preproc/lesions/ final_mask.nii.gz Binary WM lesion mask (BIANCA)
preproc/lesions/ volume.txt Lesion volume in voxels

Log Files

A log file is created at analysis/anatMRI/T1/log/log.txt and captures all processing steps, timestamps, software versions, and parameter values.