FLUKA 這款軟件做輻射防護(hù)和粒子輸運(yùn)的人應(yīng)該都不陌生。它和 MCNP、Geant4 并列為蒙特卡羅模擬工具里的老牌主力在加速器屏蔽設(shè)計(jì)、醫(yī)學(xué)物理、空間劑量評(píng)估這些方向都有大量應(yīng)用。問題是對(duì)很多剛接觸它的人來說第一步不是學(xué)會(huì)寫輸入卡片而是先把軟件在 Linux 上裝起來。我過去幫學(xué)生配過不少次環(huán)境也見過很多人卡在各種奇怪的報(bào)錯(cuò)上最后連程序都沒跑起來就放棄了。這篇筆記基于我在 Ubuntu 20.04/22.04 上的完整安裝過程所有命令都實(shí)際操作驗(yàn)證過按照步驟復(fù)制即可如果你想長(zhǎng)線用 FLUKA 做計(jì)算我也把環(huán)境變量、配套 GUI、驗(yàn)證方法這些細(xì)節(jié)一并寫了。我不打算講太多空泛的“蒙特卡羅原理”而是直接把你需要敲的命令、需要改的文件和需要避開的坑鋪開講。從一個(gè)從業(yè)者的角度說安裝這類科學(xué)計(jì)算軟件最核心的就三件事依賴環(huán)境是否齊全、路徑變量是否配置正確、能不能跑通一個(gè)官方自帶的測(cè)試算例。只要這三件事過關(guān)后面出問題的概率會(huì)小很多。1. 安裝前的準(zhǔn)備工作別急著下載先把系統(tǒng)底子打好1.1 確認(rèn)你的 Ubuntu 版本和系統(tǒng)架構(gòu)FLUKA 官方目前主要提供 64 位 Linux 版本理論上支持 Ubuntu 18.04 到 24.04 這些主流發(fā)行版實(shí)測(cè)下來 20.04 和 22.04 都得很順利。如果你用的是 24.04需要注意系統(tǒng)默認(rèn)的 Python 版本已經(jīng)是 3.12對(duì)后面裝 Flair 或關(guān)聯(lián)工具會(huì)有一些影響但不影響 FLUKA 核心程序運(yùn)行。首先確認(rèn)你的系統(tǒng)信息uname -m正常情況下輸出是x86_64。如果你是在 ARM 架構(gòu)的機(jī)器上裝 Ubuntu比如某些開發(fā)板或者 Apple Silicon 虛擬機(jī)里跑的 ARM Linux那么你需要去官方下載頁(yè)面確認(rèn)有沒有對(duì)應(yīng)的 ARM 架構(gòu)二進(jìn)制包。我個(gè)人的建議是能用 x86_64 就跑 x86_64不要自己折騰源碼交叉編譯FLUKA 的構(gòu)建體系對(duì)新手并不友好。接著確認(rèn)你的 Ubuntu 版本lsb_release -a1.2 一次性裝齊編譯器和基礎(chǔ)依賴FLUKA 本身雖然是預(yù)編譯好的二進(jìn)制但它外層的運(yùn)行腳本、配套工具和后續(xù)的幾何建模工具仍然依賴不少系統(tǒng)組件。我在第一次安裝時(shí)犯過一個(gè)低級(jí)錯(cuò)誤只等著下載官方包結(jié)果運(yùn)行腳本時(shí)報(bào)了一堆“找不到解釋器”“找不到命令”的錯(cuò)后來才發(fā)現(xiàn)原來 tcsh 和 gfortran 沒裝。執(zhí)行下面這組命令把常見依賴一口氣裝完sudo apt update sudo apt upgrade -y sudo apt install -y tcsh perl make gcc g gfortran python3 python3-pip python3-tk libxm4 libxpm-dev libxft-dev libxext-dev解釋一下這些包的作用tcshFLUKA 的rfluka啟動(dòng)腳本默認(rèn)依賴 C Shell 語(yǔ)法如果沒裝 tcsh會(huì)報(bào)/bin/sh: bad interpreter或者類似錯(cuò)誤。gfortran雖然官方二進(jìn)制不需要你自己編譯 Fortran但某些輔助工具和擴(kuò)展程序運(yùn)行時(shí)需要 Fortran 運(yùn)行時(shí)庫(kù)。libxpm-dev libxft-dev libxext-dev后面裝 Flair 或者某些圖形界面工具時(shí)會(huì)用到提前裝好省得再來一次。注意不要在這一步跳過tcsh。網(wǎng)上不少教程默認(rèn)你的系統(tǒng)已經(jīng)有 C Shell但 Ubuntu 默認(rèn)是沒有的。這個(gè)坑幾乎每個(gè)人都會(huì)踩一次。1.3 申請(qǐng) FLUKA 下載權(quán)限和版本選擇FLUKA 的下載機(jī)制和普通開源軟件不太一樣它需要通過官方渠道提交申請(qǐng)審核通過后會(huì)給你一個(gè)下載鏈接。整個(gè)注冊(cè)流程比較簡(jiǎn)單只需要提供工作郵箱和單位信息審核周期一般在一個(gè)工作日內(nèi)。我建議你直接去 FLUKA 官網(wǎng)提交下載請(qǐng)求拿到壓縮包后再回來繼續(xù)。不建議在第三方網(wǎng)盤或者論壇上找別人轉(zhuǎn)載的二進(jìn)制包一來無法確認(rèn)是否被篡改二來版本可能非常老舊缺少官方最近的修復(fù)和物理模型更新。FLUKA 目前主流版本是 4 系列你拿到的壓縮包可能是fluka-4-x.y.tar.gz這樣的命名解壓后具體版本號(hào)會(huì)有差異但安裝邏輯完全一樣。2. FLUKA 核心程序安裝從解壓到環(huán)境變量配置2.1 選擇安裝目錄并解壓官方壓縮包解壓后是一個(gè)獨(dú)立的目錄理論上放在任何位置都能運(yùn)行。但考慮到后面寫輸入文件、跑算例都會(huì)生成大量文件我的建議是單獨(dú)建一個(gè)軟件目錄不要直接扔在~/Downloads里避免誤刪或者路徑混亂。下面是我常用的目錄結(jié)構(gòu)mkdir -p ~/opt cd ~/opt tar -xzf ~/Downloads/fluka-4-x.y.tar.gz ls -l解壓后你會(huì)看到一個(gè)以版本號(hào)命名的目錄比如fluka-4-3.0。為了后續(xù)配置環(huán)境變量方便我習(xí)慣于把它重命名成簡(jiǎn)潔的FLUKAmv fluka-4-3.0 FLUKA2.2 配置 FLUPRO 環(huán)境變量FLUKA 運(yùn)行時(shí)會(huì)通過環(huán)境變量FLUPRO查找自己的主目錄、示例文件、編譯好的可執(zhí)行程序。也就是說FLUPRO必須指向你剛才解壓出來的那個(gè)目錄否則運(yùn)行腳本會(huì)一直報(bào)“找不到文件”。打開.bashrc文件vim ~/.bashrc在文件末尾追加export FLUPRO$HOME/opt/FLUKA export PATH$PATH:$FLUPRO/flutil:$FLUPRO/bin然后讓配置立刻生效source ~/.bashrc驗(yàn)證路徑是否設(shè)置正確echo $FLUPRO如果輸出/home/你的用戶名/opt/FLUKA就說明這一步已經(jīng)完成了。提示有些教程會(huì)讓你在/etc/profile或者/etc/environment里配置全局環(huán)境變量我建議不要這么做。一方面把個(gè)人軟件路徑放到系統(tǒng)級(jí)配置里會(huì)讓其他用戶也看到另一方面后續(xù)如果換版本、改目錄還要?jiǎng)酉到y(tǒng)文件非常不靈活。寫在用戶級(jí).bashrc里最合理。2.3 source 初始化腳本FLUKA 自帶一個(gè)初始化腳本通常在安裝目錄下的flutil/fluka-init或者類似位置。這個(gè)腳本會(huì)幫你把 PATH、LD_LIBRARY_PATH 等變量都整理好省得你自己一個(gè)個(gè)去 export。不同小版本之間這個(gè)腳本的名字可能略有差異以官網(wǎng)文檔為準(zhǔn)。我這里是常見版本的做法source $FLUPRO/flutil/fluka-init如果你希望以后每次打開終端都自動(dòng)加載可以把這行也寫入.bashrcecho source $FLUPRO/flutil/fluka-init ~/.bashrc不過要提醒一下如果你同時(shí)寫入了export FLUPRO和source fluka-init那么.bashrc中這兩行的順序不要弄反。必須先定義FLUPRO再執(zhí)行初始化腳本否則腳本里引用的$FLUPRO是空的。2.4 驗(yàn)證核心程序是否可用安裝完成的標(biāo)志是rfluka命令可以被系統(tǒng)找到。執(zhí)行which rfluka如果輸出類似~/opt/FLUKA/flutil/rfluka的路徑就說明命令已經(jīng)進(jìn)入 PATH接下來可以開始測(cè)試運(yùn)行了。3. Flair 圖形界面安裝與聯(lián)調(diào)讓復(fù)雜輸入文件不再勸退新手3.1 Flair 和 FLUKA 的關(guān)系FLUKA 核心程序本身是個(gè)命令行工具你輸入的是一份純文本的卡片文件.inp文件。但這套卡片語(yǔ)法比較繁瑣尤其是幾何定義部分稍不注意就寫錯(cuò)一個(gè)坐標(biāo)然后整個(gè)模型就廢了。Flair 是 FLUKA 官方配套的圖形界面工具可以幫你編輯輸入文件、檢查卡片格式、查看幾何結(jié)構(gòu)、提交計(jì)算任務(wù)并可視化結(jié)果。用一句不嚴(yán)謹(jǐn)?shù)美斫獾脑拋碚fFLUKA 是發(fā)動(dòng)機(jī)Flair 是儀表盤。發(fā)動(dòng)機(jī)不裝好儀表盤再漂亮也沒用但如果只是偶爾跑一兩個(gè)簡(jiǎn)單算例只裝核心程序也可以。我個(gè)人的建議是新手一開始就把 Flair 裝好因?yàn)樗膸缀晤A(yù)覽和卡片自動(dòng)補(bǔ)全功能能省掉大量低級(jí)錯(cuò)誤。3.2 Python 依賴和 Flair 安裝Flair 是用 Python 寫的所以需要先確認(rèn) Ubuntu 里 Python3 環(huán)境正常python3 --version接下來安裝 Python 包依賴。由于 Ubuntu 對(duì)系統(tǒng)級(jí) Python 環(huán)境做了權(quán)限管理我強(qiáng)烈建議用虛擬環(huán)境或者--user方式安裝不要直接用 sudo pip 往系統(tǒng)目錄里寫pip3 install --user numpy matplotlibFlair 本身可以從 FLUKA 官方下載頁(yè)面拿到對(duì)應(yīng)的發(fā)行包一般是一個(gè)壓縮包解壓后是一個(gè)放在哪都能運(yùn)行的目錄。官網(wǎng)經(jīng)常提供預(yù)打包版本優(yōu)先選擇預(yù)打包版本省去自己編譯依賴的麻煩。解壓后建議把 Flair 目錄也放進(jìn) PATHexport PATH$PATH:$HOME/opt/flair然后在終端里嘗試啟動(dòng)flair如果能彈出一個(gè)圖形窗口說明核心依賴沒有問題。3.3 在 Flair 中指定 FLUKA 路徑第一次打開 Flair 時(shí)它不一定能自動(dòng)找到 FLUKA 的根目錄。你需要在界面的設(shè)置項(xiàng)里手動(dòng)指定FLUPRO路徑和 FLUKA 版本號(hào)。具體操作路徑根據(jù)版本略有不同但一般都在“Settings”或者“Configuration”里。設(shè)置好后Flair 會(huì)讀取 FLUKA 自帶的物理模型數(shù)據(jù)這樣你才能在圖形界面中正確分析輸入卡片。如果你是在本地 Ubuntu 上安裝Flair 直接打開、直接改文件、直接提交作業(yè)就可以。真正需要留意的是遠(yuǎn)程服務(wù)器場(chǎng)景下面我會(huì)專門說一下。3.4 Ubuntu 24.04 的特殊處理Ubuntu 24.04 默認(rèn) Python 3.12 移除了distutils這本來不是什么大問題但某些版本的 Flair 依賴包在安裝時(shí)仍會(huì)對(duì)distutils做檢查導(dǎo)致安裝中斷。如果你遇到這類提示可以先裝一個(gè)兼容層sudo apt install -y python3-setuptools然后再重試 pip 安裝。這個(gè)坑在 20.04 和 22.04 上不會(huì)遇到但我在 24.04 上實(shí)測(cè)時(shí)就碰上了記錄下來提醒大家。4. 跑通第一個(gè)算例用官方示例驗(yàn)證安裝是否真正可用4.1 準(zhǔn)備一個(gè)運(yùn)行目錄FLUKA 運(yùn)行時(shí)會(huì)生成一堆中間文件包括輸入文件的拷貝、輸出文件、二進(jìn)制結(jié)果文件等。我強(qiáng)烈建議每個(gè)算例都單獨(dú)建一個(gè)工作目錄不要把運(yùn)行文件直接放在$FLUPRO下面否則時(shí)間一長(zhǎng)軟件目錄會(huì)被各種臨時(shí)文件搞得亂七八糟。mkdir -p ~/flukarun/test01 cd ~/flukarun/test014.2 復(fù)制并運(yùn)行官方示例FLUKA 壓縮包內(nèi)的examples目錄自帶多個(gè)示例輸入文件這些文件覆蓋了不同物理場(chǎng)景是驗(yàn)證安裝最可靠的選擇。你不需要自己從零寫輸入卡片因?yàn)槟欠炊赡芤驗(yàn)榭ㄆ袷絾栴}干擾你對(duì)“安裝是否成功”的判斷。ls $FLUPRO/examples/從列表里挑一個(gè)簡(jiǎn)單的.inp文件復(fù)制到工作目錄然后運(yùn)行cp $FLUPRO/examples/xxx.inp . rfluka xxx.inp其中xxx.inp是你選中的示例文件名字。FLUKA 默認(rèn)會(huì)讀取當(dāng)前目錄下所有需要的資源如果一切正常終端會(huì)刷出大量運(yùn)行日志。4.3 如何判斷運(yùn)行是否成功運(yùn)行結(jié)束后當(dāng)前目錄會(huì)出現(xiàn)多個(gè)文件最需要關(guān)注的是.out文件和.bnn文件。.out是標(biāo)準(zhǔn)輸出記錄了整個(gè)模擬過程的關(guān)鍵信息.bnn是二進(jìn)制結(jié)果文件后面用 Flair 查看劑量分布都要靠它。判斷是否成功最簡(jiǎn)單的辦法是看日志最后幾行tail -n 30 xxx001.out注意FLUKA 的輸出文件名會(huì)在輸入文件名后自動(dòng)追加三位數(shù)字類似xxx001.out。如果正常結(jié)束日志末尾通常會(huì)出現(xiàn)“Run terminated”或者類似的結(jié)束標(biāo)志如果中途崩潰日志會(huì)停在某個(gè)錯(cuò)誤信息附近并伴有大量的問號(hào)提示。4.4 多線程加速參數(shù)說明跑測(cè)試算例時(shí)默認(rèn)單線程就夠了但如果后續(xù)要跑實(shí)際物理模型建議利用多核 CPUrfluka -N 4 xxx.inp-N 4表示同時(shí)跑 4 個(gè)循環(huán)cycles一般取 CPU 核心數(shù)即可。需要注意的是FLUKA 的多線程機(jī)制是把不同循環(huán)分發(fā)給多個(gè)任務(wù)并行而不是像 OpenMP 那樣共享內(nèi)存并行。如果你的服務(wù)器有 16 個(gè)物理核心-N 16是可行的但如果你的機(jī)器本身還跑著其他任務(wù)建議留幾個(gè)核心給系統(tǒng)和其他進(jìn)程。5. 我踩過的坑FLUKA 安裝與運(yùn)行常見問題速查5.1 環(huán)境變量不生效每次都要重新 source癥狀終端里執(zhí)行rfluka提示command not found但明明剛才還能運(yùn)行。原因你把export FLUPRO寫在了一個(gè)臨時(shí)終端窗口里并沒有寫進(jìn).bashrc或者寫入后沒有重新加載。解決source ~/.bashrc如果仍然找不到命令檢查是否在.bashrc里寫了export FLUPRO之后再寫source $FLUPRO/flutil/fluka-init順序錯(cuò)誤會(huì)導(dǎo)致后面一行里的$FLUPRO是空的。5.2 運(yùn)行報(bào)錯(cuò)找不到 tcsh 或 bad interpreter癥狀rfluka一執(zhí)行就報(bào)錯(cuò)提示解釋器有問題。原因Ubuntu 默認(rèn)沒有安裝 tcsh而 FLUKA 的啟動(dòng)腳本引用了 C Shell 語(yǔ)法。解決回到上面第 1.2 節(jié)執(zhí)行sudo apt install -y tcsh這類問題不會(huì)在官方文檔里被反復(fù)強(qiáng)調(diào)因?yàn)閹缀跛锌茖W(xué)計(jì)算 Linux 環(huán)境都會(huì)預(yù)裝但普通的 Ubuntu 桌面版就是沒有。5.3 運(yùn)行中途報(bào)錯(cuò)找不到 gfortran 相關(guān)庫(kù)癥狀程序已經(jīng)在跑了但某個(gè)輔助模塊突然報(bào)錯(cuò)提示找不到libgfortran.so。原因使用了某些需要 Fortran 運(yùn)行時(shí)的輔助工具但系統(tǒng)沒裝 gfortran。解決sudo apt install -y gfortran裝完后再重跑一次即可。嚴(yán)格來說這不一定發(fā)生在安裝階段而是在后續(xù)編譯用戶自定義的輔助程序時(shí)更常見反正提前裝好不會(huì)有壞處。5.4 WSL 環(huán)境下 Flair 圖形界面打不開癥狀在 WSL 或者虛擬機(jī)里跑核心程序沒有問題但輸入flair后沒有圖形窗口彈出來。原因WSL 早期版本沒有內(nèi)置圖形界面支持需要 X Server 配合虛擬機(jī)則可能沒有正確安裝增強(qiáng)工具導(dǎo)致 OpenGL 相關(guān)功能異常。解決Windows 11 自帶 WSLg一般直接就能彈出窗口。如果是舊版 WSL可以在 Windows 側(cè)啟動(dòng) X Server然后在 WSL 里設(shè)置export DISPLAY:0。如果只是想快速驗(yàn)證安裝可以不依賴圖形界面直接用文本編輯器改寫.inp文件用命令行跑rfluka效果完全一樣。5.5 運(yùn)行目錄里出現(xiàn)大量臨時(shí)文件找不到主輸出癥狀跑完一個(gè)算例后目錄里全是.tmp、.dat、.out文件看得眼花繚亂。原因FLUKA 默認(rèn)在當(dāng)前目錄生成所有中間文件用戶沒有做目錄隔離。解決從一開始就養(yǎng)成“一個(gè)算例一個(gè)文件夾”的習(xí)慣每個(gè)文件都放在獨(dú)立的目錄里輸出文件名也保持和輸入文件名一致這樣后續(xù)整理數(shù)據(jù)和寫論文時(shí)都會(huì)省心很多。5.6 常見問題速查表癥狀可能原因處理方式command not found: rflukaPATH 未配置或未 source檢查.bashrc重新source ~/.bashrcbad interpreter缺少 tcshsudo apt install -y tcsh運(yùn)行中斷日志中有問號(hào)提示輸入卡片格式問題或數(shù)據(jù)路徑缺失用官方示例對(duì)比確認(rèn)所有文件路徑有效Flair 打不開顯示服務(wù)器或 Python 依賴問題WSLg/X Server 配置或重新安裝 Python 依賴libgfortran 相關(guān)錯(cuò)誤缺少 gfortran 運(yùn)行時(shí)sudo apt install -y gfortran找不到fluka-init版本不同腳本名可能不同查看解壓目錄內(nèi)文檔確認(rèn)腳本位置6. 幾點(diǎn)實(shí)用的安裝后配置建議6.1 關(guān)于源碼編譯能勸退就勸退FLUKA 官方提供的是預(yù)編譯二進(jìn)制包對(duì)絕大多數(shù)人來說完全夠用。但總有朋友出于“掌控感”想從源碼自己編譯結(jié)果一般都會(huì)陷入依賴泥潭需要特定版本的 gfortran、特定版本的 CMake、以及可能跟系統(tǒng)庫(kù)沖突的底層依賴。更有甚者FLUKA 某些底層代碼涉及大量編譯選項(xiàng)新手如果不知道如何開啟并行支持編譯出來的版本甚至可能比預(yù)編譯版本性能更低。所以我的結(jié)論是除非你是 FLUKA 內(nèi)部開發(fā)人員或者有明確的定制需求否則不要自己從源碼編譯。把時(shí)間花在物理模型學(xué)習(xí)和輸入卡片調(diào)試上收益大得多。6.2 建議保留一份干凈的模型計(jì)算目錄結(jié)構(gòu)我自己的習(xí)慣是這樣~/flukarun/ ├── case01/ │ ├── input.inp │ └── output/ ├── case02/ └── case03/每一個(gè) case 目錄放一個(gè)獨(dú)立的算例輸出文件和輸入文件分開管理。這樣不管過了多久回來看我都能一眼找到想要的模型文件。FLUKA 的中間文件命名是靠輸入文件名加序號(hào)來區(qū)分的如果你把所有算例堆在同一個(gè)目錄里過兩個(gè)月自己都分不清哪個(gè)是哪個(gè)了。6.3 簡(jiǎn)單但重要的備份習(xí)慣安裝完成后把整個(gè)~/opt/FLUKA目錄做一次備份也是非常推薦的。雖然正式建模時(shí)不需要頻繁重裝軟件但系統(tǒng)升級(jí)、硬盤更換、虛擬機(jī)遷移這些場(chǎng)景下有備份就能直接恢復(fù)不需要重新經(jīng)歷一次下載和申請(qǐng)流程。tar -czf fluka-backup.tar.gz ~/opt/FLUKA這一條看起來很簡(jiǎn)單但真的能省很多事。6.4 學(xué)會(huì)查看官方文檔FLUKA 安裝包自帶doc目錄里面有大量 PDF 手冊(cè)包括輸入卡片說明、安裝說明和示例解釋。很多時(shí)候你遇到的問題早就有官方說明只是很多人習(xí)慣直接搜索網(wǎng)上的零散答案反而忽略了最權(quán)威的來源。遇到報(bào)錯(cuò)時(shí)先翻一下$FLUPRO/doc目錄下的對(duì)應(yīng)手冊(cè)往往比在論壇里大海撈針高效得多?；氐轿业慕?jīng)驗(yàn)上來FLUKA 在 Ubuntu 下的安裝整體并不算難真正的分水嶺在于你是否理解環(huán)境變量和啟動(dòng)腳本之間的配合關(guān)系。只要把FLUPRO這個(gè)關(guān)鍵路徑配置準(zhǔn)確再確認(rèn) tcsh 和 gfortran 這類基礎(chǔ)依賴都在10 分鐘內(nèi)就能讓程序跑起來。裝完以后別急著丟開拿官方示例完整跑一次看看輸出文件的結(jié)束標(biāo)志這才是真正有效的驗(yàn)收。以后你換電腦、換系統(tǒng)、幫同事配置環(huán)境時(shí)回頭再看這一步會(huì)感謝自己當(dāng)初沒有跳過驗(yàn)證環(huán)節(jié)。