ANSYS Fluent Meshing Text Command List

ANSYS, Inc. Release 18.2

Southpointe August 2017
2600 ANSYS Drive
Canonsburg, PA 15317 ANSYS, Inc. and
[email protected] ANSYS Europe,
Ltd. are UL
http://www.ansys.com registered ISO
(T) 724-746-3304 9001: 2008
(F) 724-514-9494 companies.
Copyright and Trademark Information

© 2017 ANSYS, Inc. Unauthorized use, distribution or duplication is prohibited.

ANSYS, ANSYS Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature
names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the
United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark
of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property
of their respective owners. FLEXlm and FLEXnet are trademarks of Flexera Software LLC.

Disclaimer Notice

THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFID-
ENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products
and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement
that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting
laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products
and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions
of that software license agreement.

ANSYS, Inc. and ANSYS Europe, Ltd. are UL registered ISO 9001: 2008 companies.

U.S. Government Rights

For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use,
duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc.
software license agreement and FAR 12.212 (for non-DOD licenses).

Third-Party Software

See the legal information in the product help files for the complete Legal Notice for ANSYS proprietary software
and third-party software. If you are unable to access the Legal Notice, contact ANSYS, Inc.

Published in the U.S.A.

Table of Contents
1. Using This Manual ................................................................................................................................... 1
2. Text User Interface .................................................................................................................................. 3
2.1. Text Menu System ............................................................................................................................. 3
2.1.1. Command Abbreviation ........................................................................................................... 4
2.1.2. Scheme Evaluation ................................................................................................................... 5
2.1.3. Aliases ..................................................................................................................................... 5
2.2. Text Prompt System .......................................................................................................................... 6
2.2.1. Numbers .................................................................................................................................. 6
2.2.2. Booleans .................................................................................................................................. 7
2.2.3. Strings ..................................................................................................................................... 7
2.2.4. Symbols ................................................................................................................................... 7
2.2.5. Filenames ................................................................................................................................ 8
2.2.6. Lists ......................................................................................................................................... 8
2.2.7. Evaluation ................................................................................................................................ 9
2.2.8. Default Value Binding ............................................................................................................... 9
2.3. Interrupts ......................................................................................................................................... 9
2.4. System Commands ........................................................................................................................... 9
2.4.1. System Commands for LINUX-based Operating Systems ......................................................... 10
2.4.2. System Commands for Windows-based Operating Systems ..................................................... 10
2.5. Text Menu Input from Character Strings .......................................................................................... 11
2.6. Using the Text Interface Help System ............................................................................................... 12
3. boundary/ ............................................................................................................................................. 13
4. cad-assemblies/ ..................................................................................................................................... 35
5. diagnostics/ ........................................................................................................................................... 39
6. display/ .................................................................................................................................................. 41
7. exit ......................................................................................................................................................... 59
8. file/ ........................................................................................................................................................ 61
9. material-point/ ...................................................................................................................................... 73
10. mesh/ ................................................................................................................................................... 75
11. objects/ .............................................................................................................................................. 111
12. parallel/ ............................................................................................................................................. 121
13. report/ ............................................................................................................................................... 123
14. scoped-sizing/ ................................................................................................................................... 125
15. size-functions/ ................................................................................................................................... 127
16. switch-to-solution-mode .................................................................................................................. 129
A. Query and Utility Functions ................................................................................................................... 131
A.1. List Queries and Utility Functions .................................................................................................. 131
A.1.1. Using Boolean Operations with Lists ..................................................................................... 139
A.1.2. Examples ............................................................................................................................. 139
A.2. Label Utility Functions .................................................................................................................. 140
A.2.1. Examples ............................................................................................................................. 143
A.3. Report Utility Functions ................................................................................................................ 143
A.4. Diagnostic Based Marking Utility Functions ................................................................................... 149
A.5. Mesh Setup Utility Functions ........................................................................................................ 153
A.6. Mesh Operation Utility Functions .................................................................................................. 154
A.7. Miscellaneous Functions ............................................................................................................... 158
B. Boundary Functions .............................................................................................................................. 159
B.1. Examples ...................................................................................................................................... 168
C. Connect Functions ................................................................................................................................ 171
C.1. Examples ...................................................................................................................................... 173

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. iii
Meshing Text Command List

D. Size Field Functions ............................................................................................................................... 175

D.1. Examples ...................................................................................................................................... 182
E. Wrap Functions ...................................................................................................................................... 185
E.1. Examples ...................................................................................................................................... 191

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
iv of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 1: Using This Manual
Important

Under U.S. and international copyright law, ANSYS, Inc. is unable to distribute copies of the
papers listed in the bibliography, other than those published internally by ANSYS, Inc. Use
your library or a document delivery service to obtain copies of copyrighted papers.

This manual describes the text-based user interface of ANSYS Fluent Meshing which may be used for
scripting and other advanced workflows. Here is what you will find in each chapter and appendix:

• Text User Interface (p. 3) gives an overview of the text command language, including basic syntax and
capabilities.

• boundary/ (p. 13) lists the commands used for creating, managing, modifying, deleting boundary (face)
zones and surface mesh.

• cad-assemblies/ (p. 35) lists commands used to interact with your CAD model.

• diagnostics/ (p. 39) lists commands used to find and repair face zone problems related to connectivity and
quality.

• display/ (p. 41) lists commands used to control the rendering of your model and mesh in the graphical
window.

• exit (p. 59) lists the command to close the program.

• file/ (p. 61) lists commands used to input and output your data.

• material-point/ (p. 73) lists commands used to manage material points in your model.

• mesh/ (p. 75) lists commands used to create, manage, modify and delete cell zones and volume mesh.

• objects/ (p. 111) lists commands used in the object-based meshing workflow, from CAD import to volume
fill.

• parallel/ (p. 121) lists commands specific to parallel processing.

• report/ (p. 123) lists commands used to return volume and surface mesh statistics such as counts or quality.

• scoped-sizing/ (p. 125) lists commands used to create and manage scoped size controls.

• size-functions/ (p. 127) lists commands used to create and manage size functions such as global or periodic
sizes.

• switch-to-solution-mode (p. 129) lists the command to transfer your mesh data to the Fluent solver.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 1
Using This Manual

• Appendix A: Query and Utility Functions (p. 131) lists API functions used to interact with your model by
passing information such as names or lists of zones or objects, statistics, and diagnostics. Boolean operations
and examples are included.

• Appendix B: Boundary Functions (p. 159) lists API functions used to manage boundary (face) zone mesh. Ex-
amples are included.

• Appendix C: Connect Functions (p. 171) lists API functions used to manage boundary (face) zone connectivity.
Examples are included.

• Appendix D: Size Field Functions (p. 175) lists API functions used to manage geodesic size controls and size
fields. Examples are included.

• Appendix E: Wrap Functions (p. 185) lists API functions used to manage your mesh in UTM cases. Examples
are included.

Additional documentation is available:

• The ANSYS Fluent Meshing User's Guide describes the interactive use of Fluent Meshing through the
graphical user interface.

• The latest updates of the ANSYS Fluent Meshing tutorials on the ANSYS Customer Portal. To access tutorials
and their input files on the ANSYS Customer Portal, go to http://support.ansys.com/training.

Note

You can download the PDF documentation from the ANSYS Customer Portal (support.an-
sys.com/docdownloads).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
2 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 2: Text User Interface
In addition to the graphical user interface, the ANSYS Fluent Meshing user interface also consists of a
textual command line reference. The text user interface (TUI) is written in a dialect of Lisp called Scheme.
Users familiar with Scheme will be able to use the interpretive capabilities of the interface to create
customized commands. The TUI is described in the following sections:
2.1.Text Menu System
2.2.Text Prompt System
2.3. Interrupts
2.4. System Commands
2.5.Text Menu Input from Character Strings
2.6. Using the Text Interface Help System

2.1. Text Menu System

The text menu system provides a hierarchical interface to the program’s underlying procedural interface.

• You can easily manipulate its operation with standard text-based tools: input can be saved in files, modified
with text editors, and read back in to be executed, because it is text based.

• The text menu system is tightly integrated with the Scheme extension language, so it can easily be pro-
grammed to provide sophisticated control and customized functionality.

The menu system structure is similar to the directory tree structure of LINUX operating systems. When
you first start ANSYS Fluent Meshing, you are in the "root" menu and the menu prompt is simply a
caret/greater-than symbol:
>

To generate a listing of the submenus and commands in the current menu, press Enter.
> [Enter]
beta-feature-access file/ scoped-sizing/
boundary/ material-point/ size-functions/
diagnostics/ mesh/ switch-to-solution-mode
display/ objects/
exit report/

Use the command beta-feature-access to enable the features available in beta mode.
> beta-feature-access

Enable beta features? [no] yes

Enabling beta features...

It is recommended that you save your files before enabling beta features.
This will assist in reverting to released functionality if needed.

OK to proceed? [cancel] ok

To disable beta feature you can use the same command.

> beta-feature-access

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 3
Text User Interface

Enable beta features? [yes] no

Disabling beta features...

Warning: Note that disabling beta features may in certain cases leave some currently
used beta models active, even though further UI access to this functionality is disabled.
Use your pre-saved files to fully revert to released functionality.

OK to proceed? [cancel] ok

By convention, submenu names end with a / to differentiate them from menu commands. To execute
a command, type its name (or an abbreviation). Similarly, to move down into a submenu, enter its name
or an abbreviation. When you move into the submenu, the prompt will change to reflect the current
menu name.
> display

/display > set

/display/set >

To move back to the previously occupied menu, type q or quit at the prompt.
/display/set > q

/display

You can move directly to a menu by giving its full pathname.

/display > /file

/display//file >

In the above example, control was passed from /display to /file without stopping in the root
menu. Therefore, when you quit from the /file menu, control will be passed directly back to /dis-
play.
/display//file > q

/display >

If you execute a command without stopping in any of the menus along the way, control will again be
returned to the menu from which you invoked the command.
/display /file start-journal jrnl

/display >

The text menu system provides online help for menu commands. The text menu online help system is
described in Using the Text Interface Help System (p. 12).

To edit the current command, you can position the cursor with the left and right arrow keys, delete
with the Backspace key, and insert text simply by typing.

For additional information, refer to the following sections:

2.1.1. Command Abbreviation
2.1.2. Scheme Evaluation
2.1.3. Aliases

2.1.1. Command Abbreviation

To select a menu command, you need not type the entire name; you can type an abbreviation that
matches the command.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
4 of ANSYS, Inc. and its subsidiaries and affiliates.
 Text Menu System

• A command name consists of "phrases" separated by hyphens.

• A command is matched by matching an initial sequence of its phrases.

• Matching of hyphens is optional.

• A phrase is matched by matching an initial sequence of its characters.

• A character is matched by typing that character.

The rules for "matching" a command are:

• If an abbreviation matches more than one command, then the command with the greatest number of
matched phrases is chosen.

• If more than one command has the same number of matched phrases, then the first command to appear
in the menu is chosen.

For example, each of the following will match the given command set-ambientcolor: set-am-
bient-color, s-a-c, sac, and sa.

• When abbreviating commands, sometimes your abbreviation will match more than one command. In such
cases, the first command is selected.

• Occasionally, there is an anomaly such as lint not matching lighting-interpolation because the
li gets absorbed in lights-on? and then the nt does not match interpolation.

This can be resolved by choosing a different abbreviation, such as liin, or l-int.

2.1.2. Scheme Evaluation

If you enter an open parenthesis "(" at the menu prompt, then that parenthesis and all characters up
to and including the matching closing parenthesis are passed to Scheme to be evaluated. The result
of evaluating the expression is then displayed.
> (define a 1)

a
> (+ a 2 3 4)

10

2.1.3. Aliases
Command aliases can be defined within the menu system. As with the LINUX csh shell, aliases take
precedence over command execution. The following aliases are predefined in Cortex (error, pwd,
chdir, ls, ., and alias):

error
displays the Scheme object that was the "irritant" in the most recent Scheme error interrupt.

pwd
prints the working directory in which all file operations will take place.

chdir
changes the working directory.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 5
Text User Interface

ls
lists the files in the working directory.

alias
displays the list of symbols currently aliased.

2.2. Text Prompt System

Commands require various arguments, including numbers, filenames, yes/no responses, character strings,
and lists. A uniform interface to this input is provided by the text prompt system. A prompt consists of
a prompt string, followed by an optional units string enclosed in parentheses, followed by a default
value enclosed in square brackets
filled grids? [no] <Enter>

shrink-factor [0.1] <Enter>

line-weight [1] <Enter>

title [""] <Enter>

• The default value for a prompt is accepted by pressing Enter or typing a comma (,).

Important

A comma is not a separator. It is a separate token that indicates a default value. The se-
quence "1,2" results in three values:

– the number 1 for the first prompt.

– the default value for the second prompt.

– the number 2 for the third prompt.

• A short help message can be displayed at any prompt by entering a ?. (See Using the Text Interface Help
System (p. 12).)

• To terminate a prompt sequence, use Ctrl+C.

For additional information, refer to the following sections:

2.2.1. Numbers
2.2.2. Booleans
2.2.3. Strings
2.2.4. Symbols
2.2.5. Filenames
2.2.6. Lists
2.2.7. Evaluation
2.2.8. Default Value Binding

2.2.1. Numbers
The most common prompt type is a number. Numbers can be either integers or real numbers. Valid
numbers are, for example, 16, -2.4, .9e5, and +1e-5.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
6 of ANSYS, Inc. and its subsidiaries and affiliates.
 Text Prompt System

• Integers can also be specified in binary, octal, and hexadecimal form.

• The decimal integer 31 can be entered as 31, #b11111, #o37, or #x1f.

• In Scheme, integers are a subset of reals, so you do not need a decimal point to indicate that a number is
real; 2 is just as much a real as 2.0.

• If you enter a real number at an integer prompt, any fractional part will be truncated. For example, 1.9 will
become 1.

2.2.2. Booleans
Some prompts require a yes-or-no response. A yes/no prompt will accept either yes or y for a positive
response, or no or n for a negative response. These prompts are used for confirming potentially dan-
gerous actions such as overwriting an existing file, exiting without saving the, mesh, case, and so on.

Some prompts require actual Scheme boolean values (true or false). These are entered with the Scheme
symbols for true #t and false #f.

2.2.3. Strings
Character strings are entered in double quotes, as in "red". Plot titles and plot legend titles are examples
of character strings. Character strings can include any characters, including blank spaces and punctuation.

2.2.4. Symbols
Symbols are entered without quotes. Zone names, surface names, and material names are examples of
symbols. Symbols must start with an alphabetical character (that is, a letter), and cannot include any
blank spaces or commas.

You can use wild cards to specify zone names when using the TUI. Some examples are:

• * will translate as “all zones”.

For example,

– /display/boundary-grid * enables you to display all the boundary zones in the mesh.

– /boundary/delete-island-faces wrap* enables you to delete island faces on all zones

prefixed by wrap.

• > will translate as “all zones visible in the graphics window”.

For example, /boundary/manage/delete >, yes enables you to delete all visible zones.

• ^ will translate as “all zones selected in the graphics window”.

For example, /boundary/manage/delete ^, yes enables you to delete all selected zones.

• [object_name will translate as “all zones with the name object_name”.

For example, /boundary/manage/delete [box, yes enables you to delete all zones of an
object with the name box.

• [object_name/label_name will translate as "all zones with label_name of object_name"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 7
Text User Interface

For example, /boundary/manage/delete [fluid/box*, yes enables you to delete all zones
of an object with the name fluid and comprising face zone labels box*.

If you use a wild card for an operation that requires a single zone as input, you will be prompted to
specify a single zone from the list of those that match the expression specified.
> /boundary/manage/name wall* <Enter>

wall-1 wall-3 wall-5

wall-2 wall-4 wall-6
Zone Name [ ]

2.2.5. Filenames
Filenames are actually character strings. For convenience, filename prompts do not require the string
to be surrounded with double quotes. If, for some exceptional reason, a filename contains an embedded
space character, then the name must be surrounded with double quotes.

One consequence of this convenience is that filename prompts do not evaluate the response. For ex-
ample, the following sequence will end up writing a hardcopy file with the name fn, not valve.ps.
> (define fn "valve.ps")

fn

> hc fn

Because the filename prompt did not evaluate the response, fn did not get a chance to evaluate
"valve.ps" as it would for most other prompts.

2.2.6. Lists
Some functions in ANSYS Fluent Meshing require a "list" of objects such as numbers, strings, Booleans,
and so on. A list is a Scheme object that is a sequence of objects terminated by the empty list, ’().
Lists are prompted for an element at a time, and the end of the list is signalled by entering an empty
list. This terminating list forms the tail of the prompted list, and can either be empty or can contain
values.

For convenience, the empty list can be entered as () as well as the standard form ’(). Normally, list
prompts save the previous argument list as the default. To modify the list, overwrite the desired elements
and terminate the process with an empty list.

For example the following creates a list of three numbers: 1, 10, and 100.
element(1) [()] 1

element(2) [()] 10

element(3) [()] 100

element(4) [()] <Enter>

Subsequently,
element(1) [1] <Enter>

element(2) [10] <Enter>

element(3) [100] <Enter>

element(4) [()] <Enter>

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
8 of ANSYS, Inc. and its subsidiaries and affiliates.
 System Commands

element(5) [()] <Enter>

adds a fourth element as shown below. Then

element(1) [1] <Enter>

element(2) [10] <Enter>

element(3) [100] ()

leaves only 1 and 10 in the list. Subsequently entering

element(1) [1] ,,’(11 12 13)

creates a five element list: 1, 10, 11, 12, and 13. Finally, a single empty list removes all elements.
element(1) [1] ()

2.2.7. Evaluation
All responses to prompts (except filenames), are "evaluated" by the Scheme interpreter before they are
used. Therefore you can enter any valid Scheme expression as the response to a prompt. For example,
to enter a unit vector with one component equal to 1/3 (without using your calculator), do the following:
/foo > set-xy
x-component [1.0] (/ 1 3)

y-component [0.0] (sqrt (/ 8 9))

You can also first define a utility function to compute the second component of a unit vector as follows:
> (define (unit-y x) (sqrt (- 1.0 (* x x))))

unit-y
/foo > set-xy

x-component [1.0](/ 1 3)

y-component [0.0] (unit-y (/ 1 3))

2.2.8. Default Value Binding

The default value at any prompt is bound to the Scheme symbol "_" (underscore) so that the default
value can form part of a Scheme expression. For example, if you want to decrease a default value by
one-third, you could enter
shrink-factor [0.8] (/ _ 3)

2.3. Interrupts
You can halt the execution of the code at the next recoverable location by pressing Ctrl+C.

2.4. System Commands

You can execute system commands with the ! (bang) shell escape character on both LINUX and Windows
systems as follows:
2.4.1. System Commands for LINUX-based Operating Systems
2.4.2. System Commands for Windows-based Operating Systems

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 9
Text User Interface

2.4.1. System Commands for LINUX-based Operating Systems

If you are running ANSYS Fluent Meshing on a LINUX operating system, all characters following the !
up to the next newline character will be executed in a subshell. Any further input related to these system
commands must be entered in the window in which you started the program, and any screen output
will also appear in that window.

If you start ANSYS Fluent Meshing remotely, this input and output will be in the window in which you
start Cortex.
> !rm junk.*

> !vi script.rp

The ls and pwd aliases invoke the LINUX ls and pwd commands in the working directory. The cd
alias changes the current working directory of the program. The !ls and !pwd commands will execute
the LINUX commands in the directory in which Cortex was started. The screen output will appear in
the window in which you started ANSYS Fluent Meshing, unless you started it remotely, in which case
the output will appear in the window in which you started Cortex.

Note

The command !cd executes in a subshell, so it will not change the working directory either
for ANSYS Fluent Meshing or for Cortex, and it is therefore not useful.

Typing cd with no arguments will move you to your home directory in the console. Examples of system
commands entered in the console are as follows:
> !pwd

> !ls valve.*

Example output (in the window in which ANSYS Fluent Meshing–or Cortex, if you started the program
remotely–was started):
/home/cfd/run/valve
valve1.cas valve1.msh valve2.cas valve2.msh

2.4.2. System Commands for Windows-based Operating Systems

If you are running ANSYS Fluent Meshing on a Windows operating system, all characters following the
! up to the next newline character will be executed. The results of a command will appear in the ANSYS
Fluent Meshing console, or in a separate window if the command starts an external program, such as
Notepad.
> !del junk.*

> !notepad script.rp

!cd and !dir execute the DOS commands and the screen output appears in the ANSYS Fluent
Meshing console. The !cd command with no argument displays the current working directory in the
ANSYS Fluent Meshing console.

Example input and output (in the ANSYS Fluent Meshing console):
> !cd

p:/cfd/run/valve

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
10 of ANSYS, Inc. and its subsidiaries and affiliates.
 Text Menu Input from Character Strings

> !dir valve*.*/w

Volume in drive P is users

Volume Serial Number is 1234-5678
Directory of p:/cfd/run/valve
valve1.cas valve1.msh valve2.cas valve2.msh
4 File(s) 621,183 bytes
0 Dir(s) 1,830,088,704 bytes free

2.5. Text Menu Input from Character Strings

When writing a Scheme extension function for ANSYS Fluent Meshing, it is convenient to be able to
include menu commands in the function. This can be done with ti-menu-load-string. For example,
to open graphics window 2, use:
(ti-menu-load-string "di ow 2")

A Scheme loop that will open windows 1 and 2 and display the front view of the grid in window 1 and
the back view in window 2 is given by
(for-each
(lambda (window view)
(ti-menu-load-string (format #f "di ow ~a gr view rv ~a"
window view)))
’(1 2)
’(front back))

This loop makes use of the format function to construct the string used by menu-load-string.
This simple loop can also be written without using menu commands, but you need to know the Scheme
functions that get executed by the menu commands to do it:
(for-each
(lambda (window view)
(cx-open-window window)
(display-grid)
(cx-restore-view view))
’(1 2) ’(front back))

String input can also provide an easy way to create aliases within ANSYS Fluent Meshing. For example,
to create an alias that will display the grid, you can type the following:
(alias ’dg (lambda () (ti-menu-load-string "/di gr")))

Then any time you enter dg from anywhere in the menu hierarchy, the grid will be drawn in the active
window.

Important

ti-menu-load-string evaluates the string argument in the top level menu. It ignores
any menu you may be in when you invoke ti-menu-loadstring. Therefore, the command
(ti-menu-load-string "open-window 2 gr") ; incorrect usage

will not work even if you type it from within the display/ menu. The string itself must
cause control to enter the display/ menu, as in
(ti-menu-load-string "display open-window 2 grid")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 11
Text User Interface

2.6. Using the Text Interface Help System

The text user interface provides context-sensitive online help. Within the text menu system, a brief de-
scription of each of the commands can be invoked by entering a ? followed by the command in
question.

Example:
> ?dis
display/: Enter the display menu.

You can also enter a lone ? to enter "help mode." In this mode, you need only enter the command or
menu name to display the help message. To exit help mode type q or quit as for a normal menu.

Example:
> ?

[help-mode] > di

display/: Enter the display menu.

[help-mode] > pwd

pwd: #[alias]
(LAMBDA ()
(cx-send ’(system "pwd")))

[help-mode] > q

Help can also be obtained when you are prompted for information by typing a ? at the prompt.

Example:
> display/annotate Annotation text [""] ?

Annotation text [""]

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
12 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 3: boundary/
auto-slit-faces
slits all boundary faces with cells on both sides (these cells must be in the same cell zone). A displacement
can be specified to provide thickness to the boundary.

boundary-conditions/
contains options for copying or clearing boundary conditions when a case file is read.

clear
clears the boundary conditions assigned to the specified face zones.

clear-all
clears the boundary conditions assigned to all the face zones.

copy
enables you to copy the boundary conditions from the face zone selected to the face zones specified.

check-boundary-mesh
reports the number of Delaunay violations on the triangular surface mesh and the number of isolated
nodes.

check-duplicate-geom
displays the names of the duplicate surfaces and prints maximum and average distance between them.

clear-marked-faces
clears marked faces.

clear-marked-nodes
clears nodes that were marked using the mark-duplicate-nodes command.

compute-bounding-box
computes the bounding box for the zones specified.

count-free-nodes
reports the number of boundary nodes associated with edges having only one attached face.

count-marked-faces
reports the number of marked faces.

count-unused-bound-node
counts the unused boundary nodes in the domain.

count-unused-faces
lists the number of boundary faces that are not used by any cell.

count-unused-nodes
lists the number of boundary nodes that are not used by any cell.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 13
boundary/

create-bounding-box
creates the bounding box for the specified zones. You can specify the zone type, name, edge length, and
the extents of the box, as required. You can also optionally create a geometry object from the bounding
box created.

create-cylinder
creates a cylinder by specifying the axis, radius, and edge length or three arc nodes, the axial delta, the
radial gap, and the edge length. You can also specify the prefix for the zone being created, as required.
You can also optionally create a geometry object from the cylinder created.

create-plane-surface
creates a plane surface by specifying either the axis direction, axial location, and the extents of the surface
or three points defining the plane. You can also optionally create a geometry object from the plane surface
created.

create-revolved-surface
creates a revolved surface by rotating the specified edge through the angle specified. Specify the number
of segments, scale factor, and the pivot point and axis of rotation. You can also optionally create a geometry
object from the revolved surface created.

create-swept-surface
creates a surface by sweeping the specified edge in the direction specified. You need to specify the distance
to sweep through and the number of offsets, as required. You can also optionally create a geometry object
from the swept surface created.

delete-all-dup-faces
searches for faces on all boundary zones that have the same nodes and deletes the duplicates.

delete-duplicate-faces
searches for faces on a specified zone that have the same nodes and deletes the duplicates.

Duplicate faces may be present if you generated the boundary mesh using a third-party grid gener-
ator, or if you have used the slit-boundary-face command to modify the boundary mesh
and then merged the nodes.

delete-free-edge-faces
enables you to remove faces with the specified number of free edges from the specified boundary zones.

delete-island-faces
enables you to delete faces in a non-contiguous region of a face zone.

delete-unconnected-faces
enables you to delete the unconnected face-zones.

delete-unused-faces
deletes all the boundary faces that are not used by any cell.

delete-unused-nodes
deletes the boundary nodes that are not used by any boundary faces.

edge-limits
prints the length of the shortest and longest edges on the boundary. This information is useful for setting
initial mesh parameters and refinement controls.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
14 of ANSYS, Inc. and its subsidiaries and affiliates.
face-distribution
reports the distribution of face quality in the text window.

face-skewness
lists the worst face skewness.

feature/
enables you to create and modify features.

copy-edge-zones
copies the specified edge zone(s) to new edge zone(s).

create-edge-zones
extracts edge loops for the specified face zone(s) based on the feature method specified. You also
need to specify an appropriate value for feature angle when using the fixed-angle method.

Note

The Face Seed approach cannot be used when creating edge loops using text com-
mands.

delete-degenerated-edges
deletes degenerated edges (edges where the two end nodes are the same) for the edge zone(s) specified.

delete-edge-zones
deletes the specified edge zone(s)

edge-size-limits
reports the minimum, maximum, and average edge length for the specified edge zone(s) in the console.

group
associates the specified edge zone(s) with the specified face zone.

intersect-edge-zones
intersects the specified edge loops to create a new edge loop comprising the common edges. You
can enable automatic deleting of overlapped edges and specify an appropriate intersection tolerance.

list-edge-zones
lists the name, ID, type, and count for the specified edge zone(s).

merge-edge-zones
merges multiple edge loops of the same type into a single loop.

orient-edge-direction
orients the edges on the loop to point in the same direction.

project-edge-zones
projects the edges of the specified loop onto the specified face zone using the specified projection
method.

remesh-edge-zones
remeshes the specified edge loop(s), modifying the node distribution according to the specified
remeshing method, spacing values, and feature angle. You can also enable quadratic reconstruction,
if required.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 15
boundary/

reverse-edge-direction
reverses the direction of the edge loop.

separate-delete-small-edges
separates the edge zones based on the feature angle specified, and then deletes the edges having a
count smaller than the minimum count specified.

separate-edge-zones
separates the specified edge loop based on connectivity and the specified feature angle.

separate-edge-zones-by-seed
separates the edge loop based on the seed edge specified. The edge zone separation angle is used to
separate the edge zone (default 40).

toggle-edge-type
toggles the edge type between boundary and interior.

ungroup
ungroups previously grouped edge zones.

fix-mconnected-edges
resolves multi-connected edges/non-manifold configurations in the boundary mesh by deleting fringes
and overlaps based on threshold values specified.

improve/
enables you to improve boundary surfaces.

collapse-bad-faces
enables you to collapse the short edge of faces having a high aspect ratio or skewness in the specified
face zone(s).

degree-swap
enables you to improve the boundary mesh by swapping edges based on a node degree value other
than 6. The node degree is defined as the number of edges connected to the node.

improve
enables you to improve the boundary surface quality using skewness, size change, aspect ratio, or area
as the quality measure.

smooth
enables you to improve the boundary surface using smoothing.

swap
enables you to improve the boundary surface using edge swapping.

jiggle-boundary-nodes
randomly perturbs all boundary nodes based on an input tolerance. Some nodes will be perturbed less
than the tolerance value, while others will be perturbed by half of the tolerance value in all three coordinate
directions.

make-periodic
enables you to make the specified boundaries periodic. You can specify the type of periodicity (rotational
or translational), the angle, pivot, and axis of rotation, for rotational periodicity or the translational shift
for translational periodicity.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
16 of ANSYS, Inc. and its subsidiaries and affiliates.
 For each of the zones specified, a corresponding periodic shadow boundary zone will be created.

manage/
contains options for manipulating the boundary zones.

auto-delete-nodes?
specifies whether or not unused nodes should be deleted when their face zone is deleted.

change-prefix
enables you to change the prefix for the specified face zones.

copy
copies all nodes and faces of the specified face zone(s).

create
creates a new face zone.

delete
deletes the face zone.

flip
reverses the normal direction of the specified boundary zone(s).

id
specifies a new boundary zone ID. If there is a conflict, the change will be ignored.

list
prints information about all boundary zones.

merge
merge face zones.

name
gives a face zone a new name.

orient
consistently orients the faces in the specified zones.

origin
specifies a new origin for the mesh, to be used for face zone rotation and for periodic zone creation.
The default origin is (0,0,0).

remove-suffix
removes the suffix (characters including and after the leftmost ":") in the face zone names.

rotate
rotates all nodes of the specified face zone(s).

rotate-model
rotates all nodes of the model through the specified angle, based on the specified point and axis of
rotation.

scale
scales all nodes of the specified face zone(s).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 17
boundary/

scale-model
scales all nodes of the model by multiplying the node coordinates by the specified scale factors (x, y,
z).

translate
translates all nodes of the specified face zone(s).

translate-model
translates all nodes of the model by the specified translation offsets (x, y, z).

Note

The translation offsets are interpreted as absolute numbers in meshing mode. In

solution mode, however, the translation offsets are assumed to be distances in the
length unit set. This may lead to differences in domain extents reported after trans-
lating the mesh in the respective modes.

type
changes the boundary type of the face zone.

Note

When changing the boundary type of any zone to type interior, ensure that there
is a single cell zone across the interior boundary. Retaining multiple cell zones
across an interior boundary can cause undesirable results with further tet meshing
or smoothing operations.

Also, face zones having no/one neighboring cell zone should not be changed to type
interior.

The mesh check will issue a warning if multiple cell zones are maintained across an
interior boundary. The boundary type in such cases should be set to internal
instead.

user-defined-groups
enables you to manipulate user-defined groups.

activate
activates the specified user-defined groups.

create
creates the user-defined group comprising the specified zones.

delete
deletes the specified user-defined group.

list
lists the groups in the console.

update
enables you to modify an existing group.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
18 of ANSYS, Inc. and its subsidiaries and affiliates.
mark-duplicate-nodes
marks duplicate nodes. The marked nodes will appear in the grid display when nodes are displayed. For
a list of duplicate nodes, set the /report/verbosity level to 2 before using the mark-duplicate-
nodes command.

mark-face-intersection
marks intersecting faces. Intersection is detected if the line defined by any two consecutive nodes on a
face intersects any face in the current domain. The marked faces will appear in the grid display when faces
are displayed. For a list of intersecting faces, set the /report/verbosity level to 2 before using the
mark-face-intersection command.

mark-face-proximity
marks faces that are in proximity to each other.

Face A is considered to be in proximity to face B if any of the nodes on face A are within the calcu-
lated proximity distance from face B. The proximity distance is calculated based on the specified
relative distance and the sphere radius. The sphere radius is determined by the maximum distance
from the centroid of the face to its nodes. The marked faces will appear in the grid display when
faces are displayed.

For a list of faces in proximity to each other, set the /report/verbosity level to 2 before using
the mark-face-proximity command.

mark-faces-in-region
marks the faces that are contained in a specified local refinement region.

merge-nodes
merges duplicate nodes.

merge-small-face-zones
merges the face zones having area less than the minimum area.

modify/
contains commands used to modify the boundary mesh.

analyze-bnd-connectvty
finds and marks free edges and nodes and multiply-connected edges and nodes. This process is neces-
sary if the boundary mesh has been changed with Scheme functions.

clear-selections
clears all selections.

clear-skew-faces
clears faces that were marked using the mark-skew-face command.

collapse
collapses pairs of nodes, edge(s), or face(s). If a pair of nodes is selected, both the nodes are deleted
and a new node is created at the midpoint of the two nodes. If a triangular face is selected, the complete
face is collapsed into a single node at the centroid of the face.

create
creates a boundary face if the selection list contains 3 nodes and an optional zone. If the selection list
contains positions, then nodes are created.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 19
boundary/

create-mid-node
creates a node at the midpoint between two selected nodes.

delete
deletes all selected faces and nodes.

delta-move
moves the selected node by specified magnitude.

deselect-last
removes the last selection from the selection list.

hole-feature-angle
specifies the feature angle for consideration of holes in the geometry.

list-selections
lists all of the selected objects.

local-remesh
remeshes marked faces or faces based on selections in the graphics window. Select the faces to be
remeshed and specify the sizing source (constant-size, geometry, or size-field), the number
of radial layers of faces to be remeshed (rings), the feature angle to be preserved while remeshing
the selected faces, and the size for constant size remeshing (if applicable).

mark-skew-face
marks faces that should be skipped when the worst skewed face is reported using the Modify
Boundary dialog box. This enables you to search for the next skewed face.

merge
merges pairs of nodes. The first node selected is retained, and the second is the duplicate that is
merged.

move
moves the selected node to the selected position if the selection list contains a node and a position.

next-skew
finds the triangular face of nearest lower skewness value than that of the worst skewed face. The face
ID, its skewness, the longest edge ID, and the node ID opposite to the longest edge are displayed in
the console.

repair
repairs zones by filling all holes associated with free faces. Specify the face zones for the repair operation.

repair-options/
contains

rezone
moves the selected faces from their current zone into the selected zone, if the selection list contains
a zone and one or more faces.

select-entity
adds a cell, face, or node to the selection list by entering the name of the entity.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
20 of ANSYS, Inc. and its subsidiaries and affiliates.
select-filter
selects a filter. The possible filters are off, cell, face, edge, node, zone, position, object,
and size. If off is chosen, then when a selection is made, it is first checked to see if it is a cell, then
a face, an edge, and so on. When the node filter is used, and if a cell or face is selected, the node closest
to the selection point is picked. Thus, the nodes do not have to be displayed, to be picked.

select-position
adds a position to the selection list by entering the coordinates of the position.

select-probe
selects the probe function. The possible functions are:

• box enables the selection of a group of entities within a box, to be used in conjunction with
boundary modification functions.

• label prints the selection label in the graphics window

• off disables the mouse probes.

• polygon enables the selection of a group of entities within a polygonal region, to be used in con-
junction with boundary modification functions.

• print prints the information on the selection in the console window.

• select adds the selection to the selection list

select-visible-entities?
enables you to select only visible entities (nodes, edges, faces, zones, objects) when the box select or
polygon select options are used. Ensure that the model is zoomed to an appropriate level for correct
selection.

Tip

To quickly revert to the behavior of R16.1 or earlier, enable transparency.

Note

• If the mesh is not connected, all entities (nodes, edges, faces, zones, objects) will be se-
lected irrespective of whether they are visible or not.

• This visual selection behavior works only on local displays and may generate warning
messages when attempting selection on a remote system.

select-zone
adds a zone to the selection list by entering the zone name or ID.

show-filter
shows the current filter.

show-probe
shows the current probe function.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 21
boundary/

skew
finds the face with the highest (worst) skewness, selects it in the graphics window, and reports its
skewness and zone ID in the console window.

skew-report-zone
enables you to select the zone for which you want to report the skewness. You can either specify zone
name or zone ID.

smooth
uses Laplace smoothing to modify the position of the nodes in the selection list. It moves the selected
node to a position computed from an average of its node neighbors. The new position is an average
of the neighboring node coordinates and is not reprojected to the discrete surface.

split-face
splits two selected faces into four faces.

swap
swaps boundary edges (of triangular faces) if the selection list contains edges.

undo
undoes the previous operation. When an operation is performed, the reverse operation is stored on
the undo stack. For example, a create operation places a delete on the stack, and a delete adds a create
operation.

The undo operation requires that the name of the object exist when the action is undone. If
the name does not exist, then the undo will fail. You can undo the last few operations, but if
many operations are being performed it is recommended that you also save the mesh periodically.

orient-faces-by-point
orients the normals based on the specified material point.

print-info
prints information about the grid in the text window.

project-face-zone
projects nodes on a selected face zone onto a target face zone. Projection can be performed based on
normal direction, closest point, or specified direction.

recover-periodic-surfaces
restores the rotational periodic relationship between face zones. You will be prompted for method (auto-
matic or manual) and for face zones. Periodicity information (angle, pivot point, axis of rotation) are read
in with the mesh file.

refine/
discusses the commands used to refine the boundary mesh.

auto-refine
automatically refines a face zone based on proximity. The original face zone is treated as a background
mesh. Faces are refined by multiple face splitting passes, so that no face is in close proximity to any
face in the current domain.

clear
clears all refinement marks from all boundary faces.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
22 of ANSYS, Inc. and its subsidiaries and affiliates.
 count
counts the number of faces marked on each boundary zone.

limits
prints a report of the minimum and maximum size of each specified zone. This report will also tell you
how many faces on each zone have been marked for refinement.

local-regions
enters the local refinement menu.

define
defines the refinement region according to the specified parameters.

delete
deletes the specified region.

init
creates a region encompassing the entire geometry.

list-all-regions
lists all the refinement regions in the console.

mark
marks the faces for refinement.

refine
refines the marked faces.

remesh/
has a set of commands for remeshing the face zones.

clear-marked-faces
clears the highlighting of the triangles that are marked.

coarsen-and-refine
remeshes (coarsens/refines) the boundary face zones based on the computed size field. Specify the
boundary face zones to be remeshed, the boundary edge zones, feature angle, and corner angle. Ad-
ditionally, specify whether the current boundary face zones should be replaced by the remeshed face
zones after the operation is complete.

controls/
enters the edge loop tools text menu.

delete-overlapped?
toggles the deletion of region of overlap of the two surfaces.

direction
specifies the direction of the edge loop projection.

intersect/
enters the intersect control menu.

absolute-tolerance?
enables you to switch between the use of absolute and relative tolerance. By default, the relative
tolerance value is used.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 23
boundary/

delete-overlap?
enables/disables the deletion of overlapped edges. It toggles the automatic deletion of region
of overlap of the two surfaces. This option is used by while remeshing overlapping zones and
retriangulating prisms. By default, this option is enabled.

feature-angle
specifies the minimum feature angle that should be considered while retriangulating the
boundary zones. All the edges in the zone having feature angle greater than the specified
feature angle are retained. This option is useful for preserving the shape of the intersecting
boundary zones. The default value of feature angle is 40, however, a value in the range of
10–50 degrees is recommended. A large value may distort the shape of the intersecting
boundary zones.

ignore-parallel-faces?
Default is yes. If there are close-to-parallel faces, set to no to separate the zones and avoid
creating an intersection loop.

join-match-angle
specifies the allowed maximum angle between the normals of the two overlapping surfaces
to be joined. This parameter is used to control the size of the join region.

join-project-angle
specifies the allowed maximum angle between the face normal and the project direction for
the overlapping surfaces to be joined. This parameter is used to control the size of the join re-
gion.

refine-region?
enables you to refine the regions that are modified during the intersect operations. It toggles
the refinement of the intersecting regions after performing any of the intersection operation.

This operation improves the quality of the resulting mesh, however, this option is disabled
by default.

remesh-post-intersection?
used to enable or disable automatic post-remesh operation after any connect operation (join,
intersect, or stitch).

retri-improve?
enables you to improve the mesh. After performing any intersection operation, the slivers are
removed along the curve of intersection, Laplace smoothing is performed, and followed by
the edge swapping. Laplace smoothing is also performed for insert-edge-zone, remesh-
overlapped-zones, and prism-retriangulation options. Smoothing is performed
again. The smooth-swap operations can be controlled by changing the various defaults such
as swapping iterations, smoothing iterations, etc.

separate?
enables the automatic separation of intersected zones.

stitch-preserve?
indicates that shape of the first zone specified is to be preserved. This option is enabled by
default.

tolerance
specifies the tolerance value for the intersect operations.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
24 of ANSYS, Inc. and its subsidiaries and affiliates.
 within-tolerance?
performs the intersection operation only within the specified tolerance value. It is useful only
for the Intersect option.

project-method
specifies the method for projecting edge loops.

proximity-local-search?
includes the selected face for proximity calculation.

quadratic-recon?
enables/disables quadratic reconstruction of edge loops.

remesh-method
specifies the method to be used for the node distribution on the edge loop.

spacing
sets the node spacing for the edge loop.

tolerance
sets the tolerance for determining if two edges intersect.

create-all-intrst-loops
creates edge loop of intersection for all boundary zones in current domain.

create-edge-loops
creates edge loops for a specified face zone, based on feature angle.

create-intersect-loop
creates an interior edge loop at the intersection between two adjacent face zones. Edges created in
this way will not be remeshed by default.

create-join-loop
creates edge loop on boundary of the region of overlap of two surfaces.

create-stitch-loop
creates edge loops for connecting two surfaces along their free edges.

delete-overlapped-edges
deletes edges that overlap selected edge loops.

faceted-stitch-zones
performs the faceted stitching of zones.

insert-edge-zone
inserts an edge zone into a triangulated boundary face zone.

intersect-all-face-zones
remeshes all the intersecting face zones.

After the intersect operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 25
boundary/

intersect-face-zones
remeshes two intersecting face zones so that they become conformal.

After the intersect operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

join-all-face-zones
connects all overlapping face zones using the join operation.

After the join operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

join-face-zones
connects two overlapping faces.

After the join operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

mark-intersecting-faces
highlights the triangles in the neighborhood of the line of intersection.

mark-join-faces
highlights the triangles in the neighborhood of the join edge loop.

mark-stitch-faces
highlights the triangles in the neighborhood of the stitch edge loop.

remesh-face-zone
remeshes a specified face zone by automatically extracting edge loops. If edge loops are present in
the current domain (for example, if they were created using the create-edge-loops command),
they are used to remesh the specified face zone.

remesh-constant-size
remeshes the specified face zones to a constant triangle size while maintaining conformity with adjacent
zones. Specify the boundary face zones to be remeshed, the boundary edge zones, feature angle,
corner angle, and the constant size. Additionally, specify whether the current boundary face zones
should be replaced by the remeshed face zones after the operation is complete.

remesh-face-zones-conformally
remeshes face zones using the current size function and keeping a conformal interface between them.
If no size function is defined, an error message will be generated.

This command will prompt for:

• Boundary Face Zones

• Boundary Edge Zones

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
26 of ANSYS, Inc. and its subsidiaries and affiliates.
 • feature angle – used to determine the minimum angle between features that will be
preserved during remeshing

• corner angle – used to specify the minimum angle between feature edges that will be
preserved

• Replace Face Zone? – (default is Yes) the remeshed face zone(s) will take the name and
-id of the original zones, and the original face zone(s) will have “orig” appended to their name.
If No, the remeshed face zone(s) will have “retri” added postfix.

Note

Periodic face zones cannot be remeshed using this command.

remesh-overlapping-zones
remeshes overlapping face zones. The non-overlapping region is remeshed using the edge loops created
from the overlapping face zones.

size-functions
enters the size functions menu where you can define size functions for controlling mesh size distribution.

compute
computes the size field based on the defined parameters.

contours/
contains options for displaying contours of size functions.

draw
displays contours in the graphics window. Compute the size field using /size-func-
tions/compute or read in a size field file prior to displaying the contours of size.

set/refine-facets?
enables you to specify smaller facets if the original are too large. Default is no.

create
defines the size function based on the specified parameters.

create-defaults
creates default size functions based on face and edge curvature and proximity.

delete
deletes the specified size function or the current size field.

delete-all
deletes all the defined size functions.

disable-periodicity-filter
removes periodicity from the size field.

list
lists all the defined size functions and the parameter values defined.

reset-global-controls
resets the global controls to their default values.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 27
boundary/

set-global-controls
sets the values for the global minimum and maximum size, and the growth rate.

set-periodicity-filter
applies periodicity to the size field by selecting one source face zone.

Note

Ensure that periodicity is previously defined.

Only rotational periodicity is supported, translational periodicity is not supported

currently.

set-prox-gap-tolerance
sets the tolerance relative to minimum size to take gaps into account. Gaps whose thickness is less
than the global minimum size multiplied by this factor will not be regarded as a proximity gap.

set-scaling-filter
specifies the scale factor, and minimum and maximum size values to filter the size output from
the size field.

triangulate-quad-faces?
identifies the zones comprising non-triangular elements and uses a triangulated copy of these
zones for computing the size functions.

use-cad-imported-curvature?
enable/disable curvature data from the nodes of the CAD facets.

stitch-all-face-zones
connects (stitches) all the face zones along the free edges.

After the stitch operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

stitch-face-zones
connects two surfaces along their free edges.

After the stitch operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

/boundary/remesh/controls/intersect/remesh-post-intersection? no

stitch-with-preserve-boundary
connects (stitches) a zone to another which is connected to an existing volume mesh, while preserving
the boundary of the zones connected to the volume mesh. Specify a list of boundary zones to be
preserved, a list of the boundary zones to be connected to each of these zones, and the tolerance
value.

After the stitch operation, remesh is called automatically. To disable the post-remesh operation,
use the text command:

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
28 of ANSYS, Inc. and its subsidiaries and affiliates.
 /boundary/remesh/controls/intersect/remesh-post-intersection? no

Note

This command will not work for overlapping or partially overlapping face zones.

triangulate
triangulates quad zones.

reset-element-type
resets the element type (mixed, tri, or quad) of a boundary zone. If you have separated a mixed (tri and
quad) face zone into one tri face zone and one quad face zone, for example, each of these will be identified
as a “mixed" zone. Resetting the element type for each of these new zones will identify them as, respectively,
a triangular zone and a quadrilateral zone.

resolve-face-intersection
resolves self intersection on manifold surface meshes.

scale-nodes
applies a scaling factor to all node coordinates. You can use this command to change the units of the grid.

separate/
contains options for separating face zones.

local-regions
enters the local refinement menu.

define
enables you to define the local region.

delete
deletes the specified local region.

init
creates a region encompassing the entire geometry.

list-all-regions
lists all the local regions defined.

mark-faces-in-region
marks the faces that are contained in a specified local refinement region.

sep-face-zone-by-angle
separates a boundary face zone based on significant angle.

sep-face-zone-by-cnbor
separates a boundary/interior face zone based on its cell neighbors.

sep-face-zone-by-mark
separates a boundary face zone by moving marked faces to a new zone.

sep-face-zone-by-region
separates a boundary face zone based on contiguous regions.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 29
boundary/

sep-face-zone-by-seed
separates a boundary face zone by defining a seed face on the surface.

sep-face-zone-by-seed-angle
separates faces connected to the seed face, whose normal fall within the specified cone.

sep-face-zone-by-shape
separates a boundary face zone based on the shape of the faces (triangular or quadrilateral).

set-periodicity
defines the rotational periodicity parameters. You will be prompted for angle and axis of rotation parameters.

slit-boundary-face
slits a boundary face zone by duplicating all faces and nodes, except those nodes that are located at the
edges of the boundary zone. A displacement can be specified to provide thickness to the boundary. The
slit command only works when it is possible to move from face to face using the connectivity provided by
the cells.

You should slit the boundary face after you generate the volume mesh so that cells will not be
placed inside the gap. There may be some inaccuracies when you graphically display solution data
for a mesh with a slit boundary in ANSYS Fluent.

smooth-marked-faces
smooths the marked faces.

unmark-selected-faces
unmarks the marked selected faces.

wrapper/
enters the surface wrapper menu.

delete-all-cells?
deletes the Cartesian mesh. This command is available only after initializing the Cartesian grid.

imprint-edges?
imprints the wrapper surface on recovered feature edges that you recover. This command is available
only after creating the wrapper surface.

initialize
creates a Cartesian mesh of the specified parameters.

local-regions/
enters the local refinement menu.

define
enables you to define the local refinement region.

delete
deletes the specified refinement region.

init
creates a region encompassing the entire geometry.

list-all-regions
lists all the refinement regions in the console.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
30 of ANSYS, Inc. and its subsidiaries and affiliates.
 refine
refines the specified region according to the refinement parameters specified.

post-improve
enters the wrapper surface improvement options menu.

auto-post-improve
improves the wrapper surface using a pre-defined sequence of operations.

auto-post-wrap
performs a pre-defined sequence of post-wrapping operations on the wrapper surface.

coarsen-wrapper-surf
coarsens the wrapper surface.

filterout-far-features
deletes feature edges beyond the specified distance from the wrapper surface.

imprint-geom-surf
imprints the geometry threads on wrapper (manual zone recovery).

improve
improves the wrapper surface quality based on skewness, size change, or aspect ratio.

inflate-thin-regions
pushes apart the overlapping faces in thin regions.

post-single-surface
cleans up unmerged island regions after recovering the single surface.

recover-single-surface
recovers thin surfaces as a single surface after wrapping.

recover-zone
separates the wrapper surface into zones based on the original geometry.

remove-crossover-config
removes crossover configurations.

remove-duplicated-nodes
removes the duplicate nodes on the wrapper surface.

rename-wrapper-zones
renames the wrapper zones by specifying an appropriate prefix instead of the default prefix (wrap-).

resolve-nonmanifoldness
resolves non-manifold configurations on the wrapper surface.

resolve-self-intersection
removes the self intersecting faces.

rezone
smooths the zones separated from the wrapper surface for better representation of the geometry.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 31
boundary/

smooth-folded-faces
smooths the folded faces on the wrapper surface.

smooth-wrapper-surf
smooths the wrapper surface.

swap-wrapper-surf
swaps the nodes of the wrapper surface to improve its quality.

pre-smooth?
enable/disable smoothing of nodes during wrapping. This command is available only after initializing
the Cartesian grid.

region/
enters the regions menu. This command is available only after initializing the Cartesian grid.

draw-holes
draws the holes detected.

delete-interface
deletes the existing interface.

extract-enclosing-region
extracts the interface for the region enclosing the specified point.

extract-interface
extracts the interfaces for the specified regions.

fix-holes
fixes the specified hole(s).

list-holes
lists the existing holes.

list-interfaces
lists the existing interfaces.

list-regions
lists the regions created during the wrapper initialization.

merge-interior-regions
merges all the interior regions. After using this command, two regions will remain, the exterior
and the merged interior region.

merge-regions
merges the specified regions.

modify-region-holes
enables you to fix or open holes related to the specified region.

open-holes
opens the specified hole(s).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
32 of ANSYS, Inc. and its subsidiaries and affiliates.
 refine
refines the Cartesian grid based on the zone specific sizes and local size functions. This command
is available only after initializing Cartesian grid.

refine-enclosing-region
refines the region enclosing the specified point.

refine-region
refines the specified region.

refine-zone-cells
refines the cells associated with the specified boundary zone. This command is available only after
initializing the Cartesian grid.

update-regions
updates the regions to account for the changes made to the original geometry (during manual
hole fixing).

wrap-enclosing-region
generates the wrapper surface for the region enclosing the specified point.

wrap-interface
generates the wrapper surface for the specified interface.

wrap-region
generates the wrapper surface for the specified region. This command is available only after initial-
izing the Cartesian grid.

wrapper-region-at-location
reports the region at the specified location.

set/
enters the menu to set cell parameters.

auto-draw-sizes
enables you to draw zone-specific sizes.

clear-size
clears all the zone specific size parameters.

curvature-factor
enables you to modify curvature size function sensitivity of a wrapper.

curvature?
enables you to enable or disable curvature size function.

default-face-size
enables you to specify default face size for Cartesian grid.

feature-threshold
enables you to specify critical range within which the nodes of the wrapper will be projected onto
the feature edges.

ignore-feature-skewness
specifies the critical skewness to be considered for ignoring feature lines.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 33
boundary/

ignore-self-proximity?
enable/disable the self-proximity calculation during the refinement.

list-size
lists the current zone specific sizes of the domain.

local-size-function
enables you to set local size functions.

max-refine-level
specifies the maximum refinement level permitted.

maximum-size-level
specifies the refinement level of the largest cell in the Cartesian grid.

minimum-proximity-gap
specifies the minimum proximity gap within which the proximity will be ignored.

minimum-size-level
specifies the refinement level of the smallest cell in the Cartesian grid.

number-of-size-boxes
controls the number of boxes to display, when using Draw Sizes button in the Face Size tab.

proximity-factor
enables you to modify proximity size function sensitivity of a wrapper.

proximity?
enable/disable proximity size function.

read-local-sizes
reads the zone specific sizes stated in a file.

refinement-buffer-layers
specifies the number of additional cell layers that you want to refine.

relative-island-count
specifies a critical cell count of noise zones in a zone separation.

volume-marker
offers a volume marker manipulation for holes.

write-local-sizes
writes the zone specific sizes in a file.

zone-specific-size
enables you to specify zone specific sizes.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
34 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 4: cad-assemblies/
add-prefix
enables you to add a prefix to the selected entities. Specify the path for the entities and the prefix to be
added.

add-to-object
enables you to add the selected CAD entities to an existing object. Specify the path for the entities to be
added and select the object to be modified.

create-objects
enables you to create new geometry/mesh objects for the selected entities. Specify the path for the entities
and if required, choose to create one object per CAD entity selected and/or retain the CAD zone granularity
for object creation. By default, a single object will be created for all entities selected and the CAD zone
granularity will not be retained. Specify the object name (if applicable), object type (geom or mesh), and
cell zone type (dead, fluid, or solid).

delete-cad-assemblies
deletes all the CAD assemblies data.

draw
displays the selected CAD entities.

draw-options/
contains additional options for displaying CAD entities.

add-to-graphics
adds the selected entities to the display in the graphics window.

draw-unlabelled-zones
displays the unlabeled zones for the selected entities in the graphics window.

remove-from-graphics
removes the selected entities from the display in the graphics window.

extract-edge-zones
enables you to extract the feature edge zone for the selected entities. Specify the path for the CAD entities
and the feature angle.

labels/
contains options for displaying and managing labels.

add-to-graphics
adds the selected labels to the display in the graphics window.

delete
deletes the selected labels.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 35
cad-assemblies/

draw
displays the selected labels.

remove-from-graphics
removes the selected labels from the display in the graphics window.

rename
enables you to rename the selected labels. Specify the path for the labels and the new name. For
multiple selections, the specified name will be used, with a suitable index as suffix. For example, spe-
cifying a new label name wall will result in entities wall.1, wall.2, etc.

manage-state/
contains options for setting the CAD entity state.

suppress
suppresses the selected CAD entities.

unlock
unlocks the selected CAD entities.

unsuppress
unsuppresses the selected CAD entities.

rename
enables you to rename the selected entities. Specify the path for the entities and the new name. For multiple
entities, the specified name will be used, with a suitable index as suffix. For example, specifying a new
name wall will result in entities wall.1, wall.2, etc.

replace-object
enables you to replace an object with the selected CAD entities. Specify the path for the entities to be
added and select the object to be modified.

update-cad-assemblies
reimports the selected CAD entities using new parameters specified in the update-options/ menu.

update-options/
contains options for updating the CAD entities on reimport.

import-edge-zones?
enables you to import edge zones from the CAD entities on reimport. Specify an appropriate value for
feature angle.

one-object-per
enables you to change the CAD object granularity on reimport.

one-zone-per
enables you to change the CAD zone granularity on reimport.

tessellation
enables you to control the tessellation (faceting) during reimport. You can select either cad-faceting
or cfd-surface-mesh.

CAD faceting enables you to control the tessellation based on the CAD faceting tolerance and
maximum facet size specified.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
36 of ANSYS, Inc. and its subsidiaries and affiliates.
CFD Surface Mesh enables you to use a size field file during reimport. If you enter yes, specify
the size field file to be read. If you do not want to use a size field file, you can obtain conformal
faceting based on the underlying curve and surface curvature (using the minimum and maximum
facet sizes, and the facet curvature normal angle specified) and edge proximity (using the cells
per gap specified). You can also save the size field in a file (size field is computed based on the
specified parameters; that is, Min Size, Max Size, Curvature Normal Angle, Cells Per Gap).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 37
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
38 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 5: diagnostics/
face-connectivity/
contains options for fixing problems with face connectivity on the specified object face zones or boundary
face zones.

add-label-to-small-neighbors
separates island object face zones from all connected neighbors and merges them to the connected
neighboring face zone label based on minimum face count specified.

fix-deviations
fixes deviations in the wrapped surface mesh by imprinting edges on the wrapped face zones. Specify
the number of imprint iterations and aggressive imprint iterations to be performed.

fix-duplicate-faces
removes duplicate faces.

fix-free-faces
removes free faces by the method selected. The methods available are:

delete-free-edge-faces
removes free faces having the specified number of free edges.

delete-fringes
removes free face fringes based on the face count specified.

delete-skewed-faces
removes free faces based on the minimum skewness specified.

merge-nodes
removes free faces by merging nodes within the tolerance specified.

stitch
removes free faces based on the tolerance and number of steps specified.

fix-invalid-normals
fixes invalid normals by smoothing.

Note

Zone-specific or scoped prism settings should be applied prior to using this command.

fix-islands
deletes groups of island faces based on the absolute face count specified.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 39
diagnostics/

fix-multi-faces
fixes multiply connected faces by a combination of deleting face fringes, overlapping faces, and dis-
connected faces. Specify the maximum number of fringe faces, overlapping faces, and multiply con-
nected edges, respectively.

fix-point-contacts
fixes non-manifold configurations by removing point contacts.

fix-self-intersections
fixes self intersecting or folded faces. For fixing folded faces by smoothing, specify whether features
should be imprinted.

fix-slivers
fixes faces based on skewness and height criteria. Height is the perpendicular distance between the
longest edge of the triangle and the opposite node.

fix-spikes
fixes spiked faces based on the spike angle specified.

fix-steps
fixes step configurations by smoothing or collapsing faces based on the angle and step width specified.

remove-label-from-small-neighbors
removes disconnected island object face zone labels by merging the specified island object face zones
to the connected neighboring face zone label based on minimum face count specified.

quality/
contains options for fixing problems related to surface mesh quality on the specified object face zones or
boundary face zones.

collapse
collapses bad quality faces based on area or skewness. For collapsing based on face area, specify the
maximum face area and relative maximum area. For collapsing based on face skewness, specify the
minimum skewness and feature angle. Additionally, specify the number of iterations and whether the
boundary should be preserved.

delaunay-swap
improves the surface mesh by swapping based on the minimum skewness value and feature angle
specified. Additionally, specify the number of iterations and whether the boundary should be preserved.

general-improve
improves the surface mesh based on aspect ratio, size change, or skewness. Specify the minimum
quality value, feature angle, number of iterations, and whether the boundary should be preserved.

smooth
improves the surface mesh by smoothing. Specify the number of smoothing iterations and whether
the boundary should be preserved.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
40 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 6: display/
all-grid
displays the grid according to the currently set parameters.

annotate
adds annotation text to a graphics window. It will prompt you for a string to use as the annotation text,
and then a dialog box will prompt you to select a screen location using the mouse-probe button on your
mouse.

boundary-cells
displays boundary cells attached to the specified face zones.

boundary-grid
displays only boundary zones according to the currently set parameters.

center-view-on
sets the camera target to be the center (centroid) of an entity.

clear
clears the active graphics window. This option is useful when you redo an overlay.

clear-annotation
removes all annotations and attachment lines from the active graphics window.

draw-cells-using-faces
draws cells that are neighbors for the selected faces.

draw-cells-using-nodes
draws cells that are connected to the selected nodes.

draw-face-zones-using-entities
draws cells that are connected to the selected entities.

draw-zones
draws the boundary/cell zones using the zone ID specified as input.

objects/
contains commands for displaying objects.

display-neighborhood
displays the objects that are in the neighborhood of the selected object. The neighboring objects have
to be in contact, or intersecting the selected object.

display-similar-area
displays the objects with similar area to the selected object area.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 41
display/

explode
explodes the objects in the geometry. (This command is valid only when the geometry is an assembled
mode.)

hide-objects
hides the selected objects in the display.

implode
implodes or assembles the objects in the geometry. (This command is available only when the geometry
is an exploded mode.)

isolate-objects
displays only the selected objects.

make-transparent
makes the geometry transparent so that internal objects are visible. This command works as a toggle
undoing the transparency of the previously selected objects.

select-all-visible
selects all the visible objects in the graphics window.

show-all
unhides all the objects in the geometry and displays them.

toggle-color-mode
toggles the colors of the geometry. In one mode geometry is colored object-wise while in the other
mode it is colored zone-wise.

toggle-color-palette
toggles the color palette of the geometry.

redisplay
redraws the grid in the graphics window.

save-picture
saves a picture file of the active graphics window.

set-grid/
contains options controlling the display of the grid.

all-cells?
enables/disables the display of all cells.

all-faces?
enables/disables the display of all faces.

all-nodes?
enables/disables the display of all nodes.

cell-quality
sets the lower and upper bounds of quality for cells to be displayed. Only cells with a quality measure
value (for example, skewness) within the specified range will be displayed.

default
resets the grid display parameters to their default values.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
42 of ANSYS, Inc. and its subsidiaries and affiliates.
face-quality
sets the lower and upper bounds of quality for faces to be displayed. Only faces with a quality measure
value (for example, skewness) within the specified range will be displayed.

free?
enables/disables the drawing of faces/nodes that have no neighboring face on at least one edge.

label-alignment
sets the alignment of labels that appear in the graphics window. By default, the label is centered on
the node, cell, and so on, to which the label refers. You can specify *,ˆ, v, <, > for center, top,
bottom, left, or right. You can also combine symbols—for example, "*v" for bottom center.

label-font
sets the label font. By default, all labels appear in “sans serif" font. Some other choices are roman,
typewriter, and stroked.

label-scale
scales the size of the label.

labels?
enables/disables the display of labels.

left-handed?
enables/disables the display of left-handed faces.

list
lists all the grid display settings.

marked?
enables/disables the display of marked nodes.

multi?
enables/disables the display of those faces/nodes that have more than one neighboring face on an
edge.

neighborhood
sets the x, y, and z range to be within a specified neighborhood of a specified grid object.

node-size
sets the node symbol scaling factor.

node-symbol
specifies the node symbol.

normal-scale
sets the scale factor for face normals.

normals?
enables/disables the display of face normals.

refine?
enables/disables the display of those faces that have been marked for refinement.

tagged?
enables/disables the display of tagged nodes.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 43
display/

unmeshed?
enables/disables the display of nodes and faces that have not been meshed.

unused?
enables/disables the display of unused nodes.

x-range
limits the display of grid objects to the specified x-range.

y-range
limits the display of grid objects to the specified y-range.

z-range
limits the display of grid objects to the specified z-range.

set-list-tree-separator
sets the separator character to be used to determine the common prefix for items listed in the selection
lists, when the tree view is used.

set/
Enables you to enter the set menu to set the display parameters.

colors/
enables you to enter the colors options menu.

axis-faces
sets the color of axisymmetric faces.

background
sets the background (window) color.

color-by-type?
enables you to specify that the entities should be colored by their type or ID.

color-by-partition?
enables you to view the partitions by color. This command applies to parallel processing.

color-scheme
enables you to set the color scheme. You can select either the classic or the workbench
scheme.

far-field-faces
sets the color of far field faces.

foreground
sets the foreground (text and window frame) color.

free-surface-faces
sets the color of free surface faces.

highlight-color
sets the highlight color.

inlet-faces
sets the color of the inlet faces.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
44 of ANSYS, Inc. and its subsidiaries and affiliates.
 interface-faces
sets the color of grid interface faces.

interior-faces
sets the color of the interior faces.

internal-faces
sets the color of the internal interface faces.

list
lists the colors available for the selected zone type.

outlet-faces
sets the color of the outlet faces.

overset-faces
sets the color of the overset faces.

periodic-faces
sets the color of periodic faces.

rans-les-interface-faces
sets the color of RANS/LES interface faces.

reset-colors
resets the individual grid surface colors to the defaults.

reset-user-colors
resets individual grid surface colors to the defaults.

show-user-colors
lists the current defined user colors.

skip-label
sets the number of labels to be skipped in the colormap scale.

surface
sets the color of surfaces.

symmetry-faces
sets the color of symmetric faces.

traction-faces
sets the color for traction faces.

user-color
enables you to change the color for the specified zone.

wall-faces
sets color for wall faces.

edges?
enables/disables the display of face/cell edges.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 45
display/

filled-grid?
enables/disables the filled grid option. When a grid is not filled, only its outline is drawn.

lights/
enters the lights menu.

headlight-on?
turns the light that moves with the camera on/off.

lighting-interpolation
sets the lighting interpolation method to be used. You can choose flat, gouraud, or phong.
The first one is the most basic method, and the others are more sophisticated and provide
smoother gradations of color.

lights-on?
enables/disables the display of all lights.

set-ambient-color
sets the ambient color for the scene. The ambient color is the background light color in scene.

set-light
adds or modifies a directional, colored light.

line-weight
sets the line width factor for the window.

mouse-buttons
prompts you to select a function for each of the mouse buttons.

native-display-defaults
resets graphics window parameters to optimal settings for a local display.

Used after setting parameters for a remote display with remote-display-defaults.

overlays?
turns overlays on and off.

picture/
saves a hardcopy file of the active graphics window.

color-mode/
contains the available color modes.

color
selects full color and plots the hardcopy in color.

gray-scale
selects gray scale (i.e., various shades of gray) and converts color to gray-scale for hardcopy.

list
displays the current hardcopy color mode.

mono-chrome
selects color to monochrome (black and white) for hardcopy.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
46 of ANSYS, Inc. and its subsidiaries and affiliates.
dpi
specifies the resolution in dots per inch for EPS and PostScript files.

driver/
contains the available hardcopy formats.

dump-window
sets the command to dump a graphics window to a file.

eps
sets the Encapsulated PostScript format.

jpeg
sets the JPEG image format.

list
displays the current hardcopy format.

options
enables you to set hardcopy options, such as landscape orientation, pen speed, and physical
size. The options may be entered on one line if you separate them with commas.

png
sets the PNG image format.

post-format/
contains commands for setting the PostScript driver format and save files in PS files that can
be printed quickly.

fast-raster
enables a raster file that may be larger than the standard raster file, but will print much
more quickly.

raster
enables the standard raster file.

rle-raster
enables a run-length encoded raster file that will be about the same size as the standard
raster file, but will print slightly more quickly. This is the default file type.

vector
enables the standard vector file.

post-script
sets the PostScript format.

ppm
sets the PPM format.

tiff
sets the TIFF format.

vrml
sets the VRML format.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 47
display/

invert-background?
enables/disables the exchange of foreground/background colors for hardcopy files.

landscape?
toggles between landscape or portrait orientation.

preview
applies the settings of the color-mode, invert-background, and landscape options to the currently
active graphics window to preview the appearance of printed hardcopies.

x-resolution
sets the width of the raster format images in pixels (0 implies that the hardcopy should use the
same resolution as the active graphics window).

y-resolution
sets the height of the raster format images in pixels (0 implies that the hardcopy should use the
same resolution as the active graphics window).

re-render
re-renders the current window after modifying the variables in the set menu.

remote-display-defaults
adjusts graphics window parameters to optimal settings for a remote display.

Restore parameters for local display using native-display-defaults.

rendering-options/
contains the commands that enable you to set options that determine how the scene is rendered.

animation-option
enables you to specify the animation option as appropriate.

all
uses a solid-tone shading representation of all geometry during mouse manipulation.

wireframe
uses a wireframe representation of all geometry during mouse manipulation. This is the default
option.

auto-spin?
enables mouse view rotations to continue to spin the display after the button is released.

color-map-alignment
sets the color bar alignment.

device-info
prints out information about your graphics driver.

double-buffering?
enables or disables double buffering. Double buffering dramatically reduces screen flicker during
graphics updates. If your display hardware does not support double buffering and you turn this
option on, double buffering will be done in software. Software double buffering uses extra memory.

driver
specifies the current graphics driver.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
48 of ANSYS, Inc. and its subsidiaries and affiliates.
 null
no graphics driver.

opengl
changes the current graphics drive to OpenGL.

x11
changes the current graphics drive to X11.

face-displacement
sets the face displacement (in Z-buffer units along the camera Z-axis) for the displayed geometry
when both faces and edges are displayed simultaneously.

help-text-color
sets the color of the help text on the screen. You can select black, default, or white.

hidden-lines?
turns hidden line removal on or off. This command is available only when the color scheme is set
to classic.

hidden-lines-method/
enables you to select the hidden line removal algorithm.

mesh-display-hlr?
enables you to remove hidden lines for surfaces that are very close together. This option should
be used only if the default algorithm does not produce suitable results.

normal-hlr-algorithm
is the default hidden line removal algorithm.

hidden-surface-method/
enables you to choose from among the hidden surface removal methods that are supported. These
options (listed below) are display hardware dependent.

hardware-z-buffer
is the fastest method if your hardware supports it. The accuracy and speed of this method is
hardware dependent.

painters
will show less edge-aliasing effects than hardware-z-buffer. This method is often used
instead of software-z-buffer when memory is limited.

software-z-buffer
is the fastest of the accurate software methods available (especially for complex scenes), but
it is memory intensive.

z-sort-only
is a fast software method, but it is not as accurate as software-z-buffer.

hidden-surfaces?
enables/disables the display of hidden surfaces.

outer-face-cull?
enables/disables the display of outer faces.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 49
display/

set-rendering-options
sets the rendering options.

surface-edge-visibility
controls whether or not the mesh edges are drawn.

reset-graphics
resets the graphics system.

shrink-factor
sets shrinkage of both faces and cells. A value of zero indicates no shrinkage, while a value of one
would shrink the face or cell to a point.

styles/
contains commands for setting the display style for the different types of nodes and faces that can be
displayed.

cell-quality
indicates cells within the specified cell quality range.

cell-size
indicates cells within the specified cell size range.

face-quality
indicates faces within the specified face quality range.

face-size
indicates faces within the specified face size range.

free
indicates free nodes or faces.

left-handed
indicates faces that do not follow the right-hand rule with respect to their cell neighbors.

mark
indicates marked objects (for expert users).

multi
indicates multiply-connected nodes or faces.

refine
indicates boundary faces to be refined.

tag
indicates tagged objects (for expert users).

unmeshed
indicates unmeshed nodes or faces.

unused
indicates unused nodes or faces.

title
sets the problem title.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
50 of ANSYS, Inc. and its subsidiaries and affiliates.
windows/
enters the windows options menu, which contains commands that enable you to customize the relative
positions of sub-windows inside the active graphics window.

The menu structure for the axes, main, scale, text, video, and xy submenus is similar.

aspect-ratio
sets the aspect ratio of the active window.

axes/
enters the axes window options menu.

border?
sets whether or not to draw a border around the axes window.

bottom
sets the bottom boundary of the axes window.

clear
sets the transparency of the axes window.

left
sets the left boundary of the axes window.

right
sets the right boundary of the axes window.

top
sets the top boundary of the axes window.

visible?
controls the visibility of the axes window.

main/
enters the main view window options menu.

border?
sets whether or not to draw a border around the main viewing window.

bottom
sets the bottom boundary of the main viewing window.

left
sets the left boundary of the main viewing window.

right
sets the right boundary of the main viewing window.

top
sets the top boundary of the main viewing window.

visible?
controls the visibility of the main viewing window.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 51
display/

scale/
enters the color scale window options menu.

border?
sets whether or not to draw a border around the color scale window.

bottom
sets the bottom boundary of the color scale window.

clear?
sets the transparency of the color scale window.

font-size
sets the font size of the color scale window.

format
sets the number format of the color scale window (for example, %0.2e).

left
sets the left boundary of the color scale window.

margin
sets the margin of the color scale window.

right
sets the right boundary of the color scale window.

top
sets the top boundary of the color scale window.

visible?
controls the visibility of the color scale window.

text
enters the text window options menu.

application?
shows or hides the application name in the picture.

border?
sets whether or not to draw a border around the text window.

bottom
sets the bottom boundary of the text window.

clear?
enable or disable the transparency of the text window.

company?
shows or hides the company name in the picture.

date?
shows or hides the date in the picture.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
52 of ANSYS, Inc. and its subsidiaries and affiliates.
 left
sets the left boundary of the text window.

right
sets the right boundary of the text window.

top
sets the top boundary of the text window.

visible?
controls the visibility of the text window.

video/
contains options for modifying a video. This menu is not relevant for the meshing mode.

background
sets the background color of the graphics window. The color is specified as a string of three
comma-separated numbers between 0 and 1, representing red, green, and blue. For example,
to change the background from black (default) to gray, you would enter ".5,.5,.5" after selecting
the background command.

color-filter
set the video color filter. For example, to change the color filter from its default setting to PAL
video with a saturation of 80% and a brightness of 90%, you would enter
"video=pal,sat=.8,gain=.9" after selecting the color-filter command.

foreground
sets the foreground (text) color of the graphics window. The color is specified as a string of
three comma-separated numbers between 0 and 1, representing red, green, and blue. For ex-
ample, to change the foreground from white (default) to gray, you would enter ".5,.5,.5" after
selecting the foreground command.

on?
enables or disables the video picture settings.

pixel-size
sets the window size in pixels.

xy/
enters the XY plot window options menu.

border?
sets whether or not to draw a border around the XY plot window.

bottom
sets the bottom boundary of the XY plot window.

left
sets the left boundary of the XY plot window.

right
sets the right boundary of the XY plot window.

top
sets the top boundary of the XY plot window.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 53
display/

visible?
controls the visibility of the XY plot window.

update-scene/
contains commands that enable you to update the scene description.

delete
deletes the geometry selected using the select-geometry command.

display
displays the geometry selected using the select-geometry command.

draw-frame?
enables/disables the drawing of the bounding frame.

overlays?
enables/disables the overlays option.

select-geometry
enables you to select the geometry to be updated.

set-frame
enables you to change the frame options.

transform
enables you to apply the transformation matrix to the geometry selected using the select-geometry
command.

views/
enters the view window options menu.

auto-scale
scales and centers the current scene without changing its orientation.

camera/
contains commands to set the camera options.

dolly-camera
enables you to move the camera left, right, up, down, in, and out.

field
enables you to set the field of view (width and height) of the scene.

orbit-camera
enables you to move the camera around the target. Gives the effect of circling around the target.

pan-camera
gives you the effect of sweeping the camera across the scene. The camera remains at its position
but its target changes.

position
sets the camera position.

projection
lets you switch between perspective and orthographic views.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
54 of ANSYS, Inc. and its subsidiaries and affiliates.
 roll-camera
lets you adjust the camera up-vector.

target
sets the point the camera will look at.

up-vector
sets the camera up-vector.

zoom-camera
adjusts the camera’s field of view. This operation is similar to dollying the camera in or out of the
scene. Dollying causes objects in front to move past you. Zooming changes the perspective effect
in the scene (and can be disconcerting).

default-view
resets the view to front and center.

delete-view
deletes a particular view from the list of stored views.

last-view
returns to the camera position before the last manipulation.

list-views
lists all predefined and saved views.

read-views
reads views from an external view file.

restore-view
sets the current view to one of the stored views.

save-view
saves the currently displayed view into the list of stored views.

write-views
writes views to an external view file.

xy-plot/
enters the XY plot menu.

cell-distribution
plots a histogram of cell quality.

face-distribution
plots a histogram of face quality.

file
enables you to choose a file from which to create an xy plot.

set/
enters the set window options menu.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 55
display/

auto-scale?
sets the range for the x- and y-axis. If auto-scaling is not activated for a particular axis, you will be
prompted for the minimum and maximum data values.

background-color
sets the color of the field within the abscissa and ordinate axes.

file-lines
sets the parameters for plot lines.

file-markers
sets the parameters for data markers.

key
sets the visibility and title of the description box that displays the markers and/or lines with their
associated data. The key can be positioned and resized using the left mouse button.

labels
sets the strings that define the x- and y- axis labels.

lines
sets the pattern, weight, and color of the plot lines.

log?
enables/disables the log scaling on the x- and y-axis.

markers
sets parameters for the data markers.

numbers
sets the format and precision of the data numbers displayed on the x- and y-axis.

plot-to-file
enables you to write the xy plot values to a file.

rules
sets the visibility, line weight and color of the major and minor rules in the x- and y-axis directions.

windows
contains commands that enable you to customize the relative positions of sub-windows inside the
active graphics window.

border?
draws a border around the sub-window.

bottom
sets the bottom boundary of the sub-window.

left
sets the left boundary of the sub-window.

right
sets the right boundary of the sub-window.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
56 of ANSYS, Inc. and its subsidiaries and affiliates.
 top
sets the top boundary of the sub-window.

visible?
sets the visibility of the sub-window.

xy-percent-y?
enables/disables whether the y-coordinate should be scaled to show a percent of total values being
plotted.

zones/
contains commands for displaying zones.

display-neighborhood
displays the zones that are in the neighborhood of the selected zones. The neighboring zones have
to be in contact, or intersecting the selected zone.

display-similar-area
displays the zones with similar area to the selected zone area.

hide-zones
hides the selected zones in the display.

isolate-zones
displays only the selected zones.

make-transparent
makes the geometry transparent so that internal zones are visible. This command works as a toggle
undoing the transparency of the previously selected zones.

select-all-visible
selects all the visible zones in the graphics window.

show-all
unhides all the zones in the geometry and displays them.

toggle-color-mode
toggles the colors of the geometry. In one mode geometry is colored object-wise while in the other
mode it is colored zone-wise.

toggle-color-palette
toggles the color palette of the geometry.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 57
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
58 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 7: exit
exit
exits the program.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 59
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
60 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 8: file/
The user interface commands related to the File menu (such as reading files, importing files) and other
Select File dialog boxes do not work for the dual process build. You need to use the TUI commands
instead (for example, /file/read-mesh).

Important

• The host cannot be detached and reattached; once the connection is broken the data is lost. You
need to save the data if the machine must be shut down in between.

• All graphics information will be sent over the network, so initially it could take a long time to
assemble graphical information (especially if the host and remote server are across continents)
but after that the graphics manipulation is fast.

append-mesh
enables you to append the mesh files. This command is available only after a mesh file has been read in.

Append Rules:

• If zone names and IDs are duplicated, they will be modified and the changes will be reported in the
console.

• Domain information will be retained during the file append operation. If domain names are duplicated,
they will be modified and the changes will be reported in the console.

• Refinement region information will be retained during the file append operation. If region names are
duplicated, they will be modified and the changes will be reported in the console.

• You can append files comprising only edge zones (without face zones).

• Edge-face zone associations will be retained during the file append operation.

• Zone-specific prism parameter information will be retained during the file append operation.

append-meshes-by-tmerge
enables you to append the mesh files using the tmerge utility. This command is available only after a mesh
file has been read in.

confirm-overwrite?
controls whether attempts to overwrite existing files require confirmation.

If you do not want ANSYS Fluent to ask you for confirmation before it overwrites existing files, you
can enter the file/confirm-overwrite? text command and answer no.

file-format
enables/disables the writing of binary files.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 61
file/

filter-list
lists the names of the converters that are used to change foreign mesh (while importing mesh files from
third-party packages) files.

filter-options
enables you to change the extension (such as .cas, .msh, .neu) and arguments used with a specified filter.

For example, if you saved the PATRAN files with a .NEU extension instead of .neu, you can substitute
or add .NEU to the extension list. For some filters, one of the arguments will be the dimensionality
of the grid.

When you use the filter-options command for such a filter, you will see a default dimension-
ality argument of -d a. The dimension will automatically be determined, so you need not substitute
2 or 3 for a.

import/
enables you to import mesh information generated by some CAD packages (ANSYS, I-deas, NASTRAN,
PATRAN, and HYPERMESH), as well as mesh information in the CGNS (CFD general notation system) format.

These files are imported using the associated text commands listed here:

ansys-surf-mesh
enables you to read a ANSYS surface mesh file.

ansys-vol-mesh
enables you to read a ANSYS volume mesh file.

cad
enables you to import CAD files based on the options set.

• To import a single file (default), specify the file path and set up options for extracting features, im-
porting curvature data from CAD, and the length unit.

• To import multiple files, specify the directory path and pattern, and set up options for appending
the files, extracting features, importing curvature data from CAD and the length unit.

cad-geometry
enables you to import CAD files based on the options set.

• To import a single file (default), specify the file path. Set up options for the length unit, tessellation
method, and sizing parameters based on the tessellation method.

• To import multiple files, specify the directory path and pattern. Set up options for appending the
files, the length unit, tessellation method, and sizing parameters based on the tessellation method.

cad-options/
contains additional options for importing CAD files.

continue-on-error?
enables you to continue the import of the CAD file(s), despite errors or problems creating the fa-
ceting on certain surfaces, or other issues. This option is disabled by default.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
62 of ANSYS, Inc. and its subsidiaries and affiliates.
create-cad-assemblies?
enables creating the CAD Assemblies tree on CAD import. The CAD Assemblies tree represents
the CAD tree as it is presented in the CAD package in which it was created. All sub-assembly levels
from the CAD are maintained on import in Fluent Meshing.

For commands specific to the CAD assemblies, refer to cad-assemblies/ (p. 35)

derive-zone-name-from-object-scope?
enables zones without Named Selections to inherit the object name on import. This option is dis-
abled by default.

double-connected-face-label
adds the specified label to the name of double-connected face zones (face zones shared by two
bodies).

enclosure-symm-processing?
enables processing of enclosure and symmetry named selections during import. This option is
disabled by default. This option is applicable only to ANSYS DesignModeler (*.agdb) files.

extract-features?
enables feature extraction from the CAD model on import. You can choose to disable this, if desired.
Specify an appropriate value for feature angle. The default value is 40.

import-body-names?
enables import of Body names from the CAD files. This option is enabled by default.

Note

Any renaming of Body names in ANSYS Mechanical/ANSYS Meshing prior to the

export of the mechdat/meshdat files is ignored during import. Only original Body
names will be imported.

import-curvature-data-from-CAD?
enables importing of the curvature data from the nodes of the CAD facets. You can choose to disable
this, if desired.

import-part-names?
enables import of Part names from the CAD file(s). This option is enabled by default.

Note

Any renaming of Part names in ANSYS Mechanical/ANSYS Meshing prior to the

export of the mechdat/meshdat files is ignored during import. Only original Part
names will be imported.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 63
file/

merge-nodes?
enables the merging of geometry object nodes during CAD import. This option is enabled by default.

Note

This option can be optionally enabled/disabled only when geometry objects are
imported using the CAD Faceting option for CAD import. Mesh object nodes
will always be merged when the CFD Surface Mesh is selected for CAD import.

modify-all-duplicate-names?
enables you to modify all duplicate object/zone names by adding incremental integers as suffix.
This option is disabled by default.

For example: The CAD file contains multiple parts (or bodies) named heatshield.

• With the option disabled (default), the imported zones will be named heatshield, heatshield.1,
heatshield.2, etc.

• With the option enabled, the imported zones will be named heatshield.1, heatshield.2, heat-
shield.3, etc.

name-separator-character
allows you to specify the character used between name fields. Default is ':'.

named-selections
enables you to import Named Selections from the CAD file(s), including Named Selections from
ANSYS DesignModeler, publications from CATIA, and so on. You can additionally choose to ignore
import of certain Named Selections based on the pattern specified (for example, Layer* to ignore
layer Named Selections from CATIA), or by specifying multiple wild cards (for example, ^(Col-
or|Layer|Material).* to remove color, layer, and material Named Selections from CATIA).

Note

• Named Selections defined in ANSYS Meshing cannot be imported.

• If Named Selections is enabled, then Face named selections will be imported as face
zone labels.

object-type
enables the setting of object type on import. The options available are auto, geometry, and
mesh. The default setting is auto based on the tessellation method selected: geometry objects
will be created when the cad-faceting method is used, while mesh objects will be created
when the cfd-surface-mesh method is used.

one-face-zone-per
enables you to create one face zone per body/face/object to be imported.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
64 of ANSYS, Inc. and its subsidiaries and affiliates.
one-object-per
enables you to create one object per body/part/file/selection to be imported.

Note

For ANSYS ICEM CFD files (*.tin), set the object granularity to one object per se-
lection.

read-all-cad-in-subdirectories?
when enabled, all files in the specified directory as well as in its subdirectories will be imported.
This option is disabled by default.

save-PMDB?
saves a PMDB (*.pmdb) file in the directory containing the CAD files imported. You can use this
file to import the same CAD file(s) again with different options set, for a quicker import than the
full import. This option is disabled by default.

Note

Some options will not be available any more once the model is imported from
a PMDB file (for example, enclosure-symm-processing?), since they are
processed before the PMDB file is created.

separate-features-by-type?
enables separation of feature edges based on angle, connectivity, and named selections on import.
Edge zone names will have suitable suffixes depending on separation criteria, order of zones, ex-
isting zone names and other import options selected.

single-connected-edge-label
adds the specified label to the name of single-connected edge zones (edge zones referenced by
a single face).

strip-file-name-extension-from-naming?
removes the extension of the CAD files from the object/face zone names on import. This option is
disabled by default.

strip-path-prefix-from-names?
enables you to remove the path prefix from the object/face zone names on import. The default
setting is auto which removes the path prefix from object/face zone names when the object cre-
ation granularity is set to one object per file. You can also explicitly select yes or no.

tessellation
enables you to control the tessellation (faceting) during file import. You can select either cad-
faceting or cfd-surface-mesh.

CAD faceting enables you to control the tessellation based on the CAD faceting tolerance
and maximum facet size specified.

CFD Surface Mesh enables you to use a size field file, (Use size field file?). If you
enter yes, specify the size field file to be read. If you do not want to use a size field file,
you can obtain conformal faceting based on the underlying curve and surface curvature
(using the minimum and maximum facet sizes, and the facet curvature normal angle specified)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 65
file/

and edge proximity (using the cells per gap specified). You can also save a size field in a file
(size field is computed based on the specified parameters; that is, Min Size, Max Size,
Curvature Normal Angle, Cells Per Gap).

use-collection-names?
enables you to use the Named Selections for the object/zone names on import. Select auto, no,
or yes. The default selection is auto where the Named Selection will be used as the object/zone
name, except when the object creation granularity is set to one object per file.

use-component-names?
enables you to add the component (part or assembly) names to the object/zone names on import.
Select auto, no, or yes. The default selection is auto where the component name will be added
to the object/zone name.

use-part-names?
enables you to choose whether to add the part names from the CAD file to the object and zone
names on import. The default setting is auto which adds the part names to both object and zone
names when object creation granularity is set to body. When the object creation granularity is set
to part or file, the part names are not added to the zone names, face zone labels, or the region
names, by default. You can also explicitly select yes or no.

use-part-or-body-names-as suffix-to-named-selections?
enables you to modify zone names by using part or body names as suffixes to the Named Selections
spanning multiple parts/bodies. This option is enabled by default.

For example: The CAD file contains a Named Selection effusion with part (or body) names
id_liner and od_liner.

• With the option enabled (default), the imported zones will be named effusion:id_liner and ef-
fusion:od_liner.

• With the option disabled, the imported zones will be named effusion.1 and effusion.2.

cgns-surf-mesh
enables you to read a CGNS surface mesh file.

cgns-vol-mesh
enables you to read a CGNS volume mesh file.

fidap-surf-mesh
enables you to read a FIDAP surface mesh file.

fidap-vol-mesh
enables you to read a FIDAP volume mesh file.

fl-uns2-mesh
enables you to read a Fluent UNS V2 case file.

fluent-2d-mesh
enables you to read a 2D mesh into the 3D version.

gambit-surf-mesh
enables you to read a GAMBIT surface mesh file.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
66 of ANSYS, Inc. and its subsidiaries and affiliates.
 gambit-vol-mesh
enables you to read a GAMBIT volume mesh file.

hypermesh-surf-mesh
enables you to read a HYPERMESH surface mesh file.

hypermesh-vol-mesh
enables you to read a HYPERMESH volume mesh file.

ideas-surf-mesh
enables you to read an I-deas surface mesh file.

ideas-vol-mesh
enables you to read an I-deas volume mesh file.

nastran-surf-mesh
enables you to read a NASTRAN surface mesh file.

nastran-vol-mesh
enables you to read a NASTRAN volume mesh file.

patran-surf-mesh
enables you to read a PATRAN surface mesh file.

patran-vol-mesh
enables you to read a PATRAN volume mesh file.

load-act-tool
loads the ANSYS ACT tool.

read-boundary-mesh
enables you to read a boundary mesh. If the boundary mesh is contained in two or more separate files,
you can read them in together and assemble the complete boundary mesh.

This option is also convenient if you want to reuse the boundary mesh from a file containing a large
volume mesh.

Note

The naming of face zones can be controlled by Named Selections defined in ANSYS
Workbench. For details on exporting faceted geometry from ANSYS Workbench, refer to
the ANSYS Workbench Help.

read-case
enables you to read the mesh contained in a case file.

Note

Cell hierarchy in case files adapted in the solution mode will be lost when they are read
in the meshing mode.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 67
file/

Case files containing polyhedral cells can also be read in the meshing mode of Fluent. You can
display the polyhedral mesh, perform certain mesh manipulation operations, check the mesh quality,
and so on.

read-domains
enables you to read domain files.

Each mesh file written by Fluent has a domain section. A domain file is the domain section of the
mesh file and is written as a separate file. It contains a list of node, face, and cell zone IDs that make
up each domain in the mesh.

If a domain that is being read already exists in the mesh, a warning message is displayed. Fluent
verifies if the zones defining the domains exist in the mesh. If not, it will display a warning message.

read-journal
enables you to read a journal file into the program.

The read-journal command always loads the file in the main (that is, top-level) menu, regardless
of where you are in the menu hierarchy when you invoke it.

read-mesh
enables you to read a mesh file. You can also use this command to read a Fluent mesh file created with
GAMBIT, or to read the mesh available in a Fluent case file.

Note

Reading a case file as a mesh file will result in loss of boundary condition data as the
mesh file does not contain any information on boundary conditions.

Case files containing polyhedral cells can also be read in the meshing mode of Fluent. You can
display the polyhedral mesh, perform certain mesh manipulation operations, check the mesh quality,
and so on.

Important

You cannot read meshes from solvers that have been adapted using hanging nodes. To
read one of these meshes in the meshing mode in Fluent, coarsen the mesh within the
solver until you have recovered the original unadapted grid.

Note

The naming of face zones can be controlled by Named Selections defined in ANSYS
Workbench. For details on exporting faceted geometry from ANSYS Workbench, refer to
the ANSYS Workbench Help.

read-meshes-by-tmerge
uses the tmerge utility to read the mesh contained in two or more separate files. It enables you to read
the mesh files together and helps assemble the complete mesh.

read-multi-bound-mesh
enables you to read multiple boundary mesh files into the meshing mode.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
68 of ANSYS, Inc. and its subsidiaries and affiliates.
read-multiple-mesh
enables you to read in two or more files together and have the complete mesh assembled for you, if the
mesh files are contained in two or more separate files.

For example, if you are going to create a hybrid mesh by reading in a triangular boundary mesh
and a volume mesh consisting of hexahedral cells, you can read both files at the same time using
this command.

read-options
enables you to set the following options for reading mesh files:

• Enforce mesh topology: This option is disabled by default. Enabling this option will orient the face zones
consistently when the mesh file is read. If necessary, the zones being read will be separated, such that
each boundary face zone has at most two cell zones as neighbors, one on either side. Also, internal face
zones are inserted between neighboring cell zones that are connected by interior faces.

• Check read data: This option enables additional checks for the validity of the mesh. Enabling this option
will check the mesh topology during file read. In case incorrect mesh topology is encountered, warning
messages will be displayed and the erroneous entities will be deleted. Note that in case of mesh topology
errors, no automatic mesh repair is done, and that parts of the mesh may be non-conformal, contain
voids, or be erroneous in other ways. The purpose of the check-read-data option is to enable access
to corrupt files. This option is disabled by default with the assumption that correct data will be read,
and to shorten file read times.

read-size-field
enables you to read in a size field file.

Note

If you read a size-field file after scaling the model, ensure that the size-field file is appro-
priate for the scaled model (size-field vertices should match the scaled model).

set-tui-version
allows you to improve backwards compatibility for 18.1 journal files. By entering /file/set-tui-
version "18.1", ANSYS Fluent Meshing will hide any new TUI prompts that were added for version
18.2 and revert to the 18.1 default arguments. This text command must be manually added within the
18.1 journal file (for example, as the top line), or invoked in the ANSYS Fluent Meshing 18.2 session prior
to reading the 18.1 journal file. Note that TUI prompts that were removed for version 18.2 are not addressed
by this text command, and must be addressed manually. See Creating and Reading Journal Files for details.

show-configuration
displays the current release and version information.

start-journal
starts recording all input and writes it to a file. The current Fluent version is automatically recorded in the
journal file. Note that commands entered using paths from older versions of Fluent will be upgraded to
their current path in the journal file. See Creating and Reading Journal Files in the ANSYS Fluent Meshing
User's Guide.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 69
file/

To start the journaling process use the file/start-journal command, and end it with the
file/stop-journal command (or by exiting the program). To read a journal file into the program,
use the file/read-journal command.

Note

The read-journal command always loads the file in the main (that is, top-level) menu,
regardless of where you are in the menu hierarchy when you invoke it.

The standard period (.) alias is the same as the file/read-journal definition and is defined
by:
(alias ’. (lambda () (ti-read-journal)))

start-transcript
starts recording input and output in a file.

A transcript file contains a complete record of all standard input to and output from Fluent (usually
all keyboard and user interface input and all screen output).Start the transcription process with the
file/start-transcript command, and end it with the file/stop- transcript command
(or by exiting the program).

stop-journal
stops recording input and closes the journal file.

stop-transcript
stops recording input and output, and closes the transcript file.

write-boundaries
enables you to write the specified boundaries into a mesh file.

This is useful for large cases where you may want to mesh different parts of the mesh separately
and then merge them together. This enables you to avoid frequent switching between domains for
such cases. You can write out selected boundaries to a mesh file and then create the volume mesh
for the part in a separate session. You can then read the saved mesh into the previous session and
merge the part with the rest of the mesh.

write-case
enables you to write a case file that can be read by Fluent.

Note

You should delete dead zones in the mesh before writing the mesh or case file for Fluent.

write-domains
enables you to write all the mesh domains (except global) into a file that can be read.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
70 of ANSYS, Inc. and its subsidiaries and affiliates.
write-mesh
enables you to write a mesh file.

Note

You should delete dead zones in the mesh before writing the mesh or case file for Fluent.

write-options
enables you to set the enforce mesh topology option for writing mesh/case files.

This option is disabled by default; enabling this option will orient the face zones consistently when
the mesh file is written. If necessary, the zones will be separated, such that each boundary face
zone has at most two cell zones as neighbors, one on either side. Also, internal face zones will be
inserted between neighboring cell zones that are connected by interior faces.

write-size-field
enables you to write a size field file.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 71
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
72 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 9: material-point/
create-material-point
enables the definition of a material point. Specify the fluid zone name and the location to define the ma-
terial point.

delete-all-material-points
enables the deletion of all defined material points.

delete-material-point
deletes the specified material point.

list-material-points
lists all the defined material points.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 73
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
74 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 10: mesh/
auto-mesh
enables you to generate the volume mesh automatically. Specify a mesh object name for object-based
auto mesh; if no name is given, face zone based auto mesh is performed. Specify the mesh elements to
be used when prompted. Specify whether to merge the cells into a single zone or keep the cell zones
separate. For face zone based meshing, specify whether automatically identify the domain to be meshed
based on the topology information.

Note

• You can specify the meshing parameters for the mesh elements (prisms, pyramids or non-
conformals, tet, hex or poly) using either the respective dialog boxes or the associated text
commands prior to using the auto-mesh command.

• For parallel processing, after your mesh is distributed, cell zones will be always be merged.

auto-mesh-controls/
enters the auto-mesh-controls submenu

backup-object
enables creation of a backup of the surface mesh before volume meshing starts. This option is enabled
by default.

auto-prefix-cell-zones
enables you to specify a prefix for cell zones created during the auto mesh procedure.

Note

The auto-prefix-cell-zones command is not relevant for object-based meshing,

where the cell zone names are generated based on the material points and the objects
used to generate the mesh object.

cavity/
enters the cavity menu.

add-zones
enables you to create a cavity for adding new zones to the existing volume mesh.

create-hexcore-cavity-by-region
creates the cavity in the hexcore mesh based on the zones and bounding box extents specified.

create-hexcore-cavity-by-scale
creates the cavity in the hexcore mesh based on the zones and scale specified.

merge-cavity
enables you to merge the specified cavity domain with the parent domain.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 75
mesh/

During the merging operation, the cavity cell zones merges with the zones in the parent domain.
The wall boundaries extracted from the interior zones will be converted to interior type and
merged with the corresponding zones in the parent domain.

region
enables you to create a cavity to modify the existing volume mesh in the specified region.

remove-zones
enables you to create a cavity for removing zones from the existing volume mesh.

replace-zones
enables you to create a cavity for removing a set of zones from an existing volume mesh and replacing
them with new set of zones.

cell-zone-conditions/
contains options for copying or clearing cell zone conditions when a case file is read.

clear
clears the cell zone conditions assigned to the specified zones.

clear-all
clears the cell conditions assigned to all the zones.

copy
enables you to copy the cell zone conditions from the zone selected to the zones specified.

check-mesh
checks the mesh for topological errors.

check-quality
enables you to ensure that the mesh quality is appropriate before transferring the mesh to the solution
mode.

check-quality-level
enables you to report additional quality metrics when set to 1.

In addition to the orthogonal quality and Fluent aspect ratio, additional metrics such as cell squish
and skewness will be reported when the check-quality-level is set to 1.

clear-mesh
enables you to generate a new mesh by deleting the internal mesh and leaving only the boundary faces
and nodes.

create-heat-exchanger
creates the heat exchanger mesh. You need to specify the method for selecting the Location coordinates
(by Position or Nodes), the location coordinates, the parameters for setting up mesh density (by Interval
or Size), and the number of intervals (sizes) between points (nodes) 1–2, 1–3, 1–4. Also specify the ob-
ject/zone name prefix and enable creating the mesh object, if required.

cutcell/
enters the cutcell menu.

create
creates the CutCell mesh by performing the initialize, refine, snap, and improve operations sequentially.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
76 of ANSYS, Inc. and its subsidiaries and affiliates.
create-prism
creates the prism layers on the recovered boundary based on the zone-specific prism parameters set.
Specify the cell zones into which the prism layers are to be grown and the gap factor as appropriate.

modify/
enters the cutcell modify menu.

auto-node-move
enables you to use the Auto Node Move utility to improve the CutCell mesh quality.

cavity-remeshing
enables you to use the Cavity Remeshing utility to improve the CutCell mesh quality near the
boundary.

Note

Face zones of type internal are recovered as type wall in the cutcell mesher.
These should be reset to type internal before using the cavity remesher.

post-morph-improve
improves the quality of the CutCell mesh post-prism generation.

rezone-multi-connected-faces
enables you to resolve multi-connected configurations on the CutCell boundary. Specify an appro-
priate value for the critical count for contiguous manifold faces.

An example is shown in Figure 10.1: Rezoning Multiply Connected Faces (p. 77) where the
multiply connected faces around the surface are removed.

Figure 10.1: Rezoning Multiply Connected Faces

split-boundary
creates a copy of the specified CutCell boundary zones and makes the boundary mesh conformal
at the hanging-nodes on the copied zones. The new zones will be named based on the original
zone names and prefixed by split-.

objects/
enters the objects menu.

change-object-type
enables you to change the object type (geom or mesh).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 77
mesh/

check-mesh
checks the mesh on the specified objects for connectivity and orientation of faces. The domain
extents, volume statistics, and face area statistics will be reported along with the results of other
checks on the mesh.

create
creates the object based on the priority, cell zone type, face zones, edge zones, and object type
specified. You can specify the object name or retain the default blank entry to have the object
name generated automatically.

create-and-activate-domain
creates and activates the domain comprising the face zones from the objects specified.

create-groups
creates a face group and an edge group comprising the face zones and edge zones included in
the specified objects, respectively.

create-intersection-loops
enables you to create intersection loops for objects.

• The collectively option creates an interior edge loop at the intersection between two ad-
jacent face zones included in the same object and between multiple objects.

• The individually option creates an interior edge loop at the intersection between two ad-
jacent face zones included in the same object.

create-multiple
creates multiple objects by creating an object per face zone specified. The objects will be named
automatically based on the prefix and priority specified.

create-new-mesh-object/
contains options for creating a new mesh object by wrapping or remeshing existing objects.

remesh
creates a new mesh object by remeshing geometry objects individually or collectively.

wrap
creates a new mesh object by wrapping the specified objects individually or collectively.

delete
deletes the specified objects.

delete-all
deletes all the defined objects.

delete-all-geom
deletes all the defined geom objects.

delete-unreferenced-faces-and-edges
deletes all the faces and edges that are not included in any defined objects.

extract-edges
extracts the edge zones from the face zones included in the specified objects, based on the edge-
feature-angle value specified (/mesh/cutcell/objects/set/set-edge-feature-angle).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
78 of ANSYS, Inc. and its subsidiaries and affiliates.
improve-feature-capture
enables you to imprint the edges comprising the object on to the object face zones to improve
feature capture for mesh objects. You can specify the number of imprinting iterations and addi-
tional aggressive imprinting iterations to be performed.

improve-object-quality
This command is not relevant for CutCell meshing.

join-intersect/
The commands in this sub-menu are not relevant for CutCell meshing.

list
lists the defined objects, indicating the respective cell zone type, priority, face zones and edge
zones comprising the object, object type, and object reference point in the console.

merge
merges the specified objects into a single object.

merge-edges
merges all the edge zones in an object into a single edge zone.

Note

If the object is composed of edge zones of different types (boundary and interior),
the edge zones of the same type (boundary or interior) will be merged into a
single edge zone.

merge-nodes
merges the free nodes at the object level based on the specified tolerance or using a tolerance
that is a specified percentage of shortest connected edge length.

merge-voids
enables you to merge voids in the mesh object after the sewing operation. This command is not
relevant for CutCell meshing.

merge-walls
merges all the face zones of type wall in an object into a single face zone.

remove-gaps/
contains options for removing gaps between mesh objects. The commands in this sub-menu are
not relevant for CutCell meshing.

rotate
rotates the objects based on the angle of rotation, pivot point, and axis of rotation specified.

scale
scales the objects based on the scale factors specified.

separate-faces-by-angle
separates the face zones comprising the object based on the angle specified.

separate-faces-by-seed
separates the face zones comprising the object based on the seed face specified.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 79
mesh/

set/
contains the following options:

set-edge-feature-angle
sets the edge feature angle to be used for extracting edge zones from the face zones included
in the objects.

show-edge-zones?
displays the edge zones comprising the objects drawn in the graphics window.

show-face-zones?
displays the face zones comprising the objects drawn in the graphics window.

sew/
contains options for sewing mesh objects. The commands in this sub-menu are not relevant for
CutCell meshing.

translate
translates the objects based on the translation offsets specified.

update
enables you to update the objects defined when the face and/or edge zones comprising the object
have been deleted.

wrap/
contains options for the object wrapping operation. The commands in this sub-menu are not rel-
evant for CutCell meshing.

set/
enters the CutCell settings menu.

auto-delete-dead-zones?
controls the automatic deleting of the dead zones in the CutCell mesh.

auto-delete-solid-zones?
controls the automatic deleting of the solid zones in the CutCell mesh.

create-material-point
enables you to define a material point.

delete-all-material-points
enables you to delete all defined material points.

delete-material-point
deletes the specified material point.

list-material-points
lists all the defined material points.

max-initial-cells
specifies the maximum number of cells in the initial Cartesian grid.

set-cutcell-quality-method
enables you to set the quality measure for the improve operation. The default measure used is the
orthoskew metric.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
80 of ANSYS, Inc. and its subsidiaries and affiliates.
 set-post-morph-parameters
enables you to set parameters for improving the CutCell mesh post-prism generation using the
command /mesh/cutcell/modify/post-morph-improve.

set-post-snap-parameters
enables you to set parameters for improving the CutCell mesh quality.

set-thin-cut-face-zones
enables you to specify the face zones constituting the thin regions to be recovered during the
CutCell meshing process.

set-thin-cut-edge-zones
enables you to specify the edge zones defining the features in thin regions to be recovered during
the CutCell meshing process.

size-functions/
enters the size functions menu.

compute
computes the size field based on the defined parameters.

contours/
enters the contours sub-menu.

draw
displays contours in the graphics window. Compute the size field using /size-func-
tions/compute or read in a size field file prior to displaying the contours of size.

set/refine-facets?
enables you to specify smaller facets if the original are too large. Default is no.

create
defines the size function based on the specified parameters.

create-defaults
creates default size functions based on face and edge curvature and proximity.

delete
deletes the specified size function or the current size field.

delete-all
deletes all the defined size functions.

list
lists all the defined size functions and the corresponding parameter values defined.

list-periodicity-filter
lists the details of the source zone and rotational periodic parameters specified for the size field.

reset-global-controls
resets the values for the global controls to the defaults.

set-global-controls
sets the values for the global minimum and maximum size, and growth rate.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 81
mesh/

set-periodicity-filter
enables you to apply periodicity to the size field by selecting one source face zone.

Note

Ensure that periodicity is previously defined in the Make Periodic Boundaries

dialog box.

Only rotational periodicity is supported, translational periodicity is not supported

currently.

set-prox-gap-tolerance
sets the tolerance relative to minimum size to take gaps into account. Gaps whose thickness is less
than the global minimum size multiplied by this factor will not be regarded as a proximity gap.

set-scaling-filter
enables you specify the scale factor, and minimum and maximum size values to filter the size
output from the size field.

triangulate-quad-faces?
identifies the zones comprising non-triangular elements and uses a triangulated copy of these
zones for computing the size functions.

un-set-periodicity-filter
removes periodicity from the size field.

use-cad-imported-curvature?
allows you to use curvature data from the nodes of the CAD facets.

domains/
enters the domain menu.

activate
activates the specified domain for meshing or reporting operations.

create
creates a new domain based on the specified boundary face zones.

create-by-cell-zone
creates a new domain based on the specified cell zone.

create-by-point
creates a new domain based on the specified

Note

The create-by-point option works only for cases with no overlapping face zones.

delete
deletes the specified domain.

draw
displays the boundary face zones of the specified domain.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
82 of ANSYS, Inc. and its subsidiaries and affiliates.
 print
prints the information for the specified domain.

hexcore/
enters the hexcore menu.

controls/
enters the hexcore controls menu.

buffer-layers
sets the number of addition cells to mark for subdivision.

compute-max-cell-length
compute the maximum cell length for the hexcore mesh.

define-hexcore-extents?
enables you to extend the hexcore mesh to specified domain extents and/or selected planar
boundaries. When enabled, the outer-domain-params sub-menu will be available.

delete-dead-zones?
toggles the automatic deleting of the dead zones.

island-thresholds
opens a dialog to set absolute-island-count (default is 50) and island-volume-frac-
tion (relative to total volume of hex cells, default is 1e-06). For a cell region to be interpreted as
an island, both cell count and relative volume thresholds may not be exceeded.

keep-hex-tet-separate?
toggles the merging of Cartesian cells with the tet (and wedge) cells at the end of the hexcore
meshing process.

maximum-cell-length
sets the maximum cell length for the hex cells in the domain.

maximum-initial-cells
specifies the maximum number of cells in the initial Cartesian mesh.

maximum-subdivisions
number of changes in size (hanging node subdivisions) allowed in the hex mesh region. The default
is 50.

non-fluid-type
selects the default non-fluid cell zone type. After the mesh is initialized, any non-fluid zones will
be set to this type. If the mesh includes multiple regions (for example, the problem for which you
are creating the mesh includes a fluid zone and one or more solid zones), and you plan to refine
all of them using the same refinement parameters, modify the Non-Fluid Type before generating
the hexcore mesh.

Note

For zone-based meshing, if any cell zone has at least one boundary zone type as
inlet, it will automatically be set to fluid type. For object based meshing, volume
region type is used to determine the cell zone type.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 83
mesh/

octree-hexcore?
speeds up hexahedral core generation by enabling the octree technique for hexcore mesh gener-
ation. This option is disabled by default.

Body-of-influence sizing may be used for refinement.

This option does not support hexcore generation up to boundaries.

only-hexcore?
enables you to create only the hexcore mesh and activates the tetrahedral mesh domain (without
tetrahedral mesh generation). It enables you to prevent the automatic creation of the mesh after
hexcore generation. This option is disabled by default. This option is not available for object-based
meshing.

outer-domain-params/
contains options for defining the outer domain parameters. This sub-menu is available only when
define-hexcore-extents? is enabled.

specify-coordinates?
enables you to specify the extents of the hexcore outer box using the coordinates command.

coordinates
specifies the extents (min and max coordinates) of the hexcore outer box. This command is
available when the specify-coordinates? option is enabled.

specify-boundaries?
enables you to specify selected boundaries to which the hexcore mesh is to be generated using
the boundaries command.

boundaries
specifies the boundaries to which the hexcore mesh is to be generated when the specify-
boundaries? option is enabled. After specifying the boundaries, the auto-align?, de-
lete-old-face-zones?, and list options will also be available.

auto-align?
enables you to axis-align non-aligned planar boundaries to which hexcore mesh is to be gen-
erated. This option is available only when the specify-boundaries? option is enabled
and the boundaries are specified.

auto-align-tolerance
specifies the tolerance for aligning boundary zones when auto-align? is enabled.

auto-align-boundaries
aligns the boundary zones specified (using the boundaries command) with the tolerance
specified \ (using the auto-align-tolerance command) when auto-align? is enabled.

delete-old-face-zones?
enables you to delete the original tri face zones that have been replaced during the hexcore
meshing process. This option is available only when the specify-boundaries? option is
enabled and the boundaries are specified.

list
lists the boundaries to which the hexcore mesh is to be generated. This option is available only
when the specify-boundaries? option is enabled and the boundaries are specified.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
84 of ANSYS, Inc. and its subsidiaries and affiliates.
 peel-layers
specifies the distance for the hexcore interface to peel-back from the boundary. The default value
is 0. The higher the value of peel layer, the bigger the distance between the hexcore interface and
the boundary.

skip-tet-refinement?
enables you to omit the tetrahedral refinement phase for reducing total cell count (default is no).
Hex cell count is unaffected.

Tip

It is recommended to use peel-layers equal 0 when this option is enabled.

Warning

This option may leave narrow regions without hexcore mesh. Tetrahedral cells
with lower quality may be created in such regions, reducing the overall mesh
quality.

smooth-interface?
enables smoothing of the hexcore interface.

smooth-iterations
specifies the number of smoothing iterations.

smooth-relaxation
specifies the surface smoothing relaxation factor.

create
enables you to create the hexcore mesh according to the specified parameters.

local-regions
enters the hexcore local refinement region sub-menu.

activate
enables you to activate the specified local regions for refinement.

deactivate
enables you to deactivate the specified local regions for refinement.

define
defines the local region according to the specified parameters.

delete
deletes the specified refinement region.

ideal-hex-vol
reports the ideal hex volume for the given edge length.

init
creates a default region encompassing the entire geometry.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 85
mesh/

list-all-regions
lists the defined and active regions in the console.

laplace-smooth-nodes
applies a Laplacian smoothing operator to the mesh nodes. This command can be used for smoothing of
all cell types, including prismatic cells.

list-mesh-parameter
shows all mesh parameters.

manage/
enters the manage cell zones menu.

active-list
lists all active zones.

adjacent-face-zones
lists all face zones that refer to the specified cell zone.

auto-set-active
sets the active zones based on points that are defined in an external file. For each zone you want to
activate, you need to specify the coordinates of a point in the zone, the zone type (for example, fluid),
and (optionally) a new name. A sample file is shown below:
((1550.50 -466.58 896.41) fluid heater-#)
((1535.83 -643.14 874.71) fluid below-heater-#)
((1538.73 -444.28 952.69) fluid above-heater-#)
((1389.18 -775.51 825.97) fluid plenum-#)

Here, four fluid zones are identified, renamed, and activated. Any zone that you identify in the
file will automatically be activated. The # indicates that the mesher should append the appro-
priate ID number for the zone.

Warning

This command is valid only for tet meshes.

change-prefix
enables you to change the prefix for the cell zone.

copy
copies all nodes and faces of specified cell zones.

delete
deletes a cell zone, along with its associated nodes and faces.

get-material-point
prints the coordinates of the material point for the specified cell zone.

Note

If the cell zone is non-contiguous, the get-material-point command will print

a list of material points, one for each contiguous region.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
86 of ANSYS, Inc. and its subsidiaries and affiliates.
id
specifies a new cell zone ID. If a conflict is detected, the change will be ignored.

list
prints information on all cell zones.

merge
merges two or more cell zones.

Note

For object-based merge, the selected zones must be in the same volumetric region.
If not, you will have to merge the volumetric regions first using /objects/volu-
metric-regions/merge. If the volumetric regions cannot be merged because
they are not contiguous, you will have to delete the object(s) only before merging
the cell zones.

merge-dead-zones
enables you to merge dead zones having a cell count lower than the specified threshold value, with
the adjacent cell zone. The result of the merge operation is determined by the type of the adjacent
cell zone and the shared face area. The priority for merging with the adjacent cell zone based on type
is fluid > solid > dead (that is, merging with an adjacent fluid zone takes priority over merging with
an adjacent solid zone, which in turn takes priority over merging with a dead zone). Also, if the adjacent
zones are of the same type (for example, fluid), the zone will be merged with the zone having the
largest shared face area.

name
enables you to rename a cell zone.

origin
specifies a new origin for the mesh, to be used for cell zone rotation. The default origin is (0,0,0).

revolve-face-zone
generates cells by revolving a face thread.

rotate
rotates all nodes of specified cell zones by a specified angle.

rotate-model
rotates all nodes of the model by a specified angle.

scale
scales all nodes of specified cell zones by a specified factor.

scale-model
scales all nodes of the model by a specified factor.

set-active
sets the specified cell zones to be active.

translate
translates all nodes of specified cell zones by a specified vector.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 87
mesh/

translate-model
translates all nodes of the model by a specified vector.

type
changes the type and name of a cell zone.

modify/
enters the mesh modify menu.

auto-improve-warp
enables you to improve face warp by node movement. Specify the appropriate cell zones and
boundary zones, the maximum warp, the number of iterations per face to be improved, and the
number of iterations of the automatic node movement procedure (default, 4).

auto-node-move
enables you to improve the mesh quality by node movement. Specify the appropriate cell zones and
boundary zones, the quality limit based on the quality measure selected, dihedral angle, the number
of iterations per node to be moved and the number of iterations of the automatic node movement
procedure (default, 1). You can also choose to restrict the movement of boundary nodes along the
surface.

clear-selections
clears all items from the selection list.

deselect-last
deselects the last item you selected using the select-entity command.

extract-unused-nodes
places all unused nodes in a separate interior node zone.

list-selections
lists all items in the selection list.

list-skewed-cells
lists cells with skewness in a specified range.

mesh-node
attempts to introduce a new node into the existing mesh.

mesh-nodes-on-zone
inserts nodes associated with node or face zone into the volume mesh.

Important

If a face zone is specified, the faces are deleted before the nodes are introduced into
the mesh.

neighborhood-skew
reports the maximum skewness of cells using the specified node.

refine-cell
attempts to refine the cells in the probe list by introducing a node nears its centroid. This technique
is useful for removing very flat cells near the boundary when boundary sliver removal is not possible.
After refining the cell, you should smooth the mesh.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
88 of ANSYS, Inc. and its subsidiaries and affiliates.
 repair-negative-volume-cells
repairs negative volume cells by moving nodes. Specify the appropriate boundary zones, the number
of iterations per node to be moved, dihedral angle, whether to restrict the movement of boundary
nodes along the surface, and the number of iterations of the automatic node movement procedure
(default, 1).

select-entity
adds an entity (face, node, cell, etc.) to the selection list.

smooth-node
applies Laplace smoothing to the nodes in the selection list.

non-conformals/
enters the non-conformals menu.

controls/
enters the non-conformals controls menu.

enable?
toggles the creation of a non-conformal interface.

retri-method
specifies the method to be used for retriangulating the quad faces on the non-conformal zones.

prism
remeshes the prism-side quad zones named prism-side* or *-quad*.

quad-split
splits the quad faces diagonally into tri faces.

remesh
remeshes all the quad faces based on the edge and surface feature angle specified.

create
creates the non-conformal interface on the specified face zones using the specified retriangulation
method.

separate
enables you to separate the face zones comprising the non-conformal interface between the cell zones
specified. Specify the cell zones where the interface is non-conformal, an appropriate gap distance,
and the critical angle to be used for separating the face zones. You can also choose to orient the
boundary face zones after separation and additionally write a journal file for the separation operation.

Note

If you choose to write a journal file when using the /mesh/non-conformals/sep-

arate command to separate the mesh interface zones, you can read the journal file
to create the mesh interface automatically in solution mode.

poly/
enters the polyhedral mesh generation menu.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 89
mesh/

collapse
merge nodes to remove short edges and small faces. The decision threshold uses edge size ratio, face
size ratio, and (face) area fraction.

controls/
enters the controls menu for setting poly parameters.

cell-sizing
sets cell volume distribution function as geometric, linear, or size-field.

edge-size-ratio
sets the threshold for the size ratio of two connected edges. Recommended range is 20 to 200.

face-size-ratio
sets the threshold for the size ratio of two faces on one cell. Recommended range is 100 to 300.

feature-angle
sets the minimum threshold that should be preserved as a feature.

improve?
enables poly mesh improvement by smoothing based on the smooth-controls.

merge-skew
sets the minimum skewness threshold for cell merge.

non-fluid-type
selects the default type for non-fluid zones.

remesh-skew
sets the target skewness when remeshing.

sliver-cell-area-fraction
sets the threshold for the area of a single face to the cell surface area. Recommended range is
0.00001 to 0.001.

smooth-controls/
enters the menu for setting smoothing parameters for poly mesh.

centroid-smooth-iterations
sets the number of passes for tet-cell centroid smoothing during the poly mesh generation
phase.

edge-smooth-iterations
sets the number of passes for tet-cell edge smoothing during the poly mesh generation phase.

laplace-smooth-iterations
sets the number of passes for tet-cell Laplace smoothing during the poly mesh generation
phase.

smooth-attempts
sets the maximum number of movements for a single node during poly mesh smoothing.

smooth-boundary
enables boundary smoothing as part of poly cell smoothing. Default is no.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
90 of ANSYS, Inc. and its subsidiaries and affiliates.
 smooth-iterations
sets the number of improvement passes over the full poly mesh.

smooth-on-layer
constrains movement of nodes to maintain layering during poly mesh smoothing.

smooth-skew
sets the minimum skewness threshold for poly mesh smoothing.

improve
allows you to improve the polyhedral mesh quality based on the quality-method.

local-regions/
enters the local refinement menu.

Note

Poly meshing follows tet meshing. These commands behave like the equivalent
commands under /mesh/tet/local-regions/.

activate
activates the specified regions for refinement.

deactivate
deactivate the specified regions for refinement.

define
defines the refinement region according to the specified parameters.

delete
deletes the specified refinement region.

ideal-vol
reports the volume of an ideal tetrahedron for the edge length specified.

init
defines the default refinement region encompassing the entire geometry.

list-all-regions
lists all refinement region parameters and the activated regions in the console.

refine
refines the active cells inside the selected region based on the specified refinement parameters.

quality-method
asks you to choose from internal-default, orthoskew or squish quality measure for mesh
improvement.

remesh
improve the quality in a local region based on the minimum skewness threshold.

prepare-for-solve
prepares the mesh for solving in solution mode by performing a cleanup operation after the volume mesh
has been generated. Operations such as deleting dead zones, deleting geometry objects, deleting edge

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 91
mesh/

zones, removing face/cell zone name prefixes and/or suffixes, deleting unused faces and nodes are per-
formed during this operation.

prism/
enters the prism menu.

controls/
enters the prism controls menu.

adjacent-zone/
enters the prism adjacent zone controls menu.

project-adjacent-angle
determines whether or not to project to an adjacent zone. If a zone shares outer nodes with
any of the zones from which the layers are being grown (the “base zones”), its angle with respect
to the growth direction is compared with this value. If the angle is less than or equal to this
value, then the zone will be projected to. The default value is 75 degrees. See Using Adjacent
Zones as the Sides of Prisms for details.

project-converged
sets the convergence criterion for iterative projection. This is non-dimensionalized by the offset
height at each local node.

project-iter
sets the maximum number of iterations to perform when projecting to multiple zones. Most
projections converge in only a few iterations. There is normally no need to change this value.

project?
enables/disables projection of outer nodes to adjacent zones.

retri-feature-angle
enables you to specify the feature angle that should be prevented while generating prisms.

retriangulate-adjacent?
specifies whether or not triangular face zones adjacent to which outer nodes have been pro-
jected, will be automatically retriangulated.

side-feature-align-angle
specifies the angle used for aligning projected normals along a feature edge.

side-feature-angle
specifies the angle used for computing the feature normals.

side-topology-align-angle
specifies the angle used for aligning projected normals along a particular feature edge based
on the topology. This is particularly useful when the side-feature-angle specified is not
sufficient to decide the feature edge to align the projected normals.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
92 of ANSYS, Inc. and its subsidiaries and affiliates.
auto-separate-cells?
enables/disables automatic separation of the cells extruded from different face zones to different
cell zones.

Note

This option is not considered when the auto-mesh option is used to generate
the mesh.

check-quality?
enables/disables the checking of volume, skewness, and handedness of each new cell and face.

grow-individually?
specifies whether prisms should be grown from multiple zones individually so that the individual
prism cell zones and the individual cap face zones are retained.

improve/
enters the prism smoothing controls menu.

check-allowable-skew?
enables you to check the skewness of the prism cap for every layer.

check-size?
enables the checking of cell size during the generation of each prism layer. An error will be
reported if zero-area prism cells are generated and prism layer growth will be stopped.

When the check-size? option is disabled, the zero-area prism cells generated can be
removed during the improvement smoothing operations performed at the end of the prism
generation procedure.

corner-height-weight?
when enabled, the offset height at corners with large angles (for example, 270º) is reduced to
give a smoother prism cap.

edge-smooth-angle
specifies the maximum allowable angle between the normals of adjacent cap faces for skewness-
driven edge smoothing.

edge-smooth?
enables/disables local smoothing of nodes of the longest edges of skewed faces. This option
is switched off by default.

edge-swap-base-angle
specifies the maximum allowable angle between the normals of the base faces for skewness-
driven edge swapping.

edge-swap-cap-angle
specifies the maximum allowable angle between the normals of the cap faces for skewness-
driven edge swapping.

edge-swap?
enables/disables edge swapping to decrease the skewness of highly skewed faces. This option
is switched off by default.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 93
mesh/

face-smooth-converged
specifies the convergence criteria for cap face smoothing.

face-smooth-rings
sets the number of rings around each node to be smoothed. If zero, only a node itself is
smoothed. If one, the node and all of its neighbors are smoothed. If two, the neighbors of the
neighbors are also smoothed, and so on.

face-smooth-skew
specifies the minimum skewness to smooth cap faces.

face-smooth?
enables face-driven smoothing to improve skewness.

identify-feature-line?
enables you to smooth the normal along the feature lines of the base face zones, during normal
smoothing. This option is disabled by default.

improve-warp?
enables or disables improving of face warp during prism generation. This option is disabled
by default.

layer-by-layer-smoothing?
enables you to improve cell quality for every layer by smoothing normals in the current layer.
In addition, perturbation smoothing will be performed to improve cell quality in the lower
layer, when the quality measure is set to either skewness, squish, ICEM CFD quality, or orthoskew.
The poor quality elements are identified based on the value set for max-allowable-cell-
skew. The cell aspect ratio will also be maintained during the cell quality improvement. This
option is switched off by default.

left-hand-check
controls checking for left-handedness of faces. The default setting of 0 implies face handedness
will not be checked. A value of 1 implies only cap faces will be checked, while 2 implies faces
of all cells in current layer will be checked.

max-allowable-cap-skew
specifies the maximum skewness allowed for a prism cap face. If the skewness of a cap face
exceeds this value, the meshing process will stop and a warning indicates that the skewness
for that layer is too high.

max-allowable-cell-skew
specifies the cell quality criteria for smoothing and quality checking.

node-smooth-angle
refers to the maximum deviation of a node’s sharpest angle (that is, the most acute angle
between adjacent faces that use the node) from 180 degrees. The node will be smoothed only
if its sharpest angle falls within this range.

node-smooth-converged
sets the convergence criterion for node smoothing. If the node positions are changing by less
than this value, smoothing iterations will stop.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
94 of ANSYS, Inc. and its subsidiaries and affiliates.
 node-smooth-iter
specifies the maximum number of node smoothing iterations to be performed for the nodes
on each layer. These iterations will be performed until the convergence criterion is reached.

node-smooth-local?
enables node smoothing to converge locally. This is useful for large geometries.

node-smooth-rings
controls the locality of node smoothing by setting the number of rings around each node to
be smoothed. If zero, only the node itself is smoothed. If one, the node and all of its neighbors
are smoothed. If two, the neighbors of the neighbors are also smoothed, and so on.

node-smooth?
enables/disables node smoothing to decrease skewness. This option is switched off by default.

post-adjust-height?
enables you to perform prism height adjustment based on growth rate.

shrink-left-handed-cap?
enables shrinking of prism layers to remove left handed faces.

smooth-improve-prism-cells?
enables you to set the parameters for improving the prism cells after the required prism layers
are created. You can select optimized smoothing (smooth), node movement (improve), or
a combination of both to improve the quality. Specify the quality measure to be used, the cell
quality threshold, the number of improvement iterations, and the minimum improvement re-
quired.

swap-smooth-skew
specifies the skewness threshold for edge swapping and edge and node smoothing. The faces
with skewness greater than or equal to the specified value will be swapped and/or smoothed.

merge-ignored-threads?
enables you to automatically merge all ignored zones related to a base thread into a single thread.
This option is enabled by default. When this option is disabled, more than one ignored thread will
be generated per base thread. However, various zones can be created by ignoring this option.
They are:

*:dwall
is formed due to dangling wall.

*:prox
is formed due to proximity.

*:ud_normal
is formed due to invalid normal.

*:smooth
is formed due to smoothing of ignored regions.

The default value of the tgvar prism/ignore-extension (for which there is no TUI
command) is 1. It means that after the prism generation is over, all the ignored regions are
expanded by this number. If we expand say by n times, that is if prism/ignore-exten-

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 95
mesh/

sion is set to n using tgsetvar! (with the exclamation mark), more ignored threads will
be created because of expanding ignored regions. These regions will be named as follows:

*:cell_delete_1, *:cell_delete_2, *:cell_delete_3,.... up to \

*:cell_delete_n

If merge-ignored-threads? is enabled, then all these are merged and you finally get
only one zone per base thread, named as *:ignore.

morph/
enters the prism morphing controls menu.

improve-threshold
specifies the quality threshold used for improving the quality during the morphing operation.

morphing-convergence-limit
specifies the convergence limit for the morphing operation. The morpher uses an iterative
solver. It is assumed to have converged when the relative residual is less than this number.

morphing-frequency
specifies the frequency of the morphing operation. The number specified denotes the number
of prism layers after which the morpher is applied to the remainder of the mesh (for example,
a value of 5 indicates that the morpher is applied to the mesh after every 5 prism layers grown).

normal/
enters the prism normal controls menu.

bisect-angle
is required for growing prisms out of sharp interior corners. When the value of this angle is set,
the normals are automatically projected onto the plane bisecting the angle between faces
having an interior angle less than this angle.

compute-normal
computes the normal for the specified face zone.

converge-locally?
specifies whether or not the normal smoothing at each node is frozen once convergence is
satisfied at that node. If not, all normals are continuously smoothed until all of them have
converged.

direction-method
specifies whether the prism layers should be grown normal to surfaces or along a specified
direction vector.

direction-vector
specifies the direction vector for prism extrusion when the uniform method is selected for
direction-method.

ignore-invalid-normals?
enables you to ignore nodes that have poor normals.

max-angle-change
specifies the maximum angle by which the normal direction at a node can change during
smoothing.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
96 of ANSYS, Inc. and its subsidiaries and affiliates.
normal-method
gives options for the method to use for computing the normal direction.

acute-bisection
is a variation of that proposed by Kallinderis et al. [7], [8]. The faces surrounding a node are
analyzed to find those whose planes form the most acute angle. The resulting normal lies
on the plane bisecting those two planes.

This method is computationally more expensive than surface averaging, but is less
robust at singular points where convex edges meet smooth surfaces. For example,
if a box is sitting on the table, such a point would be where one of the box’s corners
meets the table top.

face-average
computes the normal at a node by averaging the normals of the surrounding faces.

hybrid-normal
computes the normal by all the methods available and uses the best quality normal ob-
tained. This is the default method.

minimized-angle
is a variation of that proposed by Pirzadeh [14], [15]. An ial normal at a node is determined
by averaging the normals of the surrounding faces (the face-average method). Iterations
are then performed to minimize the largest angle between the node normal and the normals
of the surrounding faces.

This method is a computationally more expensive than surface averaging, and can
produce slightly better normals when the uniform offset method is used and the
surface mesh does not contain sharp edges. When the minimum-height offset
method is used, this direction method may introduce spikes and pits in the advancing
layer surfaces.

surface-average
is similar to face-average, but handles sharp edges better.

orient-mesh-object-face-normals
enables you to orient the face normals for mesh object boundary zones. Specify the mesh object,
region or material point as appropriate, and specify whether walls, baffles or both comprising
the prism base zones are to be separated and oriented.

orthogonal-layers
specifies the number of layers to preserve orthogonality. All smoothing is deferred until after
these layers.

smooth-converged
sets the convergence criterion (in degrees) for normal smoothing. If the normal directions are
changing by less than this value, smoothing iterations will stop.

smooth-iter
specifies the maximum number of normal smoothing iterations to be performed for the normal
vectors on each layer. These iterations will be performed until the convergence criterion
(normal/smooth-converged) is reached.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 97
mesh/

smooth?
enables or disables smoothing of normal direction vectors.

offset/
enters the prism offset controls menu.

first-aspect-ratio-min
specifies the minimum first aspect ratio (ratio of prism base length to prism layer height) for
the prism cells.

min-aspect-ratio
specifies the minimum aspect ratio (ratio of prism base length to prism layer height) for the
prism cells.

smooth-converged
sets the convergence criterion for offset smoothing. If the offset heights are changing by less
than this value, smoothing iterations will stop.

smooth-iter
sets the maximum number of offset smoothing iterations to be performed. These iterations
will be performed until the convergence criterion offset/smooth-converged is reached.

smooth?
enables/disables offset distance smoothing.

post-ignore/
contains options for setting the parameters for removing poor quality prism cells after the required
prism layers are created.

post-remove-cells?
enables you to set the parameters for removing poor quality prism cells after the required
prism layers are created. You can remove cells based on quality, intersection, interior warp,
and feature edges. Specify options for removing additional cells in regions of high aspect ratio
and feature angle, the number of cell rings to be removed around the marked cells, and options
for smoothing the prism boundary and prism side height.

proximity
enters the prism proximity controls menu.

allow-ignore?
enables you to ignore nodes where the specified maximum shrink factor cannot be maintained.

allow-shrinkage?
enables shrinkage while growing prism layers.

gap-factor
controls the gap between the intersecting prisms layers in the proximity region with respect
to the cell size of the prisms.

keep-first-layer-offsets?
enables you to retain first layer offsets while performing proximity detection.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
98 of ANSYS, Inc. and its subsidiaries and affiliates.
 max-aspect-ratio
specifies the maximum allowable cell aspect ratio to determine the limit for the shrinkage of
prism layers. This option is available only when the allow-ignore? option is disabled.

max-shrink-factor
specifies the shrink factor determining the maximum shrinkage of the prism layers. This option
is available only when the allow-ignore? option is enabled.

smoothing-rate
specifies the rate at which shrinkage is propagated in lateral direction.

remove-invalid-layer?
removes the last prism layer if it fails in the quality check.

set-post-mesh-controls
sets controls specific to growing prisms post volume mesh generation.

split?
enables you to set parameters for splitting the prism layers after the initial prism layers are gener-
ated, to generate the total number of layers required. Specify the number of divisions per layer.

zone-specific-growth
enters the prism growth controls menu.

apply-growth
applies the zone-specific growth parameters specified.

clear-growth
clears the zone-specific growth specified.

list-growth
lists the zone-specific growth parameters specified for individual zones in the console.

create
creates prism layers on one or more boundary face zones based on the offset method, growth method,
number of layers, and rate specified.

improve/
enters the prism improve menu.

improve-prism-cells
collects and smooths cells in layers around poor quality cells. Cells with quality worse than the
specified threshold value will be identified, and the nodes of the cells surrounding the poor quality
cells will be moved to improve quality.

smooth-brute-force?
forcibly smooths cells if cell skewness is still high after regular smoothing.

smooth-cell-rings
specifies the number of cell rings around the skewed cell used by improve-prism-cells.

smooth-improve-prism-cells
uses a combination of node movement and optimized smoothing to improve the quality. This
command is a combination of the smooth-prism-cells and improve-prism-cells

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 99
mesh/

commands. The cell aspect ratio will also be maintained based on the value specified for max-
aspect-ratio.

smooth-prism-cells
enables optimization based smoothing of prism cells. The nodes of cells with quality worse than
the specified threshold value will be moved to improve quality. The cell aspect ratio will also be
maintained based on the value specified for max-aspect-ratio.

smooth-sliver-skew
specifies the skewness above which prism cells will be smoothed.

list-parameters
shows all prism mesh parameters.

mark-ignore-faces
enables you to mark the faces to be ignored during prism meshing.

mark-nonmanifold-nodes
enables you to mark the non-manifold prism base nodes. A list of the non-manifold nodes will be
printed in the console. The faces connected to the non-manifold nodes will also be marked. You can
use this command after specifying zone-specific prism settings, prior to generating the prisms to
verify that non-manifold configurations do not exist.

post-ignore/
contains the following options for ignoring prism cells:

create-cavity
creates a cavity in regions where prism quality is adequate, but the quality of adjacent tetrahedra
is poor. The cavity is created based on the tetrahedral cell zone, the quality measure and the cor-
responding threshold value, and the additional number of cell rings specified. You can create a
cavity comprising only tetrahedral cells or optionally include prism cells in the cavity created. When
prism cells are also included in the cavity, you can specify whether the non-conformal interface is
to be created.

mark-cavity-prism-cap
marks the prism cap faces and tetrahedral cell faces bounding the cavity to be created in regions
where prism quality is adequate, but the quality of adjacent tetrahedra is poor. Specify the tetra-
hedral cell zone, the quality measure and the corresponding threshold value to be used, and the
additional number of cell rings based on which the cavity will be created.

mark-prism-cap
marks the prism cap faces for ignoring prism cells in regions of poor quality cells and sharp corners.
Specify the prism cell zone and the basis for ignoring prism cells and the relevant parameters. The
prism cells can be ignored based on quality, intersection, (both enabled by default), warp, and
features (both disabled by default). Specify the quality measure and threshold value to be used
for ignoring cells based on quality and (if applicable) the feature edges for ignoring cells based on
features. Additionally, specify whether cells are to be marked in regions of high aspect ratio and
based on feature angle, and the additional number of cell rings based on which prism cells will be
removed.

post-remove-cells
enables you to remove prism cells in layers around poor quality cells and sharp corners. Specify
the prism cell zone, the basis for ignoring prism cells (quality, intersection, warp, features) and the
relevant parameters. Specify the number of cell rings to be removed around the marked cells. Cells

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
100 of ANSYS, Inc. and its subsidiaries and affiliates.
 will be marked for removal in regions of sharp corners based on quality, intersection, warp, and
features (as applicable) and then extended based on the number of cell rings specified. Additional
cells will be marked for removal in regions of high aspect ratio and based on feature angle (if ap-
plicable) around the exposed prism side. The boundary will be smoothed at feature corners after
the prism cells have been removed. The prism-side faces exposed by the removal of the prism cells
will be collected in a zone named prism-side-#, while for a zone wall-n, the faces correspond-
ing to the ignored prism cells will be collected in a zone named wall-n:ignore. You can also
optionally smooth the prism side nodes from the base node to the cap node to create better tri-
angles for the non-conformal interface.

quality-method
specifies the quality method used during prism generation.

reset-parameters
resets all prism parameters.

split/
contains options for splitting the prism layers after the initial prism layers are generated, to generate
the total number of layers required.

split
enables you to split the prism layers after the initial prism layers are generated, to generate the
total number of layers required. Specify the prism cell zones to be split and the number of divisions
per layer. You can also choose to use the existing growth rate (default) or specify the growth rate
to be used while splitting the prism layers.

pyramid/
enters the pyramid menu.

controls/
enters the pyramid controls menu.

neighbor-angle
sets the threshold dihedral angle used to limit the neighboring faces considered for pyramid cre-
ation. For example, if the value is set to 110° and the angle between a given quadrilateral face and
a neighboring triangular face is greater than 110°, the resulting pyramid will not include the trian-
gular face.

offset-factor
specifies the fraction of the computed pyramid height (offset) by which the pyramid heights will
be randomly adjusted. The default value is 0, indicating that all pyramids will have the exact height
computed. A value of 0.1, for example, will limit each adjustment to ±10% of the computed height.

offset-scaling
specifies the scaling, to be used to determine the height of the pyramid.

vertex-method
specifies the method by which the location of the new vertex of the pyramid will be determined.
The skewness method is used by default.

create
creates a layer of pyramids on the quad face zone.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 101
mesh/

repair-face-handedness
reverses face node orientation.

reset-mesh
clears the entire mesh.

reset-mesh-parameter
resets all parameters to their default value.

scoped-prisms/
contains options for creating scoped prism controls for mesh objects.

create
creates a new scoped prism control based on the parameters and scope specified. Specify the name,
offset method, first height or aspect ratio, number of layers, and rate or last percent. Select the mesh
object and set the scope (fluid-regions, named-regions, or solid-regions). Specify the
zones to grow prisms (all-zones, only-walls, selected-face-zones, or selected-labels,
or solid-fluid-interface). When named-regions and/or selected-face-zones or
selected-labels are selected, specify the volume and/or boundary scope. If interior baffle zones
are selected, retain the option to grow prisms on both sides of the baffles or disable it to grow prisms
on one side.

delete
deletes the specified scoped prism control.

growth-options
enables you to specify scoped prism growth options. Select Fix First Height if required, and
specify the gap factor, maximum aspect ratio, prism quality method, and the threshold quality value
for stair stepping.

list
lists all the defined scoped prism controls.

modify
modifies the specified control based on the parameters specified.

read
reads in the specified scoped prism control file (*.pzmcontrol).

set-no-imprint-zones
used to specify face zones that should not be imprinted during prism generation.

write
writes the scoped prism controls to a prism control file (*.pzmcontrol). Specify the scoped prism file
name.

separate
separates cells by various user-defined methods.

local-regions/
enters the local refinement menu.

define
enables you to define the parameters for the refinement region.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
102 of ANSYS, Inc. and its subsidiaries and affiliates.
 delete
enables you to delete a refinement region.

init
deletes all current regions and adds the default refinement region.

list-all-regions
lists all the refinement regions.

separate-cell-by-face
separates cells that are connected to a specified face zone into another cell zone. This separation
method applies only to prism cells.

separate-cell-by-mark
separates cells within a specified local region into another cell zone.

separate-cell-by-region
separates contiguous regions within a cell zone into separate cell zones.

separate-cell-by-shape
separates cells with different shapes (pyramids, tetrahedra, etc.) into separate cell zones.

separate-cell-by-size
separates cells based on the specified minimum and maximum cell sizes.

separate-cell-by-skew
separates cells based on the specified cell skewness.

tet/
enters the tetrahedral mesh menu.

controls/
enters the tet controls menu.

adv-front-method
enters the advancing front refinement controls menu.

first-improve-params
defines the refining front improvement parameters for the advancing front method.

refine-parameters
defines the cell zone improvement parameters for the advancing front method.

second-improve-params
defines the cell zone improvement parameters for the advancing front method.

skew-improve/
enters the refine improve controls menu.

attempts
specifies the number of overall improvement attempts for the advancing front method.

boundary-sliver-skew
specifies the boundary sliver skewness for the advancing front method. This parameter is
used for removing sliver cells along the boundary.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 103
mesh/

iterations
specifies the number of improvement iterations in each attempt for the advancing front
method.

sliver-skew
specifies the sliver skewness for the advancing front method. This parameter is used for
removing sliver cells in the interior.

target-low-skew
specifies the targeted skewness threshold above which cells will be improved. The improve
operation will attempt to improve cells with skewness above the target-low-skew
value specified, but there will be no attempt to reduce the skewness below the specified
value. A limited set of improve operations will be used as compared to the operations re-
quired for the target-skew value-based improvement. The value specified could be
approximately 0.1 lower than the target-skew value.

target-skew
specifies the targeted skewness during improvement for the advancing front method.

target?
enables you to enable targeted skewness-based refinement for the advancing front
method. This option enables you to improve the mesh until the targeted skewness value
is achieved.

advanced/
enters the advanced tet controls menu.

defaults?
enables/disables the use of the default values for the initialization parameters.

freeze-boundary-cells
freezes the boundary cells during mesh improvement and sliver removal operations.

keep-virtual-entities?
enables/disables the automatic deleting of virtual entities after mesh initialization.

max-cells
sets the maximum number of cells in the mesh.

max-nodes
sets the maximum number of nodes in the mesh.

Warning

Be careful when you set upper limits on the number of cells or nodes. Nodes
or cells will not be added when the prescribed limit is reached, and this may
leave the mesh unevenly refined and less than adequate.

node-tolerance
defines the smallest distance between two distinct nodes. This command is available only
when you disable the use of default values for the initialization parameters.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
104 of ANSYS, Inc. and its subsidiaries and affiliates.
 progress-reports
enables you to set the time between progress reports in seconds.

report-max-unmeshed
reports the maximum number of unmeshed entities.

report-unmeshed-faces?
reports the unmeshed faces.

report-unmeshed-nodes?
reports the unmeshed nodes.

sliver-size
is the smallest cell whose size can be determined accurately. This command is available only
when you disable the use of default values for the initialization parameters.

cell-sizing
specifies the cell sizing function for refinement. You can select geometric, linear, none, or
size-field as appropriate.

compute-max-cell-volume
computes the maximum cell volume for the current mesh.

delete-dead-zones?
specifies the maximum allowable cell volume.

delete-unused-nodes?
toggles the deleting of unused nodes during mesh initialization.

improve-mesh/
enters the improve mesh controls menu.

improve?
automatically improves the mesh.

laplace-smooth
enables you to specify the Laplace smoothing parameters.

skewness-smooth
enables you to specify the skewness smooth parameters.

swap
enables you to specify the face swap parameters.

improve-surface-mesh?
enables you to improve the surface mesh by swapping face edges where Delaunay violations occur.

max-cell-length
specifies the maximum allowable cell length.

max-cell-volume
specifies the maximum allowable cell volume.

merge-free-nodes?
enables/disables the merging of free nodes during mesh initialization.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 105
mesh/

non-fluid-type
selects the non-fluid cell zone type. After the mesh is initialized, any non-fluid zones will be set to
this type. If the mesh includes multiple regions (for example, the problem for which you are creating
the mesh includes a fluid zone and one or more solid zones), and you plan to refine all of them
using the same refinement parameters, modify the non-fluid type before generating the mesh.

Note

For zone-based meshing, if any cell zone has at least one boundary zone type as
inlet, it will automatically be set to fluid type. For object based meshing, volume
region type is used to determine the cell zone type.

refine-levels
sets the number of refinement levels.

refine-method
enables you to select the refinement method. You can select either skewness-based refinement
or the advancing front method.

remove-slivers/
enters the sliver remove controls menu.

angle
specifies the maximum dihedral angle for considering the cell to be a sliver

attempts
specifies the number of attempts overall to remove slivers.

iterations
specifies the number of iterations to be performed for the specific sliver removal operation.

low-skew
specifies the targeted skewness threshold above which cells will be improved. The improve
operation will attempt to improve cells with skewness above the low-skew value specified,
but there will be no attempt to reduce the skewness below the specified value. A limited set
of improve operations will be used as compared to the operations required for the skew value-
based improvement.

method
enables you to select the method for sliver removal. The default method used is the fast
method. The fast and the aggressive methods use the same controls and give similar
results for good quality surface meshes. In case of poor surface meshes, the aggressive
method will typically succeed in improving the mesh to a greater extent, but it may be slower
than the fast method.

remove?
enables/disables the automatic removal of slivers.

skew
specifies the skewness threshold for sliver removal.

skewness-method/
enters the skewness refinement controls menu.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
106 of ANSYS, Inc. and its subsidiaries and affiliates.
levels
specifies the number of refinement levels for skewness-based refinement.

max-skew-improve?
enables/disables the skewness-based improvement during refinement.

must-improve-skewness?
enables/disables the modification of the default auto refinement parameters in order to improve
skewness after refinement.

refine-boundary-cells?
enables/disables the automatic refinement of boundary cells during refinement.

refine-cells?
enables/disables the automatic refinement of cells during refinement.

skew-improve/
contains options for improving refinement by the skewness method. This sub-menu is available
when max-skew-improve? is enabled.

attempts
specifies the number of overall improvement attempts for the skewness method.

boundary-sliver-skew
specifies the boundary sliver skewness for the skewness method. This parameter is used
for removing sliver cells along the boundary.

iterations
specifies the number of improvement iterations in each attempt for the skewness method.

sliver-skew
specifies the sliver skewness for the skewness method. This parameter is used for removing
sliver cells in the interior.

target-low-skew
specifies the targeted skewness threshold above which cells will be improved. The improve
operation will attempt to improve cells with skewness above the target-low-skew
value specified, but there will be no attempt to reduce the skewness below the specified
value. A limited set of improve operations will be used as compared to the operations re-
quired for the target-skew value-based improvement. The value specified could be
approximately 0.1 lower than the target-skew value.

target-skew
specifies the targeted skewness during improvement for the skewness method.

target?
enables you to enable targeted skewness-based refinement for the skewness method. This
enables you to improve the mesh until the targeted skewness value is achieved.

smooth-mesh?
enables/disables the automatic smoothing of the mesh during refinement.

sort-boundary-faces?
enables/disables the automatic sorting of boundary faces by size during refinement.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 107
mesh/

sort-cells?
enables/disables the automatic reverse sorting of cells by skewness during refinement.

swap-faces?
enables/disables the automatic swapping of faces during refinement.

type
enables you to select the appropriate pre-defined skewness refinement parameters. You can
select default, fast-transition, or incremental-improve as required.

use-max-cell-size?
enables you to use the maximum cell size specified instead of recomputing the value based on
the objects, when the volume mesh is generated. This option is disabled by default.

delete-virtual-cells
deletes virtual cells created due to the use of the keep-virtual-entities? option.

improve/
enters the tet improve menu.

collapse-slivers
attempts to collapse the nodes of a skewed sliver cell on any one of its neighbors.

improve-cells
improves skewed tetrahedral cells.

refine-boundary-slivers
attempts to increase the volume of boundary slivers to create a valid tet cell. Tetrahedra having
one or two faces on the boundary are identified and then the appropriate edge split. The split
node is then smoothed such that the volume of the tetrahedron increases, thereby creating a valid
tet cell.

refine-slivers
attempts to remove the sliver by placing a node at or near the centroid of the sliver cell. Swapping
and smoothing are performed to improve the skewness. You can also specify whether boundary
cells are to be refined. Refining the boundary cells may enable you to carry out further improvement
options such as smoothing, swapping, and collapsing slivers.

skew-smooth-nodes
applies skewness-based smoothing to nodes on the tetrahedral cell zones to improve the mesh
quality.

sliver-boundary-swap
removes boundary slivers by moving the boundary to exclude the cells from the zone.

smooth-boundary-sliver
smooths nodes on sliver cells having all four nodes on the boundary until the skewness value is
less than the specified value. The default values for the skewness threshold, minimum dihedral
angle between boundary faces, and feature angle are 0.985, 10, and 30, respectively.

smooth-interior-sliver
smooths non-boundary nodes on sliver cells having skewness greater than the specified threshold
value. The default value for the skewness threshold is 0.985.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
108 of ANSYS, Inc. and its subsidiaries and affiliates.
 smooth-nodes
enables you to apply either Laplacian or variational smoothing to nodes on the tetrahedral cell
zones to improve the mesh quality.

swap-faces
performs interior face swapping to improve cell skewness.

init
generates the initial Delaunay mesh by meshing the boundary nodes.

init-refine
generates the tetrahedral mesh.

local-regions/
enters the local refinement menu.

activate
activates the specified regions for refinement.

deactivate
deactivate the specified regions for refinement.

define
defines the refinement region according to the specified parameters.

delete
deletes the specified refinement region.

ideal-vol
reports the volume of an ideal tetrahedron for the edge length specified.

init
defines the default refinement region encompassing the entire geometry.

list-all-regions
lists all refinement region parameters and the activated regions in the console.

refine
refines the active cells inside the selected region based on the specified refinement parameters.

preserve-cell-zone
allows you to specify the cell zones to be preserved during the meshing process.

refine
refines the initialized mesh.

trace-path-between-cells
detects holes in the geometry by tracing the path between the two specified cells

thin-volume-mesh/
creates a sweep-like mesh for a body occupying a thin gap. You define source and target boundary faces
zones (the source face normal should point to the target). The source face mesh may be triangles or quads.

create
initiates the dialog box to specify source and target faces and specify the following parameters

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 109
mesh/

Gap Thickness
Helps Fluent Mesher determine the region to be remeshed. If set to 0, the mesher will automatically
calculate the gap thickness. If non-zero, the Gap Thickness defines the maximum separation
between source and target zones in the swept-mesh region (default = 0).

Number of Divisions
Specifies the number of layers created between source and target faces (default = 1).

Growth Rate
Specifies the maximum thickness ratio between two adjacent layers (default = 1).

Remesh Overlap Zones

If yes, any overlapped part of the surface mesh on the target and adjacent faces will be remeshed.
Original meshes are replaced (default = yes).

An example create dialog box:

Meshing/mesh/thin-volume-mesh/create
()
Source face zones(1) [()] source*
Source face zones(2) [()]
()
Target face zones(1) [()] target
Target face zones(2) [()]
Gap Thickness [0] 1
Number of Divisions [1] 5
Growth Rate [1]
Remesh Overlap Zones? [yes]
Start thin-gap mesh:
- Create and project nodes and faces on targets …
- Project nodes on targets ...
- Create layer nodes ...
- Create side quad faces ...
- Create interior layer cells ...
- Retriangluate target face zones ...
- Retriangulate adjacent face zones ...
Done

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
110 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 11: objects/
cad-association/
contains options for modifying the selected objects based on the associated CAD entities and attaching/de-
taching the CAD entities from the objects. This menu is available when the CAD Assemblies tree is created
during CAD import.

attach-cad
attaches CAD entities to the selected geometry/mesh objects. Select the geometry/mesh objects and
specify the path for the CAD entities to be associated with the objects. The selected geometry/mesh
objects will be associated with the CAD entities which will then be locked.

detach-all-objects
detaches all the CAD objects associated with the geometry/mesh objects. Specify the type of objects
(geom or mesh) to be detached. All association will be removed and the geometry/mesh objects will
be independent of changes to the CAD entities.

detach-objects
detaches the CAD objects associated with the specified geometry/mesh objects. All association will
be removed and the selected geometry/mesh objects will be independent of changes to the CAD en-
tities.

query-object-association
returns a list of the CAD entities associated with the objects selected.

restore-cad
restores the geometry/mesh objects from the associated CAD objects.

unlock-cad
unlocks the CAD objects associated with the selected geometry/mesh objects.

update-objects
updates the specified geometry/mesh objects based on changes to the associated CAD objects.

update-all-objects
updates all geometry/mesh objects based on changes to the associated CAD objects. Specify the type
of objects (geom or mesh) to be updated.

change-object-type
allows you to change the object type (geom, or mesh).

check-mesh
checks the mesh on the specified objects for connectivity and orientation of faces. The domain extents,
volume statistics, and face area statistics will be reported along with the results of other checks on the
mesh.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 111
objects/

create
creates the object based on the priority, cell zone type, face zone(s), edge zone(s), and object type specified.
You can specify the object name or retain the default blank entry to have the object name generated
automatically.

create-and-activate-domain
creates and activates the domain comprising the face zone(s) from the object(s) specified.

create-groups
creates a face group and an edge group comprising the face zone(s) and edge zone(s) included in the
specified object(s), respectively.

create-intersection-loops
allows you to create intersection loops for objects.

• The collectively option creates an interior edge loop at the intersection between two adjacent
face zones included in the same object and between multiple objects.

• The individually option creates an interior edge loop at the intersection between two adjacent
face zones included in the same object.

create-multiple
creates multiple objects by creating an object per face zone specified. The objects will be named automat-
ically based on the prefix and priority specified.

create-new-mesh-object/
contains options for creating a new mesh object by wrapping or remeshing existing objects.

remesh
creates a new mesh object by remeshing geometry objects individually or collectively.

wrap
creates a new mesh object by wrapping the specified objects individually or collectively.

delete
deletes the specified object(s).

delete-all
deletes all the defined objects.

delete-all-geom
deletes all the defined geom objects.

delete-unreferenced-faces-and-edges
deletes all the faces and edges that are not included in any defined objects.

extract-edges
extracts the edge zone(s) from the face zone(s) included in the specified object(s), based on the edge-
feature-angle value specified (/objects/set/set-edge-feature-angle).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
112 of ANSYS, Inc. and its subsidiaries and affiliates.
improve-feature-capture
enables you to imprint the edges comprising the object on to the object face zones to improve feature
capture for mesh objects. You can specify the number of imprinting iterations to be performed.

Note

The geometry objects used to create the mesh objects should be available when the
improve-feature-capture command is invoked. Additionally, the face zones
comprising the objects should be of type other than geometry.

improve-object-quality
enables you to improve the surface mesh quality for mesh objects. Select the mesh objects and the
method for improving the surface mesh. The smooth-and-improve method improves the mesh by a
combination of smoothing, swapping, and surface mesh improvement operations. Object normals are
correctly oriented and island faces are also deleted. You can optionally coarsen the surface mesh by spe-
cifying a suitable coarsening factor. Additional imprinting operations can be done to improve feature
capture on the surface mesh. The surface-remesh method improves the mesh by remeshing based
on the current size field. Object normals are correctly oriented and island faces are also deleted.

join-intersect/
contains options for connecting overlapping and intersecting face zones.

add-objects-to-mesh-object
allows you to specify one or more mesh objects to be added to an existing mesh object.

change-region-type
allows you to select a cell zone type (solid, fluid or dead) for a specific region.

compute-regions
closed cell zone regions are computed from the specified mesh object. You may include a material
point, if desired.

controls/

remesh-post-intersection?
used to enable or disable automatic post-remesh operation after join or intersect.

create-mesh-object
allows you to specify one or more mesh objects to be connected in one mesh object.

delete-region
removes a closed cell zone region and all of its face zones, except those which are shared by other
regions, from the specified mesh object.

intersect
connects two intersecting face zones within specified angle and tolerance.

join
connects two overlapping face zones within specified angle and tolerance.

list-regions
lists details of region type, volume, material point, and comprising face zones for the topological regions
computed for the specified mesh object.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 113
objects/

merge-regions
specified regions are joined into a single region.

rename-region
enables you to specify a new name for a specified region.

labels/
contains options for creating and managing face zone labels.

add-zones
adds the specified face zones to the existing face zone label for an object.

create
creates a new face zone label for the specified face zones.

create-label-per-object
creates a new face zone label for all the face zones in every object.

create-label-per-zone
creates a new face zone label for each face zone in the object.

delete
deletes the specified face zone labels.

label-unlabeled-zones
creates labels for unlabeled face zones within the specified object. You can either use the object name
as the label or provide your own label.

merge
merges the specified face zone labels to a single label with the name specified.

remove-all-labels-on-zones
removes all the face zone labels for the specified face zones. This command is applicable to geometry
objects only.

remove-zones
removes the specified face zones from the existing face zone label for an object.

rename
renames the specified face zone label.

list
lists details such as cell zone type, priority, object type, comprising face and edge zones, and object reference
point for all the defined objects.

merge
merges the specified objects into a single object.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
114 of ANSYS, Inc. and its subsidiaries and affiliates.
merge-edges
merges all the edge zones in an object into a single edge zone.

Note

If the object is composed of edge zones of different types (boundary and interior), the
edge zones of the same type (boundary or interior) will be merged into a single edge
zone.

merge-nodes
merges the free nodes at the object level based on the specified tolerance or using a tolerance that is a
specified percentage of shortest connected edge length.

merge-voids
allows you to merge voids in the mesh object after the sewing operation.

merge-walls
merges all the face zones of type wall in an object into a single face zone.

remove-gaps/
contains options for removing gaps between the mesh objects specified or removing the thickness in the
mesh objects specified.

ignore-orientation?
allows you to set whether the orientation of the normals should be taken into account while identifying
the gap to be removed.

remove-gaps
allows you to remove gaps between the mesh objects specified or remove the thickness in the mesh
objects specified. Select the appropriate repair option and specify the other parameters required.

show-gaps
marks the faces at the gap between mesh objects based on the gap distance and percentage margin
specified.

rename-cell-zone-boundaries-using-labels
renames the boundaries of the cell zones based on the existing face zone labels. This allows for the cell
zone boundaries in solution mode to have names corresponding to the face zone labels in meshing mode.

Note

This command will not work if you read in a volume mesh generated in a version prior
to release 16.2. In such cases, regenerate the volume mesh before using the command.

rename-object-zones
renames the face and edge zones comprising the object based on the object name. You can also specify
the separator to be used.

restore-faces
restores the mesh object surface mesh from the backup created. The current mesh object face zones and
cell zones will be deleted.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 115
objects/

If the object backup is disabled (/mesh/auto-mesh-controls/backup-object no), you

will not be able to restore the surface mesh using this command.

Note

There may be a difference in the initial volume mesh generated for an object and that
generated after restoring the object surface mesh due to differences in the order of
zones/entities processed during volume meshing.

rotate
rotates the object(s) based on the angle of rotation, pivot point, and axis of rotation specified.

scale
scales the object(s) based on the scale factors specified.

separate-faces-by-angle
separates the face zone(s) comprising the object based on the angle specified.

separate-faces-by-seed
separates the face zone(s) comprising the object based on the seed face specified.

set/
contains options for setting additional object-related settings.

set-edge-feature-angle
sets the edge feature angle to be used for extracting edge zone(s) from the face zone(s) included in
the object(s).

show-edge-zones?
displays the edge zone(s) comprising the object(s) drawn in the graphics window.

show-face-zones?
displays the face zone(s) comprising the object(s) drawn in the graphics window.

sew/
contains options related to the object sewing operation.

sew
connects the mesh objects to generate the conformal surface mesh.

set/
contains additional options related to the object sewing operation.

include-thin-cut-edges-and-faces
allows better recovery of thin region configurations during the sewing operation.

process-slits-as-baffles?
allows you to collapse the nearly overlapping surfaces corresponding to the baffle when the sew
operation is performed to create the mesh object. Specify the maximum slit thickness relative to
the minimum size specified and the parallel face angle between the faces comprising the slit when
process-slits-as-baffles is enabled.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
116 of ANSYS, Inc. and its subsidiaries and affiliates.
 zone-name-prefix
allows you to specify a prefix for the zones included in the mesh object created using the sew op-
eration.

translate
translates the object(s) based on the translation offsets specified.

update
allows you to update the objects defined when the face and/or edge zone(s) comprising the object have
been deleted.

volumetric-regions/
contains options for manipulating volumetric regions and generating the volume mesh.

auto-fill-volume
creates the volume mesh for the selected volumetric regions based on the meshing parameters set.

change-type
enables you to change the region type.

compute
computes the volumetric regions based on the face zone labels. You can choose to use existing mater-
ial points for computing the regions.

Note

When regions are computed, region names and types will be based on the face zone
labels of the mesh object selected. If regions are recomputed, all previous region
names and types will be over written.

delete
deletes the specified volumetric regions.

Tip

Deleting regions may cause face zones to be deleted. It is recommended that the
region type be changed to dead instead of deleting the region.

delete-cells
deletes the cell zones of the specified regions.

hexcore/
contains options for setting hexcore mesh controls.

list
prints region information to the console, including type, volume, material point and face zones.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 117
objects/

merge
merges specified regions in to a single region.

Note

If there are shared face zones, merging regions will delete the shared face zones.
However, if there are cell zones associated with the regions, then merging the regions
will not delete the shared face zones. In this case, the shared face zones will be deleted
when the cell zones are deleted.

rename
renames the region.

scoped-prism/
contains options for setting scoped prism controls.

tet/
contains options for setting tetrahedral mesh controls.

update
recomputes the selected volumetric region(s) while preserving the region name(s) and type(s).

wrap/
contains options related to the object wrapping operation.

check-holes
allows you to check for holes in the objects. The number of hole faces marked will be reported.

recover-periodic-surfaces
allows you to reestablish the periodic relationship between master and shadow face zones on the
mesh object. You will be prompted for the method and to identify the periodic face zones to be re-
covered.

auto
performs the automatic periodic recovery method using either the master or shadow periodic face
zones. Periodic recovery will be attempted in both directions without additional prompting.

manual
performs the manual periodic recovery method. You will be prompted for periodic and shadow
face zones, and for the periodic source. The periodic source may be from an underlying periodic
geometry surface or manual entry of the rotational periodic parameters (angle, origin, axis).

Note

Only rotational periodicity is supported, translational periodicity is not supported

currently.

set/
contains additional options related to the object wrapping operation.

add-geometry-recovery-level-to-zones
enables you to set the geometry recovery level (high or low) for the specified face zones.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
118 of ANSYS, Inc. and its subsidiaries and affiliates.
 include-thin-cut-edges-and-faces
allows better recovery of thin region configurations during the object wrapping operation.

list-zones-geometry-recovery-levels
lists the zones based on geometry recovery level specified.

max-free-edges-for-hole-patching
allows you to set the maximum number of free edges in a loop to fill the holes.

minimum-relative-topo-area
specifies the minimum relative topological area for shrink wrapping.

minimum-relative-topo-count
specifies the minimum relative topological count for shrink wrapping.

minimum-topo-area
specifies the minimum topological area for shrink wrapping.

minimum-topo-count
specifies the minimum topological count for shrink wrapping.

relative-feature-tolerance
specifies the relative feature tolerance for shrink wrapping.

report-holes?
allows you to check for holes in the mesh object created. Holes, if any will be reported at the end
of the object wrapping operation.

resolution-factor
sets the resolution factor for shrink wrapping. This option can be used to set sampling coarser or
finer than the final surface mesh.

shrink-wrap-rezone-parameters
allows you to set the parameters for improving the mesh object surface quality using rezoning.
The geometry object zones will be separated based on the separation angle specified to improve
the feature imprinting on the mesh object.

zone-name-prefix
allows you to specify a prefix for the zones included in the mesh object created using the object
wrapping operation.

wrap
creates the mesh objects based on the geometry objects selected and other object wrapping parameters
specified.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 119
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
120 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 12: parallel/
agglomerate
recombine distributed mesh data into a single partition on compute node 0.

auto-partition?
automatically partitions prism base zones for parallel meshing.

distribute
allocate mesh to the compute nodes based on the computed partitions.

print-partition-info
display computed partition data to the console.

spawn-solver-processes
specifies the number of solver processes. Additional processes will be spawned as necessary when
switching to solution mode. You will also be prompted for (Linux and mixed Windows/Linux) interconnect
type, machine list or host file, and (Linux and mixed Windows/Linux) option to be used.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 121
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
122 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 13: report/
boundary-cell-quality
reports the number and quality limits of boundary cells containing the specified number of boundary
faces. If you specify zero for number of boundary faces, you will be prompted for number of
boundary nodes.

cell-distribution
reports the distribution of cell quality or size based on the bounding limits and number of partitions spe-
cified.

cell-quality-limits
reports the cell quality limits.

cell-size-limits
reports the cell size limits.

cell-zone-at-location
returns the cell zone at or closest to the specified location.

cell-zone-volume
reports the volume of the specified cell zone.

edge-size-limits
reports the edge size limits.

face-distribution
reports the distribution of face quality or size based on the bounding limits and number of partitions
specified.

face-node-degree-distribution
reports the distribution of boundary faces based on face node degree. The node degree is the number of
faces connected to the node. Specify the list of boundary face zones and the minimum and maximum face
node degree to be reported. You can also consider only internal nodes, if required.

face-quality-limits
reports the face quality limits.

face-size-limits
reports the face size limits.

face-zone-area
reports the area of the specified face zone.

face-zone-at-location
reports the face zone at the given location.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 123
report/

list-cell-quality
reports a list of cells with the specified quality measure within a specified range. The valid prefixes are bn
(boundary node), n (node), bf (boundary face), f (face), and c (cell).

memory-usage
reports the amount of memory used for all nodes, faces, and cells, and the total memory allocated.

mesh-size
reports the number of nodes, faces, and cells in the mesh.

mesh-statistics
writes mesh statistics (such as zone information, number of cells, faces, and nodes, range of quality and
size) to an external file.

neighborhood-quality
reports the maximum skewness, aspect ratio, or size change of all cells using a specified node.

number-meshed
reports the number of elements that have been meshed.

print-info
prints information about individual components of the mesh. This command also appears in the boundary
menu. When you use this command, you will be prompted for an “entity” (that is, a node, face, or cell). An
entity name consists of a prefix and an index. For a description of the displayed information see Reporting
Mesh Information

quality-method
specifies the method to be used for reporting face and cell quality.

unrefined-cells
reports the number of cells that have not been refined.

update-bounding-box
updates the bounding box.

verbosity-level
specifies how much information should be displayed during mesh initialization, refinement and other
operations. Changing the value to 2 from the default value of 1 will produce more messages, while changing
it to 0 will disable all messages.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
124 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 14: scoped-sizing/
compute
computes the size field based on the defined size functions and/or scoped size controls.

create
defines the scoped size based on the specified parameters.

delete
deletes the specified scoped size controls.

delete-all
deletes all the defined scoped size controls.

delete-size-field
deletes the current size field.

list
lists all the defined scoped size controls and the corresponding parameter values defined.

list-zones-uncovered-by-controls
lists the zones for which no scoped sizing controls have been defined.

modify
modifies the scoped size control definition.

read
enables you to read in a scoped sizing file (*.szcontrol).

validate
validates the scoped sizing controls defined. An error will be reported if the scoped sizing controls do not
exist or the scope for one (or more) controls is invalid.

write
enables you to write a scoped sizing file (*.szcontrol).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 125
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
126 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 15: size-functions/
Size functions can be defined using the commands in the size-functions menu. The command
size-functions/create enables you to define size functions. You need to specify the size function
type, whether face or edge zones are to be used, the boundary or edge zones for which the size function
is to be defined, the size function name, and the parameters relevant to the size function type. You can
also have the name generated automatically by retaining the default entry for the size function name.
The size function name will be assigned based on the zone type (face or edge) and the size function
type (for example, the size function face-curvature-sf-5 indicates that the curvature size function is
defined for face zones. The size function ID is 5.)

An example is
size-functions/create curvature face wall:x wall:y, curv-size-function 0.01 0.1 1.2 5

where, curvature is the size function type, face indicates that face zones are to be used, wall:x,
wall:y indicate the boundary zones for which the size function is defined, and curv-size-function
is the size function name. The remaining values correspond to the parameters for the curvature size
function, that is, minimum and maximum size, growth rate, and normal angle.

Note

All boundary face zones and edge zones included in the global domain are available for
defining size functions, even if a local domain has been activated.

compute
computes the size function based on the defined parameters.

contours/
contains options for managing contours.

draw
displays contours in the graphics window. Run compute prior to contours/draw.

set/
contains options to manage the contour size.

refine-facets?
allows you to specify smaller facets if the original are too large. Default is no.

create
defines the size function based on the specified parameters.

create-defaults
creates default size functions based on face and edge curvature and proximity.

delete
deletes the specified size function or the current size field.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 127
size-functions/

delete-all
deletes all the defined size functions.

disable-periodicity-filter
removes periodicity from the size field.

enable-periodicity-filter
applies periodicity to the size field.

Specify the angle, pivot, and axis of rotation to set up periodicity.

If periodicity has been previously defined, the existing settings will be applied.

Note

Only rotational periodicity is supported, translational periodicity is not supported currently.

list
lists all the defined size functions and the corresponding parameter values defined.

reset-global-controls
resets the global controls to their default values.

set-global-controls
sets the values for the global minimum and maximum size, and the growth rate.

Note

If you set the global minimum size to a value greater than the local minimum size defined
for existing proximity, curvature, or hard size functions, a warning will appear, indicating
that the global minimum size cannot be greater than the specified local minimum size.

set-prox-gap-tolerance
sets the tolerance relative to minimum size to take gaps into account. Gaps whose thickness is less than
the global minimum size multiplied by this factor will not be regarded as a proximity gap.

set-scaling-filter
allows you specify the scale factor, and minimum and maximum size values to filter the size output from
the size field.

triangulate-quad-faces?
identifies the zones comprising non-triangular elements and uses a triangulated copy of these zones for
computing the size functions.

use-cad-imported-curvature?
allows you to disable curvature data from the nodes of the CAD facets.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
128 of ANSYS, Inc. and its subsidiaries and affiliates.
Chapter 16: switch-to-solution-mode
switch-to-solution-mode
enables you to transfer the mesh data from meshing mode to solution mode in ANSYS Fluent. When you
use the switch-to-solution-mode command, you will be asked to confirm that you want to switch
to solution mode.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 129
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
130 of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix A. Query and Utility Functions
The following sections describe the query and utility functions available:
A.1. List Queries and Utility Functions
A.2. Label Utility Functions
A.3. Report Utility Functions
A.4. Diagnostic Based Marking Utility Functions
A.5. Mesh Setup Utility Functions
A.6. Mesh Operation Utility Functions
A.7. Miscellaneous Functions

A.1. List Queries and Utility Functions

When performing a series of operations, you may want to list all the zones of a particular type, group,
or containing a particular text string or name pattern. You can also query zones through the TUI based
on a regular expression and a specified variable. You can:

• Identify face/cell zones closest to a specified location.

• Identify zones/objects of a specific type or containing a particular text string. You can also identify zones
belonging to a group or object.

• Obtain object region and face zone label lists.

• Obtain mesh setup information such as zones with prism mesh settings or prism controls defined

• Use the utility functions to determine the zones created during a particular operation by performing Boolean
operations on lists returned by specific functions.

• Use the eval-expr function to evaluate the lists returned by the functions in order that they can be used
as input in the text user interface commands.

Feature Description Utility Function

Zone By location Return face zone at or closest to a (get-face-zone-at-location
query specified location '(x y z))
Return cell zone at or closest to a (get-cell-zone-at-location
specified location '(x y z))
Zone lists By zone Return a list of zones of the specified (get-zones-of-type 'type)
type default zone type
By default Return a list of zones of the specified (get-zones-of-group 'group)
group default zone group or user-defined
group
By filter Return a list of zones whose names (get-face-zones-of-filter
string contain the specified filter string 'filter)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 131
Query and Utility Functions

Feature Description Utility Function

(get-cell-zones-of-filter
'filter)
(get-edge-zones-of-filter
'filter)
(get-node-zones-of-filter
'filter)
By object Return a list of face zones in the (get-face-zones-of-objects
specified objects '(object-list))
Return a list of face zones by ID in the (tgapi-util-get-face-zone-
specified object id-list-of-object 'object)
(tgapi-util-get-face-zone-
id-list-of-object "object")
Return a list of face zones by ID in the (tgapi-util-get-face-zone-
specified regions of an object id-list-of-regions 'object
'(region-list))
(tgapi-util-get-face-zone-
id-list-of-regions "object"
'(region-list))
Return a list of edge zones in the (get-edge-zones-of-objects
specified objects '(object-list))
Return a list of edge zones by ID in (tgapi-util-get-edge-zone-
the specified object id-list-of-object 'object)
(tgapi-util-get-edge-zone-
id-list-of-object "object")
Return a list of cell zones by ID in the (tgapi-util-get-cell-zone-
specified object id-list-of-object 'object)
(tgapi-util-get-cell-zone-
id-list-of-object "object")
Return a list of face zones in the (get-face-zones-of-labels
specified face zone labels of the 'object '(list-of-label-
object specified names))
Return a list of face zones by ID in the (tgapi-util-get-face-zone-
specified face zone labels of an object id-list-of-labels 'object
'(face-zone-label-list))
(tgapi-util-get-face-zone-
id-list-of-labels "object"
'(face-zone-label-list))
Return a list of face zones shared by (get-face-zones-shared-by-
regions of specified types in the mesh regions-of-type 'mesh-ob-
object specified, where region- ject 'region-type)
type is fluid-fluid, solid-
solid, or fluid-solid
Return a list of face zones in the (get-face-zones-of-regions
specified regions 'object '(list-of-region-
names))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
132 of ANSYS, Inc. and its subsidiaries and affiliates.
 List Queries and Utility Functions

Feature Description Utility Function

By cell Return a list of prism cell zones (tgapi-util-get-prism-cell-
shape zones '(zone-list))
(tgapi-util-get-prism-cell-
zones "zone-name-pattern*")
Return a list of tet cell zones (tgapi-util-get-tet-cell-
zones '(zone-list))
(tgapi-util-get-tet-cell-
zones "zone-name-pattern*")
By Return adjacent cell zones for given (tgapi-util-get-adjacent-
connectivity face zone cell-zones zone-id)
(tgapi-util-get-adjacent-
cell-zones 'zone-name)
(tgapi-util-get-adjacent-
cell-zones "zone-name")
Return adjacent boundary face zones (tgapi-util-get-adjacent-
for given cell zones. face-zones '(cell-zone-
list))
(tgapi-util-get-adjacent-
face-zones "cell-zone-name-
pattern*")
Return adjacent interior and boundary (tgapi-util-get-adjacent-
face zones for given cell zones. interior-and-boundary-face-
zones '(cell-zone-list))
(tgapi-util-get-adjacent-
interior-and-boundary-face-
zones "cell-zone-name-pat-
tern*")
Return adjacent zones based on edge (tgapi-util-get-adjacent-
connectivity zones-by-edge-connectivity
'(zone-list))
(tgapi-util-get-adjacent-
zones-by-edge-connectivity
"zone-name-pattern*")
Return adjacent zones based on node (tgapi-util-get-adjacent-
connectivity zones-by-node-connectivity
'(zone-list))
(tgapi-util-get-adjacent-
zones-by-node-connectivity
"zone-name-pattern*")
Returns the number of faces and the (tgapi-util-get-shared-
boundary face zones that are shared boundary-zones 'cell-zone-
with the specified cell zones. name)
(tgapi-util-get-shared-
boundary-zones '(cell-zone-
list))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 133
Query and Utility Functions

Feature Description Utility Function

(tgapi-util-get-shared-
boundary-zones "cell-zone-
name-pattern*")
Mesh setup Return a list of face zones with (tgapi-util-get-face-zones-
zone-specific prism settings applied with-zone-specific-prisms-
applied)
Return a list of face zones to which (tgapi-util-get-face-zones-
the specified prism controls apply of-prism-controls "control-
name")
Return the baffle zones based on the (tgapi-util-get-baffles
face zone list specified '(face-zone-list))
Return the embedded baffle zones (tgapi-util-get-embedded-
baffles)
Wrapped Return a list of wrapped face zones (get-wrapped-zones)
zones
Unreferenced Return a list of unreferenced zones (get-unreferenced-edge-
zones zones)
(get-unreferenced-face-
zones)
(get-unreferenced-cell-
zones)
Return a list of unreferenced zones (get-unreferenced-edge-
whose names contain the specified zones-of-filter 'filter)
filter string (get-unreferenced-face-
zones-of-filter 'filter)
(get-unreferenced-cell-
zones-of-filter 'filter)
Return a list of unreferenced zones (tgapi-util-get-unrefer-
by ID, whose names contain the enced-face-zone-id-list-of-
specified pattern pattern "pattern*")
(tgapi-util-get-unrefer-
enced-cell-zone-id-list-of-
pattern "pattern*")
(tgapi-util-get-unrefer-
enced-edge-zone-id-list-of-
pattern "pattern*")
Mesh Return cell zone with maximum (tgapi-util-get-maxsize-
statistics volume for given list or pattern of cell cell-zone-by-volume "pat-
zones tern*")
(tgapi-util-get-maxsize-
cell-zone-by-volume '(zone-
list))
Return cell zone with maximum count (tgapi-util-get-maxsize-
of elements for given list or pattern cell-zone-by-count "pat-
of cell zones tern*")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
134 of ANSYS, Inc. and its subsidiaries and affiliates.
 List Queries and Utility Functions

Feature Description Utility Function

(tgapi-util-get-maxsize-
cell-zone-by-count '(zone-
list))
Return face zone with minimum area (tgapi-util-get-minsize-
for given list or pattern of face zones face-zone-by-area "pat-
tern*")
(tgapi-util-get-minsize-
face-zone-by-area '(zone-
list))
Return face zone with minimum count (tgapi-util-get-minsize-
of elements for given list or pattern face-zone-by-count "pat-
of face zones tern*")
(tgapi-util-get-minsize-
face-zone-by-count '(zone-
list))
Return a list of face zones with a (tgapi-util-get-face-zone-
count below the maximum entity list-by-maximum-entity-
count (maximum-entity-count) count maximum-entity-count
specified. You can choose to restrict only-boundary?)
the report to only boundary face
zones, if required (only-boundary?
set to #t or #f).
Return a list of edge zones with a (tgapi-util-get-edge-zone-
count below the maximum entity list-by-maximum-entity-
count (maximum-entity-count) count maximum-entity-count
specified. You can choose to restrict only-boundary?)
the report to only boundary edge
zones, if required (only-boundary?
set to #t or #f).
Return a list of cell zones with a count (tgapi-util-get-cell-zone-
below the maximum entity count list-by-maximum-entity-
(maximum-entity-count) count maximum-entity-count)
specified.
Return a list of face zones with a (tgapi-util-get-face-zone-
maximum zone area below the max- list-by-maximum-zone-area
imum-zone-area specified. maximum-zone-area)
Return a list of face zones with a (tgapi-util-get-face-zone-
minimum zone area above the min- list-by-minimum-zone-area
imum-zone-area specified. minimum-zone-area)
Mesh Return a list of zones with free faces (tgapi-util-get-zones-with-
diagnostics for the face zones specified free-faces '(zone-id-list))
(tgapi-util-get-zones-with-
free-faces '(zone-name-
list))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 135
Query and Utility Functions

Feature Description Utility Function

(tgapi-util-get-zones-with-
free-faces "zone-name-pat-
tern*")
Return a list of zones with (tgapi-util-get-zones-with-
multi-connected faces for the face multi-faces '(zone-id-
zones specified list))
(tgapi-util-get-zones-with-
multi-faces '(zone-name-
list))
(tgapi-util-get-zones-with-
multi-faces "zone-name-pat-
tern*")
Return a list of overlapping face zones (tgapi-util-get-overlap-
based on the area-tolerance and ping-face-zones "face-zone-
distance-tolerance specified name-pattern*" area-toler-
ance distance-tolerance)
Return a list of zones with marked (tgapi-util-get-zones-with-
faces for the face zones specified marked-faces '(zone-id-
list))
(tgapi-util-get-zones-with-
marked-faces '(zone-name-
list))
(tgapi-util-get-zones-with-
marked-faces "zone-name-
pattern*")
Object By name Return a list of all objects (tgapi-util-get-all-object-
lists name-list)
By type Return a list of objects of the specified (get-objects-of-type 'type)
type (tgapi-util-get-object-
name-list-of-type 'type)
By filter Return a list of objects whose names (get-objects-of-filter
contain the specified filter string 'filter)
Region By object Return a list of regions in the (get-regions-of-object 'ob-
lists specified object ject)
(tgapi-util-get-region-
name-list-of-object 'ob-
ject)
(tgapi-util-get-region-
name-list-of-object "ob-
ject")
By filter Return a list of regions in the (get-regions-of-filter 'ob-
specified object, whose names ject 'filter)
contain the specified filter string

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
136 of ANSYS, Inc. and its subsidiaries and affiliates.
 List Queries and Utility Functions

Feature Description Utility Function

By name Return a list of regions in the (tgapi-util-get-region-
pattern specified object, whose names name-list-of-pattern 'ob-
contain the specified name pattern ject "region-name-pat-
tern*")
(tgapi-util-get-region-
name-list-of-pattern "ob-
ject" "region-name-pat-
tern*")
By face Return a list of regions containing the (get-regions-of-face-zones
zones face zones specified '(list-of-face-zone-IDs))
(tgapi-util-get-region-
name-list-of-face-zones
'(list-of-face-zone-IDs))
(tgapi-util-get-region-
name-list-of-face-zones
"face-zone-name-pattern*")
Overlapping Based on Return the pairs of overlapping face (tgapi-util-find-join-pairs
zone pairs join zones based on the join tolerance and '(face-zone-name-list)
tolerance feature angle. join-tolerance absolute-
and feature tolerance? join-angle)
angle • Specify the face zones using a
(tgapi-util-find-join-pairs
face-zone-name-list, face-
'(face-zone-id-list) join-
zone-ID-list, or face-zone-
tolerance absolute-toler-
name-pattern*.
ance? join-angle)
• Specify the tolerance value for (tgapi-util-find-join-pairs
locating the overlapping faces "face-zone-name-pattern*"
(join-tolerance). join-tolerance absolute-
tolerance? join-angle)
• Choose to use an absolute tolerance
value or relative to face edges (set
absolute-tolerance to #t or
#f).

• Specify the feature angle to identify

features in the overlap region
(feature-angle). The default
value is 40.

Each member in the list returned

includes the zone IDs for the
overlapping zone pair and the
join region represented by the
bounding box. The same pair of
zones may appear multiple times
(with different join region
bounding box coordinates) in the
returned list.

The returned list is of the format:

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 137
Query and Utility Functions

Feature Description Utility Function

((pair1_zone-id1
pair1_zone-id2 (join-re-
gion-bounding-box-min x y
z) (join-region-bounding-
box-max x y z))
(pair2_zone-id1 pair2_zone-
id2 (join-region-bounding-
box-min x y z) (join-re-
gion-bounding-box-max x y
z)) ...)

For example:
((2 5 (-211.40 -139.24 -
165.17) (46.36 -101.69 -
124.61)) (2 5 (-211.4 -
204.94 -55.89) (46.29 -
171.68 -12.16)) (7 8 (-
170.82 140.79 -108.57)
(5.83 162.47 -89.04)))
List Convert Convert a list of zone name symbols (tgapi-util-convert-zone-
operations to a list of IDs name-symbols-to-ids '(zone-
name-list))
Convert a list of zone name strings to (tgapi-util-convert-zone-
a list IDs name-strings-to-ids '(zone-
name-list))
Convert a list of zone IDs to a list of (tgapi-util-convert-zone-
name strings ids-to-name-strings '(zone-
id-list))
Convert a list of zone IDs to a list of (tgapi-util-convert-zone-
name symbols ids-to-name-symbols '(zone-
id-list))
Convert a list of symbols to strings (tgapi-util-convert-symbol-
list-to-string '(symbol-
list))
Create a string from a list of symbols (tgapi-util-create-string-
from-symbol-list '(symbol-
list))
Subtract Returns the boolean subtraction of (tgapi-util-integer-list-
the lists subtract '(list-1) '(list-
2))
Replace Enables you to replace one element (tgapi-util-list-replace
in a list by another new-element old-element
input-list)
Remove Enables you to remove an element (tgapi-util-remove-element-
from a list from-list input-list ele-
ment)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
138 of ANSYS, Inc. and its subsidiaries and affiliates.
 List Queries and Utility Functions

Feature Description Utility Function

Search Enables you to search for an element (tgapi-util-list-contains?
in a list. input-list element)

A.1.1. Using Boolean Operations with Lists

You can perform Boolean operations on lists returned by the query functions:

• Union of lists: (list-union list-1 list-2 ...)

• Intersection of lists: (list-intersection list-1 list-2 ...)

• Subtraction of lists: (list-subtract list-1 list-2)

Note

Only two lists can be used as arguments for the subtraction operation.

For example,
list-1 = '(1 2 3 4)
list-2 = '(1 5 6)
list-3 = '(1 4 7)

then:
(list-union list-1 list-2 list-3) = '(1 2 3 4 5 6 7)
(list-intersection list-1 list-2 list-3) = '(1)
(list-subtract list-1 list-2) = '(2 3 4)

A.1.2. Examples
• Smoothing the prism-cap zone created during the prism creation operation:

– Obtain a list of the zones named prism-cap*.

(define initial-zones(get-face-zones-of-filter 'prism-cap*))

– Apply appropriate prism parameters and create prisms.

– Obtain a list of the zones named prism-cap* after the prism creation operation.

(define final-zones(get-face-zones-of-filter 'prism-cap*))

– Smooth the recently created prism-cap zone.

/boundary/improve/smooth(eval-expr '(list-subtract final-zones initial-

zones))

• Improving mesh object quality:

/objects/improve-object-quality (get-objects-of-type 'mesh) smooth-and-

improve 1 no

• Recovering periodic surfaces for mesh object face zones:

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 139
Query and Utility Functions

/boundary/recover-periodic-surfaces auto (get-face-zones-of-label

'_fluid '(periodic-1))

• Defining curvature sizing for all object face zones except symmetry planes:

/scoped-sizing/create control-curv curvature object-faces yes no "(eval-

expr ’(list-subtract (get-objects-of-filter '*) (get-objects-of-filter
'sym*)))" 0.25 4 1.2 18

A.2. Label Utility Functions

The following label utility functions are available:

Feature Description Function

Add On Add labels on the specified face zones. (tgapi-util-add-labels-on-face-
labels face zones '(face-zone-name-list)
zones • Specify the face zones using a face- '(label-name-list))
zone-name-list, face-zone-ID-
(tgapi-util-add-labels-on-face-
list, or face-zone-name-pat-
zones '(face-zone-ID-list)
tern*.
'(label-name-list))
• Specify the labels using a label-name- (tgapi-util-add-labels-on-face-
list (for example '(label1 la- zones "face-zone-name-pattern*"
bel2)). '(label-name-list))

On Add labels on the specified cell zones. (tgapi-util-add-labels-on-cell-

cell zones '(cell-zone-name-list)
zones • Specify the cell zones using a cell- '(label-name-list))
zone-name-list, cell-zone-ID-
(tgapi-util-add-labels-on-cell-
list, or cell-zone-name-pat-
zones '(cell-zone-ID-list)
tern*.
'(label-name-list))
• Specify the labels using a label-name- (tgapi-util-add-labels-on-cell-
list (for example '(label1 la- zones "cell-zone-name-pattern*"
bel2)). '(label-name-list))

On Add labels on the specified edge zones. (tgapi-util-add-labels-on-edge-

edge zones '(edge-zone-name-list)
zones • Specify the edge zones using an edge- '(label-name-list))
zone-name-list, edge-zone-ID-
(tgapi-util-add-labels-on-edge-
list, or edge-zone-name-pat-
zones '(edge-zone-ID-list)
tern*.
'(label-name-list))
• Specify the labels using a label-name- (tgapi-util-add-labels-on-edge-
list (for example '(label1 la- zones "edge-zone-name-pattern*"
bel2)). '(label-name-list))

Return On Returns the list of labels for the specified (tgapi-util-get-labels-on-face-

list of face face zones. Specify the face zones using a zones '(face-zone-name-list))
labels zones face-zone-name-list, face-zone- (tgapi-util-get-labels-on-face-
ID-list, or face-zone-name-pat- zones '(face-zone-ID-list))
tern*.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
140 of ANSYS, Inc. and its subsidiaries and affiliates.
 Label Utility Functions

Feature Description Function

(tgapi-util-get-labels-on-face-
zones "face-zone-name-pat-
tern*")
On Returns the list of labels for the specified (tgapi-util-get-labels-on-cell-
cell cell zones. Specify the cell zones using a zones '(cell-zone-name-list))
zone cell-zone-name-list, cell-zone- (tgapi-util-get-labels-on-cell-
ID-list, or cell-zone-name-pat- zones '(cell-zone-ID-list))
tern*.
(tgapi-util-get-labels-on-cell-
zones "cell-zone-name-pat-
tern*")
On Returns the list of labels for the specified (tgapi-util-get-labels-on-edge-
edge edge zones. Specify the edge zones using zones '(edge-zone-name-list))
zone an edge-zone-name-list, edge- (tgapi-util-get-labels-on-edge-
zone-ID-list, or edge-zone-name- zones '(edge-zone-ID-list))
pattern*.
(tgapi-util-get-labels-on-edge-
zones "edge-zone-name-pat-
tern*")
Face Return a list of face zone labels in the (get-labels-of-object 'object)
Zone specified object. (get-labels-of-object "object")
Label
lists (tgapi-util-get-all-label-name-
by list 'object)
object (tgapi-util-get-all-label-name-
list "object")
Return a list of face zone labels in the (get-labels-of-filter 'object
specified object, whose names contain the 'filter)
specified filter/pattern string. (tgapi-util-get-label-name-
list-of-pattern 'object "label-
name-pattern*")
(tgapi-util-get-label-name-
list-of-pattern "object" "la-
bel-name-pattern*")
Face Return a list of face zone labels containing (get-labels-of-face-zones
Zone the face zones specified. '(list-of-face-zone-IDs))
Label
lists
by
face
zones
Return Face Returns the list of face zones (by ID) (tgapi-util-get-face-zone-id-
list of zones containing the labels specified. list-with-labels '(face-zone-
zones name-list) '(label-name-list))
with • Specify the face zones using a face-
(tgapi-util-get-face-zone-id-
labels zone-name-list, face-zone-ID-
list-with-labels '(face-zone-
list, or face-zone-name-pat-
ID-list) '(label-name-list))
tern*.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 141
Query and Utility Functions

Feature Description Function

• Specify the labels using a label-name- (tgapi-util-get-face-zone-id-
list (for example '(label1 la- list-with-labels "face-zone-
bel2)). name-pattern* '(label-name-
list))
Cell Returns the list of cell zones (by ID) (tgapi-util-get-cell-zone-id-
Zones containing the labels specified. list-with-labels '(cell-zone-
name-list) '(label-name-list))
• Specify the cell zones using a cell-
(tgapi-util-get-cell-zone-id-
zone-name-list, cell-zone-ID-
list-with-labels '(cell-zone-
list, or cell-zone-name-pat-
ID-list) '(label-name-list))
tern*.
(tgapi-util-get-cell-zone-id-
• Specify the labels using a label-name- list-with-labels "cell-zone-
list (for example '(label1 la- name-pattern* '(label-name-
bel2)). list))

Edge Returns the list of edge zones (by ID) (tgapi-util-get-edge-zone-id-

zones containing the labels specified. list-with-labels '(edge-zone-
name-list) '(label-name-list))
• Specify the face zones using an edge-
(tgapi-util-get-edge-zone-id-
zone-name-list, edge-zone-ID-
list-with-labels '(edge-zone-
list, or edge-zone-name-pat-
ID-list) '(label-name-list))
tern*.
(tgapi-util-get-edge-zone-id-
• Specify the labels using a label-name- list-with-labels "edge-zone-
list (for example '(label1 la- name-pattern* '(label-name-
bel2)). list))

Remove From Removes the specified labels from the face (tgapi-util-remove-labels-on-
labels face zones. face-zones '(face-zone-name-
from zones list) '(label-name-list))
zones • Specify the face zones using a face-
(tgapi-util-remove-labels-on-
zone-name-list, face-zone-ID-
face-zones '(face-zone-ID-list)
list, or face-zone-name-pat-
'(label-name-list))
tern*.
(tgapi-util-remove-labels-on-
• Specify the labels using a label-name- face-zones "face-zone-name-pat-
list (for example '(label1 la- tern*" '(label-name-list))
bel2)).

From Removes the specified labels from the cell (tgapi-util-remove-labels-on-

cell zones. cell-zones '(cell-zone-name-
zones list) '(label-name-list))
• Specify the cell zones using a cell-
(tgapi-util-remove-labels-on-
zone-name-list, cell-zone-ID-
cell-zones '(cell-zone-ID-list)
list, or cell-zone-name-pat-
'(label-name-list))
tern*.
(tgapi-util-remove-labels-on-
• Specify the labels using a label-name- cell-zones "cell-zone-name-pat-
list (for example '(label1 la- tern*" '(label-name-list))
bel2)).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
142 of ANSYS, Inc. and its subsidiaries and affiliates.
 Report Utility Functions

Feature Description Function

From Removes the specified labels from the edge (tgapi-util-remove-labels-on-
edge zones. edge-zones '(edge-zone-name-
zones list) '(label-name-list))
• Specify the edge zones using an edge-
(tgapi-util-remove-labels-on-
zone-name-list, edge-zone-ID-
edge-zones '(edge-zone-ID-list)
list, or edge-zone-name-pat-
'(label-name-list))
tern*.
(tgapi-util-remove-labels-on-
• Specify the labels using a label-name- edge-zones "edge-zone-name-pat-
list (for example '(label1 la- tern*" '(label-name-list))
bel2)).

A.2.1. Examples
Consider a model with face zones part1, part2, part3, inlet1, inlet2, and outlet.

• Add labels on the specified face zones.

(tgapi-util-add-labels-on-face-zones '(inlet1 inlet2) '(inlet))

(tgapi-util-add-labels-on-face-zones "part*" '(wall solid))

• Return the list of labels on the specified face zone.

(tgapi-util-get-labels-on-face-zones '(12 34))

Returns list of labels: (inlet)

(tgapi-util-get-labels-on-face-zones "part*")

Returns list of labels: (wall solid)

• Remove labels from the specified face zones.

(tgapi-util-remove-labels-on-face-zones "part*" '(solid))

• Return the list of face zones (by ID) containing the labels specified.

(tgapi-util-get-face-zone-id-list-with-labels "inlet*" '(inlet))

Returns face zone ID list: (12 34)

A.3. Report Utility Functions

The following functions are available for reporting mesh quality, statistics, face/cell distribution:

Feature Description Utility Function

Report Mesh Types Return zone type as integer (tgapi-util-get-zone-type
zone-id)
(tgapi-util-get-zone-type
zone-name)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 143
Query and Utility Functions

Feature Description Utility Function

Return cell zone shape as symbol (tgapi-util-get-cell-zone-
shape zone-id)
Report Mesh Return count of entities for face zones (tgapi-util-get-face-zone-
Statistics count '(zone-id-list))
(tgapi-util-get-face-zone-
count '(zone-name-list))
(tgapi-util-get-face-zone-
count "zone-name-pattern*")
Return count of entities for cell zones (tgapi-util-get-cell-zone-
count '(zone-id-list))
(tgapi-util-get-cell-zone-
count '(zone-name-list))
(tgapi-util-get-cell-zone-
count "zone-name-pattern*")
Returns the node count for the specified (tgapi-util-get-face-zone-
face zone. node-count 'zone-id)
(tgapi-util-get-face-zone-
node-count 'zone-name)
(tgapi-util-get-face-zone-
node-count "zone-name")
Return face zone area for the specified (tgapi-util-get-face-zone-
zones area '(zone-id-list))
(tgapi-util-get-face-zone-
area '(zone-name-list))
(tgapi-util-get-face-zone-
area "zone-name-pattern*")
Return cell zone volume for the specified (tgapi-util-get-cell-zone-
zones volume '(zone-id-list))
(tgapi-util-get-cell-zone-
volume '(zone-name-list))
(tgapi-util-get-cell-zone-
volume "zone-name-pattern*")
Report Mesh Report the face mesh distribution based (tgapi-util-get-face-mesh-
Distribution on the specified measure, parti- distribution '(face-zone-
tions, and range (such as (0.9 1)). list) "measure" partitions
'(range))
Specify the "measure" as one of
(tgapi-util-get-face-mesh-
the following:
distribution "face-zone-name-
• "Skewness" pattern*" "measure" parti-
tions '(range))
• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
144 of ANSYS, Inc. and its subsidiaries and affiliates.
 Report Utility Functions

Feature Description Utility Function

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Qual-

ity"

Report the cell mesh distribution based (tgapi-util-get-cell-mesh-

on the specified measure, parti- distribution '(cell-zone-
tions, and range (such as (0.9 1)). list) "measure" partitions
'(range))
Specify the "measure" as one of
(tgapi-util-get-cell-mesh-
the following:
distribution "cell-zone-name-
• "Skewness" pattern*" "measure" parti-
tions '(range))
• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Qual-

ity"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 145
Query and Utility Functions

Feature Description Utility Function

Report Quality/Size Report the worst quality face and face (tgapi-util-get-face-quality-
Limits quality limits (minimum, maximum, limits '(face-zone-list)
average quality) for the list of zones "measure")
based on the measure specified. You (tgapi-util-get-face-quality-
can also report face size limits. limits "face-zone-name-pat-
tern*" "measure")
Specify the "measure" as one of
the following:

• "Skewness"

• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Qual-

ity"

Report the number of cells and the cell (tgapi-util-get-cell-quality-

quality limits (minimum, maximum, limits '(cell-zone-list)
average quality) for the list of zones "measure")
based on the measure specified. You (tgapi-util-get-cell-quality-
can also report the cell size limits. limits "cell-zone-name-pat-
tern*" "measure")
Specify the "measure" as one of
the following:

• "Skewness"

• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
146 of ANSYS, Inc. and its subsidiaries and affiliates.
 Report Utility Functions

Feature Description Utility Function

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Qual-

ity"

Report the worst quality cell (ID and (tgapi-util-print-worst-qual-

location) for the cell zones based on the ity-cell '(cell-zone-list)
measure specified. "measure")
(tgapi-util-print-worst-qual-
Specify the "measure" as one of
ity-cell "cell-zone-name-pat-
the following:
tern*" "measure")
• "Skewness"

• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Qual-

ity"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 147
Query and Utility Functions

Feature Description Utility Function

Report the edge size limits for the list of (tgapi-util-get-edge-size-
face zones limits '(face-zone-list))
(tgapi-util-get-edge-size-
limits "face-zone-name-pat-
tern*")
Report count Returns the count of free faces for the (tgapi-util-get-free-faces-
face zones specified count '(face-zone-name-list))
(tgapi-util-get-free-faces-
count '(face-zone-id-list))
(tgapi-util-get-free-faces-
count "face-zone-name-pat-
tern*")
Returns the count of multi-connected (tgapi-util-get-multi-faces-
faces for the face zones specified count '(face-zone-name-list))
(tgapi-util-get-multi-faces-
count '(face-zone-id-list))
(tgapi-util-get-multi-faces-
count "face-zone-name-pat-
tern*")
Returns the count of marked faces for (tgapi-util-count-marked-
the face zones specified faces '(face-zone-name-list))
(tgapi-util-count-marked-
faces '(face-zone-id-list))
(tgapi-util-count-marked-
faces "face-zone-name-pat-
tern*")
Print summary Print the diagnostics summary for a list (tgapi-util-print-dia-
of objects gnostics-summary '(object-
name-list))
Mesh check Reports the selected mesh check (tgapi-util-mesh-check "type-
statistics for the zones specified. name" '(edge-zone-list)
'(face-zone-list) '(cell-
• Specify the "type-name" as one of zone-list))
the following:
(tgapi-util-mesh-check "type-
– "bounding-box-statistics" name" "edge-zone-name-pat-
tern*" '(face-zone-list)
– "volume-statistics" '(cell-zone-list))
(tgapi-util-mesh-check "type-
– "face-area-statistics" name" '(edge-zone-list)
"face-zone-name-pattern*"
– "nodes-per-edge"
'(cell-zone-list))
– "nodes-per-face" (tgapi-util-mesh-check "type-
name" "edge-zone-name-pat-
– "nodes-per-cell" tern*" "face-zone-name-pat-
tern*" '(cell-zone-list))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
148 of ANSYS, Inc. and its subsidiaries and affiliates.
 Diagnostic Based Marking Utility Functions

Feature Description Utility Function

– "faces-or-neighbors-per- (tgapi-util-mesh-check "type-
cell" name" '(edge-zone-list)
'(face-zone-list) "cell-zone-
– "cell-faces-or-neighbors" name-pattern*")

– "isolated-cells" (tgapi-util-mesh-check "type-

name" "edge-zone-name-pat-
– "face-handedness" tern*" "face-zone-name-pat-
tern*" "cell-zone-name-pat-
– "periodic-face-pairs" tern*")

– "face-children"

– "zone-boundary-conditions"

– "invalid-node-coordinates"

– "poly-cells"

– "parallel-invalid-zones"

– "parallel-invalid-neighbor-
hood"

– "parallel-invalid-inter-
faces"

Refer to Checking the Mesh for

descriptions of the individual
mesh checks.

• Specify the zones to be checked.

Specify the edge zones (edge-

zone-list or edge-zone-
name-pattern*), face zones
(face-zone-list or face-
zone-name-pattern*), and
cell zones (cell-zone-list or
cell-zone-name-pattern*).

A.4. Diagnostic Based Marking Utility Functions

The following functions are available for identifying faces/zones based on diagnostic criteria such as
face connectivity and quality:

Feature Description Utility Function

Mark free faces on the face zones specified (tgapi-util-mark-free-faces '(zone-
id-list))
(tgapi-util-mark-free-faces '(zone-
name-list))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 149
Query and Utility Functions

Feature Description Utility Function

(tgapi-util-mark-free-faces "zone-
name-pattern*")
Mark multi-connected faces on the face zones (tgapi-util-mark-multi-faces '(zone-
specified based on fringe length (n) id-list) n)
(tgapi-util-mark-multi-faces '(zone-
name-list) n)
(tgapi-util-mark-multi-faces "zone-
name-pattern*" n)
Mark self-intersecting faces on the face zones (tgapi-util-mark-self-intersecting-
specified. Specify whether to mark folded faces or faces '(zone-id-list) mark-folded?)
not (mark-folded? set to #t or #f). (tgapi-util-mark-self-intersecting-
faces '(zone-name-list) mark-folded?)
(tgapi-util-mark-self-intersecting-
faces "zone-name-pattern*" mark-fol-
ded?)
Mark faces in self-proximity on the face zones (tgapi-util-mark-faces-in-self-prox-
specified. Specify whether to use relative tolerance imity '(zone-id-list) relative-toler-
(relative-tolerance? set to #t or #f), tol- ance? tolerance angle ignore-orient-
erance value, the angle, and whether to ignore ation?)
orientation (ignore-orientation? set to #t (tgapi-util-mark-faces-in-self-prox-
or #f). imity '(zone-name-list) relative-
tolerance? tolerance angle ignore-
orientation?)
(tgapi-util-mark-faces-in-self-prox-
imity "zone-name-pattern*" relative-
tolerance? tolerance angle ignore-
orientation?)
Mark duplicate faces on the face zones specified (tgapi-util-mark-duplicate-faces
'(zone-id-list))
(tgapi-util-mark-duplicate-faces
'(zone-name-list))
(tgapi-util-mark-duplicate-faces
"zone-name-pattern*")
Mark invalid normal locations on the face zones (tgapi-util-mark-invalid-normals
specified '(zone-id-list))
(tgapi-util-mark-invalid-normals
'(zone-name-list))
(tgapi-util-mark-invalid-normals
"zone-name-pattern*")
Mark point contact locations on the face zones (tgapi-util-mark-point-contacts
specified '(zone-id-list))
(tgapi-util-mark-point-contacts
'(zone-name-list))

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
150 of ANSYS, Inc. and its subsidiaries and affiliates.
 Diagnostic Based Marking Utility Functions

Feature Description Utility Function

(tgapi-util-mark-point-contacts
"zone-name-pattern*")
Mark island faces on the face zones specified, based (tgapi-util-mark-island-faces '(zone-
on the island face count (n) id-list) n)
(tgapi-util-mark-island-faces '(zone-
name-list) n)
(tgapi-util-mark-island-faces "zone-
name-pattern*" n)
Mark spikes on the face zones specified, based on (tgapi-util-mark-spikes '(zone-id-
the spike angle (spike-angle) list) spike-angle)
(tgapi-util-mark-spikes '(zone-name-
list) spike-angle)
(tgapi-util-mark-spikes "zone-name-
pattern*" spike-angle)
Mark steps on the face zones specified, based on (tgapi-util-mark-steps '(zone-id-
the step angle (step-angle) and step width list) step-angle step-width)
(step-width) (tgapi-util-mark-steps '(zone-name-
list) step-angle step-width)
(tgapi-util-mark-steps "zone-name-
pattern*" step-angle step-width)
Mark sliver faces on the face zones specified, based (tgapi-util-mark-sliver-faces '(zone-
on the maximum height (max-height) and id-list) max-height skew-limit)
skewness limit (skew-limit) (tgapi-util-mark-sliver-faces '(zone-
name-list) max-height skew-limit)
(tgapi-util-mark-sliver-faces "zone-
name-pattern*" max-height skew-limit)
Mark bad quality faces on the boundary face zones (tgapi-util-mark-bad-quality-faces
specified, based on the quality limit (quality- '(zone-id-list) quality-limit nrings)
limit) and number of rings (nrings). (tgapi-util-mark-bad-quality-faces
'(zone-name-list) quality-limit
nrings)
(tgapi-util-mark-bad-quality-faces
"zone-name-pattern*" quality-limit
nrings)
Mark faces based on the quality-measure and (tgapi-util-mark-faces-by-quality
quality-limit specified. Specify whether to '(zone-id-list) quality-measure
append the faces to those previously marked or quality-limit append-marking?)
clear previously marked faces (append-marking? (tgapi-util-mark-faces-by-quality
set to #t or #f) '(zone-name-list) quality-measure
quality-limit append-marking?)
(tgapi-util-mark-faces-by-quality
"zone-name-pattern*" quality-measure
quality-limit append-marking?)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 151
Query and Utility Functions

Feature Description Utility Function

Mark face strips based on the strip-type, (tgapi-util-mark-face-strips-by-
strip-height, quality-measure, quality- height-and-quality '(zone-id-list)
limit, and feature-angle specified. Possible strip-type strip-height quality-
values for strip-type are: measure quality-limit feature-angle)
(tgapi-util-mark-face-strips-by-
• 1: boundary-boundary strip. Multi-connected face
height-and-quality '(zone-name-list)
edges are also considered as boundary here.
strip-type strip-height quality-
• 2: feature-feature strip between angle based measure quality-limit feature-angle)
features. Feature edges, multi-connected edges, (tgapi-util-mark-face-strips-by-
and free edges are angle based features. Boundary height-and-quality "zone-name-pat-
edges will be considered features if there is an tern*" strip-type strip-height qual-
angle. ity-measure quality-limit feature-
angle)
• 3: all-all strip between all boundaries and features.

• 4: pure feature-feature strip. Only pure features,

boundary edges and multi edges will not be
considered as pure feature edges even if there is
an angle based feature.

The recommended value is 2.

Mark all faces at nodes based on deviation from (tgapi-util-mark-faces-deviating-
the size field. from-size-field '(zone-id-list) min-
size-factor max-size-factor "sf-type-
• Specify the zones using zone-id-list, zone- to-compare")
name-list, or zone-name-pattern*.
(tgapi-util-mark-faces-deviating-
• Specify the min-size-factor and max-size- from-size-field '(zone-name-list)
factor. min-size-factor max-size-factor "sf-
type-to-compare")
• Specify the size field type to be used to get size (tgapi-util-mark-faces-deviating-
at node. Set "sf-type-to-compare" to from-size-field "zone-name-pattern*"
"volumetric" or "geodesic". min-size-factor max-size-factor "sf-
type-to-compare")
Faces will be marked if the minimum edge length
at the node is less than min-size-
factor×size-at-node or the maximum edge
length is greater than max-size-factor×size-
at-node.
Mark all faces with node degree above the specified (tgapi-util-mark-faces-using-node-
threshold. Node degree is defined as the number degree '(zone-id-list) node-degree-
of edges connected to the node. threshold)
(tgapi-util-mark-faces-using-node-
• Specify the face zones using zone-id-list,
degree '(zone-name-list) node-degree-
zone-name-list, or zone-name-pattern*.
threshold)
• Specify the node-degree-threshold. (tgapi-util-mark-faces-using-node-
degree "zone-name-pattern*" node-de-
gree-threshold)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
152 of ANSYS, Inc. and its subsidiaries and affiliates.
 Mesh Setup Utility Functions

A.5. Mesh Setup Utility Functions

The following functions are available for mesh setup:

Feature Description Utility Function

Return a suitable average point based on the zones (get-average-bounding-box-center
specified '(face-zone-ID-list))
Return the bounding box extents for the list of (tgapi-util-get-bounding-box-of-zone-
zones. list '(zone-id-list))
Enables you to unpreserve some/all preserved cell (tgapi-util-un-preserve-cell-zones
zones during the meshing process. '(cell-zone-list))
(tgapi-util-un-preserve-cell-zones
"cell-zone-name-pattern*")
Create bodies of influence and if required body of (tgapi-util-create-boi-and-size-
influence size functions from the mesh refinement functions-from-refinement-regions
regions. Specify the refinement region type (set "region-type" "boi-prefix-string"
"region-type" to "tet" or "hexcore"). create-size-function?)
Specify the prefix for the BOI zones ("boi-pre-
fix-string"), and choose whether to create the
size functions (set create-size-function? to
#t or #f).
Enables you to scale the face zones around a pivot (tgapi-util-scale-face-zones-around-
point or the bounding box center. Specify the face pivot '(face-zone-list) '(scale)
zones, the scale factors in the X, Y, Z directions '(pivot) use-bbox-center?)
(scale), the pivot point (pivot), and choose (tgapi-util-scale-face-zones-around-
whether to use the bounding box center (use- pivot "face-zone-name-pattern*"
bbox-center? set to #t or #f). '(scale) '(pivot) use-bbox-center?)
Enables you to scale the cell zones around a pivot (tgapi-util-scale-cell-zones-around-
point or the bounding box center. Specify the cell pivot '(cell-zone-list) '(scale)
zones, the scale factors in the X, Y, Z directions '(pivot) use-bbox-center?)
(scale), the pivot point (pivot), and choose (tgapi-util-scale-cell-zones-around-
whether to use the bounding box center (use- pivot "cell-zone-name-pattern*"
bbox-center? set to #t or #f). '(scale) '(pivot) use-bbox-center?)
Return the face zones and their orientation for the (tgapi-util-dump-face-zone-orienta-
mesh file specified tion-in-region "filename")
Returns a sorted list of volumetric regions by (tgapi-util-sort-regions-by-volume
volume for the object specified. Specify the order "object-name" "order")
(ascending or descending).
Return the region volume for the specified region (tgapi-util-get-region-volume 'ob-
of an object ject-name 'region-name)
(tgapi-util-get-region-volume "ob-
ject-name" "region-name")
Set the quality measure. (tgapi-util-set-quality-measure
"measure")
Specify the "measure" as one of the
following:

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 153
Query and Utility Functions

Feature Description Utility Function

• "Skewness"

• "Equiangle Skewness"

• "Size Change"

• "Edge Ratio"

• "Size"

• "Aspect Ratio"

• "Squish"

• "Warp"

• "Dihedral Angle"

• "ICEMCFD Quality"

• "Ortho Skew"

• "FLUENT Aspect Ratio"

• "Inverse Orthogonal Quality"

Set object cell zone type (tgapi-util-set-object-cell-zone-type

'object 'cell-zone-type)
(tgapi-util-set-object-cell-zone-type
"object" 'cell-zone-type)
Set the number of compute threads to use for (tgapi-util-set-number-of-parallel-
algorithms like mesh check and quality compute-threads nthreads)
computation. You can use a variable number of
compute threads for these algorithms depending
on the current machine loads. The number of
compute threads is between 2 and the value
(maximum-cores-available - 1).

A.6. Mesh Operation Utility Functions

Feature Description Utility Function
Rename zones Renames an existing face zone (tgapi-util-rename-face-zone
"zone-name" "new-name")
(tgapi-util-rename-face-zone
'zone-id "new-name")
Renames an existing edge zone (tgapi-util-rename-edge-zone
"zone-name" "new-name")
(tgapi-util-rename-edge-zone
'zone-id "new-name")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
154 of ANSYS, Inc. and its subsidiaries and affiliates.
 Mesh Operation Utility Functions

Feature Description Utility Function

Replace the face zone suffix to rename (tgapi-util-replace-face-
face zones. Specify whether to merge zone-suffix '(face-zone-list)
the face zones being renamed (set "separator" "replace-with"
merge? to #t or #f). merge?)

Note

If an empty string is
specified for the separ-
ator (" "), the string
specified for replace-
with will be appended
to the face zone names.

Replace the cell zone suffix to rename (tgapi-util-replace-cell-

cell zones. Specify whether to merge the zone-suffix '(cell-zone-list)
cell zones being renamed (set merge? "old-suffix" "new-suffix"
to #t or #f) merge?)
Replace the edge zone suffix to rename (tgapi-util-replace-edge-
edge zones. Specify whether to merge zone-suffix '(edge-zone-list)
the edge zones being renamed (set "old-suffix" "new-suffix"
merge? to #t or #f) merge?)
Removes the ID suffix from face zone (tgapi-util-remove-id-suffix-
names from-face-zones)
Clean up face zone names by removing (tgapi-util-clean-face-zone-
IDs wherever possible names)
Remove the zone ID (:id) from zone ID (tgapi-util-remove-ids-from-
list. zone-names '(zone-id-list))
Change zone ID Renumber zone IDs starting from the (tgapi-util-renumber-zone-ids
number specified (start-number). '(zone-id-list) start-number)
Rename objects Renames the object (tgapi-util-rename-object
"old-object-name" "new-ob-
ject-name")
Rename objects by replacing the object (tgapi-util-replace-object-
suffix with a new suffix suffix '(object-name) "separ-
ator" "new-suffix")
Rename labels Renames the face zone label (tgapi-util-rename-label "ob-
ject-name" "old-label-name"
"new-label-name")
Rename labels by replacing the label (tgapi-util-replace-label-
suffix with a new suffix suffix '(object-list) "separ-
ator" "new-suffix")
Copy labels Copy labels from one face zone to (tgapi-util-copy-labels from-
another. Specify either face zone names face-zone to-face-zone)
or IDs

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 155
Query and Utility Functions

Feature Description Utility Function

Merge zones Merges the specified face zones. Specify (tgapi-util-merge-face-zones
a list of zone IDs or name pattern. '(zone-id-list))
(tgapi-util-merge-face-zones
"zone-name-pattern*")
Merges face zones of a given type based (tgapi-util-merge-face-zone-
on name pattern of-type 'zone-type "zone-
name-pattern*")
Merges face zones containing the (tgapi-util-merge-face-zones-
specified prefix with-same-prefix "prefix")
Merges the specified cell zones. Specify (tgapi-util-merge-cell-zones
a list of cell zones or name pattern. '(cell-zone-list))
(tgapi-util-merge-cell-zones
"cell-zone-name-pattern*")
Merge cell zones containing the specified (tgapi-util-merge-cell-zones-
prefix with-same-prefix "prefix")
Merge cell zones containing the specified (tgapi-util-merge-cell-zones-
suffix with-same-suffix "suffix")
Separate Separates cells that are connected to (tgapi-util-separate-cell-
specified face zones into another cell zone-layers-by-face-zone
zone. This separation method applies '(cell-zone-id) '(face-zone-
only to prism cells. Specify the number list) nlayers)
of layers of cells (nlayers) to be (tgapi-util-separate-cell-
separated. zone-layers-by-face-zone
'(cell-zone-id) "face-zone-
name-pattern*" nlayers)
(tgapi-util-separate-cell-
zone-layers-by-face-zone
"cell-zone-name" '(face-zone-
list) nlayers)
(tgapi-util-separate-cell-
zone-layers-by-face-zone
"cell-zone-name" "face-zone-
name-pattern*" nlayers)
Separate face zones based on the cell (tgapi-util-separate-face-
neighbors. zones-by-cell-neighbor
'(face-zone-list))
(tgapi-util-separate-face-
zones-by-cell-neighbor "face-
zone-name-pattern*")
Refine Refine marked faces (tgapi-util-refine-marked-
faces-in-zones '(face-zone-
list))
(tgapi-util-refine-marked-
faces-in-zones "face-zone-
name-pattern*")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
156 of ANSYS, Inc. and its subsidiaries and affiliates.
 Mesh Operation Utility Functions

Feature Description Utility Function

Patch Fill holes associated with free edges for (tgapi-util-fill-holes-in-
the face zones specified, based on the face-zone-list '(face-zone-
number of free edges (max-hole- list) max-hole-edges)
edges) (tgapi-util-fill-holes-in-
face-zone-list "face-zone-
name-pattern*" max-hole-
edges)
Project Project a zone on the plane specified. (tgapi-util-project-zone-on-
Specify three points for defining the plane zone-id plane)
plane.
Delete Deletes all sub-domains (all domains (tgapi-util-delete-all-sub-
other than global) domains)
Delete marked faces (tgapi-util-delete-marked-
faces-in-zones '(face-zone-
list))
(tgapi-util-delete-marked-
faces-in-zones "face-zone-
name-pattern*")
Delete empty zones based on the zones (tgapi-util-delete-empty-
specified face-zones '(face-zone-list))
(tgapi-util-delete-empty-
face-zones "face-zone-name-
pattern*")
(tgapi-util-delete-empty-
edge-zones '(edge-zone-list))
(tgapi-util-delete-empty-
edge-zones "edge-zone-name-
pattern*")
(tgapi-util-delete-empty-
cell-zones '(cell-zone-list))
(tgapi-util-delete-empty-
cell-zones "cell-zone-name-
pattern*")
(tgapi-util-delete-empty-
zones '(zone-list))
(tgapi-util-delete-empty-
zones "zone-name-pattern*")
Validate mesh Report if the boundary face zone exists (tgapi-util-boundary-zone-ex-
ists? zone-id)
(tgapi-util-boundary-zone-ex-
ists? 'zone-name)
Report if the interior face zone exists (tgapi-util-interior-zone-ex-
ists? zone-id)
(tgapi-util-interior-zone-ex-
ists? 'zone-name)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 157
Query and Utility Functions

Feature Description Utility Function

Report if the cell zone exists (tgapi-util-cell-zone-exists?
zone-id)
(tgapi-util-cell-zone-exists?
'zone-name)
Report if the volume mesh exists (tgapi-util-mesh-exists?)

A.7. Miscellaneous Functions

Feature Description Utility Function
String operations Check if the string contains another (tgapi-util-string-contains?
string "string1*" "string2*")
Enables you to split a string by the (tgapi-util-string-split
specified character. "original-string" "split-
character")
Enables you to split a string by the (tgapi-util-string-split-
specified string. with-string "original-string"
"split-string")
Folder/directory Returns the path for the working (tgapi-util-get-mesher-work-
Management directory ing-directory)
Sync the Cortex current working (tgapi-util-sync-directories
directory with the Fluent current working directory)
directory (directory)
File management Finds the file in the working directory (tgapi-util-find-file-with-
based on the filename and file- suffix "filename" "file-suf-
suffix specified. fix")
(tgapi-util-find-file-pat-
tern-with-suffix "filename"
"file-suffix")
Returns the last read file (tgapi-util-get-last-read-
file-name)
Returns the file suffix for the last read (tgapi-util-get-last-read-
file file-suffix)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
158 of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix B. Boundary Functions
The following boundary functions are available:

Feature Description Function

Improve surface Improve marked faces by splitting the (tgapi-boundary-split-marked-
mesh longer edge. faces '(face-zone-id-list)
longer-edge-split-ratio)
• Specify the face zones using a face-
(tgapi-boundary-split-marked-
zone-id-list, face-zone-name-
faces '(face-zone-name-list)
list, or face-zone-name-pat-
longer-edge-split-ratio)
tern*.
(tgapi-boundary-split-marked-
• Specify the longer-edge-split- faces "face-zone-name-pat-
ratio (length ratio for the split tern*" longer-edge-split-ra-
created by projecting the opposite tio)
node onto the longer edge). The valid
range is 0 to 0.5 and the
recommended value is 0.25.

Improve marked faces by collapsing face (tgapi-boundary-collapse-

edges. marked-faces '(face-zone-id-
list) preserve-boundary?
• Specify the face zones using a face- boundary-corner-angle max-
zone-id-list, face-zone-name- collapsible-edge-ratio)
list, or face-zone-name-pat-
(tgapi-boundary-collapse-
tern*.
marked-faces '(face-zone-
• Choose whether to preserve the name-list) preserve-boundary?
boundary by setting preserve- boundary-corner-angle max-
boundary? to #t or #f. collapsible-edge-ratio)
(tgapi-boundary-collapse-
– If preserve-boundary? is marked-faces "face-zone-name-
enabled (#t), specify the bound- pattern*" preserve-boundary?
ary-corner-angle to be used boundary-corner-angle max-
for marking fixed nodes on the collapsible-edge-ratio)
boundary. The recommended value
is 20 degrees.

• Set the max-collapsible-edge-

ratio depending on the improve
operation:

– To improve general quality, specify

a value between 0 to 0.5. A value
of 0.5 is recommended.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 159
Boundary Functions

Feature Description Function

– To collapse sliver faces, specify a
value of 0.1.

Note

A value of 0 will result

in all marked faces
being collapsed.

Tip

Use this operation when

the mesh skewness is
greater than 0.7.

Also, it is recommended
to mark faces and
collapse faces by edge
ratio incrementally. For
example, first mark faces
with skewness greater
than 0.9 and then
collapse marked faces
using an edge ratio of
0.1. When the mesh
quality is improved, next
mark faces with
skewness greater than
0.8 and then collapse
marked faces using an
edge ratio of 0.2; and so
on.

Improve sliver faces by splitting and (tgapi-boundary-split-and-

collapsing edges. collapse-sliver-faces '(face-
zone-id-list) sliver-height
• Specify the face zones using a face- "sliver-quality-measure"
zone-id-list, face-zone-name- sliver-quality longer-edge-
list, or face-zone-name-pat- split-ratio preserve-bound-
tern*. ary? boundary-corner-angle)
• Specify the height threshold for sliver (tgapi-boundary-split-and-
face improvement. All faces with collapse-sliver-faces '(face-
sliver-height less than the zone-name-list) sliver-height
specified value will be marked for "sliver-quality-measure"
improvement. Sliver height is the sliver-quality longer-edge-
shortest height of the triangular face - split-ratio preserve-bound-
the distance between the location of ary? boundary-corner-angle)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
160 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
the opposite node and its projection
(tgapi-boundary-split-and-
point on the longer edge. collapse-sliver-faces "face-
zone-name-pattern*" sliver-
• Specify either "Skewness" or "As- height "sliver-quality-meas-
pect Ratio" as the "sliver- ure" sliver-quality longer-
quality-measure", and the edge-split-ratio preserve-
sliver-quality threshold used for boundary? boundary-corner-
marking. angle)
• Specify the longer-edge-split-
ratio (length ratio for the split
created by projecting the opposite
node onto the longer edge). The valid
range is 0 to 0.5 and the
recommended value is 0.25.

• Choose whether to preserve the

boundary by setting preserve-
boundary? to #t or #f.

– If preserve-boundary? is
enabled (#t), specify the bound-
ary-corner-angle to be used
for marking fixed nodes on the
boundary. The recommended value
is 20 degrees.

Patch Create a planar surface to patch holes (tgapi-boundary-fill-planar-

associated with free faces for the face holes-using-free-faces
zones specified. The free faces should be '(face-zone-id-list) plane
continuous for the planar patch to be tolerance absolute-toler-
created. ance?)
(tgapi-boundary-fill-planar-
• Specify the face zones with free faces
using a face-zone-id-list, holes-using-free-faces
face-zone-name-list, or face- '(face-zone-name-list) plane
zone-name-pattern*. tolerance absolute-toler-
ance?)
• Specify three coplanar points to define (tgapi-boundary-fill-planar-
the plane (for example, (list '(- holes-using-free-faces "face-
10 5 5) '(0 5 5) '(0 -5 zone-name-pattern*" plane
5))). tolerance absolute-toler-
ance?)
• Specify the tolerance value, and
choose whether to use an absolute
tolerance (set absolute-toler-
ance? to #t or #f). Nodes within the

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 161
Boundary Functions

Feature Description Function

tolerance from the plane will be used
to create the planar surface.

Note

The patch surface is not

connected to the original
face zones.

Create a planar surface to patch holes (tgapi-boundary-fill-planar-

associated with free faces for the object holes-using-free-faces-in-ob-
and face zone labels specified. The free ject 'object '(face-zone-la-
faces should be continuous for the bel-list) plane tolerance
planar patch to be created. absolute-tolerance? "new-la-
bel-name")
• Specify the object and the face zone
labels with free faces using a face- (tgapi-boundary-fill-planar-
zone-label-list or face-zone- holes-using-free-faces-in-ob-
label-name-pattern*. ject 'object "face-zone-la-
bel-name-pattern*" plane
• Specify three coplanar points to define tolerance absolute-tolerance?
the plane (for example, (list '(- "new-label-name")
10 5 5) '(0 5 5) '(0 -5 (tgapi-boundary-fill-planar-
5))). holes-using-free-faces-in-ob-
ject "object" '(face-zone-
• Specify the tolerance value, and label-list) plane tolerance
choose whether to use an absolute absolute-tolerance? "new-la-
tolerance (set absolute-toler- bel-name")
ance? to #t or #f). Nodes within the
tolerance from the plane will be used (tgapi-boundary-fill-planar-
to create the planar surface. holes-using-free-faces-in-ob-
ject "object" "face-zone-la-
• Specify the new-label-name for the bel-name-pattern*" plane
planar surface created. The patch tolerance absolute-tolerance?
surface is included in the object and a "new-label-name")
new face zone label is created.

Create a planar surface to patch holes (tgapi-boundary-create-

using the free face edges for the edge planar-surface-using-edges
zones specified. The edge zone should '(edge-zone-id-list) plane
be continuous and free from tolerance absolute-toler-
intersections. ance?)
(tgapi-boundary-create-
• Specify the edge zones using an
edge-zone-id-list, edge-zone- planar-surface-using-edges
name-list, or edge-zone-name- '(edge-zone-name-list) plane
pattern*. tolerance absolute-toler-
ance?)
• Specify three coplanar points to define (tgapi-boundary-create-
the plane (for example, (list '(- planar-surface-using-edges

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
162 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
10 5 5) '(0 5 5) '(0 -5 "edge-zone-name-pattern*"
5))). plane tolerance absolute-
tolerance?)
• Specify the tolerance value, and
choose whether to use an absolute
tolerance (set absolute-toler-
ance? to #t or #f). Nodes within the
tolerance from the plane will be used
to create the planar surface.

Note

The patch surface is not

connected to the original
face zones.

Remesh Remesh the marked faces. (tgapi-boundary-remesh-

marked-faces '(face-zone-id-
• Specify the face zones using a face- list) n-rings preserve-
zone-id-list, face-zone-name- shared-zone-boundary? fea-
list, or face-zone-name-pat- ture-min-angle feature-max-
tern*. angle corner-angle "sizing-
option" constant-size min-
• Specify the number of rings (n- size max-size growth-rate)
rings).
(tgapi-boundary-remesh-
• Choose whether to preserve the shared marked-faces '(face-zone-
zone boundary by setting preserve- name-list) n-rings preserve-
shared-zone-boundary? to #t or shared-zone-boundary? fea-
#f (recommended). ture-min-angle feature-max-
angle corner-angle "sizing-
• Specify the feature-min-angle option" constant-size min-
and feature-max-angle. The size max-size growth-rate)
feature-min-angle and fea- (tgapi-boundary-remesh-
ture-max-angle are the limits for marked-faces "face-zone-name-
the feature angle. Recommended pattern*" n-rings preserve-
values are 40 and 180, respectively. If shared-zone-boundary? fea-
the mesh has false features like folds ture-min-angle feature-max-
and overlaps, the feature-max-
angle corner-angle "sizing-
angle can be set to 155.
option" constant-size min-
• Specify the corner-angle. The size max-size growth-rate)
corner-angle is the minimum angle
between feature edges that will be
preserved during remeshing. The
recommended value is 20.

• Select a "sizing-option" using

"geometric", "constant",
"geodesic" or "volumetric".

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 163
Boundary Functions

Feature Description Function

• Specify values for constant-size
(used when "sizing-option" is set
to "constant"), min-size, max-
size, and growth-rate (these are
used when "sizing-option" is set
to "geometric" or "geodesic").

Note

All four values must

be provided regardless
of the selected "siz-
ing-option".

A value of -1 can be
used for the
parameters that are
not required for a
particular sizing
option.

Remesh face zones by separating them (tgapi-boundary-remesh-face-

internally into patches and later merging zones '(face-zone-list)
them. The patches which fail to remesh '(edge-zone-list) replace-
using the advancing front (surfer) face-zones? feature-min-angle
algorithm will be remeshed using explicit feature-max-angle corner-
remeshing (split, improve, and coarsen). angle "sizing-option" con-
You can specify the number of attempts stant-size min-size max-size
for the advancing front algorithm and growth-rate n-retries-on-
also use explicit remeshing for the failed improve-failed? front-
patches, if required. intersection-tolerance)

• Specify the face zones and edge zones (tgapi-boundary-remesh-face-

using a face/edge zone list or by zones '(face-zone-list)
face/edge zone name pattern. "edge-zone-name-pattern*" re-
place-face-zones? feature-
• Choose whether to replace the original min-angle feature-max-angle
zones with the remeshed zones by corner-angle "sizing-option"
setting replace-face-zones? to constant-size min-size max-
#t or #f (recommended). size growth-rate n-retries-
on-failed improve-failed?
• Specify the feature-min-angle front-intersection-tolerance)
and feature-max-angle. The
(tgapi-boundary-remesh-face-
feature-min-angle and fea-
zones "face-zone-name-pat-
ture-max-angle limits are used to
tern*" '(edge-zone-list) re-
retain angle-based features.
place-face-zones? feature-
Recommended values are 40 and 180,
min-angle feature-max-angle
respectively. If the mesh has false
corner-angle "sizing-option"
features like folds and overlaps, the
constant-size min-size max-

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
164 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
feature-max-angle can be set to size growth-rate n-retries-
155. on-failed improve-failed?
front-intersection-tolerance)
• Specify the corner-angle. The
(tgapi-boundary-remesh-face-
corner-angle is the minimum angle
zones "face-zone-name-pat-
between feature edges that will be
tern*" "edge-zone-name-pat-
preserved for corner nodes during
tern*" replace-face-zones?
remeshing. The recommended value
feature-min-angle feature-
is 20.
max-angle corner-angle "siz-
• Select a "sizing-option" using ing-option" constant-size
"constant", "geodesic" or min-size max-size growth-rate
"volumetric". n-retries-on-failed improve-
failed? front-intersection-
tolerance)
Note

The "geometric"
option is not
supported.

• Specify values for constant-size

(used when "sizing-option" is set
to "constant"), min-size, max-
size, and growth-rate (these are
used when "sizing-option" is set
to "geodesic"). These values are not
used when the "sizing-option"
is set to "volumetric".

Note

All four values must

be provided regardless
of the selected "siz-
ing-option".

A value of -1 can be
used for the
parameters that are
not required for a
particular sizing
option.

• Specify the number of attempts to

improve the failed patches using
explicit remeshing (n-retries-on-
failed) and whether to further
improve the failed patches using

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 165
Boundary Functions

Feature Description Function

explicit remeshing improve-
failed? set to #t or #f.

• Specify the front-intersection-

tolerance for checking intersections.
The value specified should be in the
range 0 to 1. The recommended value
is 0.0, which can be increased if the
remeshed patch shows intersections.

Remesh object face zone labels by (tgapi-boundary-remesh-ob-

separating them internally into patches ject-labels 'object-name
and later merging them. The patches '(face-zone-label-list)
which fail to remesh using the surfer '(edge-zone-list) feature-
(advancing front) algorithm, will be min-angle feature-max-angle
remeshed using explicit remeshing (split, corner-angle "sizing-option"
improve, and coarsen). You can specify constant-size min-size max-
the number of attempts for the surfer size growth-rate n-retries-
algorithm and also use explicit on-failed improve-failed?
remeshing for the patches, if required. front-intersection-tolerance)

• Specify the object, face zone labels (tgapi-boundary-remesh-ob-

(face-zone-label-list or face- ject-labels 'object-name
zone-label-pattern*), and edge '(face-zone-label-list)
zones (edge-zone-list or edge- "edge-zone-name-pattern*"
zone-name-pattern*). feature-min-angle feature-
max-angle corner-angle "siz-
• Specify the feature-min-angle ing-option" constant-size
and feature-max-angle. The min-size max-size growth-rate
feature-min-angle and fea- n-retries-on-failed improve-
ture-max-angle limits are used to failed? front-intersection-
retain angle-based features. tolerance)
Recommended values are 40 and 180, (tgapi-boundary-remesh-ob-
respectively. If the mesh has falseject-labels 'object-name
features like folds and overlaps, the
"face-zone-label-pattern*"
feature-max-angle can be set to '(edge-zone-list) feature-
155. min-angle feature-max-angle
corner-angle "sizing-option"
• Specify the corner-angle. The constant-size min-size max-
corner-angle is the minimum angle size growth-rate n-retries-
between feature edges that will be on-failed improve-failed?
preserved for corner nodes during
front-intersection-tolerance)
remeshing. The recommended value
is 20. (tgapi-boundary-remesh-ob-
ject-labels "object-name"

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
166 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
• Select a "sizing-option" using '(face-zone-label-list)
"constant", "geodesic" or '(edge-zone-list) feature-
"volumetric". min-angle feature-max-angle
corner-angle "sizing-option"
Note constant-size min-size max-
size growth-rate n-retries-
The "geometric" on-failed improve-failed?
option is not front-intersection-tolerance)
supported. (tgapi-boundary-remesh-ob-
ject-labels "object-name"
'(face-zone-label-list)
• Specify values for constant-size "edge-zone-name-pattern*"
(used when "sizing-option" is set feature-min-angle feature-
to "constant"), min-size, max- max-angle corner-angle "siz-
size, and growth-rate (these are ing-option" constant-size
used when "sizing-option" is set min-size max-size growth-rate
to "geodesic"). These values are not n-retries-on-failed improve-
used when the "sizing-option" failed? front-intersection-
is set to "volumetric". tolerance)
(tgapi-boundary-remesh-ob-
Note ject-labels "object-name"
"face-zone-label-pattern*"
All four values must '(edge-zone-list) feature-
be provided regardless min-angle feature-max-angle
of the selected "siz- corner-angle "sizing-option"
ing-option". constant-size min-size max-
size growth-rate n-retries-
A value of -1 can be on-failed improve-failed?
used for the front-intersection-tolerance)
parameters that are
not required for a
particular sizing
option.

• Specify the number of attempts to

improve the failed patches using
explicit remeshing (n-retries-on-
failed) and whether to further
improve the failed patches using
explicit remeshing improve-
failed? set to #t or #f.

• Specify the front-intersection-

tolerance for checking intersections.
The value specified should be in the
range 0 to 1. The recommended value
is 0.0, which can be increased if the
remeshed patch shows intersections.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 167
Boundary Functions

B.1. Examples
To improve mesh quality on all face zones, use marking utilities with functions for improving the surface
mesh and remeshing.

• Mark faces based on quality:

(tgapi-util-mark-faces-by-quality "*" "Skewness" 0.6 #f)

• Improve the marked faces by splitting the longer edge.

(tgapi-boundary-split-marked-faces "*" 0.25)

• Mark faces based on quality:

(tgapi-util-mark-faces-by-quality "*" "Skewness" 0.95 #f)

• Improve sliver faces

(tgapi-boundary-split-and-collapse-sliver-faces "*" 0.01 "Skewness" 0.95

0.25 #t 20)

• Mark face strips between all boundaries based on strip height and quality.

(tgapi-util-mark-face-strips-by-height-and-quality "*" 3 0.01 "Skewness"

0.9 40)

• Improve the marked faces by collapsing face edges.

(tgapi-boundary-collapse-marked-faces "*" #f 20 0.5)

• Mark faces based on quality:

(tgapi-util-mark-faces-by-quality "*" "Skewness" 0.6 #f)

• Remesh the marked faces based on the size field:

(tgapi-boundary-remesh-marked-faces "*" 3 #f 40 180 20 "geodesic" 0.05

0.05 2.5 1.6)

For a mesh object _fluid, remesh all face zones using different sizing options:

• Using geodesic sizing

(tgapi-boundary-remesh-face-zones (tgapi-util-get-face-zone-id-list-of-
object "_fluid") (tgapi-util-get-edge-zone-id-list-of-object "_fluid")
#t 40 155 20 "geodesic" -1 0.35 260 1.35 1 #t 0.3)

• Using volumetric sizing

(tgapi-boundary-remesh-face-zones (tgapi-util-get-face-zone-id-list-of-
object "_fluid") (tgapi-util-get-edge-zone-id-list-of-object "_fluid")
#t 40 155 20 "volumetric" -1 -1 -1 -1 1 #t 0.0)

• Using constant sizing

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
168 of ANSYS, Inc. and its subsidiaries and affiliates.
 Examples

(tgapi-boundary-remesh-face-zones (tgapi-util-get-face-zone-id-list-of-
object "_fluid") (tgapi-util-get-edge-zone-id-list-of-object "_fluid")
#t 40 155 20 "constant" 2.0 -1 -1 -1 1 #t 0.0)

Note

In these examples, a value of -1 has been used for the parameters that are not required for
a particular sizing option.

For a mesh object _fluid, remesh object face zone labels using different sizing options:

• Using geodesic sizing

(tgapi-boundary-remesh-object-labels "_fluid" "*" "*" 40 155 20

"geodesic" -1 0.5 5 1.2 0 #f 0.0)

• Using volumetric sizing

(tgapi-boundary-remesh-object-labels "_fluid" "*" "*" 40 155 20 "volu-

metric" -1 -1 -1 -1 1 #f 0.0)

• Using constant sizing

(tgapi-boundary-remesh-object-labels "_fluid" "*" "*" 40 155 20 "con-

stant" 2.0 -1 -1 -1 1 #f 0.0)

Note

In these examples, a value of -1 has been used for the parameters that are not required for
a particular sizing option.

Patch holes associated with free faces.

• Create a planar surface to patch holes associated with free faces for the list of face zones.

(tgapi-boundary-fill-planar-holes-using-free-faces '(6 5 3 4) (list '(-

10 5 5) '(0 5 5) '(0 -5 5)) 0.001 #t)

• Create a planar surface to patch holes associated with free faces for the list of object face zone labels.

(tgapi-boundary-fill-planar-holes-using-free-faces-in-object "object"
"*" (list '(-10 5 5) '(0 5 5) '(0 -5 5)) 0.001 "symmetry" #t)

• Create a planar surface to patch holes using the free face edges for the edge zones specified.

(tgapi-boundary-create-planar-surface-using-edges "*" (list '(-10 5 5)

'(0 5 5) '(0 -5 5)) 0.001 #f)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 169
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
170 of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix C. Connect Functions
The following connect functions are available:

Feature Description Function

Connect overlapping face zone label pairs by joining (tgapi-connect-join-across-label-
zones across label pairs. pairs 'object-name '(label-pairs)
feature-angle tolerance absolute-
• Specify the mesh object-name. tolerance? separate-overlaps? "separ-
ate-method" remesh? "sizing-method"
• Specify a list of face zone label-pairs to be no-of-layers)
connected. For example, (label1 label2).

• Specify values for the parameters:

– feature-angle (default is 40)

– tolerance (default is 0.95)

– absolute-tolerance? Specify #t or #f
(default, for relative tolerance).

– separate-overlaps? Specify #t (default)

or #f to separate overlapping zones.

– "separate-method" Specify "keep-none"

or "keep-one" (recommended).

– remesh? Specify #t (default) or #f to remesh

after the connect operation.

– "sizing-method" Set to "geometric"

(default) or "size-field".

– no-of-layers Specify the number of rings

of faces to be remeshed around the
connections, default is 3.

Connect overlapping face zone label pairs by (tgapi-connect-intersect-across-la-

intersecting zones across label pairs. bel-pairs 'object-name '(label-pairs)
feature-angle tolerance absolute-
• Specify the mesh object-name. tolerance? separate-intersections?
remesh? "sizing-method" no-of-layers)
• Specify a list of face zone label-pairs to be
connected. For example, (label1 label2).

• Specify values for the parameters:

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 171
Connect Functions

Feature Description Function

– feature-angle (default is 40)

– tolerance (default is 0.95)

– absolute-tolerance? Specify #t or #f
(default, for relative tolerance).

– separate-intersections? Specify #t
(default) or #f to separate intersecting zones.

– remesh? Specify #t (default) or #f to remesh

after the connect operation.

– "sizing-method" Set to "geometric"

(default) or "size-field".

– no-of-layers Specify the number of rings

of faces to be remeshed around the
connections, default is 3.

Connect overlapping face zone label pairs by (tgapi-connect-stitch-across-label-

stitching zones across label pairs. pairs 'object-name '(label-pairs)
"stitch-method" feature-angle toler-
• Specify the mesh object-name. ance absolute-tolerance? remesh?
"sizing-method" no-of-layers)
• Specify a list of face zone label-pairs to be
connected. For example, (label1 label2).

• Specify values for the parameters:

– "stitch-method" Specify "all-all"

(default), "free-free", or "free-non-
free".

– feature-angle (default is 40)

– tolerance (default is 0.95)

– absolute-tolerance? Specify #t or #f
(default, for relative tolerance).

– remesh? Specify #t (default) or #f to remesh

after the connect operation.

– "sizing-method" Set to "geometric"

(default) or "size-field".

– no-of-layers Specify the number of rings

of faces to be remeshed around the
connections, default is 3.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
172 of ANSYS, Inc. and its subsidiaries and affiliates.
 Examples

C.1. Examples
For a mesh object _fluid with face zone labels part1, part2, and part3:

• Connect overlapping face zone label pairs by joining zones across label pairs.

(tgapi-connect-join-across-label-pairs '_fluid (list '(part1 part2)

'(part1 part3) '(part2 part3)) 40 0.95 #f #t "keep-one" #t "geometric"
3)

• Connect overlapping face zone label pairs by intersecting zones across label pairs.

(tgapi-connect-intersect-across-label-pairs '_fluid (list '(part1 part2)

'(part1 part3) '(part2 part3)) 40 0.95 #f #t #t "geometric" 3)

• Connect overlapping face zone label pairs by stitching zones across label pairs.

(tgapi-connect-stitch-across-label-pairs '_fluid (list '(part1 part2)

'(part1 part3) '(part2 part3)) "all-all" 40 0.95 #f #t "geometric" 3)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 173
 Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
174 of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix D. Size Field Functions
The size field defines the sizes in the volume. Having volumetric sizes could pose problems where sizes
are diffused across dead space, leading to unnecessary refinement. In addition to volumetric sizing, a
new type of size definition (geodesic) is introduced to define the sizes along a surface rather than the
volume. The geodesic sizing enables you to confine sizes to surfaces and avoid problems like dead
space refinement.

The following size field functions are available:

Feature Description Function

Initialize On face Initialize geodesic sizing on the specified (tgapi-size-field-initialize-
geodesic zones face zones. geodesic-on-face-zones
sizing '(face-zone-name-list) max-
• Specify the face zones using a face- size)
zone-id-list, face-zone-
(tgapi-size-field-initialize-
name-list, or face-zone-name-
geodesic-on-face-zones
pattern*.
'(face-zone-ID-list) max-
• Specify the max-size value. size)
(tgapi-size-field-initialize-
geodesic-on-face-zones
"face-zone-name-pattern*"
max-size)
On Initialize geodesic sizing on the specified (tgapi-size-field-initialize-
object object face zone labels. geodesic-on-object-labels
face '(object-list) '(face-zone-
zone • Specify the object-list or ob- label-list) max-size)
labels ject-name-pattern* and the face
(tgapi-size-field-initialize-
zone labels using a face-zone-la-
geodesic-on-object-labels
bel-list or face-zone-label-
'(object-list) "face-zone-
name-pattern*.
label-name-pattern*" max-
• Specify the max-size value. size)
(tgapi-size-field-initialize-
geodesic-on-object-labels
"object-name-pattern*"
'(face-zone-label-list) max-
size)
(tgapi-size-field-initialize-
geodesic-on-object-labels
"object-name-pattern*"
"face-zone-label-name-pat-
tern*" max-size)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 175
Size Field Functions

Feature Description Function

On Initialize geodesic sizing on the face (tgapi-size-field-initialize-
object zones for the specified objects. geodesic-on-objects '(ob-
face ject-list) max-size)
zones • Specify the object-list or ob-
(tgapi-size-field-initialize-
ject-name-pattern*.
geodesic-on-objects "object-
• Specify the max-size value. name-pattern*" max-size)

Compute Geodesic Computes geodesic sizes on face nodes (tgapi-size-field-compute-

size sizes based on the size controls specified. geodesic '(size-control-
field name-list))
(tgapi-size-field-compute-
geodesic '(size-control-
name-pattern*))
(tgapi-size-field-compute-
geodesic "size-control-name-
pattern*)
Volumetric Computes the volumetric size field (tgapi-size-field-compute-
sizes based on the size controls specified. volumetric '(size-control-
name-list))
(tgapi-size-field-compute-
volumetric '(size-control-
name-pattern*))
(tgapi-size-field-compute-
volumetric "size-control-
name-pattern*")
Geodesic Computes the geodesic blended size (tgapi-size-field-compute-
blended field as follows. geodesic-blended '(size-con-
size field trol-name-list))
• The volumetric size field is computed
(tgapi-size-field-compute-
based on all edge, face proximity and
geodesic-blended '(size-con-
BOI controls.
trol-name-pattern*))
• Geodesic sizes are computed based (tgapi-size-field-compute-
on the remaining size controls. geodesic-blended "size-con-
trol-name-pattern*")
• Updates geodesic sizes based on
volumetric sizes (the lower minimum
size (geodesic or volumetric) will be
used).

• Hard sizes are computed last.

Update On face Updates nodal (geodesic) sizes based (tgapi-size-field-update-

geodesic zones on the existing volumetric size field for geodesic-with-volumetric-on-
sizes the face zones specified. This requires face-zones '(face-zone-id-
with the volumetric size field to be list))
volumetric computed.
sizes

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
176 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
Specify the face zones using a (tgapi-size-field-update-
face-zone-id-list, face- geodesic-with-volumetric-on-
zone-name-list, or face- face-zones '(face-zone-name-
zone-name-pattern*. list))
(tgapi-size-field-update-
Note geodesic-with-volumetric-on-
face-zones "face-zone-name-
Geodesic sizes need to pattern*")
be initialized and
computed before
attempting an update.

On Updates nodal (geodesic) sizes based (tgapi-size-field-update-

object on the existing volumetric size field for geodesic-with-volumetric-on-
face the face zone labels specified. This object-labels 'object-name
zone requires the volumetric size field to be '(face-zone-label-list))
labels computed. (tgapi-size-field-update-
geodesic-with-volumetric-on-
Specify the object-name and the
object-labels 'object-name
face zone labels using a face-
'(face-zone-label-name-pat-
zone-label-list or face-
tern*))
zone-label-name-pattern*.
(tgapi-size-field-update-
geodesic-with-volumetric-on-
Note
object-labels 'object-name
Geodesic sizes need to "face-zone-label-name-pat-
be initialized and tern*")
computed before (tgapi-size-field-update-
attempting an update. geodesic-with-volumetric-on-
object-labels "object-name"
'(face-zone-label-list))
(tgapi-size-field-update-
geodesic-with-volumetric-on-
object-labels "object-name"
'(face-zone-label-name-pat-
tern*))
(tgapi-size-field-update-
geodesic-with-volumetric-on-
object-labels "object-name"
"face-zone-label-name-pat-
tern*")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 177
Size Field Functions

Feature Description Function

On Updates nodal (geodesic) sizes based (tgapi-size-field-update-
object on the existing volumetric size field for geodesic-with-volumetric-on-
face the face zones of the objects specified. objects '(object-list))
zones This requires the volumetric size field (tgapi-size-field-update-
to be computed. geodesic-with-volumetric-on-
objects "object-name-pat-
Specify the object-list or ob-
tern*")
ject-name-pattern*.

Note

Geodesic sizes need to

be initialized and
computed before
attempting an update.

Scale On Scales and limits geodesic sizes on the (tgapi-size-field-scale-

geodesic marked marked faces for the face zones geodesic-on-marked-faces
sizes faces specified. '(face-zone-id-list) scale-
factor min-size max-size)
• Specify the face zones using a face-
(tgapi-size-field-scale-
zone-id-list, face-zone-
geodesic-on-marked-faces
name-list, or face-zone-name-
'(face-zone-name-list)
pattern*.
scale-factor min-size max-
• Specify the scale-factor. size)
(tgapi-size-field-scale-
• Specify the values for min-size and geodesic-on-marked-faces
max-size "face-zone-name-pattern*"
scale-factor min-size max-
size)
On face Scales and limits geodesic sizes on the (tgapi-size-field-scale-
zones faces for the face zones specified. geodesic-on-face-zones
'(face-zone-id-list) scale-
• Specify the face zones using a face- factor min-size max-size)
zone-id-list, face-zone-
(tgapi-size-field-scale-
name-list, or face-zone-name-
geodesic-on-face-zones
pattern*.
'(face-zone-name-list)
• Specify the scale-factor. scale-factor min-size max-
size)
• Specify the values for min-size and (tgapi-size-field-scale-
max-size geodesic-on-face-zones
"face-zone-name-pattern*"
scale-factor min-size max-
size)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
178 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
On Scales and limits geodesic sizes on the
(tgapi-size-field-scale-
object faces for the face zone labels specified.
geodesic-on-object-labels
face 'object-name '(face-zone-la-
zone • Specify the object-name and the bel-list) scale-factor min-
labels face zone labels using a face-zone- size max-size)
label-list or face-zone-la-
(tgapi-size-field-scale-
bel-name-pattern*.
geodesic-on-object-labels
• Specify the scale-factor. 'object-name "face-zone-la-
bel-name-pattern*" scale-
• Specify the values for min-size and factor min-size max-size)
max-size (tgapi-size-field-scale-
geodesic-on-object-labels
"object-name" '(face-zone-
label-list) scale-factor
min-size max-size)
(tgapi-size-field-scale-
geodesic-on-object-labels
"object-name" "face-zone-la-
bel-name-pattern*" scale-
factor min-size max-size)
On Scales and limits geodesic sizes on the (tgapi-size-field-scale-
object object face zones specified. geodesic-on-objects '(ob-
face ject-list) '(face-zone-la-
zones • Specify the object-list or ob- bel-list) scale-factor min-
ject-name-pattern*. size max-size)
• Specify the scale-factor. (tgapi-size-field-scale-
geodesic-on-object-labels
• Specify the values for min-size and "object-name-pattern*"
max-size "face-zone-label-name-pat-
tern*" scale-factor min-size
max-size)
Filter On face Removes refined surface mesh clusters (tgapi-size-field-filter-
noise zones generated by geodesic sizing on the noise-geodesic '(face-zone-
specified face zones. id-list) growth-rate face-
count)
• Specify the face zones using a face-
(tgapi-size-field-filter-
zone-id-list, face-zone-
noise-geodesic '(face-zone-
name-list, or face-zone-name-
name-list) growth-rate face-
pattern*.
count)
• Specify the growth-rate. It is (tgapi-size-field-filter-
recommended to use a growth rate noise-geodesic "face-zone-
value higher than the value used for name-pattern*" growth-rate
computing the geodesic sizes (for face-count)
example, 1.6).

• Specify the face-count threshold.

For face clusters whose count is less
than the specified threshold value, the

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 179
Size Field Functions

Feature Description Function

geodesic size values will be set to the
average of the values on the cluster
boundary.

Note

Geodesic sizes need to

be initialized and
computed, but
undiffused for the face
zones specified.

Diffuse On face Diffuse geodesic sizing on the specified (tgapi-size-field-diffuse-

geodesic zones face zones. Diffusion can also happen geodesic-on-face-zones
sizing on face zones which are not specified, '(face-zone-name-list) min-
if they can be reached by node flood size max-size growth-rate
filling. diffuse-across-free-edge?
free-diffusion-range)
• Specify the face zones using a face-
(tgapi-size-field-diffuse-
zone-id-list, face-zone-
geodesic-on-face-zones
name-list, or face-zone-name-
'(face-zone-id-list) min-
pattern*.
size max-size growth-rate
• Specify the minimum and maximum diffuse-across-free-edge?
size limits to apply for the node size free-diffusion-range)
(min-size, max-size. (tgapi-size-field-diffuse-
geodesic-on-face-zones
Important "face-zone-name-pattern*"
min-size max-size growth-
The sizes will be rate diffuse-across-free-
bounded to the min- edge? free-diffusion-range)
size and max-size
specified. The final
minimum node size
will be the maximum
of (node-min-size,
min-size) and final
maximum node size
will be the minimum
of (node-max-size,
max-size).

It is recommended
that you specify the
global minimum size
required, as you
cannot revert to the
earlier minimum size
after size diffusion.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
180 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
• Specify the growth-rate to be
applied to diffuse size geodesically
(along the surface).

• Choose whether to enable diffusion

of free node sizes to other free nodes
in proximity, even when they are not
connected (set diffuse-across-
free-edge? to #t or #f).

• Specify the absolute range to be used

to find free nodes in proximity for
diffusion free-diffusion-range
(when diffuse-across-free-
edge? is enabled (#t).

On Diffuse geodesic sizing on the specified (tgapi-size-field-diffuse-

object object labels. Diffusion can also happen geodesic-on-object-labels
face on face zone labels which are not 'object-name '(label-name-
zone specified, if they can be reached by list) min-size max-size
labels node flood filling. growth-rate diffuse-across-
free-edge? free-diffusion-
• Specify the object face zone labels range)
using the object-name and the
label-name-list or label- (tgapi-size-field-diffuse-
name-pattern*. geodesic-on-object-labels
'object-name "label-name-
• Specify the minimum and maximum pattern*" min-size max-size
size limits to apply for the node size growth-rate diffuse-across-
(min-size, max-size. free-edge? free-diffusion-
range)
Important (tgapi-size-field-diffuse-
geodesic-on-object-labels
The sizes will be "object-name" '(label-name-
bounded to the min- list) min-size max-size
size and max-size growth-rate diffuse-across-
specified. The final free-edge? free-diffusion-
minimum node size range)
will be the maximum (tgapi-size-field-diffuse-
of (node-min-size, geodesic-on-object-labels
min-size) and final "object-name" "label-name-
maximum node size pattern*" min-size max-size
will be the minimum growth-rate diffuse-across-
of (node-max-size, free-edge? free-diffusion-
max-size). range)

• Specify the growth-rate to be

applied to diffuse size geodesically
(along the surface).

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 181
Size Field Functions

Feature Description Function

• Choose whether to enable diffusion
of free node sizes to other free nodes
in proximity, even when they are not
connected (set diffuse-across-
free-edge? to #t or #f).

• Specify the absolute range to be used

to find free nodes in proximity for
diffusion free-diffusion-range
(when diffuse-across-free-
edge? is enabled (#t).

D.1. Examples
Consider a model with face zones part1, part2, part3, inlet1, inlet2, and outlet.

• Initialize geodesic sizes for the face zones.

(tgapi-size-field-initialize-geodesic-on-face-zones '(inlet1 outlet)

32.0)

(tgapi-size-field-initialize-geodesic-on-face-zones "part*" 64.0)

• Compute the geodesic sizes for curvature size controls.

(tgapi-size-field-compute-geodesic 'curvature*)

• Compute the volumetric sizes for BOI size controls.

(tgapi-size-field-compute-volumetric 'boi*)

Compute the geodesic blended size field.

(tgapi-size-field-compute-geodesic-blended '*)

• Remove refined surface mesh clusters generated by geodesic sizing on the specified face zones.

(tgapi-size-field-filter-noise-geodesic "part*" 1.6 40)

• Update geodesic sizes with volumetric sizes on selected object face zone labels.

(tgapi-size-field-update-geodesic-with-volumetric-on-face-zones 'part*)

• Scale geodesic sizes on marked faces for face zones.

(tgapi-size-field-scale-geodesic-on-marked-faces '(inlet1 outlet) 0.5

0.15 256)

• Scale geodesic sizes on face zones.

(tgapi-size-field-scale-geodesic-on-face-zones "part*" 0.7 0.15 256)

Consider a model with objects part1, part2, and part3, inlet1, inlet2, and outlet.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
182 of ANSYS, Inc. and its subsidiaries and affiliates.
 Examples

• Initialize geodesic sizes for objects.

(tgapi-size-field-initialize-geodesic-on-objects '(inlet1 inlet2 outlet)

32.0)

(tgapi-size-field-initialize-geodesic-on-objects 'part* 64.0)

• Compute the geodesic sizes for curvature size controls.

(tgapi-size-field-compute-geodesic 'curvature*)

• Compute the volumetric sizes for BOI size controls.

(tgapi-size-field-compute-volumetric 'boi*)

Compute the geodesic blended size field.

(tgapi-size-field-compute-geodesic-blended '*)

• Remove refined surface mesh clusters generated by geodesic sizing on the face zones of mesh objects.

(tgapi-size-field-filter-noise-geodesic (get-face-zones-of-objects
(tgapi-util-get-object-name-list-of-type 'mesh)) 1.6 40)

• Update geodesic sizes with volumetric sizes on selected face zones.

(tgapi-size-field-update-geodesic-with-volumetric-on-objects '(inlet1
inlet2 outlet))

• Scale geodesic sizes on objects.

(tgapi-size-field-scale-geodesic-on-objects ‘part* 0.5 0.15 256)

Consider a model with mesh object _fluid with face zone labels part1, part2, and part3, inlet1, inlet2,
and outlet.

• Initialize geodesic sizes for object face zone labels.

(tgapi-size-field-initialize-geodesic-on-object-labels ‘_fluid '(inlet1

outlet) 32.0)

(tgapi-size-field-initialize-geodesic-on-object-labels ‘_fluid "part*"

64.0)

• Compute the geodesic sizes for curvature size controls.

(tgapi-size-field-compute-geodesic 'curvature*)

• Compute the volumetric sizes for BOI size controls.

(tgapi-size-field-compute-volumetric 'boi*)

Compute the geodesic blended size field.

(tgapi-size-field-compute-geodesic-blended '*)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 183
Size Field Functions

• Update geodesic sizes with volumetric sizes on selected object face zone labels.

(tgapi-size-field-update-geodesic-with-volumetric-on-object-labels
'_fluid '(inlet1 outlet))

• Scale geodesic sizes on object face zone labels.

(tgapi-size-field-scale-geodesic-on-object-labels '_fluid "part*" 0.7

0.15 256)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
184 of ANSYS, Inc. and its subsidiaries and affiliates.
Appendix E. Wrap Functions
Wrapping functions are available for generating the surface mesh for automotive applications for un-
derhood thermal management (UTM) and external-aero analysis. Note that periodic meshes are not
supported.

The following wrap functions are available:

Feature Description Function

Wrap objects Creates the wrapper surface based on the (tgapi-wrap-objects '(object-
objects and material point specified. The list) 'new-object-name "mater-
wrapper surface creation involves ial-point-name" "sizing-type")
operations such as Octree creation, (tgapi-wrap-objects '(object-
intersection, interface creation, projection list) "new-object-name" "mater-
and zone separation. ial-point-name" "sizing-type")
• Specify the objects using an object- (tgapi-wrap-objects "object-
list or object-name-pattern*. name-pattern*" 'new-object-
name "material-point-name"
• Specify a name for the new object. "sizing-type")

• Specify the material point ("materi- (tgapi-wrap-objects "object-

al-point-name") to be used for the name-pattern*" "new-object-
wrap operation. name" "material-point-name"
"sizing-type")
• Specify the sizing type (set "sizing-
type" to "geodesic" or "volumet-
ric".

Note

The size field should be

computed prior to
invoking this API.

Imprint object Imprint feature edges on given mesh (tgapi-wrap-imprint-object-

features object, and returns feature path extracted features 'mesh-object-name
after imprint. separate-off-geometry-edges?
relative-distance critical-
• Specify the mesh object using the angle)
mesh-object-name.
(tgapi-wrap-imprint-object-
• Choose whether to delete feature path features "mesh-object-name"
edges far from geometry. Set separ- separate-off-geometry-edges?
relative-distance critical-
angle)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 185
Wrap Functions

Feature Description Function

ate-off-geometry-edges? to #t
or #f.

• Specify the distance tolerance (relat-

ive-distance) and angle tolerance
(critical-angle) to determine the
features far from the geometry, when
separate-off-geometry-edges?
is set to #t.

Smooth Face Smooth face nodes while preserving the (tgapi-wrap-smooth-face-zones-

face zones features for the face zones specified. with-features-preserved
nodes specified '(face-zone-id-list) mean-
• Specify the face zones using a face- filter-iterations median-fil-
zone-id-list, face-zone-name- ter-iterations number-of-lay-
list, or face-zone-name-pat- ers)
tern*.
(tgapi-wrap-smooth-face-zones-
• Specify the number of mean filter with-features-preserved
iterations (mean-filter-itera- '(face-zone-name-list) mean-
tions). Mean filters use the average of filter-iterations median-fil-
adjacent face normal for smoothing. This ter-iterations number-of-lay-
method is better for smoothing spikes ers)
(tgapi-wrap-smooth-face-zones-
• Specify the number of median filter with-features-preserved "face-
iterations (median-filter-itera- zone-name-pattern*" mean-fil-
tions). Median filters use the median ter-iterations median-filter-
of adjacent face normal for smoothing. iterations number-of-layers)
This method is better for feature
preservation

• Specify the number of layers (number-

of-layers) to be smoothed.

Note

You can use the mean

and median filters
individually or use both
together.

Object Smooth face nodes while preserving the (tgapi-wrap-smooth-object-la-

face features for the object face zone labels bels-with-features-preserved
zone specified. 'mesh-object-name '(face-zone-
labels label-list) mean-filter-itera-
specified • Specify the mesh object and the face tions median-filter-iterations
zone labels using a face-zone-la- number-of-layers)
bel-list or face-zone-label-
(tgapi-wrap-smooth-object-la-
name-pattern*.
bels-with-features-preserved

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
186 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
• Specify the number of mean filter 'mesh-object-name "face-zone-
iterations (mean-filter-itera- label-name-pattern*" mean-
tions). Mean filters use the average of filter-iterations median-fil-
adjacent face normal for smoothing. This ter-iterations number-of-lay-
method is better for smoothing spikes ers)
(tgapi-wrap-smooth-object-la-
• Specify the number of median filter
bels-with-features-preserved
iterations (median-filter-itera-
"mesh-object-name" '(face-
tions). Median filters use the median
zone-label-list) mean-filter-
of adjacent face normal for smoothing.
iterations median-filter-iter-
This method is better for feature
preservation ations number-of-layers)
(tgapi-wrap-smooth-object-la-
• Specify the number of layers (number- bels-with-features-preserved
of-layers) to be smoothed. "mesh-object-name" "face-zone-
label-name-pattern*" mean-
Note filter-iterations median-fil-
ter-iterations number-of-lay-
You can use the mean ers)
and median filters
individually or use both
together.

Face Smooth the face nodes of the mesh (tgapi-wrap-smooth-object-off-

nodes object which are far from the geometry. geometry-faces 'mesh-object-
far Specify the mesh object. name)
from (tgapi-wrap-smooth-object-off-
geometry geometry-faces "mesh-object-
name")
Separate object Separate the mesh object face zones (tgapi-wrap-separate-object-
face zones based on the underlying geometry. face-zones 'mesh-object-name
remove-saw-tooth-configura-
• Specify the mesh object. tions? saw-tooth-feature-
angle)
• Choose whether to remove saw tooth
configurations (set remove-saw- (tgapi-wrap-separate-object-
tooth-configurations? to #t or face-zones "mesh-object-name"
#f). remove-saw-tooth-configura-
tions? saw-tooth-feature-
Specify an appropriate value for angle)
saw-tooth-feature-angle.
This is used to identify angle-based
features so as to avoid removal of
saw-tooth configurations, while
separating zones. For example, at
the corner of a cuboid formed by
six planar zones, a corner face is
topologically a saw tooth
configuration, but will not be
rezoned if the saw-tooth-fea-

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 187
Wrap Functions

Feature Description Function

ture-angle specified is less than
90 degree. The recommended
range is 30 to 60 degrees.

Remesh mesh Remesh the mesh object based on the (tgapi-wrap-remesh-object

object sizing type specified. 'mesh-object-name feature-min-
angle feature-max-angle
• Specify the mesh object. corner-angle "sizing-type"
respect-zone-boundary? front-
• Specify the feature-min-angle and intersection-tolerance)
feature-max-angle. The fea-
ture-min-angle and feature- (tgapi-wrap-remesh-object
max-angle limits are used to retain "mesh-object-name" feature-
angle-based features. The min-angle feature-max-angle
recommended value for feature- corner-angle "sizing-type"
max-angle is 180. respect-zone-boundary? front-
intersection-tolerance)
• Specify the corner-angle. The
corner-angle is the minimum angle
between feature edges that will be
preserved for corner nodes during
remeshing.

• Specify the sizing type (set "sizing-

type" to "geodesic" or "volumet-
ric").

Note

The size field should be

computed prior to
invoking this API.

• Specify if you want to respect zone

boundaries.

• Specify the front-intersection-

tolerance for checking intersections.
The value specified should be in the
range 0 to 1. The recommended value
is 0.0, which can be increased if the
remeshed patch shows intersections.

Resolve face Resolve face intersections for the mesh (tgapi-wrap-resolve-face-inter-

intersections object specified. sections-in-object 'mesh-ob-
ject-name)
(tgapi-wrap-resolve-face-inter-
sections-in-object "mesh-ob-
ject-name")

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
188 of ANSYS, Inc. and its subsidiaries and affiliates.
Feature Description Function
Inflate By Inflate mesh object faces based on the (tgapi-wrap-inflate-object-
object dihedral dihedral angle specified. faces-by-dihedral-angle 'mesh-
faces angle object-name minimum-dihedral-
• Specify the mesh object. angle absolute-min-offset rel-
ative-min-offset number-of-
• Specify an appropriate value for minim- iterations remove-saw-tooth-
um-dihedral-angle. The minim- configurations?)
um-dihedral-angle is the angle
between faces connected by an edge. (tgapi-wrap-inflate-object-
The faces will be inflated if the angle is faces-by-dihedral-angle "mesh-
less than the specified value. object-name" minimum-dihedral-
angle absolute-min-offset rel-
• Specify the absolute-min-offset ative-min-offset number-of-
and relative-min-offset. iterations remove-saw-tooth-
configurations?)
The absolute-min-offset is
the absolute distance used to
move the nodes to increase the
gap. The relative-min-off-
set is the relative distance (as a
factor of local edge length) used
to move the nodes.

• Specify the number of iterations (num-

ber-of-iterations).

• Choose whether to remove saw tooth

configurations (set remove-saw-
tooth-configurations? to #t or
#f.

By Inflate mesh object faces based on invalid (tgapi-wrap-inflate-object-

invalid normals. faces-by-invalid-normal 'mesh-
normal object-name number-of-layers
• Specify the mesh object. absolute-min-offset relative-
min-offset number-of-itera-
• Specify an appropriate value for num- tions remove-saw-tooth-config-
ber-of-layers. The number-of- urations?)
layers is the number of layers of face
nodes around the invalid normal (tgapi-wrap-inflate-object-
location to be inflated. faces-by-dihedral-angle "mesh-
object-name" number-of-layers
• Specify the absolute-min-offset absolute-min-offset relative-
and relative-min-offset. min-offset number-of-itera-
tions remove-saw-tooth-config-
The absolute-min-offset is urations?)
the absolute distance used to
move the nodes to increase the
gap. The relative-min-off-
set is the relative distance (as a
factor of local edge length) used
to move the nodes.

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 189
Wrap Functions

Feature Description Function

• Specify the number of iterations (num-
ber-of-iterations).

• Choose whether to remove saw tooth

configurations (set remove-saw-
tooth-configurations? to #t or
#f.

Improve Improve Improve the mesh object quality. (tgapi-wrap-improve-object-

mesh mesh quality 'mesh-object-name ag-
object object • Specify the mesh object. gressively?)
quality (tgapi-wrap-improve-object-
• Enable aggressive improvement if
required (set aggressively? to #t quality "mesh-object-name"
or #f. When this option is enabled, the aggressively?)
features may not be preserved during
the improve operation.

For tet Improve mesh object for tet meshing. (tgapi-wrap-improve-object-

meshing for-tet-meshing 'mesh-object-
• Specify the mesh object. name "material-point-name"
max-cell-skewness max-face-
• Specify the material point ("materi- skewness max-face-size-change)
al-point-name").
(tgapi-wrap-improve-object-
• Set the max-cell-skewness, max- for-tet-meshing "mesh-object-
face-skewness, and max-face- name" "material-point-name"
size-change. max-cell-skewness max-face-
skewness max-face-size-change)
For Improve mesh object for prism meshing. (tgapi-wrap-improve-object-
prism In general, zones will inherit the prism for-prism-meshing 'mesh-ob-
meshing settings from the underlying geometry. ject-name number-of-layers
For zones that do not inherit prism "offset-method" prism-aspect-
settings, the settings passed as arguments ratio last-ratio-percentage
will be used. prism-layer-first-height
prism-layer-growth-rate qual-
• Specify the mesh object. ity-measure max-cell-skewness
max-face-skewness keep-
• Specify the number of layers (number-
prisms?)
of-layers). The number of layers
should be the same as that set for prism (tgapi-wrap-improve-object-
meshing. for-prism-meshing "mesh-ob-
ject-name" number-of-layers
• Set the prism offset-method. Select offset-method prism-aspect-
one of the options "aspect-ratio", ratio last-ratio-percentage
"last-ratio", "uniform", or prism-layer-first-height
"minimum-height". prism-layer-growth-rate qual-
ity-measure max-cell-skewness
• Set the prism-aspect-ratio, if max-face-skewness keep-
applicable. prisms?)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
190 of ANSYS, Inc. and its subsidiaries and affiliates.
 Examples

Feature Description Function

• Set the last-ratio-percentage,
if applicable.

• Set the prism-layer-first-

height.

• Set the prism-layer-growth-

rate.

• Specify the quality-measure to be

used.

• Set the max-cell-skewness and

max-face-skewness.

• Choose whether to retain the prisms (set

keep-prisms? to #f or #t) (this
requires beta features to be enabled).

Note

A value of -1 can be used

for the parameters that
are not required for a
particular offset method.

E.1. Examples
For a model with geometry objects part1, part2, part3 and material point fluid:

• Compute the size field.

(tgapi-size-field-compute-geodesic-blended '*)

• Wrap the geometry objects using the material point fluid.

(tgapi-wrap-objects 'part* '_fluid "fluid" "geodesic")

• Imprint feature edges on the mesh object.

(tgapi-wrap-imprint-object-features '_fluid #t 0.2 15)

• Smooth face nodes while preserving features.

(tgapi-wrap-smooth-face-zones-with-features-preserved (get-face-zones-
of-objects '(_fluid)) 5 15 0)

• Smooth the face nodes of the mesh object which are far from the geometry.

(tgapi-wrap-smooth-object-off-geometry-faces '_fluid)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
of ANSYS, Inc. and its subsidiaries and affiliates. 191
Wrap Functions

• Remesh the mesh object.

(tgapi-wrap-remesh-object '_fluid 40.0 180.0 180.0 "geodesic" #f 0.0)

• Improve the mesh object quality.

(tgapi-wrap-improve-object '_fluid #t)

• Resolve thin regions and self intersections.

(tgapi-wrap-inflate-object-faces-by-invalid-normal '_fluid 2 0.0 0.2 2

#t)

(tgapi-wrap-inflate-object-faces-by-dihedral-angle '_fluid 10 0.0 0.2

2 #t)

(tgapi-wrap-resolve-face-intersections-in-object '_fluid)

• Improve mesh object for tet meshing.

(tgapi-wrap-improve-object-for-tet-meshing '_fluid "fluid" 0.96 0.8 2.0)

• Improve mesh object for prism meshing.

(tgapi-wrap-improve-object-for-prism-meshing '_fluid 1 "aspect-ratio"

5 -1 -1 1.2 "inverse-ortho" 0.97 0.9 #f)

Note

A value of -1 has been used for the parameters that are not required for the offset
method chosen.

• Separate the mesh object face zones based on the geometry.

(tgapi-wrap-separate-object-face-zones '_fluid #t 0.0)

Release 18.2 - © ANSYS, Inc. All rights reserved. - Contains proprietary and confidential information
192 of ANSYS, Inc. and its subsidiaries and affiliates.