在Ubuntu 18.04上从零搭建FLEXPART 10.4：一份避开了所有坑的保姆级配置清单
在Ubuntu 18.04上从零搭建FLEXPART 10.4：一份避开了所有坑的保姆级配置清单
大气传输扩散模型FLEXPART是研究污染物长距离输送、核事故应急响应等场景的重要工具。但它的安装过程堪称"依赖地狱"——从GRIB数据处理库到NetCDF支持，每个环节都可能因为版本不匹配或系统环境差异而失败。本文将带你用一台纯净的Ubuntu 18.04系统，避开所有常见陷阱，完成FLEXPART 10.4的完整部署。
1. 环境准备：为什么必须是Ubuntu 18.04？
选择Ubuntu 18.04并非偶然。这个LTS版本的内核(4.15)和GCC编译器(7.5)恰好满足FLEXPART 10.4对Fortran 2003标准的完整支持。更关键的是，其软件源中的关键依赖包版本与FLEXPART所需完美匹配：
| 依赖项 | 必需版本 | Ubuntu 18.04源版本 |
|---|---|---|
| gfortran | ≥7.5 | 7.5.0-3ubuntu1 |
| libeccodes | 2.7.x | 2.7.3-1 |
| libnetcdf | 4.6.x | 4.6.0-2build1 |
重要提示：虚拟机请使用VMware或VirtualBox，WSL因缺少完整的systemd支持会导致grib_api编译失败。物理机安装时建议分配至少20GB磁盘空间。
系统初始化命令如下：
sudo apt update && sudo apt upgrade -y sudo apt install -y g++ gfortran autoconf libtool automake flex bison cmake \ python3-dev python3-pip git vim curl build-essential libbz2-dev \ libssl-dev libreadline-dev libsqlite3-dev tk-dev ruby2. 依赖库安装：顺序就是生命线
2.1 基础科学计算库
错误的安装顺序会导致后续编译时出现"undefined reference"错误。必须严格按照以下步骤：
Jasper图像库：先安装这个图像编解码器，它是GRIB数据处理的基础
wget http://www.ece.uvic.ca/~mdadams/jasper/software/jasper-1.900.1.zip unzip jasper-1.900.1.zip cd jasper-1.900.1 CFLAGS="-fPIC" ./configure --prefix=/usr/local/jasper make -j$(nproc) && sudo make installGRIB_API与ECCodes：这两个库存在替代关系，但FLEXPART 10.4需要同时使用
# 先安装旧版grib_api wget https://people.freebsd.org/~sunpoet/sunpoet/grib_api-1.28.0-Source.tar.gz tar xvzf grib_api-1.28.0-Source.tar.gz cd grib_api-1.28.0-Source ./configure --prefix=/usr/local/grib_api --with-jasper=/usr/local/jasper make && sudo make install # 再安装ECCodes wget https://confluence.ecmwf.int/download/attachments/45757960/eccodes-2.7.3-Source.tar.gz tar xvzf eccodes-2.7.3-Source.tar.gz cd eccodes-2.7.3-Source mkdir build && cd build cmake -DCMAKE_INSTALL_PREFIX=/usr/local/eccodes .. make && sudo make install
2.2 NetCDF支持配置
FLEXPART输出需要NetCDF格式支持，但Ubuntu源中的版本缺少HDF5高级特性支持，必须手动编译：
# 安装zlib和szip压缩库 wget ftp://ftp.unidata.ucar.edu/pub/netcdf/netcdf-4/zlib-1.2.8.tar.gz tar -xf zlib-1.2.8.tar.gz && cd zlib-1.2.8 ./configure --prefix=/usr/local && make && sudo make install # 编译HDF5时需启用HL接口 wget ftp://ftp.unidata.ucar.edu/pub/netcdf/netcdf-4/hdf5-1.8.13.tar.gz tar -xf hdf5-1.8.13.tar.gz && cd hdf5-1.8.13 ./configure --enable-shared --enable-hl --prefix=/usr/local/hdf5 make -j$(nproc) && sudo make install3. FLEXPART本体编译：关键参数解析
获取源代码后，需要特别注意makefile的修改：
wget https://www.flexpart.eu/downloads/66 -O flexpart_v10.4.tar.gz tar xvf flexpart_v10.4.tar.gz cd flexpart_v10.4/src修改makefile时重点关注以下参数：
ROOT_DIR = /usr/local：确保指向所有依赖库的安装前缀NCOPT = -DUSE_NCF -lnetcdff -lnetcdf：启用NetCDF输出支持FFLAGS中添加-fconvert=little-endian：匹配x86架构字节序
编译命令：
make ncf=yes O_LEV=3 export LD_LIBRARY_PATH=/usr/local/grib_api/lib:$LD_LIBRARY_PATH4. 验证与排错：常见问题解决方案
4.1 动态链接库问题
如果运行时出现libgrib_api.so not found错误，需要更新动态链接库缓存：
sudo ldconfig4.2 Python接口配置
flex_extract工具依赖Python环境，需确保以下包版本匹配：
pip3 install cdsapi ecmwf-api-client netcdf4 --upgrade python3 -c "import eccodes; print(eccodes.__version__)"4.3 测试用例运行
使用内置测试案例验证安装：
cd ../examples/emep_50km ./run_emep.sh成功运行后应看到类似输出：
FLEXPART V10.4 ... Simulation finished normally我在实际部署中发现，最容易出错的环节是ECCodes与grib_api的共存配置。当遇到GRIB解码失败时，可以尝试在编译FLEXPART时临时禁用其中一个库进行测试。另外，建议在.bashrc中添加以下环境变量避免权限问题：
export ECCODES_DEFINITION_PATH=/usr/local/eccodes/share/eccodes/definitions export GRIB_API_DEFINITION_PATH=/usr/local/grib_api/share/grib_api/definitions