l-1 introduction to gambit

Fluent User Services Centerwww.fluentusers.com

1-1 2006 Fluent Inc.

Introductory GAMBIT TrainingGAMBIT 2.3 June 2006

Introduction to GAMBIT

1-2


2006 Fluent Inc.


What is GAMBIT?Geometry And Mesh Building Intelligent Toolkit

A single, integrated preprocessor for CFD analysis:z Geometry construction and import using:

ACIS solid modeling capabilities STEP, Parasolid, IGES etc. import (generally requires cleanup)

z Mesh generation for all FLUENT solvers including FIDAP and POLYFLOW Structured and unstructured hexahedral, tetrahedral, pyramid, and prisms.

z Mesh quality examinationz Boundary zone assignmentz Mesh export

1-3


2006 Fluent Inc.


Problem Setup Geometry creation

z GAMBIT modeling toolsz Import from CAD/CAE or previously generated mesh file.z Clean up and/or decompose into meshable sections

Meshingz Local meshing edge, boundary layers and size functionsz Global meshing face and/or volume

Examine mesh quality

Boundary and continuum zone assignment

Export the mesh to FLUENT

1-4


2006 Fluent Inc.


GAMBIT Startup GAMBIT can be launched using the icon (Windows XP/2000 only).

GAMBIT can also be launched from a DOS command prompt or LINUX/UNIX prompt by typing the command

gambit sessionID

Gambit 2.3

Enter or browse for path to the working directory

Enter the session ID or select from previously stored sessions.

Startup options

1-5


2006 Fluent Inc.


GAMBIT Directory and Files When GAMBIT starts up, it creates a directory called GAMBIT.#

z # is a randomly assigned, four-digit process numberz GAMBIT also creates a lock file, sessionID.lok, in the working directoryz sessionID.lok prevents another user from starting up another session using

the same ID in the same directory.z If GAMBIT crashes, this file must be removed manually.

Three files are created inside the GAMBIT.# directory.The GAMBIT database. All geometry and mesh information is savedin this file. The database is often not retrievable after a crash.

sessionID.dbs

The journal file. All user instructions are stored in this file. The journal file is directly accessible from the Run Journal form.

jou

The transcript file. All output from the current GAMBIT session is stored here.

trn

1-6


2006 Fluent Inc.


GAMBIT Directory and Files GAMBIT permanently saves these files to the working directory as sessionID.dbs, sessionID.jou, and sessionID.trn any time you issue the Save command (equivalent to any standard word processor).z The files sessionID.dbs, sessionID.jou, sessionID.trn are overwrittenz New commands are appended to the journal file, sessionID.jou.

Upon successful exit of GAMBIT :z The GAMBIT.# directory is removed.z The lock file, sessionID.lok, is deleted.

1-7


2006 Fluent Inc.


The GAMBIT GUI

DescriptionWindow

Main Menubar

OperationTool Pad

FormsArea

TranscriptWindow

GlobalControl

Command line

1-8


2006 Fluent Inc.


Operation Tool Pad

VertexEdgeFace

VolumeGroup

Boundary LayerEdgeFace

VolumeGroups

Boundary TypesContinuum Types

Coordinate SystemsSize Functions

G/TurboGeometry Cleanup

Plugin Tools

1-9


2006 Fluent Inc.


File Menu New, Open, Save, Save As and Exit Print Graphics

z Prints graphics to printer or to filez PostScript, BMP, TIF, etc.

Run Journal / Clean Journal Journal Utilitiesz Screen editor/command processor for journal filesz Command processing:

Partial or global select/deselect Automatic or stepwise journal file processing

z Ability to load the current journal filez File browserz Clean Journal removes unnecessary entries, error

commands, undo commands, etc. from the journal file. View File Opens a generic file viewer

z View of the current output (the transcript file, ident.trn)z Ability to view other files as well

1-10


2006 Fluent Inc.


File Menu Import

z ACIS, Parasolidz IGES, STEP, Catia V4, Catia V5 (add-on)z ICEM Input, Vertex Dataz CAD

Pro/E (STEP or DIRECT (add-on) Optegra Visualizer I-DEAS FTL

z Mesh - mesh and faceted geometry files. Export

z ACIS, Parasolidz IGES, STEPz Catia V4z Mesh

Export the mesh for your solver. Export 2D mesh option guarantees 2D mesh

1-11


2006 Fluent Inc.


Edit Menu Title

z Title will be included on any printed graphics File Ability to launch an editor within GAMBIT Parameters Ability to define, modify and list parameters Defaults

z Modify a large range of environment variables that affect: User environment Meshing characteristics Geometry manipulation

z Ability to load, modify and save a new set of defaults in $HOME/GAMBIT.ini which is loaded automatically at startup.

Undo/Redoz Ten levels of undo/redo (default)z Reducing number of levels also reduces memory requirements.

1-12


2006 Fluent Inc.


Solver Menu The Solver selection will have an impact on the following input forms:

z Available meshing algorithmsz Available element types z Continuum typesz Boundary typesz Export mesh file

Default solver is FLUENT 5/6

1-13


2006 Fluent Inc.


Graphical User InterfaceTranscript WindowOutput from GAMBIT is printed here as well as in ident.trn. The transcript window can be expanded using the arrow button in the top right corner.

Description WindowGives a short description of all global function buttons and screen areas

Command LineInput of (non-GUI) commands

reset: deletes all mesh and geometryreset mesh: deletes mesh, keeps geometry

1-14


2006 Fluent Inc.


Global Control

Examine Mesh

Color coding by Entity Type or Connectivity

Wireframe, Shaded,

Hidden line

Modify Label, Visibility, Render, Show/Hide mesh,

Silhouette

Display Orientation

Journal View

UndoRedo

Light sourceLabeling

AnnotationFour Split Four View

Pivot anchor control

Scale to Fit

1-15


2006 Fluent Inc.


Global Control Display Attributes Specify Display Attributes form

z Modify the following attributes (defaults given) Render Wireframe Mesh Volume OFF Silhouette All ON Label All OFF Visibility All ON

z Two ways of picking entities All All entities are picked (Default) Pick Individual picking including use of pick lists

1-16


2006 Fluent Inc.


Global Control Render Model

Wireframe

Shaded

Hidden

Modify Light/Label type

Change light source orientation and properties

Additional information on the entity label

Insert arrows and text for graphic presentations

Color Mode

Color by entity

Color by connectivity

Undo/Redo

Examine Mesh

Display different element types by quality, plane cuts, etc.

1-17


2006 Fluent Inc.


Forms

List Box (picking)Active (yellow)Inactive (white)Radio Button

(mutually exclusive)

Option Button(activates a menu)

Text Box(click to activate/edit)

Check Box(non-mutually exclusive)

Command Buttons

1-18


2006 Fluent Inc.


Forms Text box

z Field for input of data, expressions, parametersz Forms with several text boxes

The order of input is not important Use the tab key to go to the next text box Left-Click on any text box to activate.

List boxz The active list box is displayed in yellowz Left-Click to activatez Tells you the name of the most recently picked item

The item is also highlighted in red on the screen All previously picked items are displayed in pink

z Individual pick lists for each list boxz Forms with several list boxes:

Depending on the task, the order of picking may be important Use Shift + Right-Click to go to the next list box

1-19


2006 Fluent Inc.


Forms Pick Lists

z Open the Pick List by clicking on the arrow

z The "Available" list is sorted in the order of pickingz Pick List functionality:

Pick or unpick, Selected or All entities by highlight in left column and by clicking on the arrows

Highlighted "picked" entities will appear red on the screenVedge.32, edge.33

Non-highlighted picked entities will appear pinkVedge.26, edge.28

Right-click in lists area provides additional options Filter can be used to control which objects are

picked.

1-20


2006 Fluent Inc.


Mouse Operations

Click points to gridStretch ZoomDrag zoomCtrl + Click

Save view to journal filePrevious ViewDouble-Click

Accept / Next PickerNextPickShift + Click

Zoom / Z-axis RotationTranslate (pan)x/y Axis RotationDrag

RightMiddleLeftAction

You can toggle between picking with or without using the Shift key: Press and hold the right mouse button and click the left button. The cursor changes to an eye shape. Now, Pick/Next/Accept do not require the Shift key.

The Rotate/Translate/Zoom actions require the Shift key.

1-21


2006 Fluent Inc.


Mouse Operations Selecting Entities Pick a single entity

z Shift + Left-Click on the entity To pick a face or volume, Shift + Left-Click on one of the bounding edges

Pick multiple entitiesz Multiple single-entity picks ORz Click and hold, drag diagonally to pick several items at the same time

Upward diagonal drag will pick everything fully enclosed in the box. Downward diagonal drag will pick anything inside or touching the box.

The most recent pick is highlighted in red Previously picked items are highlighted in pink

Picking One Face Picking Five Faces

This faceis not picked

1-22


2006 Fluent Inc.


Mouse Operations Selecting Entities Shift + Middle-Click = Modify Pick

z The middle mouse button will behave differently depending on the mouse location: Same: Cycle to the next available object within picking tolerance New: Replace last pick with new pick at new location Bad: Shift + Middle-Click on nothing is equivalent to deselect last pick

Shift + Right-Click = Apply or go to the next list box

1-23


2006 Fluent Inc.


GAMBIT Journal Files Executable list of GAMBIT commands

z Created automatically by GAMBIT from both the GUI and TUI.z Can be created and/or edited manually using a text editor.z Journal files are small easy to transfer, e-mail, etc.

Uses:z Can be parameterized, comments can be addedz Easy recovery from a power loss or crashz Edit existing commands to create new ones

1-24


2006 Fluent Inc.


Running GAMBIT Journal Files Journal files can be processed in two

ways:z Batch mode (Run)

All commands processed without interruption.

"read pause" command will force interrupt with resume option appearing.

z Interactive mode (Edit/Run) Includes text editor for easy

modificationVMark lines in process field

to activate for processing.VEditable text field.VRight click text field

for more options.VAuto or Step through

activated process lines.

File Run Journal


1-25 2006 Fluent Inc.


Appendix

1-26


2006 Fluent Inc.


Global Control Scale-to-fit zoom in/out to fill the screen

Orient Model major axes , isometric and:z Reversez Previousz Journal view

Select pivot point around which the model rotates, zooms z Body centerz Mouse position

Model display attributesz Turn on/off visibility, label, silhouette, mesh and hidden line on all or

selected geometric entities Preset configuration of the graphics window

z 4-view and 4-splitz Options to return to any single view

Introduction to GAMBITWhat is GAMBIT?Problem SetupGAMBIT StartupGAMBIT Directory and FilesGAMBIT Directory and FilesThe GAMBIT GUIOperation Tool PadFile MenuFile MenuEdit MenuSolver MenuGraphical User InterfaceGlobal ControlGlobal Control Display AttributesGlobal ControlFormsFormsFormsMouse OperationsMouse Operations Selecting EntitiesMouse Operations Selecting EntitiesGAMBIT Journal FilesRunning GAMBIT Journal FilesAppendixGlobal Control

l-1 introduction to gambit

Documents

gambit startup gambit

gambit directory

files gambit

gambit database

gambit crashes

current gambit session

successful exit of gambit

fluent solvers