Ubuntu 20.04.6 实战：从零到一部署 Basilisk 流体模拟环境

1. 环境准备：打造纯净的Ubuntu工作台

刚拿到一台装好Ubuntu 20.04.6的电脑时，就像拿到毛坯房需要先做基础装修。我建议先执行系统更新，这个操作相当于给房子通水电。打开终端输入以下命令：

sudo apt update && sudo apt upgrade -y

这个组合命令我用了五年都没变过，先更新软件源列表再升级已安装的包。有个细节要注意：如果之前装过其他开发环境，最好用apt autoremove清理孤儿包，避免依赖冲突。有次我遇到奇怪的GLIBC版本问题，后来发现就是旧残留包导致的。

内存和存储方面，Basilisk编译时很吃资源。实测8GB内存的机器编译测试案例时会频繁触发OOM，建议准备16GB以上物理内存。如果只能用虚拟机，记得给Ubuntu分配至少4核CPU和12GB内存，交换空间设8GB以上。可以用free -h和df -h随时监控资源使用情况。

2. 依赖安装：搭建编译生态链

2.1 基础工具链配置

官方文档提到的工具其实分三类：编译工具、运行时依赖和可视化工具。我整理了个更完整的清单：

sudo apt install -y build-essential gfortran make gawk \ libopenmpi-dev libfftw3-dev libgsl-dev \ gnuplot imagemagick ffmpeg graphviz gifsicle \ valgrind pstoedit python3-dev

这里有个坑要注意：Ubuntu 20.04默认的imagemagick版本有安全限制，会导致Basilisk生成图片失败。需要修改策略文件：

sudo sed -i 's/<policy domain="coder" rights="none" pattern="PDF" \/>/<!-- & -->/' /etc/ImageMagick-6/policy.xml

2.2 源码管理工具

虽然官方推荐darcs，但我实测用git也能正常工作。如果团队在用git，可以这样操作：

sudo apt install -y git git clone https://gitlab.com/basilisk/basilisk.git

不过要注意git仓库的更新可能滞后于darcs主库。如果追求最新代码，还是建议安装darcs：

sudo apt install -y darcs darcs get http://basilisk.fr/basilisk

3. 源码编译：从代码到可执行文件

3.1 目录结构解析

Basilisk的代码结构很有特点，src目录下有几个关键文件：

• config.gcc：GCC编译配置模板
• Makefile：主构建脚本
• ppr/：预处理器的源代码

建议先建立软链接再编译：

cd basilisk/src ln -sf config.gcc config

这个config文件就像编译的"菜谱"，我习惯修改两个参数：

1. 把CFLAGS里的-O2改成-O3 -march=native充分优化
2. 加上-fopenmp支持多线程

3.2 并行编译技巧

直接make会单线程编译，在16核机器上要等半小时。改用：

make -j$(nproc)

如果遇到奇怪的编译错误，先试试make clean再重新编译。有次我遇到undefined reference错误，后来发现是并行编译时序问题导致的。

编译完成后别急着欢呼，记得跑测试验证：

cd ../tests make vortex ./vortex

应该能看到涡旋的动画输出，如果报错缺少库，可能是运行时路径没设置好。

4. 环境配置：让系统认识Basilisk

4.1 永久环境变量设置

很多教程只教了设置BASILISK路径，其实还需要设置动态库路径：

echo "export BASILISK=$(pwd)" >> ~/.bashrc echo 'export PATH=$PATH:$BASILISK' >> ~/.bashrc echo 'export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$BASILISK' >> ~/.bashrc

我更喜欢用~/.profile而不是.bashrc，因为.profile会对所有shell生效。不过要注意.profile需要注销重新登录才能生效。

4.2 验证安装成功

官方推荐的qcc --version检查太简单，我建议跑个完整案例：

cd $BASILISK/examples/atomisation make ./atomisation

这个雾化案例会输出多个时间步的图片，用ffmpeg可以合成动画：

ffmpeg -framerate 30 -i plot-*.png atomisation.mp4

如果看到液滴破碎的动画，说明整个环境工作正常。第一次运行时可能会提示缺少某些Python模块，用pip安装即可。

5. 常见问题排坑指南

5.1 依赖地狱解决方案

最头疼的就是各种依赖冲突。我总结了几种典型错误：

1. GLIBC版本问题：

   /lib/x86_64-linux-gnu/libm.so.6: version `GLIBC_2.29' not found

   这种只能升级系统或手动编译高版本glibc

2. OpenMPI冲突：

   MPI_Init_thread: Not enough threads available

   试试重新安装openmpi-bin

3. FFTW精度问题：

   undefined reference to `fftw_malloc'

   需要同时安装libfftw3-dev和libfftw3-double-dev

5.2 性能调优建议

Basilisk默认配置比较保守，我通常做这些调整：

1. 在config文件中启用AVX2指令集：

   CFLAGS += -mavx2 -mfma

2. 调整OpenMP线程数：

   export OMP_NUM_THREADS=8

3. 对于大内存机器，增加栈大小：

   ulimit -s unlimited

6. 进阶使用技巧

6.1 与Python生态集成

虽然Basilisk主要用C代码，但可以通过ctypes调用。我写了个简单的包装器：

import ctypes basilisk = ctypes.CDLL("$BASILISK/libbasilisk.so")

更高级的用法是结合Jupyter Notebook，实时可视化模拟结果。需要先安装：

pip install numpy matplotlib ipywidgets

然后在Notebook里用%matplotlib widget实现交互式绘图。

6.2 自定义物理模型

Basilisk的强大之处在于可以方便地添加新方程。比如要实现自定义的表面张力模型：

1. 在src/目录下新建mytension.h
2. 实现新的加速度项
3. 在案例的Makefile里添加：

   CFLAGS += -DMY_TENSION

我开发过非牛顿流体模块，整个过程就像搭积木一样组合现有算子。