(e) 点击Close关闭。
! 如果我们需要编译的Interpreted UDF不止一个,可以将UDFs写入单个C源文件,如all.c,然后以同样的方式进行编译连接就可以了。
7.3.2.2 Windows NT系统网络并行运算的目录结构
如果我们使用的是Windows NT系统的并行版FLUENT,就需要以特定的方式组织文件目录。3.2.1中的第一步必须以下面的步骤代替:
1. 在Fluent.Inc目录下建立一个名为udf的可写子目录。 2. 在目录udf下建立一个目录(例如,Fluent.Inc\%udf\\myudf),将C源文件拷入其中,如myudf目录下。如果多
位用户使用,可以再建立其它目录(如Fluent.Inc\%udf\\abcudf 或xyz)。
! 由于C源文件不在当前工作目录下,编译时需要输入文件路径。如:
\\\\
3. 如果已有case文件,应保证其在当前工作目录下。 7.3.2.3 调试Interpreted UDFs
如果编译有错,在相应窗口中会出现错误信息。如果因为屏幕翻动无法看清,则应该关闭Display Assembly Listing选项。
7.3.2.4 Interpreted UDFs常见编译错误
C源文件如果不是在当前工作目录下,而在编译时没有指明具体路径,就会出现下面的错误:
如果将case文件拷贝到了其他目录,而没有将C源文件一起拷过去,会出现同样的错误。 7.3.3 Compiled型UDFs
一般,我们按照下面的步骤编译连接Compiled型UDFs: 1. 在工作目录下建立相应的目录(见3.3.1); 2. 编译UDFs并建立共享库(见3.3.2); 3. 运行FLUENT;
4. 读取(或建立)case文件(case文件如果事先以存在,应保证在当前工作目录下); 5. 连接共享库到FLUENT执行(见3.3.3)。连接成功后,出现下面信息:
7.3.3.1 建立目录结构
UNIX和Windows NT系统所建目录结构是不一样的,下面分别进行说明。 UNIX系统
UNIX系统编译Compiled UDFs需要两个文件:Makefile和makefile。makefile文件是可修改的,C源文件名就在其中设定。两文件所处的相关目录为:
path/Fluent.Inc/fluent5.x/src/Makefile path/Fluent.Inc/fluent5.x/src/makefile
path为FLUENT安装目录,5.x表示FLUENT版本。
下面的步骤概括介绍了目录结构的建立过程,从图3.3.1可以看得更清楚。图3.3.1中的目录结构适用于两种版本:单精度2D运算和单精度2D并行运算。注意不需要向版本目录(2d,2d_host,2d_node)中拷入任何文件,图中所示文件在编译时会自动生成。
94
图3.3.1 UNIX目录结构说明
1. 在当前工作目录下建立一个目录用来存放库(如libudf)。
2. 拷贝Makefile.udf文件到1中建立的目录下,并重新命名为Makefile。
3. 在1中建立的目录(libudf)下,建立一个用于存放C源文件的目录,并命名为src。 4. 将C源文件(如udfexample.c)拷入src目录下。
5. 把makefile.udf文件拷入src目录下,并命名为makefile。
6. 启动FLUENT,确认FLUENT版本结构。如果是irix6.5,需要修改makefile文件(见3.3.2)。 7. 按照FLUENT版本结构建立相应的目录结构(如ultra/2d或ultra/3d等)。可能的版本有:
(a) 单精度2d或3d:2d或3d (b) 双精度2d或3d:2ddp或3ddp
(c) 单精度并行版2d或3d:2d_node和2d_host,3d_node和3d_host
(d) 双精度并行版2d或3d:2ddp_node和2ddp_host,3ddp_node和3ddp_host Windows NT系统
对于Windows NT系统需要两个文件:makefile_nt.udf和user_nt.udf。C源文件需要修改文件user_nt.udf指定。下面的步骤概括介绍了目录结构的建立过程,可参考图3.3.2。图3.3.2也只适用于两种版本:单精度2D运算和单精度2D并行运算。
图3.3.2 Windows NT目录结构说明
1. 在当前工作目录下建立一个目录(如libudf)。
2. 在新建目录下建立名为src目录,用于存放C源程序文件。 3. 将C源程序(如udfexample)拷贝入src目录。
4. 根据机器结构建立相应目录:Windows NT系统建立ntx86目录,DEC Alpha系统建立ntalpha目录。 5. 在ntx86目录或ntalpah目录下建立版本信息目录(如ntx86\\2d)。可能的FLUENT版本为:
(a) 单精度2d或3d:2d或3d (b) 双精度2d或3d:2ddp或3ddp
(c) 单精度并行版2d或3d:2d_node和2d_host,3d_node和3d_host
(d) 双精度并行版2d或3d:2ddp_node和2ddp_host,3ddp_node和3ddp_host 6. 将makefile_nt.udf和user_nt.udf拷入版本信息目录(如2d)。对于并行版本需要将这两个文件分别拷入host
95
和node目录(如2d_node和2d_host)。两文件在FLUENT中的位置: path/Fluent.Inc/fluent5.x/src/makefile_nt.udf
path/Fluent.Inc/fluent5.x/src/user_nt.udf
path为FLUENT安装目录。注意FLUENT版本更新升级后,需要把新版本的makefile_nt.udf和user_nt.udf拷入覆盖原来的文件,这和UNIX系统是不同的。 7. 把文件makefile_nt.udf重新命名为makefile。 7.3.3.2 编译建立共享库
对于UNIX和Windows NT系统编译和建立共享库的方式是不同的,下面分别叙述: UNIX系统
在建立相应的目录结构和拷入源文件之后,就可以编译生成共享库文件。 1. 编辑src目录下的makefile文件,并设置参数:
SOURCES = 要进行编译的C源文件名 FLUENT_INC = FLUENT安装路径 下面是个makefile文件的例子:
2. 如果版本结构是irix6.5,则需要进一步修改makefile文件。
(a) 在文件中找到下面部分:
CFLAGS_IRIX6R10 = -KPIC -ansi -fullwarn -0 -n32 (b) 将-ansi改为-xansi:
CFLAGS_IRIX6R10 = -KPIC -xansi -fullwarn -0 -n32 3. 在库目录(如libudf)下,输入下面的语句,执行Makefile。
Make “FLUENT_ARCH=ultra” 系统显示信息:
上述信息表明编译udfexample.c成功,同时系统会建立共享库libudf.so。
96
当然,我们可以同时编译多个C源程序文件。
Windows NT系统
在建立相应目录及拷入C源文件之后,Windows NT系统按照下面的步骤编译和建立共享库。 1. 编辑user_nt.udf文件,设置下面的参数:
SOURCES=要进行编译的C原文件名。在文件名之前,需要前缀$(SRC) (如$(SRC)udfexample.c),对于多个源文件,文件之间要以空格间隔(如 $(SRC) udfexample1.c $(SRC) udfexample2.c)。
VERSION=所使用解法器版本,如2d,3d,2ddp,3ddp等。 PARALLEL_NODE=并行运算通讯库,可能的情况有: -none:单机版
-smpi:并行使用共享内存(对多处理器机器)
-vmpi:使用MPI软件实现并行使用共享内存和网络 -net: 使用RSHD软件并行使用网络通讯
! 并行运算注意修改所有的user_nt.udf文件
下面是user_nt.udf参数设置的例子:
2. 在MS-DOS操作符下,进入到所建立目录(如\\libudf\\ntx86\\2d\\)下,执行命令nmake,如果编译出现问题使
用nmake clean 清除。
7.3.3.3 连接共享库到FLUENT
按上一节编译并建立共享库之后,就可以在FLUENT中,将共享库连接使用。具体步骤如下: 1. 运行FLUENT程序
2. 读取(或建立)case文件 3. 连接共享库到FLUENT
Define?User-Defined?Functions?Compiled…
图3.3.3 Compiled UDFs面板
(a) 在Library Name中输入存储库文件的目录名(如libudf),如果不在当前工作目录下,需要输入路径。 (b) 点击Open连接共享库到FLUENT。解法器会自动找到相应的版本的共享库,一旦连接成功,将会在case
文件中保存,下次读取case文件时会自动加载共享库。
7.3.3.4 编译连接Compiled UDFs时的常见错误
当共享库不在当前工作目录下的相应目录内时,或者取出case文件而与该case文件相关联的共享库已经移动时,会显示如下错误:
97
如果在新版本下读取旧版本的case文件,如在5.0.2中读取5.0.1版本的case文件,则会显示下面的错误:
第四节 在FLUENT模型中使用UDFS
在编译连接成功之后,我们就可以在FLUENT模型中使用UDFs。下面分别说明如何在FLUENT各模型中使用UDFs。 7.4.1 边界条件
编译连接成功边界条件UDF之后,就可以在FLUENT中选择使用。例如,定义速度入口边界条件的UDF(inlet_x_velocity)可以在Velocity Inlet面板(如下所示)中找到,选择之后点击OK按钮就可以在FLUENT中使用。
边界条件UDFs由宏DEFINE_PROFILE定义,参见2.5.6。 7.4.2 源项
源项UDFs在Fluid面板中选择,如名为cell_x_source的源项UDF。
源项UDFs由宏DEFINE_SOURCE定义,参见2.5.10。 7.4.3 物质性质
98