Download - tool gambit

8/14/2019 tool gambit

1/35

TOOLS COMMANDS

19982007 Fluent, Inc. All rights reserved. 5-1

5. TOOLS COMMANDS

GAMBIT tools commands allow you to perform the following types of operations:

Coordinate system

Size function

Turbo Geometry cleanup

Coordinate-system commands allow you to create and work with GAMBIT local

coordinate systems. Turbo commands allow you to define and generate turbo profiles and

to create turbo volumes. Size-function commands allow you to create and attach size

functions to geometric entities as a means to control mesh element sizes for triangular and

tetrahedral meshes. The geometry cleanup command provides allows you to identify and

automatically fix geometry problems such as very short edges, holes, and sharp angles.


2/35

Coordinate System Commands TOOLS COMMANDS

5-2 19982007 Fluent, Inc. All rights reserved.

5.1 Coordinate System Commands

GAMBIT coordinate-system commands allow you to perform operations that involve

coordinate systems. They include the following commands:

coordinate activate

coordinate create

coordinate delete

coordinate modify

coordinate modify (grid)

coordinate modify ruler

coordinate summarize

The following sections summarize the purpose, form, and parameters associated with each

of the commands listed above.


3/35

TOOLS COMMANDS Coordinate System Commands


5.1.1 coordinate activate

Purpose

To activate an existing coordinate system.

GUI Operation

ToolsCoordinate SystemActivate Coordinate System

General Form

coordinate activate system

Example

coordinate activate "c_sys.2"

Keywords

None


4/35



5.1.2 coordinate create

Purpose

To create a local coordinate system.

GUI Operation

ToolsCoordinate SystemCreate Coordinate System

General Form

coordinate create [ system][ cartesiancylindricalspherical ]

{ rotation[ oldsystem system][ offset real1[ real2[ real3]]

[ axis1 axis1angle1 real1[ axis2 axis2angle2 real2

[ axis3 axis3angle3 real3] ] ]

vertices vertex1vertex2vertex3 }

Example

coordinate create "c_sys.2" cylindrical rotation offset 5 0 5 \axis1 "x" angle1 45 axis2 "y" angle2 135

Keywords

Keyword Description

angle1 Specifies the angle of rotation (real1) in degrees about axis1

angle2Specifies the angle of rotation (real2) in degrees about axis2

angle3 Specifies the angle of rotation (real3) in degrees about axis3

axis1 Specifies an axis of rotation about which to orient the new

coordinate system relative to the reference system (x, y,z)


coordinate system relative to the reference system (x,y,z)


5/35



Keyword Description


coordinate system relative to the reference system (x,y,z)

cartesian Specifies the Cartesian coordinate system (default) the default

parameters of which arex,y,z

cylindrical Specifies a cylindrical coordinate system the default parameters

of which are r,,z

offset Specifies the coordinates of the origin of the new system relative

to the reference system (real1,real2,real3 =(x,y,z)or

(r,,z) or (r,, ))

oldsystem Specifies the existing coordinate system (system) relative to

which the new coordinate system is located (the active

coordinate system is the default reference system)

rotation Specifies location and orientation parameters for the new

coordinate system

spherical Specifies a spherical coordinate system the default parameters of

which are r,,

vertices Specifies three vertices that define the origin (vertex1),xaxis

(vertex2), andx-yplane (vertex3) for the new system


6/35


7/35



5.1.4 coordinate modify

Purpose

To change the coordinate system default system type or label.

GUI Operation

ToolsCoordinate SystemModify Coordinate System

General Form

coordinate modify [ system ][ cartesiancylindricalspherical ]

[ label string]

Example

coordinate modify "c_sys.2" cartesian label "tempsystem"

Keywords

Keyword Description

cartesian Specifies the Cartesian coordinate system (default) the default

parameters of which arex,y,z

cylindrical Specifies a cylindrical coordinate system the default parameters

of which are r,,z

label Specifies a new entity label (string)

spherical Specifies a spherical coordinate system the default parameters of

which are r,,


8/35



5.1.5 coordinate modify (grid)

Purpose

To modify any currently displayed grid.GUI Operation

ToolsCoordinate SystemDisplay Grid

General Form

coordinate modify system{ xyplaneyzplanezxplane }

{ xaxisyaxiszaxis }

[ add real[ and real[ and real] ... ]remove real[ and real[ and real] ... ]]

[ offset real]

[ default realreset ][ lowerbound real ][ upperbound real ][ nosnapsnap ]

[ nolineslines ]

Example

coordinate modify "c_sys.2" yzplane add -7.5 and -2.5 and \2.5 and 7.5 offset 3 snap nolines

Keywords

Keyword Description

add Specifies the position of a line or row of points (real1,real2,

...) to add to the specified grid

default Specifies the spacing increment (real> 0) between grid lines or

parallel rows of grid points


9/35



Keyword Description

lines Specifies that the grid is displayed as a series of intersecting

perpendicular lines

lowerbound Specifies realas the lower limit of the grid range

nolines Specifies that the grid is displayed as a matrix of points

nosnap Specifies that vertices created by means of the mouse are created

by projecting the selection point onto the grid, but not snapping

to the nearest grid point

offset Specifies the distance (real) by which the grid plane is offset

from the origin of the specified coordinate system along the grid

axis

remove Specifies the position of a line or row of points (real1,real2,

...) to remove from the specified grid

reset Specifies that all currently displayed grid points and lines areremoved

snap Specifies that vertices created by means of the mouse are created

at the grid point nearest to the selection point

upperbound Specifies realas the upper limit of the grid range

xaxisyaxiszaxis

Specifies thex,y, orzcoordinate axis

xyplaneyzplane

zxplane

Specifies thexy,yz, orzxcoordinate plan


10/35



5.1.6 coordinate modify ruler

Purpose

To display rulers along any or all of the axes in the currently active coordinate system.

GUI Operation

ToolsCoordinate SystemDisplay Ruler

General Form

coordinate modify systemruler[ xinvisiblexvisiblexboundingbox ]

[ yinvisibleyvisibleyboundingbox ]

[ zinvisiblezvisiblezboundingbox ]

[ xrange real1 real2 ][ yrange real1 real2 ][ zrange real1 real2 ][ xintervals integerxscale real]

[ yintervals integeryscale real]

[ zintervals integerzscale real ]

[ subintervals integer

xtics integer and/orytics integerand/orztics integer]

Example

coordinate modify "c_sys.2" ruler xboundingbox yrange 7.5 \

2.5 yintervals 4 subintervals 4

Keywords

Keyword Description

subintervals Specifies the number (integer> 1) of minor (unnumbered)

subintervals for all axes


11/35



Keyword Description

xboundingbox Specifies that thex-ruler is visible, restricted to the model

bounding box

xintervals Specifies the number (0 < integer< 101) of major

(numbered) intervals for thexaxis

xinvisible Specifies that thex-ruler is invisible

xrange Specifies the lower (real1) and upper (real2) limits of the

range of values for thexaxis

xscale Specifies the size (real> 0) of major (numbered) intervals for

thexaxis

xtics Specifies the number (integer> 0) of minor (unnumbered)

tic marks for thexaxis

xvisible Specifies that thex-ruler is visible, restricted to xrange

yboundingbox Specifies that they-ruler is visible, restricted to the model

bounding box

yintervals Specifies the number (0 < integer< 101) of major

(numbered) intervals for theyaxis

yinvisible Specifies that they-ruler is invisible

yrange Specifies the lower (real1) and upper (real2) limits of the

range of values for theyaxis

yscale Specifies the size (real> 0) of major (numbered) intervals for

theyaxis

ytics Specifies the number (integer> 0) of minor (unnumbered)

tic marks for theyaxis

yvisible Specifies that they-ruler is visible, restricted to yrange

zboundingbox Specifies that thez-ruler is visible, restricted to the model

bounding box


12/35



Keyword Description

zintervals Specifies the number (0 < integer< 101) of major

(numbered) intervals for thezaxis

zinvisible Specifies that thez-ruler is invisible

zrange Specifies the lower (real1) and upper (real2) limits of therange of values for thezaxis

zscale Specifies the size (real> 0) of major (numbered) intervals for

thezaxis

ztics Specifies the number (integer> 0) of minor (unnumbered)

tic marks for thezaxis

zvisible Specifies that thez-ruler is visible, restricted to zrange


13/35



5.1.7 coordinate summarize

Purpose

To display in the Transcriptwindow the global coordinates of coordinate system origins

and axis vectors.

GUI Operation

ToolsCoordinate SystemSummarize Coordinate Systems

General Form

coordinate summarize [ system1[system2 ... ] ]

Example

coordinate summarize "c_sys.1" "c_sys.2"

Keywords

None


14/35

Size Function Commands TOOLS COMMANDS


5.2 Size Function Commands

GAMBIT size-function commands allow you to create and attach size functions that

control mesh element sizes for edge meshes as well as for face and volume meshes

created using triangular and tetrahedral meshes, respectively. (For a complete description

of the creation and use of size functions, see Section 5.2 of the GAMBIT Modeling

Guide.)

The following size-function commands are available in GAMBIT:

sfunction attach

sfunction bgrid

sfunction create

sfunction delete

sfunction detach

sfunction modify

sfunction summarize

The following sections describe the commands listed above.


15/35


16/35



5.2.2 sfunction bgrid

Purpose

To generate a size-function background grid for all lower- and upper-topology entities

associated with a specified entity.

GUI Operation

None

General Form

sfunction bgrid{ attachedges edge1[ edge2... ]attachfaces face1[ face2... ]attachvolumes volume1[ volume2... ] }

Example

sfunction attachvolumes "volume.2"

Keywords

Keyword Description

attachedges Specifies one or more edges to which the size function(s) is/are

attached

attachfaces Specifies one or more faces to which the size function(s) is

is/are attached

attachvolumes Specifies one or more volumes to which the size function(s)

is/are attached


17/35

TOOLS COMMANDS Size Function Commands


5.2.3 sfunction create

Purpose

To create and (optionally) attach a size function.

GUI Operation

ToolsSize FunctionCreate Size Function

General Form

sfunction create [ sfunction]{ curvature

{ sourceedges edge1[ edge2 ...]sourcefaces face1[ face2 ...] }

normalangle realgrowthratereal[ sizelimitreal][ minsize real]

fixed{ sourcevertices vertex1[ vertex2 ...]

sourceedges edge1[ edge2 ...]sourcefaces face1[ face2 ...]sourcevolumes volume1[ volume2 ...] }

startsize realgrowthratereal[ sizelimitreal]

meshed{ sourceedges edge1[ edge2 ...]sourcefaces face1[ face2 ...] }

growthratereal[ sizelimitreal]

proximity{ sourcefaces face1[ face2 ...]sourcevolumes volume1[ volume2 ...] }

cellspergap real

growthratereal[ sizelimit real][ minsize real] }

{ attachedges edge1 [ edge2... ]attachfaces face1[ face2... ]attachvolumes volume1[ volume2 ...] }

Example

sfunction create fixed sourceedge "edge.11" startsize 0.2 \growthrate 1.05 sizelimit 2 attachfaces "face.132"


18/35



Keywords

Keyword Description

attachedges Specifies one or more edges to which the size function is to be

attached

attachfaces Specifies one or more faces to which the size function is to beattached

attachvolumes Specifies one or more volumes to which the size function is to

be attached

cellspergap Specifies the number of layers of mesh elements to be located

in the gaps between volume surfaces

curvature Creates a curvature-type size function

fixed Creates a fixed-type size function

growthrateSpecifies the rate at which the mesh element edge lengthsincrease with distance from the source entity

meshed Creates a meshed-type size function

minsize Specifies the minimum mesh element edge length on an

attached entity

normalangle Specifies the maximum allowable angle between outward-

pointing normals for any two adjacent mesh elements located

immediately adjacent to the surface of a source entity

proximity Creates a proximity-type size function

sizelimit Specifies the maximum mesh element edge length on an

attached entity

sourceedges Specifies a set of source edges for the size function

sourcefaces Specifies a set of source faces for the size function

sourcevertices Specifies a set of source vertices for the size function


19/35



Keyword Description

sourcevolumes Specifies a set of source volumes for the size function

startsize Specifies the maximum length of any adjacent mesh element

edge in proximity of the source entity


20/35



5.2.4 sfunction delete

Purpose

To delete one or more size functions. (NOTE: If no size function is specified, all size

functions are deleted.)

GUI Operation

ToolsSize FunctionDelete Size Functions

General Form

sfunction delete [ sfunction1[ sfunction2... ] ]

Example

sfunction delete "sfunc.1" "sfunc.4"

Keywords

None


21/35



5.2.5 sfunction detach

Purpose

To detach one or more existing size functions from their attachment entities.

GUI Operation

None

General Form

sfunction detach sfunction1[ sfunction2 ...]{ attachedges edge1 [ edge2... ]attachfaces face1[ face2... ]attachvolumes volume1[ volume2 ...] }

Example

sfunction detach "sfunc.1" attachvolume "volume.2"

Keywords

Keyword Description

attachedges Specifies the edge(s) from which the size function(s) is/are to

be detached

attachfaces Specifies the face(s) from which the size function(s) is/are to be

detached

attachvolumes Specifies the volume(s) from which the size function(s) is/are

to be detached


22/35



5.2.6 sfunction modify

Purpose

To modify an existing size function. (NOTE: Any source entities specified for the

sfunction modifycommand must correspond to those allowed by the source-function

type. For example, when modifying a curvature size function, you cannot use the

sourcevertices or sourcevolumeskeywords, because curvature size functions do

not allow the use of vertices or volumes as source entities.)

GUI Operation

ToolsSize FunctionModify Size Function

General Form

sfunction modify sfunction[ normalangle realstartsize realcellspergap real]

[ growthratereal][ sizelimitreal][ minsize real][ labellabel][ attachedges edge1 [ edge2... ]attachfaces face1[ face2... ]attachvolumes volume1[ volume2 ...] ]

[ sourcevertices vertex1[ vertex2 ...]sourceedges edge1[ edge2 ...]sourcefaces face1[ face2 ...]sourcevolumes volume1[ volume2 ...] ]

Example

sfunction modify "sfunc.3" startize 0.2 growthrate 1.05

Keywords

Keyword Description

attachedges Specifies one or more edges to which the size function is to be

attached

attachfaces Specifies one or more faces to which the size function is to be

attached


23/35



Keyword Description

attachvolumes Specifies one or more volumes to which the size function is to

be attached

cellspergap Specifies the number of layers of mesh elements to be located

in the gaps between volume surfaces for aproximitysize

function

growthrate Specifies the rate at which the mesh element edge lengths

increase with distance from the source entity

label Specifies a new label for the size function

minsize Specifies the minimum mesh element edge length on an

attached entity

normalangle Specifies the maximum allowable angle between outward-

pointing normals for any two adjacent mesh elements located

immediately adjacent to the surface of a source entity for a

curvaturesize function

sizelimit Specifies the maximum mesh element edge length on an

attached entity

sourceedges Specifies a set of source edges for the size function

sourcefaces Specifies a set of source faces for the size function

sourcevertices Specifies a set of source vertices for the size function

sourcevolumes Specifies a set of source volumes for the size function

startsize Specifies the maximum length of any adjacent mesh element

edge in proximity of the source entity for afixedsize function


24/35



5.2.7 sfunction summarize

Purpose

To display information on one or more size functions in the Transcriptwindow.

GUI Operation

ToolsSize FunctionSummarize Size Functions

General Form

sfunction summarize [sfunction1[sfunction2 ... ] ]

Example

sfunction summarize "sfunc.5" "sfunc.6"

Keywords

None


25/35

TOOLS COMMANDS Turbo Commands


5.3 Turbo Commands

GAMBIT turbo commands allow you to define, create, modify, mesh, and view turbo

volumes. (For a complete description of GAMBIT turbo modeling, see Section 5.3 of the

GAMBIT Modeling Guide.)

The turbo commands available in GAMBIT are:

turbo create

turbo decompose

turbo view

turbo volume

turbo zones

The following sections describe the commands listed above.


26/35

Turbo Commands TOOLS COMMANDS


5.3.1 turbo create

Purpose

To define and generate a turbo profile.

GUI Operation

ToolsTurboCreate Turbo Profile

General Form

turbo createhub vertexcasing vertexblade vertex1 vertex2[ vertex3 ...][ splitters vertex1 vertex2 [ vertex3 ...]{ xaxisyaxiszaxisvertices vertex1vertex2vector real1real2real3

[ origin real1real2real3]onedge edge} }

Example

turbo create hub "vertex.19" casing "vertex.7" blade \"vertex.11" "vertex.34" "vertex.55" yaxis

Keywords

Keyword Description

blade Specifies the leading (inlet-side) vertices on sets of connected

edges that comprise cross sections of the turbo blade

casing Specifies the inlet vertex on the edge that defines the shape and

location of the casing

hub Specifies the inlet vertex on the edge that defines the shape and

location of the hub

onedge Specifies an edge (edge) the endpoints of which define the

axis of revolution


27/35



Keyword Description

origin Specifies the coordinates of the origin of the axis-of-revolution

vector (real1, real2, real3 =(x, y, z) or (r,,z) or (r,,

))

splitters Specifies the leading (inlet-side) vertices on sets of connected

edges that comprise cross sections of the turbo splitter

vector Specifies the coordinates of the endpoint of the vector that

defines the axis of revolution (real1, real2, real3 =(x, y,

z) or (r,,z) or (r,, ))

vertices Specifies the origin (vertex1) and endpoint (vertex2) of the

a vector that defines the axis of revolution

xaxis Specifies that thexaxis of the active coordinate system defines

the axis of revolution

yaxis Specifies that theyaxis of the active coordinate system defines


zaxis Specifies that thezaxis of the active coordinate system defines



28/35



5.3.2 turbo decompose

Purpose

To decompose a turbo volume to facilitate meshing.

GUI Operation

ToolsTurboDecompose Turbo Volume

General Form

turbo decompose{ spanlinkedgesplithtypehctypehotype }

Example

turbo decompose hotype

Keywords

Keyword Description

edgesplit Creates mesh links between spanwise surfaces and splits

appropriate edges of the turbo volume without fully

decomposing the volume

hctype (Not yet supported) Decomposes the volume using an H-C

decomposition template

hotype (Not yet supported) Decomposes the volume using an H-O

decomposition template

htype Decomposes the volume using an H decomposition template

spanlink Creates mesh links between spanwise surfaces of the turbo

volume without decomposing the volume


29/35



5.3.3 turbo view

Purpose

To display a cascade view of a turbo volume in any or all of the graphics windows.

GUI Operation

ToolsTurboView Turbo Volume

General Form

turbo view[ hubcasingspanwise spanoff ]

[ inwindow window1[ window2... ]

Example

turbo view spanwise 1 inwindow 2

Keywords

Keyword Description

casing Displays a view of the casing surface

hub Displays a view of the hub surface (Default)

inwindow Specifies the graphics window(s) in which the turbo view is to

be displayed

off Returns all graphics windows to standard views and operations

spanwise Displays a view of the upper surface of span number span


30/35



5.3.4 turbo volume

Purpose

To create a turbo volume. (NOTE: To create a turbo volume, you must first define and

generate a turbo profile.)

GUI Operation

ToolsTurboCreate Turbo Volume

General Form

turbo volume[ bladecount integerangle real]

[ tip vertextiplength real]

[ spanwise integer]

Example

turbo volume bladecount 10 tiplength 1

Keywords

Keyword Description

angle Total angle (in degrees) swept by the turbo volume

bladecount Number of blades included in the entire turbo configuration

(determines the total angle represented by the turbo volume)

spanwise Specifies the number of spanwise sections in the turbo

volume

tip Specifies the leading (inlet-side) vertex on an edge that

defines the clearance between the blade tips and casing

tiplength Blade-tip/casing clearance expressed as an absolute value


31/35



5.3.5 turbo zones

Purpose

To assign turbo zone types to an existing turbo volume.

GUI Operation

ToolsTurboDefine Turbo Zones

General Form

turbo zoneshub face1[ face2... ]casing face1[ face2... ]inlet face1[ face2... ]outlet face1[ face2... ]pressure face1[ face2... ]suction face1[ face2... ]

Example

turbo zones hub "face.5" casing "face.9" inlet "face.10" \outlet "face.2" pressure "face.3" "face.4" "face.6" suction \"face.1" "face.7" "face.8"

Keywords

Keyword Description

casing Specifies the face(s) that comprise the casing surface of the

turbo volume

hub Specifies the face that comprises the hub surface of the turbo

volume

inlet Specifies the face(s) that comprise the inlet surface of the turbo

volume

outlet Specifies the face(s) that comprise the outlet surface of the

turbo volume

pressure Specifies the face(s) that comprise the pressure side of the

turbo blade


32/35



Keyword Description

suction Specifies the face(s) that comprise the suction side of the turbo

blade


33/35

TOOLS COMMANDS Geometry Cleanup Commands


5.4 Geometry Cleanup Command

The GAMBIT geometry cleanup command allows you to automatically identify and fix

geometry problems, such as very short edges, holes, and sharp or large angles. (For a

complete description of GAMBIT geometry cleanup commands, see Section 5.4 of the

GAMBIT Modeling Guide.)

The geometry cleanup command available in GAMBIT is:

gcleanup

The following section describes the command listed above.


34/35

Geometry Cleanup Commands TOOLS COMMANDS


5.4.1 gcleanup

Purpose

To clean up model geometry by automatically performing geometry cleanup operations.

GUI Operations

ToolsGeometry CleanupClean Up Short Edges

ToolsGeometry CleanupClean Up Holes

ToolsGeometry CleanupClean Up Sharp Angles

ToolsGeometry CleanupClean Up Large Angles

ToolsGeometry CleanupClean Up Small Faces

ToolsGeometry CleanupClean Up Duplicate Volumes

ToolsGeometry CleanupClean Up Duplicate Faces

ToolsGeometry CleanupClean Up Duplicate Edges

ToolsGeometry CleanupClean Up Duplicate Vertices

General Form

gcleanup{ shortedgeholesharpanglelargeanglesmallface

[ sliver ]dupvolumedupface

[ centroid ]dupedgedupvertex }

[ domain domain_name][ criterion real]

Example

gcleanup shortedge domain "group.3" criterion 10.5


35/35

TOOLS COMMANDS Geometry Cleanup Commands


Keywords

Keyword Description

centroid Defines duplicate faces in terms of the proximity of their

centroids rather than similarity of topology and proximity of

boundary edges.

criterion Specifies the cleanup criterion for the short-edge, sharp-angle,

and large-angle cleanup operations. The cleanup criterion

represents the maximum length for the short-edge cleanup

operation and the maximum angle for the sharp-angle and

large-angle cleanup operations. (NOTE: If you do not specify a

criterion, GAMBIT applies a default criterion to the specified

operation.)

domain Specifies the cleanup domain. (NOTE: If you do not specify a

cleanup domain, GAMBIT applies the specified cleanup

operation to the entire model.)

dupedge Cleans up duplicate edges in the specified domain.

dupface Cleans up duplicate faces in the specified domain.

dupvertex Cleans up duplicate vertices in the specified domain.

dupvolume Cleans up duplicate volumes in the specified domain.

hole Cleans up holes in the specified domain.

largeangle Cleans up large angles in the specified domain.

sharpangle Cleans up sharp angles in the specified domain.

shortedge Cleans up short edges in the specified domain.

sliver Defines small edges by proximity of opposing edges rather than

area only.

smallface Cleans up small faces in the specified domain.

Download - tool gambit

Top Related