2. STARTING GAMBIT. 2.1 Startup Procedures

Size: px

Start display at page:

Download "2. STARTING GAMBIT. 2.1 Startup Procedures"

Marcus Harvey
6 years ago
Views:

1 STARTING GAMBIT Startup Procedures 2. STARTING GAMBIT For most installations, the GAMBIT startup procedure involves execution of a simple startup command; however, the PC version of GAMBIT also includes a launcher window that automates the startup procedure and allows you to start the program from a PC desktop shortcut. In either case, you can customize the GAMBIT startup procedure by means of startup command options and can specify the directories that GAMBIT uses for general operations for example, its source and scratch directories by means of the GAMBIT initialization file. This chapter describes the GAMBIT startup procedures, including the available command options, and the organizational structure of the files and directories that are associated with GAMBIT sessions. 2.1 Startup Procedures The GAMBIT startup procedures can be grouped into two categories: General procedure PC procedure The general procedure applies to all platforms. The PC procedure applies only to GAMBIT PC installations General Procedure The general GAMBIT startup procedure involves execution of the GAMBIT startup command. The startup command can include a set of options that customize the GAMBIT session. Startup Command Format The format of the GAMBIT startup command is as follows: gambit [option1 option2...] where the option arguments represent any of the startup options described below Fluent, Inc. All rights reserved. 2-1

2 Startup Procedures STARTING GAMBIT Startup Command Options The startup command options that are available in GAMBIT are as follows. Option (Parameters) -def filename -dev driver -doc -font size Description Specifies the name (filename) of an initialization file that contains the GAMBIT program default values. Specifies a graphics driver name. Launches the local web browser and opens the table of contents for GAMBIT online documentation. Specifies the font size to be displayed by the GAMBIT GUI. The available size options are: xs (extra small) s (small) l (large) xl (extra large) -geom width x height +x +y Specifies the window size (in pixels). -help -id id -init filename Displays the available startup options. Specifies an alphanumeric identifier for the GAMBIT session. (NOTE: If you omit the -id option, GAMBIT assigns the session the default identifier, default_id.) For a description of the session identifier and its use, see Section 2.2 and Chapter 4 of this guide. Specifies the name (filename) of a journal file that is to be run at startup in the GUI mode. For a description of the purpose and use of GAMBIT journal files, see Chapter 4 of the User's Guide Fluent, Inc. All rights reserved.

3 STARTING GAMBIT Startup Procedures Option (Parameters) -inp filename -new -old -proe command -rx.y.z -res filename1 filename2 Description Specifies the name (filename) of a journal file that is to be run in the batch mode. For a description of the purpose and use of GAMBIT journal files, see Chapter 4 of the User's Guide. Mutually exclusive options that specify whether or not GAMBIT opens a new or existing session. -new specifies that GAMBIT is to open a new session -old specifies that GAMBIT is to open an existing session Starts the Pro/ENGINEER CAD program for direct import of Pro/ENGINEER geometry into GAMBIT (see Importing CAD Geometry in Section of this guide). The command keyword specifies the system-specific command used to start Pro/ENGINEER. NOTE (1): For Windows NT systems, the command keyword must be enclosed in quotation marks if it includes spaces. NOTE (2): This option does not start the GAMBIT program. Starts a previous version of GAMBIT the release number of which is specified by the parameters x, y, and z. For example, the command gambit -r2.0.4 starts GAMBIT version (NOTE: The GAMBIT version to be started must already be installed.) Creates a new journal file (filename1) corresponding to an existing GAMBIT database file (filename2). (NOTE: This option does not start GAMBIT.) Fluent, Inc. All rights reserved. 2-3

4 Startup Procedures STARTING GAMBIT Option (Parameters) -skipstartup Description (PC-installations only) Bypasses display of the Gambit Startup window when launching GAMBIT from the PC Command Prompt window (see Section 2.1.2, below). Some of the startup command options listed above require the specification of numeric or string parameters, such as window dimensions or file names, respectively. The rules that govern GAMBIT startup command syntax require that you do not enclose string parameters in quotation or double-quotation marks. For example, the correct syntax for starting an existing GAMBIT session named model1 is as follows: gambit -id model1 -old. You can also include a path name in string parameters that refer to file names or identifiers. For example, if the files associated with the session model1 in the previous example are located in a directory named project1, the correct syntax for the command is as follows: PC Procedure gambit -id project/model1 -old. For PC installations, GAMBIT provides two methods of starting the program: Gambit Startup window Command Prompt window The Gambit Startup window constitutes the primary (normal) method for starting GAMBIT on PC installations. The Command Prompt window method provides an alternative that can be useful for batch operations. Gambit Startup Window For PC installations, GAMBIT includes a Gambit Startup window that allows you to specify command options and to monitor the progress of the program launch operation. The window simplifies the GAMBIT startup procedure for PC installations and makes it easy to specify a session identifier and maintain a history of working directories. You can open the Gambit Startup window either by selecting the GAMBIT program icon from the PC Start menu or by clicking the GAMBIT shortcut icon on the PC desktop or task bar Fluent, Inc. All rights reserved.

STARTING GAMBIT Startup Procedures The Gambit Startup window includes three fields: Working Directory Specifies the working directory for the GAMBIT session (see Section 2.

5 STARTING GAMBIT Startup Procedures The Gambit Startup window includes three fields: Working Directory Specifies the working directory for the GAMBIT session (see Section 2.2.2, below) Session Id Specifies a new session identifier or allows you to select from a list of previously saved sessions Options Specifies the startup command options (see Section 2.1.1, above) To launch GAMBIT from the Gambit Startup window: 1. Select the GAMBIT program icon from the PC Start menu or click the GAMBIT shortcut icon on the PC desktop or task bar. 2. Specify the Working Directory, Session Id, and command Options. 3. Click Run. Command Prompt Window The Command Prompt window startup procedure is identical to the general procedure described in Section 2.1.1, above. To launch GAMBIT from the Command Prompt window: 1. Open the Command Prompt window. 2. Execute the GAMBIT startup command. NOTE (1): When you start the program from the Command Prompt window, GAMBIT automatically launches the Gambit Startup window (see above). You can bypass the Gambit Startup window by including the -skipstartup option in the startup command string Fluent, Inc. All rights reserved. 2-5

6 Startup Procedures STARTING GAMBIT NOTE (2): If you do not bypass the Gambit Startup window, any option that you specify in the startup command string is automatically included in the Options field on the Gambit Startup window unless it is related to the session identifier. Specifically, GAMBIT ignores the -id, -old, and -new command options when starting from the Command Prompt window unless the startup command also includes the -skipstartup option Fluent, Inc. All rights reserved.

7 STARTING GAMBIT GAMBIT File Organization 2.2 GAMBIT File Organization Session Files When you start GAMBIT, either in the batch mode or in the real-time mode employing the GUI, GAMBIT creates a modeling session. A GAMBIT modeling session consists of all operations performed in relation to a GAM- BIT model. Such operations include but are not limited to the following: Import of geometry and mesh information Creation of geometry Creation and refinement of a mesh Assignment of zone types Creation and modification of coordinate systems and grids Changing the appearance and orientation of the model as displayed in the graphics window GAMBIT keeps track of session operations, as well as the ongoing status of the model, by means of three data files. The names, titles, formats, and contents of the session data files are as follows. Name Title Format Contents jou Journal Text A sequential list of geometry, mesh, zone, and tools commands executed during the session trn Transcript Text A log of messages displayed in the GAMBIT Transcript window during the session dbs Database Binary A binary database containing geometry, mesh, graphicsdisplay, defaults, and journal information associated with the model Fluent, Inc. All rights reserved. 2-7

8 GAMBIT File Organization STARTING GAMBIT In addition to the three data files listed above, GAMBIT creates a lock file, named id.lok, where id represents the session identifier. The purpose of the lock file is to lock out the process number for the current GAMBIT session so that the data files cannot be accessed and/or modified by any concurrent GAMBIT session Directory Structure GAMBIT employs four types of directories to organize session data files and other files related to GAMBIT operation. The following table describes the type, location, and contents of each of the four directories. Directory Type Location Contents Home User specified Files that are global to all GAMBIT sessions, such as initialization files Source User specified Permanent files containing information related to a specific category, such as a project. Contents may include projectspecific initialization files, journal files, database files, transcript files, macros, and environment variables. Scratch User specified Copies of files from the source directory, temporary files, the working subdirectory, and the id.lok file. Working Subdirectory of the scratch directory (see below) Temporary session data files jou, trn, and dbs Fluent, Inc. All rights reserved.

9 STARTING GAMBIT GAMBIT File Organization Home, Source, and Scratch Directories By default, the location of the source and scratch directories is identical to that from which GAMBIT is launched. You can change the default locations of the home, source, and scratch directories by means of the GAMBIT Edit Defaults form. For a description of the Edit Defaults form and its use, see Chapter 4 of this guide. Working Directory The working directory is a subdirectory of the scratch directory. Its name consists of the identifier GAMBIT appended with a process number. For example, if you start GAMBIT such that the scratch directory is named users1 and the process number is 12345, GAMBIT locates the session files that is, jou, dbs, trn, and lok in a directory named File Management users1/gambit The following sections describe the manner in which GAMBIT manages files when you perform the following operations. Open an existing GAMBIT session Save a current GAMBIT session Opening an Existing GAMBIT Session When you open an existing GAMBIT session, GAMBIT copies the existing session data files in the source directory to their corresponding files in the working directory. For example, if the session information is as follows, Session identifier burner71 Source directory mymodel Process number 1234 GAMBIT copies files in the following manner Fluent, Inc. All rights reserved. 2-9

10 GAMBIT File Organization STARTING GAMBIT Existing Data File Name /mymodel/burner71.jou /mymodel/burner71.dbs /mymodel/burner71.trn Copied File Name /users1/gambit.1234/jou /users1/gambit.1234/dbs /users1/gambit.1234/trn Thereafter, if you modify the model during the current GAMBIT session, GAMBIT modifies the jou, dbs, and trn files but does not alter the original data files from which they were copied until you perform a save operation. Saving a Current Session When you save a GAMBIT session, GAMBIT copies the three active data files from the working directory either to the source directory or to another user-specified directory. The three copied files share a common root name that is, the session identifier. The extension of each copied file corresponds to the name of the data file from which it is copied. For example, if the save operation information is as follows, Session identifier model1 Target directory mymodel Process number 6789 GAMBIT copies the active session data in the following manner. Session File Location/Name Copy File Location/Name scratchname/gambit.6789/jou mymodel/model1.jou scratchname/gambit.6789/dbs mymodel/model1.dbs scratchname/gambit.6789/trn mymodel/model1.trn Fluent, Inc. All rights reserved.

4. GAMBIT MENU COMMANDS

GAMBIT MENU COMMANDS 4. GAMBIT MENU COMMANDS The GAMBIT main menu bar includes the following menu commands. Menu Item File Edit Solver Help Purposes Create, open and save sessions Print graphics Edit and/or