Fluent Inc. Logo return to home
next previous contents index

4. GAMBIT MENU COMMANDS

The GAMBIT main menu bar includes the following menu commands.

Menu Item Purposes
File
  • Create, open and save sessions
  • Print graphics
  • Edit and/or run journal files
  • Clean up journal files
  • View transcript files
  • Import and export geometry, mesh, CAD, and turbo data
  • Reconnect CAD components with their models
  • Exit the program
Edit
  • Edit session titles
  • Edit text files
  • Create and edit parameters
  • Edit program defaults
Solver
  • Specify a solver
Help
  • Access online help documents

The following sections of this chapter describe the functions and uses of commands available for each of main menu items listed above.

NOTE: Most of the specification forms described in the following sections include Accept and Close command buttons. Unless otherwise noted, the functions of the two buttons are as follows:
  • Accept—executes the operation associated with the form.
  • Close—closes the form without executing the associated operation.


4.1 File Commands

The GAMBIT File command menu includes the following commands.

Command Description
New Creates a new session
Open Opens a previously saved session
Save Saves the current session
Save As Saves the current session under a new name
Print Graphics Prints currently displayed graphics
Run Journal Displays and allows you to edit and/or execute the commands in any journal file
Clean Journal Removes extraneous commands, messages, and signals from a GAMBIT journal file
View File Displays the current transcript file
Import Imports geometry and mesh data; turbo, and plug-in files
Export Exports geometry and mesh data
Reconnect CAD Reconnects CAD components with their models
Exit Stops program execution

4.1.1 New

When you select New from the File command menu, GAMBIT opens the Create New Session form. The Create New Session operation (identifier command) allows you to create and name a new GAMBIT session. To create the session, you must specify the following items:

In addition to the two mandatory specifications listed above, GAMBIT also allows you to specify a title for the session.

The session identifier constitutes the root name for GAMBIT data files associated with the new session. (For a description of GAMBIT data file contents and organization, see Chapter 2 of this guide.) The save option determines whether or not GAMBIT saves existing session data before creating a new session. The session title constitutes a general descriptor for the session.

Specifying the Session Identifier

The session identifier can consist of any combination of alphanumeric characters and/or symbols that constitutes a valid file name in the operating system under which GAMBIT is running. The GAMBIT default session identifier is "model1."

Specifying the Save Option

When you create a new session, GAMBIT deletes any data associated with the current session. To save the current session data when you create a new session, select the Save current session option on the Create New Session form.

Specifying the Session Title

The session title constitutes a general descriptor for the session. It may consist of any combination of alphanumeric characters and/or symbols up to 80 characters in length.

Using the Create New Session Form

The Create New Session form (see below) allows you to create and name a new GAMBIT session. To open the Create New Session form, select New from the File menu on the main menu bar.

The Create New Session form includes the following specifications.

ID: specifies the identifier for the new session.
Title: specifies a session title up to 80 characters in length.
Save current session specifies that any current session data is saved when the new session is created. GAMBIT uses the current session identifier as the root file name for the files containing the current session data.


4.1.2 Open

When you select Open from the File command menu, GAMBIT opens the Open Existing Session form. The Open Existing Session operation (identifier command) allows you to open a previously saved session. To open the session, you must specify the following information:

The session identifier constitutes the root name of the data files for the session to be opened. (For a description of GAMBIT data file contents and organization, see Chapter 2 of this guide.) The save option determines whether or not GAMBIT saves current session data before opening a new session.

Specifying the Session Identifier

To open an existing session, you must specify the identifier of the session to be opened. The session identifier constitutes the root name of all files associated with the session.

You can specify the session identifier in one of two ways:

The ID text box allows you to directly specify the identifier of the session to be opened. The Browse command button allows you to browse file directories and to select the session to be opened from a list of existing files.

Using the ID Text Box

When you specify an identifier in the ID text box and click Accept, GAMBIT searches the current directory for a database (dbs) file the root name of which matches the specified identifier. If the database file corresponding to the session to be opened exists in a directory other than the current directory, you must also include the directory specification in the input text.

If you include a file extension when you specify the identifier, GAMBIT searches for a file matching the exact name specified in the ID text box. If you do not include a file extension when you specify the identifier, GAMBIT searches for a file with a root name matching the session identifier and a database file extension (dbs). For example, if you specify the identifier "example" in the ID text box, GAMBIT searches for a database file named example.dbs.

Using the Browse Command Button

When you click the Browse command button, GAMBIT opens the Select File form. The Select File form allows you to browse file directories in search of existing files. (For instructions concerning the use of the Select File form, see "Using the Select File Form," below.)

To specify the identifier of an existing GAMBIT session by means of the Select File form, you must search for and select a database (dbs) file the root name of which constitutes the identifier of the session to be opened. For example, to specify an existing session with the identifier, "wing005," you must search for and select a file named wing005.dbs.

Specifying the Save Option

When you open an existing session, GAMBIT deletes any data associated with the current session. To save the current session data when you open an existing session, select the Save current session option on the Open Existing Session form.

Using the Open Existing Session Form

The Open Existing Session form (see below) allows you to open a previously saved session. To open the Open Existing Session form, select Open from the File menu on the main menu bar.

The Open Existing Session form includes the following specifications.

ID: specifies the identifier of the session to be opened.
Browse… opens the Select File form (see "Using the Select File Form," below), which allows you to browse directories and file lists and to select a file name from the lists.
Save current session specifies that any current session data is saved when the existing session is opened. GAMBIT uses the current session identifier as the root file name for the files containing the current session data.

Using the Select File Form

The Select File form (see below) allows you to browse directories and to select a file from a list of currently available files. To open the Select File form, click the Browse command button on any file-related GAMBIT form.

The Select File form includes the following specifications.

Filter specifies the current file filter. The file filter specification de­ter­mines which files appear in the Files list (see below). It must include both a directory name and a file specification. The file specification can include the wildcard character, *, and can also include a file extension. If you do not include a file exten­sion in the specification, GAMBIT lists all files meet­ing the file root-name specification. The default file specifi­cation is a single wildcard character, *, which lists all files in the direc­tory).

Changing the Filter Directory Specification

There are three ways to change the filter directory specification.

  • Input the new directory name in the Filter text box and press Enter or click the Filter command button.
  • Double-click a directory name in the Directories list.
  • Highlight a directory name in the Directories list and click the Filter command button at the bottom of the form.
Changing the Filter File Specification

To change the filter file specification, input the new specification in the Filter text box and either press Enter or click the Filter command button at the bottom of the Select File form.

Directories lists all directories and subdirectories associated with the directory specified in the Filter text box. The topmost directory listed in the Directories list represents the current filter directory.
Files lists all files that match the current filter specifications.
Selection specifies the file to be selected by means of the Select File form. To change the selected file, either input the new file name in the Selection text box or highlight the name of the file in the Files list.
Accept accepts the current file selection and closes the Select File form. You can also select a file and close the form by double-clicking the file name in the Files list.
Filter changes the filter directory specification to the currently highlighted directory in the Directories list or updates the directories or files list to reflect changes made to the Filter specification.
Cancel closes the Select File form without accepting a file for selection.


4.1.3 Save

When you select Save from the File command menu (or use the save command-line command) , GAMBIT saves the current session data to three data files the root name of which constitutes the current session identifier. (For a description of GAMBIT data file contents and organization, see Chapter 2 of this guide.)

The saved data includes the following items:


4.1.4 Save As

When you select Save As from the File command menu, GAMBIT opens the Save Session As form. The Save Session As operation (save command) allows you to save the current model data using a specified identifier.

To save session data by means of the Save Session As form, you must specify an identifier that serves as the root name for the session database files. (For a description of the session identifier specifications, see "Specifying the Session Identifier," in Section 4.1.1, above.) If you specify an identifier that corresponds to an existing session, GAMBIT prompts you to acknowledge that the existing session data is to be overwritten by the current data.

Using the Save Session As Form

The Save Session As form (see below) allows you to save the current model data using a specified session identifier. To open the Save Session As form, select Save As from the File command menu on the main menu bar.

The Save Session As form includes the following specifications.

ID: specifies the identifier under which the current data is to be saved.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)


4.1.5 Print Graphics

When you select Print Graphics from the File command menu, GAMBIT opens the Print Graphics form. The Print Graphics operations (hardcopy command) allow you to print the model as currently displayed in the graphics window. You can print the graphics either to a printer or to a file.

Printing Graphics to a Printer

To print graphics to a printer, you must specify the following information:

When you open the Print Graphics form, GAMBIT displays the current default settings for the Printer Name, Printer Options, and Printer Command specifications. The default settings are specific to the hardware configuration, operating system, and/or networking capabilities of the computer system upon which GAMBIT resides. To change any of the default settings, open the Edit Defaults form and modify the printer settings on the GLOBAL default definition subform (see Section 4.2.4, below.)

On UNIX systems, the Printer Command field includes three variables—%p, %o, and %f—that represent, respectively, the Printer Name, Printer Options, and default file name to be used when printing graphics to the printer. For example, if you specify the following parameters on the Print Graphics form:

Input Field Value
Printer Name orkin
Printer Options -opostscript
Printer Command lp -d%p %o %f

and click Accept, GAMBIT executes the command

lp -d orkin -opostscript .tmphardcopy.ps
where .tmphardcopy.ps? is the standard default PostScript file name for the Print Graphics operation.

Printing Graphics to a File

To print graphics to a file, you must specify the following information:

Specifying a File Format

GAMBIT allows you to specify any one of the following formats for the graphics output file:

Specifying a File Name

There are two ways to specify the file name for the graphics file.

The graphics file name can consist of any combination of alphanumeric characters and/or symbols that constitutes a valid file name in the operating system under which GAMBIT is running. For a description of how to use the Select File form, see "Using the Select File Form," in Section 4.1.2, above.

Using the Print Graphics Form

The Print Graphics form (see below) allows you to print graphics either to a printer or to a file. To open the Print Graphics form, select Print Graphics from the File command menu on the main menu bar.

The Print Graphics form includes the following options.

Destination:
Printer specifies printing graphics to a printer.
File specifies printing graphics to a file.

Printing Graphics to a Printer

When you select the Printer option on the Print Graphics form, the middle section of the form appears as shown above. It includes the following specifications.

Printer Name: specifies the name of the printer to which the graphics are printed.
Printer Options: specifies system-specific options for the printer.
Printer Command: specifies the system commands required to print the graphics to the printer. (NOTE: The parameters %p, %o, and %f represent the printer name and options and the name of the file to be printed, respectively.)

Printing Graphics to a File

When you select the File option on the Print Graphics form, the middle section of the form appears as shown below.

The Print Graphics form File options are as follows.

File Format:
SGI RGB
PS
EPS
TIFF
BMP
TARGA
PICT
specifies the format for the graphics file (see above).
File Name: specifies the name of the file to which the graphics output is saved.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)


4.1.6 Run Journal

When you select Run Journal from the File command menu, GAMBIT opens the Run Journal form. The Run Journal form allows you to execute the commands contained in a journal file.

Overview

Journal files are text files that contain GAMBIT program commands. During any GAMBIT session, GAMBIT maintains a temporary journal file that contains all commands executed during the session. When you save a session, GAMBIT copies the temporary journal file to a permanent file. The root name of the permanent journal file is the session identifier, and its extension is "jou." For example, if you save a session with the identifier "model2," GAMBIT copies the journal file to a file named "model2.jou."

NOTE: Journal files can include comment lines as well as commands. Any line in a journal file that begins with a forward slash (/) is interpreted as a comment line rather than as a command line.

The Run Journal form allows you to run journal files, including: the current (temporary) journal file, journal files saved from previous sessions, and journal files that have been created external to the GAMBIT program by means of a text editor. When you run a journal file, GAMBIT executes the file commands as if they were entered sequentially by means of the Command line.

NOTE (1): Journal files can include IF blocks and DO loops to perform conditional operations. For a description of the syntax associated with GAMBIT IF blocks and DO loops, see Appendix A of this guide.
NOTE (2): Due to numerical processing differences between various computer platforms, complex GAMBIT journal files sometimes (though rarely) produce erroneous results when run on platforms other than those on which they were created.

Journal File Run Modes

GAMBIT provides two journal-file run modes:

Run Mode

When you execute a journal file in the Run mode, GAMBIT automatically exe­cutes all of the journal file commands in sequence, beginning at the top of the file. During the automatic execution of the journal file, GAMBIT displays a Pause com­mand button at the right side of the Command text box. If you click the Pause button, GAMBIT suspends the command execution (following execution of the current command) and changes the button title from Pause to Resume. To resume execution of the journal file commands, click Resume.

NOTE: If GAMBIT encounters a "read pause" command in a journal file, command execution is suspended as if the Pause button had been clicked, and the button title is changed to Resume.

If you pause the execution of a journal file, you can execute commands from the Command line or GUI or open and run other journal files before resuming its execution. GAMBIT maintains a stack of open journal files and executes them on a last-in/first-out basis.

Edit/Run Mode

When you run a journal file in the Edit/Run mode, GAMBIT opens the Edit/Run Journal form. The Edit/Run Journal form allows you to edit and run the entire journal file or specified portions of it. For a description of the procedures and specifications required to use the Edit/Run Journal form, see "Using the Edit/Run Journal Form," below.

Using the Run Journal Form

The Run Journal form (see below) allows you to run an existing journal file. To open the Run Journal form, select Run Journal from the File menu on the main menu bar.

The Run Journal form includes the following specifications.

Mode: specifies the journal run mode (see "Journal File Run Modes," above). GAMBIT provides two run modes:
  • Run—automatic mode
  • Edit/Run—semiautomatic mode
File Name: specifies the name of the journal file.
Current Journal loads the name of the current, temporary journal file into the File Name text box.
End previous journal run closes any open journal files that are currently paused. (NOTE: GAMBIT displays this option only if you open the Run Journal form while another journal file execution is paused.)
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Using the Edit/Run Journal Form

The Edit/Run Journal form (see below) allows you to edit and/or execute any or all of the commands in a journal file. It consists of a text editor and an input field consisting of a text box and several command buttons.

To open the Edit/Run Journal form, select Run Journal from the File menu on the main menu bar, then select the Edit/Run option on the Run Journal form, specify a journal file name, and click Accept.

You can use either of two commands (pushbuttons) available in the input field to execute selected (highlighted) commands in the Edit/Run Journal file text editor. The available commands are:

During the automatic command execution, the Auto pushbutton label changes to Stop. If you click the Stop pushbutton, GAMBIT suspends the command execution and restores the pushbutton title to Auto.

Using the Text Editor

When you load a file into the Edit/Run Journal form, the file appears in the text editor window. The text editor window allows you to modify, add, and/or delete lines of text. The following table summarizes the operations you can perform using the Edit/Run Journal form text editor.

Operation Instruction(s)
Select text Left-click the beginning of the text block and left-drag the mouse to the end of the text block. To select multiple lines of text, either left-drag the mouse across all lines to be highlighted, or left-click the beginning of the text block and Shift-left-click the end of the text block.
Modify text Select the text to be modified, and input the new text from the keyboard.
Insert text Locate the cursor at the text insertion point, and input text from the keyboard.
Delete text Select the text to be deleted, and press Delete or Backspace.
Insert a line Locate the cursor at the end of the line prior to the insertion point, and press Enter.
Delete a line Select all text on the line to be deleted and press Delete or Backspace, then locate the cursor on the empty line, and press Backspace.

In addition to the operations described above, the Edit/Run Journal form text editor allows you to search for and replace blocks of text (see "Using the Hidden Menu," below.)

Working with Command Lines and Marker Fields

Each line of text in a journal file constitutes all or part of a GAMBIT command. When you select the Run mode option on the Run Journal form, GAMBIT automatically executes each command in sequence, beginning at the top of the file. By contrast, the Edit/Run Journal form allows you to select and execute individual command lines or groups of command lines.

The Edit/Run Journal form text editor includes a marker field (identified by a right-pointing arrowhead, ">") located immediately to the left of each line of text. The marker field identifies which lines of text are to be exe­cuted when you click either the Auto or Step command button at the bot­tom of the form. Only those lines corresponding to selected (high­lighted) marker fields are executed.

The procedures for selecting single lines and groups of lines are as follows.

By default, GAMBIT executes the journal file commands beginning at the topmost selected line; however, it is possible specify a different starting point for command execution. To specify a starting point, Ctrl-left-click the marker field corresponding to the desired starting point. GAMBIT identifies the specified starting point line by displaying a "*" sign in its marker field (that is, "*>"). To unselect the currently specified starting point, Ctrl-left-click its marker field or Ctrl-left-click a different marker field to designate it as the new starting point.

NOTE: When you execute a group of selected commands by means of the Auto or Step operations, GAMBIT marks the last line in the group by displaying an "L" in its marker field (that is, "L>). The "L>" marker allows you to keep track of which journal-file command was executed last.

Using the Hidden Menu

In addition to the options described above, GAMBIT allows you to perform global selection and unselection operations by means of a hidden menu. To open the hidden menu, right-click anywhere in the text editor window.

The hidden menu includes the following options:

Option Description
Select All Selects all lines in the journal file
Unselect All Unselects all selected lines in the journal file
Toggle All Selects all unselected lines; unselects all selected lines
Reset Pointer Resets the journal file starting point to the topmost selected line
Replace Opens the Search and Replace form

The first four options perform functions related to specifying the sequence in which journal file commands are executed. The Replace option allows you to search for and replace blocks of text by means of the Search and Replace form. For instructions concerning the operation of the Search and Replace form, see "Using the Search and Replace Form," below.

Using the Input Field

The input field located at the bottom of the Edit/Run Journal form includes the following commands and specifications.

File Name: specifies the name of the file to be loaded or saved by means of the Load and Save command buttons (see below).
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Auto begins automatic sequential execution of all selected (high­lighted) command lines, starting at the topmost selected line or other specified starting point. During execution, GAMBIT displays the word, "Now" in the marker field of the command line currently being executed. (NOTE: During the automatic command execution, the pushbutton label changes from Auto to Stop. If you click Stop, GAMBIT suspends the command execution and restores the pushbutton title to Auto.)
Step executes the next selected command line.
Load loads the file specified in the File Name text box into the Edit/Run Journal form text editor.
Save saves the file as currently displayed in the text editor to the file name specified in the File Name text box.
Close closes the Edit/Run Journal form.

Using the Search and Replace Form

The Search and Replace form (see below) allows you to search for and replace blocks of text in the currently-displayed journal file. To open the Search and Replace form, select Replace from the Edit Journal File form hidden menu (see above).

The Search and Replace form includes the following specifications.

Find What: specifies the text search string.
Replace With: specifies the replacement text string.
Options:
Match Case restricts the search to only those blocks of text matching the text search string with respect to both character-type and case.
Use Pattern Matching allows you to use the wildcard character, "*", to search for all instances of a word containing a specified combination of letters or symbols. For example, if you specify "fr*" in the Find What text box and select the Use Pattern Matching option, GAMBIT searches the text file for all words beginning with "fr." If you do not select the Use Pattern Matching option, GAMBIT interprets the Find What text string literally and searches for all words containing "fr*."
Replace searches for all occurrences of the text search string in the currently-displayed text file and replaces them with the text replacement string.


4.1.7 Clean Journal

When you select Clean Journal from the File command menu, GAMBIT opens the Clean Journal form. The Clean Journal form allows you to remove extraneous commands and messages from a journal file. (NOTE: For a description of GAMBIT journal files and their use, see Section 4.1.6, above.) The removal operations can be grouped into two general categories:

The following subsections describe both types of operations.

Automatic Removal Operations

The Clean Journal operation automatically removes the following types of commands and messages from the journal file:

The following sections describe the manner in which the Clean Journal operation removes the types of commands and messages listed above.

Commands Associated with Undo Operations

When you clean up a journal file by means of the Clean Journal operation, GAMBIT removes from the journal file all commands associated with undo operations. GAMBIT undo operations can involve two types of commands:

An undo command undoes the most recently executed GAMBIT operation. Undo-group commands allow you to specify a sequence of one or more GAMBIT commands that can be undone by means of a single undo command.

The following subsections describe these two types of commands with respect to their handling by the Clean Journal operation.

Undo Commands

A GAMBIT undo command undoes the most recently executed operation. When you clean up a journal file that includes undo commands, GAMBIT removes the undo commands themselves as well as the commands that are undone by their execution. For example, if the specified journal file contains the following sequence of commands:

volume create brick width 5.3
volume create sphere radius 4
undo
the Clean Journal operation removes the second and third command lines so that the resulting journal file contains only the following command:
volume create brick width 5.3
Undo-Group Commands

GAMBIT undo-group commands allow you to specify a sequence of commands that can be undone by the execution of a single undo command. The undo-group commands include the following two commands:

To specify a sequence of commands that can be undone by a single undo command, you must precede the sequence with the undo begingroup command and follow the sequence with the undo endgroup command. For example, if you execute the following the sequence of commands:
undo begingroup
volume create frustum height 10 radius 5
volume create brick width 3
undo endgroup
undo
GAMBIT creates a cylinder and a brick, then undoes both operations.

NOTE: The undo begingroup and undo endgroup commands can be explicitly executed only from the GAMBIT Command line. Some GUI operations (for example, the Copy operation) result in the automatic creation of undo begingroup and undo endgroup commands in the active journal file, but the commands themselves are not directly available by means of the GUI.

To explicitly specify a sequence of GUI operations as part of an undo group:

  1. Enter undo begingroup on the Command line.
  2. Execute the sequence of operations to be included in the undo group-either by means of Command line commands or by means of the GUI.
  3. Enter undo endgroup from the Command line.

If a journal file contains a sequence of commands that is preceded by an undo begingroup command and followed by both an undo endgroup command and an undo command, the Clean Journal operation removes the entire command sequence, including the undo command and the undo-group commands that bracket the sequence. For example, if a journal file contains the following sequence of five commands:

undo begingroup
volume create brick width 5.3
volume create sphere radius 4
undo endgroup
undo
the Clean Journal operation removes all five commands from the file.

Error Messages

If you attempt to perform a procedure that violates GAMBIT operation or syntax rules, GAMBIT displays an error message in the Transcript window and records the error event in the active journal file. In the journal file, all such event records begin with the character sequence "/ERR". When you clean up a journal file by means of the Clean Journal operation, GAMBIT removes from the journal file all lines that begin with the characters "/ERR".

Signals

Signals are system-generated reports of exceptional system-level events such as program errors (for example, division by zero) or user requests to terminate the current process. In the journal file, all such reports are recorded as a single line in the file beginning with the character sequence "/SIG". When you clean up a journal file by means of the Clean Journal operation, GAMBIT removes from the journal file all lines that begin with the characters "/SIG".

Optional Removal Operations

In addition to the automatically-removed commands and messages listed above, the Clean Journal form provides options that allow you to remove the following types of entries from the journal file:

Comments

The Remove comments option removes all comment lines contained in the journal file.

Errored Commands

The Remove errored commands option removes from the journal file all commands that produced error messages and were not executed during the program run that produced the journal file to be cleaned.

Save Commands

The Remove save commands option removes all save commands from the journal file. For a description of the GAMBIT save command, see Section 6.3.7 of the GAMBIT Command Reference Guide.

Parameter Commands

The Remove parameter commands option removes from the journal file all commands that define or declare GAMBIT parameters.

Using the Clean Journal Form

The Clean Journal form (see below) allows you to clean up an existing journal file. To open the Clean Journal form, select Clean Journal from the File menu on the main menu bar.

The Clean Journal form includes the following specifications.

File to Process: specifies the name of the journal file to be processed in the cleaning operation.
Current Journal specifies the name of the current, temporary journal file as the file to be processed in the cleaning operation.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
New File Name: specifies the name of the cleaned file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Remove comments removes comments from the journal file.
Remove errored commands removes from the journal file any commands that produced errors during program execution.
Remove save commands removes save commands from the cleaned journal file.
Remove parameter commands removes from the journal file any commands that are related to parameter definition or declaration.


4.1.8 View File

When you select View File from the File command menu, GAMBIT opens the View File form. The View File form allows you to view any text file and to copy information from the text file to the GAMBIT Command line or to any open window.

When you first open the View File form, GAMBIT automatically loads the current transcript (trn) file. The transcript file contains information identical to that displayed in the Transcript window.

To copy information from a text file displayed in the View File form to the Command line or an open window, you must perform the following operations:

Using the View File Form

The View File form (see below) allows you to view and, optionally, highlight information in any text file. To open the View File form, select View File from the File menu on the main menu bar.

The View File form includes the following specifications.

File Name specifies the name of the file to be loaded into the View File form.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form," in Section 4.1.2.)
Load loads the text file specified in the File Name text box into the View File form.


4.1.9 Import

The Import operation (import command) allows you to import geometry and mesh information using programs other than GAMBIT. The command operates by means of Import forms, the layouts of which differ according to import operation type.

When you select Import from the File command menu, GAMBIT opens a submenu of allowable data types. The submenu includes the following types:

ACIS, Parasolid, IGES, STEP, Catia V4, and CAD files describe model geometry. ACIS and Parasolid files are associated with the ACIS and Parasolid geometric modelers, respectively. IGES and STEP are industry standard specifications. CAD files contain geometry (or faceted representations of geometry) generated by CAD programs. Turbo files contain data that describe turbomachinery configurations. Plug-in files can be used to create customized GAMBIT modeling operations.

ICEM Input and Vertex Data information consists of points that can be used to describe geometric surfaces. Mesh files include information concerning numbers and coordinates of mesh nodes, element connectivity, and groupings of the exterior sides of the mesh elements that define geometric boundaries to which boundary types, such as INFLOW or WALL, can be attached (see "Importing Mesh Files," below).

NOTE (1): GAMBIT does not support all IGES entities.
NOTE (2): The Import/CAD option allows you to either import CAD geometry by means of a data file or import geometry directly from the Pro/ENGINEER software package (a feature that requires a special GAMBIT license).
NOTE (3): When you import ACIS, IGES, STEP, Parasolid, or Catia geo­metry, you can also import any label, level, and/or color attributes associated with the geometry (and preserved in the data file). When importing ACIS geometry that contains level data, all entities belonging to a given level are assigned to a GAMBIT group, and the group is assigned the name of the ACIS level. GAMBIT assigns any imported color attributes to the shade color, rather than geometry color, for the associated entity.

The option to import label, level, and/or color attributes is controlled by means of three GAMBIT default variables:

  • FILE_IO.TRANSLATOR.IMPORT_LABELS
  • FILE_IO.TRANSLATOR.IMPORT_LEVELS
  • FILE_IO.TRANSLATOR.IMPORT_COLORS
Each variable can take on one of two values:
  • 0—Do not import the attribute.
  • 1—Import the attribute.
By default, GAMBIT does not import labels, levels, or colors when import­ing geometry—that is, all three default variables are initially set to 0.
NOTE (4): Microsoft Windows operating systems reserve certain letter com­binations to use as device names. If you attempt to import a file the name of which constitutes one of the reserved letter combinations, the import operation will experience problems and possibly fail. It is advisable, therefore, to avoid using the reserved letter combinations when specifying file names for GAMBIT import operations.

The reserved letter combinations (which are not case-sensitive) include: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9. Such letter combinations should not be used as GAMBIT import file names regardless of the file extension. For example, GAMBIT import operations might experience problems when attempting to import files named COM8, PRN.stp, or nul.igs.

Importing ACIS Files

To import an ACIS file, you must specify the following information:

The File Name specifies the ACIS file that contains the geometry information to be imported. The Import Options specify the format for the imported data and control the import operations for models that are geometrically imprecise.

Specifying the Import Options

GAMBIT provides three Import Options for importing ACIS files:

Specifying the Format Option

The Format option specifies the form of the data (ASCII or binary) for the ACIS file to be imported.

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT will attempt to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

When you select the Make Tolerant option, GAMBIT automatically detects and removes short edges and sliver faces during the geometry import operation. (NOTE: A "sliver" face is defined as a face with multiple boundary edges that possesses a region narrower than a specified distance.)

You can control the short-edge and sliver-face detection and removal operations by means of two default variables:

To specify that short edges and sliver faces are not removed during import, set each of these default variables to zero (0).

Using the Import ACIS File Form

The Import ACIS File form (see below) allows you to import geometry from ACIS files. To open the Import ACIS File form, select Import from the File menu on the main menu bar, and select ACIS from the Import submenu.

The Import ACIS File form includes the following specifications.

File Name: specifies the name of the ACIS file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options:
Format: specifies the data format for the imported data. The available data formats include:
  • ASCII
  • Binary
Heal Geometry attempts to heal geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Importing Parasolid Files

To import a Parasolid file, you must specify the following information:

Specifying the File Name

The file name specifies the Parasolid file that contains the information to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Specifying the Import Options

The Import Options allow you to customize the procedure by which the Parasolid file data are translated to become GAMBIT geometry. The Import Options are as follows:

Specifying the Model Scale Factor

The Model Scale Factor specification allows you to apply a constant scale factor to all dimensions in the imported geometry. Its default value is equal to unity (1.0).

Specifying the Stand-alone Geometry Options

The Stand-alone Geometry options allow you to specify whether or not to retain or delete imported vertices, edges, and/or faces that are not connected to higher topology entities. There are three Stand-alone Geometry options:

NOTE: The No stand-alone faces option is available because GAMBIT is capable of importing Parasolid volumes. In practice, however, the option is rarely used.

If you select the No stand-alone option for any geometry type, GAMBIT deletes all imported entities of that type that are not connected to higher topological entities. For example, if you select the No stand-alone edges option, GAMBIT deletes all edges that are not connected to faces. If you do not select the No stand-alone option for a geometry type, GAMBIT includes stand-alone entities of that type in the imported geometry.

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT will attempt to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 of the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Using the Import Parasolid File Form

The Import Parasolid File form (see below) allows you to import geometry from Parasolid files. To open the Import Parasolid File form, select Import from the File menu on the main menu bar, and select Parasolid from the Import submenu.

The Import Parasolid File form includes the following specifications.

File Name: specifies the name of the Parasolid file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options:
Model Scale Factor specifies a scaling factor for imported model geometry.
Stand-alone Geometry specifies whether or not to retain or delete imported topological entities that are not connected to higher entities.
No stand-alone vertices deletes vertices that are not connected to any edges.
No stand-alone edges deletes edges that are not connected to any faces.
No stand-alone faces deletes faces that are not connected to any volumes.
Heal Geometry attempts to heal model geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Importing IGES Files

To import an IGES file, you must specify the following information:

Specifying the File Name

The file name specifies the name of the IGES file from which geometry is to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

When you specify the name of an existing IGES file in the File Name text box, GAMBIT displays file summary information in the middle section of the Import IGES File form. The summary information represents information available in the global section of the IGES file and includes the following items:

Item Description
Product ID Name of the software used to create the IGES file
System ID Name of the system upon which the IGES file is created
Model Space Scale Ratio of model space to real space
Date Date of IGES file creation/modification
Time Time of IGES file creation/modification
Distance Tolerance Shortest distance in model space that the IGES file generating system considered coincident
Maximum Coordinate The maximum coordinate in the IGES file
Units Units of distance used in the file.

Specifying the Import Options

The Import Options allow you to customize the procedure by which the IGES file data is translated to become GAMBIT geometry. The Import Options are as follows:

Specifying the Translator

The Translator options allow you to specify which translator to use when importing IGES files into GAMBIT. The Translator options are as follows:

The Native option specifies the use of an IGES translator specifically designed for use with GAMBIT. The Native translator is capable of producing virtual geometry in the course of the data import process.

The Spatial option specifies the use of a generic translator developed by Spatial Technology, Inc.. The Spatial translator produces only real geometry.

Specifying the Model Scale Factor

The Model Scale Factor specification allows you to apply a constant scale factor to all dimensions in the imported geometry. Its default value is equal to the reciprocal of the Model Space Scale (see above).

NOTE: GAMBIT geometry operations may fail if the model dimensions are too large or too small relative to the GAMBIT global tolerance value. The GAMBIT global tolerance value is 10-6. To insure that GAMBIT geometry operations correctly handle imported IGES geometry, specify a Model Space Scale factor that enlarges or reduces the imported geometry such that its coordinate values are in the range of 10-5 to 104.

Often, the system that generates the IGES file incorrectly reports the maximum coordinate value. It is important, therefore, to read and verify geometry values before applying the Model Space Scale factor.

Specifying the Stand-alone Geometry

The Stand-alone Geometry options allow you to specify whether or not to retain or delete imported vertices, edges, and/or faces that are not connected to higher topology entities. There are three Stand-alone Geometry options:

NOTE: The No stand-alone faces option is available because GAMBIT is capable of importing IGES volumes. In practice, however, the option is rarely used.

If you select the No stand-alone option for any geometry type, GAMBIT deletes all imported entities of that type that are not connected to higher topological entities. For example, if you select the No stand-alone edges option, GAMBIT deletes all edges that are not connected to faces. If you do not select the No stand-alone option for a geometry type, GAMBIT includes stand-alone entities of that type in the imported geometry.

Specifying the Import Source

The Import Source options allow you to specify the program used to generate the IGES file that contains the data to be imported. The Import Source options are as follows:

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT attempts to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 of the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Specifying the Virtual Cleanup Specifications

When you select the Virtual Cleanup option, GAMBIT automatically cleans up geometry as it is imported. Such cleanup operations include connecting disconnected vertices and edges and merging very-short edges with longer adjacent edges in order to facilitate meshing.

NOTE: You can use the Virtual Cleanup option on the Import IGES File form to automatically cleanup geometry that has already been imported into GAMBIT. To do so:
  1. Open the Import IGES File form.
  2. Select the Virtual Cleanupoption and input appropriate values for the Connect Tolerance and Merge Tolerance specifications (see below).
  3. Ensure that the File Name text field is blank.
  4. Click Apply.

The Virtual Cleanup option includes two main specifications:

The Connect Tolerance specifies the maximum allowable distance between geometric entities to be connected (see Section 2.3.2 of the GAMBIT Modeling Guide). You can specify the tolerance either in terms of absolute distance (Value) or as a percentage of the length of the shortest edge in the model (Shortest Edge %).

The Merge Tolerance specifies the maximum length of any edge to be considered as a candidate for merging in the cleanup process (see Section 2.3.5 of the GAMBIT Modeling guide).

Using the Import IGES File Form

The Import IGES File form (see below) allows you to import geometry from IGES files. To open the Import IGES File form, select Import from the File menu on the main menu bar, and select IGES from the Import submenu.

The Import IGES File form includes the following specifications.

File Name: specifies the name of the IGES file containing the geometry to be imported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Summary: contains a summary of IGES global file information (see above).
Import Options:
Translator specifies the translator used in the import process.
Native specifies an IGES translator specifically designed for use with GAMBIT
Spatial specifies an IGES translator designed by Spatial Technology, Inc.
Model Scale Factor specifies a scaling factor for imported model geometry.
Stand-alone Geometry specifies whether or not to retain or delete imported topological entities that are not connected to higher entities.
No stand-alone vertices deletes vertices that are not connected to any edges.
No stand-alone edges deletes edges that are not connected to any faces.
No stand-alone faces deletes faces that are not connected to any volumes.
Import Source:
Generic
AutoCAD
SolidWorks
JAMA
specifies the program used to create the IGES file.
Heal Geometry attempts to heal geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)
Virtual Cleanup specifies the automation of GAMBIT cleanup operations for the imported geometry.
Connect Tolerance specifies the maximum allowable distance between geometric entities to be connected. The distance must be input as either a specific value (Value) or a percentage of the length of the shortest edge in the model (Shortest Edge %).
Merge Tolerance specifies the maximum length of any edge considered a candidate for merging in the cleanup process.

Importing STEP Files

To import a STEP file, you must specify the following information:

Specifying the File Name

The File Name specifies the STEP file that contains the information to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Specifying the Import Options

The Import STEP File form provides the following options:

Specifying the Model Scale Factor

The Model Scale Factor specification allows you to apply a constant scale factor to all dimensions in the imported geometry. Its default value is equal to unity (1.0).

Specifying the Stand-alone Geometry Option

The Stand-alone Geometry options allow you to specify whether or not to retain or delete imported vertices, edges, and/or faces that are not connected to higher topology entities. There are three Stand-alone Geometry options:

If you select the No stand-alone option for any geometry type, GAMBIT deletes all imported entities of that type that are not connected to higher topological entities. For example, if you select the No stand-alone edges option, GAMBIT deletes all edges that are not connected to faces. If you do not select the No stand-alone option for a geometry type, GAMBIT includes stand-alone entities of that type in the imported geometry.

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT attempts to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 of the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Using the Import STEP File Form

The Import STEP File form (see below) allows you to import geometry from STEP files. To open the Import STEP File form, select Import from the File menu on the main menu bar, and select STEP from the Import submenu.

The Import STEP File form includes the following specifications.

File Name: specifies the name of the STEP file.
Browse… opens the Select Fileform, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options
Stand-alone Geometry specifies whether or not to retain or delete imported topological entities that are not connected to higher entities.
No stand-alone vertices deletes vertices that are not connected to any edges.
No stand-alone edges deletes edges that are not connected to any faces.
No stand-alone faces deletes faces that are not connected to any volumes.
Heal Geometry attempts to heal geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Importing Catia V4 Files

To import a Catia V4 file, you must specify the following information:

Specifying the File Name

The File Name specifies the Catia V4 file that contains the information to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Specifying the Import Options

The Import Catia V4 File form provides the following options:

Specifying the Model Scale Factor

The Model Scale Factor specification allows you to apply a constant scale factor to all dimensions in the imported geometry. Its default value is equal to unity (1.0).

Specifying the Stand-alone Geometry Option

The Stand-alone Geometry options allow you to specify whether or not to retain or delete imported vertices, edges, and/or faces that are not connected to higher topology entities. There are three Stand-alone Geometry options:

If you select the No stand-alone option for any geometry type, GAMBIT deletes all imported entities of that type that are not connected to higher topological entities. For example, if you select the No stand-alone vertices option, GAMBIT deletes all vertices that are not connected to edges.

If you do not select the No stand-alone option for a geometry type, GAMBIT includes stand-alone entities of that type in the imported geometry.

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT attempts to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 of the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Using the Import Catia V4 File Form

The Import Catia V4 File form (see below) allows you to import geometry from Catia V4 files. To open the Import Catia V4 File form, select Import from the File menu on the main menu bar, and select Catia V4 from the Import submenu.

The Import Catia V4 File form includes the following specifications.

File Name: specifies the name of the Catia V4 file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options
Stand-alone Geometry specifies whether or not to retain or delete imported topological entities that are not connected to higher entities.
No stand-alone vertices deletes vertices that are not connected to any edges.
No stand-alone edges deletes edges that are not connected to any faces.
No stand-alone faces deletes faces that are not connected to any volumes.
Heal Geometry attempts to heal geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Importing Catia V5 Files

To import a Catia V5 file, you must specify the following information:

Specifying the File Name

The File Name specifies the Catia V5 file that contains the information to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Specifying the Import Options

The Import Catia V5 File form provides the following options:

Specifying the Model Scale Factor

The Model Scale Factor specification allows you to apply a constant scale factor to all dimensions in the imported geometry. Its default value is equal to unity (1.0).

Specifying the Stand-alone Geometry Option

The Stand-alone Geometry options allow you to specify whether or not to retain or delete imported vertices, edges, and/or faces that are not connected to higher topology entities. There are three Stand-alone Geometry options:

If you select the No stand-alone option for any geometry type, GAMBIT deletes all imported entities of that type that are not connected to higher topological entities. For example, if you select the No stand-alone vertices option, GAMBIT deletes all vertices that are not connected to edges.

If you do not select the No stand-alone option for a geometry type, GAMBIT includes stand-alone entities of that type in the imported geometry.

Specifying the Heal Geometry Option

The Heal Geometry option specifies that GAMBIT attempts to heal geometry during import. For a description of GAMBIT healing operations, see Sections 2.4.8 and 2.5.8 of the GAMBIT Modeling Guide.

Specifying the Make Tolerant Option

The Make Tolerant option applies "tolerant modeling" to ensure the creation of valid topology from imprecise imported geometry. When you select the Make Tolerant option, GAMBIT automatically assigns a tolerance value to each imported vertex and edge to maintain topological integrity for the imported model. For example, if you select the Make Tolerant option and import an edge one termination point of which does not coincide with its corresponding endpoint vertex to within default model tolerance (10-6), GAMBIT assigns a specific tolerance value to the vertex such that it becomes coincident (to within the assigned tolerance) with the edge termination point. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Using the Import Catia V5 File Form

The Import Catia V5 File form (see below) allows you to import geometry from Catia V5 files. To open the Import Catia V5 File form, select Import from the File menu on the main menu bar, and select Catia V5 from the Import submenu.

The Import Catia V5 File form includes the following specifications.

File Name: specifies the name of the Catia V5 file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options
Stand-alone Geometry specifies whether or not to retain or delete imported topological entities that are not connected to higher entities.
No stand-alone vertices deletes vertices that are not connected to any edges.
No stand-alone edges deletes edges that are not connected to any faces.
No stand-alone faces deletes faces that are not connected to any volumes.
Heal Geometry attempts to heal geometry during import.
Make Tolerant specifies the use of tolerant modeling during import. (NOTE: If you select the Heal Geometry option, GAMBIT automatically invokes the Make Tolerant option.)

Importing ICEM Input Files

ICEM data consists of sets of coordinates that define points in space. When you import an ICEM input file into GAMBIT, you can either convert the spatial points directly to vertices or allow GAMBIT to create a set of edges or a face described by the positions of the points.

To import an ICEM input file, you must specify the following information:

Specifying the File Name

The File Name specifies the ICEM input file that contains the information to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Specifying the Import Options

The Import Options options allow you to specify the type of geometry created ruing the import operation and the allowable distance between the created geometry and the original data points. There are two Import Options:

Specifying the Tolerance

The Tolerance value specifies the maximum allowable distance between the created GAMBIT geometry and the original ICEM input data points used to describe the geometry.

Specifying the Geometry to Create

The Geometry to Create optiosn allow you to specify whether GAMBIT creates vertices, edges, or a face from the imported data. If you specify the creation of a face, you must also specify the manner in which the original data is interpreted in the face creation procedure.

The Geometry to Create options are as follows:

As noted above, if you select the Face option, you must specify the method by which the ICEM point data is converted to a GAMBIT face. GAMBIT provides four face-creation options:
Using the Import ICEM Input File Form

The Import ICEM Input File form (see below) allows you to import geometry from ICEM input files. To open the Import ICEM Input File form, select Import from the File menu on the main menu bar, and select ICEM Input from the Import submenu.

The Import ICEM Input File form includes the following specifications.

File Name: specifies the name of the file containing the data to be imported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Import Options:
Tolerance specifies the maximum distance between the created GAMBIT geometry and the original data point locations.
Geometry to Create:
Vertices creates vertices from the ICEM data.
Edges creates edges from the ICEM data.
Faces creates a face from the ICEM data.
Net surface creates a network of edges from the row and column data and fits a face to the network.
Vertex rows shapes the face by fitting a surface to the data points.
Skin surface (rows)creates an edge from each row in the data file and fits the face to the network of created edges.
Skin surface (columns) creates an edge from each column in the data file and fits the face to the network of created edges.

Importing Vertex Data Files

Vertex data files contain sets of coordinates that represent vertices. To import a vertex data file, you must specify the File Name of the file to be imported.

Using the Import Vertex Data File Form

The Import Vertex Data File form (see below) allows you to import geometry from vertex data files. To open the Import Vertex Data File form, select Import from the File menu on the main menu bar, and select Vertex Data from the Import submenu.

The Import Vertex Data File form includes the following specifications.

File Name: specifies the name of the file containing the data to be imported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Importing CAD Geometry

The Import CAD Geometry operation imports geometry created by computer-aided design (CAD) programs, such as SolidWorks and Pro/ENGINEER. GAMBIT supports the importation of the following CAD data formats:

To import CAD geometry, you must specify the following information: The CAD Option specifies the CAD program used to create the geometry and, in some cases, the method used to import the geometry. The import options are specific to each CAD Option.

Specifying the CAD Option
GAMBIT provides six CAD Option options on the Import CAD Geometry form: The I-DEAS FTL and OPTEGRA VISUALIZER options import geometry data files created by the I-DEAS and OPTEGRA Visualizer programs, respectively. The Pro/ENGINEER (STEP) and Pro/ENGINEER (DIRECT) options open and run Pro/ENGINEER to either create and import a STEP file or perform a direct model transfer to GAMBIT. The Parasolid (FILE-DIRECT) and Pro/ENGINEER (FILE-DIRECT) options import geometry data in the native format of the Parasolid and Pro/ENGINEER programs, respectively.

Specifying the I-DEAS FTL Option
The I-DEAS FTL option requires specification of the File Name for the geometry data file to be imported and does not include any import options. (NOTE: The Import CAD Geometry operation can be used to import I-DEAS geometry but cannot be used to import I?DEAS mesh information. To import I-DEAS mesh information, use the Import Mesh File operation (see "Importing Mesh Files," below).)

Specifying the OPTEGRA VISUALIZER Option
The OPTEGRA VISUALIZER option requires specification of the File Name for the geometry data file to be imported and does not include any import options.

Specifying the Pro/ENGINEER (STEP) Option
When you select the Pro/ENGINEER (STEP) option, GAMBIT starts and runs the Pro/ENGINEER software package in the back­ground to create a STEP file, then reads the STEP file to import the geometry. Conse­quently, you must have a valid Pro/ ENGINEER license to use the Pro/ENGINEER (STEP) option.

NOTE: GAMBIT Pro/ENGINEER geometry import capability has been tested using Pro/ENGINEER 2001. It is possible that GAMBIT will support geometry import from Pro/ENGINEER versions above 2001, as well.

The Pro/ENGINEER (STEP) option requires specification of the File Name for the data file that describes the geometry to be imported and does not include any import options.

Specifying the Pro/ENGINEER (DIRECT) Option
The Pro/ENGINEER (DIRECT) option allows you to import geometry directly from the Pro/ENGINEER software package. (NOTE: Use of the Pro/ENGINEER (DIRECT) option requires a special GAMBIT license.) The direct import of Pro/­ENGINEER geometry circumvents many potential translation problems that can exist when geometry is imported by means of STEP files—in particular, problems associated with incomplete geometry and topology translation. Geometry that is incorrectly translated may lack the mathematical descriptions associated with the original geometry, leading to problems with GAMBIT faceting and meshing operations. Direct import of Pro/ENGINEER geometry significantly improves the import process and thereby increases the probability of obtaining a complete and accurate representation of the imported geometry.

When you import a model component (part or assembly) directly from Pro/­ENGINEER, GAMBIT imports the component as a CAD entity. CAD entities (which are assigned the prefix "c_") are similar to real GAMBIT entities with regard to their mathematical evaluations, but they behave like virtual entities with regard to GAMBIT operations. For example, CAD entities cannot take part in GAMBIT Boolean operations.

CAD entities differ from real entities primarily in that the faceting information for any CAD entity is generated in Pro/ENGI­NEER, and the mathematical description of the entity is not transferred to GAMBIT during the geometry import. As a result, if you directly import geometry from Pro/­ENGINEER and save the GAMBIT database, then open the GAMBIT database independent of Pro/­ENGINEER, the resulting GAMBIT model does not include the math­ematical descriptions of the model geometry. When performing any valid oper­ation on such geometry, GAMBIT employs stored faceting informa­tion, rather than mathematical descriptions, for the geometry evaluations required by the operation.

Enabling the Direct Pro/ENGINEER Import Capability

For versions of GAMBIT that are licensed for the Pro/ENGINEER (DIRECT) import option, the GAMBIT installation CD includes a text file named and located on the CD as follows:

gambit/cad_integration/proe_integration/protk.dat
This file contains directory information and start-up command syntax that instructs Pro/ENGINEER how to start and run GAMBIT as an add-on program. The information in the file must either be appended to an existing protk.dat file (if one exists) or copied to a specified directory, as follows: Utilizing the Direct Pro/ENGINEER Import Capability

To import geometry directly from the Pro/ENGINEER program, you must execute the following steps:

Step Description Comments
1 Start Pro/ENGINEER by means of a special GAMBIT startup command. See NOTE (1).
2 On the Pro/ENGINEER main menu, select Tools/Auxiliary Applications.... Pro/ENGINEER opens the Auxiliary Applications pop-up form.
3 In the Auxiliary Applications pop-up form, select the gambit option, and click Start. (Click Close to close the Auxiliary Applications form.) Pro/ENGINEER starts GAMBIT and displays a new option, titled "Gambit" on the Pro/ENGINEER main menu. (See NOTE (2).)
4 Open a Pro/ENGINEER part file for the geometry to be imported to GAMBIT. See NOTES (3) and (4).
5 On the Pro/ENGINEER main menu, select Gambit/Start. GAMBIT opens in a separate window. (See NOTE (5).)
6 On the GAMBIT main menu, select File/Import.../CAD. GAMBIT opens the Import CAD Geometry form.
7 On the Import CAD Geometry form, select the Pro/ENGINEER (DIRECT) option and choose the Component to be imported. (NOTE: To import Pro/ENGINEER assemblies as GAMBIT groups, select the Create groups option.) The Component option button that appears on the Import CAD Geometry form when you select the Pro/ENGINEER (DIRECT) option includes all part files that are currently open in Pro/ENGINEER.

The Create groups option allows you to import Pro/ENGINEER assemblies as GAMBIT geometry groups.

8 On the Import CAD Geometry form, click Accept. GAMBIT imports the specified part as a CAD entity.

NOTE (1): For direct import of Pro/ENGINEER geometry to GAMBIT, you must start Pro/ENGINEER by means of the GAMBIT startup command including the -proe option. For example,
   gambit -id name -new -proe
where name is the name of the GAMBIT session. This command starts the Pro/ENGINEER program but does not start GAMBIT itself.
NOTE (2): If the Auxiliary Applications pop-up window does not include the gambit option, click Register, then browse to and select the protk.dat file to register the file and enable the gambit option.
NOTE (3): You cannot operate on parts or assemblies from within Pro/ENGINEER while GAMBIT is running.
NOTE (4): It is possible to switch between Pro/ENGINEER and GAMBIT operation while GAMBIT is running.
  • To switch from GAMBIT to Pro/ENGINEER, you must exit GAMBIT by means of the File/Close option on the GAMBIT main menu bar. When you exit GAMBIT in this manner, the GAMBIT window is iconized, and GAMBIT continues to run until you end its execution from within Pro/ENGINEER.
  • To switch from Pro/ENGINEER to GAMBIT, select the Gambit option on the Pro/ENGINEER main menu bar.
To ensure that any GAMBIT operations are preserved when switching back and forth between GAMBIT and Pro/ENGINEER, it is advisable to save the GAMBIT database before switching from GAMBIT to Pro/ENGINEER operation.
NOTE (5): The Pro/ENGINEER Gambit menu provides two options:
  • Start—GAMBIT starts but does not automatically import the part or assembly
  • Export to Gambit—GAMBIT starts and does automatically import the part or assembly
The Start option requires execution of Steps 6-8 to import the part or assembly but allows you to create GAMBIT groups during geometry import. The Export to Gambit option allows you to bypass Steps 6-8 but does not allow you to create GAMBIT groups during geometry import.

Specifying the Parasolid (FILE-DIRECT) Option
The Parasolid (FILE-DIRECT) option imports geometry data that exists in native Parasolid format—such as that produced by the SolidEdge, SolidWorks, and Uni­graphics CAD programs. (NOTE: Use of the Parasolid (FILE-DIRECT) option requires a special GAMBIT license.) The option requires specification of the File Name for the geometry data file and includes the following import options: The Solid geometry option specifies that GAMBIT will import the entire CAD-system model. The Flow volume option specifies that GAMBIT will attempt to extract the flow volume surround­ing the CAD-system model during the geo­metry import operation. (NOTE: It is not always possible to extract the flow volume for a CAD-system model. If the flow volume cannot be extracted during the geometry import operation, GAMBIT will attempt to construct a flow volume by means of face-stitching operations.) The Model Scale Factor value represents a constant scale factor to be applied to all dimensions in the imported geometry.

Specifying the Pro/ENGINEER (FILE-DIRECT) Option
The Pro/ENGINEER (FILE-DIRECT) option imports geometry data that exists in native Pro/ ENGINEER format. (NOTE: Use of the Pro/ENGINEER (FILE-DIRECT) option requires a special GAMBIT license.) The option requires specification of the File Name for the geometry data file and includes the following import options: The Solid geometry option specifies that GAMBIT will import the entire CAD-system model. The Flow volume option specifies that GAMBIT will attempt to extract the flow volume surround­ing the CAD-system model during the geo­metry import operation. (NOTE: It is not always possible to extract the flow volume for a CAD-system model. If the flow volume cannot be extracted during the geometry import operation, GAMBIT will attempt to construct a flow volume by means of face-stitching operations.) The Model Scale Factor value represents a constant scale factor to be applied to all dimensions in the imported geometry.

Using the Import CAD Geometry Form

The Import CAD Geometry form (see below) allows you to import geometry created by means of CAD programs. To open the Import CAD Geometry form, select Import from the File menu on the main menu bar, and select CAD from the Import submenu.

The Import CAD Geometry form includes the following specifications.

CAD Option:
I-DEAS FTL
OPTEGRA VISUALIZER
Pro/ENGINEER (STEP)
Pro/ENGINEER (DIRECT)
Parasolid (FILE-DIRECT)
Pro/ENGINEER (FILE-DIRECT)
specifies the CAD geometry type and import method.
File Name: specifies the name of the file that contains the information to be imported. (NOTE: The Pro/ENGINEER (DIRECT) option does not require a File Name specification.)
Browse… opens the Select File form (see "Using the Select File Form" in Section 4.1.2).
Component: (Pro/ENGINEER (DIRECT) option only) specifies the name of the Pro/ENGINEER part to be imported.
Create groups (Pro/ENGINEER (DIRECT) option only) imports Pro/ENGINEER assemblies as GAMBIT groups.
Solid geometry (Parasolid (FILE-DIRECT) and Pro/ENGINEER (FILE-DIRECT) options only) specifies that GAMBIT will import the entire CAD-system model.
Flow volume (Parasolid (FILE-DIRECT) and Pro/ENGINEER (FILE-DIRECT) options only) specifies that GAMBIT will attempt to extract the flow volume surround­ing the CAD-system model during the geo­metry import operation.
Model Scale Factor (Parasolid (FILE-DIRECT) and Pro/ENGINEER (FILE-DIRECT) options only) specifies a constant scale factor to be applied to all dimensions in the imported geometry.

Importing Mesh Files

To import a mesh file, you must specify the following information:

The Type and Dimension specifications define the format of the mesh data to be imported. The Feature Angle defines the angle criterion that determines where to create topological edges for an imported three-dimensional mesh. The Merge Tolerance (which is not available for all types of imported meshes) determines which pairs (or sets) of imported nodes are merged in the importation process. The Scale specification scales the dimensions of the model relative to its original size. The File Name constitutes the name of the file to be imported.

Specifying the Type

GAMBIT allows you to import mesh information in the following formats.

NOTE (1): (Microsoft Windows® operating systems) GAMBIT sometimes encounters difficulties when attempting to import a mesh file from a Windows directory that contains spaces in the directory name—for example, "C:/Documents and Settings". To ensure trouble-free importation of mesh files:
  • Do not store mesh files in any Windows directory that includes spaces in its name.
  • Do not start GAMBIT from a Windows directory that includes spaces in its name.
NOTE (2): STL files constitute collections of unconnected triangular facets that describe the exterior of model geometry. When you import an STL file, GAMBIT automatically translates the STL-file facet information into topological entities, faces, and volumes. For a description of the format of the mesh information associated with each of the other options listed above, consult the appropriate user documentation.
NOTE (3): GAMBIT supports the importation of higher-order mesh elements only for mesh data in the GAMBIT and FIDAP file formats. If you import a GAMBIT or FIDAP mesh file that contains higher-order elements, GAMBIT retains the order of the mesh elements but linearizes the faceted geometry during import. As a result, some imported mesh-node locations may not coincide with the associated faceted geometry created during the mesh import.
NOTE (4): When you import any mesh file other than a GAMBIT neutral file, GAMBIT retains any boundary types associated with the imported data. If the boundary types in the imported file do not match those of the currently selected solver, GAMBIT assigns boundary types that are valid for the current solver and analogous to those in the imported file.
NOTE (5): When you import a PLOT3D file, GAMBIT displays PLOT3D option summary information for the file in the lower section of the Import Mesh File form. The option summary includes:
  • File Is—Indicates the basic file format (Formatted, Binary, FORTRAN Unformatted, or Unknown)
  • Multi-block—Indicates whether the data exists in a multi-block format (Yes or No)
  • IBlank—Indicates whether the data file employs the PLOT3D IBlank for­mat description (Yes or No)
  • Byte swapping—(Binary and FORTRAN Unformatted file formats only) Indicates whether byte swapping is necessary when importing the file (Yes or No). (NOTE: Byte-swapping is sometimes necessary when the platform running GAMBIT differs from that used when creating the PLOT3D data file.)
  • Precision—(Binary and FORTRAN Unformatted file formats only) Indicates the precision with which real numbers are stored in the data file (Single-precision or Double-precision)

Specifying the Dimension

If you specify any file type other than FIDAP, GAMBIT, or STL, you must specify one of three mesh Dimension options: 2 D (planar surface mesh), 3 D (volume mesh), or Surface (surface mesh in 3-D space)..

Specifying the Feature Angle

When you import a mesh file, GAMBIT automatically creates geometry based on the mesh information in the file. If you import a two-dimensional mesh, GAMBIT creates model edges at the outer boundaries of the mesh. If you import a three-dimensional mesh, GAMBIT creates faces at the outer boundaries of the mesh and creates edges, as necessary, based, in part, on the angle between adjacent mesh element faces.

The Feature Angle specification on the Import Mesh File form constitutes the criterion that GAMBIT employs to determine which mesh edges to convert to topological edges. Specifically, the Feature Angle represents a minimum value of the parameter in the expression , where is the angle (in degrees) between adjacent mesh element faces along a common mesh element edge (see Figure 4-1).

Figure 4-1: Mesh element faces, Feature Angle specification

If is greater than the Feature Angle, GAMBIT creates a topological edge at the mesh edge that is common to the two mesh element faces. If is less than the Feature Angle, GAMBIT does not include the common mesh element edge as part of a geometric edge based on the angle criterion. (NOTE: Other geometry edges and faces are created based on element connectivity and element group information that is contained in the mesh file.)

NOTE (1): If you specify a Feature Angle value of zero, GAMBIT creates faces and volumes based only on boundary and continuum zones information that exists in the imported mesh file.
NOTE (2): You can create and modify geometry based on an imported mesh by means of the Modify Meshed Geometry form (see "Using the Modify Meshed Geometry Form" in the GAMBIT Modeling Guide, Sections 3.3.7 and 3.4.5)

Specifying the Merge Tolerance

The Merge Tolerance value specifies the maximum distance between merge-able nodes in the imported mesh. For example, if two nodes are separated by a distance of 5.0(10-7) and the Merge Tolerance is set at 10-6, then the nodes are merged to become a single node in the imported mesh.

Specifying the Scale Factor

The Scale enlarges or reduces the imported mesh by a factor x, where x is the specified Scale value on the Import Mesh File form.

Using the Import Mesh File Form

The Import Mesh File form (see below) allows you to import mesh information from mesh files. To open the Import Mesh File form, select Import from the File menu on the main menu bar, and select Mesh from the Import submenu.

The Import Mesh File form includes the following specifications.

Type:
ANSYS
CGNS
FIDAP
FLUENT 4
FLUENT 5/6
GAMBIT
HYPERMESH
I-DEAS UNV
NASTRAN
PATRAN
PLOT3D
STL
TGRID
specifies the format for the mesh information to be imported.
Dimension:
2 D
3 D
Surface
specifies the dimension for I-DEAS UNV, ANSYS, NASTRAN and PATRAN files.
Feature Angle specifies the minimum value of that GAMBIT employs to determine which mesh edges are converted to model edges.
Merge Tolerance specifies the maximum distance between nodes that are to be merged in the mesh import process.
Scale specifies the factor by which the mesh is enlarged or reduced in the mesh import process.
File Name: specifies the name of the file containing the mesh and boundary attribute information to be imported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
PLOT3D Options: (PLOT3D file import only)
  • Formatted / Binary—Specifies whether the import­ed data exists as a for­matted text file or a binary file
  • With IBlank—Specifies that the data file employs the PLOT3D IBlank format description
  • Byte swapping—(Binary option only) Specifies that byte swapping is necessary when importing the file
  • Single precision / Double precision—Specifies the precision with which real numbers are stored in the data file

Importing Turbo Files

Turbo files contain data that describe turbomachinery configurations, such as edges that describe the blade cross-sections, hub, casing, and shroud. To import a turbo file, you must specify the following information:

Specifying the Type

The Type specification determines the form of the file to be imported. GAMBIT allows you to import two types of turbo files:

Native files are structured in the native GAMBIT turbo-file format (see Appendix D of this guide). Pro/ENGINEER (IBL) files are IBL-format files generated by the Pro/ENGINEER CAD package. Native and Pro/ENGINEER (IBL) files are typically assigned ".tur" and ".ibl" file extensions, respectively.

Specifying the File Name

The File Name specifies the turbo input file that contains the data to be imported. GAMBIT allows you to input the file name directly in the File Name text box or to select the file from directories and file lists by means of the Browse command button.

Using the Import Turbo File Form

The Import Turbo File form (see below) allows you to import turbo data files. To open the Import Turbo File form, select Import from the File menu on the main menu bar, and select Turbo from the Import sub­menu.

The Import Turbo File form includes the following specifications.

Type:
Native
Pro/ENGINEER (IBL)
specifies the format of the data file to be imported.
File Name: specifies the name of the turbo file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Importing Plug-in Files

Plug-in files are used in conjunction with special GAMBIT functionality to create customized modeling operations. (NOTE: For information regarding the use of plug-in files, contact your Fluent representative.) To import a plug-in file, you must specify the File Name of the file to be imported.

Using the Import Plug-in File Form

The Import Plug-in File form (see below) allows you to import a plug-in file. To open the Import Plug-in File form, select Import from the File menu on the main menu bar, and select Plug-in from the Import submenu.

The Import Plug-in File form includes the following specifications.

File Name: specifies the name of the plug-in file.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)


4.1.10 Export

When you select Export from the File menu, GAMBIT opens a submenu of file export options. The submenu includes the following options (export commands):

The ACIS, Parasolid, IGES, STEP, and Catia V4 options export model geometry in the format of their corresponding modelers or standards. The Mesh option exports mesh information in a format appropriate to the currently selected solver.

NOTE (1): When you export ACIS, Parasolid, IGES, STEP, or Catia geo­metry, GAMBIT automatically exports any label, level, and/or color attributes associated with the geometry.
NOTE (2): Microsoft Windows operating systems reserve certain letter com­binations to use as device names. If you attempt to export a file the name of which constitutes one of the reserved letter combinations, the export operation (and/or any subsequent GAMBIT import operations involving the file) will experience problems and possibly fail. It is advisable, therefore, to avoid using the reserved letter combinations when specifying file names for GAMBIT export operations.

The reserved letter combinations (which are not case-sensitive) include: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9. Such letter combinations should not be used as GAMBIT export file names regardless of the file extension. For example, GAMBIT export operations might experience problems when attempting to export files named COM8, PRN.stp, or nul.igs.

Exporting ACIS Files

To export geometry information in an ACIS format, you must specify the following parameters.

Parameter Description
Format Specifies the form in which the data is stored in the ACIS file (ASCII or Binary)
Version Specifies the ACIS version with which the exported geometry is compatible
Method Determines whether or not GAMBIT includes sequence numbers when it exports an ASCII version of the ACIS file

(NOTE: For a description of the form and purpose of ACIS-file sequence numbers, refer to ACIS documentation.)

File Name Specifies the name of the export file

Using the Export ACIS File Form

The Export ACIS File form (see below) allows you to export model geometry information in ACIS format. To open the Export ACIS File form, select Export from the File menu on the main menu bar, and select ACIS from the Export submenu.

The Export ACIS File form includes the following specifications.

Format:
ASCII specifies that the ACIS file is written in an ASCII format.
Binary specifies that the ACIS file is written in a binary format.
Version: contains an option button that allows you to specify the ACIS code version with which the exported geometry is compatible.
Method: (ASCII format only)
Sequencing specifies that sequence numbers are included in the exported ACIS file.
No Sequencing specifies that sequence numbers are not included in the exported ACIS file.
File Name: specifies the name of the file to which the ACIS geometry information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Exporting Parasolid Files

To export geometry information in a Parasolid format, you must specify the following parameters.

Parameter Description
Format Specifies the form in which the data is stored in the Parasolid file (Text or Binary)
Version Specifies the Parasolid version with which the exported geometry is compatible
File Name Specifies the name of the export file

Using the Export Parasolid File Form

The Export Parasolid File form (see below) allows you to export model geometry information in Parasolid format. To open the Export Parasolid File form, select Export from the File menu on the main menu bar, and select Parasolid from the Export submenu.

The Export Parasolid File form includes the following specifications.

Format:
Text specifies that the Parasolid file is written in a text format.
Binary specifies that the Parasolid file is written in a binary format.
Version: contains an option button that allows you to specify the Parasolid code version with which the exported geometry is compatible.
File Name: specifies the name of the file to which the geometry information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Exporting IGES Files

To export geometry information in an IGES format, you must specify the File Name and the status of the Write MSBO solids option. If you select the Write MSBO solids option, GAMBIT creates manifold solid B-rep objects (MSBOs) when exporting the IGES data.

Using the Export IGES File Form

The Export IGES File form (see below) allows you to export model geometry information in IGES format. To open the Export IGES File form, select Export from the File menu on the main menu bar, and select IGES from the Export submenu.

The Export IGES File form includes the following specifications.

File Name: specifies the name of the file to which the geometry information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Write MSBO solids creates manifold solid B-rep objects when exporting the IGES data.

Exporting STEP Files

To export geometry information in a STEP format, you must specify the File Name for the file to which the data is to be exported.

Using the Export STEP File Form

The Export STEP File form (see below) allows you to export model geometry information in STEP format. To open the Export STEP File form, select Export from the File menu on the main menu bar, and select STEP from the Export submenu.

The Export STEP File form includes the following specifications.

File Name: specifies the name of the file to which the geometry information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Exporting Catia V4 Files

To export geometry information in a Catia V4 format, you must specify the File Name for the file to which the data is to be exported.

Using the Export Catia V4 File Form

The Export Catia V4 File form (see below) allows you to export model geometry information in STEP format. To open the Export Catia V4 File form, select Export from the File menu on the main menu bar, and select Catia V4 from the Export submenu.

The Export Catia V4 File form includes the following specifications.

File Name: specifies the name of the file to which the geometry information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)

Exporting Mesh Files

When you select Export from the File menu and select Mesh from the Export submenu, GAMBIT opens the Export Mesh Files form. The Export Mesh Files form allows you to export GAMBIT mesh, boundary-type, and continuum-type information in a format appropriate to the currently selected solver.

The following table lists the available GAMBIT mesh export file formats, their associated file extensions, and the solvers to which they correspond.

Format Extension Solver(s)
FIDAP Neutral FDNEUT FIDAP
UNS / RAMPANT/ FLUENT 5/6 msh FLUENT/UNS
RAMPANT
FLUENT 5/6
Structured FLUENT 4 Grid GRD FLUENT 4
NEKTON msh NEKTON
ANSYS cdb ANSYS
Generic Neutral neu POLYFLOW
Generic

Each format differs from the others with respect to two characteristics:

Both characteristics are directly related to those of the currently active solver; therefore, to change the format of the exported file, you must first change the solver specification. For a description of the solver specifications available in GAMBIT, see Section 4.3.

NOTE (1): If you select the FLUENT/UNS, RAMPANT, FLUENT 5/6 solver, GAMBIT allows you to export a mesh created using a 2-D model that lies in the x-y coordinate plane.
NOTE (2): For a description of the GAMBIT neutral-file format, see Appendix C of this guide.
NOTE (3): Under certain conditions, GAMBIT allows you to include bound­ary conditions for edges that are parts of volumes when exporting meshes for Polyflow models. To be included in the exported Polyflow volume mesh in­formation, an edge must be specified with an ELEMENT_SIDE boundary zone type, and the zone name must begin with the letters "PM" (not case-sensitive).

Using the Export Mesh File Form

The Export Mesh File form (see below) allows you to export mesh information. To open the Export Mesh File form, select Export from the File menu on the main menu bar, and select Mesh from the Export submenu.

The Export Mesh File form includes the following specifications.

File Type: displays the export file format. To change the export file type, you must change the solver specification (see Section 4.3).
File Name: specifies the name of the file to which the mesh and boundary attribute information is exported.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Export 2-D (X-Y) Mesh (FLUENT/UNS, RAMPANT, FLUENT 5/6 solvers only) exports a mesh created using a 2-D model that lies in the x-y coordinate plane.


4.1.11 Reconnect CAD

When you select Reconnect CAD from the File command menu, GAMBIT opens the Reconnect CAD Geometry form. The Reconnect CAD Geometry form (cad reconnect command) allows you to associate (reconnect) CAD components in the current GAMBIT database with the CAD models from which they were originally imported. The association permits GAMBIT to perform exact evaluations as necessary during geometry operations.

Overview

When you import a CAD component directly using the Parasolid (FILE-DIRECT) or Pro/ENGINEER (FILE-DIRECT) option on the Import CAD Geometry form (see "Importing CAD Geometry," above), GAMBIT automatically associates the imported component with the CAD representation of the geometry data as manifest in the Parasolid or Pro/ENGINEER file from which the component is imported. The association provides GAMBIT access the original CAD information for the component and permits GAMBIT to perform exact evaluations when operating on the imported geometry.

When you save a GAMBIT database that contains directly imported CAD geo­metry, GAMBIT does not automatically retain the associations between the imported CAD components and their CAD model files. Consequently, when you reopen the database, the associations do not exist, and GAMBIT cannot perform exact evaluations as necessary during the course of its geometry operations. To enable the use of exact evaluations when working with saved databases that contain directly imported CAD geometry, it is necessary to associate (reconnect) the database CAD components with the CAD model files from which they were originally imported.

NOTE: If you open a database that contains directly imported CAD geometry and do not reconnect the CAD components, GAMBIT performs faceted evalua­tions (rather than exact evaluations) when operating on the imported geometry.

Associating CAD Components and Files

When you open a database that contains directly imported CAD geometry, GAMBIT automatically detects the presence of the CAD compo­nents and displays a Prompt window (see below) to remind you to reconnect the CAD entities to their original CAD model files.

The reconnection operation is performed by means the Reconnect CAD Geometry form (see below).

The Reconnect CAD Geometry form includes the following main elements:

The Component field displays all of the CAD components in the database that are not currently associated with a CAD model file. The File field displays the files that are to be associated with the listed CAD components. (NOTE: GAMBIT automatically updates the Component and File fields as each component is associated with a model file.) The Associate pushbutton assigns the file currently displayed in the File Name text box to the currently selected component.

To specify a file association for any listed CAD component:

  1. Select (click to highlight) the component name in the Component field.
  2. Click Browse… to open the Select File form.
  3. Use the Select File form to locate the CAD model file to be associated with the selected component. (For instructions on using the Select File form, see "Using the Select File Form" in Section 4.1.2, above.)
  4. Click Associate.
When you click Accept on the Reconnect CAD Geometry form, GAMBIT performs all of the specified Component/File associations and updates the Component list field.

Using the Reconnect CAD Geometry Form

The Reconnect CAD Geometry form (see below) allows you to associate directly imported CAD geometry from a previously saved database with the CAD model file(s) from which it was originally imported. To open the Reconnect CAD Geometry form, select Reconnect CAD from the File menu on the main menu bar.

The Reconnect CAD Geometry form includes the following specifications.

Component displays the CAD components in the database that are not currently associated with a CAD model file.
File displays the CAD model files to be associated with the CAD components.
File Name: specifies the name of the CAD model file to be associated with the currently selected (highlighted) component.
Browse… opens the Select File form, which allows you to browse existing directories and file lists and to select a file name from the lists. (See "Using the Select File Form" in Section 4.1.2.)
Associate associates the currently highlighted component with the file currently displayed in the File Name text box.


4.1.12 Exit

The Exit operation (end command) stops program execution. To exit the GAMBIT program, select Exit from the File menu on the main menu bar. If you have changed the model since the time it was last saved, GAMBIT prompts you to save the model before exiting the program (see below).


next previous contents index © 1998-2007 Fluent, Inc. All rights reserved.