Fluent User Services Center Introductory GAMBIT Notes

GAMBIT v2.0 Jan 2002

www.fluentusers.com

Introduction to GAMBIT

1-1 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Agenda Day 1
8:00 Introduction + Demo 2:00 Tutorial 3: Edge and Face Meshing
Exercises
9:15 Tutorial 1: Creating and
Meshing Basic Geometry 2:45 Volume Meshing and the Sizing
Function
9:45 Creating Geometry in Gambit
3:45 Tutorial 4: Volume Meshing and
Sizing Function Exercises
10:45 Tutorial 2: Geometry Creation
Exercises
4:30 Volume Decomposition Examples
12:00 Lunch
5:00 Break for the Day
1:00 Edge/Face Meshing and Mesh
Quality

1-2 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Agenda Day 2
8:00 Tutorial 5: Volume 1:00 Tutorial 7 or 8: Continued
Decomposition Exercises
1:30 Tutorial 9: Hex meshing the Flow
8:45 Mesh Control through Boundary Probe
Layers and Face Vertex Types
3:00 Work on your own Project
or
9:30 Tutorial 6: Vertex Types
1:00 Tutorial 7 or 8: Continued
10:30 CAD/CAE Import and Geometry
Cleanup + Demo 1:30 G/Turbo + Demo

3:00 Work on your own Project

11:30 Tutorial 7 or 8: Geometry Import
Exercise 5:00 Break for the Day

12:00 Lunch

1-3 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

What is GAMBIT?

u A single, integrated preprocessor for CFD analysis:

l Geometry construction and import
n Using ACIS solid modeling capabilities

n Using STEP, Parasolid, IGES, etc. import

s Cleanup and modification of imported data

l Mesh generation for all Fluent solvers (including FIDAP and POLYFLOW)
n Structured and Unstructured hexahedral, tetrahedral, pyramid, and prisms.

l Mesh quality examination

l Boundary zone assignment

1-4 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Operation
u General sequence of operations
l Initial setup
n Solver selection, Mesh size, Defaults, etc.

l Geometry Creation (ACIS, STEP, Parasolid, IGES or Mesh import)

n Create full geometry

n Decompose into mesh-able sections

l Meshing
n Local meshing: Edge and Boundary layers

n Global meshing: Face and/or Volume

l Mesh examination
l Zone assignment
n Continuum and Boundary attachment

l Mesh export

1-5 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Files (1)

u GAMBIT directory and files

l When GAMBIT starts up, it creates a directory called GAMBIT.#

n # = the process number

n It also creates a “lock” file, ident.lok, in the working directory

n ident.lok prevents any user from starting up another session using the

same identifier in the same directory. If the code crashes, this file needs to
be manually removed.
l Three files are created inside this directory

n ident.dbs = the database. All information will be saved in this

file. This file is NOT retrievable upon a crash
n jou = the journal file. This file is directly accessible
from the Run journal form
n trn = the transcript file. Output from GAMBIT

1-6 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Files (2)
u GAMBIT directory and files
l GAMBIT permanently saves these files to your working directory as

ident.dbs, ident.jou and ident.trn anytime you issue a “Save”

option (equivalent to any standard word processor)
n Upon Save, earlier versions of ident.dbs and ident.trn will be

overwritten, while new commands are appended to the file ident.jou

l Upon successful exit of GAMBIT:
n The directory GAMBIT.# is removed

n The lock-file ident.lok is deleted

1-7 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Startup: DEMO
u Start gambit with
“gambit filename”
l NT Users must Before save
start Gambit this
way from a
command prompt.
u Example: Start
Gambit in directory
“projects” After save

u > gambit airfoil

1-8 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Journal Files

u Journal File:
l Executable list of Gambit commands
n Created automatically by Gambit from GUI and TUI.

n Can be edited or created externally with text editor.

l Journals are small - easy to transfer, e-mail, store

u Uses:
l Can be parameterized, comments can be added
l Easy recovery from a crash or power loss
l edit existing commands to create new ones

1-9 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Running Journal Files

u Journal files can be processed in two ways:
l Batch mode (Run)
n All commands processed without interruption.

n “read pause” command will force interrupt with

resume option appearing.

l Interactive mode (Edit/Run)
n Includes text editor for easy modifications

s Mark lines in process field

to activate for processing.
s Editable text field.
s Right click text field
for more options.
s Auto or Step through
activated process lines.

1-10 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Journal File: Parametric Modeling

u Parameters (incl. arrays), control-blocks, do-loops, arithmetic functions,
etc., can be used in the Journal File for simplifying parametric studies.

Parameter names Commands are

begin with $ not case sensitive

Comment lines

1-11 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

GUI
Main Menu bar Operation toolpad

Command line Description window Global Control

1-12 © Fluent Inc. 8/9/02
 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Operation Tool Pads

Vertex Boundary Layer Boundary Types Coordinate Systems

Edge Edge Boundary Entity Sizing Function
Face Face Continuum Types G/Turbo
Volume Volume Continuum Entity User-Defined Tools
Group Group

1-13 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

File Menu (1)

u New, Open, Save, Save As and Exit

l Standard form of database operations
u Print Graphics
l Prints graphics to printer or to file
l PostScript, BMP, TIF, etc.
u Run Journal / Clean Journal
l Screen editor/command processor for journal files
l Command processing:
n Partial or global selection/de-selection

n Automatic or stepwise processing

l Ability to load the current journal

l File browser
l Clean Journal removes unnecessary tags, undo’s, etc.

1-14 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

File Menu (2)

u View File
l View of the current output,ident.trn, the
transcript file
l Ability to view other files as well
u Import
l ACIS, Parasolid -
l IGES, STEP
l ICEM Input, Vertex Data
l CAD - Pro/E, Optegra Visualizer, I-DEAS FTL
l Mesh - mesh and faceted geometry files.
u Export
l ACIS, Parasolid
l IGES, STEP
l Mesh - Export your mesh for your Solver.
n 2D option guarantees 2D mesh

1-15 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Edit Menu (1)

u Edit Title
l Title will be included on any printed graphics
u Edit File
l Ability to launch an editor within GAMBIT
u Edit Parameters
l Ability to define, modify and list parameters
n parameters: $numeric = 10,
n arrays: $array(3,4) = 5
l Parameters and arrays can also be directly defined in
the journal file using an editor (preferred option)

1-16 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Edit Menu (2)

u Edit Defaults
l Modify a large range of defaults that effect:
n User Environment

n Meshing Characteristics

n Geometry

l Ability to load, modify and save a new set of defaults

in $HOME/GAMBIT.ini which is loaded
automatically at startup.
u Undo/Redo
l Ten levels of undo/redo (default)
l Reducing number of levels also reduces memory
requirements.

1-17 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Solver Menu

u The Solver selection will have an impact on the

following input forms:
l Available meshing algorithms
l Available element types
l Continuum types
l Boundary types
l Export mesh file

1-18 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Graphical User Interface

u Command:
l Input of (non-GUI) commands, e.g.,
n reset: deletes all mesh and geometry in the current model

n reset mesh: deletes mesh, keeps geometry

u Description
l Gives a short description of all global function buttons and screen areas
u Transcript
l Output from GAMBIT is printed here as well as in ident.trn
l Transcript window can be expanded using arrow button in top right corner

1-19 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Global Control (1)

Scale-to-Fit Pivot anchor for Four split Light source Undo/Redo

view Four view Special Labels
manipulation Annotate
Orient Model Modify (on/off) Wire frame Color coding Examine Mesh
Journal View Label Shade Entity type
Visibility Hidden Line Connectivity
Rendering
Show mesh
Silhouette

1-20 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Global Control (2)

u Scale-to-fit resizes the model to fit the screen
u Orient Model - major axes , isometric and:
Reverse
Previous
Journal view
u Select Pivot - around which the model rotates, zooms
Body center
Mouse position
u Model display attributes
l Turn on/off visibility, label, silhouette, mesh and hidden line on all or
selected geometrical entities
u Preset configuration of the graphics window
4-view and 4-split
Options to return to any single view
1-21 © Fluent Inc. 8/9/02
 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Global Control (3)

u The Window Attributes form
l Modify the following attributes (defaults given)
n Render Wireframe on ; shaded and hidden off

n Mesh Volume - off

n Silhouette All on
n Label All off
n Visibility All on
l Two ways of picking entities
n “All” - All entities are picked (Default)

n “Pick” - Individual picking including

the use of pick lists

1-22 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Global (4)
u Render Model - Wireframe , Shaded , Hidden
u Modify Light/Label type
Change light source orientation and properties
Additional information on the entity label
Insert arrows and text for graphic presentations
u Color Mode
Color by entity
Color by connectivity
u Undo/Redo

u Examine Mesh
l Display different element types by quality, plane cuts, etc.

1-23 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Forms (1)
u Form - components
l List box - (picking)
n active (yellow) - ready to pick

n inactive (white) - click to activate

l Radio buttons
n mutually exclusive options

l Option button
n Option menu

l Text box
n Click-to-focus

l Check box
n non-mutually exclusive options

l Command buttons

1-24 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Forms (2)
u Text box

l Field for input of data, expressions, parameters

l The cursor is blinking if active
n To activate - left click in the text box (click-to-focus)

l Forms with several text boxes

n The order of input is not important

n Use “tab” to go to the next text box

n Use left click (click-to-focus) to go to any text box

1-25 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Forms (3)
u List box
l Highlighted in yellow if active
n To activate - left click in the list box

l Tells you the name of the latest picked item

n The item is highlighted in red on the screen

n All previously picked items are pink

l Individual pick lists for each list box

l Forms with several list boxes:
n Depending on the form, the order of picking may be important

n Use Shift right-click to go to the next list box

n Use left click (in the list box) to go to any list box

1-26 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Forms (4)
u Pick Lists
l Open the Pick List by clicking on the arrow

l The “Available” list is sorted in the order of picking

l Pick List functionality:
n Pick or Un-pick, Selected or All entities by highlight

in left column and by clicking on the arrows

n Highlighted “picked” entities will appear red on the

screen
s edge.32, edge.33
n Non-highlighted “picked” entities will appear pink
s edge.26, edge.28
n Right-click in lists area provides additional options
n Filter can be used to control which objects are picked.

1-27 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Mouse Operations (1)

Left Middle Right
Drag x-y rotation Translation Zoom/ z-rotation
Shift + Pick Next Accept/Next picker
Click
Double Previous View Save view to journal
Click
Ctrl Drag zoom Stretch zoom Click points to grid

You can toggle between picking with or without “Shift”:

Keep right mouse button down while doing a “left-click”
The cursor now changes to another symbol
Now, Pick/Next/Accept do not need a “Shift”
The Rotation/Translation/Zoom now needs a “Shift”

1-28 © Fluent Inc. 8/9/02

 Fluent User Services Center Introductory GAMBIT Notes
GAMBIT v2.0 Jan 2002
www.fluentusers.com

Mouse Operations (2)

u The picking philosophy: Left - Middle - Right
l Shift-Left: initial pick
n Alternative: click and hold, drag diagonally to pick several items at the same

time - “window picking”

n The latest pick is highlighted in red, previously picked items are highlighted

in pink
l Shift-Middle: modify pick
n The middle pick will behave differently depending on the mouse location:

s Same: Cycle to the next available object within picking tolerance

s New: Replace last pick with new pick at new location
s Bad: A Shift-Middle pick on “nothing” is equivalent to
“Un-select last pick”
l Shift-Right: Apply or go to the next list box

1-29 © Fluent Inc. 8/9/02