简介这份资源是核医学仿真软件GATE的安装流程文档面向从事核医学仿真、蒙特卡罗模拟研究的科研人员与研究生帮助其在Linux环境下完成GATE及其依赖组件的部署。资源包内含1个PDF文件大小约1.09MB以图文形式系统梳理了从环境检查到组件安装的完整脉络。内容覆盖gcc与cmake的版本核查与安装、针对不同Ubuntu版本12.04至18.04的必备包安装命令、ROOT二进制包的解压与source配置以及Geant4版本匹配与编译要点并特别提示了GATE_USE_OPTICAL功能所需的libxml2-dev依赖。文档还针对依赖冲突、包版本不匹配等常见问题给出了排查思路并建议为Gate及相关软件单独建立目录以便管理。目前已有1049人学习适合需要快速搭建GATE仿真环境、减少编译踩坑的读者参考。1. 核医学仿真软件GATE安装流程从零把Geant4和ROOT串起来如果你做核医学成像仿真比如PET、SPECT的蒙特卡洛建模大概率绕不开GATE这套开源框架。它底层跑的是Geant4的物理过程上层用ROOT做数据输出和分析整套工具链在Linux上跑得最顺。但很多人第一次装GATE就卡住了——不是卡在GATE本身而是卡在Geant4和ROOT的版本匹配、环境变量串联、ccmake配置这几个环节。这篇笔记按我实际装Gate 8.0的流程走一遍从检查gcc/cmake开始到跑通benchPET验证结束。适合刚接触核医学仿真、需要在Ubuntu上从源码编译GATE的从业者也适合之前装失败过、想排查版本对应关系的熟手。2. 装GATE之前先把地基打牢gcc、cmake与系统依赖包GATE的安装本质上是一条编译链系统基础工具 → Geant4 → ROOT → GATE。任何一环版本不对或者环境变量没串上后面都会翻车。所以这一章先把最底层的gcc、cmake和系统依赖包处理干净别急着去下载GATE的tar包。2.1 检查gcc和cmake版本是否达标先看当前系统里有没有编译工具以及版本够不够。打开终端直接敲gcc --version cmake --versionGATE 8.0对gcc的要求是版本不低于4.8cmake不低于3.x。我机器上gcc是7.3.0虽然不在官方推荐的[4.8-6.2]区间内但只要不低于最低版本就能用。cmake同理满足最低要求即可。如果提示“command not found”或者版本太低就往下走安装步骤。2.2 安装build-essential和cmakeUbuntu下最省事的做法是用apt一把装齐sudo apt-get update sudo apt-get install build-essential sudo apt-get install cmakebuild-essential这个包会带上gcc、g、make、libc-dev等一整套编译工具不用单独一个个装。cmake单独装是因为它不在build-essential的依赖里。装完再跑一次gcc --version和cmake --version确认。2.3 按Ubuntu版本装系统依赖包这一步是最容易出玄学问题的地方。GATE官方wiki按Ubuntu版本给了不同的包列表核心差异在Qt4和Qt5的库名上。我整理成表格方便对照系统版本对应GATE/Geant4版本关键依赖包Ubuntu 18.04.2 LTSGATE v8.2 / Geant4 10.5 p01cmake-curses-gui、libqt5-default、libxmu-devUbuntu 16.04.2 LTSGATE v8.0 / Geant4 10.3 p01cmake-curses-gui、libqt4-dev、libxmu-devUbuntu 14.04.3 LTSGATE v7.1 / Geant4 10.1 p02libqt4-opengl、libqt4-core、libX11-dev以Ubuntu 16.04装GATE 8.0为例完整命令是sudo apt-get install cmake cmake-curses-gui build-essential \ libqt4-opengl-dev qt4-qmake libqt4-dev \ libx11-dev libxmu-dev libxpm-dev libxft-dev如果编译时要启用GATE_USE_OPTICAL光学仿真功能还得补一个sudo apt-get install libxml2-dev注意如果apt报依赖冲突或版本不对优先按提示把缺失的依赖库补上实在解决不了就换Ubuntu 16.04这个版本在GATE社区里验证得最充分。2.4 建立独立的安装目录树在动手编译之前建议先规划好目录结构。我一般会在home下建一个sim_workspace里面分root、geant4、gate三个子目录各自再分source、build、install。这样做的好处是后面写环境变量脚本时路径清晰不会把源码目录和编译目录搞混。源码解压到sourceccmake在build里跑make install指向install三个目录互不污染。3. ROOT和Geant4的编译安装版本匹配是生死线GATE本身不直接依赖ROOT和Geant4的源码它依赖的是这两个库编译出来的二进制和头文件。所以这一章的核心就两件事ROOT用二进制包快速搞定Geant4用源码编译并确保版本和GATE对得上。3.1 ROOT优先用官方二进制包ROOT没必要从源码编译官方提供了各平台的预编译二进制包下载解压就能用。去ROOT官网下载对应Ubuntu版本和gcc版本的tar.gz比如tar -xzf root_v6.xx.xx.Linux-ubuntu16-x86_64-gcc5.4.tar.gz mv root root_v6.xx source /home/user/sim_workspace/root/root_v6.xx/bin/thisroot.shthisroot.sh这个脚本会把ROOT的bin、lib、include路径写进当前shell的环境变量。验证方式是直接输入root如果能进入ROOT的C交互界面就说明成功了。注意source thisroot.sh只在当前终端会话有效。新开一个终端就得重新source这也是后面要写gate_env.sh统一管理的原因。3.2 Geant4版本必须和GATE版本严格对应这是整个安装流程里最关键的一条GATE 8.0对应Geant4 10.3GATE 8.2对应Geant4 10.5 p01。版本不对ccmake配置阶段就会报错或者编译到一半链接失败。去Geant4官网下载对应版本的源码包tar -xzf geant4.10.03.p03.tar.gz mkdir geant4.10.03-build mkdir geant4.10.03-install cd geant4.10.03-build ccmake ../geant4.10.03.p033.3 ccmake配置Geant4的关键参数进入ccmake界面后按c开始配置按e返回。需要重点关注的几个参数参数名设置值说明CMAKE_INSTALL_PREFIX/home/user/sim_workspace/geant4/geant4.10.03-install必须用绝对路径GEANT4_INSTALL_DATAON自动下载物理数据文件必选GEANT4_USE_SYSTEM_CLHEPOFFGATE 7.0之后用Geant4集成的CLHEPGEANT4_USE_OPENGL_X11ON可视化需要GEANT4_USE_QTON图形界面需要配置完再按一次c重新配置然后按g生成Makefile并退出。接着编译安装make -j4 make install source /home/user/sim_workspace/geant4/geant4.10.03-install/bin/geant4.sh-j4里的4是并行编译的核数按自己CPU核心数填。编译过程大概二三十分钟取决于机器性能。4. 编译GATE 8.0ccmake配置与常见报错处理前面ROOT和Geant4都装好并且source过环境变量之后才能开始编译GATE。这一章把GATE的编译流程和几个高频报错点讲清楚。4.1 下载解压与目录准备从GATE官网下载Gate-8.0.tar.gz解压后建build和install目录tar -xzf Gate-8.0.tar.gz mkdir gate_v8.0-build mkdir gate_v8.0-install在进入build目录之前务必在当前终端重新source一次ROOT和Geant4的环境变量source /home/user/sim_workspace/root/root_v6.xx/bin/thisroot.sh source /home/user/sim_workspace/geant4/geant4.10.03-install/bin/geant4.sh如果这一步忘了sourceccmake配置时找不到ROOT或Geant4的路径后面会连环报错。4.2 ccmake配置GATE的核心参数cd gate_v8.0-build ccmake ../Gate-8.0按c配置后重点检查这几个参数参数名设置值说明CMAKE_INSTALL_PREFIX/home/user/sim_workspace/gate/gate_v8.0-install安装路径Geant4_DIRGeant4安装目录下的lib/Geant4-10.3.3路径不匹配需手动改ROOTCINT_EXECUTABLEROOT安装目录下的bin/rootcint路径不匹配需手动改GATE_USE_ECAT7OFF可选包普通用户不需要GATE_USE_ITKOFF可选包普通用户不需要GATE_USE_LMFOFF可选包普通用户不需要如果Geant4_DIR和ROOTCINT_EXECUTABLE的路径和你实际安装的不一致手动改成正确路径。改完按c再配置一次按g生成Makefile。4.3 编译安装与验证make -j4 make install编译时间比Geant4短一些大概十几分钟。装完之后GATE的可执行文件在gate_v8.0-install/bin/下面。4.4 环境变量脚本gate_env.sh的写法在gate_v8.0-install/bin/下新建gate_env.sh#!/bin/sh source /home/user/sim_workspace/root/root_v6.xx/bin/thisroot.sh source /home/user/sim_workspace/geant4/geant4.10.03-install/bin/geant4.sh export PATH$PATH:/home/user/sim_workspace/gate/gate_v8.0-install/bin然后source一下source /home/user/sim_workspace/gate/gate_v8.0-install/bin/gate_env.sh输入Gate如果能进入交互界面就说明环境变量串通了。为了不用每次开终端都手动source把最后这行加到~/.bashrc末尾echo source /home/user/sim_workspace/gate/gate_v8.0-install/bin/gate_env.sh ~/.bashrc5. 避坑指南GATE安装中最容易翻车的五个地方这一章记录我在装GATE过程中实际踩过的坑每条按现象、原因、解决来写。如果你正在装或者装失败了对照排查。5.1 ccmake报错找不到Geant4或ROOT现象ccmake配置GATE时提示Could NOT find Geant4或ROOTCINT_EXECUTABLE-NOTFOUND。原因当前终端没有source Geant4和ROOT的环境变量或者source的路径写错了。解决在跑ccmake之前先确认which geant4-config和which root能输出正确路径。如果输出为空重新source对应的sh脚本。source完再进build目录跑ccmake。5.2 Geant4编译时DATA下载失败现象make过程中卡在下载物理数据文件或者报网络超时。原因Geant4的DATA文件体积大网络不稳定时容易断。解决在ccmake里把GEANT4_INSTALL_DATA设为ON后可以手动去Geant4官网下载对应的DATA包解压到install目录下的share/Geant4-10.3.3/data/再重新make install。5.3 GATE编译时报CLHEP链接错误现象链接阶段报undefined reference to CLHEP::...。原因ccmake里GEANT4_USE_SYSTEM_CLHEP被设成了ON但系统里没有独立安装CLHEP。解决回到Geant4的build目录重新ccmake把GEANT4_USE_SYSTEM_CLHEP改成OFF重新make install。GATE 7.0之后用Geant4集成的CLHEP就够了。5.4 新开终端后Gate命令找不到现象当前终端能跑Gate新开一个终端就提示Gate: command not found。原因gate_env.sh只在当前shell里source过没有写进~/.bashrc。解决把source /path/to/gate_env.sh加到~/.bashrc末尾然后source ~/.bashrc。之后每次开终端会自动加载。5.5 benchmark运行报错或卡死现象跑Gate benchPET.mac时程序卡住不动或者报ROOT文件写入错误。原因可能是之前残留的benchmarkPET.root文件权限不对或者ROOT环境变量没加载。解决先删掉旧的root文件rm benchmarkPET.root确认root命令能正常启动再重新跑Gate benchPET.mac。跑大约1分钟后按Ctrlz终止然后用ROOT打开生成的root文件验证。6. 验证安装与benchPET跑通从mac脚本到root分析装完不验证等于没装。GATE源码包里自带benchmarks目录其中benchPET是最适合做安装验证的算例。这一章把验证流程走一遍顺便说几个我常用的检查习惯。6.1 跑benchPET验证基本组件先开一个新终端确认Gate命令可用然后进入benchmarks目录cd /home/user/sim_workspace/gate/Gate-8.0/benchmarks/benchPET ls如果目录下有benchmarkPET.root先删掉rm benchmarkPET.root然后运行Gate benchPET.mac程序会开始跑蒙特卡洛模拟大约1分钟后按Ctrlz终止。此时目录下应该生成了benchmarkPET.root文件。6.2 用ROOT查看仿真输出root进入ROOT交互界面后.x benchmarkPET.C这个宏会读取root文件并画出PET探测器的能量谱和符合事件分布。如果能看到直方图正常显示说明Geant4的物理过程、ROOT的I/O、GATE的探测器建模这条链路全部打通了。6.3 我每次装完必做的三个检查第一个检查是Gate --version确认版本号输出正确。第二个检查是root -b -q跑一个空宏确认ROOT的批处理模式没问题。第三个检查是看gate_v8.0-install/bin/下有没有Gate可执行文件以及gate_env.sh里的路径是否都指向实际存在的目录。这三个检查花不了一分钟但能避免后面跑正式仿真时才发现环境有问题。6.4 关于可选包的取舍ECAT7、ITK、LMF这些可选包普通玩家做基础PET/SPECT仿真基本用不到。我的建议是第一次装GATE全部保持OFF先把主流程跑通。等确实需要读ECAT7格式的医学图像数据或者要做LMF列表模式仿真时再回头重新编译GATE并打开对应选项。这样能把第一次安装的变量降到最少出了问题也容易定位。从那以后我每次装GATE都会先把gcc、cmake、Geant4、ROOT四个组件的版本号写在纸上ccmake配置时逐个核对路径最后跑一遍benchPET确认整条链路通畅。这套流程走下来基本不会再出现装到一半发现版本不对要推倒重来的情况。希望帮到你。本文还有配套的精品资源点击获取