6.1.7 Hooking DEFINE_RW_FILE UDFs

After you have interpreted (Chapter  4) or compiled (Chapter  5) your DEFINE_RW_FILE UDF, it is ready to be hooked to ANSYS FLUENT. Note that you can hook multiple read/write file UDFs to your model, if desired.

To hook the UDF to ANSYS FLUENT, open the User-Defined Function Hooks dialog box. (Figure  6.1.11)

Define $\rightarrow$ User-Defined $\rightarrow$ Function Hooks...

Figure 6.1.11: The User-Defined Function Hooks Dialog Box

You have the choice of hooking a UDF to read and write a case and data file. Below is a description of what each function does.

• Read Case is called when you read a case file into ANSYS FLUENT. It will specify the customized section that is to be read from the case file.

• Write Case is called when you write a case file from ANSYS FLUENT. It will specify the customized section that is to be written to the case file.

• Read Data is called when you read a data file into ANSYS FLUENT. It will specify the customized section that is to be read from the data file.

• Write Data is called when you write a data file from ANSYS FLUENT. It will specify the customized section that is to be written to the data file.

To hook a read case file UDF, for example, click the Edit... button next to Read Case to open the Read Case Functions dialog box (Figure  6.1.12).

Figure 6.1.12: The Read Case Functions Dialog Box

Select the function(s) you wish to hook to your model from the Available Read Case Functions list. Click Add and then OK to close the dialog box. The name of the function you selected will be displayed in the Read Case field of the User-Defined Function Hooks dialog box. If you select more than one function, the number will be displayed (e.g., 2 selected). Click OK in the User-Defined Function Hooks dialog box to apply the settings.

See Section  2.2.10 for details about defining DEFINE_RW_FILE functions.