如何快速上手matRad：放射治疗计划研究的终极开源工具 🚀

matRad是一款基于Matlab开发的开源多模态放射治疗计划系统，专为教育和研究设计。它支持光子、质子、碳离子等多种射线类型的剂量计算与优化，提供直观的图形界面和灵活的脚本扩展能力，是放射治疗计划算法研究和教学的理想工具。

📌 核心功能亮点

多模态放射治疗支持

matRad支持光子（IMRT）、质子（IMPT）、碳离子等多种射线类型的治疗计划设计，满足不同研究场景需求。通过matRad/generateStf.m模块可快速生成射野参数，结合matRad/doseCalc/目录下的剂量计算引擎实现精准剂量分布模拟。

强大的剂量计算引擎

系统集成了解析算法与蒙特卡洛模拟两种剂量计算方式：

• 解析算法：通过matRad/doseCalc/matRad_calcPhotonDose.m和matRad_calcParticleDose.m实现快速剂量计算
• 蒙特卡洛模拟：支持MCsquare和TOPAS等开源引擎（位于matRad/doseCalc/MCsquare/和topas/目录）

直观的图形用户界面

matRad图形界面支持三维剂量分布可视化与治疗计划评估

通过matRadGUI.m启动的交互界面，可实现：

• 患者CT数据导入与可视化（matRad/IO/matRad_importPatient.m）
• 靶区与危及器官勾画
• 剂量体积直方图（DVH）分析（matRad/planAnalysis/matRad_calcDVH.m）
• 等剂量线三维显示（matRad/plotting/matRad_plotIsoDose3D.m）

🔧 快速安装指南

系统要求

• Matlab R2018b或更高版本（推荐R2020a+）
• 64位Windows/macOS/Linux操作系统
• 至少8GB内存（推荐16GB以上）

一键安装步骤

1. 克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/ma/matRad
   

2. 启动Matlab，导航至项目根目录
3. 运行初始化脚本：

   matRad_rc
   

4. 启动图形界面：

   matRadGUI
   

📚 入门教程：从示例开始

matRad提供丰富的示例脚本，帮助用户快速掌握核心功能：

光子治疗计划示例

运行examples/matRad_example2_photons.m，体验完整光子IMRT计划流程：

• 加载示例患者数据
• 自动生成射野配置
• 执行剂量优化
• 生成DVH报告

质子治疗计划示例

通过examples/matRad_example5_protons.m探索质子治疗特性：

• 基于布拉格峰的剂量分布
• 鲁棒性优化（examples/matRad_example8_protonsRobust.m）
• 生物效应模型应用（matRad/bioModels/目录）

💡 实用研究技巧

自定义优化目标函数

通过修改matRad/optimization/DoseObjectives/目录下的目标函数模块，实现个性化优化策略：

• 平方偏差目标（matRad_doseObejctiveSquaredDeviation.m）
• EUD（等效均匀剂量）目标（matRad_doseObejctiveEUD.m）
• 剂量体积直方图（DVH）约束（matRad/optimization/DoseConstraints/）

4D剂量计算功能

针对呼吸运动等生理运动影响，matRad/4D/目录提供了4D剂量计算工具：

• matRad_calc4dDose.m实现时间序列剂量累积
• matRad_makePhaseMatrix.m生成呼吸相位矩阵

🤝 社区与资源

学习资源

• 官方示例库：examples/目录包含17个完整案例
• 测试脚本：test/目录下的单元测试可帮助理解核心算法

贡献指南

matRad采用开源协作模式，欢迎通过以下方式贡献：

1. 提交issue报告bug或建议
2. 开发新功能并发起Pull Request
3. 完善文档和示例脚本

🎯 总结

matRad作为免费开源的放射治疗计划系统，为科研人员和教育工作者提供了强大而灵活的工具平台。无论是剂量算法研究、治疗计划优化，还是放射物理教学，matRad都能满足您的需求。立即克隆项目，开启您的放射治疗计划研究之旅吧！

---

项目仓库地址：

git clone https://gitcode.com/gh_mirrors/ma/matRad