sMRIPrep 使用教程

1. 项目的目录结构及介绍

sMRIPrep 是一个结构磁共振成像（sMRI）数据预处理管道，旨在提供一个易于访问的、对扫描采集协议变化鲁棒的、且用户输入最少的先进接口。以下是 sMRIPrep 项目的主要目录结构及其介绍：

sMRIPrep/
├── docs/                # 文档目录，包含项目的详细文档和使用说明
├── smriprep/            # 主代码目录，包含预处理管道的核心代码
│   ├── cli/             # 命令行接口代码
│   ├── workflows/       # 工作流定义和配置
│   ├── interfaces/      # 与外部工具的接口定义
│   ├── utils/           # 工具函数和辅助代码
│   └── __init__.py      # 模块初始化文件
├── tests/               # 测试代码目录，包含单元测试和集成测试
├── setup.py             # 项目安装脚本
├── README.md            # 项目介绍和使用说明
└── LICENSE              # 项目许可证

2. 项目的启动文件介绍

sMRIPrep 的启动文件主要位于 smriprep/cli 目录下，负责处理命令行参数并启动预处理管道。以下是主要的启动文件：

• smriprep.py: 主启动文件，负责解析命令行参数并调用相应的工作流。
• parser.py: 命令行参数解析器，定义了所有可用的命令行选项。

使用示例：

smriprep-docker /path/to/data/dir /path/to/output/dir participant

3. 项目的配置文件介绍

sMRIPrep 的配置文件主要用于定义工作流的行为和参数。以下是主要的配置文件：

• smriprep/workflows/config.py: 包含工作流的配置参数，如数据输入输出路径、预处理步骤等。
• smriprep/interfaces/config.py: 包含与外部工具接口的配置参数，如 FreeSurfer、FSL、ANTs 等。

配置文件示例：

# smriprep/workflows/config.py

# 数据输入路径
input_dir = '/path/to/data/dir'

# 数据输出路径
output_dir = '/path/to/output/dir'

# 预处理步骤配置
preprocessing_steps = {
    'skullstripping': True,
    'segmentation': True,
    'spatial_normalization': True,
    # 其他步骤...
}

通过以上配置文件，用户可以自定义 sMRIPrep 的工作流行为，以适应不同的数据预处理需求。