v0.3.0 - Docker Support & 14-Step Pipeline

fMRIPrep Workbench v0.3.0

🚀 Major Features

🐳 Docker Containerization

• Complete Docker support with multi-platform images (linux/amd64, linux/arm64)
• Easy-to-use wrapper script with commands: start, stop, launch, shell, logs, status
• Docker Compose configuration for streamlined deployment
• Singularity/Apptainer support for HPC clusters
• Automated CI/CD pipeline to Docker Hub

📊 FSL FEAT Statistical Analysis (Steps 10-13)

• Complete GLM analysis workflow (Level 1, 2, 3)
• Interactive setup utility with model configuration
• Support for condition keys, contrasts, and confound regressors
• SLURM array job integration for parallel processing

🧠 FreeSurfer Manual Editing Workflow (Steps 7-8)

• Download/upload utilities for manual surface editing
• Automatic timestamped backups before upload
• Support for batch operations on multiple subjects
• Interactive and non-interactive modes

📚 Documentation Migration

• Migrated from Sphinx (RST) to MkDocs (Markdown)
• Material theme with dark mode support
• PDF export capability
• Improved navigation and search

🔢 14-Step Pipeline Architecture

Complete end-to-end workflow from acquisition to analysis:

• Steps 1-6: Download, conversion, prep, QC
• Steps 7-8: FreeSurfer editing workflow
• Step 9: Full fMRIPrep execution
• Steps 10-13: FSL FEAT GLM analysis
• Step 14: Data management utilities

🐛 Bug Fixes

• Subject list processing: Filter comments and empty lines
• DICOM conversion: Multi-session handling, single-echo sequences
• QC scripts: Write logs to correct directory
• File handle leaks: Use context managers in FSL GLM scripts
• Container management: Replace fixed delays with readiness polling

💥 Breaking Changes

• Directory renaming: 07-run-fmriprep → 09-run-fmriprep, 08-fsl-glm → 10-fsl-glm
• Pipeline structure: Expanded from 7 to 14 steps
• Documentation format: Changed from Sphinx to MkDocs

📦 Installation

Docker (Recommended)

docker pull shawnschwartz/fmriprep-workbench:0.3.0

Singularity (HPC Clusters)

Download the .sif file from the release assets below.

See the documentation for complete installation and usage instructions.

📖 Documentation

• Installation Guide
• Docker Usage Guide
• Configuration Guide
• Full Documentation

Full Changelog: v0.1.8...v0.3.0