ANSYS Fluent 19.0 UDF入门指南

需积分: 10 109 浏览量更新于2024-07-15 收藏 16.43MB PDF 举报

"ANSYS Fluent作为服务器用户指南.pdf" 这篇文档是ANSYS官方提供的UDF（User Defined Functions）手册，适用于ANSYS 19.0版本。UDF是用户自定义函数，允许用户通过编程来扩展ANSYS Fluent的功能，以满足特定的计算需求。这份指南详细介绍了如何使用ANSYS Fluent进行定制化，包括各种宏的用法和实例，对初学者来说是一份非常有价值的入门资料。在ANSYS Fluent中，UDF主要应用于以下领域： 1. **流体动力学模型扩展**：通过编写UDF，用户可以实现非标准的物理模型，例如新的湍流模型、化学反应模型、多相流模型等，以适应特定的工程问题。 2. **边界条件处理**：UDF可以创建自定义的边界条件，如复杂的速度分布、压力分布或热流率分布，以更精确地模拟实际工况。 3. **后处理定制**：利用UDF，用户可以开发自己的后处理工具，生成特定的输出变量，用于分析和可视化结果。 4. **求解器优化**：UDF可用来调整求解策略，如迭代次数、时间步长控制等，以提高计算效率和精度。 5. **多物理场交互**：在多物理场模拟中，UDF能够帮助定义新的耦合关系，比如流固耦合、热电耦合等。 6. **用户自定义输出**：通过UDF，用户可以定义额外的输出量，以便于监控和分析计算过程中的关键参数。手册中会详细介绍UDF的编写语言C和Fortran的基础知识，以及如何将UDF集成到ANSYS Fluent中。此外，它还提供了一些实际案例，这些案例有助于读者理解UDF的编写和应用过程，帮助用户逐步掌握UDF的使用技巧。需要注意的是，由于ANSYS软件产品包含商业秘密和专有技术，未经授权的使用、分发或复制是被禁止的。同时，ANSYS、Fluent、Workbench等都是ANSYS公司的注册商标，其他品牌、产品和服务名称可能是各自所有者的商标。这份指南是学习和使用ANSYS Fluent UDF的重要参考资料，无论是对研究人员还是工程师，都能从中获取丰富的知识和实践经验。

3.3.8. Overset Mesh Looping Macros ........................................................................................ 307

3.3.8.1. Looping Over Overset Interface Cell Threads (thread_loop_overset_c) ......... 307

3.3.8.2. Looping Over Active Overset Cells in a Cell Thread (begin...end_c_loop_active,

begin…end_c_loop_solve) ....................................................................................... 307

3.3.8.2.1. Example 1 ..................................................................................................... 308

3.3.8.2.2. Example 2 ..................................................................................................... 308

3.3.8.3. Looping Over Faces in a Face Thread with Overset Mesh (be-

gin...end_f_loop_active) ..................................................................................... 309

3.3.8.3.1. Example ....................................................................................................... 310

3.3.9. Multiphase Looping Macros ........................................................................................... 310

3.3.9.1. Looping Over Phase Domains in Mixture (sub_domain_loop) ............................ 310

3.3.9.2. Looping Over Phase Threads in Mixture (sub_thread_loop) .............................. 311

3.3.9.3. Looping Over Phase Cell Threads in Mixture (mp_thread_loop_c) ..................... 312

3.3.9.4. Looping Over Phase Face Threads in Mixture (mp_thread_loop_f) .................... 312

3.3.10. Advanced Multiphase Macros ....................................................................................... 313

3.3.10.1. Phase Domain Pointer (DOMAIN_SUB_DOMAIN) ................................................. 313

3.3.10.2. Phase-Level Thread Pointer (THREAD_SUB_THREAD) .......................................... 314

3.3.10.3. Phase Thread Pointer Array (THREAD_SUB_THREAD) .......................................... 314

3.3.10.4. Mixture Domain Pointer (DOMAIN_SUPER_DOMAIN) .......................................... 315

3.3.10.5. Mixture Thread Pointer (THREAD_SUPER_THREAD) ............................................ 315

3.3.10.6. Domain ID (DOMAIN_ID) .................................................................................... 316

3.3.10.7. Phase Domain Index (PHASE_DOMAIN_INDEX) .................................................. 316

3.4. Vector and Dimension Macros ................................................................................................. 316

3.4.1. Macros for Dealing with Two and Three Dimensions ........................................................ 316

3.4.1.1. RP_2D and RP_3D ............................................................................................... 317

3.4.2. The ND Macros ............................................................................................................... 317

3.4.2.1. ND_ND ................................................................................................................. 317

3.4.2.2. ND_SUM ............................................................................................................... 317

3.4.2.3. ND_SET ............................................................................................................... 317

3.4.3. The NV Macros ............................................................................................................... 317

3.4.3.1. NV_V .................................................................................................................... 318

3.4.3.2. NV_VV ................................................................................................................. 318

3.4.3.3. NV_V_VS ............................................................................................................. 318

3.4.3.4. NV_VS_VS ........................................................................................................... 318

3.4.4. Vector Operation Macros ................................................................................................ 318

3.4.4.1.Vector Magnitude Using NV_MAG and NV_MAG2 ................................................... 318

3.4.4.2. Dot Product ........................................................................................................... 319

3.4.4.3. Cross Product ........................................................................................................ 319

3.5.Time-Dependent Macros ......................................................................................................... 319

3.6. Scheme Macros ...................................................................................................................... 321

3.6.1. Defining a Scheme Variable in the Text Interface ............................................................. 322

3.6.2. Accessing a Scheme Variable in the Text Interface ........................................................... 322

3.6.3. Changing a Scheme Variable to Another Value in the Text Interface ................................. 322

3.6.4. Accessing a Scheme Variable in a UDF ............................................................................. 322

3.7. Input/Output Functions .......................................................................................................... 323

3.7.1. Message ...................................................................................................................... 323

3.7.2. Error .......................................................................................................................... 324

3.7.3.The par_fprintf_head and par_fprintf Functions ............................................. 324

3.7.3.1. par_fprintf_head ......................................................................................... 324

3.7.3.2. par_fprintf .................................................................................................... 325

3.8. Miscellaneous Macros ............................................................................................................. 325

3.8.1. Data_Valid_P() ...................................................................................................... 325

of ANSYS, Inc. and its subsidiaries and affiliates.xvi

Customization Manual

3.8.2. FLUID_THREAD_P() .................................................................................................. 325

3.8.3. Get_Report_Definition_Values ....................................................................... 326

3.8.4. M_PI ............................................................................................................................ 328

3.8.5. NULLP & NNULLP ...................................................................................................... 328

3.8.6. N_UDM .......................................................................................................................... 328

3.8.7. N_UDS .......................................................................................................................... 328

3.8.8. SQR(k) ........................................................................................................................ 328

3.8.9. UNIVERSAL_GAS_CONSTANT ..................................................................................... 329

4. Interpreting UDFs .......................................................................................................................... 331

4.1. Introduction ........................................................................................................................... 331

4.1.1. Location of the udf.h File ............................................................................................. 331

4.1.2. Limitations ..................................................................................................................... 332

4.2. Interpreting a UDF Source File Using the Interpreted UDFs Dialog Box ..................................... 332

4.3. Common Errors Made While Interpreting A Source File ............................................................ 335

5. Compiling UDFs ............................................................................................................................. 337

5.1. Introduction ........................................................................................................................... 338

5.1.1. Location of the udf.h File ............................................................................................. 338

5.1.2. Compilers ...................................................................................................................... 339

5.2. Compiling a UDF Using the GUI ............................................................................................... 341

5.3. Compile a UDF Using the TUI ................................................................................................... 346

5.3.1. Set Up the Directory Structure ........................................................................................ 346

5.3.1.1. Windows Systems .................................................................................................. 346

5.3.1.2. Linux Systems ........................................................................................................ 347

5.3.2. Build the UDF Library ..................................................................................................... 348

5.3.2.1. Windows Systems .................................................................................................. 348

5.3.2.2. Linux Systems ........................................................................................................ 350

5.3.3. Load the UDF Library ...................................................................................................... 351

5.4. Link Precompiled Object Files From Non-ANSYS Fluent Sources ............................................... 351

5.4.1.Windows Systems ........................................................................................................... 352

5.4.2. Linux Systems ................................................................................................................ 352

5.4.3. Example: Link Precompiled Objects to ANSYS Fluent ....................................................... 353

5.5. Load and Unload Libraries Using the UDF Library Manager Dialog Box ..................................... 356

5.5.1. Load the UDF Library ...................................................................................................... 356

5.5.2. Unload the UDF Library .................................................................................................. 357

5.6. Common Errors When Building and Loading a UDF Library ...................................................... 357

5.6.1. Windows Distributed Parallel .......................................................................................... 358

5.7. Special Considerations for Parallel ANSYS Fluent ...................................................................... 359

6. Hooking UDFs to ANSYS Fluent .................................................................................................... 361

6.1. Hooking General Purpose UDFs ............................................................................................... 361

6.1.1. Hooking DEFINE_ADJUST UDFs ................................................................................... 361

6.1.2. Hooking DEFINE_DELTAT UDFs ................................................................................... 363

6.1.3. Hooking DEFINE_EXECUTE_AT_END UDFs ................................................................. 364

6.1.4. Hooking DEFINE_EXECUTE_AT_EXIT UDFs ............................................................... 365

6.1.5. Hooking DEFINE_INIT UDFs ....................................................................................... 367

6.1.6. Hooking DEFINE_ON_DEMAND UDFs ............................................................................ 368

6.1.7. Hooking DEFINE_RW_FILE and DEFINE_RW_HDF_FILE UDFs ................................. 369

6.1.8. User-Defined Memory Storage ....................................................................................... 370

6.2. Hooking Model-Specific UDFs ................................................................................................. 371

6.2.1. Hooking DEFINE_ANISOTROPIC_CONDUCTIVITY UDFs ........................................... 372

6.2.2. Hooking DEFINE_CHEM_STEP UDFs ............................................................................ 374

6.2.3. Hooking DEFINE_CPHI UDFs ....................................................................................... 375

6.2.4. Hooking DEFINE_DIFFUSIVITY UDFs ........................................................................ 376

xvii

of ANSYS, Inc. and its subsidiaries and affiliates.

Customization Manual

6.2.5. Hooking DEFINE_DOM_DIFFUSE_REFLECTIVITY UDFs ........................................... 378

6.2.6. Hooking DEFINE_DOM_SOURCE UDFs .......................................................................... 379

6.2.7. Hooking DEFINE_DOM_SPECULAR_REFLECTIVITY UDFs ......................................... 380

6.2.8. Hooking DEFINE_ECFM_SOURCE UDFs ........................................................................ 381

6.2.9. Hooking DEFINE_ECFM_SPARK_SOURCE UDFs .......................................................... 383

6.2.10. Hooking DEFINE_EC_RATE UDFs .............................................................................. 384

6.2.11. Hooking DEFINE_EDC_SCALES UDFs ........................................................................ 385

6.2.12. Hooking DEFINE_EMISSIVITY_WEIGHTING_FACTOR UDFs .................................. 386

6.2.13. Hooking DEFINE_FLAMELET_PARAMETERS UDFs .................................................... 387

6.2.14. Hooking DEFINE_ZONE_MOTION UDFs ...................................................................... 388

6.2.15. Hooking DEFINE_GRAY_BAND_ABS_COEFF UDFs .................................................... 390

6.2.16. Hooking DEFINE_HEAT_FLUX UDFs .......................................................................... 391

6.2.17. Hooking DEFINE_IGNITE_SOURCE UDFs ................................................................. 392

6.2.18. Hooking DEFINE_NET_REACTION_RATE UDFs ........................................................ 393

6.2.19. Hooking DEFINE_NOX_RATE UDFs ............................................................................ 395

6.2.20. Hooking DEFINE_PDF_TABLE UDFs .......................................................................... 397

6.2.21. Hooking DEFINE_PR_RATE UDFs .............................................................................. 397

6.2.22. Hooking DEFINE_PRANDTL UDFs .............................................................................. 398

6.2.23. Hooking DEFINE_PROFILE UDFs .............................................................................. 399

6.2.23.1. Hooking Profiles for UDS Equations ...................................................................... 401

6.2.24. Hooking DEFINE_PROPERTY UDFs ............................................................................ 403

6.2.25. Hooking DEFINE_REACTING_CHANNEL_BC UDFs .................................................... 405

6.2.26. Hooking DEFINE_REACTING_CHANNEL_SOLVER UDFs ........................................... 405

6.2.27. Hooking DEFINE_RELAX_TO_EQUILIBRIUM UDFs .................................................. 406

6.2.28. Hooking DEFINE_SBES_BF UDFs .............................................................................. 407

6.2.29. Hooking DEFINE_SCAT_PHASE_FUNC UDFs ............................................................. 409

6.2.30. Hooking DEFINE_SOLAR_INTENSITY UDFs ............................................................. 410

6.2.31. Hooking DEFINE_SOLIDIFICATION_PARAMS UDFs ................................................ 412

6.2.32. Hooking DEFINE_SOURCE UDFs ................................................................................. 413

6.2.33. Hooking DEFINE_SOOT_MASS_RATES UDFs ............................................................. 415

6.2.34. Hooking DEFINE_SOOT_NUCLEATION_RATES UDFs ................................................ 416

6.2.35. Hooking DEFINE_SOOT_OXIDATION_RATE UDFs .................................................... 417

6.2.36. Hooking DEFINE_SOOT_PRECURSOR UDFs ............................................................... 418

6.2.37. Hooking DEFINE_SOX_RATE UDFs ............................................................................ 418

6.2.38. Hooking DEFINE_SPARK_GEOM UDFs ........................................................................ 420

6.2.39. Hooking DEFINE_SPECIFIC_HEAT UDFs ................................................................. 421

6.2.40. Hooking DEFINE_SR_RATE UDFs .............................................................................. 422

6.2.41. Hooking DEFINE_THICKENED_FLAME_MODEL UDFs ................................................ 423

6.2.42. Hooking DEFINE_TRANS UDFs ................................................................................... 424

6.2.43. Hooking DEFINE_TRANSIENT_PROFILE UDFs ........................................................ 425

6.2.44. Hooking DEFINE_TURB_PREMIX_SOURCE UDFs ...................................................... 426

6.2.45. Hooking DEFINE_TURB_SCHMIDT UDFs ................................................................... 427

6.2.46. Hooking DEFINE_TURBULENT_VISCOSITY UDFs .................................................... 428

6.2.47. Hooking DEFINE_VR_RATE UDFs .............................................................................. 429

6.2.48. Hooking DEFINE_WALL_FUNCTIONS UDFs ............................................................... 430

6.2.49. Hooking DEFINE_WSGGM_ABS_COEFF UDFs ............................................................. 431

6.3. Hooking Multiphase UDFs ....................................................................................................... 433

6.3.1. Hooking DEFINE_BOILING_PROPERTY UDFs ............................................................. 433

6.3.2. Hooking DEFINE_CAVITATION_RATE UDFs ............................................................... 434

6.3.3. Hooking DEFINE_EXCHANGE_PROPERTY UDFs .......................................................... 436

6.3.4. Hooking DEFINE_HET_RXN_RATE UDFs ..................................................................... 438

6.3.5. Hooking DEFINE_LINEARIZED_MASS_TRANSFER UDFs ........................................... 439

of ANSYS, Inc. and its subsidiaries and affiliates.xviii

Customization Manual

6.3.6. Hooking DEFINE_MASS_TRANSFER UDFs ................................................................... 440

6.3.7. Hooking DEFINE_VECTOR_EXCHANGE_PROPERTY UDFs ........................................... 441

6.4. Hooking Discrete Phase Model (DPM) UDFs ............................................................................. 443

6.4.1. Hooking DEFINE_DPM_BC UDFs ................................................................................... 443

6.4.2. Hooking DEFINE_DPM_BODY_FORCE UDFs ................................................................. 444

6.4.3. Hooking DEFINE_DPM_DRAG UDFs .............................................................................. 445

6.4.4. Hooking DEFINE_DPM_EROSION UDFs ........................................................................ 446

6.4.5. Hooking DEFINE_DPM_HEAT_MASS UDFs ................................................................... 447

6.4.6. Hooking DEFINE_DPM_INJECTION_INIT UDFs ........................................................ 448

6.4.7. Hooking DEFINE_DPM_LAW UDFs ................................................................................ 449

6.4.8. Hooking DEFINE_DPM_OUTPUT UDFs .......................................................................... 450

6.4.9. Hooking DEFINE_DPM_PROPERTY UDFs ..................................................................... 451

6.4.10. Hooking DEFINE_DPM_SCALAR_UPDATE UDFs ........................................................ 453

6.4.11. Hooking DEFINE_DPM_SOURCE UDFs ........................................................................ 454

6.4.12. Hooking DEFINE_DPM_SPRAY_COLLIDE UDFs ........................................................ 454

6.4.13. Hooking DEFINE_DPM_SWITCH UDFs ........................................................................ 455

6.4.14. Hooking DEFINE_DPM_TIMESTEP UDFs ................................................................... 456

6.4.15. Hooking DEFINE_DPM_VP_EQUILIB UDFs ............................................................... 457

6.4.16. Hooking DEFINE_IMPINGEMENT UDFs ...................................................................... 459

6.4.17. Hooking DEFINE_FILM_REGIME UDFs ...................................................................... 460

6.4.18. Hooking DEFINE_SPLASHING_DISTRIBUTION UDFs ............................................. 462

6.5. Hooking Dynamic Mesh UDFs ................................................................................................. 463

6.5.1. Hooking DEFINE_CG_MOTION UDFs ............................................................................ 464

6.5.2. Hooking DEFINE_DYNAMIC_ZONE_PROPERTY UDFs .................................................. 464

6.5.2.1. Hooking a Swirl Center UDF ................................................................................... 465

6.5.2.2. Hooking a Variable Cell Layering Height UDF .......................................................... 466

6.5.3. Hooking DEFINE_GEOM UDFs ....................................................................................... 467

6.5.4. Hooking DEFINE_GRID_MOTION UDFs ........................................................................ 468

6.5.5. Hooking DEFINE_SDOF_PROPERTIES UDFs ............................................................... 469

6.5.6. Hooking DEFINE_CONTACT UDFs ................................................................................ 470

6.6. Hooking User-Defined Scalar (UDS) Transport Equation UDFs .................................................. 471

6.6.1. Hooking DEFINE_ANISOTROPIC_DIFFUSIVITY UDFs ............................................. 472

6.6.2. Hooking DEFINE_UDS_FLUX UDFs .............................................................................. 473

6.6.3. Hooking DEFINE_UDS_UNSTEADY UDFs ..................................................................... 474

6.7. Common Errors While Hooking a UDF to ANSYS Fluent ............................................................ 475

7. Parallel Considerations ................................................................................................................. 477

7.1. Overview of Parallel ANSYS Fluent ........................................................................................... 477

7.1.1. Command Transfer and Communication ......................................................................... 479

7.2. Cells and Faces in a Partitioned Mesh ....................................................................................... 480

7.2.1. Cell Types in a Partitioned Mesh ...................................................................................... 480

7.2.2. Faces at Partition Boundaries .......................................................................................... 481

7.2.3. PRINCIPAL_FACE_P ................................................................................................... 482

7.2.4. Exterior Thread Storage .................................................................................................. 482

7.2.5. Extended Neighborhood ................................................................................................ 483

7.3. Parallelizing Your Serial UDF .................................................................................................... 484

7.3.1. Parallelization of Discrete Phase Model (DPM) UDFs ........................................................ 485

7.3.2. Macros for Parallel UDFs ................................................................................................. 485

7.3.2.1. Compiler Directives ............................................................................................... 486

7.3.2.2. Communicating Between the Host and Node Processes ......................................... 487

7.3.2.2.1. Host-to-Node Data Transfer ........................................................................... 487

7.3.2.2.2. Node-to-Host Data Transfer ........................................................................... 488

7.3.2.3. Predicates .............................................................................................................. 489

xix

of ANSYS, Inc. and its subsidiaries and affiliates.

Customization Manual

7.3.2.4. Global Reduction Macros ....................................................................................... 490

7.3.2.4.1. Global Summations ....................................................................................... 491

7.3.2.4.2. Global Maximums and Minimums ................................................................. 491

7.3.2.4.3. Global Logicals .............................................................................................. 492

7.3.2.4.4. Global Synchronization ................................................................................. 492

7.3.2.5. Looping Macros ..................................................................................................... 492

7.3.2.5.1. Looping Over Cells ........................................................................................ 493

7.3.2.5.2. Interior Cell Looping Macro ........................................................................... 493

7.3.2.5.3. Exterior Cell Looping Macro .......................................................................... 493

7.3.2.5.4. Interior and Exterior Cell Looping Macro ........................................................ 494

7.3.2.5.5. Looping Over Faces ....................................................................................... 495

7.3.2.6. Cell and Face Partition ID Macros ............................................................................ 496

7.3.2.6.1. Cell Partition IDs ............................................................................................ 496

7.3.2.6.2. Face Partition IDs .......................................................................................... 497

7.3.2.7. Message Displaying Macros ................................................................................... 497

7.3.2.8. Message Passing Macros ........................................................................................ 498

7.3.2.9. Macros for Exchanging Data Between Compute Nodes ........................................... 500

7.3.3. Limitations of Parallel UDFs ............................................................................................ 501

7.3.4. Process Identification ..................................................................................................... 502

7.3.5. Parallel UDF Example ...................................................................................................... 503

7.4. Reading and Writing Files in Parallel ........................................................................................ 505

7.4.1. Reading Files in Parallel .................................................................................................. 505

7.4.2.Writing Files in Parallel .................................................................................................... 506

7.5. Enabling Fluent UDFs to Execute on General Purpose Graphics Processing Units (GPGPUs) ....... 507

8. Examples ....................................................................................................................................... 509

8.1. Step-By-Step UDF Example ..................................................................................................... 509

8.1.1. Process Overview ........................................................................................................... 509

8.1.2. Step 1: Define Your Problem ............................................................................................ 510

8.1.3. Step 2: Create a C Source File .......................................................................................... 512

8.1.4. Step 3: Start ANSYS Fluent and Read (or Set Up) the Case File .......................................... 512

8.1.5. Step 4: Interpret or Compile the Source File ..................................................................... 513

8.1.5.1. Interpret the Source File ......................................................................................... 513

8.1.5.2. Compile the Source File ......................................................................................... 515

8.1.6. Step 5: Hook the UDF to ANSYS Fluent ............................................................................ 518

8.1.7. Step 6: Run the Calculation ............................................................................................. 519

8.1.8. Step 7: Analyze the Numerical Solution and Compare to Expected Results ....................... 519

8.2. Detailed UDF Examples ........................................................................................................... 519

8.2.1. Boundary Conditions ...................................................................................................... 520

8.2.1.1. Parabolic Velocity Inlet Profile in an Elbow Duct ...................................................... 520

8.2.1.2.Transient Pressure Outlet Profile for Flow in a Tube ................................................. 524

8.2.2. Source Terms .................................................................................................................. 529

8.2.2.1. Adding a Momentum Source to a Duct Flow .......................................................... 529

8.2.3. Physical Properties ......................................................................................................... 534

8.2.3.1. Solidification via a Temperature-Dependent Viscosity ............................................. 534

8.2.4. Reaction Rates ............................................................................................................... 537

8.2.4.1. Volume Reaction Rate ............................................................................................ 538

8.2.5. User-Defined Scalars ...................................................................................................... 541

8.2.5.1. Postprocessing Using User-Defined Scalars ............................................................ 541

8.2.5.2. Implementing ANSYS Fluent’s P-1 Radiation Model Using User-Defined Scalars ....... 543

8.2.6. User-Defined Real Gas Models (UDRGM) ......................................................................... 546

8.2.6.1. UDRGM Example: Redlich-Kwong Equation of State ................................................ 546

8.2.6.2. Specific Volume and Density .................................................................................. 546

of ANSYS, Inc. and its subsidiaries and affiliates.xx

Customization Manual

剩余689页未读，继续阅读

weixin_51426591

粉丝: 0
资源: 1

ANSYS Fluent 19.0 UDF入门指南

ANSYS_Fluent_Theory_Guide.pdf

ANSYS_Fluent_Users_Guide_2020.pdf

ANSYS_Fluent_Users_Guide.pdf

ANSYS Fluent in ANSYS Workbench Users Guide.pdf

Ansys_Fluent_Users_Guide.pdf

ANSYS Fluent Users Guide.pdf

2019 ANSYS Fluent Users Guide.pdf

ANSYS CFX-Solver Manager Users Guide.pdf

Ansys_Fluent_Users_Guide 2021.pdf

ANSYS Fluent User's Guide.pdf

最新资源