操作系统选择

由于 OpenFOAM 在 Linux 平台开发和测试,在非 Linux 平台无法直接对软件进行编译和安装,所以在非 Linux 平台上最简便方法是使用 docker 容器运行 OpenFOAM。下面主要介绍在 Linux 平台上 OpenFOAM 源程序编译安装过程。

环境变量

在 OpenFOAM 编译和运行时,需要设置多个环境变量。在源程序路径 ${FOAM_DIR}/etc 下,脚本文件 bashrc 包含了软件编译和运行所需的所有环境变量的设置,可以直接通过 source 命令加载。

为什么要用 source 命令?

在 OpenFOAM 中,bashrc 其实是一个 shell 脚本,这个脚本里定义了所需的环境变量。在 Linux 环境中,执行 shell 脚本有多种形式。以 bash 脚本为例,首先可以通过新开启一个 shell 并在新的环境中运行脚本,这种方式可以用 bash 命令执行此脚本,或者在脚本第一行添加 #!/bin/bash 说明执行脚本的程序,随后添加执行权限后直接执行此脚本。

$ bash ${FOAM_DIR}/etc/bashrc # bash 命令执行
$ ${FOAM_DIR}/etc/bashrc # 直接执行

这两种方法执行效果是相同的,当新的 shell 运行脚本完毕后再返回当前环境,此时当前 shell 的工作环境是未变的,也就是说执行完毕后是无法看到 bashrc 脚本内定义的环境变量。

另外一种方式就是在当前 shell 环境中执行此脚本,这时在脚本名前使用 . 或者 source 命令,如下所示。

$ . ${FOAM_DIR}/etc/bashrc # 使用 . 执行
$ source ${FOAM_DIR}/etc/bashrc # 使用 source 命令执行

此时脚本内定义的变量或所做的修改都会直接添加到当前 shell 环境内,这种方式才是正确加载 OpenFOAM 环境变量方法。

bashrc 脚本中定义了多个变量,按照编译、运行和第三方函数库相关可以分为三类。

  1. 与编译相关的 WM_XXX 变量
WM_THIRD_PARTY_DIR=$HOME/OpenFOAM/ThirdParty-1.6.x # 第三方函数库路径
WM_PROJECT_INST_DIR=$HOME/OpenFOAM
WM_PROJECT_DIR=$HOME/OpenFOAM/OpenFOAM-1.6.x # 源程序路径
WM_DIR=$HOME/OpenFOAM/OpenFOAM-1.6.x/wmake #
WM_PROJECT_USER_DIR=$HOME/OpenFOAM/$USER-1.6.x # 用户路径 WM_PRECISION_OPTION=DP # 精度设置
WM_ARCH_OPTION=64 #
WM_LINK_LANGUAGE=c++ # 链接器
WM_ARCH=linux64 # 平台架构
WM_CXXFLAGS=-m64 -fPIC # c++ 编译器参数
WM_CFLAGS=-m64 -fPIC # c 编译器参数
WM_PROJECT_VERSION=1.6.x # 版本
WM_COMPILER_LIB_ARCH=64 #
WM_CXX=g++ # c++ 编译器
WM_COMPILER_ARCH=
WM_PROJECT=OpenFOAM # 工程名
WM_LDFLAGS=-m64 # 链接器参数
WM_COMPILER=Gcc # 编译器
WM_MPLIB=OPENMPI # MPI 函数库
WM_CC=gcc # C 编译器
WM_COMPILE_OPTION=Opt # 编译选项
WM_OPTIONS=linux64GccDPOpt # 编译设置
  1. 与运行相关的 FOAM_XXX 变量
FOAM_SOLVERS=$HOME/OpenFOAM/OpenFOAM-1.6.x/applications/solvers
FOAM_APPBIN=$HOME/OpenFOAM/OpenFOAM-1.6.x/applications/bin/linux64GccDPOpt
FOAM_TUTORIALS=$HOME/OpenFOAM/OpenFOAM-1.6.x/tutorials
FOAM_JOB_DIR=$HOME/OpenFOAM/jobControl
FOAM_LIB=$HOME/OpenFOAM/OpenFOAM-1.6.x/lib
FOAM_SITE_APPBIN=$HOME/OpenFOAM/site/1.6.x/bin/linux64GccDPOpt
FOAM_MPI_LIBBIN=$HOME/OpenFOAM/OpenFOAM-1.6.x/lib/linux64GccDPOpt/openmpi-1.3.3
FOAM_APP=$HOME/OpenFOAM/OpenFOAM-1.6.x/applications
FOAM_SITE_LIBBIN=$HOME/OpenFOAM/site/1.6.x/lib/linux64GccDPOpt
FOAM_SRC=$HOME/OpenFOAM/OpenFOAM-1.6.x/src
FOAM_SIGFPE=
FOAM_UTILITIES=$HOME/OpenFOAM/OpenFOAM-1.6.x/applications/utilities
FOAM_USER_LIBBIN=$WM_PROJECT_USER_DIR/lib/linux64GccDPOpt
FOAM_INST_DIR=$HOME/OpenFOAM
FOAM_LIBBIN=$HOME/OpenFOAM/OpenFOAM-1.6.x/lib/linux64GccDPOpt
FOAM_RUN=$WM_PROJECT_USER_DIR/run
FOAM_USER_APPBIN=$WM_PROJECT_USER_DIR/applications/bin/linux64GccDPOpt
  1. 第三方库相关变量
MPI_ARCH_PATH=$HOME/OpenFOAM/ThirdParty-1.6.x/openmpi-1.3.3/platforms/linux64GccDPOpt
ParaView_INST_DIR=$HOME/OpenFOAM/ThirdParty-1.6.x/paraview-3.6.1
OPAL_PREFIX=$HOME/OpenFOAM/ThirdParty-1.6.x/openmpi-1.3.3/platforms/linux64GccDPOpt
ParaView_DIR=$HOME/OpenFOAM/ThirdParty-1.6.x/paraview-3.6.1/platforms/linux64Gcc
PARAVIEW_DIR=/opt/packages/Paraview3
ParaView_VERSION=3.6.1
MPI_HOME=$HOME/OpenFOAM/ThirdParty-1.6.x/openmpi-1.3.3

在正确设置上述环境变量后,即可对 OpenFOAM 源程序进行编译,并运行对应的求解器和工具。

编译系统

在大型程序编译与安装过程中,通常使用 make 和 cmake 等工具构建。在 OpenFOAM 中,使用的是 wmake 脚本进行编译,所在位置为 ${FOAM_DIR}/wmake/wmake

查看此脚本可以发现,其编译是基于 make 修改,但是提供了针对 OpenFOAM 不同模块更灵活的特性,具体可参考网站[1]

wmake 编译

在 Linux 平台编译软件时,通常需要给定一些编译和优化参数。在使用 wmake 编译时,编译脚本会则根据环境变量会加载对应的参数设置脚本进行编译。

在 OpenFOAM 中,编译参数设置文件所在路径为 ${FOAM_DIR}/wmake/rules/<Rules>,其中 <Rules> 成为编译规则,与环境变量中定义的编译平台、架构、编译器设置有关。

编译规则的定义在脚本 ${FOAM_DIR}/wmake/rules/General/general 中,查看脚本最后几行

$ tail -n 20 ${FOAM_DIR}/wmake/rules/General/general
COMPILER_TYPE = $(shell echo $(WM_COMPILER) | tr -d [:digit:])
DEFAULT_RULES = $(WM_DIR)/rules/$(WM_ARCH)$(COMPILER_TYPE)
RULES = $(WM_DIR)/rules/$(WM_ARCH)$(WM_COMPILER)
WMAKE_BIN = $(WM_DIR)/platforms/$(WM_ARCH)$(WM_COMPILER) ...... include $(DEFAULT_RULES)/general
include $(DEFAULT_RULES)/c++
sinclude $(RULES)/general
sinclude $(RULES)/c++
include $(GENERAL_RULES)/transform

其中 DEFAULT_RULESRULES 为定义的两个编译规则变量,可以看出编译规则名称由平台 $(WM_ARCH) 和编译器 $(WM_COMPILER) 组成。

DEFAULT_RULESRULES 变量的区别主要在于,前者中删除了 WM_COMPILER 中包含的所有数字,而默认加载的是 DEFAULT_RULES 路径下编译设置文件。

为了保证在定义规则时能够添加数字,可以修改 DEFAULT_RULES,使其与 RULES 定义完全相同。

在加载脚本指令中,#sinclude 为 OpenFOAM 自定义的宏指令。与 #include 主要区别在于,当加载文件不存在时不会报错并退出[2]

当使用某个编译规则编译完成后,生成中间文件 *.o 的路径为 ${FOAM}/build/$(DEFAULT_RULES),而可执行程序的路径为 ${FOAM}/platforam/<makeRule>

这些路径的定义都包含在了环境配置文件 ${FOAM}/etc/bashrc 中 ,并且还将可执行程序路径自动添加到 PATH 变量内,从而可以直接运行 OpenFOAM 工具和求解器。

由于 wmake 是基于 make 命令实现的,因此其也具有自动推导功能。当对某个特定源程序文件进行修改后,wmake 只会重新编译包含与此文件相关的模块。

wmake 使用

1. 编译文件结构

在使用 make 编译源程序时,需要在 makefile 中指定编译指令,并提供引用的头文件和动态链接库位置。当使用 wmake 脚本时,则仅按照一定规则配置说明文件即可。

在 OpenFOAM 每个模块内,源程序文件后缀为 .C,头文件后缀为 .H。为了提供编译所需的信息,在文件夹内必须同时包含 Make 文件夹,内含 files 和 options 两个设置文件。以 icoFoam 求解器为例,其编译文件结构为

icoFoam
├── createFields.H
├── icoFoam.C
└── Make
├── files
└── options

files 文件内,包含了进行编译程序全路径和名字(EXE 变量)。关于安装路径可以提供两种形式,一个是标准路径,编译好的求解器储存在 $FOAM_APPBIN,也可以保存在用户自己的路径 $FOAM_USER_APPBIN 中。在 icoFoam 求解器中,配置文件files 内容如下所示,其中 EXE 变量说明了需编译生成可执行程序,当目标为动态链接库时使用 LIB 变量。

$ cat icoFoam/Make/files
icoFoam.C EXE = $(FOAM_APPBIN)/icoFoam

options 文件内指定了模块需要连接的头文件和链接库,其中头文件使用 EXE_INC-I 关键字进行指定,而连接库则需要用 EXE_LIBS-L/-l 等指定。在 icoFoam 求解器中 options 文件的内容为

$ cat icoFoam/Make/options
EXE_INC = \
-I$(LIB_SRC)/finiteVolume/lnInclude \
-I$(LIB_SRC)/meshTools/lnInclude EXE_LIBS = \
-lfiniteVolume \
-lmeshTools

2. 模块编译

在 OpenFOAM 中,对特定模块编译时,需要进入模块上一层目录下,使用 wmake + <模块名> 进行编译。在 wmake 命令运行时,可以通过增加 -j 参数可以启用并行编译指令。当需要对 OpenFOAM 全部代码进行编译时,可以直接运行源程序目录下 Allwmake 脚本。

当需要删除特定求解器和动态库时运行 wclean 命令,若需将全部求解器和动态库,加 -all 参数。

自定义编译规则:Intel-2019

在本节中,将定义一个新的编译规则,设置采用 intel 2019.5.281 版本编译器和 MPI 函数库进行编译,并对编译设置文件进行相应修改。

为了在编译后,能够通过加载单独的 bashrc 脚本来使用不同的 OpenFOAM 可执行程序,可以复制一份 bashrc 文件的拷贝 bashrc-intel-19,并在此文件中修改 WM_COMPILER=Intel-19。此时自定义编译规则名为 linux64Intel-19

在使用默认参数对 OpenFOAM 编译后,生成可执行程序使用的是 SSE 指令集。随着新一代 CPU 开始提供浮点性能更高的 AVX 系列指令集,可以通过修改编译参数,使求解器使用 AVX 指令集。

这时,需要在新的编译配置文件中进行修改。为此,复制目录 ${FOAM_DIR}/wmake/rules/linux64Icc,并将目录名称修改为 ${FOAM_DIR}/wmake/rules/linux64Intel-19 作为编译规则配置文件。

在此目录下 cc++ 两个文件包含了编译器的基本设置,在OptDebugProf等后缀的对应文件内,定义了不同优化设置 WM_COMPILE_OPTION 时使用的参数。

为使用 Intel 2019.5.281 版本编译器,可以修改 cc++ 文件中 CC 变量的值为 icc 和 icpc。为了省去在编译时指定对应的 MPI 头文件和动态链接库的位置,也可以直接用 mpiicc 和 mpiicpc 分别作为 C/C++ 程序编译器。

在对第三方函数库进行编译时,使用的编译器由 WM_CCWM_CXX 变量提供,因此还需要在配置文件 bashrc-intel-19 中,添加这两个变量的定义。

$ echo 'export WM_CC=icc' >> ${FOAM_DIR}/etc/bashrc-intel-19
$ echo 'export WM_CC=icpc' >> ${FOAM_DIR}/etc/bashrc-intel-19

设置完毕后,加载新的环境配置文件 ${FOAM_DIR}/etc/bashrc-intel-19,再运行Allwmake 脚本,即可生成按照自定义规则编译的二进制程序。


  1. https://cfd.direct/openfoam/user-guide/v7-compiling-applications/

  2. https://www.openfoam.com/documentation/guides/latest/api/classFoam_1_1functionEntries_1_1sincludeEntry.html

深入理解 OpenFOAM 环境变量与编译的更多相关文章

  1. Nodejs第一天-{Nodejs基础 深刻理解浏览器 环境变量 基础语法}

    Nodejs第一天 1.什么是Nodejs ​ Nodejs是一个可以运行(解析)ECMAScript的环境; ​ ECMAScript是规定了一些列的语法 ,这些语法想要解析的执行就需要放在某个环境 ...

  2. window环境变量

    首先Window中有很多乱七八糟的路径变量之类的,归类下来有几类,主要是为了我们分清楚概念,以免搞的糊涂了. 1. Window系统的环境变量:顾名思义,就是系统级别的变量,或者利用我们编程的角度来讲 ...

  3. 一文彻底搞懂Java中的环境变量

    一文搞懂Java环境变量 记得刚接触Java,第一件事就是配环境变量,作为一个初学者,只知道环境变量怎样配,在加上各种IDE使我们能方便的开发,而忽略了其本质的东西,只知其然不知其所以然,随着不断的深 ...

  4. 【转】windows7 修改环境变量 和 用不用重启电脑的讨论

      原文:http://www.cnblogs.com/zhenmingliu/archive/2013/02/21/2921396.html   先到我的电脑>属性>高级>环境变量 ...

  5. GCC相关的环境变量

    介绍GCC在编译阶段和程序运行阶段用到的环境变量. GCC编译时用到的环境变量 GCC编译时用到的变量. C_INCLUDE_PATH GCC编译时查找头文件的目录列表.比如: echo $C_INC ...

  6. Shell 全局变量、环境变量和局部变量

    Shell 变量的作用域(Scope),就是 Shell 变量的有效范围(可以使用的范围). 在不同的作用域中,同名的变量不会相互干涉,就好像 A 班有个叫小明的同学,B 班也有个叫小明的同学,虽然他 ...

  7. 延迟环境变量扩展(bat)

    延迟环境变量扩展(bat) 之前遇到一些环境变量的问题,简单记录下 From:http://www.cnblogs.com/dongzhiquan/archive/2012/09/05/2671218 ...

  8. Linux学习总结(十)-文件复制及查看, 环境变量

    一 文件复制及移动 1.命令 cp --------copy 的意思格式 cp 选项 源文件 目标文件a: 对于文件我们直接cp 文件 目标文件假定我们在普通用户家目录下/home/lv新建两个普通文 ...

  9. [小记]Windows下配置环境变量和需不需要重启问题

    经常看到一些软件的安装说明上写着,修改Windows的环境变量,然后重新启动计算机.这让人不禁产生疑问,修改环境变量之后真的要重启吗? 其实只要理解了环境变量的原理就可以做出正确的判断.环境变量是一些 ...

随机推荐

  1. 【数据结构与算法Python版学习笔记】基本数据结构——列表 List,链表实现

    无序表链表 定义 一种数据项按照相对位置存放的数据集 抽象数据类型无序列表 UnorderedList 方法 list() 创建一个新的空列表.它不需要参数,而返回一个空列表. add(item) 将 ...

  2. MySQL:基础语法-4

    MySQL:基础语法-4 记录一下 MySQL 基础的一些语法,便于查询,该部分内容主要是参考:bilibili 上 黑马程序员 的课程而做的笔记,由于时间有点久了,课程地址忘记了 上文MySQL:基 ...

  3. Spring Cloud Alibaba 使用Nacos作为服务注册中心

    为什么需要注册中心? 在分布式架构中,服务会注册到这里,当服务需要调用其它服务时,就到这里找到服务的地址,进行调用:服务管理,核心是有个服务注册表,心跳机制动态维护 : 服务注册 创建普通Spring ...

  4. 2021.9.21考试总结[NOIP模拟58]

    T1 lesson5! 开始以为是个无向图,直接不懂,跳去T2了. 之后有看了一眼发现可暴力,于是有了\(80pts\). 发现这个图是有拓扑序的,于是可以用拓扑排序找最长路径.先找原图内在最长路径上 ...

  5. STM32 学习笔记之中断应用概览--以f103为例

    异常类型 F103 在内核水平上搭载了一个异常响应系统, 支持为数众多的系统异常和外部中断.其中系统异常有8 个(如果把Reset 和HardFault 也算上的话就是10 个),外部中断有60个.除 ...

  6. xUtils3的使用教程

    首先在build.gradle下的dependencies下添加引用. implementation 'org.xutils:xutils:3.3.36' 然后创建一个表实体. package com ...

  7. MySQL实战优化之InnoDB整体架构

    一.InnoDB 更新数据得整体架构 每个组件的作用说明: 用一条更新数据来说明每个主键得作用: update student set name = 'zhangsan' where id = 10 ...

  8. GPS与AGPS定位服务

    最近客户反馈车子启动从车库开到地面后,机器定位相对OBD内部定位会慢很多. 机器定位主要依赖定位模块 + AGPS辅助定位. 其中定位模块目前主流支持的有以下三种定位系统. 一.GPS(全球定位系统) ...

  9. Python matplotlib pylot和pylab的区别

    matplotlib是Python中强大的绘图库. matplotlib下pyplot和pylab均可以绘图. 具体来说两者的区别 pyplot 方便快速绘制matplotlib通过pyplot模块提 ...

  10. 加法运算替代 牛客网 程序员面试金典 C++ Python

    加法运算替代 牛客网 程序员面试金典 题目描述 请编写一个方法,实现整数的乘法.减法和除法运算(这里的除指整除).只允许使用加号. 给定两个正整数int a,int b,同时给定一个int type代 ...