ANSYS TurboGrid Introduction

ANSYS TurboGrid Release 11.0

December 2006

ANSYS, Inc. Southpointe 275 Technology Drive Canonsburg, PA 15317 ansysinfo@ansys.com http://www.ansys.com (T) 724-746-3304 (F) 724-514-9494

Copyright and Trademark Information
© 2003-2006 ANSYS Canada Ltd. All rights reserved. Unauthorized use, distribution, or duplication is prohibited. ANSYS, ANSYS Workbench, AUTODYN, CFX, FLUENT and any and all ANSYS, Inc. brand, product, service and feature names, logos and slogans are registered trademarks or trademarks of ANSYS, Inc. or its subsidiaries located in the United States or other countries. ICEM CFD is a trademark used by ANSYS, Inc. under license. CFX is a trademark of Sony Corporation in Japan. All other brand, product, service and feature names or trademarks are the property of their respective owners.

Disclaimer Notice
THIS ANSYS SOFTWARE PRODUCT AND PROGRAM DOCUMENTATION INCLUDE TRADE SECRETS AND ARE CONFIDENTIAL AND PROPRIETARY PRODUCTS OF ANSYS, INC., ITS SUBSIDIARIES, OR LICENSORS. The software products and documentation are furnished by ANSYS, Inc., its subsidiaries, or affiliates under a software license agreement that contains provisions concerning non-disclosure, copying, length and nature of use, compliance with exporting laws, warranties, disclaimers, limitations of liability, and remedies, and other provisions. The software products and documentation may be used, disclosed, transferred, or copied only in accordance with the terms and conditions of that software license agreement. ANSYS, Inc. is a UL registered ISO 9001:2000 company.

U.S. Government Rights
For U.S. Government users, except as specifically granted by the ANSYS, Inc. software license agreement, the use, duplication, or disclosure by the United States Government is subject to restrictions stated in the ANSYS, Inc. software license agreement and FAR 12.212 (for non DOD licenses).

Third-Party Software
See the online documentation in the product help files for the complete Legal Notice for ANSYS proprietary software and third-party software. The ANSYS third-party software information is also available via download from the Customer Portal on the ANSYS web page. If you are unable to access the third-party legal notices, please contact ANSYS, Inc. Published in the U.S.A.

Table of Contents
Copyright and Trademark Information Disclaimer Notice U.S. Government Rights Third-Party Software ANSYS TurboGrid Overview
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Blade Passage Wrap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Multi-Blade Applications. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Topology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Mesh Generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Layers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Beta Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

CFX Launcher
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Starting the CFX Launcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 The Launcher Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Working Directory Selector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 Output Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Automatic Application Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Launcher Customization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 CCL Structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10 Example: Adding the Windows Calculator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13

ANSYS TurboGrid Introduction

Page v

Table of Contents: Help On Help

Help On Help
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 ANSYS TurboGrid Documentation Structure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Document Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 File and Directory Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 User Input. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Input Substitution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Optional Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Operating System Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16 Accessing Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Adjusting Font Sizes in Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Using the Help Browser Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 Using the Search Feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Contact Information
How to Contact ANSYS Customer Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19 ANSYS Customer Portal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Page vi

ANSYS TurboGrid Introduction

ANSYS TurboGrid Overview
• • Introduction (p. 1) What’s New (p. 1)

Introduction
ANSYS TurboGrid is a powerful tool that lets designers and analysts of rotating machinery create high-quality hexahedral meshes, while preserving the underlying geometry. These meshes are used in the ANSYS workflow to solve complex blade passage problems. The ANSYS TurboGrid online product documentation is divided into five major areas: 1. ANSYS TurboGrid Introduction A brief introduction, listing of new features, and detailed information about the CFX launcher 2. ANSYS TurboGrid Tutorials 3. ANSYS TurboGrid User's Guide Information about the user interface and workflow 4. ANSYS TurboGrid Reference Guide Detailed information about menu items, command actions, syntax, etc. 5. Installation and Licensing

What’s New
The following sections outline some of the enhancements in ANSYS TurboGrid.

General
• Graphical User Interface (GUI) extended to include right-click options in the Object Tree and Viewer.

ANSYS TurboGrid Introduction
ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 1

ANSYS TurboGrid Overview: What’s New

Blade Passage Wrap
Geometry, topology, and mesh generation support has been added for: • Blades with over 270° wrap; now there are no specific limits to the amount of wrap that a blade may have.

Multi-Blade Applications
Geometry, topology, and mesh generation support has been added for multi-blade applications such as: • • Splitters Tandem vanes

Geometry
• • • • • • Auto-compute inlet and outlet points that lie between adjacent stages Hub tip capability Linearly varying tip offsets Blade biasing between periodic surfaces Blade surfaces now are represented in a manner similar to BladeModeler (creates blade surfaces in the stream wise direction rather than the span wise direction) Writing and reading periodic surfaces

Topology
• • • Support for C-Grid topology pattern at leading/trailing edges Support for sharp leading and trailing edges The topology (and mesh) near the leading and trailing edges can now be separated from the leading and trailing edge blade geometry (to reduce mesh skew on high twist blades). Automatic mesh element size matching across periodic interfaces

Mesh Generation
• Support for generating mesh in double precision for y+ values less than 1

Layers
• Generate, update and display mesh statistics

Beta Features
To enable beta features, select Edit > Options then, in the Options dialog box that appears, select TurboGrid in the tree view, and then select the Enable Beta Features check box. • Support for Re-parameterized Blade Profiles

Page 2

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

ANSYS TurboGrid Overview: What’s New

Re-parameterization of blade profiles is a tool for reducing the "hour glass" effect when a blade surface is created. To use this feature, select Create > Re-parameterized Blade Profiles. This tool will create a new set of profiles where the points are positioned to minimize the hour glass effect. It is used in conjunction with streamwise ruled surface lofting. An example of the hour glass effect is illustrated below. The cylinder on the left has the hour glass effect; the cylinder on the right does not.

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 3

ANSYS TurboGrid Overview: What’s New

Page 4

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher
• • • • • Introduction (p. 5) Starting the CFX Launcher (p. 5) The Launcher Interface (p. 6) Automatic Application Search (p. 10) Launcher Customization (p. 10)

Introduction
The CFX Launcher is provided to make it easy to run all the modules of ANSYS CFX without having to use a command line. The launcher provides the following functionality: • • • • • Setting up the working directory. Launching installed CFX and ANSYS products. Access to various other tools, including a command window which allows you to run other utilities. Access to the online help and other useful information. Extensive customization capability to allow you to change the behavior of the launcher and start your own applications.

Starting the CFX Launcher
To run the CFX launcher on a UNIX machine, type <CFXROOT>/bin/cfxlaunch in a terminal window. To run the CFX launcher on a Windows machine, you can do any one of the following: • • • Double-click the ANSYS TurboGrid 11.0 icon on the desktop (if one exists). Select All Programs > ANSYS 11.0 > CFX > ANSYS TurboGrid 11.0 from the Start menu. In a DOS window which has its path set up correctly to run ANSYS TurboGrid, type cfxlaunch (otherwise, you will need to type the full pathname of the cfxlaunch command).
Page 5

ANSYS TurboGrid Introduction
ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher: The Launcher Interface

The Launcher Interface
The layout of the CFX launcher is shown below:
Figure 1
Menu Bar

CFX Launcher
Tool Bar Working Directory Selector

Output Window

Open Windows Explorer at the Working Directory (Windows only).

The CFX launcher consists of a menu bar, a tool bar for launching applications, a working directory selector, and an output window where messages can be displayed. On Windows platforms, an icon to start Windows Explorer in the working directory appears next to the directory selector. Each main part of the launcher is described below: • • • • Menu Bar (p. 6) Tool Bar (p. 9) Working Directory Selector (p. 9) Output Window (p. 10)

Menu Bar
The CFX launcher menus are described briefly in the following table, and in more detail following the table.

File Menu (p. 7) Edit Menu (p. 7) CFX Menu (p. 7)

Allows you to save the contents of the text output window and close the launcher. Allows you clear the text output window, find text in the text output window and set options for the launcher. Allows you to run installed CFX products.

Page 6

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher: The Launcher Interface

ANSYS Menu (p. 8) Show Menu (p. 8)

Allows you to run other ANSYS products if you have them installed. Allows you to show system, installation and other information.

Tools Menu (p. 8) Allows you to access the license manager, a command line for running other CFX utilities, and a text editor. User Menu (p. 9) This is provided as an example. You can add your own application to this menu or create new menus.

Help Menu (p. 9) Allows you to access the online help system. File Menu Save As... Choosing this option will allow you to save the contents of the output window to a file. Quit Choosing this item will shut down the launcher. Any programs already launched will continue to run. Edit Menu Allows you clear the text output window, find text in the text output window and set options for the launcher. Clear This will clear the output window. Find This will display a dialog box where you can search the text in the output window. Options The Options dialog box allows you to change the appearance of the launcher. GUI Style There are a number of GUI styles that you can chose from, and are available on all platforms. For example, choosing Windows will change the look and feel of the GUI to resemble that of a Windows application. You can select from Windows, Motif, Motif Plus, SGI, Platinum and CDE (Solaris) styles. Once you have selected a style, click Apply to test. Application Font and Text Window Font The button to the right of Application Font sets the font used anywhere outside the text output window. The button to the right of Text Window Font applies only to the text output window. Clicking either of these buttons will open the Select Font dialog box. CFX Menu ANSYS TurboGrid Choosing this option will run ANSYS TurboGrid, with the working directory as specified in Working Directory Selector (p. 9).

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 7

CFX Launcher: The Launcher Interface

Other CFX Applications The launcher will search for installed CFX applications (e.g., ANSYS CFX-Pre, ANSYS CFX-Post) and provide a menu entry to launch each application. If an application is not found, you can add it. For details, see Launcher Customization (p. 10). ANSYS Menu Any version of ANSYS and ANSYS Workbench that you have installed can be launched from this menu. If an application is not found you can add it. For details, see Launcher Customization (p. 10). Installation This will show information about the version of ANSYS TurboGrid that you are running. All Choosing this option will display all of the available information, including information about your system, installation and variables. System Choosing this option will display information about the ANSYS TurboGrid installation and the system on which it is being run. Variables Choosing this option will display the values of all the environment variables that are used in ANSYS TurboGrid. Patches Choosing this option will display the output from the command cfx5info -patches. This provides information on patches that have been installed after the initial installation of ANSYS TurboGrid. Acknowledgements This will display a list of acknowledgements. Terms This will display the license terms under which ANSYS TurboGrid is provided. Tools Menu Allows you to access license management tools and a command line for running other ANSYS CFX utilities. ANSYS License Manager If ANSYS License Manager is installed, a menu entry to launch it will appear in the Tools menu. Command Line Choosing this option will start a command window from which you can run any of the ANSYS TurboGrid commands via the command line interface. The command line will be set up to run the correct version of ANSYS TurboGrid and the commands will be run in the current working directory.

Show Menu

Page 8

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher: The Launcher Interface

On Windows, if you do not use the Tools > Command Line command to open a command window, then you will have to either type the full path of the executable in each command, or explicitly set your system path to include the <CFXROOT>/bin directory. You may want to start components of ANSYS TurboGrid from the command line rather than by clicking the appropriate button on the CFX launcher for the following reasons: • • • ANSYS TurboGrid contains some utilities (e.g., a parameter editor) which can only be run from the command line. You may wish to specify certain command line arguments when starting up a component so that it starts up in a particular configuration. If you are having problems with a component, you may be able to get a more detailed error message by starting the component from the command line than you would get if you started the component from the launcher. If you start a component from the command line, any error messages produced are written to the command line window.

Edit File Opens a browser to edit the text file of your choice in a platform-native text editor. Which text editor is called is controlled by the settings in <CFXROOT>/etc/launcher/shared.ccl. User Menu The User menu is provided as an example. You can add your own applications to this menu, or create new menus. For details, see Launcher Customization (p. 10). The Help menu is described in Accessing Online Help (p. 17).

Help Menu

Tool Bar
The toolbar contains shortcuts to the main components of CFX, for example ANSYS TurboGrid, ANSYS CFX-Pre, ANSYS CFX-Solver Manager and ANSYS CFX-Post. Pressing any of the buttons will start up the component in the specified working directory. The equivalent menu entries for launching the components also show a keyboard shortcut that can be used to launch the component.

Working Directory Selector
When running the ANSYS TurboGrid software, all the files created will be stored in the working directory. If you run the software on UNIX, the working directory is the directory that was current when you started the software. If you start the software on Windows, the launcher shows the directory selected the last time it was used. To change the working directory, you can do any of the following: • • Type the directory name into the box and press <Enter>. Click on the down-arrow icon ( ) next to the directory name. This will bring up a list of recently used directories to pick from. Click on the Browse... want. icon to bring up a file browser to select the directory that you

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 9

CFX Launcher: Automatic Application Search

Output Window
The output window is used to display information from commands in the Show menu. You can right-click in the output window to show a shortcut menu with the following options: • • • • • Find...: Displays a dialog box where you can enter text to search for in the output. Select All: Selects all the text. Copy Selection: Copies the selected text. Save As...: Saves the output to a file. Clear: Clears the output window.

Automatic Application Search
The CFX Launcher automatically searches for installations of CFX and ANSYS products including the license manager. Depending on the application, the search includes common installation directories, directories pointed to by environment variables associated with ANSYS CFX and ANSYS products, and the Windows registry. In the unlikely event that a product is not found, you can configure the CFX Launcher using the steps outlined in Launcher Customization (p. 10).

Launcher Customization
Many parts of the launcher are driven by CCL commands contained in configuration files. Some parts of the launcher are not editable (such as the File, Edit and Help menus), but others parts allow you to edit existing actions and create new ones (for example, launching your own application from the User menu). The following sections outline the steps required to configure the launcher. The configuration files are located in the <CFXROOT>/etc/launcher/ directory (where <CFXROOT> is the path to your installation of ANSYS TurboGrid). You can open these files in any text editor, but we do not recommend that you edit any of the configuration files provided by ANSYS CFX, other than the User.ccl configuration file.

CCL Structure
The configuration files contain CCL objects that control the appearance and behavior of menus and buttons that appear in the launcher. There are three types of CCL objects: GROUP, APPLICATION and DIVIDER objects. The fact that there are multiple configuration files is not important; applications in one file can refer to groups in other files. An example of how to add a menu item for the Windows calculator to the launcher is given in Example: Adding the Windows Calculator (p. 13).

Page 10

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher: Launcher Customization

GROUP

GROUP objects represent menus and toolbar groups in the launcher. Each new GROUP creates

a new menu and toolbar. Nothing will appear in the menu or toolbar until you add
APPLICATION or DIVIDER objects to the group. An example of a GROUP object is given

below:
GROUP: CFX Position = 200 Menu Name = &CFX Show In Toolbar = Yes Show In Menu = Yes Enabled = Yes END

The group name is set after the colon. In this case, it is “CFX”. This is the name that APPLICATION and DIVIDER objects will refer to when you want to add them to this group. This name should be different to all other GROUP objects.
Position refers to the position of the menu relative to others. The value should be an integer between 1 and 1000. Groups with a higher Position value, relative to other groups, will have their menu appear further to the right in the menu bar. Referring to , CFX has a lower position value than the ANSYS group. The File and Edit menus are always the first two menus and the Help menu is always the last menu.

The title of the menu is set under Menu Name (this menu has the title CFX). The optional ampersand is placed before the letter that you wish to act as a menu accelerator (i.e., <Alt>+C will display the CFX menu). You must be careful not to use an existing menu accelerator. The creation of the menu or toolbar can be toggled by setting the Show in Menu and Show in Toolbar options to Yes or No respectively. For example, you may want to create a menu but not an associated toolbar.
Enabled sets whether the menu/toolbar is available for selection or is greyed out. Set

the option to No to grey it out. APPLICATION
APPLICATION objects create entries in the menus and toolbars that will launch an

application or run a process. Two examples are given below with an explanation for each parameter. The first example creates a menu entry in the Tools menu that opens a command line window. The second example creates a menu entry and toolbar button to start ANSYS CFX-Solver Manager.
APPLICATION: Command Line 1 Position = 300 Group = Tools Tool Tip = Start a window in which CFX commands can be run Menu Item Name = Command Line Command = <windir>\system32\cmd.exe Arguments = /c start Show In Toolbar = No Show In Menu = Yes Enabled = Yes OS List = winnt END APPLICATION: CFXSM Position = 300 Group = CFX Tool Tip = Launches ANSYS CFX-Solver Manager Menu Item Name = CFX-&Solver Manager Command = cfx5solve Show In Toolbar = Yes Show In Menu = Yes Enabled = Yes Toolbar Name = ANSYS CFX-Solver Manager
ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 11

CFX Launcher: Launcher Customization
Icon = LaunchSolveIcon.xpm Shortcut = CTRL+S END

• •

The application name is set after the colon, in the first example it is “Command Line 1”. This name should be different to all other APPLICATION objects.
Position: sets the relative position of the menu entry. The value should be an integer between 1 and 1000. The higher the value, relative to other applications that have the same group, the further down the menu or the further to the right in a toolbar the entry will appear. If you do not specify a position, the object assumes a high position value (so it will appear at the bottom of a menu or at the right of a group of buttons). Group: sets the GROUP object to which this application belongs. The value must correspond to the name that appears after “GROUP:” in an existing GROUP object. The menu and/or toolbar entry will not be created if you do not specify a valid group name. The GROUP object does not have to be in the same configuration file. Tool Tip: displays a message when the mouse pointer is held over a toolbar button. In the ‘Command Line 1’ example above, the Tool Tip entry is not used since a toolbar button is not created. This parameter is optional. Menu Item Name: sets the name of the entry that will appear in the menu. If you do not specify a name, the name is set to the name of the APPLICATION: object. The optional

ampersand is placed before the letter that you wish to have act as a menu accelerator (i.e <Alt>+c then “s” will start ANSYS CFX-Solver Manager. <Alt>+c selects the CFX menu and “s” selects the entry from the menu). You must be careful not to use an existing menu accelerator. •
Command: contains the command to run the application. The path can be absolute (i.e., use a forward slash to begin the path on UNIX, or a drive letter on Windows). If an absolute path is not specified, a relative path from <CFXROOT>/bin/ is assumed. If no command is specified, the menu item/toolbar button will not appear in the CFX launcher. The path and command are checked when the CFX launcher is started. If the path or command does not exist, the menu item/toolbar button will not appear in the launcher. You may find it useful to include environment variables in a command path. For details, see Including Environment Variables (p. 13). Arguments: specifies any arguments that need to be passed to the application. The arguments are appended to the value you entered for Command. You do not need to

include this parameter as there are no arguments to pass. You may find it useful to include environment variables in the arguments. For details, see Including Environment Variables (p. 13). Distinct arguments are space-separated. If you need to pass an argument that contains spaces (e.g., a Windows file path) you should include that argument in double quotes, for example:
Arguments = “C:\Documents and Settings\User” arg2 arg3

• • •

Show In Toolbar: determines if a toolbar button is created for the application. This

parameter is optional with a default value of Yes.
Show In Menu: determines if a menu entry is created for the application. This parameter is optional with a default value of Yes. Enabled: allows you to grey out the menu entry and toolbar button. Set this parameter to No to grey out the application. This parameter is optional with a default value of Yes.

Page 12

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

CFX Launcher: Launcher Customization

OS List is an optional parameter that allows you to set which operating system the application is suitable for. If OS List is not supplied, the launcher will attempt to create the menu item and toolbar button on all platforms. For example, the command to open a command line window varies depending on the operating system. In the ‘Command Line 1’ example above, the application only applies to Windows platforms. To complete the OS coverage, the launcher configuration files contain more ‘Command Line’ applications that apply to different operating systems. OS List can contain the following values: winnt (Windows, including Windows XP), aix (IBM), hpux, (HP), hpux-ia64 (64-bit HP), osf (Compaq Alpha), solaris (Sun), irix (SGI), linux, linux-ia64 (64-bit Linux). Toolbar Name: sets the name that appears on the toolbar button. This parameter is optional (since you may only want to show an icon). Icon: specifies the icon to use on the toolbar button and in the menu item. The path can

• •

be absolute (i.e., use a forward slash to begin the path on UNIX, or a drive letter on Windows). If an absolute path is not specified, a relative path from <CFXROOT>/etc/icons is assumed. The following file formats are supported for icon image files: Portable Network Graphics (png), Pixel Maps (ppm, xpm) and Bitmaps (bmp). Other icons used in the launcher are 32 pixels wide and 30 pixels high. This parameter is optional. If it is not included, an icon will not appear. •
Shortcut: specifies the keyboard shortcut that can be pressed to launch the application. You must be careful not to use a keyboard shortcut that is used by any other APPLICATION object.

Including Environment Variables In can be useful to use environment variables in the values for some parameters. You can specify an environment variable value in any parameter by including its name between the < > symbols. In the ‘Command Line 1’ example above, <windir> is used in the Command parameter so that the command will work on different versions of Windows. <windir> will be replaced with the value held by the windir environment variable. The Command and Argument parameters are the only parameters that are likely to benefit from using environment variables. Environment variables included in the Arguments parameter are expanded before they are passed to the application. DIVIDER
DIVIDER objects create a divider in a menu and/or toolbar (see the Tools menu for an example). An example of the CCL for DIVIDER objects is shown below.
DIVIDER: Tools Divider 1 Position = 250 Group = Tools OS List = winnt, aix, hpux, hpux-ia64, irix, linux, linux-ia64, osf, solaris END

The Position, Group and OS List parameters are the same as those used in APPLICATION objects. For details, see APPLICATION (p. 11).

Example: Adding the Windows Calculator
The following CCL is the minimum required to add the Windows calculator to the launcher:
GROUP: Windows Apps Menu Name = Windows END

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 13

CFX Launcher: Launcher Customization
APPLICATION: Calc Group = Windows Apps Command = <windir>\system32\calc.exe Toolbar Name = Calc END

Although the parameter Toolbar Name is not strictly required, you would end up with a blank toolbar button if it were not set.

Page 14

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Help On Help
This chapter discusses: • • • • • • Introduction (p. 15) ANSYS TurboGrid Documentation Structure (p. 15) Document Conventions (p. 16) Accessing Online Help (p. 17) Using the Help Browser Index (p. 17) Using the Search Feature (p. 18)

Introduction
The ANSYS TurboGrid online help is in chm format (Windows) or jar format (UNIX), accessible through ANSYS TurboGrid. The tutorials are available in html format, and all documentation is available in PDF format, on the ANSYS Customer Portal. For links to this website, or to contact a CFX representative, see Contact Information (p. 19 in "ANSYS TurboGrid Introduction").

ANSYS TurboGrid Documentation Structure
The ANSYS TurboGrid documentation consists of the following:

Book installation guide ANSYS TurboGrid Introduction ANSYS TurboGrid User’s Guide ANSYS TurboGrid Reference Guide

Description how to install ANSYS TurboGrid how to run ANSYS TurboGrid how to use ANSYS TurboGrid complete details for every menu item, advanced user topics, details of CCL objects and parameters A set of tutorials that demonstrate the workflow in ANSYS TurboGrid

PDF Name xtintr11.pdf xtuser11.pdf xtref11.pdf

ANSYS TurboGrid Tutorials

xttutr11.pdf

ANSYS TurboGrid Introduction
ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 15

Help On Help: Document Conventions

Document Conventions
This section describes the conventions used in this document to distinguish between text, computer file names, system messages, and input that you need to type.

File and Directory Names
File names and directory names appear in a plain fixed-width font (e.g. /usr/lib). Note that on UNIX, directory names are separated by forward slashes (/) but on Windows, back slashes are used (\). For example, a directory name on UNIX might be /CFX/bin whereas on a Windows system, the same directory would be named \CFX\bin.

User Input
Input to be typed verbatim is shown in the following convention:
mkdir /usr/local/cfx

Input Substitution
Input substitution is shown in the following convention:
cfx5 -def <def_file>

you should actually type cfx5 -def, and substitute a suitable value for <def_file>.

Optional Arguments
An optional argument is shown in the following convention:
mount -r -F hsfs\ /dev/dsk/c0t6d0s0 /cdrom

could be entered as shown, or as
mount -r -F hsfs /dev/dsk/c0t6d0s0 /cdrom

However, on a Windows machine, you must enter the whole command as one command; continue typing if the command is too long to fit on a line, and press <Enter> at the end.

Operating System Names
When we refer to objects that depend on the type of system being used, we will use one of the following symbols in the text:
<os> refers to the short form of the name which ANSYS CFX 11.0 uses to identify the

operating system in question. <os> will generally be used for directory names where the contents of the directory depend on the operating system but do not depend on the release of the operating system or on the processor type. Wherever you see <os> in the text you should substitute with the operating system name. The correct value for a UNIX system can be determined by running:
<CFXROOT>/bin/cfx5info -os

Page 16

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Help On Help: Accessing Online Help

On a Windows system, <os> will always be windows.
<arch> refers to the long form of the name which ANSYS CFX 11.0 uses to identify the

system architecture in question. <arch> will generally be used for directory names where the contents of the directory depend on the operating system and on the release of the operating system or the processor type. Wherever you see <arch> in the text you should substitute the appropriate value for your system, which can be determined by running the UNIX command:
<CFXROOT>/bin/cfx5info -arch

Accessing Online Help
There are several different ways to access the online help system: • • Select one of the appropriate commands from the Help menu of the CFX launcher or ANSYS TurboGrid. Click on a feature of the ANSYS TurboGrid interface to make it active and, with the mouse pointer over the feature, press the <F1> key (the <Help> key on Sun workstations) for context-sensitive help. Not every area of the interface supports context-sensitive help.

Adjusting Font Sizes in Online Help
If you are viewing the help in UNIX, you can increase the font size on your display by holding down the <Ctrl> key and tapping +. If you are viewing the help in Windows, you can increase/decrease the font size by holding down the <Ctrl> key and sliding the mouse wheel up or down.

Using the Help Browser Index
The Index tab of the help browser allows you to search for index terms and display the associated topics. To find a topic using the index: 1. In the field at the top, type the first few letters of a keyword. The keyword list scrolls to the relevant keywords as you type. As keywords are selected, one or more topic titles appears in the topics list below. 2. Select a topic from the list, then click the Display button (Windows) or Open button (UNIX). Results from the Help index will not be exhaustive, so you should consider using the Search function as well. See Using the Search Feature (p. 18).

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Page 17

Help On Help: Using the Search Feature

Using the Search Feature
The Search tab of the help browser allows you to perform searches through the online help. If you are running on Windows, you can search for a phrase by wrapping the phrase in quotes. In this case, you may want to turn off the Match similar words option to avoid returning extra search results for phrases made from similar words.

Page 18

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Contact Information
• • How to Contact ANSYS Customer Service (p. 19) ANSYS Customer Portal (p. 20) Technical Support for ANSYS products is provided either by ANSYS, Inc. directly or by one of our ANSYS Support Providers. Please check with the ANSYS Support Coordinator (ASC) at your company to determine who provides support for your company. Support provider contact information is available from the ANSYS Customer Service page on the ANSYS Website ( www.ansys.com) under Solutions > Services and Support > Customer Service. The direct url is : http://www.ansys.com/services/ss-customer.asp. If your support is provided by ANSYS, Inc., please use the contact information listed in the following sections.

How to Contact ANSYS Customer Service
ANSYS aims to provide high quality software, documentation and product support. To help achieve this goal, we maintain technical support centers around the world. If you have problems contacting any of our offices, please contact:

Web: Toll-Free Telephone: Telephone: Fax: Email

Select the Support tab on the ANSYS Customer Portal (http://www1.ansys.com/customer) 1.800.711.7199 724.514.3600 724.514.5096 techsupp@ansys.com

To help us respond quickly to your question, we will request the following information from you: • • • Customer Information (your name and company name) Product & Platform information (computer type & operating system; product name & version; detailed description of the question/problem) Relevant Files
Page 19

ANSYS TurboGrid Introduction
ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Contact Information: ANSYS Customer Portal

Please provide any files relevant to your problem. If you send files via email from a UNIX system, please compress and uuencode the files before sending them. If you have system-related problems once the software has been installed, information about any local customization of ANSYS TurboGrid which may have taken place can be obtained as follows: Run the CFX launcher, choose the Show > Show All command from the menu, and save the messages to a file. Include this file with your email.

ANSYS Customer Portal
The ANSYS Customer Portal is available from the ANSYS Website ( www.ansys.com) by clicking CUSTOMER AREA, then clicking ANSYS Customer Portal on the page that appears. You can also go there directly: http://www1.ansys.com/customer/.

Page 20

ANSYS TurboGrid Introduction. ANSYS TurboGrid Release 11.0. © 2003-2006 ANSYS Canada Ltd. All rights reserved. Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Index
A
accessing online help 17 ANSYS contact via internet 19 ANSYS TurboGrid customer support 19 features 1

L
Launcher 5 Launcher Show Menu 8

O
online help accessing 17 increasing font sizes for 17

C
command line 8 windows 8 contact information 19 customer support 19

S
show system information 8

F W
features 1 font sizes increasing in the online help 17 what’s new 1 working directory 9

H
help 17

ANSYS TurboGrid Introduction

Page i

Index: W

Page ii

ANSYS TurboGrid Introduction

Index: W

ANSYS TurboGrid Introduction

Page iii

Index: W

Page iv

ANSYS TurboGrid Introduction