18-第十八章-FLUENT用户自定义函数.pdf

第18章 用户自定义函数 用户自定义函数（User-Defined Function ，UDF ）亦称自定义函数，它允许对FLUENT 进行 个性化设置，这对充分发掘 FLUENT 在功能上的潜力意义深远。本章比较详细地介绍了在 FLUENT 中怎样写、编译和使用UDF ，并且还给出了有关UDF 的例子。 主要包括以下几个方面的内容： 18.1 概论 18.2 写用户自定义函数（UDF ） 18.3 解释、编译及连接用户自定义函数（UDF ） 18.4 用户自定义函数（UDF ）举例 18.1 概论 18.1.1 什么是用户自定义函数（UDF） 用户自定义函数（UDF ）是用户使用C 语言编写的函数，它可以被 FLUENT 求解器动态地 加载，从而增强 FLUENT 软件的现有功能。UDF 是使用 Fluent.Inc 提供的 DEFINE 宏定义的。 所定义的函数使用由 Fluent.Inc 提供的预定义宏和函数从 FLUENT 求解器中访问数据。每一个 UDF 都要在程序的开头包含 udf.h 文件（#include ”udf.h” ），使得在程序编译过程中，DEFINE 宏以及其它由 FLUENT 提供的宏和函数所定义的内容都能被引用。在 FLUENT 中，UDF 作为 解释的或编译的函数被执行。不论是 UDF 传送到求解器的值，还是被求解器返回到 UDF 的值， 都必须使用国际单位制。 UDF 的特征可以概括如下： （1）是用C 语言写成的。 （2 ）必须有一个关于udf.h 文件的包含声明。 （3 ）必须使用由Fluent.Inc 提供的 DEFINE 宏定义。 （4 ）使用由Fluent.Inc 提供的预定义宏和函数访问 FLUENT 求解器的数据。 （5 ）作为解释的或编译的函数被执行。 （6 ）计算中必须使用国际单位制。 在 FLUENT 中，UDF 可以执行各种不同任务。如果它们在 udf.h 文件中没有被定义为 void ， 那么它们可以返回一个值。如果它们没有返回一个值，它们还可以修改一个哑元，或修改一个 没有被作为哑元传递的变量，或者借助算例文件和数据文件执行输入输出任务。 概括说，UDF 能够完成下列任务： （1）返回一个值。 （2 ）修改一个哑元。 （3 ）返回一个值同时修改一个哑元。 （4 ）修改一个没被作为一个哑元进行传递的变量。 （5 ）从算例文件或数据文件中写入或读出信息。 UDF 可以使用 C 语言在任何文本编辑器中进行编辑，但是源文件只能以扩展名.c 保存。通 常源文件中只有一个 UDF 函数，但是也允许在一个文件中包含多个前后相连的 UDF 函数。源 文件在 FLUENT 中既可以被解释也可以被编译。对于解释型的 UDF ，源文件（例如， pressure-profile.c ）将直接被加载和解释。而对于编译型的UDF ，则首先要建立一个共享的目标 模块库，然后再把它加载到 FLUENT 中。一旦解释或编译了 UDF ，相应的 UDF 名字将会在 FLUENT 的图形界面中出现，并且在相应的面板中通过选择这个函数将其连接到一个求解器中。 18.1.2 使用UDF 的原因 UDF 允许对 FLUENT 进行特殊设置以便满足建模的特殊需要。UDF 可以用于各种实际应 用，其中包括： （1）重新设置边界条件、材料特性、表面和体积反应速率、FLUENT 输运方程中的源项， 自定义标量（UDS ）输运方程中的源项和扩散函数等等。 （2 ）在每次迭代计算后调整计算结果。 （3 ）解的初始化。 （4 ）根据计算要求，非同步执行UDF 。 （5 ）加强后处理过程。 （6 ）加强 FLUENT 中现有的物理模型（例如，离散相模型、多相混合物模型、离散点辐 射模型）。 18.1.3 UDF 的局限性 在 FLUENT 中，虽然UDF 的性能涉及到非常广的应用范围，但UDF 不可能适用于每一个 应用。毕竟不是所有的解变量或物理模型都可以被 UDF 访问。比如，比热值不能被修改，若要 修改，则