Fluent UDF 第三章 编写UDF.pdf

第 3 章 编写 UDF 第 3 章 编写 UDF 本章包含了 FLUENT 中如何写UDFs 的概述。 3.1 概述 3.2 写解释式 UDFs 的限制 3.3 FLUENT 中UDFs 求解过程的顺序 3.4 FLUENT 网格拓扑 3.5 FLUENT 数据类型 3.6 使用 DEFINE Macros 定义你的 UDF 3.7 在你的 UDF 源文件中包含 udf.h 文件 3.8 定义你的函数中的变量 3.9 函数体 3.10 UDF 任务 3.11 为多相流应用写 UDFs 3.12 在并行中使用你的 UDF 3.1 概述（Introduction ） 在你开始编写将挂到 FLUENT 代码以增强其标准特征的 UDF 之前，你必须 知道几个基本的要求。首先，UDFs 必须用 C 语言编写。它们必须使用 FLUENT 提供的 DEFINE macros 来定义。UDFs 必须含有包含于源代码开始指示的 udf.h 文件；它允许为 DEFINE macros 和包含在编译过程的其它 FLUENT 提供的函数 定义。UDFs 只使用预先确定的宏和函数从 FLUENT 求解器访问数据。通过 UDF 传递到求解器的任何值或从求解器返回到 UDF 的，都指定为国际（SI ）单位。 总之，当写 UDF 时，你必须记住下面的FLUENT 要求。 UDFs ： 1. 采用 C 语言编写。 2. 必须为 udf.h 文件有一个包含声明。 3. 使用 Fluent.Inc 提供的 DEFINE macros 来定义。 4. 使用 Fluent.Inc 提供的预定义宏和函数来访问 FLUENT 求解器数据。 5. 必须使返回到 FLUENT 求解器的所有值指定为国际单位。 3.2 写解释式 UDFs 的限制（Restriction on Writing Interpreted UDFs ） 第 3 章 编写 UDF 无论 UDFs 在 FLUENT 中以解释还是编译方式执行，用户定义C 函数（说明在 Section 3.1 中）的基本要求是相同的，但还是有一些影响解释式UDFs 的重大编 程限制。FLUENT 解释程序不支持所有的 C 语言编程原理。解释式 UDFs 不能 包含以下 C 语言编程原理的任何一个： 1. goto 语句。 2. 非 ANSI-C 原型语法 3. 直接的数据结构查询（direct data structure references ） 4. 局部结构的声明 5. 联合(unions) 6. 指向函数的指针（pointers to functions ） 7. 函数数组。 在访问 FLUENT 求解器数据的方式上解释式 UDFs 也有限制。解释式 UDFs 不能 直接访问存储在 FLUENT 结构中的数据。它们只能通过使用 Fluent 提供的宏间 接地访问这些数据。另一方面，编译式 UDFs 没有任何 C 编程语言或其它注意的 求解器数据结构的限制。 3.3 FLUENT 求解过程中UDFs 的先后顺序（Sequencing of UDFs in the FLUENT Solution Process ） 当你开始写UDF 代码的过程时（依赖于你写的 UDF 的类型），理解FLUENT 求 解过程中 UDFs 调用的内容或许是重要的。求解器中包含连接你写的用户定义函 数的 call-outs 。知道FLUENT 求解过程中迭代之内函数调用的先后顺序能帮助你 在给定的任意时间内确定那些数据是当前的和有效的。 分离式求解器 在分离式求解器求解过程中（Figure 3.3.1 ），用户定义的初始化函数（使用 DEFINE_INIT 定义的）在迭代循环开始之前执行。然后迭代循环开始执行用户 定义的调整函数（使用 DEFINE_ADJUST 定义的）。接着，求解守恒方程，顺序 是从动量方程和后来的压力修正方程到与特定计算相关的附加标量方程。守恒方 程之后，属性被更新（包含用户定义属性）。这样，如果你的模型涉及到气体定 律，这时，密度将随更新的温度（和压力 and/or 物质质量分数）而被更新。进 行收敛或者附加要求的迭代的检查，循环或者继续或停止。 第 3 章 编写 UDF