ANSYS Workbench1
ANSYS Workbench1
ANSYS Workbench1
ANSYS Workbench
Products Release Notes
ANSYS Workbench Release 10.0
KS302-RN
August 2005
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
© 2005 SAS IP, Inc. All rights reserved. Unauthorized use, distribution or duplication is prohibited.
ANSYS, ANSYS Workbench, CFX, AUTODYN, and any and all ANSYS, Inc. product and service names are registered trademarks or trademarks of ANSYS, Inc.
or its subsidiaries located in the United States or other countries. ICEM CFD is a trademark licensed by ANSYS, Inc. All other trademarks or registered
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. and ANSYS Europe, Ltd. are UL registered ISO 9001:2000 Companies.
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.
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
vi
ANSYS Workbench Products Release Notes for
10.0
Solution Status Monitor Available for Simulation and DesignXplorer DOE
Solutions
A Solution Status Monitor, located in the Windows system tray, allows users to monitor the progress of local
and remote solutions from Simulation and DesignXplorer DOE.
• Define a custom Isometric viewpoint, as well as define the "up" direction for orientation on screen.
• Flip through Previous and Next graphics viewpoints like history in a web browser.
• Control animation graphically in the new Animation tab.
• View interactive Capped Isosurfaces using a new toolbar.
• Customize the new Legend using a specialized dialog box.
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
ANSYS Workbench Products Release Notes for 10.0
Mid-Surface Feature
The Mid-Surface feature allows you to create surface bodies that are mid-way between pairs of solid body faces
of uniform thickness. The body's thickness is automatically propagated to the resultant surface bodies. The faces
can be manually selected, or an automatic mode allows you to set a thickness range and then automatically
detect matching face pairs.
Primitive Library
DesignModeler allows you to create models quickly by defining primitive shapes that do not require sketches.
All the primitive features (sphere, box, parallelepiped, cylinder, cone, prism, pyramid, torus, and bend) require
several point and/or direction inputs. These inputs may be defined by either specifically typing in the coordinates
or components, or by selecting geometry onscreen. Also, each primitive contains a base plane that identifies
the coordinate system in which the primitive is defined.
Scripting API
The Scripting Application Program Interface (API), accessible via the Run Script button in the File menu, has
been expanded to include support for Plane features.
1–10 ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
Section : CFX-Mesh Release Notes
STEP Import
DesignModeler now supports the Reader for STEP (Standard for the Exchange of Product model data) on both
the Windows and UNIX platforms. Geometry options for STEP within DesignModeler include Simplify Topology,
Tolerance, and Replace Missing Geometry.
Symmetry Feature
The new Symmetry feature takes either all the bodies or selected bodies of the model as input and accepts up
to three symmetry planes. You can choose either full or partial models to work with. If a full model is used, the
selected symmetry planes will slice the model and only a portion of the model will be retained. The feature will
operate on solid and surface bodies. It is recommended that you do not change the symmetry plane selection
after a model has been transferred to Simulation.
Display Overview
You can now display an overview of features by selecting the appropriate object in the Tree View. For example,
all point, line and triangular mesh controls can be displayed simultaneously if you highlight the Controls entry
in the Tree View. A similar overview is available for Regions, Virtual Topology, Spacings, Periodicity and Inflation.
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc. 1–3
ANSYS Workbench Products Release Notes for 10.0
Hide Option
Composite 2D Regions and Solid Bodies can now be hidden from view as an option when you right-mouse-click
on an object in the Tree View. This not only removes the objects from view, but also means that they cannot be
selected. For example, if the outer surfaces of a geometry are grouped into a Composite 2D Region and then
hidden, the internal surfaces can be still be seen and appropriate selections made, avoiding the need to use the
selection rectangles.
1–4 ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
Section : Simulation Release Notes for 10.0
• Animation. For sequenced results at release 9.0, animation was only done at the currently selected load
step. True multi-step animation was therefore not possible. This has been greatly enhanced at release
10.0 to support true multi-step animation across all steps or just a subset.
• Result Minimum and Maximum over Time. At release 9.0, only results at the current sequence number
were displayed. If a user wanted to find the minimum or maximum over all the time steps, he would be
forced to look at each step individually. At release 10.0, the minimum and maximum values across the
loads steps are computed and displayed in the Timeline window, greatly facilitating the identification of
critical load steps and the review of results at that step.
• Reviewing Results at Different Sequenced Steps. At release 9.0, if the database was solved and the user
choose a different step in the sequence controller, the program would automatically recalculate the result.
This behavior has been changed at release 10.0. After selecting a different sequence number, to calculate
the result, the user simply needs to choose Retrieve Results in a context menu available by clicking the
right mouse button in either the Timeline window or Tabular Data window. This was done to be consistent
with transient results and also to avoid potentially unexpected long delays from the auto calculation that
was present in release 9.0 on large models.
• Resuming Solved Sequenced Databases From Release 9.0 into Release 10.0. Since the minimum and
maximum values over time were not calculated at release 9.0, the Timeline window will be empty. In order
to calculate the histories, users need to simply change the sequence number on the result and choose
either Evaluate Results or Solve from the Result object context menu. Users wishing to calculate the
histories for all results can simply select all the results, perform a Clean operation (on the results only, not
on the solution), and choose Solve.
Geometry Enhancements
The following geometry enhancements have been made at release 10.0:
• Generalized Plane Strain Behavior Added as 2-D Option. Generalized Plane Strain is now available
as a 2-D option for structural and shape simulations. Generalized plane strain assumes a finite deformation
domain length in the z direction, as opposed to the infinite value assumed for standard plane strain.
• ANSYS Element Control. A new Element Control setting has been added to the Details View of a Geo-
metry object that allows users to manually control the underlying ANSYS element options (KEYOPTS) for
the geometry, or have the options program controlled (using the equivalent of the ETCON,SET ANSYS
command).
• OneSpace Designer Modeling 2005. The reader/plug-in for OneSpace Designer Modeling 2005, revision
13.20 on the Windows platform is now supported.
• STEP Reader Support. The reader for STEP (STandard for the Exchange of Product model data) on both
the Windows and UNIX platform is now supported.
• Suppress All Other Bodies. A Suppress All Other Bodies option has been added that allows users to
unsuppress only selected bodies.
Meshing Enhancements
The following meshing enhancements have been made at release 10.0:
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc. 1–5
ANSYS Workbench Products Release Notes for 10.0
• Gap Tool Expands Gap Sizing Capability. All gap sizing controls, used in electromagnetic simulations,
are now included within a Gap Tool object. The gap sizing capability, introduced at the previous release,
is more robust because of an improved algorithm. It has been expanded to include a control for identifying
face/edge or face/face pairs, and controls for defining multiple gaps within a range specified by the user.
The range can be specified as numerical values or as CAD parameters.
• Contact Sizing Support for Face/Edge Contact. The Contact Sizing tool now has the capability for
creating elements from face/edge as well as face/face contact regions.
• Automatic Virtual Topology. The creation of virtual cells can now be accomplished automatically for
surface bodies in Simulation. Upon inserting a Virtual Topology object in the tree, users can specify cri-
terion in the Details View for creating virtual cells. After choosing the Generate Virtual Cells context
menu option, Virtual Cell objects that match the criterion are automatically inserted in the tree.
• Hard Divisions. An Edge Behavior option has been added to the Sizing control that allows users to
define hard divisions or element size on a body face or edge. Using hard divisions ignores any
Curv/Proximity or Element Size global settings.
• Method Options for Uniform Meshing. Options have been added to the Method mesh control tool that
creates a uniform mesh of all quad elements or a combination of quad and triangular elements, over the
entire part of a selected surface body. The methods are governed by a Defeaturing Tolerance and an
Element Size specification value that is a user input.
• Renaming Mesh Control Tools. Any of the mesh control tools can be renamed to include the name of
the part or body by using a new Rename Based on Definition right mouse button context menu option.
For example, a Refinement tool scoped to a body named Tube can be renamed to Refinement on Tube
using this new option.
Loads/Supports Enhancements
The following loads/supports enhancements have been made at release 10.0:
• Radiation Thermal Load. A new Radiation load has been added for thermal analyses, applicable to 3-D
model faces and 2-D model edges. Adjustable settings in the Details View include Emissivity and Ambient
Temperature.
• ANSYS CFX Load Transfer. A one way transfer of fluid-structure boundary pressure loads from an ANSYS
CFX solution on to the corresponding Simulation model faces is now possible. These surfaces forces are
imported as pressure loads in Simulation.
• Bolt Load Scoping Expanded. Bolts can now be applied directly to bodies by leveraging a coordinate
system to determine the cutting plane.
Solution Enhancements
The following solution enhancements have been made at release 10.0:
• Remote Unix Settings Included in WB Cluster The remote Solver Process Settings included in the
Details View of the Solution object have been streamlined to include all Unix settings under the WB
Cluster.
• Weak Spring Stiffness Value Control. Users now can control the amount of weak spring stiffness for a
solution. Prior releases relied strictly on a value supplied by the program. Now, users can add higher
stiffness values to compensate for values that may be too weak to enable a solution or cause rigid body
motion, or they can merely experiment with different stiffness values to study the impact on their simula-
tion.
1–6 ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
Section : FE Modeler Release Notes for 10.0
• ANSYS Memory Options. An option has been added in the Details View under Process Settings for
changing the workspace and database memory for a solution.
Results Enhancements
The following results enhancements have been made at release 10.0:
• Manual Modal Frequency Sweep Range Added to Harmonic Tool. A control has been added to the
Harmonic Tool that allows users specifying Mode Superposition, the option of manually inputting the
modal frequency sweep range for a harmonic simulation.
• Strain-Life Fatigue. Strain-life low-cycle fatigue studies that assume local plastic stress/strain are now
included in the fatigue capabilities of Simulation. A new Hysteresis result has been added to support this
capability.
• Hide All Other Bodies. An ease of use feature has been added that allows display of only those bodies
that belong to a specific contact region. Choosing Hide All Other Bodies from a right mouse button click
on a Contact Region object enables this feature.
• Collapse Viewing Controls. Controls have been added under View in the main menu that facilitates
managing objects in the Simulation tree. When Collapse to Model is chosen, all objects collapse under
their parent Model object. When Collapse to Environment is chosen, all objects collapse under their
parent Environment object.
• Objects Reference Help Pages. The Simulation Help includes a reference specification page that represents
each object that can display in the Simulation tree view.
ABAQUS Support
FE Modeler now allows the user to link to ABAQUS input data and provides support for certain ABAQUS keywords
and element types.
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc. 1–7
ANSYS Workbench Products Release Notes for 10.0
Extended DOE
Via the Options control panel in DesignXplorer, you can now select an enhanced template of points for performing
a Design of Experiment (DOE) study instead of the default template. Designed for problems with continuous
parameters amenable to be fitted by response surfaces, the extended DOE allows you to select either of the
optimal designs—Rotatable, Face-Centered, G-Optimal, VIF-Optimal, User-Defined, and Auto. If there is only one
input parameter, the enhanced and the original templates are the same.
• Mesh Morphing Type: Sets the method of mesh morphing in DesignXplorer VT to either the classic or
central composite design matrix method.
ROMS Method
The Reduced Order Model Sweep (ROMS) is a new variational technology approximation method in the ANSYS
Workbench for 2D and 3D models. ROMS provides more accurate parametric results, throughout the hypercube
1–8 ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
Section : Engineering Data for 10.0
results space, with larger variation ranges for the input variables and less limitation for the input variables and
solution options.
While the default approximation type is still Auto, which automatically picks Taylor or Pade, the ROMS method
introduces two new choices: Solver Type and Out-of-core processing. All methods can be set via the Options
control panel. Note that modal analysis is not supported by the ROMS method. ROMS is intended for use with
parameterization of linear static analysis. As a result, all optimization (Six Sigma Analysis, Robust Design, Goal
Driven Optimization, GA, NLPQL, and Monte-Carlo sampling) in DesignXplorer is compatible.
In order to accomplish generic interaction between process level components, an XML instruction language for
DesignXplorer has been developed. Using this language, it is possible to chain a sequence of actions (each may
occur in a separate executable or code component) together to define a full process. This process defines a single
DOE point, which is treated as a standard Simulation design point in a traditional DesignXplorer DOE study. As
a result, all optimization (Six Sigma Analysis, Robust Design, Goal Driven Optimization, GA, NLPQL, and Monte-
Carlo sampling) in DesignXplorer is compatible with a user-defined process.
ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc. 1–9
ANSYS Workbench Products Release Notes for 10.0
1–10 ANSYS Workbench Products Release Notes . ANSYS Workbench Release 10.0 . KS302-RN . © SAS IP, Inc.
Getting Started with
ANSYS Workbench
Getting Started with ANSYS
Workbench
Table of Contents
Welcome to the ANSYS Workbench ................................................................................................ 1–1
Using Help .............................................................................................................................. 1–2
Workbench Projects and Databases........................................................................................ 1–3
Start Page Navigation ............................................................................................................. 1–4
Software Licensing............................................................................................................ 1–6
Project Page Navigation.......................................................................................................... 1–6
Headlines and Messages .................................................................................................. 1–9
Workbench Tabs................................................................................................................... 1–10
Workbench Interface............................................................................................................. 1–10
Workbench Graphics Controls ......................................................................................... 1–10
Rotate ............................................................................................................................. 1–10
Pan ................................................................................................................................. 1–10
Zoom .............................................................................................................................. 1–10
Box Zoom ....................................................................................................................... 1–11
Zoom to Fit ...................................................................................................................... 1–11
Magnifier Window ........................................................................................................... 1–11
Previous View ................................................................................................................. 1–11
Next View........................................................................................................................ 1–11
Isometric View ................................................................................................................ 1–11
Image Capture ................................................................................................................ 1–12
Capped Isosurfaces ........................................................................................................ 1–12
Results Animation ........................................................................................................... 1–13
Customizing Result Legend............................................................................................. 1–14
Workbench Windows Manager ........................................................................................ 1–16
Restore Original Window Layout ..................................................................................... 1–16
Window Manager Features ............................................................................................. 1–16
Workbench Behavior ............................................................................................................ 1–17
Solution Status Monitor ................................................................................................... 1–18
Menu Bar ........................................................................................................................ 1–20
Tree View........................................................................................................................ 1–21
List View ......................................................................................................................... 1–23
Progress Pane ................................................................................................................ 1–23
Tray Context Menu .......................................................................................................... 1–24
Workbench Options .............................................................................................................. 1–24
Workbench Limitations ......................................................................................................... 1–28
Technical Support ................................................................................................................. 1–28
If you have experience with previous standalone versions of ANSYS DesignSpace, ANSYS AGP (Analysis Geometric
Processor), or ANSYS DesignXplorer, you will discover that these applications work in the same way as before.
Within the Workbench environment however, they are referred to more as task modules. ANSYS DesignSpace
is referred to as Simulation, ANSYS AGP is referred to as DesignModeler, and ANSYS DesignXplorer is referred to
as DesignXplorer. Workbench provides enhanced interoperability and control over the flow of information
between these task modules.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
• Engineering Data: A repository of material data for use by other Workbench applications.
• FE Modeler: Uses input from NASTRAN, ABAQUS, or Simulation, and allows navigating and visualizing of
the finite element model for downstream analysis in ANSYS.
• CFX-Mesh: Generates meshes that are ready for Computational Fluid Dynamics (CFD) simulations in the
CFX-5 software product.
Using Help
To start, click Help on the toolbar.
• If you are on the Project Page, help topics are available through the following menu options:
• If you are working in any of the Workbench modules, that module's help topics are directly available,
along with the Installation and Licensing Help. The following example shows the Help menu available
from within the Simulation module:
The product online help system describes the features and uses of the ANSYS Workbench. If you are a Windows
user, the help system for all ANSYS products is Windows HTML Help. If you are a UNIX user, all ANSYS products
use Oracle Help, a Java-based intuitive online help system.
• Each help system is organized into sections, which are listed on the Contents tab. Click the document
icon or topic title next to each section to display its content in the right windowpane.
• The Index tab allows you to view topics that are based on predetermined index terms that appear alpha-
betically in a list. Primary index terms are left-justified in the list while secondary index terms are indented.
As you type in a keyword or phrase in the field above the list, matching characters jump to the top of the
list and are highlighted. For the Workbench help system, the particular module's help is displayed in
brackets following all primary index terms. To go to the topic represented by a primary or secondary index
term, double-click the index term. To find out where you are in the help system, click the Contents tab
and the table of contents will display, showing you where the topic is.
• The Search tab allows you to view topics that contain certain words or phrases you specify. When you
execute a search, all topics containing the search text display. To go to that topic, double-click the topic.
To find out where you are in the help system, click the Contents tab and the table of contents will display,
showing you where the topic is.
The Search tab in the Windows Help includes several capabilities to assist you in narrowing down inform-
ation returned in your searches. Some of these capabilities are:
As an example, if you wanted to search for all sections in the Simulation Help that included both the words
“probe” and “timeline”, a suggested term to enter in the Search tab would be “(probe and timel*) near
simulation”.
The Search tab in the Windows Help also includes checkboxes located at the bottom of the panel that
allow you to search previous results, match similar words, or search titles only.
• The Favorites tab in the Windows Help allows you to save topics that you frequently reference.
Context sensitive help for tree objects is available for some of the Workbench modules, and can be accessed by
highlighting the object and pressing the [F1] key.
www.ansys.com> MY ANSYS> Customer Area> [Id and Password]> Product Information> Product Docu-
mentation> ANSYS Complete User's Manual Set (.pdf)
Workbench operation is heavily based on core ANSYS technology. The core ANSYS Help includes descriptions
of the underlying commands and elements that interact “behind the scenes” in Workbench. Also included is a
theory manual and several guides that detail the background and operation of several types of analyses.
Additional Documentation
In addition to the online Workbench help, the following documentation is available:
• A printable English version of the Workbench Help is available in PDF format1 at:
1 - To view and print the contents of the PDF file, you must have Adobe Reader installed. A free reader download
is available at:
http://www.adobe.com/products/acrobat/readstep2.html
the item to a different geometry source. You may delete the item from the project list, or delete any associated
files along with the project item.
When a project is created, a Workbench project database file is also created. Likewise, when you perform a task
within any of the task modules, a database file is also created that is associated with the module. The Workbench
project database file contains the project definition and links to the associated module database files. The following
filename extensions are associated with each of the database files:
Note — You should only use database files created in this release or in the previous two releases. The
success of using database files created in any older releases cannot be guaranteed.
You access the Start Page either through your Start menu, or from a CAD system's ANSYS 10.0 menu. The Start
Page appears when Workbench starts and no project is open.
You can perform the following tasks from the Start Page:
• Select a template to create a new database or project. Template availability depends on licenses
available to your system.
Note — Advanced users can build customized templates. Refer to the ANSYS Workbench Software
Development Kit (SDK) in the Customization Guide for additional details.
• Open an Existing Database File. The Open area includes a drop down list of the most recently used
database files. Click on a file name to open the database file directly in the associated Workbench module.
Not all database types support a recent file list. You can click the Browse... button to open a database file
whose name is not in the file list, or you can access additional file types. For example, you can run a startup
macro by choosing a script file.
The list is filtered according to your choice in the drop down list.
– Options - Displays a dialog box that allows you to define Workbench options or preferences that
modify Workbench's behavior.
– Addins - This option launches the Addins manager dialog. This dialog allows you to load/unload
third-party add-ins that are specifically designed for integration within the Workbench environment.
You can enlarge the page by clicking the icon in the upper right corner of the Start Page. This will display more
information and minimize scrolling. You can toggle the Start Page back to the smaller size by clicking the icon
in the upper right corner again.
[a] If you choose to link to a NASTRAN or ABAQUS file, the Select Unit System dialog box appears on the Project
Page and allows you to select one of the five supported unit systems. A Custom choice is also available that allows
you to scale base units of length , time, and mass.
Software Licensing
You can choose which simulation license to use for the Workbench session by specifying it under Tools> Options>
Licensing> License Management using the Current setting. When choosing this option for the first time only,
there may be a time lag until the license list appears. This delay happens the first time within each Workbench
session. An analysis license is required for Simulation, ANSYS, and FE Modeler. (DesignModeler and DesignXplorer
have license requirements that are separate from the analysis license.)
The license will not be checked out until it is actually needed. For example, if you start a Workbench session,
specify an analysis license using this option setting, open DesignModeler, then exit the Workbench session, the
license is never checked out.
If you chose a license upon installation, that license will be the default. You can change the default under Tools>
Options> Licensing> License Management using the Default setting. Also, you will not be able to exchange
one simulation license for another during a Workbench session. To change a license, you must exit the Workbench
session and start a new session.
A project Name list is displayed on the right that indicates the database files associated with a particular project.
When you click on an item name in the Name list, the left panel changes to display options specifically related
to the item. These options provide control of the item and its relationships with other items in the Project. For
example, CAD geometry files display the following tasks: New geometry, New simulation, and Generate CFX-
Mesh. Simulation items display a group of tasks used to update geometry from its source by either pushing or
pulling any parameter values. Simulation items also display tasks to create new parametric design studies if a
version of DesignXplorer is available. Displayed items are controlled by your current simulation license and the
set of other product licenses that are available on the license server. Not all options are controlled by the simu-
lation license selection. For example, the Open CFX-Mesh option is displayed only if you have the appropriate
CFX license on the server. New geometry is displayed only if you have a DesignModeler license on the server.
6
Section : Project Page Navigation
[a] If you choose to link to a NASTRAN or ABAQUS file, a Unit Selection section appears on the Project
Page that allows you to select one of the five supported unit systems. A Custom choice is also available
that allows you to scale base units of length , time, and mass.
• Options when you select CAD geometry name:
– Transfer to DesignModeler and open the selected geometry. This requires that you select a length
unit. Then choose Generate from within DesignModeler to display and use the geometry.
– Transfer to Simulation and open the selected geometry file.
– Transfer to CFX-Mesh and open the selected geometry file.
– Set Geometry Preferences. If you choose to import geometry from a CAD system, you can specify
preferences on how you would like the geometry to be transferred into Workbench. You can find a
description of these preferences included under Geometry Preferences. This section also includes
descriptions of geometry preferences you can specify in the Geometry Details View within Simulation.
– Re-link to geometry from an open CAD system.
– Re-link to geometry from a file.
Note — This option relocates a file that may have moved. The geometry itself does not update
until you select either of the Update options in Simulation.
– Transfer to FE Modeler and open the FE model from the selected .fedb file.
– Transfer to ANSYS (if you have ANSYS installed) and open or continue the analysis from the selected
environment.
– Various editing tasks.1
[1] If you choose Delete..., a dialog box prompts you to choose one of the following options:
• Delete only the selected item and any dependent items from the project (not any underlying files).
• Delete the project items and underlying files from the system. The underlying files are listed in the dialog
box. This option does not delete CAD files, NASTRAN files, or ANSYS input files.
You can also view Headlines and Messages on the Project Page regardless of which name is highlighted.
Name Dependencies
The indentation level of an item in the Name list implies dependency and data flow. In the examples mentioned
above, a design study depends on a simulation, which in turn depends on geometry. For parametric updates,
the system pushes parameter values upwards through the dependencies and then updates items top-down. If
8
Section : Project Page Navigation
the listed file timestamp for a geometry item is newer than the timestamp for a dependent simulation, you may
need to update the simulation to incorporate edits made to the geometry.
Each item in the Name list provides a corresponding full path or file name in the list. If only a file name appears,
the file exists in the same folder as the location of the project database. A full pathname implies no relationship
between the location of the file and the project. Select an item to view its full path in the bar at the bottom of
the window.
The icon indicates the state of the item: saved, not saved, or not found. If not found, the item appears in red with
an “X”. The Project Page toolbar allows you to save individual items or all unsaved items at once. You may also
save an item from inside its associated task module. If you close a project with unsaved items, Workbench
highlights the items in the Project Page and prompts you to save all, save none, or return to the project.
The Size column is filled in for every Project Page item that has been saved to disk. The Size column shows the
size of the file currently on disk, not the expected size of the current data set in memory. For example, suppose
you save a Simulation session to a DSDB file of size 200 KB, then continue to work in Simulation, adding branches
and generating meshes. Though the memory usage has increased, the Size column will not change its value
until you execute another save operation.
Note — If the item is deleted from the Project Page, the Result File setting for the Solution object in
Simulation is not updated. The file name selection is still valid although the file is now currently missing.
A new solve will regenerate the file.
Headlines and Messages will not slow or interrupt your use of Workbench. If anything goes wrong (for example,
if your computer cannot connect to the Internet) the Headlines and Messages simply won't appear in the task
panel.
Workbench Tabs
The Start/Project Page, and each of the Workbench modules have a tab that appears at the top of the Workbench
window. The tabs appear as each page or module is used in a particular Workbench session. You can click on
any tab to immediately access the page or module represented by the tab.
You may work with multiple tabs simultaneously (e.g. the project, a DesignModeler item, a Simulation item, and
so on), but you cannot open two tabs associated with the same module. To close an item, click the X button inside
its tab. This action only removes the tab, but the data associated with the tab is still in memory, and is accessible
from the Project Page.
Workbench Interface
Most of the Workbench modules share a common interface.
Rotate
Rotate is one of the four cursor modes accessible via the right mouse button. Module-specific details are available
for DesignModeler and Simulation and FE Modeler. Rotate in DesignXplorer exhibits behavior comparable to
that in Simulation.
Pan
Pan is one of the four cursor modes accessible via the right mouse button. Module-specific details are available
for DesignModeler and Simulation and FE Modeler. Pan in DesignXplorer exhibits behavior comparable to that
in Simulation.
Zoom
Pan is one of the four cursor modes accessible via the right mouse button. Module-specific details are available
for DesignModeler and Simulation and FE Modeler. Zoom in DesignXplorer exhibits behavior comparable to
that in Simulation.
10
Section : Workbench Interface
Box Zoom
Box Zoom is one of the four cursor modes accessible via the right mouse button or the toolbar. Module-specific
details are available for DesignModeler and Simulation and FE Modeler. Box Zoom in DesignXplorer exhibits
behavior comparable to that in Simulation.
Zoom to Fit
Zoom to Fit accessible via the right mouse button or the toolbar. Module-specific details are available for
DesignModeler and Simulation and FE Modeler. Zoom to Fit in DesignXplorer exhibits behavior comparable to
that in Simulation.
Magnifier Window
The Magnifier Window can be toggled on and off via the toolbar button. It is not accessible via the right mouse
button. Module-specific details are available for DesignModeler and Simulation and FE Modeler. Magnifier Window
in DesignXplorer exhibits behavior comparable to that in Simulation.
Previous View
To return to the last view displayed in the graphics window, click the Previous View button on the toolbar. By
continuously clicking you can see the previous views in consecutive order.
Next View
After displaying previous views in the graphics window, click the Next View button on the toolbar to scroll forward
to the original view.
Isometric View
Isometric View Button
The Isometric View button allows you to view your model in the custom isometric state.
Set Button
The ISO icon button allows you to set the isometric view. You can define a custom isometric viewpoint based
on the current viewpoint (arbitrary rotation), or define the “up” direction so that geometry appears upright.
Keyboard Support
The same functionality is available via your keyboard. The numbers correlate to the following functionality:
0 = View Isometric
1 = +Z Front
2 = -Y Bottom
3 =+X Right
4 = Previous View
5 = Default Isometric
6 = Next View
7 = -X Left
8 = +Y Top
9 = -Z Back
. (dot) = Set Isometric
Image Capture
The Image Capture icon button allows you to save the contents of the Graphics window in a standard image file
format. The following file formats are supported:
Capped Isosurfaces
Capped Isosurface mode displays surfaces through the geometry that correspond to a given value within the
calculated range for a selected result. To view a capped isosurface, display the Capped Isosurface toolbar from
Simulation or from DesignXplorer.
The value for the isosurface is set by the slider or textbox in the toolbar. The slider represents the range from
min to max for the selected result.
The three radio buttons control if any solid geometry remains visible on either side of the isosurface. The leftmost
button displays the isosurface only, the center button displays the surface and geometry with values below the
surface, the right button displays the surface and values above.
Results Animation
An Animation toolbar is available to view results from Simulation or from DesignXplorer. Access the toolbar
from Simulation or from DesignXplorer. The toolbar is presented below along with descriptions of each animation
control.
1 - For sequenced and transient simulations, as you move the cursor across the Timeline controller, the cursor's
appearance changes to a scope icon for solved solution points.
Animation Behavior
Depending upon the type of simulation that you perform, the behavior of the resulting animation varies.
For a static simulation, the progression of an animation occurs in a linear forward/backward manner. The color
contours begin with the initial condition, advance to the solution state, and then “rewinds” to the initial conditions.
For thermal transient and sequenced simulations that have an associated time or step range, the animation begins
at the initial time or step value, progresses to the final set, and then stops and starts at zero again. It does not
traverse backward as it does for static simulations.
In addition, you may also select a specific time period to animate that is a subset of the total time. To do so, drag
the mouse through the time period in the Timeline window pane. The selected time period turns blue. Press the
Play button (or right-click the mouse and select a Play option) to animate only through that period. An animated
example of this function is shown below.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
A preview of the contour bar appears on the left and includes the minimum and maximum values of the current
legend. After accessing the dialog box from Simulation or from DesignXplorer, you can perform the following
tasks with the legend:
• Set maximum value: You can enter a custom value in the field at the top of the contour or you can click
the adjacent button to accept the default result Maximum value calculated by the program. The custom
value that you enter must be greater than the default value calculated by the program.
• Set alarm color for the maximum range: Click on a red, magenta, or tan button beneath the maximum value
field to set the alarm color representing values in the maximum contour range. The default color is red.
• Set lower value for the maximum range: You can enter a custom value in the second field from the top of
the contour or you can click the adjacent button to accept the default Automatic value calculated by the
program.
• Set number of bands between the bottom and top of the contour: You can set this value using the + or -
buttons, or by entering a value in the adjacent field. The number of bands can range from 1 to 14.
• Set upper value for the minimum range: You can enter a custom value in the second field from the bottom
of the contour or you can click the adjacent button to accept the default Automatic value calculated by
the program.
• Set alarm color for the minimum range: Click on a red, magenta, or tan button toward the bottom of the
contour to set the alarm color representing values in the minimum contour range. The default color is
blue.
Note — The same alarm color cannot be selected for both maximum and minimum ranges.
• Set minimum value: You can enter a custom value in the field at the bottom of the contour or you can click
the adjacent button to accept the default result Minimum value calculated by the program. The custom
value that you enter must be less than the default value calculated by the program.
• Change the color spectrum: Choose one of the four buttons in the Color area to set the contour color
spectrum from red to blue, blue to red, white to black, or black to white.
• Change the position of the legend: Choose one of the four buttons in the Position area to set the position
of the legend to one of the following locations in the Geometry window: left/vertical, right/vertical,
top/horizontal, or bottom/horizontal.
• Adjust the size of the legend: Choose a radio button in the Size area to determine the amount of space that
the legend can occupy in the Geometry window.
• Save and restore legend settings to and from an XML file: Choose the Export or Import button to perform
either of these tasks. After choosing the Export button, you are prompted to save the legend settings in
an XML file to the file path location of your choice.
• Reset settings to factory default values: Choose the Reset to perform this task.
• If you insert a Figure object that includes customized legend settings, these settings are stored
with the Figure object. Legend settings are not saved in the database file for results however.
• You can change the Position setting for all result items. The remaining settings may not be
available for certain result items (such as results under the Shape Tool or Fatigue Tool).
Tab dock means that two or more panes reside in the tabs in the same space on screen.
Autohide means that a pane (or tab docked group of panes) automatically collapses when not in use to free
screen space.
Note — The management of these windows differs on Windows platforms vs. UNIX platforms.
Panes are either pinned or unpinned . Toggle this state by clicking the icon in the pane title bar.
A pinned pane occupies space in the Workbench window. An unpinned pane collapses to a tab on the periphery
of the window when inactive.
To work with an unpinned pane, move the mouse pointer into the tab; the pane will fly out on top of other panes
in the Workbench window. The pane will remain visible as long as it is active or contains the mouse pointer. Pin
the pane to restore its previous configuration.
Move the mouse pointer over a target to preview the resulting location for the pane. Arrow targets indicate ad-
jacent locations; a circular target allows tab-docking of two or more panes (to share screen space). Release the
button on the target to move the pane.
Workbench Behavior
When transitioning between the ANSYS Workbench modules, expect to encounter unique behavioral scenarios
as described below.
Note — In order to maintain data link integrity, ANSYS Workbench must create these files for you upon
project startup. Failure to do so may cause the following error message to appear:
File Dependencies
When attempting to open a project that includes database files from more than one of the ANSYS Workbench
modules, you must be sure the files are in their original location, or in the same folder, for the project to construct
properly. For example if the DesignXplorer database (.dxdb) cannot find the Simulation database (.dsdb) or
DesignModeler database (.agdb) that it is dependent upon, the project will be constructed with only the .dxdb
and DesignXplorer can only be used to view the saved results.
CAD Plug-Ins
In a third-party CAD program, when you select the ANSYS 10.0 option, the drop-down menu allows you to select
either Simulation or Workbench. When you choose the Simulation option, you are directed into the Simulation
module of ANSYS Workbench and the CAD geometry is automatically transferred. A default Simulation database
(dsdb) name and location is created. If you save the data, the file name and location default to match your CAD
file and location. If the .dsdb already exists a warning message allows you to overwrite the file.
When you choose the Workbench option, you are redirected to the Start Page.
• Information pane – shows the status of the application and displays in-
formative tips when you hover your mouse above a menu item.
• Job count pane – displays the number of jobs displayed in the list view.
Tray The tray context menu is a duplication of options available via the main menu.
In addition, to the options described above, the Solution Status Monitor interface provides two other interactive
elements that include:
• Solution Status Tray - Double clicking the tray icon displays the solution status monitor main window.
The tray icon changes based on the status of jobs (no jobs running, at least one job is running; at least
one job has failed). A tool tip is available on the tray icon to display the current status of jobs.
• New Job Desktop Alert - The New Job Desktop Alert automatically displays when a new job is submitted.
It displays the running, and finished jobs. The number of pending jobs (in addition to running and finished
jobs) is also displayed in the window title. Tool tips are available on the individual jobs. If all jobs are finished,
the desktop alert will disappear automatically. If you wish to hide the desktop alert, use the menu options
or tray context (right-click) menu to turn it off. Closing the desktop alert will not cause it to hide itself, it
will pop-up again as long as jobs are available. Finished jobs can be hidden by using the Tools>Options
menu or the tray context menu. A screen capture of this window is shown below.
Menu Bar
The menu bar provides the following functions.
Tools Desktop alert Shows or hides the new job desktop alert window.
Remove Deletes the selected job or jobs.
Options Displays the Solution Status Monitor options window.
Help ANSYS Solution Status Help Displays the Help system in another browser window.
About ANSYS Solution Status Provides information about the program.
Tree View
Based on the clusters you have selected to view (Local Jobs, WB Cluster, or LSF Cluster) and which owners you
have selected to view (All Owner Jobs or not) All Jobs displays all currently running jobs with respect to the filters
you have selected.
Beneath All Jobs there are several filtering options available for customizing what is displayed in the list view.
You may filter your choice of completed, running, pending and failed jobs in the list view. The tree view also
contains a list of servers and queues setup on your local machine that can be configured via the context (right-
click) menu.
Test Server Button This dialog box displays the status of the server test (suc-
ceeded or failed) and a viewer to display the server’s log to
help diagnose why the server connectivity test may have
failed.
Change Server Password Enter your password into both boxes and press OK to commit
your password. If the password entries do not match, you are
alerted. Press Cancel to discard a password change.
List View
You can customize which fields are displayed in the list view using the context (right-click) menu. You may also
sort the displayed fields by selecting the appropriate column you wish to sort. You may delete jobs that belong
to you by clicking the delete button in the toolbar, or clicking Remove in the context menu, or pressing the delete
key. The List View supports the deletion of multiple jobs by highlighting the jobs you wish to remove and following
the above steps to delete them. If you delete a job, the job may not be removed from the list view immediately.
It will disappear the next time the List View is refreshed.
Progress Pane
This pane provides the following fields:
• The Progress bar is not real progress at version 10.0. It indicates that the job is active. Actual progress will
be implemented in a future release.
The Phase Progress field is not real progress. It indicates that the job is active.
• TheLog Messages field displays messages about the job. You can copy the log messages using the context
menu or the Copy (Ctrl+C) key combination.
• RSM Web Server field – the remote RSM server on which to view
running jobs.
• New Job Desktop Alert Settings fields, which includes the following:
Workbench Options
You can set several options or preferences that govern Workbench behavior from the Start Page or by performing
the following procedure from within any of the Workbench tabs.
1. From the main menu, choose Tools> Options. An Options dialog box appears and is identical regardless
of where you accessed the menu item.
2. Expand any of the major options listed on the left then click on a specific option within that category.
3. Change any of the option settings by clicking directly in the option field on the right. You will first see a
visual indication for the kind of interaction required in the field (examples are drop down menus, secondary
dialog boxes, direct text entries).
4. Click OK. Whenever an option is changed, the change is reflected in all of the applications or task modules
running inside Workbench. The options that you set are persistent from run to run.
Common Settings
The Common Settings options include general options governing graphics and interfacing.
• Background Style: sets a solid graphic background or a gradient background that varies from top to
bottom, left to right, or diagonally. The default is the top to bottom gradient.
• Background Color: sets a graphic background color from the built-in color palette. The default color is
blue.
• Background Color2: sets a second graphic background color from the built-in color palette. The second
color is used for gradient background displays. For example, if you want a top-bottom gradient that starts
out white and ends up black, Background Color should be set to white and Background Color2 should
be set to black. The default color is white.
• Edge Color: sets the color of all edges from the built-in color palette. The default color is black.
• Unshared Edge Color: sets the color of all edges that are not touching. This is useful for finding modeling
errors in sheet parts. For example, if you see a red line running through the middle of a sheet part, you'll
know that the surfaces on either side of the line do not share an edge, even though it appears that they
do. Colors from the built-in color palette are available. The default color is red.
• Mesh Edge Color: sets the color of all meshed edges from the built-in color palette. The default color is
gray.
• Text Color: sets the color of all text from the built-in color palette. The default color is black.
• Dynamic Viewing: If set to Yes and you are making a standard view change (such as front, back, left,
right, bottom, top, isometric, and Look At Face/Plane/Sketch) a short animation is drawn showing the
model moving/twisting toward its final pose. When set to No, there is no animation shown and the view
is immediately changed to the model's final pose. The default setting is Yes. Choose No if you are using
an older graphics card.
• Use Spaceball: enables the use of the Spaceball 3D import device (not supported in UNIX). The default
setting is Yes.
• Extend Selection Angle Limit (degrees): Sets a limit in degrees for what kind of face and edge angles
the system considers “smooth”. This affects the Extend to Adjacent and Extend to Limits Extend Selection
toolbar buttons in DesignModeler. Extend Selection buttons are also present in Simulation. The default
value is 20o and the range is from 0o to 90o.
• Custom Start Screen Configuration URL: Address of an XML configuration file that defines custom
content for the Start Page screen.
You can also develop and maintain several XML configuration files that each define various additional
applications to appear on the Start Page screen. Further details on this advanced task and on the overall
customization of Workbench are included in the ANSYS Workbench Software Development Kit (SDK)
section of the Customization Guide
• Load Headlines at Startup: Indicates if the Headlines and Messages section should appear on the
Project Page when Workbench is started. The default is Yes.
• Custom RSS Feed Address: URL to a custom RSS to allow the Headlines and Messages section to list
headlines from that RSS.
• Number of Significant Digits: Sets the number of digits that appear for numbers throughout Workbench.
The default is 5 and the range is from 3 to 8. This setting affects only the numbers that are displayed. It
does not imply any numerical round off of internal calculations.
• Show Beta Options: Allows testing of unreleased Workbench features. The default is No. Beta features
remain untested in this release and therefore are neither documented nor supported.
• Omit Text on Toolbars: Indicates if text tips are to be omitted from toolbar buttons. The default is No.
• ”Save As” Preferred Default: Determines the default settings when you choose File> Save As. .....The
following choices are available:
– Name and location of most recent link (e.g., CAD file) [default]
– Location of most recently saved database
Under certain conditions such as creating a new simulation from CAD, the default file name and location
are based on the geometry file. If you prefer to organize databases in a separate location, adjusting this
option may provide a more convenient default.
• CAD Licensing: Determines whether the CAD license will be released when not in use. During DesignXplorer
studies and Simulation parameter manager runs, when the CAD license is accessed repeatedly, the license
may not always be available if the Release option is used. The following choices are available:
– Release (default)
– Hold
• Start: Controls the startup of the Solution Status Monitor available on Windows platforms only. The
following choices are available:
– When ANSYS Workbench starts (default): Starts the Solution Status Monitor whenever Workbench
starts. If you choose this option and if you had closed the Solution Status Monitor, the Solution
Status Monitor will start when an asynchronous solution is performed.
– I will start it myself: Allows you to start the Solution Status Monitor manually from the Start menu
using ANSYS10.0> Workbench Utilities> ANSYS Solution Status Monitor.
– Use old Solution Status: Allows you to use the Job Status tab in Simulation. This option will not be
available in future releases.
DesignModeler
Refer to the DesignModeler Options section located in the DesignModeler help.
CFX-Mesh
Refer to the CFX-Mesh Options section located in the CFX-Mesh help.
Simulation
Refer to the Simulation Options section located in the Simulation help.
DesignXplorer
Refer to the DesignXplorer Options section located in the DesignXplorer help.
FE Modeler
Refer to the FE Modeler Options section located in the FE Modeler help.
• Current: Specifies the license to use for the Workbench session. You choose a license from a drop down
list of license names. If you choose Use Default (one of the options in the list), the license reverts to the
Default setting described below.
• Default: When you start a Workbench session, the license stated here will be used. You can change the
default license by choosing it from a drop down list that is similar to the one used for the Current setting.
Note — The Current license selection overrides the Default selection for the current Workbench session
only. The next time you run Workbench the Current selection will be restored to Use Default. Conversely,
the Default license selection is persistent from run to run.
Workbench Limitations
The following limitation applies to the Workbench environment and is not limited to a particular module.
Startup Limitation
You should avoid using a configxx.ans file when using Workbench. Specifically, issuing the ANSYS command
/CONFIG,NOELDBW,1 causes solving problems in Workbench. Also, Workbench ignores any startxx.ans and
stopxx.ans files.
Technical Support
We are dedicated to producing the world's finest mechanical design software tools. Please contact your ANSYS
support provider for any questions you may have on this product.
List of Tables
1. Point Definition Options ............................................................................................................................ 8–24
Section : Overview
Typical Usage
Menus
Viewing
2D Sketching
Selection
Planes and Sketches
3D Modeling
Parameters
Scripting API
DesignModeler Options
Overview
DesignModeler is designed to be used as a geometry editor of existing CAD models. DesignModeler is a para-
metric feature-based solid modeler designed so that you can intuitively and quickly begin drawing 2D sketches,
modeling 3D parts, or uploading 3D CAD models for engineering analysis preprocessing.
If you have never used a parametric solid modeler, you will find DesignModeler easy to learn and use. If you are
an experienced user in parametric modeling, DesignModeler offers you the functionality and power you need
to convert 2D sketches of lines, arcs, and splines into 3D models.
The DesignModeler interface is similar to that of most other feature-based modelers. The program displays menu
bars along the top of the screen.
Introduction to DesignModeler
DesignModeler features two basic modes of operation: 2D Sketching and 3D Modeling.
Sketching Mode
In the Sketching mode, you have five toolboxes to create 2D sketches by adding and removing 2D edges. From
the 2D sketches you can generate 3D solid models as described in 3D Modeling.
Modeling Mode
The Modeling mode allows you to create models, for example, by extruding or revolving profiles from your
sketches.
As you become acquainted with the tools and controls, you will quickly feel comfortable using DesignModeler
for sketching and modeling tasks.
Because DesignModeler is a feature-based modeler, the features shown in the Tree Outline list all of the operations
used to create the model. This feature list represents the model's history. Features may be modified and the
model rebuilt to reflect your changes. Features may also be suppressed, deleted, or even inserted into the middle
of the feature list.
A sketch is always required at the start of creating a new model. However not all features, such as Section : Blend
and Section : Chamfer, require you to create sketches. Some features, such as Section : Extrude or Section : Sweep,
require you to create sketches prior to their definition.
You can use the sketching toolbox to draw edges on the planes. The edges form the sketches used for feature
creation. The last sketch/plane that you worked on is the “active” sketch/plane. If any of the feature construction
tools are selected, the active sketch is the default input for that feature creation. You can select a different sketch
from the Tree Outline to change this input. Similarly, for features like Section : Skin/Loft and Section : Sweep
that require more than one sketch as input, the Tree Outline is used for sketch selections.
Before a sketch can be used to create a feature, you must define it on a plane. All sketches are attached to unique
planes. Only a single sketch can be worked on at a time. This sketch is the “active sketch.” To make an existing
sketch the active sketch, select the sketch object in the Tree Outline or in the Section : Active Sketch Drop Down
menu in the Section : Active Plane/Sketch Toolbar. You can then select the sketching tab to enter the sketching
mode and edit the sketch. Even though you can only add edges to the active sketch, you can add dimensions
or constraints between edges of different sketches in the active plane.
New planes can be inserted in the model by clicking the Section : New Plane icon in the Section : Active
Plane/Sketch Toolbar. You will then be prompted for input to clearly define the plane using the different options
available.
A plane can have any number of sketches attached to it. This is required in many instances because different
features created on a plane may use different profiles. DesignModeler does not allow you to select certain portions
of a sketch, ignoring others, for use in feature creation. Features can only be defined using entire sketches.
• Feature Dimensions
• Plane Dimensions
• Design Parameters
Feature Dimensions:
The features themselves have defining dimensions. For example, Fixed Blends have a blend radius, Extrusions
have a depth, and Revolves have an angle of revolution.
Plane Dimensions:
You can dimension the edges in the planes/sketches. You can add these dimensions at any time, and change
them to generate different model configurations.
Design Parameters:
You can promote both feature dimensions and plane dimensions to “design parameters” using the Parameters
tool, or by checking the “driven” check mark (if available) next to the feature or plane dimensions, and then
pass them into Simulation for parametric studies.
The Section : Generate icon updates the model after a dimension or parameter change is made. You are free to
specify any number of such changes before using the Section : Generate icon to update the model.
Pictured below is the model you can create by following the instructions in this section.
To start the process of creating a model, open DesignModeler from the Start Page by selecting Geometry. To
begin sketching, choose one of the sketch tools from the Section : Draw Toolbox. For this example, click on the
Section : Rectangle tool. You can simply sketch the rectangle by left clicking the top left corner location and
dragging the mouse to the lower right corner location and clicking.
Show me.1
[http://www.ansys.com/techmedia/1-create_rectangle.html]
Additional edges can be added by choosing the appropriate sketch tool. Exact locations and dimensions are not
critical at this point. For example, click on the Section : Circle tool to add two circles representing the desired
holes in the finished model. Simply sketch the rough locations. You can finalize the hole placement when editing
the model.
Show me.1
[http://www.ansys.com/techmedia/2-add_hole_circles.html]
4
Section : Process for Creating A Model
After completing the rough sketch, select the Dimensions toolbox and add dimensions by picking the appropriate
tool in the Section : Dimensions Toolbox. DesignModeler provides a number of dimensioning tools similar to
those found in advanced CAD systems. Select the Section : Diameter dimension tool, and then select the two
circles to be dimensioned. Unlike drafting systems, DesignModeler does not automatically position dimension
labels, but you can do so manually, via mouse drags.
Show me.1
[http://www.ansys.com/techmedia/3-dimension_hole_circles.html]
You may choose to use the Section : Display Name/Value tool in the Section : Dimensions Toolbox to choose the
Name and/or Value display (only Names shown here).
Show me.1
[http://www.ansys.com/techmedia/4-display_name.html]
After defining the 2D sketch, you can generate a 3D solid model using one of the feature creation operations in
DesignModeler. For example, you can revolve or sweep a profile to create a solid. DesignModeler also has Section :
Skin/Loft capabilities that allow you to join multiple sketch profiles to form a solid. After the dimensions have
been resolved, you can generate the 3D model by clicking Extrude, Revolve, etc. from the Section : 3D Features
Toolbar. For this example, the sketch is extruded to a depth of 30 millimeters (mm). Click on Extrude, then specify
the extrusion depth in the “Feature Details” window. Here the sketch is shown in the Isometric View, which you
can see by right-clicking in the Model View and selecting Section : Isometric View from the context menu.
Once the depth of the extrusion is determined and entered, you must click on the Generate button. In this example,
the 2D pattern of the sketch is extruded into a 3D solid.
Show me.1
[http://www.ansys.com/techmedia/5-generate_3_d.html]
6
Section : Process for Creating A Model
At this point, you can return to Sketching mode by clicking the Sketching tab under the Tree Outline to finalize
the dimensions. Using the Section : Edit tool in the Section : Dimensions Toolbox, simply pick the dimension
value and modify it in the details window. Alternatively, you can edit a dimension through the Details Window
of the Sketch. In this example, we change the value of D1 in Sketch1 to 20 mm.
Show me.1
[http://www.ansys.com/techmedia/6-change_dimension.html]
After modifying the dimensions, click on the Generate button from the Section : 3D Features Toolbar to update
the changes.
In addition to the 2D sketch creation tools and the 3D solid features, DesignModeler is capable of creating 3D
surface features. Click on the Modeling tab so you can add 3D features using the appropriate tools, such as features
from the 3D Features Toolbar. Here the model is shown in the Isometric View. For the example, click the Section :
Blend button, then select the Fixed Radius feature from the drop down menu.
The Geometry listing in the Feature Details window will say “Not selected.” This is where you will apply your se-
lection for the Section : Blend feature.
8
Section : Process for Creating A Model
Select the front face of the model, click “Not selected” and then click the Apply button next to the Geometry
property to complete the geometry assignment.
Change the Blend Radius to 5 mm by editing the text field of the Radius property,
If you have not yet done so, use Section : Save in the File menu to save your model. The name you select will
appear at the top branch of the Tree Outline and in the DesignModeler tab of the Section : Project Page Navig-
ation.
10
Section : Process for Creating A Model
Show me.1
[http://www.ansys.com/techmedia/7-add_3d_blend.html]
Now would be a good time to add Design Parameters to the model. One way to do this is to use the “driven”
check marks next to the feature/plane dimensions in the Feature Details window.
For example, click the checkbox of the radius dimension of FBlend1. A pop-up dialog will appear, asking
whether you want to create a new Design Parameter.
The dialog also allows you to specify the parameter name. DesignModeler uses an internal dimension “reference”
as a unique default name; it is advisable to change this name to something more meaningful with respect to
your problem at hand. The Design Parameter name you choose is important. The Parameter Key shown on the
Project Page is used to filter DesignModeler's Design Parameters.
For example, change the name to “BlendRadius”. Once you close the dialog by clicking “OK”, you will see a blue
“D” in the checkbox next to the dimension. This indicates that the dimension can no longer be set directly, but
is instead “driven” by a Design Parameter.
To complete the example, select Sketch1 (under XYPlane) from the tree. After doing so, the information for
Sketch1 appears in the Feature Details window.
12
Section : Process for Creating A Model
Instruct DesignModeler to “drive” the two dimensions XYPlane.D1 and XYPlane.D2 by design parameters “Dia-
meter1” and “Diameter2”, respectively. As shown below, when you click on D1's checkbox, a pop-up window
prompts you to personalize the Design Parameter name.
If done correctly, the two diameters will have the blue letter D before them in the Feature Details window.
At this point, the three dimensions in the example can no longer be changed using the value fields in the detail
view directly. You must use the Parameters tool in the toolbar instead. This tool will bring up the Design Para-
meters and Parameter/Dimension Assignments tabs below the display window, where parameter assignments
can be managed.
For example, go to the Design Parameters tab, and change the parameter “Diameter1” to 25,
14
Section : Process for Creating A Model
Show me.1
[http://www.ansys.com/techmedia/8-generate_parameters.html]
The model is now complete and ready for simulation. With the ANSYS Workbench you have the option to apply
this model to a new Simulation scenario with the click of a tab. For this example, click the ANSYS Workbench
Project tab. You will see details of your DesignModeler database listed and buttons to access the functionality
of Simulation.
Make the Parameter Key blank, otherwise only design parameters with the Parameter Key string will transfer.
For example, if left with the entry “DS”, as shown here, only those parameters listed with a “DS” in DesignModeler's
Parameter Manager will transfer.
By clicking on “New Simulation” under DesignModeler Tasks on the left, your geometry will be inserted into the
Simulation mode, not as a separate application, but rather in the same window with its own tab.
In the Simulation tree, entitled Outline, if you select the Geometry branch,
16
Section : Process for Creating A Model
you will see the Design Parameters you named (e.g. BlendRadius, Diameter1, and Diameter2) defined in
DesignModeler listed under the “CAD Parameters” branch in the Details View.
You can now use the Simulation Geometry detail to change any of the parameters in your DesignModeler geo-
metry. If you do so, you should update the geometry in DesignModeler to reflect your latest parameter assignment.
To do this, click the Geometry button in Simulation's toolbar and select Update: Use Simulation Parameter
Values from the drop down menu.
Notice the interoperability between DesignModeler and Simulation. They are both accessible by clicking their
corresponding tab in the ANSYS Workbench. For example, you can conveniently return to the DesignModeler
session and verify your parameter assignments by clicking the DesignModeler tab.
To return to the Section : Project Page Navigation, click the Project tab. Now both your original DesignModeler
geometry project and your current Simulation session are listed. For more information about the Section : Project
Page Navigation, click on the Help button (signified by a white question mark in a blue circle) in the Toolbar or
the Help menu.
Show me.1
[http://www.ansys.com/techmedia/9-run_in_ds.html]
18
Typical Usage
Located here are walkthrough examples of some 3D modeling tasks using DesignModeler. Instructions are included
on how to adjust your screen's area for optimal viewing of the procedures while running DesignModeler concur-
rently on your screen. Database files that are required to run the examples are also included for downloading
from the site.
Click here to interactively learn how to use some of DesignModeler's basic features (requires internet access).
File Menu
Units can only be set when creating a new DesignModeler model from the Start Page. When running Design-
Modeler in stand-alone mode, the Units preferences can be changed through the Options dialog box.
The toolbar also reflects differences in file-management functionality. When DesignModeler operates in the
ANSYS Workbench, the Start Over and Close DesignModeler options are available.
• Section : New
• Section : Start Over
• Section : Open
• Section : Close DesignModeler
• Section : Save
• Section : Save As
• Section : Export
• Section : Attach to Active CAD Geometry
• Section : Import External Geometry File
• Section : Import and Attach Options
• Section : Run Script
• Section : Print
• Section : Auto-save Now
• Section : Restore Auto-save File
• Section : Recent AGDB Files
• Section : Recent Imports
• Section : Recent Scripts
• Section : Exit Workbench
New
Hotkey: [Ctrl]-N
Use the New option to begin a new model. Before the new model is started, you will be prompted to save your
current model, if necessary. Choose the unit setting in the Units pop-up window:
You may choose a unit setting for the new session, or by checking the box you can always use the default value
for future models without being prompted. The Units pop-up window can always be reactivated through the
Options dialog box. The new model will be unnamed.
Start Over
Available only in the ANSYS Workbench mode, use the Start Over option to begin a new model. Note that your
model name is retained.
Open
Hotkey: [Ctrl]-O
Use the Open option to open a saved DesignModeler model (extension: .agdb).
Close DesignModeler
Available only in the ANSYS Workbench mode, this option will close the DesignModeler tab in the Section :
Project Page Navigation. If the model requires saving, you will be prompted to save it.
Save
Hotkey: [Ctrl]-S
The Save option stores a model with the .agdb extension at the specified file location.
Save As
Use the Save As option to store a model to a named file location (extension: .agdb). Note that the model name
in the session is determined by this operation.
You can use the Save As option for an initial save and to store a model by a different file location. Changing a
model's name and/or location using the Save As command from the File Menu creates a new copy of the
sketch/model, so two versions of the file exist: one with the old name and/or location and one with the new. The
versions are completely separate, and the work you do on one file has no effect on the other.
Export
The Export option is used to export a model to DesignModeler (.agdb), Parasolid (.x_t, .xmt_txt or .x_b,
.xmt_bin), ANSYS Neutral File (.anf) , Monte Carlo N-Particle (.mcnp), IGES (.igs), or STEP AP203 (.stp) format.
The original model name still presides over your DesignModeler session. Note that bodies that are grouped in
multiple body parts do not share topology when exported to formats other than DesignModeler's AGDB. In those
cases, all bodies are treated as if they are single body parts.
When exporting to IGES, non-manifold line bodies may not be exported properly, or may not be exported at all.
When exporting to Parasolid, MCNP, and IGES formats, those exported files may appear in the Recent Imports
list.
You can import a model into DesignModeler that is currently open in a CAD session on your computer. Use the
Attach to Active CAD Geometry option to import the model into DesignModeler, where it will appear as an
attached feature in the feature Tree Outline. You do not need to begin a new model to use the Attach to Active
CAD Geometry option and it can be used at any time (and multiple times) during any DesignModeler session.
Note — The Attach to Active CAD Geometry option is not supported for UNIX.
From the CAD program Unigraphics you can attach surface thicknesses. Surface thicknesses are automatically
transferred to bodies in DesignModeler and are updated whenever the CAD geometry is refreshed. You are still
allowed to modify the thickness of a surface body, though if you do, then that surface's thickness will no longer
update when the CAD geometry is refreshed.
Source Property
DesignModeler will automatically detect active CAD programs on your computer. You can choose which one
DesignModeler will attach to by changing the CAD Source property in the Details View.
4
Section : File Menu
CAD parameters should be uniquely named. If duplicate parameter names exist, the Import/Attach feature will
generate a warning. It is not recommended to create design parameters from CAD parameters whose names
are non-unique.
Note that the corresponding CAD system must support material properties and have materials assigned to the
bodies in order for the material properties to be processed in DesignModeler. Material property transfer is sup-
ported for Autodesk Inventor, Pro/ENGINEER, and Unigraphics. The default setting is off for all new Import and
Attach features. For .agdb files created prior to Release 8.0, the default is no.
Refresh Property
Once a model is attached, you can continue to edit it in your CAD program. To reflect changes made with the
CAD program in DesignModeler or to reflect changes in the original active CAD source, change the Refresh
property to Yes. These are the three choices for the Refresh property:
The refresh will be completed to reflect any changes once the Generate button is clicked.
Note — Autodesk Mechanical Desktop models will not maintain associativity upon refresh.
Operation Property
Attach also has an Operation property. This allows you to do things other than add bodies to your model.
Note — The Add Material option does not always apply. DesignModeler will not add material when the
Attach consists of multiple bodies AND active bodies already exist in the current model. In this case,
DesignModeler will automatically apply the “Add Frozen” material type instead and mark the feature
with a warning.
Note — When body suppression operations are needed in your model, it is best to perform them with
DesignModeler than with attached CAD programs. If the suppression of a body using the CAD program
results in a DesignModeler part being added or deleted, you may lose associativity on the part in your
Simulation.
Process Property
The Process property describes what bodies will get attached to DesignModeler. The options are Solids Only,
Surfaces Only, and All Bodies. The default setting is All Bodies. Modifying this setting after the Attach feature has
generated may lead to loss in associativity.
6
Section : File Menu
x = supported
Reader/Plug-In Pro/ENGINEER x x x
for Pro/ENGIN- Wildfire 1
EER Pro/ENGINEER x x x
Wildfire 2
Reader/Plug-In Unigraphics NX x x x
for Unigraph- 2.0
ics Unigraphics NX x*** x*** x
3.0
Reader/Plug-In Mechanical
for Mechanical Desktop 2005
Desktop** Mechanical
Desktop 2006
Reader/Plug-In OneSpace De-
for OneSpace signer Modeling
Designer 2005 (Rev. 13.20)
Plug-In for TcEng 9.1.2 with
TeamCenter UGNX3,
Engineering TcEng 9.0.0 with
UGNX2
x = supported
* This version processor may run on the Sun UltraSPARC 64–bit platform, but with limited performance.
****IGES import and export on the HP platform may behave differently than other operating systems.
8
Section : File Menu
The Import External Geometry File option is used exclusively to import foreign models such as:
Imports can be applied at any time during your DesignModeler session. You do not need to begin a new model
to use the feature.
From the CAD program Unigraphics you can attach surface thicknesses. Surface thicknesses are automatically
transferred to bodies in DesignModeler and are updated whenever the CAD geometry is refreshed. You are still
allowed to modify the thickness of a surface body, though if you do, then that surface's thickness will no longer
update when the CAD geometry is refreshed.
Material property transfer is supported for Autodesk Inventor, Pro/ENGINEER, and Unigraphics. Material properties
transfer is controlled by the Import Material Properties option through the Details View. The default setting is
“yes.” for all new import and attach features. For .agdb files created prior to Release 8.0, the default is no.
Operation Property
Import also has an Operation property. This allows you to do things other than add bodies to your model.
Note — The Add Material option does not always apply. DesignModeler will not add material when the
Import consists of multiple bodies AND active bodies already exist in the current model. In this case,
DesignModeler will automatically apply the “Add Frozen” material type instead and mark the feature
with a warning. For Import features in all .agdb files prior to this upgrade, the default operation is Add
Material.
Process Property
The Process property describes what bodies will get imported to DesignModeler. The options are Solids Only,
Surfaces Only, and All Bodies. The default setting is All Bodies.
When importing a file with an extension of “.mcnp”, the Process property will be changed to Solids Only and
become disabled. Only solid bodies may be defined in MCNP files.
Refresh Property
Sometimes an imported CAD file may have changed since it was first imported into DesignModeler. To reflect
changes made to the CAD file in DesignModeler, change the Refresh property to “yes.”. This will cause Design-
Modeler to refresh the imported geometry the next time you click Section : Generate.
Note — When you modify the Process property or change the CAD source, the Refresh is automatically
set to “yes.”.
Parasolid
BladeGen
• DesignModeler imports CFX BladeGen on Windows systems only. The BladeGen import produces a flow
path, which is the air or fluid surrounding the blade. The import procedure is a three-step process:
10
Section : File Menu
It is important to note the scaling factor when importing BladeGen models. If an incorrect Model Unit
setting is chosen, it is possible that the BladeGen model will fail to import into DesignModeler. In some
cases, tolerance issues will prevent the Parasolid conversion from succeeding, or it may produce a distorted
flow path. In these cases, it is recommended to try using a larger Model Unit setting.
CATIA
• Version 5 surface bodies consisting of closed surfaces are transferred as solid bodies.
IGES
• IGES imports of sets of surfaces that enclose a region will create a solid body.
STEP reader
• The STEP (STandard for the Exchange of Product model data) reader will both read and write model data
to and from the STEP format. It is important to note that the STEP format does not store model data in
the same was as DesignModeler. STEP format stores surface data, which upon import into DesignModeler
is stitched together to form bodies. In some rare cases, a DesignModeler model exported to STEP format
may not produce the exact same geometry when imported again into DesignModeler.
Autodesk Inventor
• At present, all Autodesk Inventor weldments get grouped as a single part with a single body. This may
cause problems for the mesher determining an appropriate mesh element size (making them too large)
and a failure when meshing using default values. If this occurs, it would be recommended that mesh sizing
be defined and scoped to the weldment part and a mesh retried.
• The plug-in will import all parts in the model based on body type import filters. Active CAD session
models imported from OneSpace Designer Modeling can only be updated from an active session unless
the model is relinked to a specified file. A model imported based on its file can only be updated from the
file unless relinked to an active session.
• OneSpace Designer Modeling supports the import of solid and surface components.
• Supported extension types include (*.pkg;*.bdl;*.ses;*.sda;*.sdp;*.sdac;*.sdpc).
Note — SES files are not portable between different versions of OneSpace Designer Modeling.
They should be limited to use on a single machine.
Pro/ENGINEER
• When importing Pro/ENGINEER parts, the parts must reside on a local or mapped drive. This is due to an
error in Pro/ENGINEER that causes issues when attempting to use parts from network paths.
• File versions of Pro/ENGINEER are accessible through the Workbench Start Page.
• To improve our associativity with Pro/ENGINEER models, a modification was made to vertex processing
that will yield a “break” in associativity for most vertex loads and boundary conditions upon update. You
will be required to reattach/redefine those loads that are lost, but should expect associativity to be
maintained from that point forward.
• Surface bodies imported into DesignModeler include numerical references to the parent part or assembly
and Pro/ENGINEER quilt ID. For example, a part named H103 with three Pro/ENGINEER quilts 1, 2, and 3
will be identified as H103[1], H103[2] and H103[3].
Solid Edge
• When importing a Solid Edge assembly, make sure that no two components use the same component
name. This will result in the second component being displayed on top of the first.
• A closed surface body will be imported into DesignModeler as a solid body since Solid Edge considers
this body as a solid.
• Solid Edge recommends that part documents contain only one body, otherwise a duplicate set of para-
meters and variables may be imported.
SolidWorks
• A limitation imposed by SolidWorks in relation to geometry and the API processing exists if a sketch is
revolved 180 degrees. As a result, the faces generated on either portion of the revolution are identified
as the same. However if the revolution angle is changed, they now become different faces; one retains
the original identification and the second a new one. This creates an associativity break if the angle of
revolution is modified to or from 180 degrees.
Unigraphics
• Closed surface models from Unigraphics can only be imported to ANSYS Workbench Products through
UG NX 1.0.1.2 and up. Persistence may not be maintained when a Unigraphics import is first refreshed in
old databases prior to Release 8.0.
• If you refresh Unigraphics geometry in DesignModeler, the Unigraphics interface uses Unigraphics User
Defined Objects (UDO) to store persistent IDs. To maintain the associativity of the geometry between
Unigraphics and DesignModeler, you need to Import/Attach the Unigraphics geometry file in Design-
Modeler and save the part file at the end of a Unigraphics session (plug-in), or save the part file from
within DesignModeler (reader). At update/refresh time, you will need to set the Reader Save Part File
property to Yes. The part file will be saved at the end of an attach process using the same file name in the
same directory. The current part file will be backed up by changing the extension of the file to bak before
saving the part. Make sure that the file is not set to read-only.
Note — You should avoid setting Reader Save Part File to Yes on UNIX platforms if a CAD file is
open.
• Simplify Geometry - If yes, DesignModeler will simplify the surfaces and curves of the model into analyt-
ical geometry where possible. Default is no.
12
Section : File Menu
• Simplify Topology - If yes, DesignModeler will remove redundant faces, edges, and vertices from the
model where possible. Default is no. Property appears in the Details View only when you select an IGES
or STEP file for import.
• Heal Bodies - Attempts to heal geometry before performing import or attach operation. Default is no.
• Clean Bodies - Attempts to heal geometry for solid and surface bodies after performing import or attach
operation. Default is “yes.”. The Clean Bodies option is not available on Linux platforms. Additionally, im-
ported line bodies are ignored by the Clean Bodies option.
• Tolerance - Choose either Normal or Loose stitching tolerance. Default is Normal. Property appears in
the Details View only when you select an IGES or STEP file for import.
• Replace Missing Geometry - If yes, missing geometry will be replaced. Default is no. Property appears
in the Details View only when you select an IGES or STEP file for import.
• Reader Save Part File - If set to yes, then Unigraphics' User Defined Objects (UDO) will be saved.
• Do Smart Update - If on, when you modify preferences such as the parameter key, attributes, import
type, etc. will not be respected if the component can be smart updated. Further details available in Simu-
lation help.
• Stitch Surfaces - If on, the modeler will attempt to stitch together all surface bodies resulting from import.
Property appears in the Details View only when you select an IGES or STEP file for import.
Simplify Simplify Heal Bod- Clean Bod- Tolerance Replace Reader Smart Up- Stitch Sur-
Geometry Topology ies ies* Missing Save File date faces
Geometry
Acis x x x
BladeGen
Catia V5 x x x
Inventor x x x x
IGES x x x x x
Mechanic- x x x
al Desktop
OneSpace x x x
Designer
Modeling
Parasolid x
Pro/ENGIN- x x x
EER
Solid Edge x x x
Solid- x x x
Works
STEP x x x x x x x
Unigraph- x x x x x
ics
Run Script
Use the Run Script option to start a script created with the instructions in Scripting API. Such scripts are intended
to assist in creating many similar parts by making simple changes to the script file.
Use the Print option to print your model. The option is only available when you are in Section : Print Preview
mode.
Auto-save Now
DesignModeler will now automatically save backup files of the model after a specified number of Generates.
Auto-save Now forces an automatic save immediately. A list of these backup files will then be available for you
to resume from the File->Restore File Menu.
Auto-save files are saved to a folder named Auto-save, which resides in DesignModeler's temporary directory.
In the Options dialog box, under the DesignModeler Miscellaneous options, you can set the path where the
temporary directory will be created. Whenever you change this path, a new temporary directory and Auto-save
folder will be created and the old folder and Auto-save files will be deleted.
Auto-save files have the following special naming convention: ModelName.agdb-##, where ModelName is the
name of the file and ## starts at 00 (the most recent Auto-save file) and increases until the specified Auto-save
File Limit has been reached (the highest ## is the oldest Auto-save file).
Note — Since the Auto-save filename depends on the name of the original .agdb file, it is not advisable
to have multiple models with the same filename, as their Auto-save files will interfere and overwrite each
other. Additionally, it is not recommended to have multiple DesignModeler sessions of the same model
open, as their Auto-save files will interfere.
Image Capture
The Image Capture tool allows you to save the contents of the graphics view in a standard image file format.
The following file formats are supported:
14
Section : File Menu
You can restore an Auto-save file by selecting a file using Restore Auto-save in the File Menu. A list of all the
Auto-save files for the model that is currently open is displayed as well as Browse option. The Browse option will
open to the Auto-save folder and display all the Auto-save files, where you may choose a specific Auto-save file.
Note — The -00 Auto-save file will not be displayed in the list unless the Auto-save Frequency is greater
than Every Generate and the model has not just been Auto-saved.
Recent Imports
From this menu you may choose a recent CAD file to Import. A new Import feature will be added to the bottom
of the feature list, with the CAD file automatically chosen as the source. Note that previously exported files may
also appear in this list.
Recent Scripts
From this menu you may choose to run a script that was recently used.
Exit Workbench
The Exit Workbench option closes the ANSYS Workbench. You are prompted to save your file first if you have
not already done so.
Create Menu
The following feature options are available under the Create Menu. The Section : 3D Features include:
16
Section : Concept Menu
Concept Menu
The following feature options are available under the Concept Menu:
Tools Menu
The following feature options are available under the Tools Menu:
• Section : Freeze
• Section : Unfreeze
• Section : Named Selection
• Section : Mid-Surface
• Section : Joint
• Section : Enclosure
• Section : Symmetry
• Section : Fill
• Section : Surface Extension
• Section : Winding Tool
• Section : Form New Part
• Parameters
• Addins - Launches the Addins manager dialog that allows you to load/unload third-party add-ins that
are specifically designed for integration within the ANSYS Workbench environment.
• Options
View Menu
The View Menu consists of four groups of display controls that affect the appearance of your model in Design-
Modeler and one group that restores the original window layout. The settings in the View Menu are saved in
the .agdb files themselves, though the Triad and Ruler are always on by default.
The first and second groups apply only to solids and surface bodies.
• Section : Triad
• Section : Ruler
Help Menu
This online documentation for DesignModeler is provided as a set of HTML files in standard Microsoft HTML Help
for Windows. See Using Help for detailed usage instructions.
• ANSYS DesignModeler Help: Click this button to access the ANSYS Workbench Help. By default you are
taken to the DesignModeler section, where you can search by keywords.
Note — You can also access the online documentation by pressing the [F1] hotkey.
• Installation and Licensing Help: Click this button to access the ANSYS Workbench Installation and Li-
censing Help.
• About ANSYS DesignModeler: Click this button to access copyright, software build date and version,
and service pack version information.
Context Menus
Context menus are only accessible using the right mouse button.
Hide Body
Right clicking on a body in the Tree Outline and clicking Hide Body may hide the body. A light check mark icon
will appear in the Tree Outline when a body is hidden.
Right clicking on Hide All Other Bodies functions as the name implies.
Show Body
A body can be made visible by right clicking on the body in the Tree Outline and clicking Show Body. A solid
green check mark icon will appear in the Tree Outline when a body is visible.
Right clicking on Show All Other Bodies functions as the name implies.
Suppress Body
A body may be suppressed by right clicking on the body in the Tree Outline and clicking Suppress Body. An
“X” icon will appear in the Tree Outline when a body is suppressed.
Unsuppress
A body can be unsuppressed by right clicking on the body in the Tree Outline and clicking Unsuppress Body.
A solid green check mark icon will appear in the Tree Outline when a body is not suppressed.
Right clicking on Invert Suppressed Body Set functions as the name implies.
Note — For more information about body visibility and suppression, please see the Section : Body Status
section.
A part may be suppressed by right clicking on the Part branch in the Tree Outline and clicking Suppress Part.
The Suppress Part command suppresses all bodies that belong to the part. An “X” icon will appear in the Tree
Outline when a part is suppressed (all bodies are suppressed). If some bodies in the part are already suppressed
when the suppress command is clicked, they will remain suppressed and the unsuppressed bodies will become
suppressed.
Unsuppress Part
A part can be unsuppressed by right clicking on the Part branch in the Tree Outline and clicking Unsuppress
Part. If some bodies in the part are not suppressed when the Unsuppress Part command is clicked, they will
remain unsuppressed and the suppressed bodies will become unsuppressed. A solid green check mark icon will
appear in the Tree Outline when a part is not suppressed (not all bodies are suppressed).
Hide Part
Right clicking on the Part branch in the Tree Outline and clicking Hide Part may hide a part. The Hide Part
command hides all bodies that belong to the part. A light check mark icon will appear in the Tree Outline when
a part is hidden (all bodies are hidden). If some bodies in the part are already hidden when the Hide Part command
is clicked, they will remain hidden and the visible bodies will become hidden.
Show Part
A part can be made visible by right clicking on the Part branch in the Tree Outline and clicking Show Part. If
some bodies in the part are visible when the Show Part command is clicked, they will remain visible and the
hidden bodies will become visible. A solid green check mark icon will appear in the Tree Outline when a part is
visible (not all bodies are hidden). Bodies that are suppressed when Show Part is clicked will not be affected.
When you have model entities selected, you will be able to start a Named Selection feature through the context
menu. The Named Selection option is not available in the Sketching mode, feature creation, or edit selection.
The Form New Part feature is available only if bodies are selected and all of those bodies do not belong to the
same part, and you are not in the middle of an operation that creates or edits model features.
By default, DesignModeler places every newly created body by itself, into a new part. However, you can group
multiple bodies into a single part. Solid bodies, grouped as such, will have shared topology in Simulation and,
when meshed, will form distinct but contiguous regions within the part mesh.
Surface Bodies grouped in the same part may share the topology if they are used in creating a Joint, depending
on the choice/settings in the details of Joint.
To create a new part, select one or more bodies from the Model View window and use the Form New Part option
in the context menu (right mouse button).
A new part can also be formed by selecting multiple bodies in the Tree Outline and using the Form New Part
option in the context menu (right mouse button). Before a new part is formed, the selected bodies are removed
from any existing parts. The new part is appended to the bottom of the body list in the Tree Outline and any
parts that become empty are removed. For parts that contain multiple bodies, a part branch, containing multiple
bodies, will be denoted in the tree. Part branches will not be shown explicitly for single-body parts.
The Details View for a part contains the part name, which can be changed, and the number of bodies, volume,
surface area, and number of edges and faces associated with it.
To illustrate how grouping bodies into parts works, consider the following model with six bodies, named 1
through 6. Initially each body belongs to its own body group and no part branches are visible.
Now the odd numbered bodies are selected to form a body group. The result is that there are four parts; the first
three use the defaults, consisting of one body each; the last one is the newly formatted group of bodies named
“Part,” which can be expanded to show the three bodies within it. The part can then be renamed to “Odd Numbers.”
Suppose you now wish to group the prime numbers together. Bodies 2, 3, and 5 are selected and a body group
is formed. It can then be renamed to “Prime Numbers.” Note that the group named “Odd Numbers” now contains
only one body, so only body 1 is shown. Bodies 2, 3, and 5 are now grouped under the new part, “Prime Numbers.”
Explode Part
The Explode Part operation will separate the bodies contained within a part, changing them into single body
parts. To perform the operation, right click the part you want to eliminate in the Tree Outline and choose Explode
Part.
Result:
The operation may also be performed by selecting all the bodies that belong to a part in the Model View window,
then choosing Explode Part in the context menu.
Edit Selections
DesignModeler allows you to perform Section : Edit Selections for Features and Apply/Cancel via the feature's
context menu.
Feature Insert
DesignModeler allows you to insert a feature before a selected feature (branch in the feature Tree Outline) via
the right mouse button.
A feature menu item is only shown in the right mouse button submenu if the system supports inserting the
corresponding feature at the selected position in the tree. Note that Insert Feature will roll back the model to its
status before the selected feature (branch in the tree). Just as in Edit Selections, this is necessary so that you
can properly select model entities for the creation of the new feature (see example illustration below). When
inserting a feature or performing edit selections on a feature, the features that appear after the selected one will
become temporarily inactive until the model is regenerated. Inactive features appear gray in the Tree Outline.
Feature Suppression
Through the feature Tree Outline, you can suppress and unsuppress features. When a feature is suppressed,
that means it is ignored when the model is generated. There are four suppression options, though only two of
the four are available at a time.
•
Suppress: Suppresses the selected feature and features that depend on it.
•
Unsuppress: Unsuppresses the selected feature and all features that it depends on.
•
Suppress & All Below: Suppresses the selected feature and all features below it in the feature Tree
Outline.
•
Unsuppress & All Below: Unsuppresses the selected feature, all features below it in the feature
Tree Outline, and all features that they depend on.
The Show Problematic Geometry feature is available when faulty geometry associated with the error or undesired
state can be determined for a feature. Furthermore, it is only selectable for one feature at a time. The Show
Problematic Geometry feature will point out the faulty topology by selecting it and displaying an annotation
containing a description of the error. It is important to note that this option is not available for all errors or all
features. Only features in which additional error information is available can identify problematic geometry. Also
note that the availability of problematic geometry may depend on the state of the model. If a feature fails and
contains problematic geometry, that geometry must exist in the final model in order to be identifiable (e.g. if a
blend feature identifies an edge as problematic and a subsequent Extrude feature cuts material such that the
edge disappears from the model, then the problematic edge will not be available for viewing).
The Show Problematic Geometry option can only be accessed from the context menu of features in the Tree
Outline.
If selected, the Show Problematic Geometry option will point out the offensive geometry and highlight it.
If there are multiple faulty topologies available, then all of them will be highlighted and annotated. The maximum
number of problematic geometry that is shown on the screen at one time can be set in the Options control
panel.
Show Dependencies
The Show Dependencies option will display the parents and children of the selected feature. A parent is a feature
that the selected feature depends on. A child is a feature that depends on the selected feature. The Show De-
pendencies option will not appear for features that have no parents or children.
•
Keep Visible: Makes the selected sketch always visible, even when viewing another plane. Applies
only to sketches.
•
Don't keep visible: Returns the sketch to its normal viewing mode. The sketch will be visible if the
plane it belongs to is visible. Applies only to sketches.
•
Look At: Orients the display so that it is centered on the selected sketch or plane.
The Delete function is provided as a context menu option (right mouse button) whenever applicable within the
Model View window and Details View. For example, you can select a constraint or edge from the Details View,
click the right mouse button, and choose Delete.
The Delete function is also available in context menus (right mouse button) accessed in the feature Tree Outline.
A feature or sketch may be deleted if it is not used to define any other feature. Cross sections may be deleted if
they are not assigned to any line bodies. The Delete function can also be used to “Cancel” the creation of a new
feature.
Note — While a new feature is being created, no other feature in the model can be deleted.
Sketch Instances
Sketch Instances allow you to place copies of existing sketches in other planes. The edges in a sketch instance
are fixed just like a plane boundary and cannot be moved, edited, or deleted by normal sketch operations. When
changes are made in a base sketch, its instances will be automatically updated to match it when a Generate is
done. A sketch instance can be used just like normal sketches for creating other features. However, it cannot be
used as base sketches for Instances, and since it is designed to be a copy of the base sketch, you cannot go into
Sketching mode to edit/modify a Sketch Instance. Because you are not allowed to make a sketch instance 'active'
while in Sketching mode, they are not included in the drop down menu of sketches on the toolbar.
The basic steps to create a sketch instance are to first right click on the plane in the tree where you want to insert
the Sketch Instance.
Since a Sketch Instance must lie in a plane later in the tree than the base sketch (unless the base sketch is a
plane boundary), the XYPlane does not have an option for creating a Sketch Instance. The other two fixed planes
have the option Insert Sketch Instance, and for other planes, Sketch Instance is an option in the Insert portion
accessible via the right mouse button. Select the base sketch property in the Details View and then select the
base sketch, either from the tree, or in the graphics area if it has been made visible. Just selecting a single edge
of the desired sketch is sufficient. When you click on Apply, you will see the new Sketch Instance in the active
plane. Note that the selected sketch must be from a plane that is earlier in the tree than the active plane. Another
option for the base sketch is to select a plane in the tree that has boundary edges. These are planes made from
planar faces. The boundary edges will be treated just like a base sketch.
You can also modify the following properties to control the location, angle, and scale of the sketch instance:
• FD1, Base X: This, along with Base Y, sets a reference location in the Base Sketch.
• FD2, Base Y: See Base X above.
• FD3, Instance X: This, along with Instance Y, sets the location in the active plane where the Base X and
Y of the Base Sketch will be positioned. The Instance X and Y locations are also used as the central point
for rotation and scale.
• FD4, Instance Y: See Instance X above.
• FD5, Rotate Angle: This allows rotation about the Instance X and Instance Y location.
• FD6, Scale: This allows scaling in relation to the Instance X and Instance Y location. Scaling is limited to
a range of 0.01 to 100.0.
A Base Sketch can be used for multiple Sketch Instances. However, once you have used a sketch as a Base Sketch,
you cannot delete it until you have deleted all of its Sketch Instances.
Note that a base sketch must be in a plane prior to the current plane in the tree. This is because the location and
definition of the instance depends on the base sketch. If they were in the same plane, the location and definition
of the base sketch could be affected by constraints and dimensions to the fixed sketch instance. This would mean
that B depends on A, but A also depends on B, a circular definition that must be avoided. However, when the
base sketch is really a plane boundary (a plane is selected as the base sketch), this circular definition cannot occur
since the plane boundary is fixed. Because of this, an instance of a plane boundary is allowed to be in the same
plane as its base.
Measure Selection
A setting in the Options dialog box defines a limit at which DesignModeler will stop automatically measuring a
selection. This is intended to avoid doing CPU-intensive operations when the selection becomes complex. For
properties that appear in the Details View, such as volumes and surface areas, you will see three dots "..." instead
of the calculated value when the object exceeds the automatic calculation limit defined in the Options dialog
box.
You can always force the selection to be measured by right clicking on the property and choosing Measure Se-
lection. The Measure Selection option, if applicable, will appear in the Details View context menu and in the
Tree Outline context menu if a body or part is selected.
You can quickly edit a dimension's name and value by selecting the dimension, then clicking the right mouse
button and choosing the Edit Name/Value option as shown below.
A pop-up window will appear where you may modify the dimension's name and value. Note that for reference
dimensions, you may only modify the name.
Move Dimensions
To change a cross section dimension's location, use the right mouse button option, as explained in the Section :
Editing Cross Sections.
Go To Feature
When you have a model entity selected in the Model View window, the Go To Feature function is accessible
via the right mouse button.
The function allows you to find which feature generated the selected entity. The supported entities are faces,
edges, vertices, point feature points (PF points), and bodies. When a body is selected, this function will only show
the first feature used to generate the body. The corresponding feature will be selected in the Tree Outline.
Note — This operation may fail to identify the appropriate feature due to the extension of surfaces during
feature generation. It includes Body Operation and Surface Extension. Also the search may fail for Slice
when it is performed on surface or line bodies.
Select All
The Select All option will select all visible entities in the model, for the active selection filter you have chosen.
Shaded Display
Model faces are drawn, in normal “shaded” mode, but not model edges.
Wireframe Display
Model edges are drawn, but not model faces. The edges are drawn in two colors, one for shared edges, the other
for unshared edges. The edge colors are determined by the DesignModeler Options dialog.
Note — The solid display for line body edges is done by sweeping the cross section along the edge. The
sweep may fail to be displayed properly if the cross section dimensions are so large that the sweep be-
comes self-intersecting. In this case, the edge is drawn without a solid facet representation.
Triad
To toggle the triad orientation symbol in the display screen at all times, single-click the left mouse button on
the Triad button in the View menu. The triad symbol is on by default.
The interactive Triad in the bottom right corner of the window contains viewing and informational controls.
Ruler
To toggle the ruler in the display screen, single-click the left mouse button on the Ruler button in the View menu.
You can use the ruler, shown at the bottom of the Graphics Window, to obtain a good estimate of the scale of
the displayed geometry. The ruler is on by default.
The following is displayed when you use the right mouse button in both the Sketching and Modeling modes.
• Section : Rotate
• Section : Pan
• Section : Zoom
• Section : Box Zoom
• Front View: To view your part from the front, click on the Front View button.
• Back View: To view your part from the back, click on the Back View button.
• Right View: To view your part from the right, click on the Right View button.
• Left View: To view your part from the left, click on the Left View button.
• Top View: To view your part from the top, click on the Top View button.
• Bottom View: To view your part from the bottom, click on the Bottom View button.
• Isometric View: The Isometric View allows you to view in 3D any time.
Display Toolbar
Use the display buttons to manipulate how triads, models, faces, planes and sketches are displayed in the
graphics Window.
Display Plane
The Display Plane button allows you to toggle between displaying the axis vectors and origin point (if there is
not a 3D model), and to toggle between displaying the axis vectors, origin point, and boundary edges (if there
is a 3D model). If you turn off the axis vectors, origin point, and boundary edges, the 3D model is turned on
automatically.
Display Model
The Display Model button allows you to toggle between displaying the 3D model or not. If you turn off the 3D
model, the plane is turned on automatically.
Look at Face/Plane/Sketch
The Look at Face/Plane/Sketch button centers the display on the currently selected Face, the currently active
Plane, or the currently active Sketch.
Rotation Modes
Use the rotation modes to manipulate the position of items displayed in the Sketch/Model Window.
Rotate
The Rotate tool allows you to rotate any sketch, model, or part. The cursor location and shape determine the
rotation behavior.
Pan
The Pan tool allows you to move the entire part about the display screen.
Zoom
The Zoom tool allows you to scale the part on the display screen.
Box Zoom
The Box Zoom tool allows you to use the cursor to indicate opposite corners of the zoom window.
Zoom to Fit
The Zoom to Fit tool allows you to show the part at full size in the display screen.
Magnifier Window
The Magnifier Window tool allows you to zoom in to portions of the model. With the model in any state, you can
display the Magnifier Window by clicking the button in order to:
• Pan the Magnifier Window across the model by holding down the left mouse button and dragging the
mouse.
• Increase the zoom of the Magnifier Window by adjusting the mouse wheel, or by holding down the middle
mouse button and dragging the mouse upward.
• Recenter or resize the Magnifier Window using a right mouse button click and choosing an option from
the context menu. Recenter the window by choosing Reset Magnifier. Resizing options include Small
Magnifier, Medium Magnifier, and Large Magnifier for preset sizes, and Dynamic Magnifier Size
On/Off for gradual size control accomplished by adjusting the mouse wheel.
Standard model zooming, rotating, and picking are disabled when you use the Magnifier Window.
Previous View
To return to the last view displayed in the graphics window, click the Previous View button on the toolbar. By
continuously clicking you can see the previous views in consecutive order.
Next View
After displaying previous views in the graphics window, click the Next View button on the toolbar to scroll forward
to the original view.
Isometric View
Isometric View Button
The Isometric View button allows you to view your model in an isometric state.
Set Button
The ISO icon button allows you to set the isometric view. You can define a custom isometric viewpoint based
on the current viewpoint (arbitrary rotation), or define the “up” direction so that geometry appears normally
oriented.
The Restore Default icon button resets the isometric view to its default state.
Keyboard Support
The same functionality is available via your keyboard. The numbers correlate to the following functionality:
0 = View Isometric
1 = +Z Front
2 = -Y Bottom
3 =+X Right
4 = Previous View
5 = Default Isometric
6 = Next View
7 = -X Left
8 = +Y Top
9 = -Z Back
. (dot) = Set Isometric
Print Preview
A tab at the lower left corner of the sketch window shows that by default, the system is in the Model View. To
the right is the Print Preview tab. Clicking it allows you to print the current view of your model or save a screen
shot.
The lines at the top of the Print Preview page contain several fields describing the model. The text for some of
the fields is determined by the properties in the model branch, which is the first branch in the Tree Outline.
To print the model, use the Section : Print option in the File menu.
Window Layout
The window layout in the ANSYS Workbench environment implements a docking pane configuration that allows
you to shift and size the individual panes to your liking.
To create a solid body from your sketch, all connected chains of edges must be closed.
Many sketching operations make heavy use of the right mouse button context menu for optional input.
Some also have optional input via toolbox check/edit box options. In the following, these options are
listed after the operation's icon:
The right mouse button Back option is very much like a “micro” undo during the sketching operation.
The sketching operations support Undo/Redo functionality, but note that each plane stores its own
Undo/Redo stacks.
Also note that while in Sketching mode, you can always exit whatever function you are in and go to the
general Select mode, by pressing the [ESC] key. Note that if you have accessed a window external to the
DesignModeler, you will need to click somewhere back in the DesignModeler window before the [ESC]
key will be usable.
Undo
Use the Undo command to rescind the last sketching action performed.
Redo
Note — Sketch Instances (accessible via the Context menus) allow you to place copies of existing sketches
in other planes.
Points are created automatically at the ends of 2D edges. The points can then be used for dimensions and con-
straints. Additionally, there are options in the Section : Draw Toolbox to create a point at a screen location or at
the intersection of 2D edges.
Construction Sketches
One very important use of having multiple sketches in a plane is to use one sketch just for construction geometry.
You can name this sketch “Construct” or something similar to remind you that it is for construction geometry.
This sketch can be used for geometry that is useful for the construction or constraints on other geometry, but is
geometry that you do not wish to be included in a feature.
For example, if you want to create a circular pattern of holes, it can be difficult to constrain/dimension these so
that they remain in the pattern you want, especially if you want the option of later modifying the radius of the
pattern.
An easy way to deal with this is to create a construction sketch and then create a polygon in that construction
sketch, with the same number of sides/vertices that you want for the pattern of holes. Then constrain/dimension
the polygon so that the vertices are where you want the circle centers to be.
Finally, go back to the sketch where you want real geometry created and create the circles, with each circle
center coincident with one of the polygon vertices. Now you can modify the radius of the polygon, or rotate it,
and the circles will move with it. However, if you extrude the sketch with the circles, the polygon is ignored.
Another simple example is if you want a series of circle centers to be linear, you can simply create a line in a
construction sketch and constrain all of the circle centers to be on that line.
Color Scheme
2D entities are colored to indicate their constraint status. The colors will help you to identify sketch entities that
may require constraints or are in error. There are five colors used to denote the status of a 2D entity:
• Teal: Under-constrained
• Blue: Well Defined
• Black: Fixed
• Red: Over-Constrained
• Gray: Inconsistent or Unknown
Auto Constraints
During drawing input, if the Auto Constraints Cursor mode is on, symbols are displayed confirming snapping to
either of:
Note — Cursor and Global Auto Constraint modes can add noticeable time to sketch operations on very
complex sketches, so you can control whether or not you want them on (see Auto Constraints on the
Constraints menu).
All the detail views are broken into groups, listed in boldface and proceeded by a [-], followed by the information
that pertains to that group. Items within a group have a title on the left followed by a value on the right. The
value column may be grayed-out, if the item is read-only, and cannot be edited.
Sketch Details
Details of Sketch
The first item under the Details of Sketch group, lists the sketch name in a value field that can be edited. This allows
you to change the name of a sketch. All names and labels that you create must be unique, start with a letter, and
contain only letters, digits and underscores. Spaces and hyphens are not recognized. If your supplied name does
not end in a numeric and is not unique, a numeric will be added at the end. For example, MyPlane becomes
MyPlane2, and MySketch5 becomes MySketch6.
The next item in this group is 'Show Constraints,' and its value can be Yes or No. Changing this value has a major
effect on how the rest of the Sketch Detail View will look, as will be explained below.
Clicking the 'Details of' group selects the sketch and highlights all the edges in the sketch.
Dimensions: n
The 'Dimensions: n' group lists the dimension, where 'n' is the number of dimensions created with this active
sketch. This group will not appear if there are no dimensions as part of the sketch. If there are dimensions, they
will be listed item by item. Their appearance depends on whether or not they are Reference dimensions. If it is
a Reference dimension, its name is displayed enclosed in parenthesis in the title area, and its value is displayed
in a read-only background value field. Otherwise, if the dimension is not a Reference dimension, then the title
field is preceded with a check box (provided the model has been saved to a file and has a valid model name)
which, once checked, will be marked with a “D” indicating that the dimension is driven by a Design Parameter.
Once a dimension is driven by a Design Parameter, its value field becomes read-only.
If a dimension's value field is not read-only, then you can select it and change the value. The sketch(es) on this
plane will then be updated to reflect this change. You can then click Generate to have this change reflected in
your 3D model.
In general, you can select any dimension by selecting it in the Model View area, or by selecting it in the details
view. If you select the “Dimensions: n” group, all the dimensions in the sketch are selected and highlighted.
Edges: n
The “Edges: n” group, lists the edges contained in the sketch, where 'n' is the number of edges in the sketch. The
format of this group is strongly affected by the setting of the “Show Constraints” switch above. If the switch is
set to “No”, then each of the edges is listed as an element of this group, with its type as the title, and its value
the name of the edge. If the switch is set to “Yes”, then each of the edges is listed as its own group, 'Edge Type
Name,' containing a list with constraints that are applied to that edge.
If you select the “Edges: n” group, all of the edges are selected.
Selecting one of the constraints actually selects the constraint, though these cannot be seen, and highlights the
edges involved in the constraint. If you select one of the constraints, and then hit Delete, the constraint is deleted,
not the highlighted edges.
Points: n
If the “Show Constraints” switch above is set to “No,” and you have created construction points while this sketch
was active, these construction points are listed in the 'Points: n' group, where 'n' denotes their number. If the
constraint switch is set to “Yes,” then they are created as “Point Name” groups and appear identical to the “Edge
Type Name” groups above.
References: n
The 'References: n' group lists points and edges in other sketches that are directly connected to points or edges
in this sketch via constraints or dimensions. The origin point and axis lines for the plane are not listed here, but
if you have more than one sketch in your plane and put a dimension between an edge in one sketch and an
edge in another sketch, you will see this group show up.
You can select items in this group and they will be highlighted and selected. However, selecting the group itself
has no effect.
Edge Details
Next, there will be an item with the title “Constraint Status”, and a value such as Fixed, Under-Constrained, Over-
Constrained, Inconsistent, Well Defined, or Unknown. An example of Inconsistent would be if you created a triangle
and dimensioned the lengths of the sides, then changed their values such that they were 10, 20, and 50. This is
not possible and would lead to an Inconsistent constraint status on one or more of the edges. When you have
one or more edges with an Inconsistent or Over-Constrained status, the status of other edges sometimes cannot
be determined. When this happens, you may see the Unknown status appear. If an edge has a status of Under-
Constrained, an additional item will appear with the title “Constraints Needed” and a value of Position, Angle,
Radius, or a combination of these depending how the item can still change based on its current constraints.
After the constraint status item, each constraint on the edge is listed, with the related edge in the value field.
Following this there are Point Name groups for each of the edge's base, end, and center points, when appropriate.
These will show the X and Y position of the point, its constraint status, and the constraints on the point.
You can select items in the Edge Details similar to selecting from the Sketch Details. When you create something
new, you are returned to the Sketch Details. You can also return there by clicking the New Selection icon.
Dimension Details
Details of NAME
When you select a dimension in the Model View area, the Dimension Details appear. The first group in the Di-
mension Details is always 'Details of NAME,' where NAME is the name of the selected dimension. The first item
in this group identifies the dimension type, and lists the dimension's name in the value field, which can be edited.
Note that dimension names must be unique, and if the name you supply ends with a numeric, it will be modified
to find a unique name. If your supplied name does not end in a numeric and is not unique, then a numeric will
be added at the end. The next item lists the Value. If the value field is not read-only, then you can modify it.
Clicking Generate will then propagate that change through the 3D model.
The following items identify the points or edges associated with this dimension. Then, the next item allows you
to state whether or not this is a Reference Only dimension. If it is, you will not be able to change its value and its
name will be shown enclosed in parentheses, and its value can change as the sketch is changed. Finally, there
is a switch that allows you to prevent the position of this dimension from automatically being updated when its
associated geometry moves.
To go back to the Sketch Details, you can select the Active Sketch Drop Down menu on the toolbar, or [ESC] can
be used to clear the selections and go back to the Sketch Details. Note that if you have accessed a window ex-
ternal to DesignModeler, you will need to click somewhere back in DesignModeler window before the [ESC] key
will be usable.
Draw Toolbox
The Draw toolbox is displayed by default when you enter the Sketching mode. Use the tools to draw 2D edges
and apply dimensions and constraints.
Note — Sometimes not all of the toolbox items can be displayed at once. Use the up and down arrow
buttons to the right of the toolbox categories to scroll up and down though the available toolbox items.
Line
Use the cursor to indicate a start and end for the line.
Tangent Line
To maintain tangency between a line and an edge, use the Tangent Line tool. Click on an existing edge or endpoint
to start the line. It will rubber band as tangent to the selected edge and you can then indicate the length of the
line. The rubber band line will not stay under the cursor, but instead, its length will be based on the cursor location,
while its start and direction are controlled by the selected edge. To ensure that you are tangent to the end of an
edge, select its endpoint, not the actual edge.
Line by 2 Tangents
To create a line tangent to two edges (or points), use the Line by 2 Tangents tool. Select two edges or points
near the desired tangent location on each edge. The defined line will start and end at the tangency location on
each selection.
Polyline
Right Mouse Button Context Menu: Open End, Closed End, Back
To draw a closed or open polygon, use the Polyline tool. The Polyline tool allows you to draw a series of connected
lines. You need to use one of the right mouse button options, Open End or Closed End, to finish your input and
actually define the lines.
Polygon
The Polygon tool allows you to draw regular polygons with n = 3-36 sides. You set the number of sides via an
edit box on the toolbox item. Then you enter a center location and the location of one of the vertices. The polygon
is then created, along with a center point. This center point is important to the polygon, as a special type of in-
ternal constraint is created to maintain the polygon's shape, even when you rotate or resize the polygon. If you
delete the central point, the internal constraint is deleted and the polygon may no longer maintain its shape
when changes are made to it. The edges of the Polygon are lines, just like those you could create with the basic
Line function, or Polyline. The main difference is that this internal constraint makes sure the polygon retains its
shape. If you select a center point of a polygon, you will see in its detail view that it lists 'Polygon Center', with
the number of sides for the full polygon show to the right. If you select one of the edges, it lists 'Polygon Edge'
as one of its constraints and shows the center point of the polygon to the right.
You can delete lines from the polygon and it will still maintain its shape, as long as the center point and at least
three edge lines remain. However, when a polygon line is deleted, the adjacent lines remain in the correct location
and angle, but the neighboring endpoints can be either trimmed back or extended without violating the polygon
shape. When making copies of a polygon with Cut/Copy/Paste/Move/Replicate, you need to either select all of
the lines of the polygon, or the center point (in which case all lines will be processed as though they were selected).
If you do not select all the lines, or the center point, copies will not have the internal constraint that maintains
the polygon shape. The screen shot below shows some sample polygons. The one at the lower left has had three
lines deleted from it. Also shown are some Line and Point entries in the Sketch detail view, with constraints
shown.
Rectangle
To proportionately draw a rectangle with a horizontal/vertical orientation, use the Rectangle tool. It allows you
to draw a horizontal and vertical oriented rectangle (defined by four edges), by indicating opposite corners.
The Auto-Fillet option, if checked, allows you to indicate one more location to provide the radius for corner arcs.
If your radius is too large for all four of the corners, the narrow ends of the rectangle will be replaced with 180°
arcs.
Rectangle by 3 Points
To draw a rectangle at an angle by specifying three of the four corners, use the Rectangle by 3 Points. It allows
you to draw a rectangle (defined by four edges) at any angle. Your first two-cursor indications define the length
and direction of one side of the rectangle. Your third indication determines the length of the sides perpendicular
to the initial side.
The Auto-Fillet option, if checked, allows you to indicate one more location to provide the radius for corner arcs.
If your radius indication is too large for all four corners, the narrow ends of the rectangle will be replaced with
180° arcs.
Oval
To draw an oval, use the Oval (four edges) tool. Indicate the center of the two circular end caps, and then indicate
their radius.
Circle
To draw a circle, use the Circle tool. Indicate the center and then the radius.
Circle by 3 Tangents
To draw a circle using three tangents, use the Circle by 3 Tangents tool. Select three points or edges near where
you want a tangent circle created. A circle will be created that is tangent to the selected edges, or passing through
the selected points.
Arc by Tangent
To draw an arc by tangent, use the Arc by Tangent tool. Select an edge or endpoint to start a tangent arc. An arc
is then rubber banded. You control the radius and angular extent of the arc with the cursor. Which way the arc
curves from your initial selection depends on your cursor position. If you imagine a tangent line extending out
from this first location, which side of that line your cursor is on effects the direction the arc curves. Also, if you
want the second end of the arc to be tangent to another curve, watch for the 'T' to be displayed, if you have the
Section : Auto Constraints Cursor turned on, when selecting the second curve. You can use the right mouse
button Reverse option to reverse the initial direction of the arc. If you want it to be tangent to the end of an
edge, be sure to select its endpoint instead of the edge itself. If you select a center point, Section : Construction
Point, or nothing at all, a 180° arc will be created.
Note — If you are selecting a point where there is more than one possible endpoint, and not getting the
direction you want, then instead select the edge as close as possible to its end. That way, Auto-Constraints
should still snap the arc to the edge endpoint.
Arc by 3 Points
To draw an arc using three points, use the Arc by 3 Points tool. Indicate the start and end of an arc, then the final
indication controls the side and radius of the arc.
Arc by Center
To draw an arc from a center point, use the Arc by Center tool. Indicate a center and then drag the cursor to in-
dicate the radius, just as though you were creating a full circle. After that, however, use the radius indication as
the start angle of the arc, and a third indication gives the end angle. When moving the cursor for the third location,
the Arc can be created in either direction from your second location. However, once the Arc being rubberbanded
exceeds 90°, that locks in the direction from the second location, allowing you to continue moving the cursor
to create Arcs greater than 180° if desired.
Ellipse
To draw an ellipse from a center point, use the Ellipse tool. Indicate the center and then the end of one axis of
the ellipse to determine the angle of the ellipse. Use the third indication to determine the length of the other
axis of the ellipse.
Ellipses and elliptical arcs (trimmed/partial ellipses) can be difficult to properly constrain and dimension. One
very important thing to remember regarding this is that you can use the Section : Parallel constraint with them.
This will set the major axis parallel to a line or another ellipse. If you don't want the line in your sketch, you can
put it in a separate 'construction' sketch. Also, dimensioning or constraining the center point and using the min
and max radius dimensions are useful techniques for ellipses.
Finally, tangent constraints are also useful. You can even create a rectangle (by 3 points so it can be at an angle)
in a 'construction' sketch; make the ellipse parallel to a long side of the rectangle; and then make the ellipse
tangent to each of the sides.
Spline
Right Mouse Button Context Menu: Open End, Open End with Points, Closed End, Closed End with Points,
Back
To draw a closed or open spline, use the Spline tool. Create the spline by indicating a series of control points and
then use the right mouse button to finish the spline either Open End or Closed End, with Points or without
Points. The with Points options will create points at the locations used to create the spline that are associated
with the spline, like the center points of circles. These points have a special form of coincident constraint to the
spline that prevents them from sliding along the spline.
Flexible Splines
To create a flexible spline, click on the toolbox check/edit box beside the Spline feature.
The 'Flexible' check box can be used to decide whether you want the spline you create to be rigid (default), or
flexible (if you check the box). A rigid spline can be moved or rotated, but its actual shape will not change (unless
you later change it to flexible). You can change the shape of a flexible spline by assigning constraints (e.g. tangent
lines at its endpoints), dimensions, or by using the Drag function to move defining points, tangent curves, or
other edges that are related to the spline via constraints or dimensions. Note that if you create a spline 'with
Points', those points remain at fixed locations along the curve. These are very useful for dragging to modify the
shape of the spline. The Section : Edge Details for a spline contains a line that allows you to change whether of
not you want a spline to be flexible or not. Note that currently, if you create a Closed spline, it will be set to non-
flexible, no matter what the setting of the Flexible option is and cannot be changed in the Section : Edge Details.
Construction Point
Points are automatically constructed during edge creation at edge end points and/or center. This option allows
the cursor input of additional points, which, may or may not lie on edges.
This option will place a point at the intersection of two selected edges. If the edges do not intersect, but their
extensions would, this extended intersection will be found.
Note — If the curves intersect at more than one location, your selection locations will determine which
is created.
Modify Toolbox
Use the Modify toolbox to edit your sketches.
Fillet
You can draw a fillet for intersecting and non-intersecting edges. Select an endpoint connecting two edges, or
two edges or points to place a tangent arc of the specified radius between them. The selection locations are
used to determine both where to place the tangent arc, and which end of the selected edges to trim (or extend)
to the tangency location. You can use the right mouse button options to control the trimming of the selected
edges, or to optionally create a full circle with no trimming.
Chamfer
You can draw a chamfer for intersecting and non-intersecting edges. Select an endpoint connecting two edges,
or edges to create a chamfer line “breaking” the corner between them. The length specified is the distance from
the intersection location of the edges to each of the endpoints of the chamfer line.
Corner
Select two edges to trim or extend as needed to their intersection location. Where you select the edges determines
which end of the edge is modified.
Trim
Select an edge in an area where you want it to be trimmed. The portion of the edge up to its intersection with
other edge, axis line, or point will be removed. If the edge does not intersect anything, it will be deleted. If the
Ignore Axis box is checked, then axis lines will be ignored when determining the trim extent.
Extend
Select an edge near the end of the edge that you want extended to its intersection with another edge, axis line,
or point. If you have previously trimmed a spline, Extend can be used on it. However, it cannot extend a spline
beyond the ends of its original definition. If the Ignore Axis box is checked, then axis lines will be ignored when
determining extensions.
Split
There are several distinct right mouse button options to this function, so be sure to choose which you want before
selecting an edge.
Split Edge at Selection: Set as the default option, it splits an edge into two pieces at the selection location, unless
the selected edge is a full circle or ellipse. If it is a full circle or ellipse, both start and end endpoints are created
at the selection location.
Split Edges at Point: Select a point, and all edges, which pass through the selected point, are split there.
Split Edge at All Points: Select an edge and it is split at all points that it passes through and that have a coincident
constraint to it.
Split Edge into n Equal Segments: Set the value n in the edit box and then select the edge which you want to
Split.
Variable Text
The Split toolbox has variable text, depending on which Split right mouse button option you select. Moreover,
the n= number edit box only appears when the Split Edge into n Equal Segments option has been selected.
Note — A value up to 100 is allowed for n. If you attempt to set the value to more than 100 the prevously-
set value is retained.
Drag
Select a point or an edge to “drag” using the cursor. How the model will change depends on both what you select,
and existing constraints and dimensions on the model. You can drag a group of edges by preselecting them
before choosing this tool.
Cut
This lets you select a set of items to copy to an internal clipboard, and then deletes the originals from the sketch.
Copy
Right Mouse Button Context Menu: Clear Selection, End / Set Paste Handle, End / Use Plane Origin as
Handle, End / Use Default Paste Handle
Right Mouse Button Context Menu: Clear Selection, Use Plane Origin as Handle
Cut/Copy requires the selection of a paste handle relative to which the Paste will be performed. The paste handle
is the location to which the cursor is attached while you are moving the image into position to paste. The basic
sequence is:
This lets you select a set of items to copy to an internal clipboard, and leaves the originals in the sketch.
If Cut/Copy are used with preselection, the right mouse button is the same as after End / Select Paste Handle
is chosen: (Clear Selection, Use Plane Origin as Paste Handle)
If Cut or Copy is exited without selecting a paste handle, a default will be used.
Dimensions to axis lines, origin point, or unselected items will NOT be processed. An attempt will also be made
to preserve as many constraints on the selected items as possible. Note that Horizontal/Vertical dimensions and
constraints are converted to the opposite in a 90° rotation at Paste time. At any other rotation angle, these di -
mensions and constraints will not be pasted.
Paste
This lets you take items placed on the clipboard by Cut or Copy and place them into the current (on new) sketch,
even if it is on a different plane.
Whatever you place on an internal clipboard by Cut or Copy, you can place either in the same plane or on another
plane. The edges are dragged, relative to the previously selected paste handle. By changing r and f, and then
using the right mouse button options, the edges to be pasted can be rotated or scaled. The Change Paste Handle
option displays symbols at each of the selected curves endpoints and/or center plus a symbol that represents
the plane origin relative to where the curves were when they were Cut or Copied. The symbol nearest the cursor
is displayed different than the others. Once you click to select the nearest symbol, that location will now be used
as the paste handle (location that is attached to the cursor). You can paste multiple times.
Move
The Move command functions the same as the Replicate command with the exception that your original selection
is moved to a new location instead of being copied.
Dimensions to axis lines, origin point, or unselected items will NOT be processed. An attempt will also be made
to preserve as many constraints on the selected items as possible. Note that Horizontal/Vertical dimensions and
constraints are converted to the opposite in a 90° rotation at Paste time. At any other rotation angle, these di -
mensions and constraints will not be pasted.
Replicate
Right Mouse Button Context Menu: Clear Selection, End / Set Paste Handle, End / Use Plane Origin as
Handle, End / Use Default Paste Handle
Right Mouse Button Context Menu: Clear Selection, Use Plane Origin as Handle
Right Mouse Button Context Menu: Rotate by r Degrees, Rotate by -r Degrees, Flip Horizontally, Flip Vertically,
Scale by Factor f, Scale by Factor 1/f, Paste at Plane Origin, Change Paste Handle, End
After one of the End / options is selected, the right mouse button changes to the Paste right mouse button.
If Move/Replicate are used with preselection, the right mouse button is the same as after End / Select Paste
Handle is chosen: (Clear Selection, Use Plane Origin as Paste Handle)
Dimensions to axis lines, origin point, or unselected items will NOT be processed. An attempt will also be made
to preserve as many constraints on the selected items as possible. Note that Horizontal/Vertical dimensions and
constraints are converted to the opposite in a 90° rotation at Paste time. At any other rotation angle, these di -
mensions and constraints will not be pasted.
Offset
Right Mouse Button Context Menu: Clear Selection, End Selection / Place offset
The Offset function allows you to create a set of lines and arcs that are offset by an equal distance from an existing
set of lines and arcs. The original set of lines and arcs must be connected in a simple end-to-end fashion and can
form either an open or closed profile. You can either preselect the edges, or select them within the function and
then choose the right mouse button option “End selection / Place offset” when finished with the selection process.
Now, as you move the cursor around, its location is used to determine three things:
• Offset distance
• Offset side
• Offset area
The first two are fairly clear, but the third is also very important. If portions of your selected curves would collapse
out or cross over one another given the current offset side and distance, the cursor location determines which
area of offset curves is kept. With large offset distances and collapsed areas, some unique results will occur if the
cursor is placed in areas that should be removed. However, by placing the cursor in desired areas, you should
find that this method of allowing you to select the desired offset area allows for the offset of many very complex
shapes.
Also, remember that if the offset does not give you exactly what you want, you can easily use the Trim and Extend
functions to make minor changes later.
To create the new curves, click the mouse when you are satisfied with what is displayed. You can then create
additional offsets, or use the right mouse button to clear the selection or exit the function. Once you have created
a set of offset curves, a single distance dimension between an original curve and its offset will control the spacing
of all curves in the offset.
At this point, you cannot change the offset distance via a dimension to any value that would cause more curves
to collapse out (e.g. a radius that becomes zero or negative).
If you show the constraints in the Sketch detail view, you will see that multiple Equal Distance constraints have
been created between the curves. This is what maintains the spacing.
Offset Examples
The first image below contains a simple rectangle with a circular cutout on the top. For this illustration, these
edges have a fixed constraint and appear as black. It has been offset three times to the outside and three times
to the inside. Sketching pencil symbols are shown where the cursor was placed for each offset.
On the first inside offset, closest to the profile, you will see that all the curves have been offset and trimmed ap-
propriately. On the next inside offset, you will notice that the line on the upper left of the original profile has
been eliminated as it has collapsed out. Finally, on the third inside offset, you will see a single triangular shape
(with an arc for one side) as at this distance, offsetting the bottom line and the top arc intersect, splitting the
result into two possible areas. The cursor location determines that this is the result.
Now, looking at the first outside offset, you will see that the arc has been extended to its intersections with the
top line offsets. In the second outside offset, the lines would no longer intersect the arc, so the arc is 'extended'
with tangent lines from its ends. Finally, on the third outside offset, the radius of the arc has collapsed to zero or
less, so it is eliminated.
The second image below shows a line with a simple rectangular notch, repeated three times, and again in each
case the original curves are fixed so they show up as black. Also again, sketching pencil symbols are shown where
the cursor was placed for each offset. In the upper part of the image, it has been offset such that the notch has
been collapsed out. In the center part of the image, the cursor was placed in the area being collapsed out. This
is to illustrate the importance of where you place the cursor! In the lower area, you can see how a single dimension
makes the entire offset profile fully constrained.
Dimensions Toolbox
Use the Dimensions toolbox to define your sketch.
Note — Because the numbers for dimension names begin at 1 for each plane, there can be, for example,
H1 and V2 in many different planes. They remain unique as the name is associated with the plane to
which they belong. When creating dimensions, while placing the dimension on the plane, you can click
the right mouse button to Cancel (delete the current dimension), change whether or not a dimension
automatically changes position when its associated geometry changes, or select Edit Name/Value. This
will pop up a dialog box that allows you to change the name and/or value before indicating the location
for the dimension. For Reference dimensions, or dimensions being created with Section : Semi-Automatic,
you can only modify the name, not the value. You can also access the pop-up dialog via the right mouse
button when you select a dimension from the general select mode.
General
Right Mouse Button Context Menu: Horizontal, Vertical, Length/Distance, Radius, Diameter, Angle
Allows creation of any of the dimension types, depending on what edge(s) and right mouse button options are
selected. When you use a single edge for Horizontal, Vertical, or Length/Distance dimensions, the dimension is
actually to its endpoints.
After Horizontal, Vertical, Length/Distance, selected: (Horizontal, Vertical, Length/Distance, Angle, Select Pair,
Cancel)
After Sketch (straight) line selected: (Horizontal, Vertical, Length/Distance, Angle, Select Pair, Cancel)
After Radius, Diameter, or a sketch circle or ellipse selected: (Radius, Diameter, Select Pair, Cancel)
Horizontal
Select two points or edges to create a horizontal dimension between them, then choose a position for the di-
mension text. You can choose lines for the dimension, but they are not actually used. Instead, the endpoint
nearest your selection is used. The selection location determines which side of a circle or ellipse (or its arc) is
used. Splines are not selectable for this function, but their endpoints can be used.
Note — The Dimension measures only the distance in the horizontal (x-axis) direction. Any vertical distance
is ignored.
Vertical
Select two points or edges to create a vertical dimension between them, then choose a position for the dimension
text. You can choose lines for the dimension, but they are not actually used. Instead, the endpoint nearest to
your selection is used. The selection location determines which side of a circle or ellipse (or its arc) is used. Splines
are not selectable for this function, but their endpoints can be used.
Note — The Dimension measures only the distance in the vertical (y-axis) direction. Any horizontal distance
is ignored.
Length/Distance
The Length/Distance dimension measures the true distance between two selected points or edges. The selection
location determines which side of a circle or ellipse (or its arc) is used. Splines are not selectable for this function,
but their endpoints can be used.
Radius
Select a circle or ellipse, or their arcs for this tool. If you select an ellipse or elliptical arc, either its major or minor
radius will be dimensioned, depending on the selection location, and whether another dimension already exists.
Diameter
You can select a circle or circular arc, though this is usually used on full circles.
Angle
Select two lines to create an angle dimension between them. By varying the selection order and location, you
can control whether you are dimensioning the acute, obtuse, or 360° minus the acute or obtuse angle. The selection
process gives you the flexibility to create any kind of angle dimension you may want. Imagine the intersection
of the two lines as the center of a clock. Then the end of the lines that you select nearest will be the direction of
the hands on the clock. Finally, the dimension will measure the angle counter clockwise from the first selected
line to the second. You may then position the text of the dimension where you want it.
The Alternate Angle right mouse button option allows you to switch to any of the four possible angles by re-
peatedly selecting this option.
Semi-Automatic
The Semi-Automatic tool will present a series of dimensions for you to place to help fully dimension your model.
For each dimension presented, you have the option of placing it where you want it, or using the right mouse
button options:
Skip: Delete this dimension and do not place it on the sketch. Go on to the next possible dimension.
Exit: Delete this dimension and exit the tool without offering any more dimensions to place.
Continue: Ignore the right mouse button and continue to allow this dimension to be dragged into position.
Edit
Allows you to edit the name and value of a dimension, or change its Reference dimension flag. If you set it to be
a Reference dimension, you cannot change its value to change the model. Instead changes to the model will
change the value of a Reference or driven dimension. Note that Reference dimensions are displayed inside par-
entheses.
Note — The dimension value can also be edited in the Section : Sketch Details.
Move
The Move tool allows you to reposition an existing dimension. Simply select a dimension to move, then click
again to define its new location.
Animate
The Animate tool allows you to see the effect that changing a dimension through a range of values would have
on the sketch. You can set a minimum and maximum scale in the Options dialog box to apply to the dimension.
The system will run through several cycles (set in toolbox edit box) of modifying the selected dimension between
its value times the minimum factor and its value times the maximum factor. The right mouse button speed se -
lections determine how many intermediate steps are calculated and displayed, thus effecting the speed of the
animation. The speed will also be effected by the complexity of the sketches in the current plane. The sketch will
return to its original state when finished.
Display Name/Value
The Display Name/Value command allows you to decide whether to display dimension names, values, or both.
Constraints Toolbox
Use the Constraints toolbox to define relationships between sketch elements and reference planes.
Fixed
Select a 2D edge or point to prevent it from moving. For an edge, this does not fix the locations of its endpoints
unless “Fix Endpoints” is checked. They can still move along the curve. Endpoints may also be selected to apply
a Fixed constraint to them after which they can no longer move. When a point is selected to make it Fixed, all
points coincident to it are also made Fixed.
Horizontal
Select a straight line. The Horizontal constraint forces a selected line to a position parallel to the X-axis. If an ellipse,
or elliptical arc is selected, its major axis will be forced parallel to the X-axis.
Vertical
Select a straight line. The Vertical constraint forces a selected line to a position parallel to the Y-axis. If you select
an ellipse, or elliptical arc, its major axis will be forced parallel to the Y-axis.
Perpendicular
Select two edges as close as possible to the location where they, or their extensions, would cross. The Perpendic-
ular constraint ensures that, where the two edges cross, they (or if curves, their tangents) are at 90° to each other.
Using preselect, you can select an edge and a series of other edges to be perpendicular to the first edge before
selecting this function.
Tangent
Select two edges as close as possible to the location where they are to be tangent. The selection location controls
which side of a circle the Tangent constraint applies. Also, the tangency can occur outside of the displayed portion
of a curve. For example, a line can be made tangent to a circle that is far from it. Using preselect, you can select
an edge and a series of other edges to be tangent to the first edge before selecting this function.
Coincident
Select two points, two edges, or a point and an edge as near as possible to the location you want them to be
coincident. The coincident location can be outside the displayed portion of either edge. For example, you can
make a point coincident with a line even though the point does not lie on the displayed line segment. Using
preselect, you can select an edge and a series of other edges to be coincident to the first edge before selecting
this function. The selected edges must be of the same type, or one of them must be a point. You cannot make
two splines coincident.
If you have two or more points that are at, or near the same location and you want to assign them as all coincident,
a good way to do it is to preselect using box selection with only points allowed for selection. Then go to Coin-
cident and constraints will be created to make them all coincident.
Midpoint
Select a point and a line. The Midpoint constraint forces the point to be on the line an equal distance from the
line endpoints. You can preselect a series of point-line pairs before selecting this function.
Note — If you split, trim, or extend a line that has a midpoint constraint, the constraint will be removed.
Symmetry
First select a line to be the symmetry axis, then a pair of points or edges (of the same type) to be symmetric about
the axis. If you want the endpoints of the curves to also be symmetric, you need to add symmetry constraints to
them as well.
You may continue to select pairs of points or edges (of the same type) to be symmetric about the axis you already
have selected. Use the right mouse button option. Select new symmetry axis when you want to select a new
axis. Axis and pairs of points or edges (of the same type) may also be preselected before entering the function.
Parallel
Right Mouse Button Context Menu: Select pairs, Select multiple, New multiple select
The default right mouse button option, Select pairs, allows you to select a pair of 2D straight edges, such as lines.
The Parallel constraint forces the selected lines or major axes for ellipses and elliptical arcs to be parallel. The
right mouse button option, Select multiple, allows you to select a continuing series of lines or ellipses. In the
series, after you have selected two edges, a constraint is created and then the second edge you selected is used
as the first edge for the next pair. This continues until you either use the right mouse button to start a new series
or return to standard pairs selection. A series of these may be preselected before selecting the function and they
are treated like a series selected in 'Select multiple' mode.
Concentric
Right Mouse Button Context Menu: Select pairs, Select multiple, New multiple select
The default right mouse button option, Select pairs, allows you to select two points, circles, circular arcs, ellipses,
or elliptical arcs. The Concentric constraint will force selected points, or centers to be at the same location. For
circles, circular arcs, ellipses, or elliptical arcs, they do not need to have an actual center point. The right mouse
button option, Select multiple, allows you to select a continuing series of points, circles, circular arcs, ellipses, or
elliptical arcs. In the series, after you have selected two edges, a constraint is created and then the second edge
you selected is used as the first edge for the next pair. This continues until you either use the right mouse button
to start a new series or return to standard pairs selection. A series of these may be preselected before selecting
the function and they are treated like a series selected in 'Select multiple' mode.
Equal Radius
Right Mouse Button Context Menu: Select pairs, Select multiple, New multiple select
The default right mouse button option, Select pairs, allows you to select two circles or circular arcs. The Equal
Radius constraint will ensure that circles or circular arcs have the same radius. Then, by placing a radius or dia-
meter dimension on one of the arcs or circles, you can control the radius of all of them. The right mouse button
option, Select multiple, allows you to select a continuing series of circles, and circular arcs. In the series, after you
have selected two edges, a constraint is created and then the second edge you selected is used as the first edge
for the next pair. This continues until you either use the right mouse button to start a new series or return to
standard pairs selection. You can preselect a series of circles and circular arcs before selecting the function and
they are treated like a series selected in 'Select multiple' mode.
Equal Length
Right Mouse Button Context Menu: Select pairs, Select multiple, New multiple select
The default right mouse button option, Select pairs, allows you to select a pair of lines. The Equal Length constraint
ensures that the selected lines are the same in length. The right mouse button option, Select multiple, allows
you to select a continuing series of lines. In the series, after you have selected two lines, a constraint is created
and then the second line you selected is used as the first line for the next pair. This continues until you either
use the right mouse button to start a new series or return to standard pairs selection. You can preselect a series
of lines before selecting the tool and they are treated like a series selected in 'Select multiple' mode.
Equal Distance
Right Mouse Button Context Menu: Select 2 pairs, Select multiple, New multiple select
Use the Equal Distance constraint to select two pairs of edges. Each pair can be points, lines, or a point and a
line. The two pairs do not have to be the same. Note that the constraint requires four edges (points or lines), one
of which may be shared. If two lines are selected as a pair, they must be, and will be forced to be parallel if they
are not already. The constraint ensures that the distance between the edges in the first pair is the same as the
distance between the edges in the second pair. You can preselect a series of edges before selecting the function,
and they will all become equally spaced. While in the function, you can use the right mouse button options to
use the second selection “twice.” This allows you to select three edges and make them all equally spaced. While
in the function, you can also use the right mouse button option, Select multiple, and then select a series of points
and/or lines. Just as preselected edges, they will all become equally spaced. For example, if you select five lines-
-A, B, C, D, and E--three constraints are created. The first ensures that the distance A-B is the same as B-C. The
next ensures B-C is the same as C-D. The last ensures that C-D is the same as D-E. The result is a series of five
equally-spaced lines.
Auto Constraints
While drawing, DesignModeler will attempt to detect constraints. These constraints include point coincidence,
curve tangency, horizontal and vertical lines, etc. However, in some models, this setting of automatic constraints
is detrimental to the drawing process. In very complex sketches, either or both of these constraint modes can
add noticeable time to the input or modification of sketches. This option allows you to control the automatic
constraint detection.
Cursor on/off decides whether local constraint snapping is performed or not. Auto Constraint Cursor only looks
for coincident, tangent, and perpendicular constraints between the edge you are creating and other edges that
are under the cursor (or a short extension would put them under the cursor).
Global on/off determines the automatic constraint detection with respect to all the entities in the active plane.
Auto Constraint Global is not processed until you actually create an edge, and then it is examined in its relation
to all other edges and points in the plane.
Settings Toolbox
• Section : Grid
• Section : Major Grid Spacing
• Section : Minor-Steps per Major
• Section : Snaps per Minor
Grid
This gives access to the grid options: grid visibility, Show in 2D on/off, as well as snap behavior, Snap on/off. The
grid guides you as you create your sketch. The grid is optional and you may sketch without it. The grid is not re-
quired to enable snapping.
At start-up a grid appears (depending on defaults in the Options dialog box). The grid appears fixed as a rectan-
gular XY pattern in the current plane. Any input for 2D-edge creation using the Section : Draw Toolbox will snap
to this rectangular grid if the Grid Snap option is checked. The minimum range of the grid is determined by the
Minimum Axes Length setting in the Grid Defaults section of the Options dialog box. It will expand as needed
if items are drawn outside the current grid area. It can also shrink back to its minimum range if items are deleted.
This option specifies the spacing for the grid. You can set the spacing in terms of the Major Grid Line Distance,
i.e., the distance between two major grid lines.
You can set the spacing for display and/or snapping in terms of the Major Grid Line Distance, i.e., the distance
between two major grid lines. The spacing for minor grid line display and/or snapping is equal to the Major Grid
Spacing divided by the value you set for the Minor-Steps per Major.
Grid Snaps per Minor allows you to specify intermediate snap locations between minor grid lines (1-1000). You
can use this to reduce the density of the grid display, while still snapping to a tighter grid. For example, in milli-
meters if the Major Grid Spacing is set to 10, you can set the Minor-Steps per Major to 5, and the Grid Snaps
per Minor to 2. This way, minor grid lines are displayed every 2 mm, but snapping is still to every mm.
Another way to use this function is to set this to a value like 100 or 1000. This way, sketching does not appear to
be snapping to a grid, but it actually is and the coordinates of your sketching are being snapped to 1/100th or
1/1000th of your minor grid line spacing. For example, if the minor grid lines are every inch and the Grid Snaps
per Minor are set to 100, when sketching a point its coordinates will end up as numbers such as 8.36 or 5.27 instead
of 8.357895846483938474 or 5.27123934933421 with no grid snapping at all.
Modeling Mode
The following is displayed when you use the right mouse button in the Modeling mode.
• Select Loops/Chains: This works for 2D and 3D edges. Instead of selecting a single edge, it will select the
entire loop of edges or, if the edge does not belong to a loop, the entire edge chain.
• Select Smooth Chains: This works only for 3D edges and works the same as Select Loops/Chains except
that the chain is defined by edges that are tangent to each other at their endpoints (that is, no jagged
intersections allowed).
The following image depicts (left to right) a loop, chain, and smooth chain.
Because the selection filter buttons on the toolbar can represent more than one type of filter, the status of the
detailed filters can be checked through the right mouse button context menu. For example when you are in the
modeling mode, the following image shows that both Vertex and PF Point filters are on.
Selection Toolbar
To select multiple entities, hold the [Ctrl] key down while selecting additional entities when in the modeling
mode.
New Selection
Use the New Selection button to clear the current selection, if any, and start a new selection. This also ends the
current sketching state.
Select Mode
The Select Mode toolbar button allows you to select items designated by the Selection Filters through the Single
Select or Box Select drop down menu options.
•
Single Select (default): Click on an item to select it.
•
Box Select: Selects all filtered items by dragging a selection box. There are two types of selections
based on the dragging direction. When the dragging is from left to right, items completely enclosed in
the box are selected. When the dragging is from the right to the left, items completely and partially enclosed
in the box are selected. Note the difference in the hash marks along the edges of the box to help you de-
termine which box selection type will be performed.
Drag a selection box from the left to the right The edges fully inside the box are selected
Drag a selection box from the right to the left The edges inside the box and the edges touching the box are
selected
You can use the [Ctrl] key for multiple selections in both modes. Switching the select mode from Single Select
to Box Select or vice versa does not affect the current selection.
Use the Select Sketch Points (2D) button to turn the selection of 2D points on/off in sketching mode.
Use the Select Model Vertices (3D) button to turn the selection of 3D model vertices on/off.
Use the Select PF Points button to turn the selection of 3D point feature points on/off. See the Point feature for
more information about PF Points.
Use the Select Sketch Edges (2D) button to turn the selection of 2D edges on/off in sketching mode.
Use the Select Model Edges (3D) button to turn the selection of 3D model edges on/off.
Use the Select Line Edges button to turn the selection of 3D model line edges on/off.
Use the Select Faces button to turn the selection of 3D model faces on/off.
Use the Select Bodies button to turn the selection of solid bodies on/off.
Use the Select Line Bodies button to turn the selection of 3D model line bodies on/off.
Use the Select Surface Bodies button to turn the selection of 3D model surface bodies on/off.
Extend Selection
Extend to Adjacent
Use the Extend to Adjacent button to expand the selected 3D edges and 3D faces to include any adjacent
edges/faces that form a “smooth” angle with the original selection set. Each click of Extend to Adjacent expands
the selection by one adjacent (and smooth) edge/face. The current face selection is extended with its adjacent
faces. Here, “adjacent” means, adjacent and separated by a seam edge -- i.e., corner (non-smooth) adjacencies
do not count.
Faces are considered smooth if the angle between them is less than the limit defined in the Section : Geometry
DesignModeler option in the DesignModeler Options dialog box.
After Extend to Adjacent, faces that are adjacent and smooth to the selected one have been added to the se-
lection set:
Extend to Limits
Use the Extend to Limits button to gain the same result as clicking the Extend to Limits button multiple times,
until the selection can no longer grow.
After Extend to Limits, the selection set is expanded until all tangent faces have been added:
Flood Blends
Use the Flood Blends button to expand your currently selected blend faces to include all of its adjacent blend
faces.
Note — This is not a fool proof method. For some cases, variable-blend faces cannot be identified. “Flood
Chamfer” is not supported.
After Flood Blends, the selection set has expanded to include all the blend faces:
Flood Area
Use the Flood Area button to expand the face selection to include all faces within the area contained by the
selected edges.
Given a seed face selection and a selection of boundary edges (the current face selection is interpreted as the
seed selection; the current edge selection is interpreted as the “boundary” selection), Flood Area extends the
face selection by flooding the bounded area. Multiple, disconnected seed and respective boundary conditions
are supported. The face flood covers the case of flooding multiple (disconnected) areas. Then each such area
would be defined by one seed face and its respective boundary. If the selection of the boundary edges is incom-
plete or not closed, then the flood will extend to the whole of the respective body.
Before Flood Area, two regions have been bounded by edges, with one face selected in each region:
After Flood Area, the two regions are flooded up to the bounding edges:
Graphical Selection
Tips for working with graphics
• You can rotate the view while selecting geometry by dragging your middle mouse button.
• You can zoom in or out by holding the Shift key and dragging with the middle mouse button.
• You can pan the view by using the arrow keys or holding the [Ctrl] key and dragging with the middle
mouse button.
• Click the interactive triad to quickly change the Model View window.
• You can zoom in or out by scrolling the mouse wheel.
• To rotate about a specific point in the model, switch to Rotate mode and click the model to select a rotation
point.
• To roll the model, click the Rotate button, then hold down the left mouse button outside of the model as
shown.
• To select more than one surface, hold the [Ctrl] key and click the surfaces you wish to select.
• You may customize the mouse operations in the Section : Workbench Options.
Highlighting
Highlighting provides visual feedback about the current pointer behavior (e.g. select surfaces) and location of
the pointer (e.g. over a particular surface). The surface edges are highlighted in colored dots.
Picking
A pick means a click on visible geometry. A pick becomes the current selection, replacing previous selections. A
pick in empty space clears the current selection in the modeling mode.
By holding the [Ctrl] key down, you can add unselected items to the selection and selected items can be removed
from the selection.
Painting
Painting means dragging the mouse on visible geometry to select more than one entity. A pick is a trivial case
of painting. By holding the [Ctrl] key down, painting will append all appropriate geometry touched by the
pointer to the current selection.
Depth Picking
Depth Picking allows you to pick obscured entities through the Z-order. Whenever more than one entity lies
under the pointer, the graphics window displays a stack of rectangles in the lower left corner. The rectangles are
stacked in appearance, with the topmost rectangle representing the visible (selected) geometry and subsequent
rectangles representing geometry hit by a ray normal to the screen passing through the pointer, front to back.
The stack of rectangles is an alternative graphical display for the selectable geometry.
Highlighting and picking behaviors are identical and synchronized for geometry and its associated rectangle.
Moving the pointer over a rectangle highlights both the rectangle and its geometry. [Ctrl] key and painting be-
haviors are also identical for the stack. Holding the [Ctrl] key while clicking rectangles picks or unpicks associated
geometry, while preserving the rest of the current selection. Dragging the mouse (painting) along the rectangles
picks geometry front-to-back or back-to-front.
Use the Active Plane/Sketch Toolbar to create a new plane or a new sketch. You can also use it to switch the
active plane or active sketch while in the sketching mode. (While in the modeling mode, this is usually done via
selection in the Feature Tree.)
Note — A very useful shortcut exists that allows you to create a new plane and new sketch in a single
operation. To do this, while in the modeling mode, select a face. By selecting the sketching tab, the plane
and sketch will be created automatically.
Use the Active Plane Drop Down to select the plane in which you want to work. This lists all the planes present
in the model. You can select a plane to make it the active plane. XYPlane is the default.
New Plane
Use the New Plane tool to create a new plane. Click on Type in the Details View to display the drop down menu
that lists the six different types of plane construction:
• From Point and Edge: new plane is defined by a point and a 2D line or 3D edge. The plane goes through
the point and the two ends of the selected edge. These three locations cannot be colinear.
• From Point and Normal: new plane is defined by a point and a normal direction. Alternatively, there is
the option to create a parameterized and persistent tangent plane, via a Point Feature (construction) point
and the base face normal.
• From Three Points: new plane is defined by three points.
Note — Three-point planes defined in Release 8.0 and forward place the plane origin at the first
point, and the X-Axis by default is in the direction from the first point to the second point. When
you edit three-point planes created prior to Release 8.0, they still function as they always did.
• From Coordinates: new plane is defined by typing in the coordinates of the origin and normal. You can
also select a point to use its coordinates for the origin. If you select a point, its coordinates are used as the
initial origin coordinates. If the point later moves, or you change any of the coordinates, then the point
and plane origin will not be at the same location. Also, if you have “Driven” a coordinate by promoting it
to a Design Parameter, then that coordinate will not be changed by the selected point. If you have all
three coordinates “Driven” then the option to select a point will not be displayed.
Terminology
In DesignModeler, the plane terminology considers a “plane” to be a 2D object (X- and Y-Axis) with an orientation
(determined by the plane normal vector). In contrast, Simulation uses a coordinate system terminology. There,
the “normal” is referred to as the Z-Axis.
Reference Geometry
Several features in DesignModeler, including Plane, accept point and direction reference inputs.
Point Reference
Generally speaking, DesignModeler accepts three forms of “point” input:
• 2D (Sketch) Points
• 3D (Model) Vertices
• Point Feature Points (Construction Points, Point Loads, Spot Welds)
Direction Reference
Normal direction, X-Axis line, and Reference edge for Rotation can be defined by selecting a face (its normal is
used), a 2D line, a 3D edge, two points, or three points. The direction reference for the Plane feature and other
DesignModeler features accepts the following “directional” input: ˙
Plane Properties
When constructing a plane, some plane types allow you to use the Details View to add an offset to the plane.
Also, some types allow you to use the Details View to reverse the plane normal direction. When adding from
another plane or a planar face, you can specify a rotation axis and angle. In this case, rotation takes precedence
to offset.
1. Subtype: This property is only available if the plane type is From-Face. Then if the selected face is, at
creation time, a planar face, the options for the Subtype are either:
• Outline: The plane's origin is placed at one of the selected face's vertices. This option is only available
for planar faces.
• Tangent Plane: The plane's origin is placed at the location where you clicked. This is the only option
allowed for curved faces.
2. X-Axis Line: This allows you to select a direction (see above) with which you want the plane's X-Axis to
be aligned. If not specified, the system will align the plane's axes with the axes of the global coordinate
system. Applies to Release 7.1 and earlier.
3. Z-Axis Rotation: This allows you to specify the degrees in which the X-axis can be rotated around the
normal vector. 0° means no rotation; take X-axis as is. Applies to Release 7.1 and earlier.
4. Offset Before Rotate: This property is only available for From-Plane planes, if the rotation axis is selected,
and the rotation axis lies in the base plane. By default Offset Before Rotate is set to No, which means that
the rotation (around the selected rotation axis) is applied before the offset. On the other hand, if the
property is set to “yes.”, then the offset is applied first. Applies to Release 7.1 and earlier.
5. Reverse Normal/Z-Axis: Reverses/flips/inverts the plane normal (or Z-Axis; Blue triad arrow).
6. Flip XY-Axis: Reverses/flips/inverts both the X- and Y-axis of the plane.
7. Use Arc Centers for Origin: This property is only available for From Face planes. If “yes.”, then when a
planar face is selected and an arc or elliptical arc edge is nearest to the selection, then the center of the
circle/ellipse will be used for the origin. When this is set to No, then arc and elliptical arc edges are treated
just like other edges and the nearest end point is used for the origin. The default is “yes.” for all new Plane
features and No for planes created prior to Release 8.1.
8. Export Coordinate System: Exports the plane as a coordinate system into Simulation. The default is
No.
Note — ANSYS Workbench Products 7.1 is only processing exported coordinate systems at the
time of the initial attach of the active CAD model. This means, in particular, the Updates are not
supported for exported coordinate systems.
Plane Transforms
Planes defined prior to Release 8.0 will maintain their current definition form, and editing them will remain as it
was in the past. For Release 8.0, definitions of Planes have been made more general and much more flexible.
While each plane type has its own set of required information, the transform logic and prompts are now
identical for all plane types. Now after the detail information for the specific plane type, the following lines are
always displayed:
• Reverse Normal/Z-Axis? No
• Flip XY-Axes? No
• Export Coordinate System? No
After the Transform 1 line, a 'Transform 1 Axis' appears for transform types that require an axis selection. Also,
an 'FD1, Value 1' line will appear for any transform that requires a value. Likewise for additional transforms if they
are used.
Clicking on the down arrow in the right column of Transform 1 generates a drop down menu of choices for the
type of transform you want. Clicking on Transform 1 in the left column, produces the same categorized list.
• None: No change
• Reverse Normal/Z-Axis: Reverses the Normal/Z-Axis, as well as the X-Axis
• Flip XY-Axes: Reverse the X-Axis and Y-Axis
• Offset X: Offsets the plane's origin in its X direction by the amount in its matching “value.”
• Offset Y: Offsets the plane's origin in its Y direction by the amount in its matching “value.”
• Offset Z: Offsets the plane's origin in its Z direction by the amount in its matching “value.”
• Rotate about X: Rotates the plane about its X-Axis by the degrees in its matching “value.”
• Rotate about Y: Rotates the plane about its Y-Axis by the degrees in its matching “value.”
• Rotate about Z: Rotates the plane about its Z-Axis by the degrees in its matching “value.”
• Rotate about Edge: For this option, an additional line appears, “Transform n Axis,” where “n” is the current
transform number, and allows selection of an Edge. The plane is then rotated about this Edge by the degrees
in its matching “value.”
• Align X-Axis with Base: Certain plane types inherit a base direction from what is used in their definition.
This is true for Plane From Plane, Plane from Planar Face, and Three Point Plane. This option will attempt
to align the X-Axis with the base data. Note, that by default the X-Axis is aligned with this data prior to
any transforms. For all other plane types, this option acts the same as 'Align X-Axis with Global'.
• Align X-Axis with Global: Aligns the X-Axis of the plane with the Global X-Axis, unless it is normal to it.
• Align X-Axis with Edge: For this option, an additional line appears, 'Transform n Axis', where 'n' is the
current transform number, and allows selection of an Edge. The X-Axis is then aligned with this Edge.
• Offset Global X: Offsets the plane's origin in the global X direction by the amount in its matching “value.”
• Offset Global Y: Offsets the plane's origin in the global Y direction by the amount in its matching “value.”
• Offset Global Z: Offsets the plane's origin in the global Z direction by the amount in its matching “value.”
• Rotate about Global X: Rotates the plane about the global X-Axis by the degrees in its matching “value.”
• Rotate about Global Y: Rotates the plane about the global Y-Axis by the degrees in its matching “value.”
• Rotate about Global Z: Rotates the plane about the global Z-Axis by the degrees in its matching “value.”
• Move Transform Up: This exchanges the position of this transform and the one previous to it in the list
and thereby the order of processing it. If this is the first transform in the list, it becomes the last. Note that
this changes the 'FDn' parameters that refer to the transforms that change position in the list. If there is
only one transform, this does nothing.
• Move Transform Down: This exchanges the position of this transform and the one after it in the list and
thereby the order of processing it. If this is the last transform in the list, it becomes the first. Note that this
changes the 'FDn' parameters that refer to the transforms that change position in the list. If there is only
one transform, this does nothing.
• Remove Transform: This deletes the current transform, and those following it are moved down one.
Note that this changes the 'FDn' parameters that refer to the transforms that change position in the list.
The 'FD1, Value 1' is the value that is associated with this transform, if needed, giving you the ability to place and
orient the new plane just the way you want. In addition to the up to 9 user-specified transforms, which are pro-
cessed in the order you specify, you can also specify a final 'Reverse Normal/Z-Axis', which is the same as a 180°
rotation about the plane’s Y-Axis, and a ’Flip XY-Axes’, which is the same as a 180° rotation about the plane’s Z-
Axis.
Note — For plane types (Align X-axis with Base) that do not have an X-axis direction inherited from their
base data, an Align X-Axis with Global is automatically performed before any of the specified transforms.
An alternative way to assign the transform type is through the right mouse button context menu. Right click on
Transform 1 (RMB) to bring up the menu, where you can choose the transform list manually. The right mouse
button context menu is available for all 9 of the user-defined plane transforms.
Tangent Plane
If you create a From-Face plane from a curved-surface face, then the preview will give you the “tangent plane”
with regards to the point selected—the subtype will conveniently default to Tangent Plane. This plane is specially
marked as “dead” and will never be regenerated after creation. This is AGP Release 6.1 behavior and is maintained
in DesignModeler Release 8.1 for backward compatibility. However, the correct way to create a tangent plane
at a given point is to:
1. Place a controlled/persistent/parameterized Construction Point onto the face, via the Point Feature; and
2. Use this point feature points (PF points) for the tangent plane creation with the From-Point-and-Normal
plane type.
Plane Preview
The plane preview shows all three axes. When creating a new plane, you will see the X (red), Y (green), and Z
(blue) direction arrows for the new plane.
For a curved-surface base face, the plane's subtype is set to Tangent Plane and remains as such (no other option
for curved-surface base faces). In this case, the origin is determined by the location where you click on the face.
Once generated, such created tangent planes remain fixed - i.e., they are “dead” and will not be regenerated.
For planar base faces, you also have the option to set the subtype to Tangent Plane. However, since it is probably
more useful, it will default to Outline. In this case the origin is determined like this:
• DesignModeler finds the edge on the face closest to where you clicked.
• From that edge, DesignModeler chooses the vertex closest to where you clicked. If the face contains only
a ring edge (such as a circle, ellipse, or spline), then it places the origin at the center.
For the case where the origin is placed at a vertex, the X-Axis (red arrow) is aligned such that it is tangent to the
closest edge. For ring edges, the X-Axis is determined by the type of ring. For example, the ellipse above aligned
the X-Axis with its major axis.
Also for planar faces (whether ring or not), you have the option to reverse the direction of the axes.
• If the base face is planar, the plane loses its axes and becomes a “face-boundary Outline plane,” where
face-boundary edges will be inserted as fixed lines into the plane object. In this case it is far more useful
to have access to the boundary edges of the base face (for sketching constraints and dimensioning) than
to the axes.
Note — These planes and their boundary regenerate/refresh properly after the model changes.
• If the face is curved-surface, then the plane is treated as a “(dead) Tangent Plane,” with axes, and the origin
fixed as it was given at plane creation time.
Note — These planes do not regenerate; rather, they are frozen “dead” in the state of creation (or
their last regeneration with a planar base face - observe that it is possible, but probably atypical,
that faces change from planar to curved-surface, or vice versa, during model regeneration).
Otherwise:
• If the plane has been created with a curved-surface base face, then the plane defaults to and remains
as a “(dead) Tangent Plane” for the life of the feature, independently of whether the base face changes
geometry or not (this is in contrast to 6.1 behavior). Refer to the subtype property which, in this case, be-
comes read-only.
• If the plane has been created with a planar base face, and with the Subtype property specifically set to
that of “(dead) Tangent Plane” then, as above, the plane will remain so for the life of the feature.
• If the plane has been created with a planar base face, and with subtype Outline (which happens to be
the default in this case), then the plane will be created as a face-boundary (instead of axes) and the origin
snapped to the closest vertex. The plane subtype will remain “Outline” for the life of the feature—however,
it will properly regenerate whenever the face outline changes.
• If the plane has been created with a planar base face, but there is no vertex suitable for snapping (in case
of a ring edge), then the plane will be created as with a face boundary, and the origin will be set at the
center of the face.
In addition:
• If a plane cannot be regenerated, because it has been created as a “face-boundary outline plane” and the
base face somehow changed from planar to curved-surface (unlikely, but possible), then the plane will
not regenerate (i.e., fall back to the last successful generation, the appropriate boundary edges) and a
warning will be issued (yellow check mark).
The following illustration shows an example plane with Offset Before Rotate = No.
Apply/Cancel in Plane
Because of the many options available in Plane, changes to properties that require selections are immediately
shown in the preview of the plane. Until you hit Apply for a property, or Generate for the plane itself, you have
the option of using Cancel in that property to backup to the previous selection (if any). Once you hit Generate,
all current selections are considered “applied.”
Use the Active Sketch Drop Down to select in which sketch of the active plane you want to work.
New Sketch
Click the New Sketch icon to create a new empty sketch in the active plane.
To attach a new sketch to a plane, select the plane that the sketch is to be attached to, and then click on the New
Sketch icon in the Section : Active Plane/Sketch Toolbar.
Note — New sketches cannot be added to planes that are suppressed or in error.
The statistics list the number of entities contained in the body or part as well as the volume and surface area of
the body. For parts, the sums of the volumes and surface areas of bodies contained within the part are displayed.
Volumes and surface areas are measured automatically up to the limit specified by the Measure Selection Limit
setting in the Options Dialog. If you see three dots “...” instead of a numerical value, that means the geometry is
too complex to be automatically measured. You may use the Measure Selection context menu option to force
the volume and surface area calculation at any time. In some rare cases, DesignModeler may not be able to
complete the measurement. When this occurs, the volume and surface area of the entity will be reported as
“Unknown.”
For more information on bodies and parts, please visit these sections:
• Section : Bodies
• Section : Parts
Bodies
• Section : Body States
• Section : Body Types
Body States
There are two states for bodies in DesignModeler:
•
Active: The body can be modified by normal modeling operations. Active bodies cannot be sliced.
To move all active bodies to the Frozen state, use the Section : Freeze feature. Active bodies are displayed
in blue in the Tree Outline. The body's icon in the Tree Outline is dependent on its type: solid, surface,
or line.
•
Frozen: The body is immune to all modeling operations except slicing. To move a body from the
Frozen state to the Active state, select the body and use the Section : Unfreeze feature. Frozen bodies
are displayed in white in the Tree Outline. The body's icon in the Tree Outline is dependent on its type
- solid, surface, or line.
Body Types
There are five types of bodies that DesignModeler supports:
•
Solid: The body has both a surface area and volume.
•
Surface: The body has a surface area, but no volume.
•
Line: The body, consisting entirely of edges, does not have a surface area or volume.
Line body edges are shown in one of three colors. On the graphics screen, line body edges are shown in
violet for line bodies that have no Section : Cross Section assigned to them. Line bodies that have cross
sections draw their edges as either red or black. Red means the edge has an invalid cross section alignment,
whereas black denotes a valid cross section alignment. If line bodies are drawn in Section : Show Cross
Section Solids mode, then all black edges are instead drawn as solids using their cross section attributes.
•
Planar: A special case of surface body is the 2D planar body. A 2D planar body is defined as a flat
surface body that lies entirely in the XYPlane. These bodies are available to use for 2D analysis, meaning
they will be sent to Simulation when you have chosen 2D analysis from the simulation options in the
Project Page. In DesignModeler, the only difference between 2D planar bodies and other surface bodies
is the icon that appears in the Tree Outline. A 2D planar body behaves in exactly the same way as any
other surface body regarding feature operations and selection.
The easiest way to create planar bodies in DesignModeler is to create sketches on the XYPlane, then use
the Section : Surfaces From Sketches feature to create the surface bodies. Since they are flat and they lie
in the XYPlane, they will be identified as planar bodies.
•
Winding: The body, consisting entirely of edges, does not have a surface area or volume.
Winding bodies are special forms of Line bodies that are intended to model coils of wire. In fact, a normal
Line body can be converted to a Winding body or back if desired. The other way Winding bodies can be
created is via the Section : Winding Tool. Winding bodies created by the Section : Winding Tool, cannot
be converted to normal Line bodies. Instead of having a standard Cross Section assigned to them, Winding
bodies currently only allow a rectangular cross section, and its values are determined by the Winding
Table for Winding bodies from the Section : Winding Tool.
In order to create a valid Winding body from a Line body, it must be based on only line and arc edges and
form a closed loop. If the Alignment direction is not consistent when it is converted, the conversion process
will reverse alignments on edges as necessary to assure a consistent orientation. You may right click on
a converted Winding body in the tree and reverse the alignments of all edges in that converted Winding
body.
For Winding bodies that are converted from Line bodies, any previous cross section assignments to them
are cleared, and you can manually enter length and width values for the cross section. These converted
Winding bodies still allow you to control the alignment whereas those created by the Section : Winding
Tool do not. Likewise you can modify the Number of Turns property for a converted Winding body. Turns
comes from the Winding Table for those created by the Section : Winding Tool.
When Winding bodies are passed to Simulation and the ANSYS environment, a special element type
(SOURC36) is used to mesh winding body edges with a single element. Converting Line Bodies that contain
edge types other than Line or Arc/Circle to Winding bodies will cause errors in Simulation, and therefore
should be avoided.
Body Status
The status of a body is indicated by the small check mark or x next to the body icon in the Tree Outline. The
status of a body can be one of the following types:
•
Visible: The body is visible on screen. It is denoted by a green check mark.
•
Hidden: The body is not visible on screen. It is denoted by a light green check mark.
•
Suppressed: Suppressed bodies do not get sent to Simulation for analysis, nor are they included
in the model when exporting to a format other than AGDB. In the Tree Outline, a blue x is shown next to
suppressed bodies. Unlike the behavior in Simulation, suppressed bodies are included in the statistics of
its owning part and/or overall model statistics. Hint: To suppress bodies when attaching to a plug-in, it
is best to leave all bodies unsuppressed in the CAD program, then suppress them in DesignModeler.
Note — Suppressing bodies in such a way that it results in adding or deleting parts to or from
DesignModeler, while the model is attached as an active CAD model in Simulation, may result in
lost associativities on the part level.
•
Warning: This alerts you when a line body either has no cross section assigned, or contains edges
that have not been aligned.
Note — This will not be displayed if the cross section type is Section : Circular or Section : Circular
Tube, where default alignment is considered acceptable.
•
Error: This error appears when a line body contains edges that have invalid alignment. This means
that a cross section cannot be oriented on an edge because the edge's alignment vector is parallel to the
edge's direction. See Section : Cross Section Alignment for more information about line edge alignment.
•
Error: This error can occur for a number of reasons as shown below.
Note — Similar to features, when a warning or error is indicated on a body, you can now right click on it
in the Tree Outline and choose Show Errors to get more information. Also, bodies showing an error icon
will NOT be transferred to Simulation.
Additional Properties
From the CAD program Unigraphics, you can attach surface thicknesses using either the Section : Attach to
Active CAD Geometry or Section : Import External Geometry File features. Material property transfer is supported
for Autodesk Inventor, Pro/ENGINEER, and Unigraphics.
Thickness: This value is entered as the thickness of the body in Simulation. The property only appears for
surface bodies.
Material: This read-only property appears for bodies that have a material attribute assigned to them. Mater-
ial properties can only be created by utilizing the Section : Attach to Active CAD Geometry or Section : Import
External Geometry File features.
Body thickness and material may propagate as a result of boolean operations. For example, suppose a surface
body has both a thickness and material defined. If that body is cut into two or more pieces, then each piece will
also possess the same thickness and material.
Body Naming
Names of bodies imported or attached to DesignModeler using the Section : Import External Geometry File and
Section : Attach to Active CAD Geometry features can be renamed. After renaming a body you must refresh for
the name to be kept. Otherwise the body name supplied by the CAD source will appear.
By default, body names are assigned from the CAD source if one is provided. The body name will also be refreshed
if the CAD source is refreshed. However, once you manually modify a body's name, that name will remain regardless
of whether the body originated from another CAD system.
Winding Bodies that are created by a Section : Winding Tool are automatically named using the Phase name and
coil number (from the Winding Table), e.g. "A.1" for Phase "A", coil number 1. Again, this is just a default name
and if you change it, then your name will remain.
Parts
• Section : Form New Part
• Section : Explode Part
• Section : Part Status
You can group bodies into parts using the Section : Form New Part tool. These parts will be transferred to Simu-
lation as parts consisting of multiple bodies, with shared topology. By default, DesignModeler places each body
into one part by itself. To form a new part, select one or more bodies from the graphics screen and use the right
mouse button option Section : Form New Part. The Section : Form New Part option is available only when bodies
are selected and you are not in a feature creation or feature edit state. Parts can also be created by selecting one
or more bodies from the Tree Outline and clicking Form New Part in the Tools menu.
Explode Part
Parts can be deconstructed. Select a part in the Tree Outline, then use the right mouse button option Explode
Part to break the part into individual bodies. See Section : Explode Part in the Section : Context Menus section
of the Menus chapter.
Part Status
The status of a part is indicated by one the following three types:
•
Visible: Some bodies in the part are visible on screen. It is denoted by a green check mark.
•
Hidden: All bodies in the part are hidden. It is denoted by a light green check mark.
•
Boolean Operations
• Section : Material Types
• Section : Model Size Box
• Section : Manifold Geometry
Material Types
Typically, the generation of a 3D feature (e.g. Extrude or Sweep, Section : Sweep) consists of two steps:
• Add Material : Use to create material and merge it with the active bodies. It is always available.
• Cut Material: Use to remove material from the active bodies. It is available whenever active bodies are
present.
• Slice Material: Use to slice frozen bodies into pieces. It is available only when ALL bodies in the model
are frozen.
• Imprint Faces: Similar to Slice, except that only the faces of the bodies are split, and edges are imprinted
if necessary, but no new bodies are created. Its availability is the same as Cut in that it operates on active
bodies.
• Add Frozen: Similar to Add Material, except that the feature bodies are not merged with the existing
model but rather added as frozen bodies. This allows you, for example, to automatically import a model
as an assembly of frozen bodies, without the need to manually apply the Freeze feature.
Note — Line bodies are immune to Cut, Imprint, and Slice operations.
Manifold Geometry
All solid and surface geometry created in DesignModeler must be manifold. This means that for solid bodies,
each edge connects to exactly two faces.
For surface bodies, each interior edge connects to two faces, and each boundary edge connects to exactly one
face. Most often, non-manifold solids can occur during Section : Enclosure operations, where bodies touch at an
edge or vertex.
For surface bodies, any type of 'T' intersection is considered non-manifold and is not permitted in Boolean oper-
ations. Bodies that are oriented in this manner should be kept separate by leaving one or both bodies frozen. If
you wish to share topology between bodies that form a 'T' intersection, consider using the Section : Joint feature.
Below are some examples of valid (manifold) and invalid (non-manifold) geometry:
Example 1
This solid is invalid because the top edge connects to four When split into two bodies, this geometry becomes manifold.
faces instead of two.
Example 2
This surface body is invalid because it contains a “T” intersec- When kept separate, two bodies remain manifold.
tion. The middle edge is connected to three faces.
Profiles
Important
The 3D features that create bodies support the following base objects:
Sketches, faces, and Named Selections consist of one or more profiles. Each profile is a chain of non-intersecting
sketch edges that are used in the four basic modeling features:
• Section : Extrude
• Section : Revolve
• Section : Sweep
• Section : Skin/Loft
Profiles are either open or closed. A closed profile is one in which the edges in the chain form a loop. An open
profile is a sketch chain that is open at both ends. If a profile intersects itself, then it is invalid. Below, from left
to right, are three examples of profiles: a closed profile, an open profile, and an invalid self-intersecting profile.
By default, closed profiles take precedence over open profiles. If a sketch contains both closed and open profiles,
then the closed profiles will be used and the open profiles will be ignored. In this example, one closed profile
takes precedence over the other open profiles in this Revolve feature.
The As Thin/Surface property allows you to define a thickness to create thin solids or set it to zero to create surfaces.
When using open profiles, As Thin/Surface must be set to Yes, otherwise a warning will be issued. In this example,
two open profiles are extruded to create two surface bodies.
Both open and closed profiles are not allowed to intersect each other except when As Thin/Surface is set to Yes.
Additionally, when using intersecting profiles, the thickness must be non-zero. The following two examples show
the cases when profiles are permitted to intersect each other.
For the Revolve feature, if the base sketch contains only open profiles and one of its edges is used as the axis of
revolution, then the profile to which the edge belongs will be ignored (it is already used as an “axis”). An example
is shown below, where the middle profile contains an edge chosen as the rotation axis.
You can change certain Feature Selections where applicable. This functionality is provided by the means of the
Apply/Cancel buttons in the Details View. By default, Feature Selections are read-only; however, editing Feature
Selections is possible under two circumstances:
Once editing of Feature Selections is enabled, you can “activate” the Apply/Cancel buttons by either double-
clicking the corresponding property names (left column of Details View) or by single-clicking the corresponding
property value fields (right column).
The Plane feature and the Revolve feature use a rotation axis selection. By selecting the axis row in the Details
View, you can define the rotation axis, which must be a straight 2D or 3D edge. For the Revolve feature, you can
also preselect the axis line before clicking the Revolve button.
The Section : Sweep feature takes a profile sketch, the sweep profile, and sweeps it along a path sketch, the
sweep path. You define the sweep profile by selecting the Sweep Profile row in the Details View and then selecting
the desired sketch or plane in the Tree Outline, and finally clicking Apply to lock in your selection. Similarly, you
define the sweep path by selecting the Sweep Path row in the Details View and then selecting the desired sketch
or plane in the Tree Outline, and again click Apply to lock in your selection.
In the Section : Body Operation feature, the planes are chosen by following the status bar instructions or by
highlighting the source or destination plane property, then choosing a plane from the Tree Outline and clicking
Apply.
Select geometry
Click feature button
RESULT: Selection is loaded into the object
• Post-select (Note: this is the most typical usage!)
Click feature button (at feature creation) or use the Edit Selections right mouse button option
Bring up the Apply/Cancel buttons for the desired property
Select geometry
Click Apply/Cancel
RESULT: Selection is loaded into the object (in case of Apply)
Example
Illustrated here is an example of using post-select to create a fixed-radius blend. Use the Blend drop down menu
from the toolbar, and select Fixed-Radius Blend.
Specify the blend radius as desired, and start edge selection by double-clicking the Geometry property, thus
bringing up the Apply/Cancel buttons, and perform your edge selection:
Click Apply, to accept your selection, and then Section : Generate to create the Blend feature. Now, assume more
modeling has been done, and after some other features have been created, you want to go back and edit the
above edge selection. Use the right mouse button context menu over the Blend feature…
…and select the Edit Selections option. This will “roll back” the model to the state before the Blend feature.
Upon selecting the Edit Selections option, the model will roll back to the state it was in when the feature was
created. During selection editing, features that are inactive are shown in gray. If a feature was suppressed when
Edit Selections is selected, the feature and any of its parent features will become unsuppressed.
At this point, you may edit, say, the Blend feature's edge selection by double-clicking the Geometry property,
thus, again, bringing up the Apply/Cancel buttons, and perform your edge selection:
The current geometry selection of the feature is selected on screen. Now, say, add another edge to the selection
by holding down the [Ctrl] key:
Click Apply to accept your changes, and click Section : Generate to update the model.
The Edit Selections option is available for all features except Freeze. Additionally, Edit Selections may not be
performed on any of the three absolute planes, nor is it allowed during feature creation.
3D Features
Use the 3D Features Toolbar to create a model and to make changes to it. The 3D features are also accessible via
the Section : Create Menu. Next to each features icon in the Tree Outline is a graphic showing the state of the
feature. There are five states a feature can have:
Additionally, if the feature appears in gray, it means the feature is inactive. This can occur whenever you are
performing a Section : Feature Insert or Section : Edit Selections for Features and Apply/Cancel.
Generate
Hotkey: [F5]
Click the Generate button to update the model after any number of changes in the model's feature or sketch/plane
dimensions, or changes in design parameters.
Extrude
Use the Extrude button to create an extruded feature. Solids, surfaces, and thin-walled features can be created
from a sketch (to create surfaces, set the inner and outer thicknesses to zero). The active sketch is the default
input but can be changed by selecting the desired sketch or a plane from face (boundary used) in the Tree
Outline.
A Section : Named Selection can also be selected as the base object. If a Section : Named Selection is used, then
a Direction Vector must be defined, and will be used for extruding all legitimate items in the Section : Named
Selection. Extrude can use faces (its edges are actually used) and edges from the Section : Named Selection as
well as Surface Bodies (treated like faces) and Line Bodies (treated like edges) from Named Selections. Open sets
of edges will only be used if there are no faces or closed sets of edges in the Section : Named Selection.
The Details View is used to set the Extrude depth, direction vector, direction, direction type and modeling oper-
ation (Add, Cut, Slice, Imprint, or Add Frozen). Clicking Section : Generate completes the feature creation and
updates the model.
Note — The Direction Vector is required if the base object is a Section : Named Selection.
Extent Types:
There are five Extent Types that you use to define the extrusion:
Fixed Type
Fixed extents will extrude the profiles the exact distance specified by the Depth property. The feature preview
shows an exact representation of how the feature will be created:
To Next Type
To Next will extend the profile up to the first surface it encounters when adding material. When performing Cut
and Slice operations, the extent will go up to and through the first surface or volume it encounters. Although
the preview will show the direction in which the profile gets extruded, the actual extent will not be determined
until the feature is generated.
If Target Bodies are selected, then DesignModeler will only consider those bodies when determining the To Next
extent.
To Faces Type
The To Faces is an advanced option which allows you to extend the Section : Extrude feature up to a boundary
formed by one or more faces. Select the face or faces to which you want to extend the Section : Extrude feature.
This is easiest when you have only one profile in the base sketch. If you have multiple profiles in your Base Object,
you have to make sure that each profile has at least one face intersecting its extent. Otherwise, an extent error
will result.
The extent calculation is the same for all material types. Although the preview will show the direction in which
the profile gets extruded, the actual extent will not be calculated until the feature is generated.
Note — To Faces option is quite different from To Next. You can say that To Next does not mean “to the
next face,” but rather “through the next chunk of the body (solid or surface).”
Another noteworthy aspect of the To Faces option is that it can also be used with respect to faces of frozen
bodies.
To Surface Type
The To Surface extent is an advanced option which allows you to define the extent through a surface. In this
case a single target face is selected and its underlying (and possibly unbounded) surface is used as the extent.
The underlying surface must fully intersect the extruded profile or an error will result.
Also, please note that some Non-Uniform Rational B-Splines (NURBS) target faces cannot be extended. In those
cases, the Surface Extension feature may fail if the extension is not fully bounded by the selected target face's
surface.
The extent calculation is the same for all material types. The preview will show the direction of the extrusion,
but the actual extent calculation is not performed until the feature is generated.
Revolve
Use the Revolve button to create a revolved feature. The active sketch is the default but can be changed using
the Tree Outline. If there is a disjoint line in the sketch, it is chosen as the default axis of revolution. A Section :
Named Selection can also be selected as the base object. Revolve can use faces (its edges are actually used) and
edges from the Section : Named Selection as well as Surface Bodies (treated like faces) and Line Bodies (treated
like edges) from Named Selections. Open sets of edges will only be used if there are no faces or closed sets of
edges in the Section : Named Selection. The axis of revolution may be any straight 2D sketch edge, 3D model
edge, or plane axis line.
Further, the Details View can be used to change the angle of revolution, the feature direction, and modeling
operation: Add, Cut, Slice, Imprint, or Add Frozen. Solids, surfaces, and thin-walled features can be created by
using this feature. For creating a surface body, the inner and outer thickness values should be kept equal to zero.
Clicking Section : Generate completes the feature creation and updates the model.
Sweep
The Details View can be used to change the modeling operations (Add, Cut, Slice, Imprint, or Add Frozen) and
the alignment of the sweep. Solids, surfaces, and thin-walled features can be created by using this feature. For
creating a surface body, the inner and outer thickness values should be kept equal to zero. Clicking Section :
Generate completes the feature creation and updates the model.
The Sweep profile may consist of a single or multiple chains, and they may be either open or closed. The sweep
path may be either an open or a closed chain, but there may only be one path. If the sweep path is an open chain,
then the endpoint of the path that lies closest to the profile(s) is chosen as the start vertex for the Sweep operation.
For either the Sweep profile or the Sweep path, or both, you may use Named Selections. Also note that if neither
end of a an open Sweep path or if no vertex of a closed Sweep path lies in the plane of the Sweep profile, then
the resulting Sweep may appear strange. This is especially true if Path Tangent is being used for Alignment.
Alignment
There are two options for the alignment property:
Path Tangent: Reorients the profile as it is swept along the path to keep the profile's orientation with respect
to the path consistent.
Global Axes: The profile's orientation remains constant as it is swept along the path, regardless of the path's
shape. As an example, consider these two sweeps that use identical path and profile sketches. The picture on
the left uses Path Tangent alignment, while the picture on the right uses Global Axes alignment.
Use Scale to taper or expand the profile along the path of the sweep. The value for Scale determines the size of
the end of the sweep relative to the original profile. Use Turns to twist the profile as it is swept along the path.
The value of Turns is the number of rotations about the path. A negative value for Turns will make the profile
rotate about the path in the opposite direction.
These two properties are designed for creating helical sweeps, although there are some restrictions:
Skin/Loft
Takes a series of profiles from different planes to (Add, Cut, Slice, Imprint, or Add Frozen, depending on the
chosen “material type”) a solid or surface fitting through them. The Details View can be used to change the
modeling operations (Add, Cut, Slice, Imprint, or Add Frozen). Solids, surfaces, and thin-walled features can be
created by using this feature. For creating a surface body, the inner and outer thickness values should be kept
equal to zero. Clicking Section : Generate completes the feature creation and updates the model.
You must select two or more profiles for the Skin/Loft feature. A profile is a sketch with one closed or open loop
or a plane from a face or a Section : Named Selection. All profiles must have the same number of edges. Addition-
ally, open and closed profiles cannot be mixed. All profiles for the Skin/Loft feature must be of the same type.
Sketches and planes can be selected by clicking on their edges or points in the graphics area, or by clicking on
the sketch or plane branch in the Tree Outline. Upon selecting an adequate number of profiles, a preview will
appear which shows the selected profiles and the guide line. The guide line is a gray polyline which shows how
the vertices between the profiles will line up with each other.
There is a right mouse button context menu to assist in creating the Skin/Loft feature. Clicking the right mouse
button context menu will present two options:
• Fix Guide Line: Allows you to click on edges in the graphics area to change the guide line alignment. For
open profiles, the guide line must pass through the profiles at their endpoints.
• Continue Sketch Selection: Leaves the alignment state in order to continue profile selection for the
Skin/Loft feature.
Note — There are four reordering options plus Delete, which will remove the selected profile from the
list altogether.
Point Profiles
The Skin/Loft feature can accept profiles consisting of a single point. A point profile is defined as a sketch that
contains exactly one construction point and nothing else or a Section : Named Selection with a single vertex or
3D Point (from Section : Point feature). Point profiles are restricted to either the first and/or last profile in the
profile list. Point profiles may not be placed in the middle of the profile list. If both the start and end profiles are
point profiles, then at least three profiles are necessary for the Skin/Loft feature instead of the usual two. You
can tell which profiles in the Details View are point profiles by the asterisk (*) that is placed after them. In the
following picture, Sketch3 is a point profile:
You do not need to be concerned about how the guide rail lines up with a point profile, since there is only a
single point for the Skin/Loft to which to converge. The other profiles in your profile list may be either open or
closed, but not both. Shown here are some examples:
Profiles for a boat's hull (closed profiles): After generating the Skin/Loft:
Thin/Surface
The Thin/Surface feature allows you to convert solids into thin solids or surfaces. The feature can operate on
both active and frozen bodies. Typically, you will select the faces to remove, and then specify a face offset that
is greater than or equal to zero (>=0). You can make a model's thickness in one of three directions of offset:
• Inward
• Outward
• Mid-Plane
The simplified shelling application allows you to convert from thin solid models to surface models. This applies
for a thickness of zero (=0). The Thin/Surface feature supports thickness > 0 if the selected faces are part of
surface bodies. This allows for the “thickening” of an imported surface. Example:
When you create a surface, you can also specify a Face Offset. Face Offset only appears when the thickness is
zero.
The Direction property specifies the direction in which the surface is thickened (or the solid is hollowed). The
directions are Inward, Outward, and Midplane. Midplane allows for consistent thickness to approximate the
midsurface. Midplane applies half of the given thickness to both sides.
Note — This does not mean midplane extraction. It means that the bodies will be hollowed, such that
the inner and outer walls of the bodies are offset equal distances from the original faces.
For example, shown below left is a body before hollowing and to the right, the body after midplane hollowing.
Note — The Midplane direction can be applied to surface bodies as well, so that surfaces are thickened
equally on both sides.
Blend
The Blend feature allows you to create blends in two forms:
Fixed Radius
Variable Radius
Fixed Radius
The Fixed-Radius feature allows you to create blends on model edges. You can preselect 3D edges and/or faces
for blending, and select 3D edges and/or faces while in the blend creation itself. If you select a face, all the edges
from that face are blended. Preselection allows additional options from a right mouse button context menu for
face edge loop selection and smooth 3D edge chain selection from the model. You can edit the blend radius in
the Details View. Clicking Section : Generate completes the feature creation and updates the model.
Variable Radius
The Variable-Radius feature allows you to blend features on model edges. You can preselect 3D edges for
blending and/or you can select 3D edges while in the blend creation itself. Preselection allows additional options
from a right mouse button context menu for face edge loop selection and smooth 3D edge chain selection from
the model. Use the Details View to change the start and end blend radius for each edge. Also, the Details View
can set the transition between blends to smooth or linear. Clicking Section : Generate completes the feature
creation and updates the model.
Chamfer
The Chamfer feature allows you to create planar transitions (or chamfer faces) across model edges. You can
preselect 3D edges and/or faces for chamfering, and/or you can select 3D edges and/or faces while in the
chamfer creation itself. If a face is selected, all the edges from that face are chamfered. Preselection allows addi-
tional options from a right mouse button context menu for face edge loop selection and smooth 3D edge chain
selection from the model. Every edge on a face has a direction. This direction defines a right and left side.
Chamfer is defined either by two distances from the edge for the planar transition (chamfer face), or by a distance
(left or right) and an angle. The type of chamfer is defined in the Details View along with the distances and angle.
Clicking Section : Generate completes the feature creation and updates the model.
Point
The Point feature allows for controlled and fully dimensioned placement of points relative to selected model
faces and edges. These points are referred to as point feature points, or PF points.
The feature can operate on both active and frozen bodies. You begin by selecting the set of base faces and guide
edges. Next, select the type:
• Spot Weld: Used for “welding” together otherwise disjointed parts in an assembly. Only those points that
successfully generate mates are passed as spot welds to Simulation. Spot welds on multiple body parts
will not be transferred to Simulation.
• Point Load: Used for “hard points” in the analysis. All points that successfully generate are passed to
Simulation as vertices. However, Simulation will ignore points that do not lie on faces. Also point loads
on multiple body parts are not supported in Simulation.
• Construction Point: No points of this type are passed to Simulation.
Then, choose from up to four possible Point Definition options, and for each of these certain placement definitions
may be specified:
The Point placement is defined by distances on the chain of guide edges and by distances along the chain of
guide edges as follows:
Sigma: the distance between the beginning of the chain of guide edges and the placement of the first point.
Measurement is taken on the chain of the first Guide Edge selected, in arc length.
Edge Offset: the distance between the guide edges and the placement of the spots on the set of base faces
(approximation).
Delta: the distance, measured on the guide edges, in arc length between two consecutive points, for the
Sequence By Delta option.
N: the number of points to be placed, relative to the chain of guide edges, in case of the Sequence By N option.
Omega: the distance between the end of the chain of guide edges and the placement of the last spot, for
the Sequence By N option. Measurement is taken on the chain of the Guide Edges in arc length.
Base Face
Edge
Offset
Mating Face
Guiding Edge
Definitions
Base Faces: where points are to be added.
Guiding Edges: used as a reference to create the points.
Mating Faces: what DesignModeler detects as the faces on which mating points are to be created when
creating the “Spot Welds.” These faces may be on either side of the Base Faces within the given range. If the
edge offset is zero (i.e., if the points lie on the Guide Edges, and no Mating Faces are found on either side of
the Base Face), then an attempt is made to find Mating Faces in the tangent direction of the Base Face. This
can be used to approximate “Seam Welds.”
Mating Targets: what body is to be used for finding contact points. Used for models with multiple bodies,
when contact is only desired between certain bodies.
The mating face is detected automatically, and the points are added depending on whether the mating face is
above the points on the base face, or below the points on the base face. Illustrated below is an example when
points will not have mating points on the Mating Face.
Mating Face
Guiding Edge
Base Face
Point Placement
For edge offsets that are nonzero, the point is placed on a Base Face, relative to the Guiding Edge, as illustrated
Surface Normal
1 Edge
Edge Tangent
Offset
Surface Normal
below.
Points that fall outside their base faces will not be placed, as illustrated below.
Edge
Offset
If Sigma is zero, then the sequence of the points will begin from the beginning of the first edge of the chain of
guide edges. Similarly, if Omega is zero, the point at the other end will be on the edge of the base face.
For the Spot Weld analysis type, there is a “Range” property in the Details View. In this case, for each point placed
on the base faces, the system will attempt to find a suitable “mate” on another face (typically on another surface
body). If successful, it will then place a point at the “mate” position as well (the original point and its mate will
be interpreted as a “weld” by Simulation). The Range specifies the maximum distance for each original point to
probe for its mate.
3
Edge Tangent
Direction 1 and 2 are always searched. The closest mate found from these two directions is chosen. If no mate
is found, then direction 3 is searched.
Mate placement is defined by the ray originating from the original point in one of the three directions described
above. Note that each point's ray may be different, since the ray depends on the shape of the base face, as illus-
trated below. The distance between the point and its mate must be less than or equal to the Range parameter.
For a Spot Weld from Coordinates File, only directions 1 and 2 are searched.
Mates
Original
Points
Note that the face offset may be either positive or negative, and may even result in the point being placed inside
a body. An example is shown here, where the base face and guide edge are highlighted.
Note — Current versions of Simulation (up to and including 9.0) do not support isolated points, i.e., points
that are placed off a surface, be it inside or outside a solid. This means that, currently, it is not recommen-
ded to use Face Offsets > 0 for any other purpose than for creating construction points, internal to the
DesignModeler model.
Coordinates File
This option allows you to specify a text file from which to read coordinates. These coordinates are used exactly
as specified and are not projected onto any face or edge. The file itself must be a simple text file formatted ac-
cording to the following rules:
1. After a pound sign '#,' everything else on that line is considered a comment and is ignored.
2. Empty lines are ignored.
3. Data consists of 5 fields, all on one line, separated by spaces and/or tabs:
4. A data line with the same Group and Id numbers as a previous data line is an error.
5. Number of points is limited to the value set in the Options dialog box (see the Point Feature Limit
setting under the DesignModeler Miscellaneous settings in the Options dialog box).
The Refresh property for this option allows you to update your text file and have the system read it again. Since
the Group number and Id number fields uniquely identify each point generated for this Section : Point feature,
this allows you to modify coordinates, or delete or add points. A sample coordinates file is shown below.
# List of Point Coordinates
# Group 1
1 1 20.1234 25.4321 30.5678
1 2 25.2468 30.1357 35.1928
1 3 15.5555 16.6666 17.7777
#Group 2
2 1 50.0101 100.2021 7.1515
2 2 -22.3456 .8765 -.9876
2 3 21.1234 22.4321 23.5678
Special Notes for Point Load and Spot Weld from Coordinate File
For Point Load and Spot Weld, a base face is searched for at each point, and for Spot Weld, mate faces are also
determined. Because the mate faces are automatically detected, you should not put locations of mate points in
the file. Doing so may result in the creation of duplicate spot welds.
Normally, a very tight tolerance is used when checking that a point is actually on a face. For locations read from
coordinate files, this tolerance is loosened to make the points easier to specify. However, they will still need to
be within 5.0e -7 meters of the face. This tolerance is mapped to the unit setting you are using, so for example it
is equivalent to 5.0e-4 millimeters, or about 2.0e-5 inches.
If a point lies on an edge or vertex, then any of the adjacent faces could be used for Point Load. Spot Weld will
try each of these possible faces until it finds one for which it can also find a mate face. You have some control of
this by selecting the Section : Target Bodies in the Section : Point feature.
For Point Load and Spot Weld, points are created for each coordinate in the file (up to the limit, see item five
in Coordinates File). However, note that Simulation will ignore Point Load points that are not on a face. Also,
for Spot Welds, if no base face is found, the point is internally marked as “expired” and does not display or
transfer to Simulation.
Others
Import Yes
Attach Yes
* The Target Bodies property for Enclosure and Point have a slightly different meaning. Please see the Section :
Enclosure or Point feature for details.
Target Bodies
The Target Bodies property allows you to specify which bodies are operated on during a Cut, Imprint, or Slice
operation. By switching the value of the Target Bodies property from All Bodies to Selected Bodies, you can select
bodies through another Apply/Cancel property called Bodies. Here, the bodies that you select will be the ones
subjected to the Boolean operation.
For example, suppose you wish to cut circular holes into the blocks of this model, but for only some of the blocks.
After changing the Material Type to Cut Material, the Target Bodies property will appear. By changing its value
to Selected Bodies, the bodies you wish to be cut may be chosen. Here three bodies are chosen.
After clicking Section : Generate, three of the five bodies have holes. Only the bodies selected as targets were
used in the Boolean operation.
The same functionality applies to Imprint and Slice operations as well. The following picture is the result if the
operation were changed to Imprint Faces. Here the imprinted faces are highlighted for clarity.
If the blocks are initially frozen, we could perform a Slice operation using target bodies. Selecting the same three
bodies would yield this result. Note here that for clarity, frozen body transparency has been turned off.
Merge Topology
Extrude, Revolve, Section : Sweep, and Skin each have a property called Merge Topology. This property is a
Yes/No combination box that gives you more control over feature topology. Setting the property to Yes will
optimize the topology of feature bodies, while setting it to No will leave the topology of feature bodies unaltered.
For features in previous versions, AGP 7.0 and older, Merge Topology is a read-only property whose value is
AGP 7.0 style. This means that features created in old versions of AGP follow the previous topology merging
scheme and cannot be changed. Under the old scheme, inner profile faces are merged, but outer profile faces
are not.
The default setting for Merge Topology differs depending on the 3D feature you are using:
For example, consider a rectangular profile with a circular hole in it. To illustrate the differences in the topology
merging schemes, each edge is split into several pieces:
Extruding this profile in AGP 7.0 would produce the following result. The old scheme merges the cylindrical faces
of the hole, but does not merge the outer faces of the block:
In DesignModeler 7.1 and later, you have control over topological optimizations. The same profile is extruded
in DesignModeler 7.1:
Note how the setting the value to Yes optimizes all topology of the feature body. It is however, recommended
to leave this setting as No for the Skin/Loft and Section : Sweep features to best represent the true characteristics
of the profiles. Additionally, you should be cautious when changing the value of the Merge Topology property
because after initial creation, once other features depend on this, faces and edges may appear or disappear and
cause failures and invalid selections for subsequent features.
Primitives
DesignModeler allows you to create models quickly by defining primitive shapes that do not require sketches.
All the primitive features require several point and/or direction inputs. These inputs may be defined by either
specifically typing in the coordinates or components, or by selecting geometry on the screen. Also, each primitive
contains a base plane which identifies the coordinate system in which the primitive is defined.
• Section : Sphere
• Section : Box
• Section : Parallelepiped
• Section : Cylinder
• Section : Cone
• Section : Prism
• Section : Pyramid
• Section : Torus
• Section : Bend
Sphere
The Sphere feature creates a primitive sphere from an origin and radius.
Inputs
• Origin: The center of the sphere.
• Radius: The radius of the sphere.
Box
The Box feature creates a primitive box. It can be defined in two ways:
• From One Point and Diagonal: The box is defined by one point and a diagonal vector which defines the
box's opposite corner.
• From Two Points: The box is defined by two points that represent opposite corners of the box.
Inputs
• Point 1: The first corner of the box.
• Point 2: The second corner of the box.
• Diagonal: The vector spanning from the first point to its opposite point.
No coordinate of Point 2 may match its corresponding coordinate of Point 1. The Diagonal vector must have
non-zero inputs for all three of its components.
Parallelepiped
The Parallelepiped feature creates a parallelepiped from an origin and three axis vectors.
Inputs
• Origin: The starting corner of the parallelepiped.
• Axis 1: The vector defining the first side of the parallelepiped.
• Axis 2: The vector defining the second side of the parallelepiped.
• Axis 3: The vector defining the third side of the parallelepiped.
Cylinder
The Cylinder feature creates a primitive cylinder from an origin, axis, and radius.
Inputs
• Origin: The center of the cylinder at its base.
• Axis: The central axis of the cylinder. A vector defining the central axis of the cylinder.
• Radius: The radius of the cylinder.
Cone
The Cone feature creates a primitive cone from an origin, axis, and two radii.
Inputs
• Origin: The center of the cone at its base.
• Axis: The central axis of the cone. A vector defining the central axis of the cone.
• Base Radius: The radius of the cone at its base.
• Top Radius: The radius of the cone at its top.
Note — Either the Top Radius or the Base Radius may be zero, but not both.
Prism
The Prism feature creates a primitive prism. The prism's size can be defined in two ways:
Inputs
• Origin: The center of the prism.
• Axis: The central axis of the prism. A vector defining the central axis of the prism.
• Base: The vector defining the direction to the first vertex of the prism.
• Radius: The radius of the prism.
• Side Length: The length of each prism side.
• Sides: The number of prism sides.
Note — The Axis and Base vectors are not required to be perpendicular. They may not however, be par-
allel.
Pyramid
Inputs
• Origin: The center of the pyramid's base.
• Axis: The central axis of the pyramid. A vector defining the central axis of the pyramid.
• Base: The vector defining the pyramid base's alignment.
• Base Length: The length of the pyramid base.
• Base Width: The width of the pyramid base.
• Pyramid Height: The height of the pyramid. A value of zero implies a pyramid of full height.
Note — The Axis and Base vectors are not required to be perpendicular. They may not however, be par-
allel.
Torus
Inputs
• Origin: The center of the torus.
• Axis: The central axis of the torus.
• Base: The vector defining the alignment of the torus with respect to its axis.
• Inner Radius: The distance from the axis to the inside of the torus.
• Outer Radius: The distance from the axis to the outside of the torus.
• Angle: The angle of rotation about the axis.
Note — The direction of rotation about the axis follows the right hand rule. The Axis and Base vectors
are not required to be perpendicular. They may not however, be parallel.
Bend
Inputs
• Origin: The center of the bend.
• Axis: The central axis of the bend.
• Base: The vector defining the alignment of the bend with respect to its axis.
• Radius: The distance from the axis to the center of the bend profile.
• Base Length: The length of the bend's profile.
• Base Width: The width of the bend's profile.
• Angle: The angle of rotation about the axis.
Note — The direction of rotation about the axis follows the right hand rule. The Axis and Base vectors
are not required to be perpendicular. They may not however, be parallel.
• Section : Freeze
• Section : Unfreeze
• Section : Named Selection
• Section : Mid-Surface
• Section : Joint
• Section : Enclosure
• Section : Symmetry
• Section : Fill
• Section : Surface Extension
• Section : Winding Tool
• Pattern Feature
• Section : Body Operation
• Section : Slice
• Section : Face Delete
Freeze
The Freeze feature is an advanced modeling tool available from the Tools menu. Freeze has two applications:
it allows for an alternative method for assembly modeling with multiple body parts, and it allows you to “slice”
a given part into several sub-volumes (e.g., sweepable volumes for hex meshing).
1. Create the bodies of the 3D feature (e.g., the body or bodies of an Extrude feature).
2. Merge the feature bodies with the existing model via Boolean operations:
• Add Material
• Cut Material
• Imprint Faces
The Freeze feature allows you to control the second step. It acts as a separator in the construction history as
displayed in the Tree Outline. Any bodies created for features before a Freeze will become frozen. Frozen
bodies are denoted by the ice cube icon next to a body under the Bodies branch of the Tree Outline. All frozen
bodies will be ignored when it comes to the Add, Cut, or Imprint Material operation of any features following
the Freeze.
• Slice Material
In contrast to Add and Cut, the Slice Material operation is only available when the model consists entirely of
frozen bodies. Also, in the case of Slice Material, the Freeze separator does not hide bodies from the Boolean
operation.
Unfreeze
The Unfreeze feature activates a selected body, or a group of frozen bodies, and merges them with the active
bodies in the model if applicable.
DesignModeler is not an assembly modeler; rather it is an “extended” part modeler that can deal with multiple
bodies. However, with the Freeze and the Unfreeze tools, certain modeling capabilities for (imported) assemblies
do exist. On the one hand, this may seem a limitation, but on the other hand, this is a different approach to as-
sembly modeling and allows actually more (or other) functionality (e.g., slicing).
By default, if you import an assembly from a CAD package, the modeling capabilities of DesignModeler are limited,
because applying any form of a 3D modeling operation would simply merge any touching bodies into one.
However, this can be circumvented with the Freeze and Unfreeze tools.
If you immediately Freeze the model after importing an assembly or import an assembly using the Add frozen
operation, your bodies will be shielded from the merge. You can, at that point, add new bodies; however, you
cannot modify any of the existing frozen bodies. For this, you can use Unfreeze to select bodies to become
“active.” (Active bodies are depicted as shaded blue blocks in the Tree Outline.) DesignModeler can now operate
on the newly unfrozen bodies as it would on any other active bodies.
Freeze Others
If set to Yes, all unselected bodies will become frozen, while selected bodies will become active. You do not have
to first Freeze immediately followed by an Unfreeze.
Named Selection
The Named Selection feature allows you to create named selections that can be transferred to Simulation, or
used in the creation of some features. You can select any combination of 3D entities, including point feature
points (PF points). Selections are performed through an Apply/Cancel property called Geometry in the Details
View of DesignModeler.
Named selections are transferred to Simulation by first selecting the Named selections option in the Default
Geometry Options section of the ANSYS Workbench environment Project Page.
There you must provide a key string that is used to choose which named selections you wish to transfer. A Named
Selection feature will be transferred to Simulation if the key string given in the ANSYS Workbench environment
is found in the feature's name. This field can have any number of prefixes with each prefix delimited by a semicolon
(for example: NS_ForceFaces;NS_FixedSupports;NS_BoltLoaded). By default the filter is set to NS. If the filter
is set to an empty string all applicable entities will be imported as named selections.
To ensure your selections remain persistent in Simulation, it is recommended that you create your Named Se-
lection features last.
It is recommended that you do not delete or rename a Named Selection feature after the model has been
transferred to Simulation. To avoid confusion, please note that Simulation will retain the previous Named Selection
features.
a face that will be shared between two bodies, place the Named Selection on both faces. During transfer, the
two faces will be merged, and one of them will persist in the resultant model.
Mid-Surface
The Mid-Surface feature allows the creation of surface bodies that are midway between existing solid body
faces. The resulting surface body(s) have a Thickness property which defines the “thickness” that surface body
represents. The faces can be manually selected, or an automatic mode allows you to set a thickness range and
then automatically detect matching face pairs. Along with the basic name property, there are six properties for
defining a Mid-Surface via manual selection, and four additional properties for automatic detection.
• Face Pairs: An Apply/Cancel property that facilitates the selection of the matching faces. The selected
faces must be of the same type and be defined such that one is essentially offset from the other by a fixed
distance. The order of the selected faces is important, especially the first pair of a given thickness. The
mid-surface will be generated attempting to have the normal such that it points from the second (lavender
/ hot pink) face towards the first (purple) face. You must select a face and its matching face in the order
you prefer. If you try to select two or more faces on one side before selecting the other side, the feature
will assume you are selecting a face and immediately its matching face, thus leading to errors. Also, if you
select a pair of faces that are not exact offsets of one another, a warning message will be displayed and
the pair will not be used. In general, the normals from the two faces should point away from each other.
For planar faces this is explicitly tested for and if they do not point away from each other, a warning will
be displayed and they will not be used. For other face types, if they are offsets, but the normals point toward
each other, or in the same direction, they will get used but the results may not be correct. If they are valid,
the first face will be colored purple, and the second lavender / hot pink, with the eventual normal pointing
outward from the purple face.
• Selection Method: Here you can decide whether to manually select faces, or set up additional properties
so that matching faces can be automatically detected. If you have face pairs already selected when you
select Automatic mode and you have not yet set min/max threshold values, then they will be automatically
computed from your current selections.
• Thickness Tolerance: This property provides a tolerance so that face pairs that are the same distance
apart, along with those that are within tolerance of that distance, can be grouped together. The feature
will attempt to combine resulting surface bodies which touch one another and have the same thickness
into a single surface body.
• Sewing Tolerance: During the creation of the Mid-Surface, internally surfaces are created from each face
pair selected. These are then trimmed to other surfaces with the same thickness and then sewn together
to attempt to form as few surface bodies as possible. However, there are sometimes small gaps between
these individual surfaces. This tolerance specifies the maximum gap that can be closed by the sewing
process. Normally it is not necessary to change this tolerance. However, if you find there are small gaps
in the resulting body, this may be increased to a point where the gap gets closed. Note that using too
large of a sewing tolerance can lead to slots or openings getting filled when they should not. Very large
tolerances can result in strange results and should be avoided.
• Extra Trimming: As with the Sewing Tolerance above, there are situations that the internal trimming al-
gorithms cannot completely handle. In these cases, it is useful to be able to trim sheets that have trimming
errors to the original body, or at times to trim all sheets to the original body for cases where no error was
detected even though the trimming was not correct. If trimming to the original body would result in a
non-manifold sheet, then the sheet will remain untrimmed. You also have options to delete sheets with
trimming errors, or to keep them with no additional trimming. Note that if you use the “Delete Untrimmed”
option and there are trimming problems, you will not be able to use “Show Problematic Geometry” as
the problem geometry will have been deleted.
• Preserve Bodies: Here you can decide whether the bodies whose faces you are selecting are kept or not
after the Mid-Surface feature is generated. Along with the “Yes” and “No” options there is also an option
to Preserve body if error. With this option, if one or more of the selected face pairs in a body cannot be
properly processed, then that body will be preserved. If some face pairs for that body are successful, then
the sheet bodies created by those pairs will be inside the preserved solid body. If there are no problems
then this option is the same as the “No” option.
If you choose the Automatic selection method, the following four additional properties are shown:
• Bodies to Search: Here you choose which bodies to search. The default is Visible Bodies. The other
choices are All Bodies, and Selected Bodies. If you choose Selected Bodies an additional Bodies property
is displayed that allows you to select the bodies to process.
• Minimum Threshold: This sets the minimum distance allowed between face pairs during automatic de-
tection. If it is set larger than the Maximum Threshold, then that value is set equal to the Minimum
Threshold. Also, only values greater than zero are allowed.
• Maximum Threshold: This sets the maximum distance allowed between face pairs during automatic
detection. If it is set less than the Minimum Threshold, then that value is set equal to the Maximum
Threshold. Also, only values greater than zero are allowed.
• Find Pace Pairs Now: This property will always display a 'No' as its value. When you set it to 'Yes', detection
is done at that time, using the settings you have provided for the Threshold and Bodies, as well as the
Thickness Tolerance. When it is finished processing, this value is automatically set back to 'No'. If you have
previously selected face pairs, the options shown for this are 'No'; 'Yes - Add to Face Pairs'; and 'Yes - Replace
Face Pairs'.
• Add Face Pairs: This is the default mode for selecting face pairs. When the Face Pairs property is active,
this allows you to add additional face pairs.
• Remove Face Pairs: When the Face Pairs property is active, this allows you to select a single face and all
face pairs that contain that face are removed.
• Reverse Face Pairs: When the Face Pairs property is active, this allows you to select a single face and all
face pairs that contain that face are reversed. Additionally, all face pairs that are dependent on the selected
face via adjacent face connections that have matching orientation are also reversed.
• Clear Existing Face Pair Selections: This clears all current face pairs.
• Adjust Min/Max Thresholds: This uses the distance between all currently selected face pairs to set the
Minimum and Maximum Threshold properties.
Usage
There are several important concepts to understand to ensure successful use of the Mid-Surface feature.
with solid material between them. This is automatically checked for planar pairs. Planar faces will not be
accepted if the normals do not point in the correct directions. For other face types it is up to you to choose
properly. If faces are selected that do not follow this rule, the resulting mid-surface may not be correct.
• Selecting face pairs that do not make sense will likely lead to errors. For example, selecting more that a
single face pair on a simple block solid leads to multiple intersecting sheets rather then a single mid-surface
sheet to represent the block. These cannot be properly trimmed and lead to trimming errors.
• You can control the normal direction of automatically detected faces by selecting an initial pair manually.
• You are free to mix manual selections and automatic detections (for example with different thresholds).
• The minimum and maximum threshold ranges are actually expanded by half of the thickness tolerance.
This means you can set both thresholds to the same value and then only get faces that are within the
tolerance range of that thickness.
• If your model has small faces, it is better to set identical minimum and maximum threshold ranges and
use a fairly tight tolerance to avoid a mismatch of faces.
• Another reason to use small threshold ranges is to avoid selection of valid, but unwanted face pairs. For
example if you have a rectangular block 2 x 4 x 8 and you use a threshold range from 1 to 5, you will get
the face pair that is 2 units apart and the face pair that is 4 units apart. The result would be two intersecting
mid-surface sheets. A range of 1 to 9 would result in three intersecting sheets. So for this part a range of
1 to 3 would work much better, or even better would be 2 to 2 so that you get used to using just exactly
what is wanted.
• Sewing Tolerance can be used to close small gaps, but using very large values can lead to invalid results.
• You may right click on the Mid-Surface feature in the tree if it has errors or warnings and look at either
the error/warnings, or at the geometry causing the problem.
Step-by-Step Example
The following example should help to demonstrate some of the functionality described above. Browse ... to
one of the following:
The Demo_Bracket part is imported and is actually two separate solids. The front brace, even though it touches
the main bracket is a separate body, as you might have in an assembly part.
In the first figure, load the part, chose the Mid-Surface feature, and select two face pairs (using the stacked
rectangles in the lower left to choose hidden faces). These pairs represent the two thicknesses of this model.
Now, after selecting Apply, go to the Automatic Selection mode. Since some face pairs are already selected, and
the minimum and maximum thresholds have not yet been set, it automatically calculates a range based on the
current selections. This can also be done via the right mouse button context menu at any time, or the thresholds
can be set manually. Next, for Find Face Pairs Now, select Yes, Add to Face Pairs. This results in a total of 11
face pairs being selected. However, there is actually one face pair not wanted, and some adjustments are needed
so that the normal points in the direction desired.
Here you can see where to select the pair to remove and the pair to reverse. An unwanted face pair was detected
near on of the slots because its thickness is within range of the thresholds that were specified. When you have
cases like this, activate the face pairs property and, with the cursor in the graphics area, use the right mouse
button context menu to choose Remove Face Pairs. Then select the unwanted face pair as indicated above.
Just the one selection will remove both faces of the pair. The next step is to reverse the normals of the surfaces
for the two braces such that they point away from each other. Use the right mouse button option Reverse Face
Pairs, select once where indicated, and the order of all connected face pairs will be reversed.
Here is how the model will appear after the removal and reversal, but before the Apply. Now you are ready to
Apply, and then Generate.
Here is the result of the Generate. Now, instead of two solid bodies, there are four surface bodies. They cannot
be combined into a single body because the "T" intersections would cause it to be non-manifold. Also, in the final
figure below, you will see that the resulting surface bodies for the back brace are automatically extended/trimmed
to meet the main part of the bracket, as these were all part of one solid body originally. However, the front brace
was a separate body, so it is not automatically extended.
Note that the Surface Extension feature can be used to extend the front brace so it does meet the main bracket.
Joint
The Joint feature is a tool used to join surface bodies together so that their contact regions will be treated as
shared topology when meshed in Simulation. The feature takes two or more surface bodies as input, then imprints
edges on all bodies where they make contact. There is no restriction on the states of the bodies you select; both
active and frozen body selections are permitted. The Share Topology property allows you to control the beha-
vior of the feature:
• Share Topology: To treat the imprinted edges as shared topology in Simulation, set the Shared Topology
option to Yes. Imprinted edges will display an edge joint where the coincident edges are to signify that
their edges will be shared. That is, two coincident edges will still exist in DesignModeler as separate edges,
but when the model is attached to Simulation, the edges are merged into one. If Share Topology is set
to No, then edges will be imprinted on both surface bodies, but no shared topology information is kept.
The default setting is Yes.
• Edge joints generated : This tells you the number of edge joints that the Joint feature created. The value
of this property will always be zero if Share Topology is set to No.
• Expired edge joints: This will inform you of any edge joints that have expired due to model changes. If
any edges in an edge joint are modified in any way, then the edge joint will become expired and no longer
appear when viewing the edge joints. For this reason, it is recommended that you apply Joint features
after you are done building your model. This property is not displayed if there are no expired edge joints
for a Joint feature.
For example, suppose you wish to join the following two surface bodies. DesignModeler would normally not
allow these two bodies to be merged, since they created non-manifold geometry. Using the Joint feature, we
can imprint the bodies and form shared topology between them.
After generating the Joint feature, edges are imprinted onto all three bodies, and topology sharing information
is created. Notice that the shared edges are shown as thick blue lines. Additionally, the three bodies are grouped
under the same part.
For more information on viewing edge joints, see Show Edge Joints.
Enclosure
The Enclosure feature is a tool used to enclose the bodies of a model so that the material enclosing the bodies
can be assigned to something such as a gas or fluid in Simulation. The feature takes either all the bodies or selected
bodies of the model as input, creates a frozen enclosure body around those bodies, and then cuts the bodies
out of the enclosure. This operation will not delete any bodies currently in the model. All types of bodies will be
enclosed but only solid bodies will be cut out of the enclosure.
The Section : Enclosure feature supports symmetry models when the shape of enclosures is a box or a cylinder.
A symmetry model may contain up to three symmetry planes. You can choose either full or partial models to be
included in the enclosure. If a full model is used, symmetry planes will slice off the Enclosure feature and only
a portion of the enclosure will be retained.
During the model transfer from DesignModeler to Simulation, the Enclosure feature with symmetry planes forms
two types of named selections:
Open Domain: All exterior enclosure surfaces that are not coincident to any symmetry planes are grouped
in an Open Domain named selection.
Symmetry Plane: For each symmetry plane, all faces, from both the enclosure and the model, that are coin-
cident to the symmetry plane are grouped into a named selection.
Note — It is recommended that you do not change the symmetry plane selection after a model has been
transferred to Simulation. Simulation will not delete the previous symmetry planes during updating. A
similar note applies when using the Named Selection feature.
These additional properties allow you to control the behavior of the feature:
• Shape: This property specifies the shape of the enclosure. There are four different shapes available:
Box (default)
Sphere
Cylinder
User Defined
• User Defined Body: If User Defined is selected for the Shape property, then this property becomes
available. It is an Apply/Cancel property that facilitates selection of the user defined enclosure body. The
body selected for this property may not be included in the list of target bodies. Additionally, only one
user-defined body can be selected.
• Cylinder Alignment: If cylinder is selected for the Shape property then this property becomes available.
This specifies the cylinder axis of the bounding cylinder surrounding the target bodies. There are four
different alignments the cylinder can have:
Automatic (default)
X-Axis
Y-Axis
Z-Axis
Automatic alignment will align the cylinder axis in the largest direction (X, Y, or Z) of the bounding box
surrounding the target bodies.
For the enclosure with symmetry planes, the following rules are applied for automatic alignment:
1. For one symmetry plane, the largest dimension of the bounding box for the target bodies is used.
2. For two symmetry planes, the intersection of the two symmetry planes is used.
3. For three symmetry planes, the intersection of the first two symmetry planes is used.
– Number of Planes: This property defines how many symmetry planes are used in the enclosure.
The default value is 0.
– Symmetry Plane1: first symmetry plane selection
– Symmetry Plane2: second symmetry plane selection
– Symmetry Plane3: third symmetry plane selection
– Model Type: This property specify either Full Model or Partial Model as input for the enclosure
with symmetry planes:
Full Model: DesignModeler will use the chosen symmetry planes to cut the full model, leaving
only the symmetrical portion. For each symmetry plane, material on the positive side of the
plane (that is, the +Z direction) is kept, while material on the negative side is cut away.
Partial Model: Since the model has already been reduced to its symmetrical portion,
DesignModeler will automatically determine on which side of the symmetry planes the ma-
terial lies.
• Cushion: The cushion property specifies the distance between the model and the outside of the enclosure
body. The enclosure is initially calculated to be just big enough to fit the model, and then the cushion
value is applied to make the enclosure larger. The cushion is set to a default value and must be greater
than zero. This property is available for all enclosure shapes except User Defined. This property may also
be set as a design parameter.
Note — The bounding box calculation for the model used in the Enclosure feature is guaranteed
to contain the model (or selected bodies). While the computed bounding box is usually very close
to the minimum-bounding box, it is not guaranteed.
• Target Bodies: This property specifies whether all of the bodies or only selected bodies of the model will
be enclosed. The default is all bodies.
• Bodies: If Target Bodies is set to Selected Bodies then this property becomes available. It is an Apply/Cancel
button property that facilitates selection of the target bodies that you wish to be enclosed. None of the
bodies selected for this property can also be selected as the user-defined body.
• Merge Parts: This property specifies whether or not the enclosure and its target bodies will be merged
together to form a part. It is only available during feature creation or while performing Edit Selections.
If yes, the enclosure body (or bodies) and all target bodies will be merged into a single part. Only solid
bodies are considered when merging parts - line and surface bodies will not be merged. If the property
is set to No, then no attempt is made to group the bodies into the same part, nor is any attempt made to
undo any groupings previously performed. The Merge Parts property is set to No by default, and will
automatically be set to No after each Merge Parts operation.
Sphere Enclosure
First Freeze the body or bodies that you will build your enclosure around.
Then create the User Defined Enclosure over the selected bodies.
Symmetry
The Symmetry feature is a tool used to define a symmetry model. The feature takes either all the bodies or se-
lected bodies of the model as input and accepts up to three symmetry planes. You can choose either full or
partial models to work with. If a full model is used, the selected symmetry planes will slice off the model and only
a portion of the model will be retained. The valid body types for this feature are surface and solid.
During the model transfer from DesignModeler to Simulation, the faces and edges coincident to the symmetry
planes are grouped into a named selection.
Note — It is recommended that you do not change the symmetry plane selection after a model has been
transferred to Simulation. Simulation will not delete the previous symmetry planes during updating. A
similar note applies when using the Named Selection feature.
The following properties allow you to control the behavior of the feature:
• Number of Planes: This property defines how many symmetry planes are used in the feature.
• Symmetry Plane1: first symmetry plane selection.
• Symmetry Plane2: second symmetry plane selection.
• Symmetry Plane3: third symmetry plane selection.
• Model Type: This property specifies either Full Model or Partial Model as input.
Full Model: DesignModeler will use the chosen symmetry planes to cut the full model, leaving only
the symmetrical portion. For each symmetry plane, material on the positive side of the plane (that is,
the +Z direction) is kept, while material on the negative side is cut away.
Partial Model: Since the model has already been reduced to its symmetrical portion, there is no
model change after the Symmetry feature is generated. However when the model is transferred from
DesignModeler to Simulation, the faces and edges coincident with the symmetry planes will be iden-
tified automatically and put into a named selection.
• Target Bodies: This property specifies whether all of the bodies or only selected bodies of the model will
be enclosed. The default is All Bodies.
• Bodies: If Target Bodies is set to Selected Bodies, then this property becomes available. It is an Apply/Cancel
button property that facilitates selection of the target bodies.
A full model after creating a Symmetry feature with one symmetry plane:
A full model after creating a Symmetry feature with two symmetry planes:
Fill
The Fill feature is located in the Section : Tools Menu, and is available when the model consists of active and/or
frozen bodies. This feature will create frozen bodies that fill selected depressions and holes in bodies that are
currently in the model. Faces must be selected such that they surround each of the cavities that are to be filled.
When the feature is generated, the bodies already in the model will not be modified. Frozen bodies that fill the
selected cavities and holes will be added.
Note — The Fill feature may only be used in conjunction with solid bodies. A warning message is displayed
if you select faces belonging to surface bodies.
The Fill feature is chosen from the Section : Tools Menu with a body in the model:
The faces are then selected for the area that is to be filled:
Finally, the feature is generated and the frozen body that fills the selected depressions is created:
When Filling a cavity, all faces in the cavity must be selected in order to complete the Fill operation. As shown
here, to Fill a cylindrical cavity, both the base face and the circular face must be selected, otherwise the operation
will fail.
In the case of a rectangular cavity, five faces must be selected: the base face, and each of the four side faces as
shown here.
Surface Extension
The Surface Extension feature allows the extension of surface bodies. Sets of edges that belong to the bound-
aries of surface bodies are selected through an Apply/Cancel property. The surface is extended naturally along
the selected edge set. The extension distance can be determined by a fixed number or by a set of bounding
faces. There are five properties that define the Surface Extension feature:
• Edges: An Apply/Cancel property that facilitates the selection of the edge sets. The selected edges must
be on the boundary of the surface. Edges on the interior of the surface body cannot be extended.
• Extent: This property has four options for defining the extent of the surface extension:
– Fixed (default): Fixed means the surface will be extended an exact amount.
– To Faces: To Faces means the surface will be extended up to a bounding set of faces.
– To Surface: To Surface allows the surface to be extended up to a single face's unbounded surface.
– To Next: To Next will extend the selected surfaces up to the first encountered faces which fully bound
the extension. This operation is similar to the To Faces option except the user is not required to select
the target faces. This is most useful when joining surface bodies in an assembly.
• Distance: This property defines the distance to extend the surface. Its value must be greater than zero or
an error will occur. The extension is performed along the direction perpendicular to the selected edge
set. It only appears if the Fixed extent is chosen. The value in this property may be promoted to a Design
Parameter.
• Faces: An Apply/Cancel property that allows selection of faces. The extended surface must be fully bounded
by the selected faces to succeed. This property only appears if the To Faces extent is chosen.
• Target Face: An Apply/Cancel property that allows the selection of a face to be used as the bounding
surface. In this case a single target face is selected and its underlying (and possibly unbounded) surface
is used as the extent. The underlying surface must fully intersect the extruded profile or an error will result.
Also, note that some Non-Uniform Rational B-Splines (NURBS) target faces cannot be extended. In those
cases, the Surface Extension feature may fail if the extension is not fully bounded by the selected target
face's surface. This property only appears if the Section : To Surface Type extent is chosen.
Note that not all surfaces are extendable. Sometimes parametric surfaces twist awkwardly or become self inter-
secting when extended. Since the extension distance is measured perpendicular to the edge set, one must be
careful that the edges do not become twisted when extended.
Consider the ellipse in the following picture. The gray surface is extended, producing the result shown by the
blue surface. After extending the surface along the elliptical edge, the resulting edge after the extension is not
an ellipse, but rather a parametric curve. Had this surface been extended any further, the resulting edge would
have become self-intersecting, causing the surface extension operation to fail.
Another example of the Surface Extension feature is shown here. Suppose you wish to extend the surface of
the gray cone up to the cylindrical face and down to the planar surface. First, select the edges along the surface
to extend:
Upon generating the feature, the gray cone is extended up to the desired faces:
A final example of the Surface Extension is shown here with the extent set as To Surface. To extend the surface
to the body, first select the edges to be extended as with the other extent types:
Next, chose the face whose unbounded surface you wish to extend to:
Upon generating the feature, the surface body is extended to the desired face's surface:
An example of the To Next feature is shown here. Suppose you wish to extend the surface to the planar surface
and the U-shape face. First, select the edges along the surface to extend:
Upon generating the feature, the surface body is extended to the desired faces:
Winding Tool
The Winding Tool is used to create Winding Bodies (a special form of line body) that represent coils of wire
wound through slots of a rotor or stator of a motor. The Winding Bodies generated will automatically be named
using the phase and coil from the Winding Table.
When you select a winding body, you will be shown the cross section size for the coil and the number of turns
for it. Unlike standard Line Bodies, you cannot change the Cross Section or Alignment of its edges. The Winding
Tool itself sets these. Like normal Line Bodies, the display of Winding Bodies is affected by the View options
Section : Show Cross Section Alignments, and Section : Show Cross Section Solids.
Interface
Before selecting Winding Table from the Section : Tools Menu , you should first create a model of the rotor or
stator to which it will be applied, and the center plane that will define the alignment of the Winding Bodies. Below
are two diagrams showing how the winding coils are defined.
• Center Plane: A plane defined midway between the ends of the rotor or stator, with its origin and Z-axis
at the center of the rotor or stator. It is recommended that you create this plane prior to creating the
Winding feature.
• Winding Table File: This is where you pick the Winding Table File to use. When this is set/changed, it is
read and the value in the next property, "Number of Slots" is set from it. Also if the Winding Table is dis-
played, you will be able to see what was read from the file. A Winding Table File is not required. You may
enter the winding data manually.
• Number of Slots: This is used to compute the location of all the other slots. This value must be the same
as that in the Winding Table. This value is initially 0, so the property shows as “Invalid”. A value greater
than 1 must be entered. If you enter a Winding Table File, this value is set from the “SLOTS n” record in
that file. If this value is changed, it resets all slot angles to be equally spaced around a full circle (see Slot
Angles below).
• Stack Length: This is the distance between the ends of the rotor or stator. The actual length of the coil
edges that go through a slot will be this length plus the clearance value added at each end.
• Slot Angle: This is the counterclockwise (CCW) angle from the X-axis of the Center Plane to a radius line
from the origin of the Center Plane through the center of Slot 1. If there is a Skew Angle, it is important
to understand that this value is measured at the central plane. (For the angle of other slots, see Slot Angles.)
• Skew Angle: If this is zero, the coils will go in a direction normal to the central plane as they pass through
the In and Out slots. If it is not zero, the location at the top and bottom of the rotor or stator will be mod-
ified by half the Skew Angle, counterclockwise at the top and clockwise (CW) at the bottom. In fact, the
top and bottom of the coil will be modified slightly more than that as the angle continues to “skew” the
Clearance distance beyond the top and bottom of the rotor or stator. The skew angle must be in the range
from -12.0 to 12.0 degrees.
• View Winding Table: The default for this is Yes, which means you want to display the Winding Table and
allow it to be edited via the Winding Table Editor.
• Refresh: This is automatically set to Yes when you change the Winding Table File, or the Number of Slots
(since that must agree with the value in the Winding Table). When this value is Yes, then the Winding
Table File will be parsed for its values when the feature is generated.
• Clash Detection: When this is set to Yes and solid bodies are selected in the next property, then Clash
Detection will be performed during Section : Generate. The SlotIn portion of each coil will be tested for
clashes with the selected bodies. If the radius for the SlotOut is different than that for the SlotIn, then the
SlotOut portion of the coil will also be tested for clashes. If no body is selected, or this property is set to
No, then no clash detection is done for the coils. However, you will still be warned of a possible clash at
the ends if the clearance for a coil is not larger than half of the width specified for that coil. Clashes between
coils are not looked for.
• Body for Clash Detection: This property is only seen if the previous property is set to Yes. This allows the
selection of bodies for the clash detection. If the previous property is set to Yes and no solid bodies are
selected, this property will show as Invalid, and a warning will be issued for the feature during Section :
Generate.
Note — As with other features, the Winding Bodies are not actually created, or the Winding Table parsed
until you select Section : Generate.
Note that standard Cross Sections as created under the Section : Concept Menu are not used for Winding bodies.
Instead, the cross section information for a Winding Body is provided in the Winding Table for each coil. These
values are used in a similar way to standard Cross Sections.
When DesignModeler parts are transferred to Simulation, information is sent to Simulation identifying the
Winding Bodies, along with the Number of Turns and the special cross section information needed.
Winding Table
To create winding bodies, you will need a Winding Table to provide information needed for each coil. The
Winding Table is a ".txt" file with the following characteristics:
1. After a pound sign '#', everything else on that line is considered a comment and is ignored.
2. Empty lines are ignored.
3. Values on a line are separated by spaces and/or tabs.
4. Keywords are not case sensitive. Version, version, VERSION, VeRsIoN are all valid.
5. At the top of the file are two special lines:
VERSION 10.0
SLOTS 8
6. The primary data lines must contain the following columns, in order:
Phase Coil Turns SlotIn SlotOut Rout- Clear- Radius- Radius- CSType Length Width Rotate
ing ance In Out Ends
7. Phase is a text string with no spaces/tabs in it. It is limited to 20 characters. The phase and coil are used
to maintain persistence for the winding bodies. If you modify the phases or coils, it is possible that other
features dependent on this feature may not generate successfully.
8. Coil, Turns, SlotIn, and SlotOut are integer values greater than zero
9. SlotIn and SlotOut must be different and not greater than the number of slots
10. A data line with the same Phase and Coil of a previous line is an error.
11. Routing must be STRAIGHT or ARC (or 0/1). This is how the connections between slots are made.
12. Clearance is the distance above and below the 'Stack Length' (see below) for the connections
13. RadiusIn and RadiusOut are the radius values to the center of the cross section within a slot.
14. CSType must be RECT. Currently this is the only value allowed here.
15. Length is the size of the cross section in the direction of a radius from the axis through the slot
16. Half the Width must be smaller than the Clearance or you will get a Warning of a possible Clash between
the connection and the end of the rotor/stator
17. Rotate Ends is an optional column with values of Yes/No (1/0 are also accepted). If Yes (or 1), this will
rotate the alignment of the connections between slots by 90°. This can be useful for coils that connect
slots on opposite sides of the winding (near 180° apart).
SLOTS 8
#Format is:
#Phase Coil Turns SlotIn SlotOut Routing Clear- Radius- Radiu- CSType Length Width Rotate
ance In sOut Ends
A 1 50 6 1 Straight 0.6 8.0 8.0 RECT 2.0 1.0 Yes
A 2 50 7 2 Straight 0.6 8.0 8.0 RECT 2.0 1.0 Yes
A 3 50 8 3 Straight 0.6 8.0 9.0 RECT 2.0 1.0 Yes
B 1 50 5 2 Straight 0.76 9.0 9.0 RECT 2.5 1.5 No
• Winding Data
• Slot Data
At the top will be the name of the Winding Tool, and the filename (and path) of the Winding Table File (if it has
been given). At the bottom of the panel are four buttons:
• Clear: Gives you the option to clear the Winding Table, and the filename if it exists.
• Save: Allows you to save the Winding Table to a file
• Refresh: Gives you the option to reload the table back from an already assigned file. If no filename has
been provided, this does nothing.
• Close: Allows you to close the Winding Table Editor. If you have made changes, you are given the option
of saving first. You can then turn it back on via the View Winding Table property.
Winding Data
In between the names at the top and the buttons at the bottom, the information in the Winding Table is displayed
in columns corresponding to the columns described in the section Winding Table File. You will note that comments
(phase name starting with a "#") are displayed in green and invalid values are displayed in red. If the file was read
from an external file and there was missing data, those positions display as three consecutive question marks
(???). If you right click on a row in the table, you are given several options:
To insert a row at the end, just click in the Phase cell of the row after the last one in the table. Once you have
entered the Phase cell, the rest of the row is able to be edited, unless you entered a comment ("#" at start of the
phase). You will note that when new rows are inserted, or added at the end, an attempt is made to set default
values based on the values in neighboring rows.
Slot Angles
By default, the slot angles are equally spaced in a full circle, with the spacing based on dividing 360 by the
number of slots. Anytime you change the number of slots, this spacing is adjusted based on the above formula,
and any custom angles you have entered are lost. If you want to change the angles, then when the Winding
Table is being displayed via View Winding Table, you can click on the Slot Data tab to view the slot angles.
Here, you will see the angle of each slot, as measured from the first slot (S1). This way, if you change the Slot
Angle property, all the other slots will rotate with it. All slot angles must be greater than 0.0° and less than 360.0°.
Also, to preserve the numbering order, slot angles must always be greater than the previous slot angle and less
than the following slot angle. Angles entered that do not meet these requirements will not be accepted.
Finally, remember that anytime you change the number of slots, or click on the Clear button here, the values in
this table will revert to equal spacing around a circle.
Pattern
The Pattern fgeature allows you to create copies of faces and bodies in three patterns:
For face selections, each connected face set is patterned independently of other face sets. For a face pattern to
succeed, the copied instance of the face set must remain coincident with the body it originated from, or be able
to be easily extended to it. The new faces of the pattern must touch the topological entities that were incident
to the original face set, also known as the base region. Additionally, the instances for face sets may not intersect
each other or the original face set. The faces may belong to either active or frozen bodies. An example of the
base region is shown below.
There are no such restrictions for selected bodies. Solid, surface, and line bodies are all acceptable. If the selected
bodies are active, then the patterned copies will be added to the model as active bodies and merged with other
active bodies. For selected bodies that are frozen, their instances will be added to the model as frozen bodies.
• Pattern Type: Defines either a Linear, Circular, or Rectangular pattern. The default setting is Linear.
• Geometry: An Apply/Cancel type selection property that accepts face and body selections.
• Direction: The direction for a Linear pattern, or the first of two directions for a Rectangular pattern.
• Offset: The offset distance for a Linear pattern, or the first of two offsets for a Rectangular pattern. This is
the distance between each instance of the pattern. Its value must be non-zero.
• Axis: The rotation axis for a Circular pattern. The axis may be any straight 2D sketch edge, 3D model edge,
or plane axis.
• Angle: The rotation angle for a Circular pattern. This is the angle between each instance of the pattern.
If the value of this property is 0°, then DesignModeler will automatically calculate the angle necessary to
evenly space the patterns about the rotation axis, and you will see “Evenly Spaced” indicated in the
property instead of a numerical value. The default value for Angle is 0°.
• Copies: The number of copies to create for Linear and Circular patterns. For Rectangular patterns this is
the number of copies to create in the first direction. Its value must be positive. The default value is 1.
• Direction 2: The second of two directions for a Rectangular pattern.
• Offset 2: The second of two offset distances for a Rectangular pattern. This is the distance between each
instance of the pattern in the second direction. Its value must be non-zero.
• Copies 2: The number of copies to create in the second direction for Rectangular patterns. Its value must
be positive. The default value is 1.
Body Operation
The Body Operation feature allows you to manipulate bodies. Any type of body can be used with body operations,
regardless of whether it is active or frozen. However, point feature points (PF points), attached to the faces or
edges of the selected bodies, are not affected by the body operation.
The Body Operation feature is available via the Create menu. It has up to eight options, although not all of them
will be available at all times. For selections, bodies are selected via the Apply/Cancel property in the Details View.
Planes are also selected via Apply/Cancel properties. The options are:
Mirror
You select bodies and a mirror plane. Upon clicking Section : Generate, DesignModeler will create copies of the
selected bodies that are reflections of the original bodies in the mirror plane. Active bodies that are reflected
will be merged with the active model, whereas frozen bodies that are reflected will not. By default, the mirror
plane is initially the active plane.
After generating:
Move
Select bodies and two planes—a source plane and a destination plane. Upon clicking Section : Generate,
DesignModeler will transform the selected bodies from the source plane to the destination plane. This is especially
useful for aligning imported or attached bodies. Typically, these planes will be planes created from the faces of
the bodies at hand.
Copy
The exact same as the Move option, except that copies of the bodies are moved while the original bodies remain
unaltered.
Delete
Use to select bodies to delete from the model.
Scale
Use to select bodies to scale, then select a scaling origin through the Scaling Origin property. This property is a
combination box with three options:
• World Origin: The origin of the world coordinate system is used as the scaling origin.
• Body Centroids: Each selected body is scaled about its own centroid.
• Point: You can select a specific point, either a 2D sketch point, 3D vertex, or PF points, to use as the scaling
origin.
The bodies after scaling them about their centroids by a scale factor of 2x:
The final three Body Operation types are designed to use bodies in Boolean operations, similar to the material
types used in other features. You may choose whether you wish to keep or destroy the bodies you have chosen
for the Boolean operation through the Preserve Bodies property. The default value for Preserve Bodies is No.
Cut Material
You select bodies to use in a cut operation that is performed on the active bodies in the model. Body Operation's
Cut Material option works the same way as Cut Material does for any of the basic features. This option is available
when active bodies exist in the model.
Imprint Faces
You select bodies to use in an imprint operation that is performed on the active bodies in the model. Body Op-
eration's Imprint Faces option works the same way as Imprint Faces does for any of the basic features. This option
is available when active bodies exist in the model.
Slice Material
You select bodies to use in a slice operation that is performed on a completely frozen model. Body Operation's
Slice Material option works the same way as Slice Material does for any of the basic features. This option is
available only when all bodies in the model are frozen.
Slice
The Slice feature improves the usability of DesignModeler as a tool to produce sweepable bodies for hex
meshing. As with the Slice Material operation, the Slice feature is only available when the model consists entirely
of frozen bodies.
The Slice feature is available via the Create Menu and has two options:
Slice By Plane: Select a plane, and the model will be sliced by this plane.
Slice Off Faces: Select faces on the model, presumably forming some concavity; andDesignModeler will
“slice off” these faces.
Note — Internally the Slice Off Faces feature is very similar to Face Delete. In Face Delete, the selected
faces are removed from the model and deleted. Afterwards, the engine will attempt to heal the remaining
bodies. In Slice Off Faces, the selected faces are also first removed from the existing model, only then
they are not deleted, but rather, DesignModeler will attempt to create new bodies out of the sliced-off
faces. An important similarity between Slice Off Faces and Face Delete is that both operations involve
model healing, and the engine may not be able to determine a suitable extension to cover the wound
left by the removed faces. If so, then the feature will report an error stating that it cannot heal the wound.
For example, suppose you are using an .agdb file, as illustrated below. Since you want to slice it in order to make
the model sweepable, immediately set the Import's Operation Type to Add Frozen. Select the faces you want to
“slice off,” then bring down the Section : Create Menu and select Section : Slice.
Hit Section : Generate, and see how the model is sliced into different bodies. Note that, in these screen shots,
we show the frozen bodies in a “solid” manner. By default, DesignModeler is showing frozen bodies in a translucent
manner (but you can change this behavior through an option in the Section : View Menu.
For example, you might wish to slice a body by a plane, but do not want to slice all bodies by it. Slice Targets is
a combination box with two options:
All Bodies: The plane slices all frozen bodies. This is the default option.
Selected Bodies: Only the selected bodies are sliced by the plane. If this option is chosen, an Apply/Cancel
property will appear to facilitate body selection.
As illustrated below, a Slice By Plane will operate only on the selected body.
After generating the Slice feature, only the selected body got sliced.
Face Delete
Use the Face Delete feature to undo features such as blends and cuts by removing faces from the model and
then healing it to patch up the holes left behind by the removed faces. Face Delete can be used to remove un-
wanted features from imported models. It can be used for defeaturing and refeaturing of imported models; remove
a feature, such as a hole, and recreate in DesignModeler in order to get it parameterized. Use of the feature is
graphically illustrated below.
During feature creation of Face Delete, you may select faces and 3D edges. The 3D edge selection is only there
to assist in selecting the faces with use of the Section : Flood Area selection extension. Face Delete works by
attempting to remove groups of adjacent selected faces from the model, and heal the resulting “wound.” You
should select the faces such that upon removing these groups, the surrounding geometry can extend to cover
the wound(s) left by the removed faces. If a suitable extension cannot be determined, the feature will report an
error stating that it cannot heal the wound.
Suppose you wanted to delete the blends and cavity from this model.
Using the Face Delete feature, select these four highlighted faces.
Concept Menu
Use the features in the Concept Menu to create and modify beam models. To begin Concept Modeling, you can
either create line bodies using the Section : Construction Point and Section : Line features in the Section : Draw
Toolbox to design a 2D sketch and generate a 3D model, or use the Section : Import External Geometry File feature.
Line Bodies can be created using either method.
The following feature options are available under the Concept Menu:
Using the Section : Model Appearance Controls, you can modify your model's cross section assignments and
alignments before body grouping. Use the Section : Form New Part feature to group bodies.
The Lines From Points feature allows the creation of Line Bodies in DesignModeler that are based on existing
points. Points can be any 2D sketch points, 3D model vertices, and point feature points (PF points). The feature's
selections are defined by a collection of point segments. A point segment is a straight line connecting two selected
points. The feature can produce multiple line bodies, depending on the connectivity of the chosen point segments.
The formation of point segments is handled through an Apply/Cancel property.
Point Segments
Each Line Body edge is defined by a line connecting two points, forming a segment. The two points may be any
combination of 2D sketch points, 3D model vertices, and PF points. Point Segment selection is performed in two
ways:
• Point Pairs: Each segment is formed by selecting pairs of points. For every two points selected, one point
segment is formed.
• Point Chains: Point Segments are formed in a continuous chain by selecting a chain of points. The first
segment is defined by the first two points selected. Thereafter, each additional point selection defines
another segment, using the end of the previous segment as the start of the next segment.
As you select point segments, green lines will appear on screen indicating that a segment has been formed. To
remove a point segment, simply reselect the two points that define the segment and the segment will disappear.
To lock in your point segment selection, click the Apply button. All point segments highlighted in green will now
turn blue to indicate they've been locked in.
The Lines from Points feature starts off in Point Pairs selection mode by default. To change selection modes,
use the right mouse button context menu.
The Lines From Sketches feature allows the creation of Line Bodies in DesignModeler that are based on base
objects, such as sketches and planes from faces. The feature creates Line Bodies out of all sketch edges contained
in the selected base objects. multiple line bodies can be created, depending on the connectivity of the edges
within the base objects.
You can select sketches and planes from faces via the Tree Outline and lock in the selections through the Base
Objects Apply/Cancel property.
Multiple sketches, planes, and combinations of sketches and planes can be used as the Base Object for the creation
of line bodies.
88
Section : Concept Menu
The Lines From Edges feature allows the creation of Line Bodies in DesignModeler that are based on existing
model edges. The feature can produce multiple line bodies, depending on the connectivity of the selected edges
and faces. You can select 2D sketch edges, 3D model edges, and faces through two Apply/Cancel properties:
Edges
Line Body edges can be created from a combination of 2D sketch edges and 3D model edges.
Faces
Line Body edges are created from the boundary edges of each selected face.
Edge Joints
When the Lines From Edges feature executes, shared topology is created between the new line edges and the
original model edges that created them. Edges marked as shared are called edge joints, and are viewable by
turning on edge joint display (see Show Edge Joints). Two additional properties list the results of the Lines From
Edges operation:
• Edge joints generated: This tells you the number of edge joints that the Lines From Edges feature created.
• Expired edge joints: This will inform you of any edge joints that have expired due to model changes. If
any edges in an edge joint are modified in any way, then the edge joint will become expired and no longer
appear when viewing the edge joints. This property is not displayed if there are no expired edge joints
for a Line From Edges feature.
3D Curve
The 3D Curve feature allows the creation of line bodies in DesignModeler that are based on existing points or
coordinates. Points can be any 2D sketch points, 3D model vertices, and point feature points (PF points). Coordin-
ates are read from text files. The feature's selections are defined by a collection of points in a chain. The curve
passes through all points in the chain. All points in the chain must be unique. The 3D Curve feature can produce
multiple curves when reading the data from files.
• Closed End: connects the last point to the first point to form a closed curve.
• Open End: forces a closed curve to be open again.
• Clear All Points: removes all points from the chain.
• Delete Point: allows you to remove a point from the chain.
The feature is useful for creating curves that may be used as a Named Selection base object.
1. After a pound sign (#), everything else on that line is considered a comment and is ignored.
2. Empty lines are ignored.
3. Data consists of five fields, all on one line, separated by spaces and/or tabs:
90
Section : Concept Menu
c. X coordinate
d. Y coordinate
e. Z coordinate
4. A data line with the same Group number and Sequence number as a previous data line is an error. A
data line cannot contain the same Group number and Sequence number as a previous data line.
5. For a closed curve, the point number of the last line should be 0. In this case, the coordinate fields are
ignored.
20
The Split Line Body feature allows you to break Line body edges into two pieces. The location of the split is
controlled by the Fraction property, which determines where along the edge the split should occur. The edges
selected for the operation must come from active bodies. Section : Cross Section Alignment of the edges being
split will be passed to the split edges. Those edges with just default alignments will continue to have default
alignments, which will normally be +Z unless that is invalid, in which case +Y is used.
The value for Fraction specifies the ratio between the distance from the start point of the edge to the split location
and the overall length of the edge. For example, a Fraction value of 0.5 will split the edge into two edges of equal
length, each edge being half the length of the original edge. A Fraction value of 0.75 will split the edge into two
edges where the first edge is three quarters the length of the original edge and the other edge is only one quarter
the length of the original edge. The default value for Fraction is 0.5.
The Split Line Body feature may be applied only to Line body edges that are not used in a Section : Surfaces
From Lines operation. The reason for this is that the line splitting operation destroys the original edge to create
two new edges. Once the original edge is destroyed, any associativity between it and surface body edges is lost.
If you wish to both split an edge and use it to create a surface body, it is recommended that you split the edge
first, then use the two resultant edges in a subsequent Section : Surfaces From Lines feature.
The Split Line Body feature is generated using the default 0.5 Fraction value, then a cross piece is created
between the two split locations using the Section : Lines From Points feature:
Afterwards, if the Fraction value is changed to 0.25 and the model is regenerated, it would produce this result:
The Surfaces From Lines feature allows the creation of Surface bodies in DesignModeler that use Line body
edges as the boundary. Line body edges should be chosen such that they produce non-intersecting closed loops.
Each closed loop will create a frozen surface body that contains a single face. The loops should form a shape
such that a simple surface can be inserted into the model. Examples of simple surfaces are planes, cylinders, tori,
cones, and spheres. Simple twisted surfaces can also be created. After a surface has been generated, you can
choose to flip the normal of the surface by setting Flip Surface Normal to Yes. You can also choose to set
thickness in the Section : Details View.
92
Section : Concept Menu
Note that sometimes it is impossible to generate a single surface that will span the closed profile of Line Body
edges. In these cases, DesignModeler may still generate a surface body consisting of multiple faces. When this
happens, the faces that get generated are not guaranteed to remain persistent. By modifying the source edges
used in the feature, there is no guarantee that the same number of faces will get created or stay in the same
location on the Line Body. The Surfaces From Lines feature will be marked with a warning alerting you of this
occurrence.
Edge Joints
When the Section : Surfaces From Lines feature executes, shared topology is created between the new surface
body edges and the original line edges that defined the surface. Edges marked as shared are called edge joints,
and are viewable by turning on edge joint display (see Section : Show Edge Joints). Two additional properties
list the results of the Section : Surfaces From Lines operation:
• Edge joints generated: This tells you the number of edge joints that the Section : Surfaces From Lines
feature created.
• Expired edge joints: This will inform you of any edge joints that have expired due to model changes. If
any edges in an edge joint are modified in any way, then the edge joint will become expired and no longer
appear when viewing the edge joints. This property is not displayed if there are no expired edge joints
for a Section : Surfaces From Lines feature.
The Surfaces From Sketches feature allows the creation of surface bodies using sketches as their boundary.
Both single and multiple sketches may be used as the base objects for this feature. Base sketches must include
closed profiles and may not be self-intersecting. The Surfaces From Sketches feature is located in the Concept
Menu, and has two operations: add material and add frozen. After a surface has been generated, you can choose
to adjust the normal of the surface. By default, the normal will be aligned to the plane normal. You can change
this by setting Orient with Plane Normal to No in the Details View. You can also adjust the thickness of the
surface in the Details View.
After:
94
Section : Concept Menu
Cross Section
Cross sections are attributes assigned to line bodies to define beam properties in Simulation. In DesignModeler,
cross sections are represented by sketches and are controlled by a set of dimensions. You may only modify the
dimension values and dimension locations of a cross section; they are not to be edited in any other way. The el-
even cross section types supported in DesignModeler correspond directly to specialized beam section types
used in the ANSYS environment.
To change a cross section dimension's location, use the right mouse button option, Section : Move Dimensions,
available when right clicking on the cross section in the Tree Outline or when right clicking in the graphics
96
Section : Concept Menu
window when viewing a cross section. DesignModeler will enter a dimension moving state, identical to the tool
used to move dimensions in the Section : Dimensions Toolbox in Sketching Mode. When you are done moving
dimensions on the cross section, the Move Dimensions state is ended by clicking on another item in the Tree
Outline or by clicking the Section : New Selection button.
Note that for Section : User Integrated cross sections, the Move Dimensions option does not appear because
there is no sketch representation for cross sections of this type.
Note that the check mark on a line body will be yellow if no Cross Section is assigned or if a default alignment is
being used. The check mark will be red if the alignment is invalid.
To make cross section assignment faster, you can also assign cross sections to multiple bodies at once. By using
the [Ctrl] key or by using box selection, you can select multiple line bodies. In the Details View, you will see the
number of line bodies selected at the top of the property group. Though the properties shown are specific to
the first line body selected, the cross section assignment will apply to all selected bodies. Below is an example
of what you would see when four line bodies are selected.
• Centroid: The cross section is centered on the edge according to its centroid. This is the default setting.
• Shear Center: The cross section is centered on the edge according to its shear center. Note that for this
setting, DesignModeler draws the body's edges the same way it does for Centroid. When analyzed, the
shear center is used.
• Origin: The cross section is not offset and is taken exactly as it appears in its sketch.
For black line body edges, you'll notice that each one has a small alignment triad shown with it, as shown in the
picture below. The blue arrow identifies the edge's tangent direction, while the green arrow r epresents the
alignment vector. It is this green arrow that defines the +Y direction of the cross section on the edge. The green
arrow is defined by a reference direction, which is set through an Apply/Cancel property for line body edges. A
line body edge's alignment becomes invalid when its reference direction is parallel to the edge's tangent direction.
By default, initially all line body edges are aligned in either the global +Z direction, or if that would be invalid,
the global +Y direction. The text for this property will indicate if +Z or +Y is being used and will be colored if a
valid alignment edge has not been selected. While a default alignment results in valid edge orientation for most
line body edges, it does not necessarily mean the cross section is aligned in the desired manner. You should
check the alignment arrows of your edges or inspect the line bodies with their solid facet representation to ensure
that your cross sections have the desired alignment on the edges. See Viewing for more information on line
body display modes.
98
Section : Concept Menu
Note — The icon on a line body will be yellow if no cross section is assigned or if a default alignment is
being used (unless the cross section type is Section : Circular or Section : Circular Tube, where default
alignment is considered acceptable). The icon will be red if the alignment is invalid. For more information
see Section : Body Status
To set the line body edge's alignment, first select the edge in the graphics window. A property called Cross Section
Alignment will appear in the Details View. If there is no alignment direction defined for the edge, then the
property will appear in yellow as “Not Selected”. Activating the Apply/Cancel buttons of this property will place
you in an alignment selection mode, where you may select entities in the Tree Outline or from the graphics on
screen to define a reference direction. The reference direction may be any of the types described in Section :
Direction Reference, though usually plane normal directions are most often used. When you've selected the
desired direction reference, you can assign it by clicking the Apply button. To preserve the previously assigned
reference direction, click Cancel. To clear the reference direction from a line body edge, you can clear the selection,
then click the Apply button. The direction reference will be cleared and the default global +Z or +Y direction will
again be used.
You can also change the Alignment mode to Vector, and enter an X, Y, and Z direction for the alignment vector.
When not in 'Vector' mode, these fields are used to show the direction of the current alignment selection (or
default), though they will be read-only.
In addition to the default or specified alignment, you can also specify a 'Rotate' angle. This rotation will be applied
after the alignment is processed. There is also now an option, 'Reverse Orientation?' If you set this to 'Yes,' it treats
the edge as though it has been reversed. If you are displaying the triad, you will see that it displays at the opposite
end, and that the X and Z axes directions have reversed. This also effects the direction of any additional 'Rotate'
angle.
Finally, when finished editing Cross Section Alignment properties, ESC, Section : Generate, or reselection the
Select icon can be used to easily clear the Details View display.
Note — Line Bodies with unaligned edges (or no Cross Section assignment) will be shown with a yellow
check mark in the Tree Outline. If it has any edges with invalid alignments, it will have a red indicator.
See Section : Cross Section for more information.
The table below illustrates the cross section alignment of an edge that is valid.
100
Section : Concept Menu
To make cross section alignment faster, you can also assign direction references to multiple edges at once. By
using the [Ctrl] key or by using box selection, you can select multiple line body edges. In the Details View, you
will see the number of line body edges selected at the top of the property group. Though the properties shown
are specific to the first line body edge selected, the cross section alignment will apply to all selected edges. Below
is an example of what you would see when four line body edges are selected.
Rectangular
• B = Width
• H = Height
Y
H
B X
Circular
• R = Radius
102
Section : Concept Menu
Y
R
Circular Tube
Y
Ri
X
Ro
Channel Section
Data to be supplied in the Channel Section value fields: W1, W2, W3, t1, t2, t3
W2
t2
W3 t3
X
t1
W1
I Section
Data to be supplied in the I Section value fields: W1, W2, W3, t1, t2, t3
W2
t2
W3
t3
Y
X
t1
W1
Z Section
Data to be supplied in the Z Section value fields: W1, W2, W3, t1, t2, t3
104
Section : Concept Menu
• t3 = Stem thickness.
W2
t2
W3 t3
Y
X
t1
W1
L Section
t2
W2
Y
X
t1
W1
T Section
• W1 = Flange width.
• W2 = Overall depth.
• t1 = Flange thickness.
• t2 = Stem thickness.
t2
W2
Y
X
t1
W1
Hat Section
Data to be supplied in the Hat Section value fields: W1, W2, W3, W4, t1, t2, t3, t4, t5
W3
t3
W4 t4 t5
t1
X t2
W1 W2
Rectangular Tube
Data to be supplied in the Rectangular Tube value fields: W1, W2, t1, t2, t3, t4
106
Section : Concept Menu
t2
t4
W2
Y
X
t3
t1
W1
User Integrated
Arbitrary: User-supplied integrated section properties instead of basic geometry data. Data to be supplied in the
User Integrated value fields: A, Ixx, Ixy, Iyy, Iw, J, CGx, CGyz, SHx, SHy
Note — For User Integrated cross sections, there is no sketch representation. When displaying line bodies
with their cross sections as solids, line bodies that use the User Integrated cross sections will have no
solid representation.
In order to delete a cross section, it must first be unused. That means the cross section cannot be assigned to
any line body in the model.
Within ANSYS Workbench, parameters can be passed from application to application (e.g. Pro/ENGINEER to
DesignModeler) and updated from ANSYS Workbench applet to applet (e.g. DesignModeler to Simulation). Once
a parameter is created and uniquely named, it can be accessed through related applications/applets.
Parameters Windows
DesignModeler distinguishes between plane/sketch or feature dimensions and design parameters. A model
easily contains hundreds of dimensions. It is not useful to consider all of them for parametric studies. Thus,
DesignModeler allows you to “promote” a selected set of these to Design Parameters. The Parameters tool
includes four tabbed windows:
To display the Parameters windows, click on the Parameters feature in the toolbar or choose the Parameters
menu item from the Section : Tools Menu. You can edit the text that appears in each window.
Note that these Design Parameters will be filtered according to the Parameter Key that you specify on the
Project Page.
See Sending Parameters to Simulation for information specific to the Project Page.
The left-hand side is a reference to one of the plane/sketch or feature dimensions, or, optionally, a reference to
an auxiliary “variable”.
The right-hand side is an arbitrary expression in +, -, e+, e-,*, and /, including parentheses, referencing Design
Parameters (here, the syntax uses the “@” prefix) and feature dimensions, but also numeric constants or references
to auxiliary variables and parametric functions. DesignModeler will evaluate the right-hand side of each expression,
and use the resulting value to drive the dimension referenced in the left-hand side.
Plane/sketch dimensions are referenced by the plane's name, followed by a period (“.”), followed by the dimensions
name. The syntax for feature dimensions is as follows: feature name, followed by a period (“.”), followed by 'FD1,'
'FD2,' ... (“Feature Dimension 1,” “Feature Dimension 2,” ...) according to the Section : Details View of the corres-
ponding dimensions property of the feature in question.
These expressions can also be used to make a dimension in one plane or feature drive the dimension of another
plane or feature.
Check Tab
The Check tab triggers an execution of the Parameter/Dimension Assignments without updating the model.
This can serve as a “syntax check” in case you are using nontrivial assignments.
The contents of the Check tab is a log output; it serves no other purpose -- editing it has no effect. The first
column is the corresponding line number in the Parameter/Dimension Assignments text. The second column
classifies the line into one of four types:
The next column is the assigned value; i.e., the result of the right-hand-side expression of the corresponding
Parameter/Dimension Assignments. This is followed by a printout of the right-hand-side expression itself.
The log output will be interrupted in case of a “syntax” error. This includes errors where Design Parameters are
references (“@”'prefix) which do not exist.
Close Tab
The Close tab closes the Parameters text window, and returns to the model-only view.
Creating Parameters
You can also promote feature and sketch dimensions directly through the Section : Details View.
Feature and sketch dimensions contain check boxes next to their properties in the Section : Details View. When
the check box is clicked, a popup dialog will appear which allows you to give the design parameter a name.
Design Parameter names cannot contain spaces, nor special characters, nor can they begin with a numeric
character. After clicking OK, DesignModeler creates the design parameter in the Design Parameters text window
and then assigns the feature or sketch dimension to that design parameter in the Parameter/Dimension As-
signments text window.
Note — Even though the pop-up dialog provides you with an unique default parameter name, it is re-
commended to rename the Design Parameter to something more fitting to your analysis.
Afterwards, the Section : Details View shows the letter “D” next to feature and sketch dimensions that are “driven”
by design parameters. A driven feature or sketch dimension becomes read-only in the Section : Details View,
since its value is now determined by the Parameter Manager. Parameter assignments can be cancelled by clicking
the “D” check box again. This will comment out the assignment line in the Parameter/Dimension Assignments
text window and clear the “D” that was in the check box. Clicking the check box will toggle the parameter assign-
ment on and off. Once created, the design parameters themselves always remain unless deleted or commented
out manually in the Design Parameters text window.
Note — If you choose to promote the parameters of an Attach feature to DesignModeler Design Para-
meters, you will instead see a “P”. You cannot undo the operation, i.e., you cannot uncheck the “P” in this
case. A CAD parameter cannot contain spaces, otherwise it will not be parsed correctly in the Parameter
Manager.
By clicking the check boxes in the Section : Details View, Design Parameters can be easily enabled or disabled.
However, if you choose to manually modify the contents of the Design Parameters or Parameter/Dimension
Assignments text windows, you must ensure your changes are consistent among both windows. For example,
if you wish to manually delete an entry in the Design Parameters text window, you must also delete all references
to that entry in the Parameter/Dimension Assignments window. Use the Check tab to inspect your changes
and help pinpoint errors, if any.
Once you have created Design Parameters to define your model, varying them is easy. Just change the Design
Parameter values in the first text window, then click the Check window tab to verify your changes. Note that
any features that are affected by the Design Parameter change will be marked as updated. Click Generate to
update the model.
Parameters Tutorial
The basic steps used in adding Design Parameters to a model in DesignModeler are illustrated in Section :
Process for Creating A Model.
Parametric Expressions
Parametric expressions involve operations among parameters and numbers such as addition, subtraction, mul-
tiplication, and division. The available parametric expressions for DesignModeler are listed in the table below.
Operator Operation
+ Addition
— Subtraction
* Multiplication
/ Division
^ Exponentiation
% Modulus; returns the remainder of x/y.
E+, E-, e+, e- Scientific notation
Parentheses can also be used for clarity and for nesting operations. The order in which DesignModeler evaluates
an expression is as follows:
Note — + or - must follow e/E in Parameter/Dimension Assignments tab but + need not follow e/E in
Design Parameters tab as it is implied.
P = (R1+R2)/2
Parametric Functions
A parametric function is a sequence of operations that return a single value, such as SQRT(x), LN(x), or SIN(x). The
available functions for DesignModeler are listed in the table below.
COS(x)
TAN(x)
ASIN(x) Arcsine, Arccosine, and Arctangent of x. x must be between
-1.0 and +1.0 for ASIN and ACOS. Output is in degrees by de-
ACOS(x) fault. Range of output is -90 to +90 for ASIN and ATAN, and
0 to 180 for ACOS.
ATAN(x)
D = exp(ln(x)) # Evaluates to x
To send all Design Parameters to Simulation, make the Parameter Key blank before starting the simulation.
Note that this should not be confused with the Parameter Key property used in Section : Import External Geometry
File and Section : Attach to Active CAD Geometry features accessible via the Section : File Menu.
Note that when importing CAD models into DesignModeler, you can promote those CAD parameters to be
Design Parameters in DesignModeler. However, if a CAD system contains multiple parameters with the same
name, then only one of them can be promoted in DesignModeler.
This feature provides the option of running JScript files (extension .js) to create basic geometry in DesignModeler.
Access to DesignModeler functions is accessible via the prefix 'agb.', as in the command:
To execute one of these files, click Run Script in the File Menu. This opens a file browser window where you can
select the file to run.
Note — Although JScript is case sensitive, an error message is not generated when an inaccurate variable
is entered. JScript allows mixed-case variables by the same name to coexist.
Creation Limits
Bound by the definitions in script, some items can be created via a single command, while others take multiple
commands for the full definition. In the multiple command cases, the first command creates the basic item or
feature, then additional commands provide the additional required information. This additional information can
be in the form of functions or properties of the base object, as noted in:
• Script Constants
• Script Features
For most of the multiple commands, an 'agb.Regen();' command is required to complete them. In these cases,
the feature in not completely created until the Regen command is executed. If you are creating multiple features,
you cannot simply put a single Regen() command after all of them. The Regen command must follow each feature
definition as it completes the definition of that feature.
Special Constants
Some commands will require special constants as input arguments. These constants are accessed as 'agc.Name'.
For example, when creating a Point feature, you need to provide the Point type and Definition type. Because
there is only one form of the Point feature available in script, the following example script can be used to create
a Point feature from a coordinate file.
In this simple script, the basic Point feature (PF1) is created first, using constants to designate the type of Point
feature to create. Next the “Coordinate File” property of the feature is set, giving the full path and name of the
coordinate file to read. When the '\' is included in a text string, it is given twice, even though this represents just
one '\' in the actual path. Finally the Regen() command completes the operation.
In general most features have a “Name” property. This allows you to set the name that will appear in the tree for
this feature. For example, in the above sample, an additional line could be added to set the name that would
appear in the tree:
PF1.Name = "BoxPoints";
Script Constants
Note — The codes using back slash paths listed below apply to the Windows operating system. UNIX
users must use forward slashes instead.
//Material Mode
agc.Add //Add Material
agc.Frozen //Add Frozen
Script Features
Script features include two basic functions and five DesignModeler features. Complete descriptions of the features
are accessible by clicking on the feature name from the list below.
Functions
• Selection
• Point Access
Features
• Point
• Lines from Points
• Surfaces From Lines
• Cross Section
• Form New Part
Selection Functions
The selection functions are restricted to use with Surfaces From Lines and Form New Part from selected bodies.
is not an 'n'th match, then nothing is added. If the second argument is not provided, multiple edges can
be added to the current selection. The ID is set in the AddSegment command for the Line From Points
feature below. If it is not set, then its value is 0.
Plane Features
• PlaneFromPlane(basePlane)
• PlaneFromPointEdge(point, edge)
• PlaneFromPointNormal(point, item1, item2, item3): For this call, item2 and item3 are optional
depending on how you define the Normal. It can be with an edge, two points, or three points (a cross
product is used).
• PlaneFrom3Points(point1, point2, point3)
• PlaneFromCoord(x, y, z, i, j, k)
Properties
• Name: Allows the feature to be named, e.g. "CenterPlane".
• ReverseNormal: Reverses/flips/inverts both the plane normal and X-axis.
• ReverseAxes: Reverses/flips/inverts both the X- and Y-axis of the plane.
• ExportCS: Exports the plane as a coordinate system into Simulation.
Functions
• AddTransform(type, value, edge): Adds a transform to the plane. The value and edge arguments
are optional, but may be needed by the transform type you select. Note that for transform types
XformEdgeRotate and XformXAlignEdge you should include both the value and edge arguments.
• GetOrigin(): Returns the origin point of the plane.
• GetXAxis(): Returns the X-axis line of the plane.
• GetYAxis(): Returns the Y-axis line of the plane.
Example
var PF1 = agb.FPoint(agc.FPointConstruction, agc.FPointCoordinateFile);
PF1.CoordinateFile = "E:\\Onyx90\\box8pt.txt";
agb.Regen(); //To insure model validity
var LF1 = agb.LinePt();
LF1.AddSegment(PF1.GetPoint(1, 1), PF1.GetPoint(1, 2), 1);
LF1.AddSegment(PF1.GetPoint(1, 2), PF1.GetPoint(1, 3), 2);
agb.regen();
var Yes = agc.Yes;
var No = agc.No;
spt0 = pl4.GetOrigin();
var spt2 = PF1.GetPoint(2, 2);
var spt3 = PF1.GetPoint(2, 4);
var pl6 = agb.PlaneFrom3Points(spt0, spt2, spt3);
if(pl6)
pl6.Name = "Batch_3_Pts";
agb.regen();
PF1.GetPoint(1, 4));
if(pl10)
pl10.Name = "Batch_PT_Normal_3Pts";
agb.regen();
Point Feature
• FPoint(Type, Definition)
Type Options
• agc.FPointConstruction: Construction Point
Definition Options
• agc.FPointCoordinateFile: From Coordinate File
Properties
• Name: Allows the feature to be named, e.g. "BoxPoints"
• CoordinateFile : Allows the Coordinate File to be set, e.g. "D:\\Samples\\Box.txt"
Functions
• GetPoint(Group, Id): Allows access to a point defined by the Point feature. (See the Line from Points
feature for an example of its use)
Note — Only a single Type and Definition are supported in script. This allows creation of a Point feature
from a Coordinate File. The format of the coordinate file is described in the standard documentation for
this feature. The required sequence is to define the feature, set its coordinate file, and then do a Regen().
Naming it is optional.
Example
var PF1 = agb.FPoint(agc.FPointConstruction, agc.FPointCoordinateFile);
PF1.Name = "BoxPoints"; //This is not required
PF1.CoordinateFile = "D:\\Samples\\Box.txt";
agb.Regen();
//Here is how to get the coordinates of one of the points
var pt1 = GetPoint(1,1);
var x = agb.GetPointX(pt1);
var y = agb.GetPointY(pt1);
var z = agb.GetPointZ(pt1);
Properties
• Name: Allows the feature to be named, e.g. "TableTopLines"
• Material: agc.Add for 'Add Material' (default if not specified) and agc.Frozen for 'Add Frozen'
Functions
• AddSegment(Pt, Pt, ID, x, y, z): Adds a segment to the Line feature, and optionally sets its ID
and alignment. The ID and alignment are optional arguments. In order to supply the alignment, an ID
must be supplied. However, if the ID is zero, it will not be used. If during the creation of this feature this
segment is split into multiple edges, each will get the specified ID and/or alignment, if specified.
• GetNumBodies(): This can only be used after a Line feature is created and Regen called. Gets the number
of Line bodies created from the feature. This may not be the same as the number of segments added. It
depends on how many segments are connected, or intersect, and if segments connect with segments
from other Line features. Because of this the number can range from 0 to the number of segments added.
• GetBody(index): This can only be used after a Line feature is created and Regen called. This is called
with a value of 1 to the number returned by GetNumBodies.
• GetNumEdges(): This can only be used after a Line feature is created and Regen called. Gets the number
of Line edges created from the feature. This may not be the same as the number of segments added. It
depends on how many segments intersect other edges (this can create additional edges), and if segments
overlap existing edges. A segment that totally overlaps an existing edge will not create any edge. Because
of this the number can range from 0 to more than number of segments added.
• GetEdge(index): This can only be used after a Line feature is created and Regen called. This is called
with a value of 1 to the number returned by GetNumEdges.
The Line from Points feature can be created from existing points. These must be points defined by the Point
feature. Naming it is optional. This feature can be created by either using AddSegment calls after creation function,
LinePt(), or by putting the points in the selection list before calling LinePt(). If you put the points in the selection
list first, via agb.AddSelect(agc.TypeFPoint, point), where GetPoint is used to get the point, there are two restric-
tions.
First, this method does not allow you to set the alignment vector. Second, a point can only be in the select list
once, so this cannot be used if you need to use a point more than once. With either method, the feature is not
complete until you issue the Regen() command.
Example
var PF1 = agb.FPoint(agc.FPointConstruction, agc.FPointCoordinateFile); //Creates basic feature
PF1.Name = "TablePoints"; //This is not required
PF1.CoordinateFile = "D:\\Samples\\Table.txt";
agb.Regen(); //Feature not complete until this is done
Properties
• Name: Allows the feature to be named, e.g. "Hood"
Note that for this feature, you must first use AddSelect(agc.TypeEdge3d, edge) to add the Line Edges you want
to use to the selection set prior to invoking the SurfFromLines() function. The required sequence is to preselect
the lines, define the feature, and then do a Regen(). Naming it is optional.
Example
//Points
var PF1 = agb.FPoint(agc.FPointConstruction, agc.FPointCoordinateFile);
PF1.CoordinateFile = "E:\\Onyx81\\box8pt.txt";
agb.Regen(); //To insure model validity
//Bottom
var LF1 = agb.LinePt();
LF1.AddSegment(PF1.GetPoint(1, 1), PF1.GetPoint(1, 2));
LF1.AddSegment(PF1.GetPoint(1, 2), PF1.GetPoint(1, 3));
LF1.AddSegment(PF1.GetPoint(1, 3), PF1.GetPoint(1, 4), 1); //Note setting ID=1
LF1.AddSegment(PF1.GetPoint(1, 4), PF1.GetPoint(1, 1));
agb.Regen();
var i;
var edge;
var numb1 = LF1.GetNumEdges();
if(numb1 == 4)
{
agb.ClearSelections();
for(i=1; i<5; i++)
{
edge = LF1.GetEdge(i);
agb.AddSelect(agc.TypeEdge3d, edge);
}
var surf1 = agb.SurfFromLines();
agb.regen();
}
//Now select using IDs
agb.ClearSelections();
agb.AddSelectEdgeID(1);
agb.AddSelectEdgeID(2);
agb.AddSelectEdgeID(3);
agb.AddSelectEdgeID(4);
var surf2 = agb.SurfFromLines();
agb.Regen();
Properties
• Name: Allows the feature to be named, e.g. "tube4x6"
Example
var CS1 = agb.CSRect(6.0, 4.5); //Creates rectangular Cross Section 6 units wide by 4.5 units high
CS1.Name = "Top";
Properties
• Name: Allows the part to be named, e.g. "Bracket"
These functions allow you to combine all bodies created by feature functions, or only those you added to the
selection set, into a single part.
1. From the main menu, choose Tools> Options. An Options dialog box appears and the DesignModeler
options are displayed on the left.
2. Click on a specific option.
3. Change any of the option settings by clicking directly in the option field on the right. You will first see a
visual indication for the kind of interaction required in the field (examples are drop down menus, secondary
dialog boxes, direct text entries).
4. Click OK.
Section : Geometry
Section : Graphics
Section : Miscellaneous
Section : Toolbars
Section : Units
Section : Grid Defaults
Other help descriptions available that describe the Options dialog box:
• Common Settings
• CFX-Mesh
• Simulation
• DesignXplorer
• Licensing
Geometry
The Parasolid category includes:
• Transmit Version: DesignModeler writes your model in Parasolid format when you Export using the .x_t
or .x_b extension. The Geometry preference displays the Transmit version (16.0, 15.0, 14.0, 13.0, or 12.0)
which is useful when you want to transfer your model into a third-party CAD program that uses a different
Parasolid version. DesignModeler defaults to Transmit Version 15.0.
• Body Validation: The Body Validation allows you to select one of three values:
• Problematic Geometry Limit: This defines the maximum number of problematic geometries collected
for a feature. The selectable range of the Problematic Geometry Limit is from 1 to 20, with 10 being the
default.
• IGES Export Type: Allows you to export solids or trimmed surfaces when exporting a model to an IGES
file. The default is Solids.
• Enable MCNP Options?: Enables several features specific to MCNP operations:
1. Always
2. Never
3. Up to Limit, in which case the limit is given in the next preference (default).
• Measure Selection Limit (#faces/edges): specifying the maximum number of 3D (model) edges or faces
to trigger automatic selection measurements.
The default setting for the Section : Measure Selection preferences is Up to Limit, and Limit = 25. They occur in
two instances:
1. The Surface Area and Volume properties under the Detail View of a body
2. The (current) Selection Information area at the lower-right side of the screen (i.e., towards the right, on
the status bar).
Selection measurements may be a CPU-intensive endeavor; especially (1) when selecting complex bodies (i.e.,
solids or surfaces) in the Tree View, and/or (2) when accumulating large and complex (model) face/edge selection
sets, most probably via the Extend Selection toolbar buttons. The mentioned option settings allow you to influence
DesignModeler's behavior.
If automatic selection measurements are disabled - either due to the option setting Never or because of going
“over” the specified Limit, then DesignModeler will skip the measurements. However, there will be a right mouse
button Context Menu option Measure Selection, which will allow the user to compute the measurements on
demand.
Graphics
The Graphics category includes:
• Facet Quality: You can control the quality of DesignModeler's model facets. The Facet Quality setting is
a number between 1 (lowest quality) and 10 (highest quality). The default setting is 5. Shown here, left to
right, is an example of Facet Quality 10 and Facet Quality 1.
Setting the facet quality higher will improve the look of the model, but DesignModeler will take longer to generate
model facets. Setting the facet quality lower will speed up facet generation, but reduce the visual quality of the
model. Note that the Facet Quality setting does not affect the actual geometry of the model; it only affects how
the geometry is displayed.
Note — It is strongly recommended that you use the default Facet Quality setting or lower with very
large models. Model faceting is a memory intensive operation. With a high Facet Quality setting, the
system may fail to generate facets due to insufficient memory.
• Minimum and Maximum Scale: the amount that dimensions will animate relative to the original dimension.
For example, values of 0.5 and 1.5 will cause the dimension to animate between 50% and 150% of its
original size.
Miscellaneous
The Display category includes:
• Startup Mode: Modeling (Modeling/Sketching). You can choose which mode you would like DesignModeler
to start in. The default is Modeling.
• Folder for temporary files: DesignModeler occasionally uses temporary files. Here you can specify a
folder to put these files. The default is operating system dependent.
• Auto-save Frequency: This property defines how often DesignModeler performs an auto-save of the
model. The choices are:
– Every Generate
– Every 2nd Generate
– Every 5th Generate
– Never Auto-save
Note — Choosing the Never Auto-save option will disable Auto-save. The default frequency is
Every 5th Generate.
• Auto-save File Limit (per model): This is the number of Auto-save files stored for each model. You may
choose a number between 5 and 20. The default is 10.
• Delete auto-save files after...(days): This is the number of days that DesignModeler will keep auto-save
files before automatically deleting them. The default is 60.
• Max Recent File Entries: This is the number of entries (1–10) that will show in the Recent AGDBs, Recent
Imports, and Recent Scripts menus. The default is 5.
• XZ-ZX Plane Direction for new parts: Allows you to choose whether the second standard plane (along
with XYPlane and YZPlane) is to be an XZPlane, with its normal being (0.-1,0), or a ZXPlane with its normal
being (0,1,0). The default is ZXPlane.
• Point Feature Limit: This represents the maximum number of PF points allowed per Point feature. The
default is 500.
• Image Resolution: The quality of the screenshot image. Choices are Normal (default), Enhanced, and
High (Memory Intensive).
• Image Type: The type of graphics image used for screenshots. Choices are PNG (default), JPEG, and BMP.
• Use Spaceball: Set to No if you wish to disable support for the Spaceball device. The default is Yes. (Not
supported in UNIX)
Toolbars
The Feature Toolbar is now customizable. You can specify which features will be available as icons in the Feature
Toolbar. The Show icon in Feature Toolbar... categories control which icons will appear in the toolbar. Any
feature that appears in any of the menus described above can be added to the toolbar by selecting Yes next to
its name.
Note — The first icon in the Feature Toolbar is always the Generate button. This is hard-coded, and cannot
be changed. Because the Feature Toolbar has limited screen real-estate, if you add too many icons in
your customization, using Show Toolbar Texts = Yes, then the toolbar may be cutoff, and the last icons
will “fall off” the screen.
Units
The Units category includes:
• Length Unit: reflects the current units selection. Millimeter is displayed by default but can be changed
to your default unit of preference (Centimeter, Meter, Inch, Foot).
• Display Units Pop-Up Window: sets whether the Units pop-up window is displayed. The Units pop-up
window appears when moving to DesignModeler from the Start Page and allows you to select a length
unit at that point. The Units pop-up window includes an Always use default checkbox, which when
checked, causes the Units pop-up window to not display upon subsequent moves to DesignModeler from
the Start Page. By setting Display Units Pop-Up Window to Yes (the default), you can reset the Units
pop-up window to appear upon subsequent moves to DesignModeler from the Start Page. The window
is only viewable in the Workbench Mode.
Grid Defaults
The unit length reflects the current selection.
In the Grid Defaults category, note that each plane has its own grid settings, so you can set each plane's grids
differently. The grid settings in the Options dialog box define what the default grid settings are for each new
plane created. The Grid Defaults category includes:
• Minimum Axes Length: This allows you to set the default length of the axes for newly-created planes.
The default size of the grid, if any, will always be twice this length. Note that this is just the minimum size.
As items are created outside this range, the axes and grid will expand as needed. If these items are later
deleted, the axes and grid can shrink back down to the Minimum Axes Length. The default varies depending
on the units you choose.
• Major Grid Spacing: The setting for the number of units in between consecutive thick grid lines. The
default varies depending on the units you choose.
• Minor-Steps per Major: This determines the number of thin grid lines per major line. The default varies
depending on the units you choose.
• Grid Snaps per Minor: This allows you to specify intermediate snap locations between minor grid lines.
The default is 1.
• Show Grid (in 2D Display Mode): This allows you to show the grid in 2D by default. The default is No.
• Snap to Grid (while in Sketching): This allows you to turn on Snap in 2D by default. The default is No.
• Apply Grid Defaults to Active Plane: By changing it to Yes, the grid defaults in the Options dialog box
will be applied to the active plane. Note that this setting is always No when the Options dialog box is
opened.
Usage Examples
Grid Snaps per Minor in the Settings group allows you to specify intermediate snap locations between minor
grid lines (1-1000). You can use this to reduce the density of the grid display, while still snapping to a tighter
grid. For example, in millimeters if the Major Grid Spacing is set to 10, you can set the Minor-Steps per Major
to 5, and the Grid Snaps per Minor to 2. This way, minor grid lines are displayed every 2 mm, but snapping is
still to every mm.
Another way to use this function is to set this to a value such as 100 or 1000. This way, sketching does not appear
to be snapping to a grid, but it actually is and the coordinates of your sketching are being snapped to 1/100th
or 1/1000th of your minor grid line spacing. For example, if the minor grid lines are every inch and the Grid
Snaps per Minor are set to 100, when sketching a point its coordinates will end up as numbers such as 8.36 or
5.27 instead of 8.357895846483938474 or 5.27123934933421 with no grid snapping at all.
CFX-Mesh produces meshes containing tetrahedra, prisms and pyramids in standard 3D meshing mode, and
additionally can include hexahedra in the Extrude 2D meshing mode. It produces output in the form of a CFX
Section : CFX-Pre Mesh File, suitable for importing directly into CFX-Pre, the CFX-5 pre-processor. Extensive ad-
vanced surface and volume mesh generation controls are available, including:
• Section : Inflation
• Section : Controls
• Edge and Surface Proximity detection
• Parallel volume meshing
There are some restrictions on the topology of your geometry. These are described in Geometry.
Define Regions
When you come to set up your CFD simulation, you will need to define boundary conditions on which to apply
specific physics. For example, you may need to define where the fluid enters the geometry or where it leaves.
Although it would be possible to select the faces which correspond to a particular boundary condition in CFX -
Pre, it is rather easier to make this selection in CFX-Mesh. In addition, it is much better to define the location of
periodic boundaries before the mesh is generated to allow the nodes of the surface mesh to match on the two
sides of the periodic boundary, which in turn allows a more accurate CFD solution. You can define the locations
of boundaries by creating Composite 2D Regions in the appropriate locations from within CFX-Mesh.
In many simple cases, the need for mesh controls is removed by the setting of appropriate local face mesh spacings,
Edge Proximity and Surface Proximity. These controls can be used in isolation, or in combination. Inflation is
used to control the near-wall internal mesh distribution.
CFX-Mesh uses all the current Mesh Control settings to determine the appropriate size of the mesh in a particular
region. In general, the element size is determined by the minimum length scale from all Mesh Controls, the local
length scale from surface mesh parameters and global length scale.
The surface mesh can be previewed before generating the volume mesh by using the Preview function. Preview
Groups can be used to view the surface mesh on selected faces or the whole surface mesh can be generated in
one go.
Two surface meshers, the Section : Delaunay Surface Mesher and the Section : Advancing Front (AF) Surface
Mesher, are available for use.
An alternative volume mesher, the Section : Extruded 2D Meshing, is available for two-dimensional or simple
extruded meshes.
The volume mesh is written to a CFX-5 Section : CFX-Pre Mesh File ready for import into CFX-Pre. It cannot be
viewed in CFX-Mesh.
Mesh Adaption
The CFX-5 software allows you to refine your mesh automatically as the solution to your CFD calculation is ob-
tained. This helps to ensure that a fine mesh is used where the solution is changing most rapidly. The set-up for
Mesh Adaption takes place in the CFX-Pre software, not in CFX-Mesh. Mesh Adaption can be used to improve a
reasonable solution; it cannot be used to produce good solutions from a initial poor quality mesh, so you must
still generate a reasonable mesh to begin with.
Note that the link above is an internet link to up-to-date tutorials, not to material stored on your computer. If
internet access is not available from the machine you want to use, or if the speed of your connection is too slow
for this to be convenient, then you can instead download the tutorial files as a package, put them on your local
machine and view them locally. You may have to update this package when the tutorials are updated, particularly
upon the release of a new version of CFX-5. An up-to-date package should be readily available from the CFX
Community Website: go to http://www.ansys.com/cfx and follow the Community link. This site is available to all
registered users. If you have not already got a username and password, go to http://www-waterloo.an-
sys.com/cfx/community/apply.htm to apply.
If you want to print out the tutorials, then we recommend that you follow the instructions above to download
a package which is suitable for printing, and use this for printing from.
Please contact your local support representative if you have any difficulty in obtaining the tutorial package.
Also note that while using the software, pressing the F1 key over the Details View in CFX-Mesh will open up the
CFX-Mesh online help at a relevant page (“context-sensitive help”).
Tree View
The Tree View, located towards the top left of the CFX-Mesh window, shows the current state of the mesh settings.
The symbols to the left of each item's name are called Status Symbols and show the state of that particular item;
their meanings are listed in the table below.
• To delete an item from the tree, right-click on its name and select Delete from the context menu that
appears.
• To rename an item, right-click on its name and select Rename from the context menu that appears. Any
name must start with an alphabetic character, can be any length and can contain alphabetic characters,
numbers and single spaces.
• To change the settings of an object, left-click on its name and then edit the information in the Section :
Details View below.
• A plus symbol to the left of an item's icon indicates that it contains associated sub-items. Click on the plus
symbol to expand the item and display its contents.
• To collapse an item, so that none of its sub-items are visible in the tree, click on the minus symbol to the
left of the item's icon. To collapse all expanded items at once, double-click the Model name at the top of
the tree.
• To insert a new sub-item, right-click on the item and select Insert ... from the context menu that appears.
Some items are only allowed to appear once (e.g. Inflation, Stretch).
• To view all the items of a particular type, select the entry in the Tree View which contains them. The items
will then be highlighted in the Graphics windows. For example, to view all Virtual Topology, click on the
Virtual Topology heading in the Tree View. All Virtual Topology entities (Virtual Faces and Virtual Edges)
will then be highlighted.
For Regions and Spacings, there is a slight exception to this general rule. If you click on the Regions
heading in the Tree View, all Composite 2D Regions are highlighted except for the Default 2D Region. If
you click on the Spacing heading in the Tree View, all Face and Edge Spacings are highlighted except for
the Default Face Spacing. The Default 2D Region and Default Face Spacing are excluded as these contain
all the faces which are not otherwise assigned explicitly to a user-defined Composite 2D Region or a user-
defined Face Spacing; if they were included then the whole model would be highlighted when either of
these headings were selected.
• Several items are in the tree by default when the meshing database is created, and these cannot be deleted
or renamed. They include Region (with the Default 2D Region), Preview, Spacing (with the two default
spacing objects), Controls, Periodicity, Inflation, Stretch, Proximity and Options.
Status Symbols
Next to each item in the Tree View is a small symbol, known as a “Status Symbol”, that gives you information
about the status of that item. The meanings of these are given in the table below.
Symbol Meaning
Everything is valid.
Everything is valid but the item has been automatically changed and you may wish to double-check the settings.
This may occur, for example, if you have performed a geometry update which has resulted in a face no longer
existing: if that face appeared in the location list for any mesh feature, then it will have been removed automat-
ically as part of the update and so the mesh feature will be marked with this status symbol.
This means that there is something invalid about the definition of the item or one of its sub-items (which will
also be marked with the same symbol). Often this will be because no required selection has been made.
The item is suppressed (inactive).
Symbol Meaning
This status symbol only applies to Regions and Solid Bodies.
Everything is valid but the item has been hidden in the Graphics window. When this status symbol is displayed,
the item cannot be selected in the Graphics window; however, the item is not suppressed and will still be meshed
(although the mesh can be displayed on the item only when the item is visible in the viewer).
These status symbols only apply to Preview Groups.
If the symbol underneath the yellow flash is a green tick, then the Preview Group is valid but either the mesh
has not been generated or the generated mesh is out-of-date i.e. it does not reflect the current mesh settings.
To generate an up-to-date mesh for the Preview Group, right-click over its name and choose Generate This
Surface Mesh. To generate an up-to-date mesh on all Preview Groups, right-click over Preview in the Tree View
and choose to Generate All Surface Meshes.
If the symbol shows the yellow lightning bolt but the symbol underneath it is a yellow tick, then the Preview
Group is both out-of-date (see above) and automatically changed. Refer to the table entry for a yellow tick
symbol for details of what might cause an automatic change to a Preview Group.
If the symbol shows the yellow lightning bolt but the symbol underneath it is a red exclamation mark, then the
Preview Group is both out-of-date (see above) and invalid. You must make the Preview Group valid (by making
a valid selection for its Location) before you can generate or regenerate it.
This indicates that an item contains associated sub-items . Left-click on the symbol to expand the item and
display its contents.
Left-click on the symbol to close the item so that its contents are not visible in the tree.
Suppressing Objects
Items in the Tree View can be suppressed. This means that they become inactive. For instance, if you had set up
an Inflated Boundary, but wanted to try generating the mesh without it, then you could suppress the Inflated
Boundary, generate the mesh, and then, if required, simply unsuppress it to make it active again with the same
settings as before.
Most items can be suppressed, including Inflated Boundaries, Face Spacings and Controls. You can also suppress
higher-level objects. For example, you could suppress the entire Inflation entry to turn off Inflation, or suppress
the entire Controls entry to suppress all of the Controls.
Note that if you suppress geometry (Parts or Bodies) then this hides them from the Graphics window and stops
them from being included in the mesh. More details on how this affects the resulting mesh is given in Section :
Suppression of Bodies and Parts .
A suppressed object still shows in the Tree View, but its Status Symbol will become gray to indicate its status.
You must unsuppress an object before you can edit or delete it.
Items are suppressed by right-clicking on their names in the Tree View, and selecting Suppress. To unsuppress,
right-click again and select Unsuppress.
In addition to Suppress and Unsuppress, users can also Suppress All (when multiple entities exist), Unsuppress
All (when multiple entites exist), as well as Invert Suppression which inverts the state of the suppression for
each entity at the same level in the Tree View.
Hiding Objects
Items in the Region section and Bodies in the Geometry section of the Tree View can be hidden. This means that
they are not displayed in the Graphics window.
A face or edge that is part of Composite 2D Region or Body that is hidden cannot be selected; however, hiding
an item does not exclude it from the meshing process and if, after meshing, the status of an item is changed
from hidden to shown, the mesh can be displayed.
Note that if you suppress geometry (Parts or Bodies) rather than hiding it, then this hides the geometry from the
Model View and stops it from being included in the mesh. More details on how this affects the resulting mesh
is given in Section : Suppression of Bodies and Parts .
A hidden object still shows in the Tree View, but its Status Symbol will become a pale color to indicate its status.
Items are hidden by right-clicking on their names in the Tree View, and selecting Hide. To show again, right-click
again and select Show.
In addition to Hide and Show, users can also Hide All (when multiple entities exist), Show All (when multiple
entites exist), as well as Invert Visibility which inverts the state of the visibility for each entity at the same level
in the Tree View.
Details View
The Details View is found to the bottom left of the CFX-Mesh window. It contains all of the available information
for any item in the Section : Tree View. You can access it by clicking with the left mouse button on the item's
name in the Tree View.
Details which are grayed out cannot be edited, but most can be edited by simply clicking in the relevant box
and typing. Press Enter on the keyboard after typing in a box to make the change take effect, or simply move
the cursor out of the box.
You can change the name of an item by right-clicking on its name in the Tree View. This is not available through
the Details View.
Where a box requires you to make a selection, you can do this either by picking items from the Graphics window
(where appropriate) or through the Tree View directly. Selection is explained in Section : Selection.
4
Section : Toolbars and Icons
Most of the parameters and settings that require you to enter a number will only take numbers within a certain
range. See Section : Valid and Invalid Values for more details on valid ranges.
Selections of locations must satisfy the rules for the objects that you are trying to create. If you try to make a se-
lection which is invalid, then the selection will not be accepted. Some notes on valid selections are given under
the section which describes the feature which you are creating, and some notes for the case where you have
multiple Bodies in your geometry are in Section : 2D Regions and Faces.
To minimize the number of mouse clicks required to select a Location for any CFX-Mesh Model feature, the
Location selection is now made active when you first create that feature (e.g. Inflated Boundary, Preview Group,
Composite 2D Region). For example, this means that you can create a new Inflated Boundary and then immediately
click in Graphics window to select the faces for it, without having to first activate the Location selection by
clicking in the Details View.
In general, if you select an object in the Tree View, the Location selection for the first item which does not already
contain a valid selection is activated.
If you prefer not to have the Location selection being automatically activated, then you can set the CFX-Mesh
option Auto Activate to No, under Properties View Options. The CFX-Mesh options and how to set them are
described in CFX-Mesh Options.
Graphics Window
The Graphics window forms the largest section of the CFX-Mesh window, and is the place where the model is
displayed. It also shows the Section : Ruler and the Section : Triad, the axes in the bottom right corner. How to
move the model around and put it into selected views is described in Section : Display Control, Mouse Actions,
and the Rotation Modes Toolbar.
• Menus Toolbar
• Selection Filters
• Section : Interrupt
File Toolbar
The File Toolbar reproduces some of the functionality from the File menu.
Clear all the user-defined settings from the CFX-Mesh database (reinitialize the database).
Clear Settings This is equivalent to starting a new CFX-Mesh database with the same geometry, but is
quicker since the geometry does not need to be re-imported.
Reverts the settings to how they were when you last saved the CFX-Mesh database.
Revert Settings to Saved
Save the current setup as a .cmdb file. The name and location is dictated by the settings
Save File on the Project Page.
By default, the mouse buttons and keyboard presses over the Graphics window have the following functions in
CFX-Mesh. In some cases, holding down the Shift or Ctrl key whilst using the mouse changes its behavior. A de-
scription of the functions themselves can be found in the following table.
6
Section : Toolbars and Icons
You can change which function is assigned to which mouse button by using Common Settings>Graphics In-
teractions in the Workbench Options. These can be accessed using Tools>Options.
You can also use the Section : Triad at the bottom right corner of the Graphics window to quickly put the model
into a specified viewing position.
The left mouse button is used both for selection and for model manipulation. Its behaviour is determined by
Selection is described in Selection Filters, and the rotation modes are described below.
Rotate Mode
By default, dragging the mouse with its middle button held down rotates the model in Rotate Mode, which is
described in the table below. In addition, the left mouse button can operate in Rotate Mode when the appropriate
rotation mode is selected from the Rotation Modes Toolbar.
When in Rotate Mode, the type of cursor which is shown determines which type of rotation occurs.
Free rotation.
The type of cursor which is shown (and hence the type of rotation) depends on the starting location of the
cursor. In general, if the cursor is near the center of the graphics window, the familiar 3D free rotation occurs. If
the cursor is near a corner or edge, a constrained rotation occurs: pitch, yaw or roll.
Specifically, the circular free rotation area fits the window. Narrow strips along the edges support pitch and yaw.
Corner areas support roll. The following figure illustrates these regions.
The crosshairs in the Graphics window indicate the center of rotation. If you are using the left mouse button in
Rotate Mode then you can click over the model with the left mouse button to change the position of the crosshairs
relative to the model. Click outside the model to restore the default center of rotation.
Selection
Many objects in the meshing definition need to be applied to a particular piece of geometry (such as a face) or
to be associated with another item (a Point Control needs to be associated with a particular Spacing Definition,
for example).
Where you are required to select an object in the Section : Tree View, then you can do this as follows:
1. Click in the box in the Section : Details View which requires the selection, to make it active. This step may
not be needed if Auto Activate is set to Yes and there is no valid selection already made.
8
Section : Toolbars and Icons
The process for selecting a geometric object from the Section : Graphics Window is similar.
• Sometimes you may want to select both objects from the Tree View and faces from the Graphics window
- for instance, if you wish to apply Section : Inflation to a set of faces which can be selected most conveni-
ently by selecting a Composite 2D Region and then adding a few faces selected directly from the Graphics
window. In this case, selecting the objects of the two different types acts independently. For instance, if
you have selected a Composite 2D Region, you can simply click on a face in the Graphics window to add
it to the selection, without holding down the Ctrl key. If you click on a face in the Graphics window (without
holding down a key) then that will add that face to the selection and clear any existing selection of faces,
but not affect any selection of Composite 2D Regions. If you want to clear the selection of Composite 2D
Regions as well, you must explicitly deselect them (by holding down Ctrl and clicking on them).
• Usually, if you are required to select geometric objects of a particular type, then your selection will be
automatically restricted to select only objects of the required type. For instance, when choosing faces to
apply a Face Spacing to, only faces will be able to be selected. If the selection is not being restricted
automatically but you want to enforce a restriction, then you can use a Selection Filter.
Selection Filters
When you activate a Selection Filter, your selection is restricted to only items of a particular type.
Point Selection
When you need to select a point from the Graphics window, then in general you can select either a model vertex
(corner of a face), an arbitrary point on any of the model faces, or specify coordinates. How to do either of these
is described below.
Vertex Selection:
1. If the Point entry in the Details View shows the word “None” on a yellow background, or some coordinates
are displayed, then click on None or the coordinate entry, to make the Point entry change to show two
buttons, Apply and Cancel.
2. Move the mouse over the required vertex in the Graphics window until a small red wireframe sphere
appears (see the picture below). Whilst the sphere is visible, click with the left mouse button.
3. Click on Apply in the Details View. The Point entry will now show 1 Vertex.
Point on a Face:
1. If the Point entry in the Details View shows the word “None” on a yellow background, or some coordinates
are displayed, then click on None or the coordinate entry, to make the Point entry change to show two
buttons, Apply and Cancel.
2. Move the mouse over the part of the face in the Graphics window where you want the point to be, and
click with the left mouse button.
3. If there is more than one face under the mouse at the point when you click, then the Selection Rectangles
will appear in the bottom left-hand corner of the Graphics window. If you click on one of these, you can
move the point so that it appears not on the face closest to you, but one of the faces underneath the
mouse which is not at the front. In order to see the location of the point at this stage, you will need to
make the geometry partially transparent.
4. Click on Apply in the Details View. The Point entry will now show the coordinates of the point that you
picked. Note that these coordinates now specify the point, so if the geometry changes (from a geometry
update, it is possible that this point may no longer lie on a face.
Specify Coordinates:
1. If the Point entry in the Details View shows two buttons reading Apply and Cancel, click on Cancel to
make the Point entry show the word “None” or show some coordinates.
2. Right-click on None or the coordinate entry and choose Edit.
3. Edit the coordinates as required. The only allowed formats are three numbers (X, Y, Z) separated by either
spaces or commas (you may not use a comma to separate two numbers and only use a space to separate
10
Section : Toolbars and Icons
the third). You must not enter the units string (such as “[mm]”); CFX-Mesh will add that in for itself using
the model dimensions. Press Return on the keyboard to finish editing the coordinates.
or
There are two selection modes. To switch between them, you use the Selection Mode Toolbar, which is located
along with the rest of the toolbars at the top of the window.
•
Flood Select - In this mode, you can select multiple geometric objects simply by pressing and
holding down the left mouse button and then moving the mouse over them. Any object which the mouse
touches is added to the selection.
•
Box Select - In this mode, you can select geometric objects from the Graphics window by clicking
with the left mouse button and then dragging it across other objects. All the objects that the box fully
encloses are selected. If you hold down the Ctrl key while you draw the box, then these items will be added
to the current selection.
Note that with both selection methods, hidden faces or hidden bodies cannot be selected. The faces or bodies
must be made visible in the model view in order that they can be selected.
Display Toolbar
Triad
The Triad in the bottom right corner of the Graphics window shows the orientation of the model. It can also be
used to position the model in one of several pre-defined viewing positions:
• Click on one of the arrows along the axes to put the model into a view normal to that arrow.
• Click on the cyan ball to put the model into an isometric view.
Moving the mouse over the Triad identifies the axis (X, Y, Z) and direction (+/-) of the arrow, using tool tips.
Positive-direction arrows are labeled and color-coded. Negative direction arrows display only when you hover
the mouse cursor over the appropriate region, but can still be clicked on to put the model in a view normal to
the arrow.
To control whether the Triad is visible or not, use the Section : Display Toolbar.
Ruler
You can use the ruler, shown at the bottom of the Graphics window, to obtain a good estimate of the scale of
the displayed geometry.
To control whether the Ruler is visible or not, use the Section : Display Toolbar.
Geometry Toolbar
The Geometry Toolbar gives you access to the actions which can be performed on the geometry.
This allows you to re-import the geometry after it has been changed, keeping as many
Update Geometry of the mesh settings applied as possible. See Section : Geometry Update for more details.
Geometry Checking is described in Section : Geometry Checking.
Geometry Check
Meshing Toolbar
The Meshing Toolbar gives you access to the meshing actions which can be performed on the model.
This allows you to generate or regenerate the surface mesh. You must use a Section :
Generate Surface Mesh Preview Group to view the mesh in CFX-Mesh.
This allows you to generate or regenerate the volume mesh and write a CFX-Pre Mesh
Generate Volume Mesh File. See Section : Creating the Volume Mesh for more details.
Interrupt
Sometimes you may want to interrupt a lengthy meshing operation before it finishes, perhaps because you
realise that you have made a mistake, or that the resulting mesh is going to take too long to generate or be too
big. In this case, you can use the Interrupt (or “Halt current processing”) button. This is located in the CFX-Mesh
toolbar near the top of the ANSYS Workbench window.
Clicking on the Interrupt button will interrupt any meshing operation in progress (including the Verify Geometry
functionality). After a short delay, CFX-Mesh will return an error showing that the meshing operation has failed,
and an Error will appear in the Tree View which shows that the meshing has terminated because the user has
interrupted it. The user interface is then unlocked for use again.
12
Section : Toolbars and Icons
A limitation of the Interrupt functionality is that it only takes effect when the underlying meshing process ex-
changes data with the user interface. Usually this data exchange occurs very frequently; for example, data exchange
takes place every time the progress bar is incremented. In a small number of circumstances, however, the under-
lying meshing processes may go for a relatively long period of time without exchanging data with the user interface
(for example, if such a large mesh is being generated that there is no significant progress to report, or in certain
unusual cases when the mesher fails). In this case, Interrupt will appear to have no effect. If you do need to in-
terrupt the meshing process under such circumstances, then use the Task Manager (Windows) or the kill command
(UNIX) to end the following processes:
File Menu
The File Menu contains the following items.
File > Clear Settings Clears all the user-defined settings from the CFX-Mesh database
(reinitialize the database). This is equivalent to starting a new CFX-
Mesh database with the same geometry, but is quicker since the
geometry does not need to be re-imported.
File > Revert Settings to Saved Reverts the settings to how they were when you last saved the CFX-
Mesh database.
File > Save Saves the current setup. The filename and location are shown on the
Project Page.
File > Save As... Saves a copy of the current setup as a different file. The Project Page
is updated to show the new name and location of the files.
File > Export CCL... Exports the current mesh settings as a CCL file.
File > Close CFX-Mesh Closes CFX-Mesh leaving ANSYS Workbench open.
File > Exit Workbench Exits from ANSYS Workbench. You will be prompted to save any open
files.
Tools Menu
The Tools Menu contains the following items.
Tools > Rotate These functions are identical to those on the Rotation Modes Toolbar.
Tools > Pick Vertex These functions are identical to those on the Selection Filters Toolbar.
Tools > Options This function allows you to set up various preferences both for CFX-
Mesh and ANSYS Workbench. See CFX-Mesh Options for more details.
View Menu
The View Menu contains the following items.
View > Shaded Display with 3D These functions toggle the geometry display between a view with
Edges shaded faces and a view with just the wireframe outline. This setting
View > Wireframe Display is not stored in the CFX-Mesh database but is a properly of the ANSYS
Workbench session i.e. if you open a different CFX-Mesh database
within the same ANSYS Workbench session, then the setting persists.
To change the default setting (i.e. the setting for when ANSYS Work-
bench is opened), use Tools > Options... and change the View setting
under Graphics View.
Tools > Show Triad These functions are identical to those on the Display Toolbar.
Restore Original Window Layout This function allows you to restore the original layout of the Details
View, Tree View and Graphics window.
Go Menu
The Go Menu contains the following items.
Go > Update Geometry These functions are identical to those on the Geometry Toolbar.
Go > Generate All Surface Meshes These functions are identical to those on the Meshing Toolbar.
After importing the geometry, it is possible to modify it and update the geometry in CFX-Mesh at a later time.
This is described in Section : Geometry Update.
Whether the geometry originates from an external import or is created from scratch in DesignModeler, it must
satisfy certain requirements in order that it can be used successfully in meshing. Additionally, you should bear
in mind how you want to use the geometry in the CFX-5 software as you create it, because if you want to model
Solid domains (e.g. for heat transfer), fluid subdomains (e.g. to specify a resistance source) or Thin Surfaces, you
will need to create the geometry using multiple Solid Bodies. You will also need to make sure that each region
you need for a boundary condition in CFX-5 is available as a separate face or faces.
CFX-Mesh includes a geometry-checking utility which can be run to check for the presence of certain features
in faces and edges which can cause meshing difficulties.
If the geometry consists of multiple Bodies and/or Parts, then it is possible to choose to mesh the different Bodies
and Parts separately or together, or not at all. This is described in Section : Suppression of Bodies and Parts .
CFX-Mesh also allows you to control the display of geometry in order to see the model more clearly and to facil-
itate selection of faces in multiple body geometries.
1. Save the external CAD file. Then import it into DesignModeler by using the File>Import External Geo-
metry File menu item. Then select the .agdb file on the Project Page and then choose the option Gen-
erate CFX Mesh to open CFX-Mesh with that geometry. You will need an appropriate license for
DesignModeler to use this route.
2. Save the external CAD file and close the CAD package. Then browse to find the geometry file from the
Project Page, highlight its name and select Generate CFX Mesh. This method uses the CAD interfaces
in reader mode. You need a license for the CAD interface appropriate for your CAD package to use this
route.
3. Open the CAD model in the external CAD package. Then open ANSYS Workbench, either by using the
ANSYS 10.0 in the CAD package, or by opening it manually. On the Project Page, you will see your part
name listed under the Link to Active CAD Geometry group. If it is not listed, you will need to click Refresh.
Once your part is listed there, click this part and then set the preferences under the Default Geometry
Options group and the Advanced Geometry Defaults group. Afterwards, choose the option Generate
CFX Mesh to import the geometry into CFX-Mesh. This method uses the CAD interface in plug-in mode.
You need a license for the CAD interface appropriate for your CAD package to use this route.
If you are going to use the direct CAD interfaces, then it is probably more convenient in general to use plug-in
mode rather than reader mode, since this will allow for more convenient geometry updates when you modify
the geometry. However, not all CAD interfaces support the plug-in mode. A list of those which do can be found
in CAD Systems.
Whether or not you import the CAD via DesignModeler or not will be dictated by which licenses you have available.
If you have both types of license, then you can consider either method.
One advantage of importing external CAD into DesignModeler rather than directly into CFX-Mesh is that you
can combine Bodies into one Part in DesignModeler. Simply select all of the Bodies and then use Tools> Form
New Part in DesignModeler. Where surfaces from different Bodies are coincident, then they will be converted
into shared surfaces and CFX-Mesh will then be able to produce a matching mesh on these surfaces, and place
the mesh for the Bodies on each side into one assembly. This, in turn, means that CFX-Pre will not need to use
GGI connections between the two Bodies.
Another advantage of importing external CAD into DesignModeler is that you have more choice of the units you
want to work in. For many of the external CAD files, you will be unable to change the units if they are imported
into CFX-Mesh directly.
If you import CAD into DesignModeler then DesignModeler does some checking and clean-up to ensure that
the geometry is clean enough for use with solid modeling. This means that in some rare cases, you may get a
better mesh if the geometry has been imported via DesignModeler. On the other hand, some CAD geometries
will fail to import into DesignModeler as they do not satisfy its more stringent requirements, but can be imported
into CFX-Mesh directly and meshed with no difficulty.
One advantage of importing the CAD directly into CFX-Mesh is that geometry updates will be more convenient
than if you import via DesignModeler.
ACIS
The ACIS reader supports .sat files which include single or multiple bodies. You must specify the length units of
the geometry when CFX-Mesh initialises. We recommend verifying dimensions before meshing; this can be done
by matching a known length in the geometry against the Section : Ruler.
Autodesk Inventor
The Autodesk Inventor interface supports files containing parts or assemblies, using the extensions .ipt or .iam.
CFX-Mesh will always use a length unit of centimeters for imported Autodesk Inventor geometries.
CATIA V4
The import of this file format into CFX-Mesh is not supported as the mesher is unable to mesh the resulting
geometry.
CATIA V5
The CATIA V5 reader supports CATIA V5 parts (*.CATPart) and assemblies (*.CATProduct). CATIA V5 surface
bodies consisting of closed surfaces are transferred as solid bodies. You must specify the length units of the
geometry when CFX-Mesh initialises. We recommend verifying dimensions before meshing; this can be done
by matching a known length in the geometry against the Section : Ruler.
IGES
The IGES reader supports IGES files containing parts or assemblies, using the extensions .igs or .iges. Closed
surfaces and hollow solids from an IGES file are transferred as full solids. CFX-Mesh will always use a length unit
of meters for imported IGES geometries.
Parasolid
The Parasolid reader supports Parasolid files containing parts or assemblies, using the extensions .x_t or .xmt_txt.
CFX-Mesh will always use a length unit of meters for imported Parasolid geometries.
Pro/ENGINEER
The Pro/ENGINEER interface supports Pro/Engineer part (.prt) or assembly (.asm) files. CFX-Mesh uses the units
which are stored in the Pro/Engineer file.
Solid Edge
The Solid Edge interface supports Solid Edge part, assembly, sheet metal, and weldment documents. CFX-Mesh
will always use a length unit of meters for imported Solid Edge geometries.
SolidWorks
The SolidWorks interface supports SolidWorks part and assembly documents. CFX-Mesh will always use a length
unit of meters for imported SolidWorks geometries.
STEP
The STEP reader supports STEP files containing parts or assemblies, using the extensions .stp or .step. CFX-Mesh
will always use a length unit of millimeters for imported STEP geometries.
Unigraphics
The Unigraphics interface supports Unigraphics files containing parts or assemblies. CFX-Mesh uses the units
which are stored in the Unigraphics file.
Geometry Update
After you have imported a geometry into CFX-Mesh you may find at some stage that you need to modify it. For
instance, perhaps you made a mistake in the original construction, or you want to update a dimension or remove
a small feature that you do not want to resolve in your CFX-5 simulation. CFX-Mesh has the capability to update
your geometry whilst retaining most or all of the settings (depending on the complexity of the changes made
to the geometry, the CAD format and the method of import).
If your geometry was imported into CFX-Mesh from DesignModeler or from an external CAD package using plug-
in mode, then you only need to open the original CAD file in the CAD package (DesignModeler in the case of
.agdb files) and make the appropriate modifications to the geometry. You can then return to CFX-Mesh and
access Geometry Update by right-clicking on Geometry in the Tree View and selecting Update Geometry. Al-
ternatively, it is available from the Geometry Toolbar ( ). You will be warned before the update takes
place, and asked to confirm it.
If your geometry was imported into CFX-Mesh from an external CAD package using reader mode, then you must
modify the geometry and save the new geometry into the appropriate file. You can then return to CFX -Mesh
and access Geometry Update by right-clicking on Geometry in the Tree View and selecting Update Geometry.
Alternatively, it is available from the Geometry Toolbar ( ). You will be warned before the update takes
place, and asked to confirm it.
On import of the new geometry, CFX-Mesh checks to see whether the CAD entities (faces, edges, vertices, etc.)
that were present in the original geometry still exist in the new geometry. It then updates the features in the
Tree View as follows.
• If the geometric location for a CFX-Mesh feature (e.g. a list of faces for a Face Spacing) consists entirely of
geometric entities which no longer exist, then CFX-Mesh marks that feature as invalid by using the invalid
status symbol . In order to make the model valid again, you must either delete that feature or modify
it to specify an appropriate location for the feature.
• If the geometric location for a CFX-Mesh feature (e.g. a list of faces for a Face Spacing) consists of both
geometric entities which no longer exist and entities which do still exist, then the non-existent entities
are removed from the location list. For example, if a Face Spacing is applied to three faces, and after the
update one of these faces no longer exists, then the Face Spacing will be automatically modified so that
after the geometry update, it is applied to just the two remaining faces. Where features are automatically
updated in this way, CFX-Mesh marks them as such by using the status symbol . Where you see this
symbol after a geometry update, you are advised to check that the feature is applied to where you expect
it to be. If you want to change this symbol back to the normal symbol, simply click on the feature
name in the Tree View then click next to Location in the Details View and just press Apply without
modifying anything.
• New faces are automatically added to the Default 2D Region, Default Face Spacing and Default Preview
Group.
After a geometry update, you should always check that your settings are still applied to their required location.
In order to keep applying existing meshing features to the correct locations, CFX-Mesh needs to be able to
identify a geometric location such as a face as being the same in the old geometry and the new geometry. How
well it is able to do that depends on both the CAD format and the method of import.
If your geometry was creating in DesignModeler, then you should find that most geometry updates work with
the minimum required modification to your meshing model. The one exception to this is that if you combine
bodies to form a single part using the Form New Part functionality, or use the Explode Part functionality to
reverse this change. In this case, the underlying faces do not maintain their identity during the geometry update
and you may need to re-apply the locations of all the mesh settings.
If you have used a direct CAD interface in plug-in mode, then once again you can expect that many geometry
updates will work with the minimum required modification to your meshing model. However, if you are using
a CAD interface in reader mode, then it is more difficult to maintain the identities of the geometric locations
during import, and you may find that you have to re-apply the locations of all the mesh settings.
When you create a new CFX-Mesh database, it is associated with a particular geometry file on the Project Page.
CFX-Mesh will always update the geometry from the geometry file which is listed on the Project Page, even if
this is a different file location to the original location. If the Project Page does not have a valid file location for
this geometry then you will not be able to perform a geometry update until you have updated the Project Page
to show a valid file location.
If you have a CFX-Mesh database which is not associated with a geometry file through the Project Page (e.g. if
you chose to open the CFX-Mesh database directly when you first started ANSYS Workbench, rather than
opening the project which contains it) then CFX-Mesh will use the geometry with the same filename as the ori-
ginal for a geometry update. The filename is stored with a full path so you must have not renamed the file or its
directory for this to work. If the original file is not available then you will not be able to perform a geometry update.
Geometry Requirements
Geometry requirements and how to create certain desired topologies are described in the following sections.
General Geometry Requirements
Multiple Bodies, Parts and Assemblies
Geometry and Topology for Solid Bodies
Geometry and Topology for the Faces of Solid Bodies
Geometry and Topology for the Faces of an Inflated Boundary
Geometry for Thin Surfaces
Poorly-Parameterized Surfaces
Degenerate Geometry
• It does not matter whether or not the Solid Bodies are Frozen in DesignModeler; they will still appear in
CFX-Mesh and can be meshed regardless of this state. If you want to exclude a Solid Body from meshing,
you must suppress it in CFX-Mesh or suppress or delete it in DesignModeler.
6
Section : Geometry Requirements
3D representation 2D representation
If you just create the two Bodies shown, then they do not meet at a common face: the circle at the end of the
cylinder is not one of the faces of the cube. The picture below shows this situation.
3D representation 2D representation
In order to make a common face between the two, the cube needs to have the square face that touches the
cylinder split into two: one face is the circle at the end of the cylinder, and the other face is the remaining square
with a circular cut. This is shown in the picture below. Green and black are used to color the faces of the cube.
3D representation 2D representation
3D representation 2D representation
8
Section : Geometry Requirements
a conducting solid in your CFX-5 simulation. A single mesh will be produced throughout the two Bodies
(providing that they are in the same part) but the mesh on either Body will be available separately for selection
in CFX-5.
3D representation 2D representation
This method only works if the outside Body is a cube, sphere or cylinder, since these are the only Bodies that the
Enclosure operation can create directly. If the two Bodies were not just simple shapes, then to create a geometry
with this topology, you could do the following:
In this example, setting Merge Parts? to Yes has the effect of combining the two Bodies into one part without
having to do this explicitly.
The following configuration, in which the outer Body has no hole, is NOT correct:
3D representation 2D representation
3D representation 2D representation
1. create the middle cube (which forms the outside faces of the red Body),
2. use the Enclosure operation to create the outside cube with the middle cube cut out of it, without re-
moving the inner cube,
3. use an Extrude operation to create the inner cube (which forms the hole), setting Operation to Cut
Material, and
4. select both Bodies and combine them into one Part using Tools>Form New Part.
Once again, this method only works if the outside Body is a cube, sphere or cylinder, since these are the only
Bodies that the Enclosure operation can create. If the two Bodies were not just simple shapes, then to create a
geometry with this topology, you could do the following:
1. create the middle cube (which forms the outside faces of the red Body),
2. Freeze it,
3. create the outer Body,
4. use the Enclosure operation with Shape set to User Defined, User Defined Body set to the outer Body,
Target Bodies set to All Bodies, and Merge Parts? to Yes.
5. Unfreeze the middle cube and choose to Freeze Others? (to make the middle cube the active Body),
6. use an Extrude operation to create the inner cube (which forms the hole), setting Operation to Cut
Material.
In this example, setting Merge Parts? to Yes has the effect of combining the two Bodies into one part without
having to do this explicitly.
10
Section : Geometry Requirements
3D representation 2D representation
Since the cylinder is not entirely enclosed by the outside Body, you cannot use the Enclosure operation to make
a geometry with this topology. In order to construct this geometry in DesignModeler, you could
In this example, setting Merge Parts? to Yes has the effect of combining the two Bodies into one part without
having to do this explicitly.
The following configuration, in which the cube has no hole, is NOT correct:
3D representation 2D representation
Non-Manifold Geometry
The CFX-Mesh surface meshers are unable to mesh certain face topologies. An example of one such such topology
is shown below, and is an example of a non-manifold face topology. In the example below, four faces are associated
with one edge: two with the outer body, and two with the inner body.
The way to work around this particular problem is to split the outer body as shown in the picture below.
Problems can also arise if there is no non-manifold edge present but there is a face which has a non-manifold
vertex, as shown below.
12
Section : Geometry Requirements
Closed Faces
A closed face has two distinct edges which occupy the same location in space. The most common example of a
closed face is a cylindrical face. Both of the two cylinders shown below have a closed face - the curved part of
the cylinder is made up of just one face.
Closed faces are not a problem for the default surface mesher, the Section : Delaunay Surface Mesher. However,
they cannot be meshed with the Section : Advancing Front (AF) Surface Mesher. If you want to use the Advancing
Front Surface Mesher, then you will have to split the cylindrical face into two parts:
In DesignModeler this can be done as follows, assuming that the cylindrical face was created by Extruding, Re-
volving or Sweeping a circle.
1. Select the sketch containing the circle, and then use Split from the Modify Toolbox of the Sketching tab
to divide the circle into two or more distinct edges.
2. On the Details View for the Extrude/Revolve/Sweep that created the face, set Merge Topology? to No.
Then click on Generate to regenerate the cylindrical face.
The second step is required to stop DesignModeler from optimizing the topology of the created face(s), which
would have resulted in this case in DesignModeler still creating a single face, even though the circle being ex-
truded/revolved/swept was formed of two edges.
Merging Topology
CFX-Mesh will create a surface mesh on each individual face. This means that in the case where (for example)
very narrow faces are present, a mesh length scale must be chosen which is sufficiently small relative to the width
of the narrow dimension to allow a reasonable mesh to be created on the narrow faces, even though the physics
of your CFD simulation is such that there is no need to have a fine mesh in this area.
In some cases, this may not be avoidable. However, if you are using DesignModeler to generate your geometry,
then you may be able to avoid this situation by setting Merge Topology to Yes when creating the Solid Bodies
in DesignModeler. In summary, this setting allows DesignModeler to optimize the faces created and in some
cases this will result in faces that would otherwise be separate being merged into one face. More details can be
found in the DesignModeler Help under Section : Merge Topology.
CFX-Mesh also allows you to merge two or more faces into one Virtual Face. The surface meshing operation will
then mesh across the Virtual Face rather than the smaller constituent faces, thus removing the requirement for
the mesh length scale to resolve the width of any of these constituent faces. Virtual Faces and their limitations
are discussed in Virtual Topology.
If you try to perform Inflation with such a topology, you will not get a uniform thickness of inflation near where
the triangular Face A touches the inflation face. Instead, the number of layers of inflation at the point where Face
A meets the inflation face will be reduced to zero; as one moves away from this point, the number of layers will
increase by 1 in successive elements, until it reaches the number of layers that you requested.
1. Redefine the non-inflated faces to be inflated ones. In this case the inflation will cause elements to be
produced normal to these faces, and the problem does not arise.
14
Section : Geometry Requirements
2. You can edit the non-inflated faces by merging them, and so removing one of the internal edges. One
way to merge the faces is to make use of the Merge Topology feature in DesignModeler; another way is
to use the Virtual Topology feature in CFX-Mesh.
The CFX-5 Solver treats each side of the Thin Surface uniquely and computes the flow variables for both sides
separately.
The Thin Surface must be the face of a Solid Body, so to set up a Thin Surface in CFX-Mesh, you must have more
than one Solid Body present in the model, and this must be a consideration when constructing the geometry.
You can also set up a Composite 2D Region which actually forms the Thin Surface boundary condition for the
CFD simulation, if you choose.
Thin Surface Topology Restrictions
The following examples demonstrate the use of multiple Solid Bodies to create Thin Surfaces. There is usually
more than one way in which the Solid Bodies can be defined to create the same Thin Surface.
Example 1: Free Floating Thin Surface
Example 2: Attached Thin Surface
Solid Body
16
Section : Geometry Requirements
In each case, the Solid Bodies have been created in order to put the Thin Surface at the edge of a Solid Body.
They must also satisfy the rules for creating multiple Solid Bodies:
In each case, the Solid Bodies are contained within the same part. More details on allowed configurations of
Solid Bodies can be found in Section : Geometry and Topology for Solid Bodies.
In each case, the Solid Bodies have been created in order to put the Thin Surface at the edge of a Solid Body.
They must also satisfy the rules for creating multiple Solid Bodies:
In each case, the Solid Bodies are contained within the same part. More details on allowed configurations of
Solid Bodies can be found in Section : Geometry and Topology for Solid Bodies.
In addition, for case (1) above, the intersection between the two Solid Bodies must consist of two faces, one for
the Thin Surface and one for the part not in the Thin Surface. To break the face which forms the intersection, you
can use Imprint Faces in DesignModeler - see the DesignModeler Help for more details. In order to construct
this geometry (1) in DesignModeler, you could
Poorly-Parameterized Surfaces
Some external CAD packages may allow some control over the type of surfaces which can be created. This section
gives some guidelines which can be applied when using these CAD packages, in order to produce high-quality
surfaces which are the most suitable for meshing. It is intended for advanced users only. You will need to refer
to your CAD package's documentation to find out what control over surfaces it allows.
A four-sided surface is often a parametric surface, that is, it can be thought of as topologically equivalent to a
flat square which has been distorted, as shown below. The position of a point upon the surface can then be de-
scribed by the values of two parameters, ξ1 and ξ2, which usually take values in the range 0 to 1.
A poorly-parameterized surface is one where the shape of the surface is distorted so much that this parametric
description of the surface becomes difficult to work with. For example, near the “corners” of the surface, a small
change in actual position on the surface can lead to a very large change in the values of ξ1 and ξ2, or vice versa.
The parameterization of a surface can affect the quality of the mesh produced on it. For a non-trimmed parametric
surface, the surface mesh is created on a unit square in parametric space. This mesh is then mapped back to
corresponding physical locations on the actual surface. The uniformity of the mapping between parametric and
physical space is an important factor in retaining the quality of the triangulation in physical space.
Parametric lines are the lines in physical space which map to even straight lines parallel to the edges of the square
in parametric space. By visualizing the parametric lines on a surface, you can gain a qualitative representation
of the parameterization of a surface; consult your CAD package documentation to see if this is possible within
it. As a guide, the more uniform the distribution of these lines, the better the parameterization of the surface.
Parametric lines should also not meet at very small or very large angles. You can clearly see that the parametric
lines on the circular parametric surface meet at angles very far away from 90 degrees, when 10 equally-spaced
parametric lines are used in the diagram below.
18
Section : Geometry Requirements
To improve the parameterization of the surface, it may be necessary to regenerate the surfac e in the original
CAD package. To identify and fix poorly-parameterized surfaces, you need to understand how a surface is rep-
resented and how a mesh is created on the surface. One of the simplest examples is a unit cube. The six planar
surfaces which share common edges form a solid enclosing a volume of 1 unit cubed. Let us assume that the
edges of the cube are aligned with the three principle axes (X, Y, Z). The surface meshing algorithms implemented
in CFX-Mesh are, in effect, two-dimensional meshing algorithms, creating a group of connected planar triangles
for each individual planar surface of the cube. Each surface mesh is then mapped to the physical coordinates of
the geometry. For a unit cube it is relatively simple to see how this mapping takes place. The two-dimensional
coordinates map to each side of the cube, so ξ1 and ξ2 directly replace the x or y or z physical coordinates, as
shown in the table and diagram below.
The range of ξ1and ξ2 is [0,1] (for a parametric surface) and in the case of a unit cube the coordinates (x, y, z) also
have a range [0,1], so the mappings between ξ1, ξ2 and x, y, z are one-to-one. This is obviously not the case for
all surfaces and geometries, simply stretching the unit cube in the x-direction by scaling the geometry using the
vector (3,1,1) immediately changes the mapping between ξ1, ξ2 and the x-coordinate. This implies that there is
a direct relationship between the parametric and physical coordinates for a surface and that we need to consider
the linearity of the mapping between the two coordinate systems. This is particularly true in the case of parametric
surfaces where we mesh a unit square in parametric space which is mapped to the related geometrical surface.
The following examples demonstrate particular problems:
Example 1: Distorting the Square
Example 2: Circle
Example 3: Uneven Parametric Lines
Example 4: Degenerate Surfaces
Example 5: Cusps
In case (i) it is easy to see that any triangle created in parametric space will be mapped to a triangle in physical
space which possesses the same internal angles.
(ii)
In case (ii), the internal angles of a mapped triangle can be seen to be different, but not by a significant amount.
(iii)
In case (iii) there is a significant variation in the internal angles and in the case where a triangle is created at the
origin of (ξ1, ξ2) the mapping to physical space does not create a valid triangle. The parametric lines provide you
with guidance with respect to the amount of distortion relating to the parameterization.
Example 2: Circle
The second example is that of a circular parametric surface created from four curves. Near the “corners” of the
surface (where ξ1 and ξ2 are zero, for example), a small change in actual position on the surface can lead to a
very large change in the values of ξ1 and ξ2. The parametric lines are displayed to show the surface more clearly.
20
Section : Geometry Requirements
A workaround to this problem is to re-create the surface as some sort of planar surface which is trimmed by the
circle boundary. In some CAD packages you may be able to do this by creating the circle from five edges rather
than four.
Some CAD packages may allow such a surface to be refitted to have a more even distribution of the parametric
lines. Otherwise the surface will have to be regenerated using a different method or using a collection of more
evenly spaced curves.
A degenerate surface occurs when one or more sides of the parametric quadrilateral surface used for meshing
collapse to a singularity.
Degenerate surfaces should be recreated ensuring that the singularity is avoided. More information is given in
Section : Degenerate Geometry.
Example 5: Cusps
Another example of a poorly-parameterized surface is shown below. The problem is the sharp point on the surface
(the sharper the point, the more likely it is to cause a problem).
This time, a large change in position may correspond to only a small change in ξ1 and ξ2.
One way to avoid this problem in some CAD packages is to break one of the curves into two pieces, so that that
surface has five sides and can no longer be a parametric surface, as shown below.
Degenerate Geometry
Degenerate entities are those whose length, area or volume degenerate to zero because of the coincidence of
one or more points or vertices.
Although CFX-Mesh can handle some forms of degenerate geometry, you may find that if you try to mesh de-
generate geometry, you may get an error message when the surface or volume meshing operations encounter
the degenerate geometry entity, and the meshing operation will terminate. Whether the mesher terminates at
the surface meshing or volume meshing stage depends on the type of degeneracy it has encountered.
The most common problems with degenerate geometry occur as a result of importing parametric surfaces and
parametric solids which comprise degenerate edges or faces. A parametric surface is a four-sided surface which
is represented as topologically equivalent to a flat square which has been distorted (see Section : Poorly-Para-
meterized Surfaces). A parametric solid is a six-faced solid which is represented as topologically equivalent to a
cube which has been distorted.
Surface Meshing
Surface meshing problems usually occur as a result of the surface mesher trying to mesh a surface of zero area.
This can occur if your imported parametric solid or B-rep solid contains a solid face which has degenerated to
an edge. Meshing problems will occur if:
• during creation of a B-rep solid your original surface list contained a zero area degenerate surface; or
• a zero area degenerate face is present in a parametric solid. This can occur if you used a degenerate entity
to create the solid (e.g. creating a solid prism by extruding with a three-sided triangular parametric surface)
or you explicitly defined a parametric solid with a degenerate face (e.g. by defining two pairs of vertices
at the same location).
22
Section : Geometry Checking
In both cases, depending upon the CAD package used to create the geometry, the solution could involve the
following steps.
Volume Meshing
Volume meshing problems with degenerate geometry tend to occur when Section : Inflation is used on faces
which are connected to a degenerate edge of a non-inflated face. If Inflation cannot proceed along a non-inflated
adjacent face edge the mesher will fail trying to create inflated elements. The general solution is to follow the
guidelines for Inflation described in Section : Geometry and Topology for the Faces of an Inflated Boundary.
Geometry Checking
The geometry checking facility in CFX-Mesh checks for the presence of certain undesirable features in faces and
edges, which can cause the mesher to generate a low quality mesh or to fail to generate a mesh at all.
You can access it by right-clicking on Geometry in the Tree View and selecting Verify Geometry. Alternatively,
The results of all of the checks are given in warning messages which can be viewed under the Errors section of
the Tree View. The last warning issued gives a summary of the checks:
Other warnings are issued about particular faces or edges which fail each check. Clicking on any of the warnings
which refer to faces will highlight the face it concerns. If it is difficult to see the highlighted face, you could hide
the display of the geometry before clicking on the error. The part of the model causing the error will still highlight,
which should make it much easier to see. Hiding the geometry (or part of the geometry) can be done by right -
clicking on the name of the Body or Part under Geometry in the Tree View.
Note that a failed check may not necessarily result in a poor mesh, particularly if default tolerances are used.
However, it may be worth checking the mesh on any faces which fail the checks, to ensure that a high-quality
mesh has been achieved.
Also note that these checks will not pick up all problems which can be associated with the geometry; they only
check for a few specific problems. General geometry requirements are described in Section : Geometry Require-
ments.
To set the limits and tolerances used to judge when an edge or face has failed the checks, you can use the Section :
Verify Options under Geometry in the Tree View.
The default tolerance given depends upon the size of the geometry. As a general rule of thumb, you should start
by adjusting this so that it is a bit less than the finest mesh length scale that you want to use, so that you can see
regions where short edges will affect the mesh.
Sliver Edge Checking is one of the checks performed when using the Section : Geometry Checking feature. You
can change the tolerance used for the check by using Section : Verify Options; valid values for the Short Edge
Limit are anything above zero.
The table below shows some examples of sliver factors that would be computed.
When the Sliver Face Check is run, faces with a sliver factor greater than the limit set will be identified as potential
sliver surfaces. The default value of 25 is usually sensible. Each face identified will be highlighted when the indi-
vidual warning message is selected.
Sliver Face Checking is one of the checks performed when using the Section : Geometry Checking feature. You
can change the limit used for the check by using Section : Verify Options. The Sliver Factor Limit must be greater
than 1.0.
Faces identified that possess an unacceptable sliver factor may be removed by merging them with neighbouring
faces. More details of this process can be found in Section : Virtual Faces.
More details on what is meant by face parameterization is given in Section : Poorly-Parameterized Surfaces.
Parameterization Face Checking is one of the checks performed when using the Section : Geometry Checking
feature.
Verify Options
The Verify Options item (under Geometry in the Tree View) allows you to set the tolerances and limits for the
Section : Geometry Checking feature.
• Short Edge Limit - This limit is used with Section : Sliver Edge Checking. When the check is performed,
all edges which are shorter than this limit will generate warnings.
• Sliver Factor Limit - This limit is used with Section : Sliver Face Checking. When the check is performed,
all faces which have sliver factors greater than the limit will generate warnings.
Sometimes, particularly with imported geometries, there may be some short edges which are part of the
boundary of a face, where the length of the edges is much less than the required mesh spacing in that region
of the geometry. Since the mesher will place a minimum of three points on every edge which makes up a face,
the presence of these short edges will result in some elements that are of the same size as these short edges,
rather than a mesh using the required spacing. This results in an uneven mesh with many more mesh elements
than would have been desired.
To get round this problem, CFX-Mesh allows you to remove short edges. To set this up, use the Fix Options item
under Geometry in the Tree View. The default is NOT to remove any edges.
If you set Remove Short Edges to Yes, then you will be asked for an Edge Length (which must be shorter than
the Maximum Spacing set for the Default Body Spacing). All edges shorter than this length will be ignored by
the mesher (although they will still show up in the geometry display) and the two ends will collapse to a point.
You must make sure that the Edge Length specified is shorter than the mesh length scale at any point where
edges may be removed, and you must also make sure that removing the edges does not cause any face to collapse
(to give a face with zero area).
The pictures below show the effect of short edge removal. The face shown is a square with sides of 1 m. However,
the bottom of it is made up from two edges: one is only 2 cm long and the other is 98 cm long. The mesh is
shown first without short edge removal, meshed with a length scale of approximately 0.1 m. The short edge has
caused a patch of fine mesh which was not required. The magnified inset clearly shows the mesh resolving the
short edge.
The second picture shows the mesh after short edge removal. The edge tolerance was set to 0.08 m. The mesh
is much smoother since it does not need to resolve the short edge.
Removing short edges in this way does not give you control over individual edges; you can only specify a length
and then remove all edges shorter than this length. CFX-Mesh allows you to remove individual short edges in
certain circumstances by merging them with adjacent edges to form a Virtual Edge. This is described in Section :
Virtual Edges, and a comparison between the Short Edge Removal described in this section and Virtual Edges is
given in Section : Virtual Edges and Short Edge Removal.
By default, all Parts and Bodies imported into CFX-Mesh are listed in the Tree View, displayed in the Graphics
window and will appear in the surface and volume meshes. This behavior can be changed by using the Suppress
functionality.
In order to suppress a Body or Part, right-click over the relevant entry under Geometry in the Tree View, and select
Suppress. For example, to suppress Body 1, right-click on the entry for Body 1. To unsuppress a Body or Part
which has previously been suppressed, right-click on its name and select Unsuppress. Note that suppressing a
Part is equivalent to suppressing all of the Bodies within the Part.
• The Body or Part will be listed in the Tree View as being suppressed, using the following status symbol:
or instead of or
• The Body will no longer be displayed in the Graphics window. This can make it easier to manipulate and
select from geometrical objects in the Graphics window when you have complex geometries. (Note that
you can also use the Hide functionality to achieve this effect.)
• The faces, edges and vertices of the Body are no longer available for selection. This means, for example,
that if you have multiple Bodies and want to select all of the faces in one Body for a 2D Composite Region,
then you can suppress all the other Bodies, use Box Select to select all visible faces, then unsuppress the
other Bodies. (Note that you can also use the Hide functionality to achieve this effect.)
• The Body will not appear in any mesh that you generate. Features that are applied to a suppressed Body
only will be ignored: for example, a Face Spacing which is applied to only a single face on a suppressed
Body will be ignored as if it was suppressed itself. A features which is applied to both suppressed and
unsuppressed Bodies will be applied to just the unsuppressed Bodies: for example, a Face Spacing which
is applied to faces across several bodies will just be applied to those faces on unsuppressed Bodies. A
Periodic Pair which has only faces from a suppressed Body in one of the two location lists will be ignored,
even if the other location list contains faces from an unsuppressed Body.
Note that if you mesh multiple Bodies together, then in general you will get a different mesh than if you mesh
each one separately (by suppressing all the Bodies and then unsuppressing them one at a time). This is because
certain meshing features affect the mesh on nearby Bodies. An example of this would occur if you have a Face
Spacing on Body 1 which is close enough to affect Body 2. If you mesh the two Bodies together, then Body 2 is
affected by the Face Spacing. If you mesh Body 2 without meshing Body 1, then the Face Spacing is not applied
and so the mesh on Body 2 is different. Features which can result in the mesh being different if Bodies are meshed
separately include Face Spacings, the existence of shared faces between a suppressed Body and an unsuppressed
Body, Periodic Pairs which are across multiple Bodies, and Surface Proximity.
The model must always be valid regardless of the state of the suppression of the Bodies. For example, you are
not allowed to create a Section : Periodic Pair on any shared faces. Even if you suppress one of the Bodies which
makes up half of that shared face so that it appears that the other half of the shared face is not shared any more,
you are still not allowed to create a Periodic Pair on that face, because that would be invalid if the Body was then
unsuppressed.
Note that suppressing a Body is different from hiding a Body. If you hide a Body, it is no longer available for se-
lection and no longer displayed in the Graphics window; however, it will still be including in any meshing oper-
ation.
Control over how the Bodies are displayed is described in Section : Geometry Display.
Geometry Display
The display of geometry is controlled using the Geometry section of the Tree View. To change the appearance
of the geometry, left-click on Geometry in the Tree View and modify the controls in the Details View.
• Transparency (%) - Choose the transparency of the Bodies. 100% means that the geometry is completely
transparent (i.e. it won't show up) and 0% means that the geometry is completely opaque.
• Shine (%) - Shine controls how much light is reflected by the faces of the Bodies. 0% gives the lowest
amount of reflection and will result in the geometry looking matt in texture. 100% gives the most amount
of reflection and will make the geometry very bright.
It is also possible to control which parts and bodies are displayed; this is described in Section : Suppression of
Bodies and Parts .
In order to remove this limitation, CFX-Mesh allows you to combine faces and edges into Virtual Faces and
Virtual Edges. Once faces and edges have been combined in this way, then only the Virtual Faces and Virtual
Edges are seen by the meshers, and you do not need to resolve their constituent narrow faces or short edges.
Virtual Faces and Virtual Edges collectively are referred to as Virtual Topology.
• A Virtual Face or Virtual Edge may be created and then added to, or alternatively it may be included in a
new Virtual Face or Virtual Edge. If an existing Virtual Face or Edge is added to a new Virtual Face or Edge
and this is successfully created, the original Virtual Face(s) or Edge(s) will be removed from the Tree View.
• Once Virtual Topology is created, then as far as the rest of CFX-Mesh is concerned, the underlying merged
faces or edges no longer exist; the Virtual Faces and Virtual Edges are seen instead. This means that if you
perform, for example, a Section : Geometry Checking, then short edges which have been merged into
Virtual Edges will no longer show up as being short edges. Faces which have been merged into a Virtual
Face will no longer be available for selection; you will only be able to select the Virtual Face. Virtual entities
can be used wherever the ordinary geometric entities of the same type can be used.
• If, for example, you have two faces in Face Spacing 1, and you then create a Virtual Face from these two
faces, then CFX-Mesh treats this as if the two faces had disappeared from the geometry and one new one
(the Virtual Face) had appeared. This means that the new Virtual Face will be added to the Default Face
Spacing (not Face Spacing 1) and the existing Face Spacing, which no longer contains any valid geometry,
will be marked as invalid. In general, on creation of a Virtual entity, CFX-Mesh checks to see whether the
CAD entities (faces, edges, vertices, etc.) that were present prior to the creation of entity still exist. It then
updates the features in the Tree View as follows.
– If the geometric location for a CFX-Mesh feature (e.g. a list of faces for a Face Spacing) consists entirely
of geometric entities which no longer exist, then CFX-Mesh marks that feature as invalid by using the
invalid status symbol . In order to make the model valid again, you must either delete that feature
or modify it to specify an appropriate location for the feature (perhaps the new Virtual Face).
– If the geometric location for a CFX-Mesh feature (e.g. a list of faces for a Face Spacing) consists of both
geometric entities which no longer exist and entities which do still exist, then the non-existent entities
are removed from the location list. For example, if a Face Spacing is applied to three faces, and after
the creation of the Virtual Face one of these faces no longer exists, then the Face Spacing will be
automatically modified so that after the creation of the Virtual Face, it is applied to just the two remain-
ing faces. Where features are automatically updated in this way, CFX-Mesh marks them as such by
using the status symbol . Where you see this symbol after creating Virtual Topology, you are advised
to check that the feature is applied to where you expect it to be. If you want to change this symbol
back to the normal symbol, simply click on the feature name in the Tree View then click next to
Location in the Details View and just press Apply without modifying anything.
– New Virtual Faces are automatically added to the Default 2D Region, Default Face Spacing and Default
Preview Group.
After the creation of Virtual Topology, you should always check that your existing mesh settings are still
applied to their required location.
• If you perform a Geometry Update after creating Virtual Topology, then the Virtual Topology will continue
to be applied in its existing locations provided that all of these locations exist. If any of the locations no
longer exist, then the Virtual entity will be marked as invalid and you will have to remove it in order to
make the model valid again. You can, of course, then add another Virtual entity to take its place.
• Virtual Topology is removed along with all other settings if you choose to Clear Settings.
Virtual Faces
Virtual Faces are created by merging together two or more faces from the geometry to make one larger surface.
The reason why you might want to do this is to avoid having to mesh individual faces. Normally, a surface mesh
is created for every face of each body which is being meshed. In order to produce a reasonable quality mesh (or
in some cases, any mesh at all) on a face which is very narrow, you may need to use a very small mesh length
scale (and hence a large mesh) for regions where the physics of the CFD model do not require this. If you can
merge such narrow faces with other faces, then you can drastically increase the mesh length scale in this region,
which will result in a mesh with fewer elements. Additionally, you may be able to merge faces together in such
a way that very small angles on the original surfaces are eliminated, which also leads to a higher quality mesh.
Create a Virtual Face from the three faces along the front left
of the cube, to merge the narrow face with its immediate
neighbors.
Now when the mesh is created, the coarse mesh length scale
is used to mesh right across the narrow face, which is no
longer resolved, as required. The creation of a Virtual Face
will, where possible, automatically merge its external edges
to form Virtual Edges. If this is not desired, automatic merging
of edges bounding a new virtual surface can be turned off
on the Virtual Topology section of the Options panel. The
figure to the left shows the behaviour if automatic edge
merging is turned on (the default).
To create a Virtual Face, right-click on Virtual Topology in the Tree View, and select Insert > Virtual Face. You
can then select the faces required from the Graphics window (you cannot select faces by selecting a Composite
2D Region). All faces must be adjacent so that the Virtual Face is a single continuous entity. Virtual Faces are NOT
restricted to groups of surfaces where the angle between the average combined surface normal and any normal
on the combined faces exceeds 90 degrees. However, Virtual Faces cannot form a closed region, for example,
all six sides of the cube shown above cannot be combined into a Virtual Face, but if any one of the sides of the
cube is not included, then the new Virtual Face is not a closed region and creation is allowed.
Note that if you merge faces which do not meet at a tangent, then the sharp angle where they meet will be
rounded off over a distance of approximately 1 local element size.
Some general notes on Virtual Topology (which apply to Virtual Faces) are given in Section : General Information
on Virtual Topology.
Virtual Edges
Virtual Edges are created by merging together two or more edges from the geometry to make one larger edge.
The reason why you might want to do this is to avoid having to mesh an individual edge. Normally, when the
surface mesh is created for a face, at least three nodes are placed on every edge. This will result in a very fine
mesh near short edges, in regions where the physics of the CFD model do not necessarily require this. If you can
merge these short edges with other edges, then you can drastically increase the mesh length scale in this region
and make a mesh containing fewer elements.
The following simple example shows the use of Virtual Edges. Virtual Edges can be used to eliminate edges in-
dependent of the presence of Virtual Faces.
Now when the mesh is created, the coarse mesh length scale
is used to mesh right across the whole geometry, with no
need for small elements near where the short edge used to
be.
To create a Virtual Edge, right-click on Virtual Topology in the Tree View, and select Insert > Virtual Edge. You
can then select the edges required from the Graphics window. All edges must be adjacent so that the Virtual
Edge is a single continuous entity. You can only merge edges which form part of the boundary of the same two
faces.
Some general notes on Virtual Topology (which apply to Virtual Faces) are given in Section : General Information
on Virtual Topology. See Section : Virtual Edges and Short Edge Removal for a discussion of how Virtual Edges
are different from Short Edge Removal.
8
Section : Virtual Edges
Short Edge Removal removes all edges shorter than a certain length (which you specify) in the geometry. When
the mesher sees a short edge which is to be removed, the behavior is as if the edge was collapsed to zero length:
a single node is placed at one end of the edge and no other nodes are put on the edge at all. As a result, you can
only merge short edges which are shorter than the local mesh length scale, or your resulting mesh will be badly
distorted. There is no individual control over which edges should be regarded as short; all edges below the
specified length scale will be removed.
The creation of a Virtual Edge is effectively a merger of two or more edges, creating a single, longer edge. The
mesher will place nodes along the Virtual Edge with no regard for where the original edges were. There is no
requirement that the merged edges are smaller than the mesh length scale. However, you can only merge edges
which are shared between the same two faces of the geometry. You have individual control over which edges
are merged and must create each Virtual Edge separately.
Short Edge Removal and Virtual Edges can be used in the same mesh setup. Where the setup contains both,
Virtual Edges take precedence i.e. Virtual Edges are created first, and then Short Edge Removal removes any re-
maining edges of a length shorter than the given length scale.
In general, where it is possible, it is recommended that you remove short edges by using Virtual Edges rather
than Short Edge Removal. This approach results in greater consistency with other features of CFX-Mesh.
Example Geometry Mesh with short edge Mesh without short edge
1
In this example, the short edge to be eliminated can be removed by using Short Edge Removal, providing that
the mesh length scale is large enough and there are no shorter edges elsewhere in the geometry that you need
to keep. In this example the mesh length scale is only a few times longer than the length of the short edge and
so there is a very slight distortion in the mesh where the node from one end of the edge has been collapsed onto
the node at the other end of the edge. The short edge cannot be removed using Virtual Edges because there is
no edge shared between the same two faces that it can be merged with.
In this example there is a whole series of short edges to be removed. Short Edge Removal cannot be used because
the entire length of the series of edges would be collapsed and the distortion would be too large. However, the
series of short edges can be merged into one Virtual Edge.
3
In this example, either Short Edge Removal could be used or the short edge could be merged with its neighbor
to its right to make Virtual Edge. The decision on which method to use would depend on whether you had other
short edges you wanted to remove and whether you needed the individual control that you get by using Virtual
Edges. The resulting mesh produced by the two methods is slightly different. The top mesh, produced by Short
Edge Removal, is very slightly distorted since the mesh length scale is not much greater than the length of the
short edge. The bottom mesh is produced by the Virtual Edge method.
10
Regions
The geometry which defines your simulation is a collection of one or more Solid Bodies and the faces which
bound them. CFX-Mesh has several features which require you to select some part of the geometry in order to
provide a location for the feature.
CFX-Mesh also allows you to give names to parts of the geometry. These Composite Regions can then be used
for specifying locations in CFX-Mesh. They will also label collections of nodes or elements in the mesh output
from CFX-Mesh, for use in the CFX-Pre. Currently, only Composite 2D Regions can be created in CFX-Mesh.
You do not need to define any Composite Regions in CFX-Mesh, since you can always select the parts of the
geometry directly in CFX-Mesh. Mesh associated with particular Solid Bodies and faces is accessible in CFX-Pre
even without creating a Composite Region. However, it is often much easier or clearer to select parts of the
geometry for a Composite Region and then to use it by name later during the mesh setup than it is to select the
geometry directly each time it is to be used. It is also easier to select and name parts of the geometry (for use in
the CFD simulation) within CFX-Mesh than it is to select the appropriate mesh regions within CFX-Pre.
The Regions part of the Tree View contains details of all of the Composite Regions which have been defined in
the model.
2D Regions
Named Selections
2D Regions
When you are asked to select a 2D Location for your meshing feature, in most cases you will be able to select 2D
Regions directly from the geometry or from a list of Composite 2D Regions which you have previously defined.
If your geometry has more than one solid body meeting at a shared face, then you need to understand the dif-
ference between a 2D Region and a face.
Available Composite 2D Regions are shown under Regions in the Tree View.
If your model has only one solid, then each face is also a 2D Region, and vice versa. If your model has more than
one solid, then all of the external faces will also be 2D Regions. However, two 2D Regions will exist for every
shared (internal) face (assuming that you have combined the solids into the same part). Each meshing feature
that requires you to specify a location has its own rules about whether or not you can set different properties
for the two 2D Regions which make up a shared face.
• Composite 2D Region: You may include any combination of 2D Regions in a Composite 2D Region (including
just one or both sides of a shared face). However, if you are going to use a Composite Region to specify
the location for any other meshing feature, then you must make sure that it only includes 2D Regions
which satisfy the requirements of the appropriate feature.
• Section : Face Spacing: It is important that you do not try to apply different Face Spacings to 2D Regions
which are the two sides of a common face, since the surface mesh is generated on the common face, not
on the 2D Regions separately. It is acceptable to include a 2D Region which forms one half of a shared
face in a Face Spacing without including the other side of the shared face, but only if the 2D Region which
forms the other side is not included in any other Face Spacing (other than the Default Face Spacing).
• Section : Inflated Boundary: When creating an Inflated Boundary, you can have different settings for the
two different 2D Regions which make up a common face i.e. you can apply Inflation to one 2D Region
and not the other, or to both but with different settings. The example below shows the difference in one
particular case.
• Section : Preview Group: A Preview Group can contain any combination of 2D Regions. It does not matter
if 2D Regions are contained in more than one Preview Group, nor if a 2D Region is included which forms
one half of a shared face, but the other half is not included.
If you try to pick a 2D Region which is half of a shared face, then the Selection Rectangles will appear. Each shared
face will be represented by two rectangles which are attached to each other, one for each side or 2D Region, as
shown below. You can use these rectangles to select individual 2D Regions easily and accurately.
CFX-Mesh will not allow you to select locations for meshing features which break the rules given for each feature.
In places where you are required to select a 2D Region to specify a location for a meshing feature, CFX-Mesh re-
cognizes two types of 2D Region: Primitive and Composite. The primitive regions are those which exist in the
geometry by default: there is one for every external face and two for each shared face (see Section : 2D Regions
and Faces for more details). You can select these 2D Regions directly from the geometry in the Graphics window.
The composite regions are those which you create explicitly, and consist of one or more primitive 2D Regions
which you select and give a name to.
You can create a Composite 2D Region from any single primitive 2D Region or group of primitive 2D Regions.
No primitive 2D Region can be assigned to more than one Composite 2D Region. A Default 2D Region is created
by CFX-Mesh and cannot be renamed or deleted; this always contains any primitive 2D Regions that have not
been used in other Composite 2D Regions, and its contents change dynamically as you create and modify other
Composite 2D Regions. In this way, every primitive 2D Region is always assigned to exactly one Composite 2D
Region. You must always leave at least one primitive 2D Region in the Default 2D Region.
To create a Composite 2D Region, right-click over Regions in the Tree View, and select Insert>Composite 2D
Region. You can then select the required primitive 2D Regions from the Graphics window. A Composite 2D Region
can be deleted or renamed by right-clicking over its name in the Tree View.
You can use the Composite 2D Regions to specify locations for meshing features in CFX-Mesh, rather than having
to select the faces individually. Simply click on the name of the Composite 2D Region from the Section : Tree
View to select it, instead of clicking on the faces in the Graphics window.
Any Composite 2D Regions that you create in CFX-Mesh appear in CFX-Pre and can be used as locations for
boundary conditions and domain interfaces. The 2D Regions and their names are written to the Section : CFX-
Pre Mesh File with the mesh. Even if you do not specify any Composite 2D Regions in CFX-Mesh, mesh on the
primitive 2D Regions will still be available for selection to define boundary conditions in CFX-Pre. However, the
following advantages apply if you create at least some Composite 2D Regions in CFX-Mesh:
• It may be easier to select the primitive 2D Regions you require in CFX-Mesh than in CFX-Pre.
• If the faces you need are not available to be selected, then you will find this out before meshing the geo-
metry, rather than creating the mesh and then discovering that the face you need is not available in CFX-
Pre. This might happen, for example, if two faces that you expected to be separate actually form a single
face, due to the way that you created the geometry.
You may also want to create additional Composite 2D Regions if, for example, you want to create plots on indi-
vidual or groups of faces during post-processing.
Named Selections
Named Selections created in DesignModeler can be imported into CFX-Mesh as Composite 2D Regions.
This functionality has to be enabled before it can be used, and then it only applies to new CFX-Mesh databases.
Existing databases (from both this release and previous releases) cannot be updated to use Named Selections
if it is not enabled when they are created.
You can choose to enable this functionality for all databases or on a database-by-database basis. To enable it for
all new databases, do the following:
1. Open the Options dialog box, either from Tools>Options or from the Start page which appears when
you first open ANSYS Workbench.
2. Under Common Settings > Geometry Import, set Named Selection Processing to Yes.
3. To import all Named Selections regardless of their name, remove all characters from the Named Selection
Prefix setting. If you want to restrict the import of Named Selection according to their names, then enter
the Named Selection prefix key into the Named Selection Prefix box. All Named Selections whose name
starts with this prefix will then be imported.
4. Named Selections will then be imported into CFX-Mesh every time you start a new CFX-Mesh database
from a DesignModeler database which contains Named Selections.
If you only want to enable this functionality for selected databases, then do the following:
In CFX-Mesh there are restrictions on the use of Composite 2D Regions, in that no primitive 2D Region can be
assigned to more than one Composite 2D Region. This restriction does not apply to Named Selections when
created in DesignModeler and therefore, when geometry containing Named Selections is imported into CFX-
Mesh, the Named Selections will be ignored if they do not comply with the rules governing CFX-Mesh Composite
2D Regions. The warning message will reference the Named Selections that are causing the problem. If this occurs,
then you will need to return to DesignModeler and remove the Named Selection(s) that overlap. In CFX-Mesh,
you can then perform an Update Geometry or open the geometry in a new CFX-Mesh session.
Spacing
You can specify the background mesh length scale for a body or bodies by using a Section : Body Spacing.
You can also specify the mesh length scale for particular faces or edges using a Section : Face Spacing or Section :
Edge Spacing. A Face or Edge Spacing can also influence the mesh in the nearby volume.
Other controls over the mesh length scale at any given point are described in Section : Controls, Section : Stretch
and Section : Proximity.
Body Spacing
The Body Spacing for a body gives the background length scale for its volume i.e. the length scale before any
Section : Face Spacing, Section : Controls or other explicit length scale controls are applied. It should be set to
the coarsest length scale required anywhere in the body, since no elements can be created that are larger than
the Body Spacing in that body.
One Body Spacing exists by default: “Default Body Spacing”. This applies to all bodies. Only one parameter can
be controlled for the Default Body Spacing:
• Maximum Spacing - This is the maximum element size which will be used when creating triangles on
the faces of the body and tetrahedra in the volume of the body. The default is set to around 5% of the
maximum extent of the model. CFX-Mesh will accept any length (greater than zero) for this size.
Face Spacing
A Face Spacing is used to specify the mesh length scale on a face (or faces) and in the volume adjacent to the
selected faces.
One Face Spacing exists by default: “Default Face Spacing”. This applies to all faces which have not been explicitly
selected for inclusion in other Face Spacings. Each additional Face Spacing is applied to a face or faces which
you must select.
To create a new Face Spacing, right-click on Spacing in the Tree View. After creation, Face Spacings (except the
Default Face Spacing) can be deleted, suppressed (made inactive) or renamed by right-clicking on their names
in the Tree View.
• Minimum Edge Length - Enter the Minimum Edge Length for the surface mesh on the faces. This only
applies when Angular Resolution or Relative Error has been selected as the Face Spacing Type.
• Maximum Edge Length - Enter the Maximum Edge Length for the surface mesh on the faces. This only
applies when Angular Resolution or Relative Error has been selected as the Face Spacing Type. It must be
given a value between the Minimum Edge Length and the Maximum Spacing set under Default Body
Spacing.
• Radius of Influence - Specify the extent of the Face Spacing influence. If, for example, you specify a Radius
of Influence of 2 cm then the region of space within 2 cm of the Face Spacing is filled with mesh with the
same length scale as on the face itself. Beyond the Radius of Influence, the size of the elements expands
as you move away from the faces, in accordance with the Expansion Factor. This parameter does not apply
when the Face Spacing Type is set to Volume Spacing.
• Expansion Factor - Specify how fast the mesh length scale returns to its background value away from a
region where it has been constrained by a Face Spacing. Each successive element as you move away from
the face (outside the Radius of Influence specified above) is approximately one Expansion Factor larger
than the previous one. Hence large values tend to coarsen the mesh rapidly away from the face. This
parameter also governs how fast a local surface length scale that has been overridden near a curve (because
of its curvature) expands back to its global value. It therefore controls both the rate of growth of volume
elements away from faces and the rate of growth of surface elements away from curved boundaries into
the middle of a flat face. It does not apply when the Face Spacing Type is set to Volume Spacing. Expansion
Factors should be between 1.0 and 1.5.
• Location - Select the face(s) of the model from the Graphics window to use for the Face Spacing. You can
either select faces directly from the Graphics window or select Composite 2D Regions (or the Default 2D
Region) from the Tree View. The Default Face Spacing does not allow you to make this selection, since it
automatically applies to all faces which have not been explicitly selected for inclusion in other Face Spacings.
A face cannot be in more than one Face Spacing. If you have multiple Solid Bodies in your geometry, then
you should read the information on the difference between faces and 2D Regions to understand how you
can apply Face Spacings to the faces which form the boundaries between the bodies.
The figure below shows a Face Spacing on a 1 m cube, with a Constant Edge Length of 0.05 m, Radius of Influence
0.2 m, and Expansion Factor 1.2.
Any Face Spacing other than the Default Face Spacing will have a volumetric effect, except when set to use the
Volume Spacing. The Radius of Influence determines the volume that the Face Spacing is applied to away from
the face. This will affect both the volume mesh and the surface mesh on faces within the Radius of Influence.
The Radius of Influence can be set to zero, in this case the Face Spacing is applied only to the selected faces. A
volumetric effect will still be seen as the edge length scale is expanded back into the volume mesh, but the ex-
pansion will begin as soon as you move away from the face.
When Face Spacings are used (other than the Default Face Spacing using the Volume Spacing option), then
nearby faces may also be affected. For example, if you create a Face Spacing with a Radius of Influence of 2 cm,
then another face which is 2 cm away will also be affected. In order to achieve this, the surface mesher will run
twice; once to generate an initial mesh and detect faces which are within the region of influence of a Face Spacing,
and then a second time after reducing the local background mesh length scale based on the proximity of faces.
Edge Spacing
An Edge Spacing is used to specify the mesh length scale on an edge (or edges) and in the volume adjacent to
the selected edges.
To create a new Edge Spacing, right-click on Spacing in the Tree View. After creation, Edge Spacings can be de-
leted, suppressed (made inactive) or renamed by right-clicking on their names in the Tree View.
– Constant - Set a Constant Edge Length for the edges, overriding the Section : Body Spacing. You
cannot set this length scale to be larger than the Maximum Spacing specified in the Default Body
Spacing.
– Volume Spacing - Use the same spacing on the face as the Maximum Spacing specified for the Body
on the faces selected.
• Minimum Edge Length - Enter the Minimum Edge Length for the surface mesh on the edges. This only
applies when Angular Resolution or Relative Error has been selected as the Edge Spacing Type.
• Maximum Edge Length - Enter the Maximum Edge Length for the surface mesh on the edges. This only
applies when Angular Resolution or Relative Error has been selected as the Edge Spacing Type. It must
be given a value between the Minimum Edge Length and the Maximum Spacing set under Default Body
Spacing.
• Radius of Influence - Specify the extent of the Edge Spacing influence. If, for example, you specify a Ra-
dius of Influence of 2 cm then the region of space within 2 cm of the Edge Spacing is filled with mesh with
the same length scale as on the edge itself. Beyond the Radius of Influence, the size of the elements expands
as you move away from the edges, in accordance with the Expansion Factor. This parameter does not
apply when the Edge Spacing Type is set to Volume Spacing.
• Expansion Factor - Specify how fast the mesh length scale returns to its background value away from a
region where it has been constrained by an Edge Spacing. Each successive element as you move away
from the edge (outside the Radius of Influence specified above) is approximately one Expansion Factor
larger than the previous one. Hence large values tend to coarsen the mesh rapidly away from the edge.
It does not apply when the Edge Spacing Type is set to Volume Spacing. Expansion Factors should be
between 1.0 and 1.5.
• Location - Select the edge(s) of the model from the Graphics window to use for the Edge Spacing. You
can select edges directly from the Graphics window.
The figure below shows an Edge Spacing on a 1 m cube, with a Constant Edge Length of 0.05 m, Radius of Influence
0.2 m, and Expansion Factor 1.2.
Any Edge Spacing will have a volumetric effect, except when set to use the Volume Spacing. The Radius of Influence
determines the volume that the Edge Spacing is applied to away from the edge. This will affect both the volume
mesh and the surface mesh on faces within the Radius of Influence.
The Radius of Influence can be set to zero, in this case the Edge Spacing is applied only to the selected edges. A
volumetric effect will still be seen as the edge length scale is expanded back into the volume mesh, but the ex-
pansion will begin as soon as you move away from the edge.
When Edge Spacings are used, then nearby edges and faces may also be affected. For example, if you create an
Edge Spacing with a Radius of Influence of 2 cm, then another edge or face which is 2 cm away will also be affected.
There are certain circumstances where an Edge Spacing may not have the effect which you intend i.e.:
• one or both faces which are adjacent to the edge with the Edge Spacing have a Face Spacing defined
with the Angular Resolution or Relative Error option, and
• the Edge Spacing refines the spacing on the edge to less than the Minimum Edge Length set for the one
or both of the Face Spacings on the adjacent faces.
In this case the nodes are placed on the edge in accordance with the Edge Spacing. However, when nodes are
then placed on the adjacent face(s) with the Minimum Edge Length which is greater than the local edge spacing,
the mesh length scale immediately transitions to the Minimum Edge Length specified by the Face Spacing (rather
than expanding away using the Expansion Factor specified by the Edge Spacing). This can result in significant
distortion of the mesh. Under some circumstances, the mesher is able to detect when this would occur, and if it
does so, it will coarsen the spacing on the edge back to the Minimum Edge Length of the face with the largest
Minimum Edge Length. This can make it appear as if the Edge Spacing is being ignored. If the mesher is unable
to detect in advance when a distorted mesh would obtained, then it will warn you about the poor angles in the
resulting surface mesh as necessary. The type of distortion obtained in such a case is shown in the second figure
below. In either case, the way to avoid the situation occurring is to set the Minimum Edge Length of the Face
Spacing(s) of the two adjoining faces to be less than or equal to the smallest edge length arising from the Edge
Spacing.
In the first figure, the two faces shown have a Face Spacing which is defined to give a Constant edge length of
2 mm. The edge in the center has an Edge Spacing which gives a Constant edge length of 0.15 mm. You can
see that the mesh spacing transitions smoothly from 0.15 mm on the edge to the 2 mm on the face, and the
surface mesh is of a high quality.
The second figure shows an example where the Edge Spacing does not have the desired effect. The two faces
shown have a Face Spacing defined using the Angular Resolution option, with a Minimum Edge Length of 1.9
mm and a Maximum Edge Length of 2.0 mm. The edge in the center has an Edge Spacing which gives a Constant
edge length of 0.15 mm. The resulting mesh is distorted and of a poor quality. The way to avoid this is to set the
Minimum Edge Length of the Face Spacing to less than or equal to the smallest edge spacing arising from the
Edge Spacing.
Angular Resolution
The Angular Resolution option for Section : Face Spacing and Section : Edge Spacing allows the edge length on
particular faces or edges to vary depending upon the local curvature. That is, a short edge length is used where
the face or edge is highly curved, and a longer edge length is used where it is flatter. It is used for automatically
refining the mesh in geometries that have curved faces or edges and can replace the need for other Section :
Controls in such geometries. It has a similar effect to using the Section : Relative Error setting, but is specified
differently.
In order to control how much the curvature is resolved, you must set the Angular Resolution parameter. This
represents the maximum angle allowed to be subtended by the arc between two adjacent surface mesh nodes.
When the angle is made smaller, more nodes will be placed on the edge or surface to resolve the curvature
better. CFX-Mesh will allow you to set this parameter to anything between 1.0 degree and 90.0 degrees.
When this option is used, you can set a Minimum and Maximum Edge Length in the Details View for the Face
Spacing, to prevent over-refinement in regions of high curvature and over-coarsening on flat faces.
Relative Error
The Relative Error option for Section : Face Spacing and Section : Edge Spacing allows the edge length on partic-
ular faces or edges to vary depending upon the local curvature. That is, a short edge length is used where the
face or edge is highly curved, and a longer edge length is used where it is flatter. It is used for automatically re-
fining the mesh in geometries that have curved faces or edges and can replace the need for other Section :
Controls in such geometries. It has a similar effect to using the Section : Angular Resolution setting, but is specified
differently.
In order to control how much the curvature is resolved, you must set the Relative Error. The Relative Error is the
maximum deviation of the resulting mesh away from the geometry face or edge expressed as
where r is the local radius of curvature. The value entered should be in the range of approximately 0.00004 to
0.292, which corresponds to 360 edges and 4 edges per circumference, respectively. When the Relative Error is
made smaller, more nodes will be placed on the edge or face to resolve the curvature better.
Controls
Mesh Controls are used to refine the surface and volume mesh in specific regions of your model. The mesh refining
effect decays with increasing distance from the control, generating progressively coarser elements. Controls can
be defined using any point on the model (e.g. corners of faces) or by specifying coordinates. They can be located
anywhere in the 3D space of your model: inside, outside or on the edge.
Three types of volumetric Controls are available: Point, Line and Triangle. In addition, a volumetric effect may
be obtained by using a Section : Face Spacing.
Point Spacing
Point Control
Line Control
Triangle Control
You can suppress (make inactive) all of the Controls in the model by right-clicking on Controls in the Tree View.
Point Spacing
Each of the three volumetric controls (Point, Line, and Triangle) require you to specify spacing attributes for the
Control at appropriate points. A Point Spacing is a set of values which can be used for this purpose. There are
three required values:
• Length Scale - a length scale for the mesh size in the locality of the point to which the Point Spacing is
applied. This must be less than the Maximum Spacing set under Default Body Spacing.
• Radius of Influence - the radial extent of the fixed local length scale influence. If, for example, you specify
a Radius of Influence of 2 cm then the region of space within 2 cm of the Control is filled with mesh with
the length scale given by the Length Scale specified above.
• Expansion Factor - the mesh coarsening rate is determined by a geometric expansion factor. Each suc-
cessive element as you move away from the Control (outside the radius specified above) is approximately
one Expansion Factor larger than the previous one. Hence large values tend to coarsen the mesh rapidly
from the Control. Expansion Factors should be set to between 1.0 and 1.5.
A new Point Spacing can be created by right-clicking on Controls in the Tree View and selecting Insert>Point
Spacing. After creation, a Point Spacing can be renamed, deleted or duplicated by right-clicking on its name in
the Tree View. Note that Delete is only available if the Point Spacing is not in use by a Point, Line or Triangle
Control. Also note that if you duplicate a Point Spacing, its values are copied into the new Point Spacing, but
there is no further link between them i.e. if you change the original Point Spacing, then the duplicate will not be
updated in any way.
Point Control
• Point - You can select a point for the Control by selecting a vertex from the model, selecting an arbitrary
point on the model faces or by specifying its coordinates. See Section : Point Selection for details.
• Spacing - Select a Section : Point Spacing which defines the mesh attributes for the Point Control (Length
Scale, Radius of Influence and Expansion Factor). To make the selection, click in the box next to Spacing,
click on the name of the required Point Spacing in the Tree View, and then click on Apply back in the
Details View.
The figure below shows a Point Control on a 1 m cube, with Length Scale 0.05 m, Radius of Influence 0.2 m, and
Expansion Factor 1.2.
8
Section : Controls
A new Point Control can be created by right-clicking on Controls in the Tree View and selecting Insert>Point
Control. After creation, a Point Control can be renamed, suppressed (made inactive), deleted or duplicated by
right-clicking on its name in the Tree View. Note that if you duplicate a Point Control, its settings are copied into
the new Point Control, but there is no further link between them i.e. if you change the original Point Control,
then the duplicate will not be updated in any way. If you want to suppress all the Controls in the model, right -
click over Controls and select Suppress.
Once a Point Control is created and is valid, then if you click on its name in the Tree View, the Point Spacing that
it refers to will be highlighted, and a small graphic similar to the one shown below will appear at the location of
the Point Control.
In this graphic, the small sphere at the center shows you where the point itself is located. The middle sphere
(green in the picture) shows you the mesh Length Scale at that point, and the largest sphere (blue) shows you
the Radius of Influence. If the Radius of Influence is zero, then this sphere will not show up separately.
Line Control
A Line Control controls the mesh spacing in a region defined by a cylindrical volume between two spheres.
You must specify a Point location and a Section : Point Spacing for each of two points to define a Line Control.
The line for the control is the straight line between the two end-points, not the model edge which joins the two
points (if any).
Each of the two points which form the line can have different Point Spacings, which means different settings of
Length Scale, Radius of Influence, and Expansion Factor. Where the settings for any parameter are different, the
two values are blended linearly as you move along the line.
• Point 1 / Point 2 - You can select points for the Control by selecting a vertices from the model, selecting
arbitrary points on the model faces or by specifying coordinates. See Section : Point Selection for details.
• Spacing Definitions - If you want to specify the same Section : Point Spacing for both points, set Spacing
Definitions to Uniform. If you want to specify a different Section : Point Spacing for each point, set Spacing
Definitions to Individual.
• Spacing / Spacing 1 / Spacing 2 - Select a Section : Point Spacing which defines the mesh attributes. If
you selected to set one Point Spacing for both points, then the selection you make for Spacing will apply
to both points; if you selected to set a different Point Spacing for each point, then you must separately
select a Spacing 1 and Spacing 2 to apply to Point 1 and Point 2 respectively. To make the selection, click
in the box next to Spacing / Spacing 1 / Spacing 2, click on the name of the required Point Spacing in
the Tree View, and then click on Apply back in the Details View.
The figure below shows a Line Control on a 1 m cube, with Length Scale 0.05 m, Radius of Influence 0.2 m, and
Expansion Factor 1.2.
A new Line Control can be created by right-clicking on Controls in the Tree View and selecting Insert>Line
Control. After creation, a Line Control can be renamed, suppressed (made inactive), deleted or duplicated by
right-clicking on its name in the Tree View. Note that if you duplicate a Line Control, its settings are copied into
the new Line Control, but there is no further link between them i.e. if you change the original Line Control, then
the duplicate will not be updated in any way. If you want to suppress all the Controls in the model, right -click
over Controls and select Suppress.
Once a Line Control is created and is valid, then if you click on its name in the Tree View, the Point Spacing that
it refers to will be highlighted, and a small graphic similar to the one shown below will appear at the location of
the Line Control.
In this graphic, the red line shows you where the line is located. The inner spheres (green in the picture) shows
you the mesh Length Scale at that point, and the outer spheres (blue) shows you the Radius of Influence. If
the Radius of Influence is zero, then the green spheres will not show up separately.
Triangle Control
10
Section : Controls
A Triangle Control controls the mesh spacing in a region defined by a prismatic volume between three spheres.
You must specify a Point location and a Section : Point Spacing for each of the three points needed to define the
triangle. The triangle is formed from the three lines which join up the points, regardless of where the model faces
are.
Each of the three points which form the triangle can have different Point Spacings, which means different settings
of Length Scale, Radius of Influence, and Expansion Factor by selecting different Spacing Definitions to apply at
each point. Where the settings are different, the three values are linearly blended as you move around the triangle.
• Point 1 / Point 2 / Point 3 - You can select points for the Control by selecting a vertices from the model,
selecting arbitrary points on the model faces or by specifying coordinates. See Section : Point Selection
for details.
• Spacing Definitions - If you want to specify the same Section : Point Spacing for all three points, set
Spacing Definitions to Uniform. If you want to specify a different Section : Point Spacing for each point,
set Spacing Definitions to Individual.
• Spacing / Spacing 1 / Spacing 2 / Spacing 3- Select a Section : Point Spacing which defines the mesh
attributes. If you selected to set one Point Spacing for all three points, then the selection you make for
Spacing will apply to all the points; if you selected to set a different Point Spacing for each point, then
you must separately select a Spacing 1, Spacing 2 and Spacing 3 to apply to Point 1, Point 2 and Point
3 respectively. To make the selection, click in the box next to Spacing / Spacing 1 / Spacing 2 / Spacing
3, click on the name of the required Point Spacing in the Tree View, and then click on Apply back in the
Details View.
The figure below shows a Triangle Control on a 1 m cube, with Length Scale 0.05 m, Radius of Influence 0.2 m,
and Expansion Factor 1.2.
A new Triangle Control can be created by right-clicking on Controls in the Tree View and selecting Insert>Triangle
Control. After creation, a Triangle Control can be renamed, suppressed (made inactive), deleted or duplicated
by right-clicking on its name in the Tree View. Note that if you duplicate a Triangle Control, its settings are copied
into the new Triangle Control, but there is no further link between them i.e. if you change the original Triangle
Control, then the duplicate will not be updated in any way. If you want to suppress all the Controls in the model,
right-click over Controls and select Suppress.
Once a Triangle Control is created and is valid, then if you click on its name in the Tree View, the Point Spacing
that it refers to will be highlighted, and a small graphic similar to the one shown below will appear at the location
of the Triangle Control.
In this graphic, the red triangle shows you where the triangle is located. The inner spheres (green in the picture)
shows you the mesh Length Scale at that point, and the outer spheres (blue) shows you the Radius of Influence.
If the Radius of Influence is zero, then the green spheres will not show up separately.
Periodicity
Some CFD simulations can make effective use of periodic pair boundary conditions, which force the flow leaving
at one face to re-enter at that face's equivalent in the periodic mapping. The CFX-5 Solver is capable of making
more accurate calculations on this type of boundary condition if the mesh on each face in the periodic boundary
is identical to the mesh on the equivalent face in the periodic mapping. The use of Periodicity allows you to
generate identical meshes for faces that will later be specified as part of a periodic boundary condition in the
12
Section : Periodicity
simulation set-up. This is achieved by the specification of Periodic Pairs in CFX-Mesh. When you create a Periodic
Pair, you supply two faces (or lists of faces) and a transformation which maps one face (or li st) onto the other
face (or list). The mesh on these two faces (or lists of faces) is then constrained to be identical.
Periodic Pair
Geometry Requirements for Periodic Pairs
Mesh Generation Process for a Periodic Pair
Extruded Periodic Pair
Periodic Pair
To define a Periodic Pair, right-click on Periodicity in the Tree View and choose Insert>Periodic Pair. The use of
Periodic Pairs is described in Section : Periodicity.
You must specify the following items for the Periodic Pair definition:
• Location 1 - Select a face or a set of faces of the model from the Graphics window. You can either select
faces directly from the Graphics window, or select a Composite 2D Region from the Tree View. In either
case, all the faces selected must be on the external boundary of the model and must not be included in
an Inflated Boundary.
• Location 2 - Select a face or a set of faces of the model from the Graphics window. The faces must be related
to those selected for Location 1 as described in Section : Geometry Requirements for Periodic Pairs. Again,
you can either select faces directly from the Graphics window, or select a Composite 2D Region from the
Tree View.
• Periodic Type - This can either be set to Translation or Rotation. If Translation is selected, then in most
cases no further input is required. If, however, Rotation is selected, then you must specify the axis, by
specifying any two points on it. You can select the points by selecting a vertices from the model, selecting
arbitrary points on the model faces or by specifying coordinates. See Section : Point Selection for details.
• Translation Vector - In certain cases, CFX-Mesh cannot determine automatically what the translation
vector for a translational periodic pair is. In these cases, you will be asked to supply the translation vector
for the Periodic Pair explicitly. You should specify the translation vector which moves the faces in Location
1 to those in Location 2.
• Angle of Rotation - In certain cases, CFX-Mesh cannot determine automatically what the rotation angle
for a rotational periodic pair is. In these cases, you will be asked to supply the rotation angle for the Peri-
odic Pair explicitly. You should specify the angle which rotates the faces in Location 1 to those in Location
2, using the right-hand rule. The vector for the rotation axis is the vector between the specified Point 1
and Point 2. Only angles greater than zero are permitted. If your setup requires the use of an angle less
than zero, then switch Point 1 and Point 2 to reverse the rotation axis. See the picture below.
After creation, a Periodic Pair can be renamed, suppressed (made inactive) or deleted by right-clicking on its
name in the Tree View. If you want to suppress all the Periodic Pairs in the model, right-click over Periodicity
and select Suppress.
When a Periodic Pair has been created, then if you click on its name in the Tree View, the faces it is using will be
highlighted. In addition, if the Periodic Pair is rotational, the axis of rotation will be shown as a highlighted line.
If it is not possible to conform to these rules for your geometry, then you should create standard Composite 2D
Regions for the periodic faces (one for each half of the periodic pair). You will then be able to make a periodic
boundary using these faces when setting up your CFD simulation, but the mesh will not be identical between
the faces, which will reduce the accuracy of the CFX-5 solver on these boundaries.
It is possible for Section : Controls to affect the mesh in unexpected locations when Periodic Pair regions are
used. Controls originally located outside a Solid Body can be copied into the Body through the transformation
and affect the local face and volume mesh length scale.
The process which the mesher uses to generate mesh on periodic faces is as follows:
Inflation
In near-wall regions, boundary layer effects give rise to velocity gradients which are greatest normal to the face.
Computationally-efficient meshes in these regions require that the elements have high aspect ratios. If tetrahedra
are used, then a prohibitively fine surface mesh may be required to avoid generating highly distorted tetrahedral
elements at the face.
CFX-Mesh overcomes this problem by using prisms to create a mesh that is finely resolved normal to the wall,
but coarse parallel to it. The mesher can use the local face element normals to 'inflate' 2D triangular face elements
into 3D prism elements at selected walls or boundaries. You can control the creation of these elements and de-
termine their size and distribution in near-wall regions.
The figures below show the inflated mesh region and the transition between the inflation mesh and the tetra-
hedral mesh.
You can set different inflation parameters for different faces. When two inflated faces meet at a common edge
and use different inflation heights, the heights are smoothed.
To apply inflation to any face in the model, you must define an Section : Inflated Boundary which includes that
face. The Inflation process is controlled by a global set of parameters (located under Inflation in the Tree View),
as well as the parameters set for an individual Inflated Boundary. These are described in:
Inflation can be applied to all ordinary boundaries but not to boundaries specified as a Section : Periodic Pair.
Inflation also can be applied to faces which are internal to the region to be meshed, and you can choose separately
to inflate off either side of the face. How to do this is described in Section : 2D Regions and Faces.
Inflation - Details
The following parameters are available for Section : Inflation and provide global control over all Inflated Bound-
aries. All can be set using the Details View for the Inflation object in the Tree View.
• Number of Inflated Layers - This controls the number of inflation layers. If First Layer Thickness is used
to specify the thickness of the inflation layer, then this is a maximum number of inflation layers. Otherwise,
it will be the actual number of inflation layers, except in places where layers are removed locally for reasons
of improving mesh quality (e.g. where inflation layers would otherwise collide with each other). The
Number of Inflated Layers is restricted to be no more than 50.
• Expansion Factor - The relative thickness of adjacent inflation layers is determined by a geometric expan-
sion factor. Each successive layer, as you move away from the face to which the Inflation is applied, is ap-
proximately one Expansion Factor thicker than the previous one. Expansion Factors must be set to between
1.0 and 1.5.
• Number of Spreading Iterations
• Minimum Internal Angle
• Minimum External Angle
• Inflation Option - This option controls how the inflation height is specified. The two options are:
The process used for creating the layers of prisms when using the First Layer Thickness option (with Extended
Layer Growth set to No) is as follows:
1. Put a single layer of prisms against the faces of the inflated boundary, of a height equal to the First Prism
Height.
2. Check the aspect ratio of the prisms (ratio of height to base length). Where this is unity or the height is
already greater than the base length, stop adding prisms. Where the height is still less than the base
length, add another layer of prisms of height calculated by multiplying the height of the previous layer
by the Expansion Factor.
3. Repeat step 2 until all the prisms have a height approximately equal to the base length, or until the
Number of Inflated Layers setting is reached (this setting is used as a maximum number of inflated
layers).
If you set Extended Layer Growth to Yes, then you can carry on adding prisms even after the aspect ratio has
reached 1. The prisms are added with a height equal to the base length, until the Number of Inflated Layers is
reached. The following two pictures show the difference.
The upper picture shows the situation where Extended Layer Growth is set to No, the default. Although the
Number of Inflated Layers was set to 20, only 14 layers have been created, because unit aspect ratio was
reached. The lower picture shows the situation where Extended Layer Growth is set to Yes. The extra 6 layers
have now been added, all with a height equal to their base length.
The First Prism Height must be less than the Maximum Spacing set under Default Body Spacing.
It is recommended that you examine the mesh wherever possible to allow you to visualize the extent of the in-
flation and the quality of the transition from the prisms to the tetrahedral elements. You can view the inflated
mesh (and so see the extent of the inflation) by using a Section : Preview Group. The Details View for Preview
allows you to specify exactly how you view the inflated mesh. The full volume mesh can be viewed in CFX-Post.
The following two images help to demonstrate the effect of enabling the First Layer Thickness option. The first
image uses default values and the Total Thickness option, and the second uses a specified First Prism Height.
The following two images help to demonstrate the effect of combining Section : Controls with a specified First
Prism Height. The first image uses default values and the Total Thickness option with the Point Control, and the
second uses a specified First Prism Height.
An additional option is Layer by Layer Smoothing, which by default is set to No. This option allows prisms to
grow out normal to the surface, i.e. orthogonal to the surface, the layer normals and heights are then progressively
smoothed, during the creation of each layer, to maximize the number of layers obtained. Layer by Layer
Smoothing can only be employed when the Inflation Option is First Layer Thickness. Note that invoking Layer
by Layer Smoothing will result in longer mesh generation times as the smoothing process is applied on each
prism layer rather than just the once that happens by default.
Total Thickness
You can select this option by selecting Total Thickness as the Inflation Option on the Details View for Inflation.
With this option enabled, the total thickness of the inflation is controlled by the Thickness Multiplier, the local
element edge length and the Maximum Thickness. (The local element edge length is determined by the Section :
Face Spacing and Section : Controls, and the Maximum Thickness is set individually for each Section : Inflated
Boundary.)
This method of inflation creates a less smooth transition from the inflated prism mesh elements to the tetrahedral
mesh elements than the alternative, which is to set the Inflation Option to Section : First Layer Thickness.
However, the number of inflated layers is more constant, and you can have some control over the height of the
inflation layers on a face-by-face basis, given that the Maximum Thickness parameter can be specified separately
for each individual Inflated Boundary.
The process used for creating the layers of prisms when using the Total Thickness option is given below:
2. Use the specified Number of Inflated Layers and Expansion Factor to calculate the height of each layer,
given the total thickness that has just been calculated.
If the element edge length changes in the region of the inflation layer, due to (say) a Control, then the inflation
thickness will not be constant over the inflated face. The figure below shows what happens to the inflation
thickness in the vicinity of a Point Control.
Additionally, sometimes inflation layers may be removed (for example, where the inflation layers from two dif -
ferent faces would otherwise collide) and this will also cause the total thickness of the inflation layer to decrease.
Some comparisons between the effect of choosing the Total Thickness option and choosing the First Layer
Thickness option are shown in Section : First Layer Thickness.
Number of Spreading Iterations - This governs how far the effects of deleted elements propagate. By default
it is set to zero and only the original elements marked for deletion will actually be deleted. However by increasing
this value, neighboring elements are also marked for deletion. The value specifies the number of layers of
neighboring elements that are also deleted. It cannot be set to above 10.
For adjacent inflation boundaries where the relative gap between inflation elements is small, interstitial tetra-
hedral elements can become distorted. Increasing the number of spreading iterations reduces the probability
of this occurring, although the default settings do not usually require modification.
Minimum Internal Angle - This governs the minimum angle that is allowed in the triangular face of a prism
nearer to the surface before it is deemed to be of unacceptable quality and marked for deletion. The default
value is 2.5 degrees but you may want to increase this if you are having problems with high aspect ratio elements
adjacent to inflated layers. You must set a value between 0.0 and 40.0 degrees.
Minimum External Angle - This governs the minimum angle that is allowed in the triangular face of a prism
farthest from the surface before it is deemed to be of unacceptable quality and marked for deletion. The default
value is 10 degrees but you may want to increase this if you are having problems with high aspect ratio elements
adjacent to inflated layers. You must set a value between 0.0 and 40.0 degrees. This parameter controls the
minimum angle in a triangular face seen by the tetrahedral volume mesher, triangles containing small angles
are more difficult to create tetrahedral on and therefore increasing this parameter will increase the reliability of
the volume mesher.
Inflated Boundary
The creation of an Inflated Boundary is how you specify which faces you want Section : Inflation to apply to.
There are some limitations on the topology that you can have for the inflation process to work well.
• Location - Select the face(s) of the model from the Graphics window. You can either select the faces directly
from the Graphics window, or select a Composite 2D Region from the Tree View. A face cannot be in more
than one Inflated Boundary, and it may not be in both an Inflated Boundary and a Section : Periodic Pair.
If you have multiple Solid Bodies in your geometry, then you should read the information on the difference
between faces and 2D Regions to understand how you can apply Inflation to the faces which form the
boundaries between the bodies and determine which side(s) of these faces have Inflation.
• Maximum Thickness - Set the Maximum Thickness for the whole inflation layer. The way that this para-
meter is used is described in Section : Total Thickness. It must be set to a value less than the Maximum
Spacing set under Default Body Spacing. The parameter is not used if the Inflation Option is set to First
Layer Thickness in the Section : Inflation - Details.
A new Inflated Boundary can be created by right-clicking on Inflation in the Tree View and selecting Insert>In-
flated Boundary. After creation, an Inflated Boundary can be renamed, suppressed (made inactive) or deleted
by right-clicking on its name in the Tree View. If you want to suppress all the Inflated Boundaries in the model,
right-click over Inflation and select Suppress.
A inflated boundary can also be created on any internal face; this includes faces that are intended to be Thin
Surfaces. Inflation will not occur on an exposed edge of such a face, as such the inflation layers will be gradually
reduced to zero as the mesh approaches the exposed edge nodes.
You can also choose to inflate only one side of a face that will be used as a Thin Surface. How to do this is described
in Section : 2D Regions and Faces.
There are some considerations to make when setting up the Inflated Boundary, particularly when setting the
Maximum Thickness (and not using First Layer Thickness):
Inflating Between Thin Gaps
Inflating the Inside Walls of Cylindrical Pipes
If you change the setting of the Thickness Multiplier and/or the Maximum Thickness, then you will have to ensure
that enough of a gap remains between the inflation layers for the volume mesher to be able to fill the remaining
void with good quality tetrahedra.
The refinement of the surface mesh in order to fulfil this criteria can be undertaken automatically using Section :
Surface Proximity, and the default setting of four elements across the gap satisfies exactly this criteria.
• The inflated layers will grow towards each other and eventually collide on the axis of the cylinder. Even
if they stop short of colliding they will leave a narrow cylindrical void that must be filled by the volume
mesher.
• The quality of the exposed element faces on the inflated layer deteriorates as the thickness of the inflated
layer grows. The face topology of the inflated triangulated face is the same as the original one so the the
exposed triangles have a greater aspect ratio.
If the inflation thickness is too great then the resulting void can be difficult to mesh and can lead to either
When using the Section : Total Thickness option in the Inflation Details View, then providing that the Thickness
Multiplier is set to 1 (the default) and the Maximum Thickness is set to something larger than the local mesh
length scale on the faces which form the cylinder, then the total thickness of the inflation layer is approximately
equal to the local mesh length scale.
A simple calculation shows that in this case, the inflated layers will not meet in the middle as long as there are
at least seven equal sub-divisions around the circumference of the pipe. For a more typical value of sub-divisions,
i.e. 12 or more, it will also guarantee that the resulting void is not too thin and that the exposed faces are of a
reasonable quality.
• Increase the number of sub-divisions around the circumference of the pipe. This can be done by applying
a Section : Face Spacing to the faces of the cylinder.
• Modify the Maximum Thickness of the inflated layers on these faces to restrict their growth. This can be
done in the Details View of the Section : Inflated Boundary that they are part of.
• Increase the value of the Minimum External Angle. This will ensure that any prismatic elements with a
high aspect ratio triangular face are removed from the inflated layer. The parameter can be changed using
the Details View for Section : Inflation.
• Increase the Number of Spreading Iterations. This will increase the number of layers that are removed
when a collision is detected and should leave a larger gap. The parameter can be changed using the Details
View for Section : Inflation .
Stretch
Stretch can be used to expand or contract the mesh elements in a particular direction. In practice, the geometry
is expanded by the specified factors, meshing takes place and then the geometry is contracted back to its original
size.
The Stretch object is present in the Tree View by default. Three items are required to specify the stretch:
The maximum and minimum stretches allowed are 0.2 and 5.0 respectively. Stretch factors below 0.6 are not
recommended.
Before stretching:
After stretching:
When a stretch factor is used, the effective influence of a Section : Point Control, which is treated as a spherical
mesh control whilst meshing takes place, will NOT be modified to elliptical. Hence a Point Control will appear
to influence an elliptical region when the mesh is examined; this is caused by the modified influence of the mesh
control not being mapped between stretched and non-stretched space. A Section : Line Control and Section :
Triangle Control will be affected in a similar way.
Stretch cannot be used if the Extruded 2D Meshing option is enabled. Any stretch factors set will be ignored.
Proximity
The Proximity settings control automatic refinement of the mesh when edges or faces are found to be in close
proximity to other edges or faces, but not connected. There are two types of proximity setting:
Edge Proximity
When Edge Proximity is enabled, your model will be examined for locations where relatively small mesh elements
are used on a curved face in close proximity to relatively large coarse elements on a flat face. In these locations,
the coarse elements will be automatically refined to improve the model in this region.
The effect of using Edge Proximity is carried over to adjacent faces. This can be seen in the figure below where
the mesh has been refined on the lower face when Edge Proximity is ON.
There are no user controls for Edge Proximity, other than allowing it to be enabled and disabled. The default is
for it to be enabled.
Edge Proximity is only available when using the Section : Delaunay Surface Mesher.
Surface Proximity
When Surface Proximity is enabled, your model will be examined for locations where distinct faces are in close
proximity. The surface mesh will then be automatically modified to reduce the mesh size in regions where faces
are in close proximity and the original mesh does not resolve the gap sufficiently.
• Number of Elements Across Gap - The aim when Surface Proximity is enabled is to have at least the
number of elements specified by this setting spanning the gap between the faces. We do not recommend
using a value less than the default of 4. This will allow higher quality inflated (prismatic) and tetrahedral
volume elements to be created in the gap region. If you use values of 1 or 2, and inflation is applied to
the faces, then you may encounter meshing problems. The maximum allowed setting is 10.
• Maximum Number of Passes - This specifies the maximum number of times that the surface mesher will
run in order to satisfy the criteria for Number of Elements Across Gap. It must be between 1 and 10.
The Surface Proximity process requires an initial surface mesh to be generated. The relative proximity of triangular
face elements is then compared with the size of the triangles themselves. If the triangular element size is greater
than 1/n of the gap between the faces, where n is the setting of Number of Elements Across Gap, then local
mesh controls are introduced into the mesh and the surface mesh is modified.
The process allows the mesh length scales to be reduced by a factor of 2 each time the mesh is regenerated, and
the process is applied up to a maximum of n times, where n is the Maximum Number of Passes. This results in
the Surface Proximity option potentially reducing an original triangular edge to 1/2n of the initial length if the
maximum reduction in length scale is applied on each pass of the surface meshing. For reference, a setting of n
= 5 gives up to a 1/32 reduction in edge length, and this corresponds to an original triangle being replaced by
approximately 1000 triangles.
Surface Proximity is available for both the Section : Delaunay Surface Mesher and Section : Advancing Front (AF)
Surface Mesher. An example of the effect of Surface Proximity is shown below.
The surface mesh was created using Angular Resolution as the Section : Face Spacing option. This refines the
mesh on the cylindrical pipes but not the box. It can be seen that the mesh on the cylindrical pipes is considerably
finer where the pipes are in close proximity and the same is true where the pipe and box are close. In the corres-
ponding volume mesh (not shown), the number of volume elements crossing the gap region is 4.
Caution should be exercised on geometries where one geometrical component intersects a second component
at an acute angle. If Surface Proximity is used in this case, the mesh length scale may be dramatically reduced
in the region of the intersection. It is important, therefore, to introduce a minimum mesh length scale, possibly
using the Minimum Edge Length available when the Angular Resolution option is used for the Section : Face
Spacing.
Note that if you have multiple parts which are very close together (e.g. they would have a shared face if the parts
were combined into one part), then using Surface Proximity can result in unexpected refinement on the faces
which are close to faces from the other parts. If this is a problem, then you can instead mesh each part separately:
this can be achieved by suppressing all but one part in CFX-Mesh and meshing that, and then repeating for every
other part.
Mesh Options
The following settings are available under the Options part of the Tree View:
Every length scale (except for those applied to Face Spacings) that you set anywhere in CFX-Mesh is multiplied
by the Global Mesh Scaling factor before meshing takes place. This can be very useful if you have set up a mesh
including several Controls and then want to refine it uniformly without having to change all of these settings.
The Global Mesh Scaling Factor can be given a value between 0.5 and 2. Making it smaller makes the mesh length
scales smaller i.e. gives you a larger mesh.
Only mesh length scales are affected by the Global Mesh Scaling factor. For example, the Radius of Influence for
Controls is not affected. This makes its behaviour different to just using Section : Stretch with Stretch in X, Stretch
in Y and Stretch in Z all set to the same values. If you try to scale the mesh using the Stretch functionality in this
way, then all lengths (including Radius of Influence) will be affected.
Note that the Global Mesh Scaling factor is only applied at the meshing stage. For instance, the display of the
size of Controls will show the size as if the Global Mesh Scaling factor is set to 1, although when the mesh is
generated, the actual size of the mesh in the vicinity of the Control will be affected by this factor.
Surface Meshing
Two surface meshers are available in CFX-Mesh:
Delaunay Surface Mesher
Advancing Front (AF) Surface Mesher
The surface mesher used by CFX-Mesh can be changed using the Options settings in the Tree View.
The surface mesher used by CFX-Mesh can be changed using the Options settings in the Tree View.
Meshing Strategy
The Meshing Strategy option, set on the Details View for Options in the Tree View, controls the global behaviour
of the mesher. This setting has fundamental implications for the type of meshing which takes place. The following
options are available.
• Advancing Front and Inflation 3D - This is the default choice of meshing strategy. This meshing strategy
creates a 3D mesh consisting of tetrahedra, with prisms and pyramids if Section : Inflation is used. Most
models will require the use of this meshing strategy.
• Extruded 2D mesh - This meshing strategy allows you to generate a 2D or simple extruded mesh. It is
only applicable for geometries (or parts of geometries) which can be created by a rotation or translation
of a collection of faces. It generates a mesh consisting of prisms, with hexahedra if Section : Inflation is
used.
• Advancing Front - This is the default choice for volume meshing. It uses the Advancing Front Volume
Mesher to generate a mesh using a single processor on your local machine (the machine which is running
ANSYS Workbench).
• Parallel Advancing Front - This choice uses the Advancing Front Volume Mesher to generate a mesh
using more than one process on your local machine. You may wish to use this if you are generating a large
mesh and want to speed up the mesh generation process on a machine with more than one processor,
or to overcome the memory limitations of a single process.
The Advancing Front Volume Mesher is described in Section : Advancing Front Volume Mesher, and using it in
parallel is described in Section : Parallel Volume Meshing.
When the volume mesh of tetrahedral elements (together with prismatic and pyramidal elements if Inflation is
used) is generated, it is written to the Section : CFX-Pre Mesh File.
Parallel Volume Meshing has been implemented to increase the maximum mesh size that can be created. You
can also speed up mesh generation by running in parallel. A typical speed-up is of the order of 50% when using
4 processors on a mesh greater than 5 million tetrahedral elements. To achieve a reasonable speed-up, we do
not recommend using less than 500,000 elements per partition for a tetrahedral mesh.
If you select to use the Parallel Advancing Front option, then you must specify the Parallel Meshing option.
The two choices are:
• PVM Local Parallel - Generates the mesh in parallel using multiple processeses on the same machine
(your local machine).
• PVM Distributed Parallel - Generates the mesh in parallel on multiple processors spread over your local
machine and other machines. This is a beta feature.
When using Parallel Volume Meshing, the meshing process divides the geometry up into sections (“partitions”)
which are meshed separately (one in each process specified) and then the mesh is consolidated into one volume
mesh. A volume mesh produced in parallel is indistinguishable from a volume mesh produced in serial (using
only one process). You will NOT be able to see partition boundaries in the mesh.
Partitioning is the process of dividing the geometry into sections (partitions) each to be meshed individually. To
control this process, you must specify how many times the geometry should be divided along each of the major
coordinate axes X, Y and Z, by specifying Number of Partitions in X, Number of Partitions in Y and Number
of Partitions in Z. If you specify Number of Partitions in X to be 2, Number of Partitions in Y to be 1, and
Number of Partitions in Z to be 1,then the geometry is divided along the X-axis, giving two partitions in total.
In general, the product of these three numbers will give the total number of partitions used for the parallel
meshing operation.
In general, it is best to have as few mesh elements intersecting a partition boundary as possible, to minimize the
amount of communication required between processes. This means that if you have a long thin pipe geometry,
then it is best to partition the geometry so that it is divided along the coordinate direction which is along the
length of the pipe, for example.
Although you need to decide how many partitions there should be along each of the three major axes, you do
not need to specify the locations at which the geometry is divided. The location of the partitions in each coordinate
direction is determined automatically, taking into account variations in the mesh length scale, in order to produce
partitions that will each contain roughly the same number of volume elements. This is important for getting the
best speed-up for the number of partitions.
You should not use more partitions than there are processors on the local machine if you want to see a speed-
up in the mesh generation process, since this will cause more than one partition to be assigned to some processors,
resulting in slower volume meshing.
If you are using PVM Distributed Parallel (which uses processors on different machines), then you can use as
many partitions as you have available processors on the different machines. You should also bear in mind that
each processor will be given a similar size of mesh to produce, so adding in an extra processor which is significantly
slower than the others will actually slow the whole meshing process down, since it has to wait for the slowest
processor to finish.
If you are using the PVM Distributed Parallel option for generating your mesh, then you need to specify which
machines you want to use for the meshing process by using the Hosts List option. You can select any hosts to
run on by entering a comma-separated list e.g. “machine1,machine2”, subject to the following restrictions:
• PVM Distributed Parallel is only supported on machines which are of the same type (e.g. the machines in
each parallel run must be all Windows machines, all HP machines, all SUN machines or all Linux machines).
• Each machine you want to run on must have network access to the local machine and must have an in-
stallation of ANSYS Workbench which includes CFX-Mesh in the same location as the local machine.
• Each machine must have been set up to run ANSYS CFX software in parallel. On Windows machines:
– The rsh service supplied with the ANSYS CFX software (not the ANSYS Workbench software) must be
installed and available on each machine other than the local (master) machine. The setup of this rsh
service is described in ANSYS CFX 10.0 Installation Guide in the section “Installing ANSYS CFX on Windows
Systems > Windows Parallel Setup > Setting up the rsh Service”. Please note the relevant security
warnings in this section.
On UNIX machines:
– Each machine other than the local (master) machine must be configured to allow remote shell com-
mands (rsh, or remsh on HP systems) to be executed from the local machine. If your network is not
already set up to do this, then this set up is described in ANSYS CFX 10.0 Installation Guide in the section
“Installing ANSYS CFX on UNIX Systems > UNIX Parallel Setup > General Requirements > Remote Access”.
Extruded 2D Meshing
CFX-Mesh has the capability of generating 2D meshes (1 element thick) or simple extruded meshes. 2D meshes
can be used for 2D simulations, and extruded meshes can be used to create a mesh which is more aligned with
the flow, or with fewer elements than the equivalent 3D mesh (for example, if you have a long thin pipe where
there is little variation in the flow variables along the pipe length). In either case, the method of creating the
mesh is the same: you must specify which faces of the geometry the extrusion takes place between, and then
the Extruded 2D mesher generates the mesh on these faces and performs the extrusion between them (more
detail is given below). An example of a simple extruded mesh is shown below.
Only certain geometries are suitable for use with this meshing option. The basic requirement is that the geometry
must be capable of being created by taking a set of surfaces and either revolving them about an axis to form a
set of solids, or translating them along a fixed vector to form a set of solids (you do not need to have actually
created the geometry in this fashion for Extruded 2D Meshing to work). See Section : Geometry Requirements
for Extruded 2D Meshing for more details.
To enable the Extruded 2D mesher, set Meshing Strategy (under Options in the Tree View) to Extrude 2D
Mesh. When you make this setting, then any Periodic Pairs currently in the Tree View are removed and replaced
by a single Section : Extruded Periodic Pair entry. You use the Extruded Periodic Pair entry to define the faces
for the extrusion, and the transformation between them. (If you later set the Meshing Strategy back to Advancing
Front with Inflation 3D then the original Periodic Pairs are restored and the Extruded Periodic Pair is removed.)
Extruded 2D Meshing Options
Extruded Periodic Pair
Geometry Requirements for Extruded 2D Meshing
Mesh Generation Process for Extruded 2D Meshing
• 2D Extrusion Option - The default setting for this option is Full, and this generates a mesh using the full
extent of your geometry. However, if you want to generate a 2D mesh (1 element thick) then you may
not wish to use the full extent of the geometry, but to select a thickness which allows high quality mesh
elements to be generated. In this case, you can select Partial. When this setting is selected with a rotational
extrusion, then CFX-Mesh automatically sets the angle of rotation for the extrusion to be 1 degree. When
this setting is selected with a translational extrusion, then CFX-Mesh automatically determines a thickness
which is appropriate given the local mesh element sizes. The example below illustrates this.
If you want to control the thickness of the extrusion exactly, then you must create the geometry with the
appropriate thickness and use the Full option.
If you select the Partial option, then you are restricted to having just one element thick and none of the
other options listed below are available.
• Number of Layers - This setting allows you to control the number of layers which the extruded mesh is
divided into.
• Distribution - This determines how the mesh elements are distributed along the length of the extrusion.
It is only relevant if Number of Layers is set to 2 or greater. The options are described in the table below.
• Expansion Factor - For the non-uniform Distribution settings, the Expansion Factor determines the
rate of growth of the element thickness between successive elements. Each element is one Expansion
Factor bigger than the previous one. Values between 1 and 1.5 are allowed.
An Extruded Periodic Pair is a specific example of the more general Periodic Pair which is used to define the
transformation for Extruded 2D Meshing.
Only one Extruded Periodic Pair is allowed, and this will be created automatically when you activate the Extrude
2D Meshing option, and removed when you stop using the Extrude 2D Meshing option. An Extruded Periodic
Pair cannot be renamed, suppressed or manually deleted.
You must specify the following items for the Extruded Periodic Pair definition:
• Location 1 - Select a face or a set of faces of the model from the Graphics window. You can either select
faces directly from the Graphics window, or select a Composite 2D Region from the Tree View. In either
case, all the faces selected must be on the external boundary of the model and must not be included in
an Inflated Boundary.
• Location 2 - Select a face or a set of faces of the model from the Graphics window. The faces must be related
to those selected for Location 1 as described in Section : Geometry Requirements for Extruded 2D Meshing.
Again, you can either select faces directly from the Graphics window, or select a Composite 2D Region
from the Tree View.
• Periodic Type - This can either be set to Translation or Rotation. If Translation is selected, then in most
cases no further input is required. If, however, Rotation is selected, then you must specify the axis, by
specifying any two points on it. You can select the points by selecting a vertices from the model, selecting
arbitrary points on the model faces or by specifying coordinates. See Section : Point Selection for details.
• Translation Vector - In certain cases, CFX-Mesh cannot determine automatically what the translation
vector for a translational periodic pair is. In these cases, you will be asked to supply the translation vector
for the Extruded Periodic Pair explicitly. You should specify the translation vector which moves the faces
in Location 1 to those in Location 2.
• Angle of Rotation - In certain cases, CFX-Mesh cannot determine automatically what the rotation angle
for a rotational periodic pair is. In these cases, you will be asked to supply the rotation angle for the Extruded
Periodic Pair explicitly. You should specify the angle which rotates the faces in Location 1 to those in
Location 2, using the right-hand rule. The vector for the rotation axis is the vector between the specified
Point 1 and Point 2. Only angles greater than zero are permitted. If your setup requires the use of an angle
less than zero, then switch Point 1 and Point 2 to reverse the rotation axis. See the picture below.
When an Extruded Periodic Boundary has been created, then when you click on its name in the Tree View, the
faces it is using will be highlighted. In addition, if the Extruded Periodic Boundary is rotational, the axis of rotation
will be shown as a highlighted line.
• Each Body in the geometry must be capable of being constructed by taking a single face and either re-
volving it or translating it to define the solid Body.(You do not need to have actually created the geometry
in this fashion for Extruded 2D Meshing to work.)
• To set up the Extruded 2D meshing, you need to define an Extruded Periodic Pair. The transformation
specified for this Extruded Periodic Pair, which relates Location 1 and Location 2 in the Extruded Peri-
odic Pair definition, must match the transformation (revolve or extrude) that could be used to construct
the Body from a face.
• If there are multiple Bodies in the geometry, then each one must be capable of being constructed using
the same transformation. Every Body in the geometry must have faces in both Location 1 and Location
2 in the Extruded Periodic Pair.
• Each face in the Location 1 face list must map to an equivalent face in the Location 2 face list under the
specified transformation. The mapping must be the same for each pair of faces. Multiple faces can be se-
lected for each of Location 1 and Location 2, provided each face in the Location 1 face list maps onto a
face in the Location 2 face list using the specified transformation.
It is possible for Section : Controls to affect the mesh in unexpected locations when Extruded Periodic Pairs are
used. Controls originally located outside a Solid Body can be copied into the Body through the transformation
and affect the local face and volume mesh length scale.
1. The Extruded Periodic Pair faces are checked with the specified transformation.
5. The remaining faces are meshed, using all of the usual meshing settings (e.g. Inflation, Controls). Although
the surface mesh on these faces is not used in the final mesh, this step is necessary to allow the appro-
priate inflation elements to be generated. To avoid wasting large amounts of computing time, the
mesher actually only creates the necessary parts of this surface mesh rather than the full mesh. This is
the end of the surface meshing procedure.
6. The Extruded 2D Mesher then removes the surface mesh from all faces but those in Location 1 and Loc-
ation 2.
7. The volume mesh is obtained by joining up the equivalent nodes on Locations 1 and 2, taking into account
the settings for 2D Extrusion Option, Number of Layers and Distribution.
The Preview function in the Tree View allows you to preview mesh on a face or faces of your geometry.
Faces are selected by creating a Section : Preview Group, and you can choose whether to generate the mesh on
just a few faces or whether to generate the whole surface mesh at one go. The Details View for Preview allows
you to control how the mesh is displayed in the Graphics window, including whether or not to display the inflated
elements if you have set up Inflated Boundaries.
Preview Group
Controlling the Display of Surface Mesh
Preview Group
A Preview Group is created to allow you to specify which part of the surface mesh you want to preview, in order
to verify that the settings applied have the desired effect.
To create a Preview Group, right-click on Preview in the Tree View, and ask to insert a Preview Group. In the
Details View, you will be asked to select 2D Regions to form the group. Only 2D Regions can be placed in a preview
group; you cannot preview the mesh in the volume of a body (away from any faces). If you want to preview the
mesh on an edge, you must add a 2D Region which is bounded by that edge to a Preview Group.
One Preview Group is created automatically: the Default Preview Group. This contains all of the faces in the
geometry and can be used to view the full surface mesh. As you make changes to your geometry (e.g. by geometry
update or using Virtual Topology) the Default Preview Group is automatically updated to contain all the faces
of the new geometry.
Once a Preview Group is created, you can right-click on its name in the Tree View and choose Generate This
Surface Mesh in order to preview the mesh just on the selected faces. Click on the Preview Group name at any
time to display the mesh.
If you change the mesh settings, then the mesh will no longer be up-to-date and instead of seeing the green
tick status symbol ( ) next to the Preview Group entries in the Tree View, you will instead see this symbol:
. You will still be able to view the existing mesh elements, but the mesh will not reflect your latest settings.
To regenerate just the mesh in any preview group, just right-click on its name and choose Generate This Surface
Mesh again.
If you have several Preview Groups, then rather than regenerating the mesh on each one separately, you can
instead right-click over Preview and choose to Generate All Surface Meshes. This will generate the full surface
mesh, and so update all preview groups. To view the full surface mesh at once, just click on the Default Preview
Group name. The function Generate All Surface Meshes is also available from the Meshing Toolbar ( )
and the Go menu at the top of the window.
If you are using Section : Inflation, Section : Surface Proximity or Face Spacings, then the mesh on each face is
affected by the mesh on the faces which are near it, and so the full surface mesh will always be generated behind
the scenes (otherwise the displayed surface mesh would not be the same mesh that you would get if you asked
to create a volume mesh). In this case, you do not save any time by using Generate This Surface Mesh instead
of Generate All Surface Meshes.
Control over how the mesh is displayed is described in Section : Controlling the Display of Surface Mesh.
To hide the mesh, simply click on one of the other objects in the Tree View. To show the mesh again, click on the
Preview Group name. To delete a Preview Group, right-click over its name in the Tree View and select Delete.
If you are generating a large mesh, you may find that after you have displayed the surface mesh in ANSYS
Workbench, the ANSYS Workbench process is using a lot of memory. This may result in a volume mesh failure
due to not enough memory being available, or make the viewer very slow to respond. In this case, right-click
over Preview in the Tree View, and select Clear Surface Mesh. This removes the surface mesh from memory.
When you do this you will only be able to view surface meshes again once you have regenerated them.
To see the statistics for the mesh, expand the Preview Group object in the Tree View (by clicking on the plus sign
next to its name) and then click on the Mesh Statistics ( ) entry which opens up. The numbers of quads
(four-sided surface elements) and triangles in the mesh is shown in the Details View.
If non-fatal warning messages or errors are produced by the mesher, then these messages will be shown under
the Errors item in the Section : Tree View. You can click on each error to view it. If the error or warning concerns
a particular face or element, then when you click on that error, the appropriate face or element will be highlighted
in the Graphics window.
If fatal errors are produced, then the error messages can be accessed in the same way. In addition, a pop-up
message will notify you that the meshing operation has failed.
You should note that by default, the surface mesh is displayed after it has been modified due to the presence of
inflation layers, if you are using Inflation. You can use the Details View for Preview to change from viewing the
surface mesh after inflation to viewing the surface mesh before inflation, or to view the inflated layers themselves.
If you want to view the volume mesh, of 3D elements, you can do so in CFX-Post by loading either the Section :
CFX-Pre Mesh File or the Results File.
• Display Mode - Choose between Wire on Face Mesh (shows the mesh faces and the mesh lines), Wire
Mesh (shows just the mesh lines) or Face Mesh (shows the mesh faces).
• Display Mesh - This controls how the surface mesh elements are displayed if you are using Section : Infla-
tion. The table below describes the different options and shows a simple case as an example.
Mesh After Inflation This option shows the mesh after the
inflated elements have been gener-
ated. It is the default if you have spe-
cified inflation in your model. It shows
the surface mesh as it will appear after
volume meshing, including the quad
(four-sided) surface elements created
during the inflation process.
The Display Mesh parameter is not available if the Extruded 2D Meshing option is enabled. When this
meshing option is used, the surface mesh is always displayed after both the inflation and extrusion processes
have taken place.
• Transparency (%) - Choose the transparency of the mesh. 100% means that the mesh is completely
transparent (i.e. it won't show up) and 0% means that the mesh is completely opaque.
• Shine (%) - Shine controls how much light is reflected by the faces of the mesh. 0% gives the lowest
amount of reflection and will result in the mesh looking matt in texture. How much light is reflected by
the displayed mesh is also affected by the Shine setting under Geometry in the Tree View. In particular,
if Shine under Geometry is set to 0%, then the Shine setting under Preview has no effect: the mesh is
always displayed as matt.
• Face Color Mode - This controls the color of the faces (if Display Mode is set to show the Face Mesh) or
lines (if Display Mode is set to show the Wire Mesh). Choose between:
Once you have finished setting up your mesh, you can generate the volume mesh by right-clicking on Mesh in
the Tree View and selecting Generate Volume Mesh. You can also generate the volume mesh using the Section :
Meshing Toolbar.
The volume mesh is written to the Section : CFX-Pre Mesh File ready for import into CFX-Pre.
You will not be able to view the volume mesh or any 3D elements (including the prism elements produced by
the Section : Inflation process) in CFX-Mesh. Instead, after generating the mesh you must load the mesh into
CFX-Post to view it.
To regenerate the mesh, simply right-click on Mesh in the Tree View and choose Generate Volume Mesh again.
If non-fatal warning messages or errors are produced by the mesher, then these messages will be shown under
the Errors item in the Section : Tree View. You can click on each error to view it. If the error or warning concerns
a particular face or element, then when you click on that error, the appropriate face or element will be highlighted
in the Graphics window.
If fatal errors are produced, then the error messages can be accessed in the same way. In addition, a pop-up
message will notify you that the meshing operation has failed.
The file name and location is specified by using the file browser which appears each time you ask to create the
volume mesh. The extension is .gtm. By default, CFX-Mesh will not overwrite any existing CFX-Pre Mesh file. If
you specify a name of a file which already exists, then CFX-Mesh will tell you that the file already exists. You can
either change the file name specified, remove or move the existing file, or choose to overwrite the existing file.
If you have installed CFX-5.7.1 so that you can run CFX-5 in ANSYS Workbench, then the first time you create a
volume mesh within a project, a new Advanced CFD entry will appear on your Project Page, which will contain
the CFX-Pre Mesh File. Every subsequent CFX-Pre Mesh File that you create will appear under this entry. Each of
these entries can be used to start CFX-5 in ANSYS Workbench; see the CFX-5 User Documentation for details.
When you start CFX-Pre in ANSYS Workbench, using one of these CFX-Pre Mesh Files, then CFX-Pre automatically
saves its simulation setup using this file and the simulation file .cfx with the same base name. If you later regen-
erate the volume mesh, you must choose a different name for your new CFX-Pre Mesh File to avoid overwriting
data placed in the existing CFX-Pre Mesh File by CFX-Pre.
If you start CFX-Pre outside of ANSYS Workbench and import a CFX-Pre Mesh File into a new simulation, then
you can choose whether to save the simulation with the same name as the CFX-Pre Mesh File or with a different
name. If you choose to save with the same name, then when you regenerate the volume mesh, you must choose
a different name for your new CFX-Pre Mesh File to avoid overwriting data placed in the existing CFX-Pre Mesh
File by CFX-Pre. If you choose to save the simulation with a different name then you can safely use the same CFX-
Pre Mesh File name when regenerating the volume mesh.
1. From the main menu, choose Tools>Options. An Options dialog box appears and the CFX-Mesh options
are displayed on the left.
2. Click on a specific option.
3. Change any of the option settings by clicking directly in the option field on the right. You will first see a
visual indication for the kind of interaction required in the field (examples are drop down menus, secondary
dialog boxes, direct text entries).
4. Click OK.
Graphics View
Graphics window
Properties View
Geometry
Virtual Topology
Miscellaneous
Other help descriptions available that describe the Options dialog box:
• Common Settings
• DesignModeler
• Simulation
• DesignXplorer
• Licensing
Graphics View
The Assembly category includes:
• View: This determines the type of geometry display which is used for CFX-Mesh at the start of each ANSYS
Workbench session. After that, changes to the View type can be made through the Tools menu and the
setting of View type will persist if you open or create a new CFX-Mesh database. The View type is not a
property of the CFX-Mesh database and is not stored in a CFX-Mesh database.
• Transparency: This determines the value of Transparency which is given to the geometry whenever a
new CFX-Mesh database is started. After that, the Transparency of the mesh is stored in the database and
changes are made by using the Details View for Geometry through the normal CFX-Mesh user interface.
See Section : Geometry Display for details.
• Shine: This determines the value of Shine which is given to the geometry whenever a new CFX-Mesh
database is started. After that, the Shine of the mesh is stored in the database and changes are made by
using the Details View for Geometry through the normal CFX-Mesh user interface. See Section : Geometry
Display for details.
• Transparency: This determines the value of Transparency which is given to the mesh whenever a new
CFX-Mesh database is started. After that, the Transparency of the mesh is stored in the database and
changes are made by using the Details View for Preview through the normal CFX-Mesh user interface.
See Section : Controlling the Display of Surface Mesh for details.
• Shine: This determines the value of Shine which is given to the mesh whenever a new CFX-Mesh database
is started. After that, the Shine of the mesh is stored in the database and changes are made by using the
Details View for Preview through the normal CFX-Mesh user interface. See Section : Controlling the Display
of Surface Mesh for details.
Graphics window
The Tree Colors category includes:
• Normal: This setting determines the normal color of the text in the Tree View.
• Dimmed: This setting determines the dimmed color of the text in the Tree View, which is used when the
Tree View is not in focus i.e. you are entering information in the Details View.
• Highlight: This setting determines the text color when a Tree View entry is being highlighted; for example,
a Point Spacing will be highlighted if a Point Control which uses that Point Spacing is selected.
Properties View
The List Behaviour category includes:
• Auto Activate: If this is set to Yes, then when you click on an object in the Tree View which requires a
selection and is currently invalid, the item which requires selection is opened automatically. For example,
if you create a new Inflated Boundary, then it requires you to select a location for the inflation. If Auto
Activate is turned on, then you can select the required faces from the Graphics window immediately. If
Auto Activate is turned off, then you must click next to Location in the Details View before you can start
selecting faces.
The default setting is Yes. Select No if you want to revert back to the behavior of CFX-Mesh 8.1 or earlier.
Geometry
The CAD category includes:
• Auto Verify on Change: If you set this to Yes, then every time you perform a Geometry Update or Clear
Settings operation, the CAD Check operation is performed on the new setup. This would be useful if you
were making changes to your geometry and wanted to find out immediately if it was invalid or poor, before
you did any other operations. The default setting is No.
Virtual Topology
The General category includes:
• Automatically Remove Invalidated Virtual Cells: If this is set to Yes (this is the default setting), then
every time a virtual face or edge is edited to include an existing virtual face (or edge), that virtual entity
will be automatically deleted. If this is set to No, then existing virtual entities cannot be added to a new
or existing virtual face (or edge).
• Merge Edges Bounding New Virtual Faces: If this is set to Yes (this is the default setting), then all edges
that bound a newly created virtual face will be assessed to see if they can be merged. The merging will
be dependent on the Automatic Edge Merging Tolerance, so if the angle between the two tangents of
connected edges that bound a virtual face is less than the tolerance they will be merged. If this is set to
No, then the edges that bound a newly created virtual face will not be modified.
• Automatic Edge Merging Tolerance (Degrees): This angle sets the threshold at which connected edges
on a newly created virtual face can be automatically merged.
Miscellaneous
The Files category includes:
• Folder for Temporary Files: During meshing operations, CFX-Mesh can write large amounts of data to
temporary files. This option allows you to specify where these files should be written: you should select
a directory with plenty of disk space, particularly if you are generated large meshes. It only takes effect
when CFX-Mesh is started for the first time in a ANSYS Workbench session. The default value is specified
by the TEMP environment variable. If this environment variable is not set, then the default directory is
specified by TMP or TMPDIR, or if neither of these are set, the directory used is C:\Temp (Windows) or
/tmp (UNIX).
• Frequency of Auto Backup: This determines how often a backup file is written. The options are Frequently,
which will back up your CFX-Mesh database after (approximately) every 10 changes to your mesh setup,
Moderately, which will back up after every 20 changes, Infrequently, which will back up after every 40
changes, and Never. The default is Moderately. Additionally, you can choose to backup your database
just before each meshing action; see below for details.
• Auto Backup Before Action: In addition to the backups which take place after every so many changes,
you can also choose to take a backup copy of your CFX-Mesh database immediately before performing
any meshing action, by setting this option to Yes (the default).
Backup files are saved in a directory called <tmpdir>\cfx.cm.vXX.Y\.recovery, where <tmpdir> is the Folder
for Temporary Files set by the previous option, and XX.Y are numbers chosen to make the directory name
unique. If your original .cmdb and .cmdat names were Project.cmdb and Project.cmdat, respectively, then the
backup files will be called _Project.cmdb and _Project.cmdat, for example. In order to restore these backup
files, you should do the following:
1. Open a new ANSYS Workbench session. On the Start Page, choose to Open an existing file and set the
filter to look for existing CFX-Mesh files. Browse to locate the required backup files in the temporary
folder.
2. Once CFX-Mesh has opened, choose File>Save As... and save the backup files to the name and location
that you wish to restore them to.
3. Close the project without saving it.
Do NOT just manually move and rename the files back to where you want them, or CFX-Mesh will NOT be able
to re-open them.
Common Queries
Why can the Mesher Fail Trying to Create a Surface Mesh?
Why can the Mesher Fail Trying to Create a Mesh with Inflation?
How can I Create a Mesh Greater than 1 km Across?
How can I Ask to See the Warning Messages that the Mesher Produces?
Which Part of my Model is Causing the Problem?
Why do I get Messages About Disk Space when I Have Plenty of Space in my Project Directory?
What are the Files which CFX-Mesh Produces?
1. You may be trying to mesh Section : Closed Faces with the Section : Advancing Front (AF) Surface
Mesher, which cannot mesh such faces.
The simplest solution to this problem is to use the Section : Delaunay Surface Mesher which is selected
by default. If you need to use the AF Surface Mesher, then there are two possible solutions to this problem.
For relatively simple geometries you can recreate your model without closed faces, for example using
two curved faces to define a cylinder. You can find more help with this in Section : Closed Faces.
For larger, more complicated, or imported models, you can break closed faces into one or more non-
closed faces using the Split action in DesignModeler to split the Solid Body in such as way as to also
break the closed face.
2. You may be trying to mesh an invalid face topology. Some non-manifold topologies cannot be meshed
with either surface mesher.
Also see Section : Meshing Warning and Error Messages for additional information on meshing warnings and
error messages.
Why can the Mesher Fail Trying to Create a Mesh with Inflation?
Check your geometry model to make sure adjoining non-inflated faces do not contain two or more edges which
meet at an intermediate edge point.
For tips on how to use the surface meshers most effectively, see Section : Geometry and Topology for the Faces
of Solid Bodies.
If you want to create a mesh which is larger than this, then we suggest that you generate a scaled-down version
of your geometry and mesh. It is then straight-forward to scale the mesh up again on import into CFX-Pre.
How can I Ask to See the Warning Messages that the Mesher Produces?
By default, warning messages from the mesher are ignored to allow meshing to continue uninterrupted unless
a fatal error occurs.
If non-fatal warning messages or errors are produced by the mesher, then they will be displayed under the Errors
item in the Section : Tree View.
If it is difficult to see the highlighted face or element, you could hide the display of the geometry before clicking
on the error. The part of the model causing the error will still highlight, which should make it much easier to see.
Hiding the geometry (or part of the geometry) can be done by right-clicking on the name of the Body or Part
under Geometry in the Tree View.
Why do I get Messages About Disk Space when I Have Plenty of Space in my
Project Directory?
The meshers work in a temporary directory before writing the CFX-Pre Mesh File back into the project directory.
If the temporary directory does not have enough disk space then they cannot complete.
The temporary directory is specified on starting CFX-Mesh for the first time by the TEMP environment variable,
or, if this environment variable is not set, by TMP or TMPDIR, or if neither of these are set, the directory used is
C:\Temp (Windows) or /tmp (UNIX). After the first start-up of CFX-Mesh the temporary directory location is stored
in the CFX-Mesh preferences and these environment variables will not be looked at again unless the stored
temporary directory no longer exists.
You can change the temporary directory by selecting Tools>Options>CFX-Mesh>Miscellaneous from anywhere
in ANSYS Workbench, and setting an appropriate value for Folder for Temporary Files.
You should never rename any of these files except by using the Project Page in ANSYS Workbench. If you need
to contact customer support then all of the files (except the .gtm) must be provided to allow your problem to
be reproduced.
• The location of an Inflated Boundary must not be contained in any other Inflated Boundary or any Periodic
Pair or Extruded Periodic Pair.
• The location of a Periodic Pair must not be contained in any Inflated Boundary or any other Periodic Pair.
• The location of an Extruded Periodic Pair must not be contained in any Inflated Boundary.
• The location of a Composite 2D Region must not be contained in any other Composite 2D Region.
• The location of a Face Spacing must not already be contained in any other Face Spacing, except the Default
Face Spacing.
CFX-Mesh allows you to select any combination of locations from the Graphics window and Tree View and then
checks that the selection does not break any of the rules above at the time when you press Apply in the Details
View. If the new selection does break one of the rules, then the new selection will not be applied and the contents
of the Location will remain as they were. So even if it is only one part of the selection that breaks the rules, the
whole new selection will be reverted.
If you have multiple bodies in your geometry, then you should refer to Section : 2D Regions and Faces for more
details on what is valid to apply to 2D Regions which form the two sides of a face.
Edge is Periodic
Face for Edge is Periodic
Face has Less than 2 Edges
Invalid Periodicity in Faces Detected
Matching Periodic CAD Vertices Exceed Tolerance
No Edges Found in Search Box
Summary for CAD quality checking
Storage Allocation Failed
Surface is Parametrically Closed
Surface Mesh has Triangles which are Identical
There was a Problem Converting the Mesher Output into the GTM Database
2 Transformations Specified
Two or More CAD Edges Between Non-inflated Surfaces Meet at a CAD Vertex on an Inflated Surface
The Volume Mesher Cannot Continue. It is Continually Adding and Removing the Same Elements.
Zero Length Vector
Edge is Periodic
If you are using the Section : Advancing Front (AF) Surface Mesher, edges of faces that form closed loops must
not be made up of a single curve. See Section : Closed Faces for help on working around this problem.
This message occurs when the mesher detects a surface which is closed in two directions, such as a torus. This
is invalid geometry. You should eliminate the face referred to, perhaps by splitting it into two parts as suggested
in the error message.
There was a Problem Converting the Mesher Output into the GTM Database
The meshers work in a temporary directory before writing the CFX-Pre Mesh File back into the project directory.
If the temporary directory does not have enough disk space then they cannot complete, and this message is one
indication that this may the problem. You can change the temporary directory by selecting Tools>Options>CFX-
Mesh>Miscellaneous from anywhere in ANSYS Workbench, and setting an appropriate value for Folder for
Temporary Files.
This message can also occur if the meshing fails right at the end, when occasionally the file filename.gtm.lck
(where filename.gtm is the name of the temporary CFX-Pre Mesh File ) is created and not removed. After this
happens, you will not be able to write to that file location again; you will continue to get the same error each
time you try. The workaround in this case is to remove the file filename.gtm.lck manually from the directory.
2 Transformations Specified
This warning occurs when you have two or more Periodic Pairs with different transformations. It is there to warn
you that when more than one transformation is in use, Section : Controls will be mapped according to all of the
transformations, and that this can sometimes result in them being applied in locations that you did not expect.
It is recommended that you check the resulting mesh to ensure that it is all as you intended.
Two or More CAD Edges Between Non-inflated Surfaces Meet at a CAD Vertex
on an Inflated Surface
The situation which leads to this warning message is described in Section : Geometry and Topology for the Faces
of an Inflated Boundary.
In this case the average of the normal created at the point A is zero. This type of geometry is uncommon and
should be avoided when using Inflation.
The Maximum Spacing will be the actual length scale of the mesh all over the region to be meshed, unless it is
overridden as a result of some sort of mesh control, which is used to modify locally the size of mesh elements.
This is particularly beneficial in an area of highly irregular flow or in a local area of interest.
Finally, length scales can be described in two forms. A face length scale is used to describe the size of the triangles
of a two-dimensional surface mesh. A volume length scale is used to describe the size of volume elements of a
three-dimensional volume mesh.
The following points should be considered and noted as good meshing practice:
• The length scale you use should reflect the features of the flow you wish to model. It is important to resolve
geometric features that affect the flow with adequate mesh resolution.
• If the size of the geometric features vary significantly, then you will require local control over the mesh.
It is recommended that you use at least 10 elements across any features of interest.
• For the highest accuracy, you should generally seek a mesh-independent solution, which means that the
results of your simulation do not change by reducing the mesh length scale. You can approach this by
gradually decreasing the Maximum Spacing of your mesh (and that of any Controls or Face Spacings applied
to it) and comparing solutions. A straightforward way to do this is to use the Section : Global Mesh Scaling.
Mesh independence means that errors due to the scale of the mesh affecting the computed results have
been eliminated. In the majority of industrial simulations, mesh independent solutions cannot be achieved
due to limits of available memory and computing power. For these simulations, it is still sensible to perform
simulations for two or more mesh sizes in order to be able to make some estimate of the accuracy of the
solution.
Pro/ENGINEER..................................................................................................................... 5–14
Solid Edge ............................................................................................................................. 5–16
SolidWorks............................................................................................................................ 5–17
STEP ................................................................................................................................................ 5–17
Unigraphics ........................................................................................................................... 5–18
Troubleshooting ............................................................................................................................... 6–1
Problem Situations .................................................................................................................. 6–1
A Load Transfer Error Has Occurred. ....................................................................................... 6–1
Although the Solution Failed to Solve Completely at all Time Points. ................................................. 6–1
An Error Occurred Inside the SOLVER Module: Invalid Material Properties .............................................. 6–2
An Error Occurred While Starting the ANSYS Solver Module .................................................................... 6–3
An Internal Solution Magnitude Limit Was Exceeded. ........................................................................ 6–3
An Iterative Solver Was Used for this Analysis .......................................................................... 6–4
Assemblies Missing Parts ........................................................................................................ 6–4
CATIA V5 and IGES Surface Bodies ........................................................................................ 6–5
Illogical Reaction Results......................................................................................................... 6–5
Large Deformation Effects are Active ....................................................................................... 6–5
One or More Contact Regions May Not Be In Initial Contact ...................................................................... 6–5
One or more contact regions using MPC formulation may have conflicts ........................................... 6–6
One or More Parts May Be Underconstrained .......................................................................... 6–6
Problems Unique to Asynchronous Solutions ........................................................................... 6–6
Problems Using Solution ......................................................................................................... 6–8
Running Norton AntiVirusTM Causes Simulation to Crash ........................................................................ 6–9
The Correctly Licensed Product Will Not Run ........................................................................... 6–9
The Deformation is Large Compared to the Model Bounding Box ...................................................... 6–9
The Initial Time Increment May Be Too Large for This Problem ................................................................ 6–9
The License Manager Server Is Down .................................................................................... 6–10
The Solution Combination Folder ........................................................................................... 6–10
The Solver Engine was Unable to Converge........................................................................... 6–11
The Solver Fills My Disk With Temporary Files ....................................................................... 6–11
Unable to Find Requested Modes .......................................................................................... 6–11
CAD Related Troubleshooting ............................................................................................... 6–12
I. Appendices
List of Figures
1. A Worksheet Tab View of a Geometry Folder .................................................................................................. 3–22
1. Annotation of a force on a surface ............................................................................................................. 4–15
2. Max and Min annotations and two probe annotations: ............................................................................. 4–17
3. Racetrack Coil Configuration ........................................................................................................................... 4–49
4. Circular Coil ...................................................................................................................................................... 4–50
5. 1/4 Symmetry Model of Actuator ............................................................................................................... 4–51
6. Symmetry Mesh for Actuator with Full Winding Conductor ...................................................................... 4–52
7. Example of Report ......................................................................................................................................... 4–138
List of Tables
1. Available Capabilities by License ..................................................................................................... 3–1
1. A Model Transferred to ANSYS ..................................................................................................... 4–71
Note — If you are familiar with ANSYS commands, you can use Commands objects.
Are you new to Simulation? If so, we encourage you to study the walkthrough example of a basic structural
static simulation presented later in this Simulation Approach section. In addition to showing a real world imple-
mentation of the overall Simulation steps presented above, this example includes showing some of the basic
features of Simulation that are used in all simulation types. Study this walkthrough example even if your main
interest is in a simulation type other than structural static.
Simulation Types
The following simulation types are available. The overall steps presented under Simulation Approach are used
in all types with some variations. The primary differences are in the specific types of loads and results you use,
as described below.
• Structural - Use global and structural loads to produce a variety of structural results. By default, 3-D
structural simulations are performed. You can configure Workbench for a 2-D structural simulation. Non-
linear structural simulations are also realizable. The following specialized structural simulations are available:
– Static - Use when loads are constant for individual sets of results. Typical applications include determ-
ining safety factors, stresses and deformation for a body or assembly under structural loading. A Stress
Simulation wizard is available in the product as well as a walkthrough example in the Simulation Help.
– Sequenced - Use when loads vary or for reviewing individual stages of results. The Stress Simulation
wizard mentioned above for static structural simulations can be used. A walkthrough example of a
sequenced simulation is available in the Simulation Help.
– Harmonic - Use for sustained cyclic loads that produce a sustained cyclic or harmonic response. The
Stress Simulation wizard mentioned above for static structural simulations can be used. Before ap-
plying loads, set the drop down menu to Harmonic in the Environment context toolbar. Then use
the Harmonic Tool to assist you with the simulation. The Harmonic Tool is available from the Solution
context toolbar under the Tools drop down menu.
– Fatigue - Use to simulate performance under anticipated cyclic loading conditions over the life span
of the product or structure you are modeling. Specifically, a fatigue simulation determines the life and
safety factor for a body or assembly under fatigue loading. A Fatigue Simulation wizard is available
in the product along with a Fatigue Tool to assist you with the simulation. The Fatigue Tool is available
from the Solution context toolbar under the Tools drop down menu. See Section : Fatigue Overview
in the Simulation Help for more information.
– Frequency (Modal) - Use to determine the natural frequencies for a body or assembly. A Frequency
Simulation wizard is available in the product along with a Frequency Finder to assist you with the
simulation. The Frequency Finder is available from the Solution context toolbar under the Tools
drop down menu.
– Buckling - Use to simulate a sudden large deformation of a structure due to an increase of an existing
load. The Stress Simulation wizard mentioned above for static structural simulations can be used. In
addition, use the Buckling Tool to assist you with the simulation. The Buckling Tool is available from
the Solution context toolbar under the Tools drop down menu.
– Shape Optimization - Use to determine efficient ways to reduce the weight of a body or assembly.
A Shape Optimization wizard is available in the product along with a Shape Finder to assist you with
the simulation. The Shape Finder is available as a button in the Solution context toolbar.
• Thermal - Use to determine thermal results for a body or assembly under thermal loading. By default, 3-
D thermal simulations are performed. You can configure Workbench for a 2-D thermal simulation with
provisions.
– Static - Use when thermal loads are constant for individual sets of results. Typical applications include
determining temperature or heat flux for a body or assembly under thermal loading. A Thermal
Simulation wizard is available in the product.
– Transient - Use when thermal solutions vary with time, typically occurring with time-varying loads
and/or boundary conditions. The Thermal Simulation wizard, mentioned above for static simulations
can be used. A walkthrough example of a thermal transient simulation is available in the Simulation
Help.
• Electromagnetic - Use to determine electromagnetic results for a body or assembly with electromagnetic
loads. An Electromagnetic Simulation wizard is available in the product. Electromagnetic simulations
are available only in 3-D. A walkthrough example of an electromagnetic simulation is available in the
Simulation Help.
Presented below is an example structural static simulation of a 12-part control arm assembly used in a race car.
The assembly is made of structural steel and the objective is to determine if using a lighter material, such as
aluminum, will preserve the structural integrity of the assembly under the rigors of its operating environment.
• The end cylinders are fixed except for being free to rotate in the tangential direction.
• The back surfaces at the top are constrained from moving in the normal direction.
• A constant downward force of 4450 N (~1000 lbf) is applied to the top surface.
Two simulation scenarios are examined where the assignment of material is the only difference between the
two. Maximum Equivalent Stress Safety Factors for each scenario are compared to determine how strong the
designs are relative to material yield.
This example makes use of the Simulation Wizard for many of the actions associated with the overall tasks.
The following procedure illustrates the structural simulation after the model is constructed in a supported CAD
system.
Task Action
1. Open the DesignModeler geo- Browse ... to one of the following:
metry database file.
• Windows platform:
• Unix platform:
.../ansys_inc/v100/aisol/Samples/Simulation/ControlArm.agdb
Task Action
2. Move geometry into Simulation. • Click on the [Project tab] to leave DesignModeler and go to the Work-
bench Project Page.
• Click on New Simulation.
• After geometry appears in Simulation, ensure Units> Metric (m, kg, N,
°C, s, V, A) is checked.
3. Examine contact regions in the • Close the Simulation Wizard panel that is displayed on the right. We
control arm assembly. will use the wizard in the next step.
The following is an animated GIF. Please view online if you are reading the
PDF version of the help.
4
Section : Structural Static Simulations
Task Action
4. Open the Simulation Wizard. • Click the Simulation Wizard button in the toolbar (green checkmark
icon). The Simulation Wizard appears on the right.
Note — Under Required
Steps in the Simulation
Wizard are the overall
ordered simulation steps.
An adjacent green check
indicates the task is com-
plete. A yellow “X” indic-
ates that the task requires
an input. A green “i” indic-
ates the task has required
information, such as a
default value. Choosing a
task with an adjacent “i”
allows you to quickly
change that default value.
The wizard is fully custom-
izable to facilitate specific
in-house procedures.
5. Assign structural steel as materi- • In Simulation Wizard, Required Steps = Verify Materials.
al.
A flashing callout balloon shows you where and how to verify or change
the material. The default material is Structural Steel.
Task Action
6. Insert supports.
6
Section : Structural Static Simulations
• Select (click) the two end cylinders (use the [Ctrl] key for multiple selec-
tion).
Note — You can also add loads and supports by using a right
mouse button click on the Environment folder in the Outline,
and choosing Insert > load or support from the context menu.
8
Section : Structural Static Simulations
Task Action
7. Insert load. • In Simulation Wizard, Required Steps = Insert Loads.
• Reorient the assembly and select the face as shown.
– Define By = Components.
– Z Component = -4450.
• [Enter].
Task Action
8. Capture environment. After • In Outline, click on the Environment folder.
“staging” the model by rotating it
• Orient display so that all three load and support labels are visible as
to a particular perspective and in- shown.
cluding labels, you can use the
Figure toolbar button to capture
snapshots for later presentation in
the report.
10
Section : Structural Static Simulations
Task Action
10. Obtain solution. • In Simulation Wizard, Required Steps = Solve.
• Click the Solve toolbar button. You will see progress bars during the
solution.
The solution is complete when you see a green check mark adjacent to
the Solution folder in the Outline.
Task Action
11. Review results and capture
picture for report.
12
Section : Structural Static Simulations
The following is an animated GIF. Please view online if you are reading the PDF
version of the help.
The following is an animated GIF. Please view online if you are reading the
PDF version of the help.
Task Action
12. Examine Safety Factor and • In Outline, under the Solution folder, expand Stress Tool (+) and click
capture picture for report. on Safety Factor.
14
Section : Structural Static Simulations
Task Action
13. Duplicate simulation for Safety • In Outline, collapse the Model folder (-).
Factor comparison. This will pre-
• In Simulation Wizard, Advanced Tasks = Compare Models.
serve the original simulation and
geometry for comparison.
14. Assign Aluminum Alloy as ma- • In Outline, click on the Model2 folder.
terial.
• In Simulation Wizard, Required Steps = Verify Materials.
• Under Details of “Multiple Selection”, set Material = Import.
• Under Material Data to Import, choose Aluminum Alloy.
• Click OK.
Task Action
16. Compare Safety Factors of both • In Outline, under the Model2 folder, expand Environment (+).
simulations and include picture for
• Under the Environment folder, expand Solution (+).
report.
• Under the Solution folder, expand Stress Tool (+).
• Click on Safety Factor.
Using Aluminum, the Safety Factor is well within the acceptable minim-
um value, while the weight of the assembly has been reduced to almost
1/3 the weight of the original Structural Steel design. Reducing weight
is a critical consideration in automotive racing.
• Click the Figure toolbar button.
Note — For more model and report screen space, you can deactivate
the SimulationWizard panel by clicking the “X” in the upper right
corner of the panel. You can reactivate it at any time by clicking the
green check toolbar button.
Sequenced Simulations
A sequenced simulation is recommended for simulating varying structural load applications or for reviewing
individual stages of results. In a sequenced simulation, you can define each load condition as an independent
16
Section : Sequenced Simulations
load step. Upon solving, final results are available from the last load step as well as from any of the intermediate
load steps.
When the number of sequence steps is greater than 1, a Timeline controller and Tabular Data window
appear as shown below:
Note — The management of these windows (for example, repositioning) differs on Windows
platforms vs. Unix platforms.
You use the Timeline controller to select which load step you will be defining or modifying, or which
load step's results you want to display. The Timeline controller also displays the magnitude of the loads.
3. Apply the loads for each step.
Note — If you use a Displacement in a sequenced simulation, the degrees of freedom used must
not change, although the component values can change.
Inserting a load under the Environment updates the Tabular Data window with a grid to enable you
to enter data on a per-step basis. As you enter the data, the values are reflected in the Timeline controller,
also on a per-step basis.
A check box is available for each component of a load in order to turn on or turn off the viewing of the
load in the Timeline controller display. Components are color-coded to match the component name in
the Tabular Data widow. Clicking on a step value in the Tabular Data window or selecting a step value
in the Timeline controller will update the display in the upper left corner of the Graphics window with
the appropriate step number and load data.
To select a step value in the Timeline controller, hover the mouse over the step until a circle cursor appears
then click on that location. The selected step number appears bolded, as shown in the following example:
To select step 3, hover mouse until circle cursor ap- Step 3 is selected.
pears, then click.
The following options are also available in a context menu that displays when you click the right mouse
button within the Timeline controller and/or the Tabular Data widow:
• Retrieve Results: Retrieves and presents the results for the object at the selected step.
• Insert Step: Inserts a new step before the currently selected step in the Timeline controller or Tab-
ular Data window. The values from the current step will be copied to the new step. All load objects
in the Environment will be updated with a new step.
• Cut Step: Deletes a step, but retains the information in a buffer for subsequent use in the Paste Step
After option.
• Paste Step After: Takes step information in the buffer (resulting from Copy Step or Cut Step) and
pastes the step after the currently selected (highlighted) step.
• Copy Step: Copies single step information into a buffer. Use in conjunction with Paste Step After
to duplicate load step information from one step number to another.
• Cut Cell: Clears the entries for selected cells.
• Copy Cell: Copies the cell data into the clipboard for a selected cell or group of cells. The data may
then be pasted into another cell or group of cells. The contents of the clipboard may also be copied
into Microsoft Excel. Cell operations are only valid on load data and not data in the Step column.
• Paste Cell: Pastes the contents of the clipboard into the selected cell, or group of cells. Paste operations
are compatible with Microsoft Excel.
• Select All: Selects all cells in the Tabular Data window.
• Delete Step: Removes the selected step from the sequence. The step will be removed from all load
objects in the multistep environment.
• Zoom to Range: Zooms in on a subset of the data in the Timeline controller. Click and hold the left
mouse at a step location and drag to another step location. The dragged region will highlight in blue.
Next, select Zoom to Range. The chart will update with the selected step data filling the entire axis
range.
• Zoom to Fit: If you have chosen Zoom to Range and are working in a zoomed region, choosing
Zoom to Fit will return the axis to full range covering all steps.
4. Select result items. You can associate a result item with a particular load step by highlighting the result
item and then specifying the Sequence Number in the Details View for that result.
Note — If you insert a Commands object under an Environment or Solution object, a Sequence
Selection Mode control is available in the Details View of the Commands object. Use this control
to specify which sequence steps are to process the Commands object.
5. Solve. If a sequenced simulation fails to solve completely, Simulation includes a feature that allows you
to recover partially solved or unconverged results.
6. Review Results. After a solution is completed, click on the results object in the Tree. The Timeline con-
troller and Tabular Data window appear. Result data is charted in the Timeline controller and listed in
the Tabular Data window. The result data includes the Maximum and Minimum values of the results
object over the steps.
To view the results in the Graphics window for the desired step, select the step in the Timeline controller
or Tabular Data window, then click the right mouse button and choose Retrieve Results. The Details
View for the chosen result object will also update to the selected step.
Presented below is an example of a sequenced simulation that involves the successive application of three bolts
to a flange assembly. The bolts are shown below along with the Fixed Support that is applied to the inner tube.
The goal of the simulation is to examine the Total Deformation resulting after tightening the first bolt, then the
second bolt, then the third bolt. A sequenced simulation is the ideal approach for this problem.
Three load steps are planned with each step defining a specific combination of bolt status for the three bolts.
The bolt status for each load step is shown in the following table.
Bolt Status
Load Step 1: Only first bolt is Load Step 2: Only first and Load Step 3: All bolts are
tightened. second bolts are tightened. tightened.
First Bolt Load Lock Lock
Second Bolt Open Load Lock
Third Bolt Open Open Load
Task Action
1. Open the DesignModeler geo- Browse ... to one of the following:
metry database file.
• Windows platform: ...\Program Files\ANSYS
Inc\v100\AISOL\Samples\Simulation\Bolts.agdb
• Unix platform: .../ansys_inc/v100/aisol/Samples/Simulation/Bolts.ag-
db
2. Move geometry into Simulation. • Click on the [Project tab] to leave DesignModeler and go to the Work-
bench Project Page.
• Click on New Simulation.
To match the layout in the picture above, click on the Rotate button in
the toolbar.
• Ensure Units> Metric (m, kg, N, °C, s, V, A) is checked.
Task Action
4. Apply Bolt load to the first bolt. • On the assembly, click on the cylindrical surface representing the first
bolt.
• From the Environment context toolbar, choose Bolt from the Structural
drop down menu.
Task Action
5. Apply Bolt load to the second
and third bolts.
Task Action
6. Add fixed support. • Click on the inner tube of the assembly.
• From the Environment context toolbar, choose Fixed Support from
the Structural drop-down menu.
Task Action
8. Set loading conditions for the • Click on Bolt 2 in the tree.
second bolt that represent all
• Enter the following load information into the Tabular Data window:
steps.
– Step 1 = Open
– Step 2 = Load; 10000
– Step 3 = Lock
– Step 1 = Open
– Step 2 = Open
– Step 3 = Load; 10000
10. Review the details of the load You can make any data changes directly in the Tabular Data window. In addi-
step information. tion to the graphical display in the Timeline controller of loads vs. steps for
the highlighted load, you can click on Environment, then on the Worksheet
tab to display reaction forces.
11. Select result item for load step • In Outline, click on the Solution folder.
1.
• From the Solution context toolbar, choose Total from the Deformation
drop down menu.
• Select 1 for the Sequence Number in the Details View.
12. Select result item for load step • Repeat step 11 but select 2 for the Sequence Number in the Details
2. View of Total Deformation 2.
13. Select result item for load step • Repeat step 11 but select 3 for the Sequence Number in the Details
3. View of Total Deformation 3.
Task Action
14. Solve the simulation. • Click on Solve in the toolbar.
15. Review result of load step 1. • Click on Total Deformation in the tree.
(Your results may vary from what Total Deformation when only the first bolt is tightened:
is shown for the 3 steps.)
16. Review result of load step 2. • Click on Total Deformation 2 in the tree.
Total Deformation when only the first and second bolts are tightened:
Task Action
17. Review result of load step 3. • Click on Total Deformation 3 in the tree.
4. Enter the end time (in seconds) in the End Time field. The beginning time is assumed to be 0.0 seconds
so the end time must be greater than 0.0 seconds.
5. Specify the initial temperature in the Details View of the Initial Condition object.
• To specify a uniform temperature across the model, set Initial Temperature to Uniform Temperature,
then set Initial Temperature Value to the desired value.
• To specify a non-uniform temperature from another environment, set Initial Temperature to Non-
Uniform Temperature, then set Initial Condition Environment to the name of a static environment.
The temperature solution from this environment will be used as the initial condition.
Note —
– If the environment that includes the non-uniform temperature does not exist (for example,
if the environment was deleted), the Initial Condition object changes to the underdefined
state.
– Convergence objects inserted under an environment that is referenced by an Initial
Condition object will invalidate the Initial Condition object, and not allow a solution to
progress.
TIP: If you already have a steady state environment set up in Simulation and you want to use the results
from this environment as the initial condition for a subsequent transient analysis, a short cut is available.
To generate the new environment, click the right mouse button on the Temperature result and choose
Generate Transient Environment with Initial Condition from the context menu. All loads and supports
from the original static environment are duplicated in the new transient environment. In the Details
View of the new Initial Condition object, Non-Uniform Temperature is set, and Initial Condition En-
vironment is set to the name of the static environment.
6. Apply thermal loads using the general procedure for applying loads in any simulation with additional
provisions for transient settings as described below. The thermal loads can either be constant (such as
an unchanging Heat Flux or applied Temperature), or tabular (such as Internal Heat Generation from
turning a computer chip on and off for a specified time period).
• To define a constant thermal load, set Define As to Constant in the Details View of the thermal load
and enter a value for the Magnitude.
• To define a time-dependent thermal load, set Define As to Load History in the Details View of the
thermal load and choose one of the following options from the History Data menu:
– New Load History... - Transfers to Engineering Data where you can define a new load history by
entering load values and corresponding time values. The name of the load history appears in the
tree in Engineering Data.
– Import... - Displays a dialog box where you can access existing load history definitions from library
files. Choosing an existing load definition assigns it as part of the load specification.
– Edit <load history name> ... - Transfers to Engineering Data where you can edit the data repres-
enting the load history currently assigned to the part.
When you return to Simulation (click the Simulation tab), the new load history name appears in the
History Data area. The data is charted in the Timeline controller and listed in the Tabular Data
window. The load history data is read-only.
A check box is available for each component of a load in order to turn on or turn off the viewing of
the load in the Timeline controller display. Components are color-coded to match the component
name in the Tabular Data widow. Clicking on a time value in the Timeline controller or Tabular
Data window will update the display in the Graphics window with the appropriate time and load
data.
Note — The management of these windows (for example, repositioning) differs on Windows
platforms vs. Unix platforms.
7. Adjust transient settings (optional). The default settings for a transient simulation will provide accurate
and robust answers for most problems. You can proceed to solving in the next step or you can customize
your transient solution options (especially useful if you are an advanced user) by selecting the Transient
Settings object under Solution. A corresponding Transient Settings worksheet appears. You can make
adjustments directly on this page.
8. Solve. The solution to a transient simulation will typically have multiple result points. This can lead to
large solution result files. Since the potential amount of results is large, only results that you request will
be read into memory. As long as the result file is present, the program can calculate any additional results.
However, if the result file is missing, then any additional results, animation, or using the solution as input
in a coupled environment simulation will require a full solution in order to recreate the result file. In order
to save on disk space, you can control which output types will be put into the result file.
If a transient simulation fails to solve completely, Simulation includes a feature that allows you to recover
partially solved or unconverged results.
9. Review Results. Click on a result object in the tree. The Timeline controller display will show the Maximum
and Minimum values of the result over time. The Tabular Data window lists the time values at which
results were requested (refer to step 7 on transient settings) along with the Maximum and Minimum
values.
• To view the complete results of the result object, click on the first column of the Tabular Data window
at a results time point of interest. Click the right mouse button and choose Retrieve Results from
the context menu. This action will retrieve the results for the object at the selected time point. The
Graphics window will display the results, and the Timeline controller will update the cursor to the
time point. The Details View will be updated to reflect the results at the selected time point.
• To retrieve results at points intermediate to the requested result time points, click on a desired time
in the Timeline controller and choose Retrieve Results. Results will be interpolated from the nearest
result time points and displayed in the Graphics window. The Maximum and Minimum values will
appear in the chart and in the Tabular Data window. The Details View for the result object will also
update to this interpolated time value.
TIP: You may create a static Environment containing the temperature results applied as a Thermal
Condition. The Thermal Condition provides temperatures as a "load" to a static simulation for evaluating
thermal strains. To create a single step simulation, highlight a time point in the Timeline controller or
Tabular Data window, then click the right mouse button and choose Generate Static Environment
with Thermal Condition from the context menu. If several static simulations are required using temper-
ature results from different time points, highlight the multiple time points choose Generate Static En-
vironment with Thermal Condition. A multi-step sequenced static Environment object will be created.
The Worksheet view Thermal Condition load object will reflect the time values at which temperatures
will be applied as thermal loads.
The following options are available in a context menu that displays when you click the right mouse
button within the Timeline controller and/or the Tabular Data widow:
• Retrieve Results: Retrieves and presents the results for the object at the selected time point.
• Generate Static Environment with Thermal Condition: Creates a new static environment that in-
cludes a Thermal Condition load object that is based on the temperature result from a thermal
simulation. The temperature can vary with time. Refer to the TIP above for additional variations.
• Copy Cell: Copies the cell data into the clipboard for a selected cell or group of cells. The data may
then be pasted into another cell or group of cells. The contents of the clipboard may also be copied
into Microsoft Excel. Cell operations are only valid on load data and not data in the Step column.
• Select All: Selects all cells in the Tabular Data window.
• Zoom to Range: Zooms in on a subset of the data in the Timeline controller. Click and hold the left
mouse at a step location and drag to another step location. The dragged region will highlight in blue.
Next, select Zoom to Range. The chart will update with the selected step data filling the entire axis
range.
• Zoom to Fit: If you have chosen Zoom to Range and are working in a zoomed region, choosing
Zoom to Fit will return the axis to full range covering all steps.
The following additional features are available to assist you in reviewing results in a transient simulation:
• Contour Results - Because the simulation is time dependent, part of the definition of a contour result
is to set at which time the result will be calculated. You can set this using the Display Time setting
in the Details View of the result object.
• Animation - A result animation may be useful over the time period of interest.
• Probe Results - A probe result is scoped to a specified region such as an XYZ point (to model a ther-
mocouple for example). The result output can be at a given point in time or across all points in time
(to create a result time history plot of output as a function of time).
• Result Trackers - For a transient simulation, two Temperature Result Tracker objects are provided
under a Solution Information object. As the solution progresses, output will be plotted in real
solution time. The Temperature Result Tracker objects can be scoped either to a vertex or be set
to display global Minimum and Maximum values at a solution point. Note that the output is plotted
for each solution point.
Note — If you request a result before the first solved time point, the result is reported at the first
solved time point. Simulation cannot extrapolate before the first time point. In this case, the
values appearing in the Details View of the result object for Display Time and Time (under In-
formation) may not be in agreement.
Presented below is an example of a thermal transient simulation that examines the overall structural effect on
a circuit board (shown below), resulting from the switching states of computer chips on the board.
A. Thermal Steady State. The goal is to determine the constant steady state temperature that results from
the internal heat generation and convection experienced by the circuit board and computer chips before
the switching of the chips occurs. This steady state temperature will be used as the initial condition for
the thermal transient simulation that follows.
B. Thermal Transient. The goal is to determine the temperature change resulting from the switching states
of two computer chips over a specified time period. The switching of each chip occurs at different times
within the time period. The resulting temperature at the end of the time period will be used as a thermal
condition load that will be applied in the thermal stress simulation that follows.
C. Thermal Stress. The goal is to determine the total deformation and equivalent stress experienced by the
thermal changes in the circuit board and the switching states of the chips.
Task Action
1. Open the DesignModeler geo- Browse ... to one of the following:
metry database file.
• Windows platform: ...\Program Files\ANSYS
Inc\v100\AISOL\Samples\Simulation\BoardWithChips.agdb
• Unix platform: .../ansys_inc/v100/aisol/Samples/Simulation/Board-
WithChips.agdb
Task Action
2. Move geometry into Simulation. • Click on the [Project tab] to leave DesignModeler and go to the Work-
bench Project Page.
• Click on New Simulation.
• To match the layout in the picture above, click on the Rotate button in
the toolbar.
3. Begin thermal steady state simu- • Click right mouse button on Environment.
lation.
• Choose Rename.
• Type Thermal Steady State and press Enter.
• Ensure Units> Metric (m, kg, N, °C, s, V, A) is checked.
Task Action
4. Apply Internal Heat Genera- • Select the computer chip shown below. To select the chip, first click on
tion load to one chip. the Body selection filter toolbar button, then click on the chip. If the
entire board is selected, click on the rear depth picking (stack) indicator
in the lower left to select only the chip.
Task Action
5. Add Convection load represent- • Select the board and all bodies on the board by choosing Edit> Select
ing Stagnant Air - Simplified Case All from the main menu. You know that you have made the correct se-
to entire board. lection if 16 Bodies is displayed at the bottom of the Workbench win-
dow. If it does not, make sure that the Body toolbar button selection
filter is set, then retry the selection.
• Click right mouse button on Thermal Steady State.
• Choose Insert > Convection.
• Set the following in the Details View:
– Define As = Temperature-Dependent
– Correlation = Stagnant Air - Simplified Case (if not already dis-
played, click in the field and choose it from the menu, or choose
Import..., then select it from the dialog box).
– Ambient Temperature = type 23 and press Enter.
The solution is complete when green checks are displayed next to all
of the objects.
Task Action
8. Review result. • Highlight Temperature result.
Task Action
10. Specify an end time of 200 • Highlight the Thermal Transient object.
seconds for the transient simula-
• In toolbar, type 200 in the End Time field and highlight the Initial
tion.
Condition object.
11. Ensure that the Initial Condi- • With the Initial Condition object highlighted, note that the Initial
tion is set to the Thermal Steady Condition Environment field is already set correctly to the Thermal
State environment. Steady State environment. This was a further result of choosing Gen-
erate Transient Environment with Initial Condition in step 8 above.
In general, you can choose (or change) an environment from the drop
down list in this field whose temperature will be set as the initial condi-
tion for the thermal transient simulation. Only those environments that
have a thermal steady state temperature result will be available in the
drop down list.
Task Action
12. Add Internal Heat Generation • Select the computer chip shown below.
load to a chip such that the load
represents the following time his-
tory based on the switching states
of that chip:
0 - 20 sec. = Off
20 - 40 sec. = On
40 - 200 sec. = Off
• After pressing the Enter key followin entry of the last data point, click
the [Simulation] tab at the top to return to Simulation. Note that the
switching curve and data that you just defined are displayed in the
Timeline controller and Tabular Data windows.
Task Action
13. Add Internal Heat Generation • Select the computer chip shown below.
load to a second chip such that the
load represents the following time
history based on the switching
states of that chip:
0 - 60 sec. = Off
60 - 70 sec. = On
70 - 200 sec. = Off
• Click the [Simulation] tab at the top to return to Simulation. Note that
the switching curve and data that you just defined are displayed in the
Timeline controller and Tabular Data windows.
Task Action
14. Note transient settings estab- • Highlight the Transient Settings object. The Transient Settings
lished so far. worksheet displays a summary of your transient settings so far. You
need not make any changes here because all default settings and ad-
justments are acceptable for this simulation.
15. Solve. • Click right mouse button on Solution in Thermal Transient environ-
ment.
• Choose Solve.
The solution is complete when green checks are displayed next to all
of the objects.
Task Action
16. Review results. • Highlight Temperature result.
• Open the Solution Information object and note that there are two
Temperature result tracker objects listed. These represent the Maxim-
um and Minimum temperature results.
• Highlight each result tracker and note the graphical display (Global
Maximum is shown below).
Task Action
17. Probe specific results on each • Highlight Solution object in Thermal Transient environment and select
of the three chips. same chip used in the Thermal Steady State simulation (see step 4).
• Click right mouse button on Solution object.
• Choose Insert> Probe Tool> Probe Tool.
• Select first chip used in the Thermal Transient simulation (see step 12).
• Click right mouse button on Probe Tool.
• Choose Insert> Probe Tool> Probe.
• Select second chip used in the Thermal Transient simulation (see step
13).
• Click right mouse button on Probe Tool.
• Choose Insert> Probe Tool> Probe.
• Click right mouse button on Probe Tool.
• Choose Solve to obtain the probed results.
Task Action
18. Begin thermal stress simulation. • Click right mouse button on Temperature result in Thermal Transient
environment.
• Choose Generate Static Environment with Thermal Condition. Note
that the following occurs as a result of this action:
19. Ensure that the Thermal Con- • Highlight the Thermal Condition object.
dition load is set to the Thermal • Note that the Thermal Environment field is already set correctly to the
Transient temperature at the end
Thermal Transient environment and the Time is set correctly to 200
time of 200 sec. seconds. These were further results of choosing Generate Static Envir-
onment with Thermal Condition in step 17 above. In general, you can
choose (or change) an environment from the drop down list in this field
whose temperature will be set as the Thermal Condition load for a
thermal stress simulation. Only those environments that have a thermal
temperature result will be available in the drop down list. If temperatures
are defined as load histories, a Time field is also included.
Task Action
20. Add Fixed Support constraints • Click on the Face selection filter toolbar button, then select the inside
to each of the holes on the circuit surface of the top hole as shown.
board.
21. Add Equivalent Stress result • Click right mouse button on Solution under Thermal Stress environ-
for the board and the board com- ment.
ponents.
• Choose Insert> Stress> Equivalent (von Mises). This result is scoped
to the default selection of All Bodies, as displayed in the Details View
Geometry field.
22. Add Equivalent Stress result • Click the Body selection filter toolbar button, then select the board and
for the board components without all chips by choosing Edit> Select All from the main menu.
the board.
• Unselect the board by holding the Ctrl key while clicking on an empty
region of the board. Ensure that 15 Bodies is displayed at the bottom
of the Workbench window.
• Click right mouse button on Solution under Thermal Stress environ-
ment.
• Choose Insert> Stress> Equivalent (von Mises). Ensure that the Geo-
metry field in the Details View displays 15 Bodies.
23. Solve. • Click right mouse button on Solution in Thermal Stress environment.
• Choose Solve.
The solution is complete when green checks are displayed next to all
of the objects.
Task Action
24. Review results.
Electromagnetic Simulations
An electromagnetic simulation typically involves the Simulation approach (presented above) with some variations.
The main variation is that the geometry must be a single solid body, a single solid multi body part, or a winding
conductor body. Electromagnetic loads are used to produce a variety of electromagnetic results.
Note — The use of pyramid elements in critical regions should be minimized. Pyramid elements are used
to transition from hexagonal to tetrahedral elements. You can eliminate pyramid elements from the
model by specifying All Tetrahedrons using a Method mesh control tool.
The following problem consists of simulating the performance of the solenoid actuator shown below.
The CAD model is a 1/4 symmetry view of the system, which includes a moving armature, a yoke, and a wound
coil (represented by a line body). The objective of the simulation is to compute the force on the armature, the
inductance of the coil, and the flux linking the coil.
The coil is a wound structure consisting of 100 turns, carrying 10 amps per turn. The coil is modeled using a
winding body. The original CAD model includes a line body that represents the centerline of the coil.
• In DesignModeler, promote the line body to a winding body, and supply the coil cross-section information
and number of turns.
• In DesignModeler, provide an enclosure for the model that simulates the surrounding air domain.
• In Simulation, set up the boundary conditions, specify the results quantities, and simulate the performance
of the actuator.
After the CAD model is prepared in DesignModeler, the following procedure illustrates the electromagnetic
simulation.
Task Action
1. Open the DesignModelergeo- • Browse ... to one of the following:
metry database file.
Windows platform:
.../ansys_inc/v100/aisol/Samples/Simulation/ActuatorDemo.agdb
2. Promote the line body to a • In the Modeling tab, expand the Parts/Bodies folder and click on Line
winding body. Body.
• Under Details of Line Body, set the following:
Task Action
3. Define enclosure with two sym-
metry planes.
• Tools> Enclosure.
• Under Details of Enclosure1, set the following:
– Shape = Box
– Number of Planes = 2 (for 2 symmetry planes).
– Symmetry Plane1: click on field, click ZXPlane in the Modeling
tab, then [Apply].
• [Generate].
Task Action
4. Move geometry into Simulation. • Click on the [Project] tab to leave DesignModeler and go to the Work-
bench Project Page.
• Click on New Simulation.
• To match the layout in the picture above, click on the Rotate button in
the toolbar.
5. Define material properties. • In Outline, expand the Model folder, then expand the Geometry folder
down to the Part level, and click on armature.
• Under Details of “armature”, accept the default of Material = Struc-
tural Steel.
Task Action
6. Define coil current. • In Outline, under the Environment folder, click on Conductor Winding
Body.
• Under Details of “Conductor Winding Body”, set Conductor Current
= 10 A.
Task Action
7. Apply flux parallel boundary
condition.
• Right mouse click on Magnetic Flux Parallel in the Outline, then click
on Duplicate.
• Repeat the procedure above for Under Details of “Magnetic Flux
Parallel”, but set Named Selection = Symmetry:YZPlane.
• Right mouse click on Magnetic Flux Parallel 2 in the Outline, then click
on Duplicate.
• Repeat the procedure above for Under Details of “Magnetic Flux
Parallel”, but set Named Selection = Symmetry:ZXPlane.
Task Action
8. Add a picture of the boundary • In Outline, click on the Environment folder.
conditions for publishing in the
report.
• From the Standard toolbar, click on the Figure button to add this picture.
Task Action
9. Select solution results. • In Outline, click on the Solution folder.
• From Electromagnetic toolbar drop-down menu, click on Total Flux
Density.
• Repeat above for Total Field Intensity, Inductance, Flux Linkage, and
Directional Force/Torque.
• Under Details of “Directional Force/Torque”, set Orientation = Y
Axis.
• From the Graphics Toolbar, click the Body selection button.
• Click on armature body in the Geometry window as shown below.
• In the Details View, click in the Geometry field, then click Apply.
Task Action
11. Review results and add result
pictures for publishing in the re-
port.
• In Outline, click on Total Field Intensity. Note the field in the air gap
region.
• From the Standard toolbar, click on the Figure button to add this picture.
• In Outline, expand the Model folder, the Geometry folder and the Part
folder, then right mouse click on Solid and chose Hide Body to hide
the enclosure body.
• In Outline, click on Total Flux Density.
• From the Standard toolbar, click on the Figure button to add this picture.
• In Outline, click on Directional Force/Torque, then note the Sum value
under Details of “Directional Force/Torque”, and the result plot. The
Sum value equals 1/4 the total force on the armature because a quarter
symmetry model was used.
• From the Standard toolbar, click on the Figure button to add this picture.
• In Outline, click on Inductance.
• Under Details of “Inductance”, then under Symmetry, set Multiplier
= 4 and note the result in the Worksheet tab.
Task Action
12. Create a report. • Click on the Report Preview tab.
• Scroll down and click [Generate Report].
2-D Simulations
Simulation has a provision that allows you to run structural and thermal problems that are strictly two -dimen-
sional (2-D). For models and environments that involve negligible effects from a third dimension, running a 2-D
simulation can save processing time and conserve machine resources.
You can configure Workbench for a 2-D simulation by first creating or opening a surface model in DesignModeler,
or in any supported CAD system that has provisions for surface bodies (Autodesk Mechanical Desktop and
Autodesk Inventor do not support surface bodies). The model must be in the x-y plane. 2-D planar bodies are
supported, 2-D wire bodies are not. Then, on the Project Page, choose 2-D in the Analysis Type drop-down
menu located under Advanced Geometry Defaults, and attach the model into Simulation. You can specify a
2-D simulation only when you attach the model. After attaching, you cannot change from a 2-D simulation to a
3-D simulation or vice versa.
• For Geometry items in the tree, you have the following choices located in the 2D Behavior field within
the Details View:
– Plane Stress (default): Assumes zero stress and non-zero strain in the z direction. Use this option for
structures where the z dimension is smaller than the x and y dimensions. Example uses are flat plates
subjected to in-plane loading, or thin disks under pressure or centrifugal loading. A Thickness field
is also available if you want to enter the thickness of the model.
– Axisymmetric: Assumes that a 3-D model and its loading can be generated by revolving a 2-D section
360o about the y-axis. The axis of symmetry must coincide with the global y-axis. The geometry has
to lie on the positive x-axis of the x-y plane. The y direction is axial, the x direction is radial, and the z
direction is in the circumferential (hoop) direction. The hoop displacement is zero. Hoop strains and
stresses are usually very significant. Example uses are pressure vessels, straight pipes, and shafts.
Axisymmetric behavior cannot be used in a shape simulation.
– Plane Strain: Assumes zero strain in the z direction. Use this option for structures where the z dimension
is much larger than the x and y dimensions. The stress in the z direction is non-zero. Example uses are
long, constant, cross-sectional structures such as structural beams. Plane Strain behavior cannot be
used in a thermal simulation or a shape simulation.
Note — Since thickness is infinite in plane strain calculations, different results (displace-
ments/stresses) will be calculated for extensive loads (that is, forces/heats) if the solution is
performed in different unit systems (MKS vs. NMM). Intensive loads (pressure, heat flux) will
not give different results. In either case, equilibrium is maintained and thus reactions will not
change. This is an expected consequence of applying extensive loads in a plane strain analysis.
In such a condition, if you change the Simulation unit system after a solve, you should clean
the result and solve again.
– Generalized Plane Strain: Assumes a finite deformation domain length in the z direction, as opposed
to the infinite value assumed for the standard Plane Strain option. Generalized Plane Strain provides
more practical results for deformation problems where a z direction dimension exists, but is not con-
siderable. See Section : Using Generalized Plane Strain for more information.
→ Fiber Length: Sets the length of the extrusion when using the Generalized Plane Strain option.
This choice is displayed only if 2D Behavior is set to Generalized Plane Strain.
→ End Plane Rotation About X: Sets the rotation of the extrusion end plane about the x-axis when
using the Generalized Plane Strain option. This choice is displayed only if 2D Behavior is set to
Generalized Plane Strain.
→ End Plane Rotation About Y: Sets the rotation of the extrusion end plane about the y-axis when
using the Generalized Plane Strain option. This choice is displayed only if 2D Behavior is set to
Generalized Plane Strain.
– By Body: Allows you to set the Plane Stress (with Thickness option), Plane Strain, or Axisymmetric
options for individual bodies that appear under Geometry in the tree. If you choose By Body, then
click on an individual body, these 2-D options are displayed for the individual body.
• For a 2-D simulation, use the same procedure for applying loads and supports as you would use in a 3-D
simulation. The loads and results are in the x-y plane and there is no z component.
• You can apply all loads and supports in a 2-D simulation except for the following: Bolt Load, Simply Sup-
ported, Fixed Rotation, and all electromagnetic loads.
• A Pressure load can only be applied to an edge.
• A Bearing Load and a Cylindrical Support can only be applied to a circular edge.
• For simulations involving plane stress and plane strain behavior, a Rotational Velocity load can be applied
about an individual x, y, or z-axis. Combinations of x and y components can be applied, but combinations
of x and z components, and combinations of y and z components cannot be applied.
• For simulations involving axisymmetric behavior, a Rotational Velocity load can only be applied about
the y-axis.
• For loads applied to a circular edge, the direction flipping in the z axis will be ignored.
to the infinite value assumed for standard plane strain. It provides a more efficient way to simulate certain 3-D
deformations using 2-D options.
The deformation domain or structure is formed by extruding a plane area along a curve with a constant curvature,
as shown below.
The extruding begins at the starting (or reference) plane and stops at the ending plane. The curve direction along
the extrusion path is called the fiber direction. The starting and ending planes must be perpendicular to this
fiber direction at the beginning and ending intersections. If the boundary conditions and loads in the fiber dir-
ection do not change over the course of the curve, and if the starting plane and ending plane remain perpendic-
ular to the fiber direction during deformation, then the amount of deformation of all cross sections will be
identical throughout the curve, and will not vary at any curve position in the fiber direction. Therefore, any de -
formation can be represented by the deformation on the starting plane, and the 3-D deformation can be simulated
by solving the deformation problem on the starting plane. The Plane Strain and Axisymmetric options are
particular cases of the Generalized Plane Strain option.
All inputs and outputs are in the global Cartesian coordinate system. The starting plane must be the x-y plane,
and must be meshed. The applied nodal force on the starting plane is the total force along the fiber length. The
geometry in the fiber direction is specified by the rotation about the x-axis and y-axis of the ending plane, and
the fiber length passing through a user-specified point on the starting plane called the starting or reference
point. The starting point creates an ending point on the ending plane through the extrusion process. The
boundary conditions and loads in the fiber direction are specified by applying displacements or forces at the
ending point.
The fiber length change is positive when the fiber length increases. The sign of the rotation angle or angle change
is determined by how the fiber length changes when the coordinates of the ending point change. If the fiber
length decreases when the x coordinate of the ending point increases, the rotation angle about y is positive. If
the fiber length increases when the y coordinate of the ending point increases, the rotation angle about x is
positive.
For buckling and modal simulations, the Generalized Plane Strain option usually reports fewer Eigenvalues
and Eigenvectors than you would obtain in a 3-D analysis. Because it reports only homogenous deformation in
the fiber direction, generalized plane strain employs only three DOFs to account for these deformations. Th e
same 3-D analysis would incorporate many more DOFs in the fiber direction.
Because the mass matrix terms relating to DOFs in the fiber direction are approximated for modal and transient
analyses, you cannot use the lumped mass matrix for these types of simulations, and the solution may be slightly
different from regular 3-D simulations when any of the three designated DOFs is not restrained.
Note — The Generalized Plane Strain load is applied to all bodies. There can be only one Gen-
eralized Plane Strain load per Environment so this load will not be available in any of the load
drop-down menu lists if it has already been applied.
6. In the Details View, input the x and y coordinates of the reference point , and set the boundary conditions
along the fiber direction and rotation about the x and y-axis.
7. Add any other loads or boundary conditions that are applicable to a 2-D model.
8. Solve. Reactions are reported in the Details View of the Generalized Plane Strain load.
9. Review results.
Coupled Environments
Many times the analysis of a phenomenon involves more than one type of solution. Typical examples of these
so called coupled environments include thermal-stress, pre-stress modal, and fluid-structure interactions. Simulation
will implicitly determine a coupled environment depending on how the environment is defined.
Presented below is a list of the available coupled analysis types and how Simulation determines a given type.
The Analysis Type is reported as a read-only indication in the Details View of the Solution object.
• Thermal Stress - There are two methods for defining a coupled thermal stress solution.
– Implicit: Here the program determines the solution is coupled thermal-stress by the presence of thermal
loads and structural results under the same environment. This method is supported for legacy databases
but is not the recommended method.
– Explicit: Here you insert a Thermal Condition load into your structural environment. The thermal
condition may either be a uniform or non-uniform temperature. This is the recommended method as
it clearly shows the coupled phenomenon.
• Thermal Shape - Same conditions as Thermal Stress except for the presence of shape tools instead of
structural results.
• Free Vibration With Pre-Stress (pre-stress modal) - A structural solution is performed followed by a
modal solution (where stress stiffening effects are accounted for in the modal analysis), if structural loads
exist in the environment of a Solution object that includes a Frequency Finder.
• Free Vibration With Thermal Pre-Stress - Here, three individual solutions are performed in the following
order: thermal solution, followed by a structural solution, followed by a modal solution.
• Fluid-Structure Interaction (FSI) - This feature enables you to import fluid forces from a steady-state or
transient CFD analysis performed using ANSYS CFX, into Simulation. This one way transfer of surface forces
at a fluid-structure interface allows you to investigate the effects of fluid flow on a structure's deformation
and stresses.
Note — When mapping ANSYS CFX results onto the Simulation face(s) the Simulation nodes are projected
on to the ANSYS CFX surface. All Simulation face nodes will map to the ANSYS CFX surface according to
the following rules:
Rule c. will always work, so in the end every node will get some kind of mapping. However the most ac-
curate load mapping occurs for nodes projected normal to the mesh face. The percentage of Simulation
nodes that mapped successfully using rule a. above is reported in the diagnostics. When the Simulation
mesh is very coarse, there can be some misses near the edges of the ANSYS CFX boundary. However all
nodes become mapped eventually. The accuracy of force transfer improves as the Simulation mesh is
refined.
To provide some feedback on how well the mapped loads match the ANSYS CFX solution, images of
both ANSYS CFX solution and the mapped load values are created. In addition a CFX Load Transfer
Summary is also created that shows the net force on the surface computed in ANSYS CFX and the net
force transferred to the Simulation surfaces.
Note — To use this feature on Unix platforms, you must have run the cfxwbinst script after the ANSYS
CFX installation in order to enable ANSYS CFX in Workbench. This script is provided as part of the
ANSYS CFX installation and details of its use can be found in the ANSYS CFX 10.0 Installation Guide.
1. Select the Simulation model's surfaces on which this load transfer is to occur.
2. Insert a Pressure load in the environment of interest.
3. In the Details View, set Define As to CFX Results.
4. Click the CFX Surface field and choose Import... from the menu.
5. Browse... to choose a CFX Result File (.res). After you specify the .res file, the ANSYS CFX boundary
names (equivalent to Named Selections) are displayed with selection radio buttons, along with the time
points at which results are available.
The selected ANSYS CFX surface solution will be mapped onto the Simulation surfaces on which the
Pressure load is applied. The CFD solution on the selected boundary will be represented as image object(s)
under the Pressure load in the tree.
6. Proceed with solution in Simulation. You can apply other boundary conditions and loads. During the
solution procedure Simulation interacts with CFX-Post to map the ANSYS CFX results onto the Simulation
surfaces. In addition to the images that show the ANSYS CFX mapped loads on the Simulation surfaces,
a CFX Load Transfer Summary is also created as a Comment, which shows the net force on the surface
computed in ANSYS CFX and the net force transferred to the Simulation surfaces.
Note — The force values shown in the CFX Load Transfer Summary should only be used as a
qualitative measure of the load transferred from ANSYS CFX to the Simulation mesh. The closer
the CFX Computed forces are to the Simulation Mapped Forces, the better the mapping. The
actual force transferred to Simulation is reflected in the reaction forces.
Wizards
Wizards provide a layer of assistance above the standard user interface. They are made up of tasks or steps that
help you interpret and work with simulations. Conceptually, the wizards act as an agent between you and the
standard user interface.
Note — Callouts close automatically, or you may click inside a Callout to close it.
Wizards use hyperlinks (versus command buttons) because they generally represent links to locations within
the standard user interface, to content in the help system, or to a location accessible by a standard HTML hyperlink.
The status of each step is taken in context of the currently selected Section : Tree Outline object. Status is con-
tinually refreshed based on the Outline state (not on an internal wizard state). As a result you may:
• Freely move about the Section : Tree Outline (including between branches).
• Make arbitrary edits without going through the wizards.
• Show or hide the wizards at any time.
Wizards are docked to the right side of the standard user interface for two reasons:
• The Section : Tree Outline sets the context for status determination. That is, the wizards interpret the
Outline rather than control it. (The user interface uses a top-down left-right convention for expressing
dependencies.)
• Visual symmetry is maintained.
To close wizards, click the . To show/hide tasks or steps, click the section header. Options for wizards are set
in the Wizard section of the Options dialog box under Simulation.
Simulation Wizard
The Simulation Wizard appears in the right side panel whenever you click the in the toolbar. You can close
the Simulation Wizard at any time by clicking at the top of the panel. To show or hide the sections of steps
in the wizard, click the section header.
When activated, a task navigates to a particular location in the user interface and displays a callout with a message
about the status of the task and information on how to proceed. Activating a task may change your tab selection,
cursor mode, and Section : Tree Outline selection as needed to set the proper context for proceeding with the
task.
You may freely click tasks to explore Simulation. Standard tasks WILL NOT change any information in your simu-
lation.
Callouts close automatically based on your actions in the software. Click inside a callout to close it manually.
Most tasks indicate a status via the icon to the left of the task name. Rest your mouse on a task for a description
of the status. Each task updates its status and behavior based on the current Section : Tree Outline selection and
software status.
Tasks are optional. If you already know how to perform an operation, you don't need to activate the task.
Click the Choose Wizard task at the top of the Simulation Wizard to change the wizard goal. For example, you
may change the goal from Find safety factors to Find fatigue life. Changing the wizard goal does not modify
your simulation.
At your discretion, simulations may include any available feature not covered under Required Steps for a wizard.
The Simulation Wizard does not restrict your use of Simulation.
You may use the Simulation Wizard with databases from previous versions of Simulation.
1.
In Simulation, activate the Simulation Wizard by clicking in the Standard Toolbar, or choose View>
Simulation Wizard in the Main Menu.
2. In the Simulation Wizard, click Choose Wizard.
3. Click the bulleted option to browse for a custom wizard definition.
4. Browse to the wizard XML file that you saved from the Simulation Wizard Editor (step 2 in the first pro-
cedure above).
In addition to the instructions that appear within the Simulation Wizard Editor, a Simulation Wizard Customization
Guide is also available and is accessible from inside the Simulation Wizard Editor.
A complete alphabetical listing of Simulation objects reference pages is included in a later section. To determine
the reference page for an object in a group, consult the group page whose title matches the object, and check
the entry: “Applies to the following objects”.
• Title - For individual object reference pages, the title is the default name of the object as it appears in the
tree. For group reference pages, the title is a name given to the collection of objects represented.
• Object definition - A brief description of the individual object or group of objects.
• License level - The required license level you must have in order to use the object or group of objects.
• Applies to the following objects - Appears only on group reference pages and includes the default name
of all objects represented on the group reference page.
• Tree dependencies - The valid location of the object or group of objects in the tree (Valid Parent Tree
Object), as well as other possible objects that you can insert beneath the object or group of objects
(Valid Child Tree Objects).
• Insertion options - Procedure for inserting the object (individual or one in the group) in the tree. Typically
this procedure includes inserting the object from a context toolbar button or through a context menu
option when you click the right mouse button with the cursor on the object.
• Additional related information - a listing of topics related to the object or object group that are in the
help. Included are links to those topics.
• Tree location graphic - an indication of where the object or group of objects appears in the Simulation
tree.
• Details View - a listing of every setting or indication available in the Details View (located directly beneath
the object tree) for the object. Included are links to more detailed information on an item within the help.
• Relevant right mouse button context menu options - a listing of options directly relevant to the objects
that are available in the context menu through a right mouse click on the object. Included are links to
more detailed information on an item within the help. The options listed are in addition to the options
for inserting child objects from the Insert menu, as well as options that are common to most of the objects
(such as Solve, Copy, Cut, and Delete).
The objects reference is not intended to be your primary source of procedural information for performing simu-
lations -- see the Simulation Approach section for introductory and procedural guidelines concerning when and
where to use the Simulation objects.
Page Listings
The following is an alphabetical listing of object reference pages:
Alert
Body
Commands
Comment
Contact
Contact Region
Convergence
Coordinate System
Coordinate Systems
Environment
Figure
Geometry
Global Coordinate System
Initial Condition
Loads and Supports (Group)
Mesh
Mesh Control Tools (Group)
Model
Named Selections
Parameter Manager
Part
Point Mass
Project
Result Tracker
Results and Result Tools (Group)
Solution
Solution Combination
Solution Information
Spot Weld
Transient Settings
Variable Graph
Virtual Cell
Virtual Topology
Alert
Sets pass or fail thresholds for individual results. When a threshold is exceeded, the status symbol changes in
front of the associated result object. The status is also displayed in the Details View of the Alert object. Alerts
facilitate the presentation of comparisons in automatic reports.
Tree Dependencies:
• Insert> Alert
• Click right mouse button on a result object or in the
Geometry window> Insert> Alert.
Results:
Status - Read-only indication of the pass/fail status; also
includes criterion (for example: “Passed: Minimum Above
Value”).
Body
Defines a component of the attached geometry included under a Geometry object (for example, Body 1 in the
figure below), or under a Part object if under a multi body part (for example, Body 2 in the figure below).
Tree Dependencies:
Insertion Options:
• Attaching Geometry
4
Section : Page Listings
Definition:
Suppressed
Brick Integration Scheme
Material
Nonlinear Material Effects
Bounding Box:
Length X
Length Y
Length Z
Commands
Allows use of ANSYS commands or APDL programming in a simulation.
Tree Dependencies:
Insertion Options:
• Commands Objects
6
Section : Page Listings
Input Arguments:
ARG1 through ARG9
Comment
Inserts a comment for a Simulation parent object. The comment editor creates a fragment of HTML, and the
object itself consists of that HTML fragment, a string denoting the author's name, and a color. Report adds the
resulting HTML fragment directly in line, in the specified color and notes the author. The Comment context
toolbar provides buttons to insert various HTML tags as well as buttons for inserting pictures and hyperlinks.
Note — For UNIX versions of Simulation, you must first click the Pencil button before you can edit the
comment. To close the editor, click the Pencil button again.
Tree Dependencies:
Contact
Defines conditions when two or more parts meet. Includes global settings in Details View that apply to all Contact
Region child objects.
Tree Dependencies:
8
Section : Page Listings
Insertion Options:
• Contact Overview
• Contact Region Settings
• Supported Contact Types and Formulations
• Contact Ease of Use Features
• Contact Tool and Results
• Contact Options Preferences
Transparency:
Enabled
Contact Region
Defines conditions for individual contact and target pairs. Several Contact Regions can appear as child objects
under a Contact object.
Tree Dependencies:
Advanced:
Formulation
Interface Treatment
Specify Offset
Normal Stiffness
Normal Stiffness Factor
Update Stiffness
Thermal Conductance
Thermal Conductance Value
Pinball Region
Pinball Radius
Search Direction
10
Section : Page Listings
Convergence
Controls the relative accuracy of a solution by refining solution results on a particular area of a model.
Tree Dependencies:
• Insert> Convergence
• Click right mouse button on a result object or in the
Geometry window> Insert> Alert.
• Convergence
• Error (Structural)
• Error (Thermal)
• Simulation Options - Convergence
Results:
Last Change - Read-only indication of the most recent
change in convergence.
Converged - Read-only indication of the convergence
state (Yes or No).
Coordinate System
Represents a local coordinate system that you can add under a Coordinate Systems object.
Tree Dependencies:
• Coordinate Systems
• Creating Coordinate Systems
Origin Data:
Origin X
Origin Y
Origin Z
Advanced:
Ansys System Number
12
Section : Page Listings
Coordinate Systems
Houses any new coordinate systems that can include a Global Coordinate System object and local Coordinate
System objects.
Tree Dependencies:
• Coordinate Systems
• Creating Coordinate Systems
Environment
Represents the combination of all load and support objects for a given Model object.
Tree Dependencies:
Insertion Options:
Definition:
Reference Temp
Inertia Relief
Figure
Captures any graphic displayed for a particular object in the Geometry window. Popular uses are for presenting
specific views and settings for later inclusion in a report.
Tree Dependencies:
14
Section : Page Listings
• Figures
• Viewports
• Reports
• Usage Example
• Standard Toolbar
Geometry
Represents attached geometry in the form of an assembly or multi body part from a CAD system or from
DesignModeler. The geometry can be updated using the Geometry context toolbar. Assembly parameters, if
available, are viewable under the Geometry object.
Tree Dependencies:
Insertion Options:
• Attaching Geometry
• Model Context Toolbar
• Geometry Context Toolbar
16
Section : Page Listings
Definition:
Source - Read-only indication of the path and file name
associated with the geometry.
Type - Read-only indication of how the original geometry
was created (CAD product name or DesignModeler).
Length Unit - Read-only indication of the length unit
originally assigned to the geometry.
Element Control - Allows manual control of the underly-
ing ANSYS element options (KEYOPTS) for individual Part
or Body objects beneath the Geometry object. To
manually set ANSYS element options, set Element Con-
trol to Manual, then select the Part or Body object. Any
element options that are available for you to manually
set appear in the Details View of the Part or Body object.
For example, the Brick Integration Scheme setting for
a Part or Body object becomes available only when Ele-
ment Control is set to Manual. When Element Control
is set to Program Controlled, all element options are
automatically controlled and no settings are displayed.
The ANSYS equivalent to this setting is the inclusion of
the ETCON,SET command in the input file, which auto-
matically resets options for the 18x series of elements to
optimal settings. Refer to the ANSYS Elements Reference
in the ANSYS Help for more information on ANSYS ele-
ments and element options.
2D Behavior - appears only for a designated 2-D simula-
tion.
Bounding Box:
Length X
Length Y
Length Z
Preferences:
Import Solid Bodies
Import Surface Bodies
18
Section : Page Listings
Tree Dependencies:
Insertion Options:
• Coordinate Systems
• Creating Coordinate Systems
Definition:
Scope Mode
Type
Origin Data:
Origin X
Origin Y
Origin Z
X Axis Data:
Component X
Component Y
Component Z
Y Axis Data:
Component X
Component Y
Component Z
Z Axis Data:
Component X
Component Y
Component Z
Advanced:
Ansys System Number
Initial Condition
For transient simulations, sets the initial temperature to a uniform temperature that you can input, or to a non-
uniform temperature that you can set to refer to thermal results from another environment.
Tree Dependencies:
Insertion Options:
20
Section : Page Listings
Applies to the following objects: Acceleration, Bearing Load, Bolt, Compression Only Support, Conductor,
Convection, Current, Cylindrical Support, Displacement, Fixed Rotation, Fixed Support, Force, Frictionless
Support, Generalized Plane Strain, Heat Flow, Heat Flux, Internal Heat Generation, Magnetic Flux Parallel,
Moment, Perfectly Insulated, Pressure, Radiation, Remote Displacement, Remote Force, Rotational Velocity,
Simply Supported, Standard Earth Gravity, Temperature, Thermal Condition, Voltage
Tree Dependencies:
Insertion Options:
• Applying Loads
• Types of Loads
• Types of Supports
• How to Apply Loads/Supports
• Applying Loads Demonstration
22
Section : Page Listings
Definition:
Define By - specify either Vector or Components (the
choices are different for Bolt). Applicable to Acceleration,
Rotational Velocity, and all structural load objects except
Generalized Plane Strain, Pressure, and Thermal Con-
dition.
Type - Read-only indication of load or support type. Not
applicable to global loads, Conductor, Current, General-
ized Plane Strain, Thermal Condition, or Voltage.
Magnitude - appears if Define By is set to Vector, or as
a field to enter magnitude of load. Not applicable to
Standard Earth Gravity, Generalized Plane Strain,
Thermal Condition, all support objects, Convection,
Radiation, and all electromagnetic load objects.
Direction - appears if Define By is set to Vector, or read-
only indication for global loads except for Standard Earth
Gravity.
X, Y, Z Component - appears if Define By is set to Com-
ponents (one field per direction).
Suppressed
Mesh
Manages all meshing functions and tools for a model; includes global controls that govern the entire mesh.
Tree Dependencies:
Insertion Options:
• Meshing Overview
• Mesh Context Toolbar
Element Size
Curv/Proximity
Shape Checking
Solid Element Order
Straight Sided Element - appears if the model includes
an enclosure from DesignModeler.
Initial Size Seed
Applies to the following objects: Contact Sizing, Gap Sizing, Gap Tool, Mapped Face Meshing, Match Face
Mesh, Method, Part Proximity, Part Relevance, Refinement, Sizing
Tree Dependencies:
24
Section : Page Listings
Insertion Options:
• Meshing Overview
• Mesh Context Toolbar
• Gap Tool Context Toolbar - applicable to Gap Sizing
and Gap Tool
• Convergence - applicable to Refinement
• Error (Structural) - applicable to Refinement
Definition:
Suppressed
Definition:
Define By
Minimum
Maximum
Gap Aspect Ratio
Gap Density
Generate on Update
Model
Defines the geometry for the particular branch of the tree. The Environment object and sub-levels provide ad-
ditional information about the Model object, including loads, supports and results, but do not replace the geo-
metry. Graphic settings applied to the Model object apply to lower level objects in the tree. The Model object
groups geometry, material assignments, contact and mesh settings. The Geometry, Contact and Mesh objects
are not created until geometry is successfully attached.
Tree Dependencies:
26
Section : Page Listings
Insertion Options:
• Attaching Geometry
• Model Context Toolbar
Named Selections
Represents all child objects grouped as named selections for a model.
Tree Dependencies:
Scope:
Geometry - Use selection filters to pick geometry, click
in the Geometry field, then click Apply.
Parameter Manager
Collects and manages parameters and displays them in the Parameter Manager Worksheet.
Tree Dependencies:
28
Section : Page Listings
• Parameters
• Section : Specifying Parameters
• Section : Scenario Grids
• Section : What Ifs
• Section : Failures
• Section : CAD Parameters
Part
Defines a component of the attached geometry included under a Geometry object. The Part object is assumed
to be a multi body part with Body objects beneath it as depicted in the figure below. Refer to the Body objects
reference page if the Geometry object does not include a multi body part, but instead only includes individual
bodies, as depicted by Body 1 in the figure below.
Tree Dependencies:
Insertion Options:
• Attaching Geometry
Definition:
Suppressed
Material
Bounding Box:
Length X
Length Y
Length Z
Point Mass
Represents the inertial effects from a body.
30
Section : Page Listings
Tree Dependencies:
• Point Mass
• Coordinate Systems
• Geometry Context Toolbar
Definition:
Magnitude - Define magnitude; can be designated as a
parameter.
Suppressed
Project
Includes all objects in Simulation and represents the highest level in the object tree. Only one Project can exist
per Simulation session.
Tree Dependencies:
Insertion Options:
Result Tracker
Provides results graphs of deformation, contact, or temperature, vs. time or cumulative iteration.
Tree Dependencies:
32
Section : Page Listings
Definition:
Type - Read-only indication of result tracker type for De-
formation and Temperature objects. For Contact object,
specify contact output.
Orientation - appears for a Deformation result tracker
object.
X-Axis Values - specify Time or Cumulative Iteration.
Applies to the following objects: 1st Buckling Mode, Beam Tool, Biaxiality Indication, Buckling Tool, Contact
Tool, Current Density, Damage, Damage Matrix, Direct Stress, Directional Deformation, Directional Field
Intensity, Directional Flux Density, Directional Force/Torque, Directional Heat Flux, Elastic Strain Intensity,
Electric Potential, Equivalent Alternating Stress, Equivalent Plastic Strain, Equivalent Stress, Fatigue
Sensitivity, Fatigue Tool, Flux Linkage, Frequency Finder, Frequency Mode in Range [1st - 6th], Frequency
Response, Frictional Stress, Gap, Harmonic Tool, Hysteresis, Inductance, Life, Maximum Bending Stress,
Maximum Combined Stress, Maximum Principal Elastic Strain, Maximum Principal Stress, Maximum Shear
Elastic Strain, Maximum Shear Stress, Middle Principal Elastic Strain, Middle Principal Stress, Minimum
Bending Stress, Minimum Combined Stress, Minimum Principal Elastic Strain, Minimum Principal Stress,
Normal Elastic Strain, Normal Stress, Penetration, Phase Response, Pressure, Probe, Probe Tool, Rainflow
Matrix, Reactions, Safety Factor [fatigue], Safety Factor [stress], Safety Margin, Shape Finder, Shear Elastic
Strain, Shear Stress, Sliding Distance, Status, Stress Intensity, Stress Ratio, Stress Tool, Structural Error,
Temperature, Thermal Error, Thermal Strain, Total Deformation, Total Field Intensity, Total Flux Density,
Total Force, Total Heat Flux, Vector Principal Elastic Strain, Vector Principal Stress
Tree Dependencies:
34
Section : Page Listings
36
Section : Page Listings
Insertion Options:
• For results and result tools that are direct child objects
of a Solution object, use any of the following methods
after highlighting the Solution object:
• Result Types
• Solution Context Toolbar
• Fatigue Overview
Definition:
Type - result type indication, can be changed
within the same result category. Read-only indica-
tion for: Current Density, Electric Potential,
Equivalent Plastic Strain, Structural Error,
Temperature, Thermal Error, Vector Principal
Elastic Strain, Vector Principal Stress.
Display Time - appears if Transient is set in the
Environment or Solution context toolbar.
Sequence Number - appears if Steps: is set to
greater than 1 in the Environment or Solution
context toolbar.
Orientation - appears only for: Directional De-
formation, Directional Field Intensity, Direction-
al Flux Density, Directional Force/Torque, Dir-
ectional Heat Flux, Normal Elastic Strain, Nor-
mal Stress, Shear Elastic Strain, Shear Stress,
Thermal Strain.
38
Section : Page Listings
Solution
Defines result types and formats for viewing a solution. Also includes settings that can be established prior to a
solve.
Tree Dependencies:
Insertion Options:
• Solving Overview
• Solution Context Toolbar
• Convergence
• Problem Situations
40
Section : Page Listings
Adaptive Convergence
Max Refinement Loops
Refinement Depth
Options
Save ANSYS db
ANSYS db File Name - appears if Save ANSYS db is set
to Yes.
Solver Type
Weak Springs
Spring Stiffness - appears if Weak Springs is set to On.
Spring Stiffness Factor - appears if Spring Stiffness is
set to Factor.
Spring Stiffness Value - appears if Spring Stiffness is
set to Manual.
Large Deflection
Auto Time Stepping - appears if Static or Harmonic is
set in the Environment or Solution context toolbar.
Initial Substeps - appears if Auto Time Stepping is set
to On.
Minimum Substeps - appears if Auto Time Stepping is
set to On.
Maximum Substeps - appears if Auto Time Stepping is
set to On.
Number of Substeps - appears if Auto Time Stepping
is set to Off.
Solution
Analysis Type - Read-only indication.
Nonlinear Solution - Read-only indication.
Solver Working Directory - Read-only indication.
Result File Name Selection
Result File - Read-only indication if Result File Name
Selection is set to Program Controlled.
Solver Messages - Read-only indication.
Output Controls
Calculate Stress
Calculate Strain
Calculate Contact
Calculate Error
Calculate Thermal Flux
Solution Combination
Manages solutions that are derived from the results of one or more environments.
License Level: ANSYS Professional and above except if Fatigue Tool is included, then ANSYS DesignSpace and
above
Tree Dependencies:
• Solution Combinations
• Underdefined Solution Combinations (Troubleshoot-
ing)
Solution Information
Allows tracking, monitoring, or diagnosing of problems that arise during a nonlinear solution.
Tree Dependencies:
42
Section : Page Listings
• Solution Information
• Solution Context Toolbar
Spot Weld
Defines conditions for individual contact and target pairs for a spot weld, which is used to connect individual
surface parts to form a surface model assembly , just as a Contact Region object is used to form a solid model
assembly. Several Spot Weld objects can appear as child objects under a Contact object.
Tree Dependencies:
• Spot Welds
• Contact Context Toolbar
Transient Settings
For transient simulations, displays a Transient Settings worksheet that provides a graphical display of the
transient settings, and allows you to adjust these settings prior to solving.
Tree Dependencies:
44
Section : Page Listings
Insertion Options:
Visibility:
Chart Legend - displays the chart legend to the right of
the chart.
DT Legend - displays the time increment legend beneath
the chart.
Tabular Data - displays timeline grid of Time and Step
Reset beneath the chart (On by default).
Curve Type Column - displays the Type column of the
timeline legend, located in the lower right area of the
worksheet.
Variable Graph
Displays a graph of parameters defined in the Parameter Manager Worksheet. At least two parameters must
be defined.
Tree Dependencies:
• Parameters
• Section : Specifying Parameters
• Section : Scenario Grids
• Section : What Ifs
• Section : Failures
• Section : CAD Parameters
Virtual Cell
Defines an individual surface or edge group, defined manually or automatically. The collection of all Virtual Cell
objects exists under one Virtual Topology object.
Tree Dependencies:
46
Section : Page Listings
Insertion Options:
Scope
Geometry - Read-only indication of components that
make up the Virtual Cell object.
Virtual Topology
Represents all definitions of surface or edge groups within a model. Each definition is represented in a Virtual
Cell object.
Tree Dependencies:
Definition
Region Flatness
Smallest Edge Tolerance
Advanced
Shared Boundary Ratio
Region Size
Generate on Update
48
Simulation Basics
• Simulation License Options
• Simulation Interface
• Customizing Simulation
• Simulation System Files
Simulation Interface
Section : Simulation Window
Section : Tree Outline Conventions
Section : Tree Outline
Section : Tabs
Section : Geometry
Section : Graphical Selection
Section : Details View
Section : Parameters
Section : Toolbars
Section : Print Preview
Section : Triad and Rotation Cursors
Simulation Window
The following is an example of the Simulation interface.
• 3D Geometry
• 2D/3D Graph
• Spreadsheet
• HTML Pages
Note — The Geometry window may include splitter bars for dividing views.
Section : Tabs The document tabs that are visible on the lower right portion of the Simulation Window.
Status Bar Brief in-context tip. Selection feedback.
Splitter Bar Application window has up to 3 splitter bars.
• A symbol to the left of an item's icon indicates that it contains associated subitems . Click to expand
the item and display its contents.
• To collapse all expanded items at once, double-click the Project name at the top of the tree.
• Drag-and-drop function to move and copy objects.
• Branching. For more information, see Section : Branches.
• To delete a tree object from the Section : Tree Outline, right-click on the object and select Delete. A con-
firmation dialog asks if you want to delete the object.
Status Symbols
A small status icon displays just to the left of the main object icon in the Section : Tree Outline
Mapped Face or Match Face Surface could not be mapped meshed, or mesh of face
Mesh Failure pair could not be matched.
Ok Everything is ok.
Needs to be Updated Equivalent to “Ready to Answer!”
Tree Outline
The object Tree Outline matches the logical sequence of simulation steps. Object sub-branches relate to the
main object. For example, the Environment object contains loads. You can right-click on an object to open a
context menu which relates to that object. You can rename objects, provided the objects are not being solved.
Suppress/Unsuppress Items
Several items in the Simulation tree outline can be suppressed, meaning that they can be individually removed
from any further involvement in the analysis. For example, suppressing a part removes the part from the display
and from any further loading or solution treatment.
For all items listed above, including named selections, you can suppress/unsuppress items through context
menu options available via a right mouse button click. Included is the context menu option Invert Suppressed
Body Set, which allows you to reverse the suppression state of all bodies (unsuppressed bodies become sup-
pressed and suppressed bodies become unsuppressed). You can suppress named selections using either the
context menu options mentioned above , or through the Named Selection Toolbar.
Another way to suppress a body is by selecting it in the graphics window, then using a right mouse button click
in the graphics window and choosing Suppress Body in the context menu. Conversely, the Unsuppress All
Bodies option is available for unsuppressing bodies. Options are also available in this menu for hiding or showing
bodies. Hiding a body only removes the body from the display. A hidden body is still active in the analysis.
Tabs
The bottom of the browser pane in the application window contains the five main document tabs shown above.
The Worksheet tab is available when tabular, graphic, or text data concerning the object is available.
The tabs provide alternative views of the current Outline object. You can move among the Section : Geometry,
Animation, Section : Worksheet Tab, Section : Print Preview, and Section : Report Preview at any time by clicking
the tabs. The Outline remains visible.
Geometry
The Geometry window displays the geometry model. All view manipulation, geometry selection and graphics
display of a model occurs in the Geometry window. The window contains:
• 3D Graphics.
• A DHTML page (which may contain graphics such as charts).
• A scale ruler.
• A legend and a triad control (when you display the solution).
• Contour results objects.
Note — When you click Insert, then select Comment, the Geometry window splits horizontally, and the
HTML comment editor displays in the bottom of the window. The Geometry representation of the
model displays at the top. For more information about editing comments, refer to the Comment object
reference.
Graphical Selection
Tips for working with graphics
• You can use the ruler, shown at the bottom of the Geometry window, to obtain a good estimate of the
scale of the displayed geometry or results (similar to using a scale on a geographic map). The ruler is
useful when setting mesh sizes.
• You can rotate the view in a geometry selection mode by dragging your middle mouse button. You can
zoom in or out by rolling the mouse wheel.
• Hold the control key to add or remove items from a selection. You can paint select surfaces on a model by
dragging the left mouse button.
• You can pan the view by using the arrow keys.
• Click the interactive Section : Triad and Rotation Cursors to quickly change the graphics view.
• Use the stack of rectangles in the lower left corner of the Section : Geometry to select surfaces hidden by
your current selection.
• To rotate about a specific point in the model, switch to rotate mode and click the model to select a rotation
point. Click off the model to restore the default rotation point.
• To multi-select one or more surfaces, hold the [CTRL] key and click the surfaces you wish to select, or use
Box Select to select all surfaces within a box. The [CTRL] key can be used in combination with Box Select
to select surfaces within multiple boxes.
• Click the Viewports icon to view up to four images in the Section : Geometry window.
• Controls are different for Graphs & Charts.
Activates rotational controls in the Geometry window (left mouse button). The cursor changes appearance
depending on its window location.
Pointer Modes
The pointer in the graphics window is always either in a picking filter mode or a view control mode. When in a
view control mode the selection set is locked. To resume the selection, repress a picking filter button.
The Graphics Toolbar offers several geometry filters and view controls as the default state, for example, surface,
edge, rotate, and zoom.
If a Geometry field in the Section : Details View has focus, inappropriate picking filters are automatically disabled.
For example, a pressure load can only be scoped to surfaces.
If the Direction field in the Section : Details View has focus, the only enabled picking filter is Select Direction.
Select Direction mode is enabled for use when the Direction field has focus; you never choose Select Direction
manually. You may manipulate the view while selecting a direction. In this case the Select Direction button allows
you to resume your selection.
Defining Direction
Orientation may be defined by any of the following geometric selections:
If an axis is required (e.g. for rotational velocity) selection of a planar face also requires a vertex.
Direction Defaults
If you create an object by selecting Geometry and choosing Insert, the Direction field may default if the geometry
defines an orientation. For example, a force applied to a planar face by default acts normal to the face. One of
the two directions is chosen automatically. The load annotation displays the default direction.
• Planar faces
• Straight edges
• Cylindrical or revolved faces
• Vertices
If one vertex is selected, you must hold down the [CTRL] key to select the other. When you press the [CTRL] key,
only vertices highlight.
When you finish editing the direction, the hit point (initially marked by the selection blip) becomes the default
location for the annotation:
Highlighting
Highlighting provides visual feedback about the current pointer behavior (e.g. select surfaces) and location of
the pointer (e.g. over a particular surface).
Picking
A pick means a click on visible geometry. A pick becomes the current selection, replacing previous selections. A
pick in empty space clears the current selection.
By holding the [CTRL] key down, you can add unselected items to the selection and selected items can be removed
from the selection. Clicking in empty space with [CTRL] depressed does not clear current selections.
Blips
A crosshair blip appears at the location where you release the mouse button:
Blips disappear when you clear the selection or make another pick.
Painting
Painting means dragging the mouse on visible geometry to select more than one entity. A pick is a trivial case
of painting. Without holding the [CTRL] key down, painting picks all appropriate geometry touched by the
pointer.
Depth Picking
Depth Picking allows you to pick geometry through the Z-order behind the blip.
Whenever a blip appears above a selection, the graphics window displays a stack of rectangles in the lower left
corner. The rectangles are stacked in appearance, with the topmost rectangle representing the visible (selected)
geometry and subsequent rectangles representing geometry hit by a ray normal to the screen passing through
the blip, front to back. The stack of rectangles is an alternative graphical display for the selectable geometry.
Each rectangle is drawn using the same edge and surface colors as its associated geometry.
Highlighting and picking behaviors are identical and synchronized for geometry and its associated rectangle.
Moving the pointer over a rectangle highlights both the rectangle its geometry, and vice versa. [CTRL] key and
painting behaviors are also identical for the stack. Holding the [CTRL] key while clicking rectangles picks or unpicks
associated geometry. Dragging the mouse (Painting) along the rectangles picks geometry front-to-back or back-
to-front.
Selection Filters
The mouse pointer in the graphics window is either in a picking filter mode or a view control mode. A latched
button in the graphics toolbar indicates the current mode.
Filter Behavior
Vertices Vertices are represented by concentric circles about the same size as a blip. The circumference
of a circle highlights when the pointer is within the circle.
Edges Painting may be used to pick multiple edges or to “paint up to” an edge (to avoid tediously
positioning the pointer prior to clicking).
Faces Allows selection of faces. Highlighting occurs by dotting the banding edges of the surface.
Bodies Picking and painting: select entire bodies. Highlighted by drawing a bounding box around
the body. The stack shows bodies hidden behind the blip (useful for selecting contained
bodies).
• Extend to Adjacent
– For faces, Extend to Adjacent searches for faces adjacent to faces in the current selection that meet
an angular tolerance along their shared edge.
Single face selected in part on the left. Additional adjacent faces selected after Extend to Ad-
jacent option is chosen.
– For edges, Extend to Adjacent searches for edges adjacent to edges in the current selection that meet
an angular tolerance at their shared vertex.
Single edge selected in part on the left. Additional adjacent edges selected after Extend to
Adjacent option is chosen.
• Extend to Limits
– For faces, Extend to Limits searches for faces that are tangent to the current selection as well as all
faces that are tangent to each of the additional selections within the part. The selections must meet
an angular tolerance along their shared edges.
Single face selected in part on the left. Additional tangent faces selected after Extend to Limits
option is chosen.
– For edges, Extend to Limits searches for edges that are tangent to the current selection as well as all
edges that are tangent to each of the additional selections within the part. The selections must meet
an angular tolerance along their shared vertices.
Single edge selected in part on the left. Additional tangent edges selected after Extend to
Limits option is chosen.
For all options, you can modify the angle used to calculate the selection extensions in the Options dialog box
setting Extend Selection Angle Limit, under the Common Settings.
– Dragging to the right to form the box selects entities that are completely enclosed by the box.
– Visual cue: 4 tick marks completely inside the box.
– Dragging to the left to form the box selects all entities that touch the box.
– Visual cue: 4 tick marks that cross the sides of the box.
You can use the [CTRL] key for multiple selections in both modes.
Viewports
The Viewports toolbar button allows you to split the graphics display into a maximum of four simultaneous
views. You can see multiple viewports in the Section : Geometry window when any object in the tree is in focus
except Project. You can choose one, horizontal, vertical, or four viewports. Each viewport can have separate
camera angles, labels, titles, backgrounds, etc. Any action performed when viewports are selected will occur
only to the active viewport. For example, if you animate a viewport, only the active viewport will be animated,
and not the others.
A figure can be viewed in a single viewport only. If multiple viewports are created with the figure in focus, all
other viewports display the parent of the figure.
Note — Each viewport has a separate Slice tool, and therefore separate Draw Slice Plane. The concept
of copying a Slice Plane from one window to the next does not exist. If you want Slice Planes in a new
window, you must create them in that window.
Viewports are not supported in sequenced simulations.
Feature Control
Pan [Right Mouse Button]
Zoom [Middle Mouse Button]
Box Zoom [[Alt]Left Mouse Button]
Rotate (3D only) [Left Mouse Button]
Perspective Angle (3D only) [[Shift]Left Mouse Button]
Display Coordinates (2D only) [[Ctrl]Left Mouse Button] along graph line
Details View
The Details View is located in the bottom left corner of the window. It provides you with information and details
that pertain to the object selected in the Section : Tree Outline. Some selections require you to input information
(e.g., force values, pressures). Some selections are drop-down dialogs, which allow you to select a choice. Fields
may be grayed out. These cannot be modified.
The following example illustrates the Details View for the object called Geometry.
Features
The Details View allows you to enter information that is specific to each section of the Tree Outline. It automat-
ically displays details for branches such as Geometry, Model, Contact, etc. Features of the Details View include:
Header
The header identifies the control and names the current object.
Categories
Category fields extend across both columns of the Details Pane:
This allows for maximum label width and differentiates categories from other types of fields. To expand or collapse
a category, double-click the category name.
Decisions
Decision fields control subsequent fields:
Note — The left column always adjusts to fit the widest visible label. This provides maximum space for
editable fields in the right column. You can adjust the width of the columns by dragging the separator
between them.
Text Entry
Text entry fields may be qualified as strings, numbers, or integers. Units are automatically removed and replaced
to facilitate editing:
Inappropriate characters are discarded (for example, typing a Z in an integer field). A numeric field cannot be
entered if it contains an invalid value. It is returned to its previous value.
Ranges
If a numeric field has a range, a slider appears to the right of the current value:
If the value changes, the slider moves; if the slider moves the value updates.
Increments
If a numeric field has an increment, a horizontal up/down control appears to the right of the current value:
Geometry
Geometry fields filter out inappropriate selection modes. For example, a bearing load can only be scoped to a
face. Geometries other than face will not be accepted.
Clicking Apply locks the current selection into the field. Other gestures (clicking Cancel or selecting a different
object or field) do not change the field's preexisting selection.
Callouts
Callouts provide specific information and instructions for fields within the control:
Options
Option fields allow you to select one item from a short list. Options work the same way as Decisions, but don't
affect subsequent fields. Options are also used for boolean choices (true/false, yes/no, enabled/disabled, fixed/free,
etc.) Double-clicking an option automatically selects the next item down the list.
Selecting an option followed by an ellipsis causes an immediate action. In this case, Import… allows selection
of a material not already in the list:
Worksheet Tab
The Worksheet tab contains predominately tabular or text data (but may also contain graphical data) about the
following types of Simulation objects:
• Geometry
• Coordinate Systems
• Contact
• Environment
• Tabular Loads
• Harmonic loads
• Fatigue Tool
• Contact Tool
• Frequency Finder
• Buckling Tool
• Solution Information
• Solution Combination
• Parameter Manager
• Variable Graph
• Contact Tool reactions
• Harmonic Tool
Displaying Information The Worksheet tab lists the information for child objects of an Outline Tree's folder.
The information can be displayed graphically for comparison. For example, with harmonic loads you can select
multiple loads to compare to one another for variance. Also, for all load and support objects listed under the
Environment folder (except rotations and accelerations), the Worksheet tab displays a Time View -- a graph
of that object's value vs. time.
Go To Selected items A useful feature in the worksheets associated with most of the folders mentioned above
is the ability to instantly select items in the tree that you pick in the Name column (leftmost column) on the
worksheet. The graphical equivalents of the items also display in the Geometry window. This feature allows you
to quickly change properties in the Details View, and is available for worksheets associated with the Geometry,
Coordinate Systems, Contact, Environment, Frequency, and Buckling folders.
To use this feature, select one or more items in the Name column of the worksheet (standard Windows controls
for multiple selection apply), right-click on one of the selected items and choose Go To Selected Items in Tree.
The items are selected in the tree, and the Geometry window replaces the worksheet and displays graphics as-
sociated with the selected items. An example is shown here:
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Note — A weak spring reaction in the Environment worksheet has no equivalent in the Environment
folder so choosing this item and then choosing Go To Selected Items in Tree has no effect.
Viewing Selected Columns for Contact When viewing a worksheet from a Contact folder, or a Contact Re-
actions item (under a Contact Tool folder), you can choose which columns will display.
To choose the columns that will display, right mouse click anywhere inside the worksheet table. From the context
menu, click on any of the column names. A check mark signifies that the column will appear. There are some
columns in the Contact folder worksheet that will not always be shown even if you check them. For example, if
all the contact regions have a Pinball Region set to Program Controlled and the Pinball Radius column is
checked, Pinball Radius will not show because you have not set any of this data.
By default, the Transient Settings worksheet will define time step reset points based on significant load changes
and will request results data at every time point used by the solver. If these settings are appropriate for your
simulation, then no additional processing of data in this worksheet is required.
Timeline Chart
The timeline chart presents a graphical representation of Environment loads as a function of time. The chart
will display constant loads as well as time-history loads. The chart also contains a time increment legend that
displays the solver settings for minimum time step (∆Tmin), initial time step (∆Tinitial), and maximum time
step (∆Tmax). These time step increments are scaled to the Time axis of the chart to give a visual reference to
the time increment settings.
A context menu is available in the chart area. Use the right mouse button to display the following list of options
available in the chart area:
• Add Result: Adds a result at a particular time point. Position the cursor at a time point where result data
is desired. Choosing Add Result will add an orange marker to the Time axis indicating that results data
will be available at this time point.
• Delete All Results: Deletes the requested time points for results data.
• Add Manual Reset: Selects a time point for resetting the time step size (Step Reset) to the initial time
step. Choosing a time step reset is usually done at time points corresponding to significant time-varying
load changes to accurately capture the time phenomena. The time point selected for rest is displayed
with a white marker. The worksheet controls provide a convenient option to automatically select time
step resets based on the time-varying load curves (Automatic Step Resets). Automatic reset points are
displayed with a blue marker. Automatic and Manual time step resets may be active simultaneously.
• Delete Manual Resets: Deletes manual time step reset points.
The chart area supports selection of time points over a time range. Use the left mouse button to drag over a time
range within the chart area. The dragged area will highlight in blue. Pressing the right mouse button presents
several context menus: Add and Delete options for Results Sets and time step reset points operating within
the selected time range. A Zoom to Fit option will zoom the chart such that the requested time range fills the
chart area. A Zoom to Fit context menu option will allow you to return to the original timeline range.
Step Reset Constraints are shown in gray at the top of the chart. Time points within the time ranges highlighted
in gray cannot be selected for time step reset points.
Result Set Constraints are shown in gray at the bottom of the chart. Time points within the time ranges high-
lighted in gray cannot be selected for results data.
Load data is viewed in the chart for loads defined in the Environment object. Loads of a mixed type (i.e., Tem-
perature and Heat Flux) are normalized along the vertical axis. Loads of a similar type are shown to scale. Use
the timeline legend to control visibility of load data.
Below the time axis on the chart is a display of the solution point markers. This is only visible after a solution. The
black markers indicate the time points where a solution occurred. This can be used as a reference to visually
check the frequency and location of solution points relative to the time-history loads. The black markers only
appear if Result Sets is set to Manual in the Worksheet Controls, as discussed in the next section.
Worksheet Controls
The worksheet controls section of the worksheet provides options for automatically creating time step reset
points and for selecting time points where results output will be made available.
• The Automatic Step Resets slider control selects critical time points where the solver resets the time in-
crement to the initial time step value. Use this control to capture the transient response to a sharp change
in loads. By default, the slider control is set mid-span and will pick up time step reset time points for severe
load changes. You can adjust the slider to be more or less aggressive in selecting time points. You can
select automated time points in conjunction with manually defined time points using the context menu
in the chart area.
• The Result Sets control enables you to select the time points where you wish the solver to compute results
data. By default, the program will compute results at all solution time points (Automatic option). You can
use the Manual option to select equally spaced time points over a time range. You may issue the Manual
option several times, allowing for multiple selections of result time points.
• Choosing the Reset button allows you to restore the default settings for both the Automatic Step Resets
and Result Sets time points. You can also clear the manual results sets using a context menu option in
the chart area.
• After completing a solution, the Transient Settings worksheet is in a "locked" mode where options cannot
be changed. This is done to keep the settings in line with the current results. If you wish to change the
options to prepare for another run, choose the Unlock button.
Timeline Grid
The timeline grid is a non-editable record of the time Step Reset points and Results Set points.
Timeline Legend
The timeline legend lists the Environment loads for the simulation. Checkboxes in the Visible column control
the display of the load in the chart. Checkboxes in the Active column control which loads are to be used to de-
termine the automatic time step reset points that you set with the Automatic Step Resets slider control in the
Worksheet Controls.
The Curve and Type columns include load data (circles) and Result Tracker data (triangles), including the two
Result Tracker objects that are displayed by default for a transient simulation: minimum temperature (RTMin)
and maximum temperature (RTMax).
Note — If you duplicate the Environment, the checkbox status in the Active column will be duplicated
only for the load data because the Result Tracker data does not affect the Results Set or Step Reset
points.
Parameters
To parameterize a variable, click the box next to it. A P appears in the box. Items that cannot be parameterized
do not display a check box and are left-aligned to save space.
The boxes that appear in Simulation apply only to the Simulation Parameter Manager. Checking or unchecking
these boxes will have no effect on which CAD parameters are transferred to DesignXplorer.
Toolbars
Toolbars are displayed across the top of the window, below the menu bar. Toolbars can be docked to your pref-
erence. The layouts displayed are typical. You can double-click the vertical bar in the toolbar to automatically
move the toolbar to the left.
Main Menu
The Main Menu includes the following items. Click a menu item to see a description of the tasks associated with
that item.
Standard Toolbar
The Standard Toolbar contains application-level commands, configuration toggles and important general
functions. Each icon button and its description follows:
Graphics Toolbar
The Graphics Toolbar sets the selection/manipulation mode for the cursor in the graphics window. The toolbar
also provides commands for modifying a selection or for modifying the viewpoint. Each icon button and its de-
scription follows:
Extend Selection Adds adjacent surfaces (or edges) within angle tolerance,
to the currently selected surface (or edge) set, or adds
tangent surfaces (or edges) within angle tolerance, to the
currently selected surface (or edge) set.
Toggle Magnifier Window On/Off Displays a Magnifier Window, which is a shaded box that
functions as a magnifying glass, enabling you to zoom in
on portions of the model. When you toggle the Magnifier
Window on, you can:
Context Toolbar
The Context Toolbar occupies the 2nd row of toolbars. The Context Toolbar configures its buttons based on
the type of object selected in the Section : Tree Outline. The Context Toolbar makes a limited number of relevant
choices more visible and readily accessible.
Note —
• Drop-down menus from Context Toolbar buttons display the same submenu from the correspond-
ing item under Insert in the Section : Main Menu.
• Some Context Toolbar items, such as Contact or Mesh Controls, can be hidden.
• The Context Toolbar cannot be hidden (for simplicity and to avoid jumbling the screen). The
toolbar appears blank when no options are relevant.
• The toolbar displays a text label for the current set of options.
• An Options dialog box setting turns off button text labels to minimize context toolbar width.
Most context toolbars include the button to jump “Up One Level.” The command selects the parent of the
current object in the Outline. In most cases this button changes the contents of the context toolbar.
The Project Context toolbar becomes active when Project is selected in the tree. From the Project Context
toolbar you can create a new Model branch in the tree.
The Model Context toolbar becomes active when a Model is selected in the tree. The Model Context toolbar
contains options to attach or update geometry, create virtual topology, create a coordinate systems branch and
define one or more solution combinations.
Geometry
Choosing the Geometry option allows you to attach geometry by listing recently used geometry files or by allowing
you to choose a file from a directory. You can also update geometry using parameter values.
Virtual Topology
You can use the Virtual Topology option to reduce the number of elements in a model by merging surfaces and
lines. This is particularly helpful when small surfaces and lines are involved. The merging will impact meshing
and selection for loads and supports. See Virtual Topology Overview for details.
Contact
You can transfer structural loads and heat flows across the contact boundaries and “connect” the various parts.
See the Contact section for details. The Contact button is available only if a Contact object is not already in the
tree (such as a model that is not an assembly), and you wish to create a Contact object.
Coordinate Systems
All geometry is displayed in the world (global) coordinate system by default. To create a new unique coordinate
system, select the Coordinate Systems button from the toolbar, which inserts a Coordinate System folder into
the Section : Tree Outline. The folder includes one Global Coordinate System object by default. You can then
insert one or more local coordinate system objects to the Coordinate Systems folder. You define the Type of
local coordinate system as either Cartesian or Cylindrical in the Section : Details View. You then define the
Origin through one of the methods.
• Selecting a topology:
3. Click Apply. A coordinate system symbol displays at the origin location as determined by the following:
Preselecting one or more topologies and then inserting a Coordinate System will automatically
locate its origin as stated above.
• Entering the coordinates directly in the Details View. The origin will be at this location.
Coordinate systems defined when geometry is imported from DesignModeler, Pro/ENGINEER, or SolidWorks will
automatically be created in Simulation. For more information, see the Attaching Geometry section under
DesignModeler, or see the Notes section under Pro/ENGINEER or SolidWorks.
Any local coordinate systems that were created in Simulation, or imported from DesignModeler, Pro/ENGINEER,
or SolidWorks, can be applied to a part, or to a Point Mass, Acceleration, Standard Earth Gravity, Rotational Velocity,
Force, Bearing Load, Remote Force, Remote Displacement, Moment, Displacement, or Contact Reaction using
the Coordinate System menu in the Details View of the particular part, load, Displacement, or Contact Reaction.
Through an Options dialog box Simulation setting for Export, you can specify your results to automatically open
in Excel when exporting. When exporting results (see Section : Exporting Data) for a particular result object, that
object’s scope and coordinate system will be taken into account. You may save the results in three different
formats:
• Excel (.xls)
• Text (.txt)
• all files (.*) where you can specify the extension
Solution Combination
Use the Solution Combination option to combine multiple environments and solutions to form a new solution.
A solution combination folder can be used to linearly combine the results from an arbitrary number of load cases
(environments). Note that the environments must be structural static with no solution convergence. Results such
as stress, elastic strain, displacement, contact, and fatigue may be requested. To add a load case to the solution
combination folder, right click on the worksheet view of the solution combination folder, choose add, and then
select the scale factor and the environment name. An environment may be added more than once and its effects
will be cumulative. You may suppress the effect of a load case by using the check box in the worksheet view or
by deleting it through a right click. For more information, see Section : Solution Combinations.
The Geometry Context toolbar is active when you select the Geometry branch in the tree or any items within
the Geometry branch. The Geometry button functions the same as it does under the Model Context toolbar.
Using the Geometry toolbar you can also apply a Point Mass.
The Virtual Topology Context toolbar includes an option to insert Virtual Cell objects where you can group
surfaces or edges.
The Contact Context toolbar contains options to insert a spot weld or a manual contact region.
The Meshing Context toolbar allows you to add the Mesh Controls option to your model, or view feedback from
the mesher (grayed out if the mesher gathered no warnings or errors).
The Gap Tool Context toolbar is used to have Simulation search for face pairs within a specified gap distance
that you specify.
The toolbar display varies depending on the type of simulation you choose, as shown below.
• Static - Choose Static in the drop down menu and enter 1 in the Steps field:
• Sequenced - Choose Static in the drop down menu and enter the number of sequenced steps (any number
greater than 1) in the Steps field:
• Harmonic - Choose Harmonic in the drop down menu. There is no other field in the toolbar:
• Transient - Choose Transient in the drop down menu and enter the final time of interest in the End Time
field:
A portion of the toolbar display varies depending on the type of simulation you choose, displaying the same
information as the Environment context toolbar.
Objects created via the Solution toolbar are automatically selected in the Outline. Prior to a solution this toolbar
always remains in place (no contours to display). Structural and/or thermal result types may not be displayed ,
depending on the settings in the Physics Filter located in the View menu.
A table in the Results section indicates which bodies can be represented by the various choices available in the
drop-down menus of the Solution toolbar.
Inserting some other tools changes the solution context toolbar to other toolbars (e.g., Solution Information).
The Result toolbar applies to Solution level objects that display contour or vector results.
Scale factors precede the descriptions in parentheses in the list. The scale factors shown above apply to a partic-
ular model's deformation and are intended only as an example. Scale factors vary depending on the amount of
deformation in the model.
You can choose a preset option from the list or you can type a customized scale factor relative to the scale factors
in the list. For example, based on the preset list shown above, typing a customized scale factor of 0.6 would
equate to approximately 3 times the Auto Scale factor.
The system maintains the selected option as a global setting like other options in the Result toolbar.
For results that are not scaled, the combo box has no effect.
Relative Scaling
The combo list provides five “relative” scaling options. These options scale deformation automatically relative
to preset criteria:
• Undeformed
• True Scale
• 0.5x Auto
• Auto Scale
• 2x Auto
• 5x Auto
Legend
When you choose the Legend button, a Legend dialog box appears that allows you to customize the default
settings and appearance of the result contour legend. Refer to Customizing Result Legend for a description of
the tasks you can perform within this dialog box.
Geometry
You can observe different views from the Geometry drop-down menu.
• Exterior
• IsoSurfaces
This view displays the interior only of the model at the transition point between values in the legend, as indicated
by the color bands.
• Capped IsoSurfaces
This view displays contours on interior and exterior surfaces. When you choose Capped IsoSurfaces, a Capped
Isosurface toolbar appears beneath the Result context toolbar. Refer to Capped Isosurfaces for a description
of the controls included in the toolbar.
• Slice Planes
This view displays planes cutting through the result geometry; only previously drawn slice planes are visible.
Contours Options
To change the way you view your results, click any of the options on this toolbar.
• Smooth
Edges Options
You can switch to wireframe mode to see gaps in surface models. Red lines indicate shared edges.
In addition, you can choose to view wireframe edges, include the deformed model against the undeformed
model, or view elements.
Showing a subdued view of the undeformed model along with the deformed view is especially useful if you
want to view results on the interior of a body yet still want to view the rest of the body's shape as a reference.
An example is shown here.
The Show Undeformed Model option is useful when viewing any of the options in the Geometry drop-down
menu.
• No Wireframe
This view shows the deformed body with contours, with the undeformed body in translucent form.
• Show Elements
• Click the Graphics button on the Result context toolbar to convert the result display from contours (default)
to vectors.
• When in vector display, a Vector Display toolbar appears with controls as described below.
• When in vector display, click the Graphics button on the Result context toolbar to change the result
display back to contours. The Vector Display toolbar is removed.
Uniform vector lengths identify paths using vector arrows in line form.
Course grid size with vector arrows in solid form. Same using wireframe edge option.
Uniform vector lengths , grid display on slice plane with vector arrows in solid form.
Zoomed-in uniform vector lengths , grid display with arrow scaling and vector arrows in solid form.
• Click the toolbar button and then drag the mouse across the part to create the Slice Plane. To view the
newly created plane, rotate the model.
• You can construct additional Slice Planes by clicking and dragging additional lines across the model.
• To exit Draw Slice Plane mode, click the toolbar button again.
Edit Planes
You can use the Edit Planes toolbar button to display Slice Plane anchors.
• Click on the line on either side of the anchor to view the colored exterior on that side of the plane. This is
called a “Capping Plane.” A dashed line indicates a Slice Place, a solid line denotes a Capping Plane. You
cannot display a Slice Plane within a Capping Plane.
• Drag the Slice Plane or Capping Plane anchor to change the position of the plane.
• To maneuver between multiple planes, press the TAB key. You can also mouse over the square selection
boxes. The active Slice Plane or Capping Plane displays a blue box within the anchor. Inactive planes display
a white box. Locate the desired box and click to select. When your mouse is over a box, it turns red.
• To delete the selected Slice Plane or Capping Plane, press the [Delete] key. If you delete all of the planes,
you'll be left with a wireframe model (you can then click the Geometry drop-down menu and select Ex-
terior, or add new Slice Planes if you wish).
• To exit Edit Planes Mode, click the toolbar button again.
Usage Tip: To more fully grasp the new features of planes, you can experiment using different models.
Toolbar buttons allow for toggling Max and Min annotations and for creating probe annotations.
When you select a Comment object in the Outline, the Comment Context toolbar and Comment Editor appear.
For more information about editing comments, refer to the Comment object reference.
Note — For UNIX versions of the product, you must first click the Pencil button before you can edit the
comment. You must click the Pencil button again to close the editor.
The Print Preview toolbar allows you to print the currently-displayed image, or send it to an e-mail recipient or
to a Microsoft Word or PowerPoint file.
The Report Preview toolbar allows you to select a language for the report and adjust the image resolution. The
graphics browser exports images to a specific resolution (e.g. 512x384 pixels); the HTML page specifies the display
resolution for images. By default the resolutions match. By increasing the resolution of the bitmap while holding
the HTML resolution constant the print quality of image may be increased. The options below correspond to
100%, 200% and 400% image resolutions. Changing the language or the image quality setting forces regeneration
of the HTML page.
You can also print the report, save it to a file, send it to an e-mail recipient or to a Microsoft Word or PowerPoint
file, refresh the images, and adjust the font size.
The Unit Conversion Toolbar is a built-in conversion calculator. It allows conversion between five consistent unit
systems.
The Units menu sets the active unit system. The status bar shows the current unit system. The units listed in the
toolbar and in the Section : Details View are in the proper form (i.e. no parenthesis).
The Unit Conversions toolbar is hidden by default. To see it, select View> Unit Conversion Toolbar.
The Named Selection Toolbar contains options to group and control like-grouped items. It is available for use
on all types of selections: vertices, edges, faces, and bodies.
Use named selections with large models to improve the visibility of selected parts. Named selections are auto-
matically created in the event of a mesher failure so that problem surfaces can be identified.
1. Select geometry items in the graphics window that are to be members of the named selection group.
The controls in the Named Selection Toolbar remain grayed out until you select one or more items, or
...
If you selected bodies under the Geometry tree object, right mouse click on one of the body objects
and choose Create Selection Group in the context menu.
3. Type a name for the group (or accept a default name), in the Selection Name dialog box. A Named Se-
lections branch object is added to the Simulation tree. The name of the selection appears as a selectable
item in the Named Selection display (located to the right of the Create Selection Group button), and
as an annotation on the selected graphic items that make up the group.
• Selection drop-down menu: controls selection options on items that are part of the group whose
name appears in the Named Selection display.
– Select Items in Group: selects only those items in the named group.
– Add to Current Selection: Selects items in the named group combined with other items that
are already selected. This option is grayed out if the geometry type in the named selection does
not match the geometry type of the other selected items.
– Remove from Current Selection: Removes the selection of items in the named group from
other items that are already selected. Selected items that are not part of the group remain selected.
This option is grayed out if the geometry type in the named selection does not match the geometry
type of the other selected items.
Note — Choosing any of these options affects only the current selections in the Geometry
view, These options have no effect on what is included in the named selection itself.
• Visibility drop-down menu: controls display options on bodies that are part of the group whose
name appears in the Named Selection display.
– Hide Bodies in Group: Turns off display of bodies in the named group (toggles with next item).
Other bodies that are not part of the group are unaffected.
– Show Bodies in Group: Turns on display of bodies in the named group (toggles with previous
item). Other bodies that are not part of the group are unaffected.
– Show Only Bodies in Group: Displays only items in the named group. Other items that are not
part of the group are not displayed.
You can also hide or show bodies associated with a named selection using a right mouse button click
on the particular tree item under the Named Selections object and choosing Hide or Show from
the context menu.
• Suppression drop-down menu: controls options on items that affect if bodies of the group whose
name appears in the Named Selection display are to be suppressed, meaning that, not only are they
not displayed, but they are also removed from any treatment such as loading or solution.
– Suppress Bodies in Group: Suppresses bodies in the named group (toggles with next item).
Other bodies that are not part of the group are unaffected.
– Unsuppress Bodies in Group: Unsuppresses bodies in the named group (toggles with previous
item). Other bodies that are not part of the group are unaffected.
– Unsuppress Only Bodies in Group: Unsuppresses only bodies in the named group. Other bodies
that are not part of the group are suppressed.
You can also suppress or unsuppress bodies associated with a named selection using a right mouse
button click on the particular tree item under the Named Selections object and choosing Suppress
or Unsuppress from the context menu. The Suppress and Unsuppress options are also available if
you select multiple named selection items under a Named Selections object. The options will not
be available if your multiple selection involves invalid conditions (for example, if you want to suppress
multiple items you have selected and one is already suppressed, the Suppress option will not be
available from the context menu.
The status bar shows the selected group area only when the areas are selected. The group listed in the toolbar
and in the Section : Details View provides statistics that can be altered.
The Named Selection Toolbar is on by default and can be turned off or on by selecting View> Named Selection
Toolbar.
You can import named selections that you defined in a CAD system or in DesignModeler. A practical use in this
case is if you want the entities of the named selection group to be selected for the application of loads or
boundary conditions.
1. On the Project Page, check Named selections and complete the name field; or, in the Geometry Details
View under Preferences, set Named Selection Processing to Yes and complete the Named Selection
Prefixes field (refer to these entries under Geometry Preferences for more details).
2. A Named Selections branch object is added to the Simulation tree. In the Named Selection Toolbar, the
name of the selection appears as a selectable item in the Named Selection display (located to the right
of the Create Selection Group button), and as an annotation on the graphic items that make up the
group.
You can scope any of the following items to named selections: contact regions, mesh controls, loads, or supports.
2. Under the Details View, in the Scoping Method drop-down menu, choose Named Selection.
3. In the Named Selection drop-down menu, choose the particular name. For a contact region, there are
two drop-down menus, one for Contact and one for Target.
• Only valid named selections will show in the Named Selection drop-down menu. If there are no valid
named selections, the drop-down menu will be empty. No two Named Selections branches can have
the same name. It is recommended that you use unique and intuitive names for the Named Selections.
• If you change a named selection that is used by an item, the associated geometry will update accordingly.
• If you delete a named selection used by an item, the item becomes underdefined.
• If all the components in a named selection cannot be applied to the item, the named selection is not valid
for that item. This includes components in the named selection that may be suppressed. For example, in
the case of a bolt load scoped to cylindrical surfaces, only 1 cylinder can be selected for its geometry. If
you have a named selection with 2 cylinders, one of which is suppressed, that particular named selection
is still not valid for the bolt load.
When you write an ANSYS input file that includes a named selection group, the group is transferred to ANSYS
as a component provided the name contains only standard English letters, numbers, and underscores. The fol-
lowing actions occur automatically to the group name in Simulation to form the resulting component name in
ANSYS:
Example: The named selection group in Simulation called 1 Edge appears as component C_1_Edge in the ANSYS
input file.
Print Preview
Print Preview runs a script to generate an HTML page and image. The purpose of the Print Preview tab is to allow
you to view your results or graphics image.
The title block is an editable HTML table. To change the information, double click inside the table.
Rotation Cursors
Click the Rotate button to display and activate the
following rotation cursors:
Free rotation.
•
Specifically, the circular free rotation area fits the window. Narrow strips along the edges support pitch and yaw.
Corner areas support roll. The following figure illustrates these regions.
Customizing Simulation
Section : Simulation Options
Section : Variables
Section : Macros
Simulation Options
You can control the behavior of functions in Simulation through the Options dialog box. To access Simulation
options:
1. From the main menu, choose Tools> Options. An Options dialog box appears and the Simulation options
are displayed on the left.
2. Click on a specific option.
3. Change any of the option settings by clicking directly in the option field on the right. You will first see a
visual indication for the kind of interaction required in the field (examples are drop-down menus, sec-
ondary dialog boxes, direct text entries).
4. Click OK.
Contact
Convergence
Export
Fatigue
Frequency
Graphics
Meshing
Miscellaneous
Report
Solution
Startup
Visibility
Wizard
Other help descriptions available that describe the Options dialog box:
• Common Settings
• DesignModeler
• CFX-Mesh (available only if CFX-Mesh is selected at installation)
• DesignXplorer
• Licensing
Contact
The Auto Detection category allows you to change the default values in the Details View for the following:
• Auto Detect Contact on Attach: Indicates if contact detection should be computed upon geometry import
or not. The default is Yes.
• Tolerance: Sets the default for the contact detection slider; i.e., the relative distance to search for contact
between parts. The higher the number, the tighter the tolerance. In general, creating contacts at a tolerance
of 100 finds less contact surfaces than at 0. The default is 0. The range is from -100 to +100.
• Face/Face: Sets the default preference1 for automatic contact detection between faces of different parts.
The choices are Yes or No. The default is Yes.
• Face/Edge: Sets the default preference1 for automatic contact detection between faces and edges of
different parts. The choices are:
– Yes
– No (default)
– Only Solid Edges
– Only Surface Edges
• Edge/Edge: Sets the default preference1 for automatic contact detection between edges of different
parts. The choices are Yes or No. The default is No.
• Priority: Sets the default preference1 for the types of contact interaction priority between a given set of
parts. The choices are:
1
Unless changed here in the Options dialog box, the preference remains persistent when starting any Workbench
project.
The Transparency category includes the following exclusive controls for this category. There are no counterpart
settings in the Details View.
• Parts With Contact: Sets transparency of parts in selected contact region so the parts are highlighted.
The default is 0.8. The range is from 0 to 1.
• Parts Without Contact: Sets transparency of parts in non-selected contact regions so the parts are not
highlighted. The default is 0.1. The range is from 0 to 1.
The Default category allows you to change the default values in the Details View for the following:
– Bonded (default)
– No Separation
– Frictionless
– Rough
– Frictional
• Formulation: Sets the type of contact formulation method. The choices are:
– Augmented Lagrange
– Pure Penalty (default)
– MPC
– Normal Lagrange
• Update Stiffness: Enables an automatic contact stiffness update by the program. The choices are:
– Never (default)
– Each Equilibrium Iteration
– Each Substep
Convergence
The Convergence category allows you to change the default values in the Details View for the following:
• Target Change: Change of result from one adapted solution to the next. The default is 20. The range is
from 0 to 100.
• Allowable Change: This should be set if the criteria is the max or min of the result. The default is Max.
The Solution category allows you to change the default values in the Details View for the following:
• Max Refinement Loops: Allows you to change the number of loops . The default is 1. The range is from
1 to 10.
Export
The Export category includes the following exclusive controls for this category. There are no counterpart settings
in the Details View.
• Automatically Open Excel: Excel will automatically open with exported data. The default is Yes.
• Include Node Numbers: Nodal numbers will be included in exported file. The default is Yes.
• Include Node Location: Nodal location can be included in exported file. The default is No.
Fatigue
The General category allows you to change the default values in the Details View for the following:
• Design Life: Number of cycles that indicate the design life for use in fatigue calculations. The default is
1e9.
• Analysis Type: The default fatigue method for handling mean stress effects. The choices are:
– SN - None (default)
– SN - Goodman
– SN - Soderberg
– SN - Gerber
– SN - Mean Stress Curves
The Goodman, Soderberg, and Gerber options use static material properties along with S-N data to account
for any mean stress while Mean-Stress Curves use experimental fatigue data to account for mean stress.
The Cycle Counting category allows you to change the default values in the Details View for the following:
• Bin Size: The bin size used for rainflow cycle counting. A value of 32 means to use a rainflow matrix of
size 32 X 32. The default is 32. The range is from 10 to 200.
The Sensitivity category allows you to change the default values in the Details View for the following:
• Lower Variation: The default value for the percentage of the lower bound that the base loading will be
varied for the sensitivity analysis. The default is 50.
• Upper Variation: The default value for the percentage of the upper bound that the base loading will be
varied for the sensitivity analysis. The default is 150.
• Number of Fill Points: The default number of points plotted on the sensitivity curve. The default is 25.
The range is from 10 to 100.
• Sensitivity For: The default fatigue result type for which sensitivity is found. The choices are:
– Life (default)
– Damage
– Factor of Safety
Frequency
The Frequency category allows you to change the default values in the Details View for the following:
• Max Number of Modes: The number of modes that a newly created frequency branch will contain. The
default is 6. The range is from 1 to 100.
• Limit Search to Range: You can specify if a frequency search range should be considered in computing
frequencies. The default is No.
• Min Range: Lower limit of search range. The default is 0.
• Max Range: Upper limit of search range. The default is 100000000.
Graphics
The Default Graphics Options category allows you to change the default values in the Details View for the fol-
lowing:
• Show Min Annotation: Indicates if Min annotation will be displayed by default (for new databases). The
default is Yes.
• Show Max Annotation: Indicates if Max annotation will be displayed by default (for new databases). The
default is Yes.
• Contour Option: Selects default contour option. The choices are:
– Smooth Contour
– Contour Bands (default)
– Isolines
– Solid Fill
– No Wireframe (default)
– Show Undeformed Wireframe
– Show Undeformed Model
– Show Elements
Meshing
Except for Relevance, the Meshing category includes the following exclusive controls for this category. There
are no counterpart settings in the Details View.
• Relevance: Allows setting of the default mesher, known as relevance. The Details View default is 0, but
can be changed here. The range is from -100 to +100.
• Unmeshable Areas: Highlights the problematic areas encountered when meshing. The choices are:
.
• Number of Retries: Number of times the mesher will try to remesh. The default is 4. The range is from 0
to 4.
The mesher will increase the fineness of the mesh with each retry in an effort to obtain a good mesh. It is
possible that the mesh will contain more elements than you intended. If this is not acceptable, you should
lower the number of retries.
• Extra Pass With Proximity Control After Failure: Performs 2 extra passes in addition to the number of
retries with a proximity control added internally. The default is Yes.
Note — If you set Number of Retries to 0, the mesher executes only one remeshing attempt, re-
gardless of the setting of Extra Pass With Proximity Control After Failure.
Miscellaneous
The Miscellaneous category allows you to change the default values in the Details View for the following:
• Load Orientation Type: Specifies the orientation input method for certain loads. This input appears in
the Define By option in the Details View of the load, under Definition.
– Vector (default)
– Component
The Image category includes the following exclusive controls for this category. There are no counterpart settings
in the Details View.
• Image Transfer Type: Defines the type of image file created when you send an image to Microsoft Word
or PowerPoint, or when you select Print Preview. The choices are:
– PNG (default)
– JPEG
– BMP
Report
The Tables category includes the following exclusive controls for this category. There are no counterpart settings
in the Details View.
• Table Border: Specifies the thickness of the tables' borders (in pixels). It will give the table more of a 3D
look. The default is 2. The range is from 0 to 10.
• Cell Spacing: Specifies the amount of space between each cell (in pixels) in a table. The default is 0. The
range is from 0 to 10.
• Cell Padding: Specifies the free space inside each cell of a table (in pixels). It will make the text and
numbers look less 'cramped' into a cell. The default is 4. The range is from 0 to 10.
The Miscellaneous category includes the following exclusive controls for this category. There are no counterpart
settings in the Details View.
• Maximum Number of Digits Trailing a decimal: Choose the number of decimals to be displayed. The
default is 2. The range is from 1 to 12.
Solution
Except for Save Ansys Files, the Solution category allows you to change the default values in the Details View
for the following:
• Save Ansys Files: Allows you to keep the Ansys solver files. The default is No. There is no relation between
this setting and the Save ANSYS db option in the Details View of a Solution object. Save Ansys Files
refers to files created by ANSYS during a solve and does not have a counterpart setting in the Details View.
Save ANSYS db refers to ANSYS creating and saving a database file in a specified location.
• Number of Processors to Use: Allows you to choose the number of processors to utilize during solution.
Setting this to 2 does not harm a single processor computer. The default is 2. The range is from 1 to 8.
• ANSYS Memory Settings: Specifies the amount of system memory used for the ANSYS workspace and
database. The following options can be set as defaults:
– Programmed Controlled: Workbench determines the best memory settings for the solve. You are
advised to use this setting unless you are fully aware of the consequences resulting from manually
inputting the settings.
– Manual: Allows you to specify the memory settings (in MB) in the WS Memory and DB Memory fields.
• WS Memory: Default setting for the workspace memory when ANSYS Memory Settings is set to
Manual.
• DB Memory: Default setting for the database memory when ANSYS Memory Settings is set to Manual.
• Solver Type: Specifies which ANSYS solver will be used. The choices are:
• Use Weak Springs: Specifies whether weak springs are added to the model. The Programmed Controlled
setting automatically allows weak springs to be added if an unconstrained model is detected, if unstable
contact exists, or if compression only supports are active. The choices are:
.
• Solution Information Tool Refresh Times (s): Specifies how often any of the result tracking items under
a Solution Information object get updated while a solution is in progress. The default is 2.5 s.
• Run Solver Process on: Specifies where the solve process will run. The following choices are available:
– Local Machine (default): Sets a synchronous solution that will run on the local desktop machine.
– WB Cluster: Solution will be submitted to a Remote Solution Manager local or web service. The latter
requires that you have a Remote Solution Manager network configured according to the ANSYS
Workbench Products Remote Solution Manager Configuration Guide (included as part of the ANSYS
Workbench Products Installation and Configuration Guides, accessible from the main menu under Help>
Installation and Licensing Help.
– LSF Cluster: Solution will be submitted to an LSF cluster (Windows only). This requires that you have
LSF, a separate product from PlatformTM Computing that manages job queues and balances machine
resources. The Workbench client machine must be a member of the LSF cluster.
• Job Assignment: Specifies whether the solution is to run on a Queue or on a specific Server.
• License to Use on Cluster/Server: Specifies the name of a valid ANSYS product license (ANSYS Profes-
sional or higher) to be used for a solution on the remote server. You can specify the license by entering
the license name or product code. For example, for an ANSYS Professional license, you can type either
ANSYS Professional or prf. See Section 3.4. Product Variable Table in the ANSYS, Inc. Licensing Guide, ac-
cessible from the main menu under Help> Installation and Licensing Help.
The Default Process Settings - Local Machine category allows you to change the default values in the Details
View for the following:
• Solver Working Directory: Allows you to change the location of the solver's temporary files and log files.
The choices are:
Note — If you do not override the Solver Working Directory, the application uses the system
working directory. The system working directory is specified through the TEMP environment
variable UNLESS the TMP variable is defined in which case it uses this variable.
The Default Process Settings - Server Assignment category allows you to change the default values in the
Details View for the following:
• Compute Server: Specifies the name of a server machine that is accessible on your network.
• User Name: Specifies a valid login name for the Machine Name that you entered.
• User Password: Specifies a valid password for the Machine Name and User Name that you entered.
• Solve Command: Specifies a valid command line for running ANSYS on the machine whose name is
entered in Machine Name.
• Working Directory: Specifies a valid directory on the machine whose name is entered in Machine Name.
The user whose name is entered in User Name must have write access to this directory.
The Default Process Settings - LSF Cluster category allows you to change the default values in the Details View
for the following:
• Queue Name: Specifies the name of a particular queue on the LSF Cluster.
The Default Process Settings - WB Cluster category allows you to change the default values in the Details View
for the following:
• Machine Name: Specifies the name of the Web Service machine that is accessible on your Remote Solution
Manager network. If you enter localhost for the Machine Name, the client machine acts as the local web
service and server.
• Queue Name: Specifies the name of a particular queue on the Remote Solution Manager network.
The Output Controls category allows you to change the default values in the Details View for the following (all
are originally set to Yes):
• Calculate Contact
• Calculate Error
• Calculate Strain
• Calculate Stress
• Calculate Thermal Flux
Startup
The Startup category includes the following exclusive controls for this category. There are no counterpart settings
in the Details View.
• Show Startup Panel: Indicates if the Simulation Wizard assistance panel should appear when you first
start the application. You might not want to see this every time you launch the application. The default
is Yes.
Visibility
The Visibility category includes the following exclusive controls for this category. There are no counterpart
settings in the Details View.
• Mesh Folder: Indicates if mesh folder should appear in the Tree Outline. You may not want to see or know
about meshes. The default is Visible.
• Part Mesh Statistics: Indicates if mesh information (the number of nodes and elements) should show in
the Details View of a part. The default is Visible.
• Fatigue Tool: Turns on/off Fatigue tool capability. The default is Visible.
• Parameter Manager: Turns on/off Parameter Manager capability. The default is Visible.
• Shape Finder: Turns on/off Shape finder capability. The default is Visible.
• Harmonic Tool: Turns on/off Harmonic Tool capability. The default is Visible.
• Contact Tool: Turns on/off Contact Tool capability. The default is Visible.
Wizard
The Wizard Options category includes the following exclusive controls for this category. There are no counterpart
settings in the Details View.
• Default Wizard: This is the URL to the XML wizard definition to use by default when a specific wizard isn't
manually chosen or automatically specified by a simulation template. The default is StressWizard.xml.
• Flash Callouts: Specifies if callouts will flash when they appear during wizard operation. The default is
Yes.
The Skins category includes the following exclusive controls for this category. There are no counterpart settings
in the Details View.
• Cascading Style Sheet: This is the URL to the skin (CSS file) used to control the appearance of the Simu-
lation Wizard. The default is Skins/System.css.
The Customization Options category includes the following exclusive controls for this category. There are no
counterpart settings in the Details View.
• Simulation Wizard URL: For advanced customization. SeeRunning the Simulation Wizard from a Custom
Location in the Customization Guide for details.
• Enable WDK Tools: Advanced. Enables the Wizard Development Kit. The WDK adds several groups of
tools to the Simulation Wizard. The WDK is intended only for persons interested in creating or modifying
wizard definitions. The default is No. See Using the Integrated Wizard Development Kit (WDK) in the Custom-
ization Guide for details.
Note —
• URLs in the Simulation Wizard follow the same rules as URLs in web pages.
• Relative URLs are relative to the location of the Simulation Wizard URL.
• Absolute URLs may access a local file, a UNC path, or use HTTP or FTP.
Variables
Variables provide you the capability to override default settings.
To set variables:
1. Choose Variable Manager from the Tools menu.
2. Click in the row to add a new variable.
3. Type a value.
4. Click OK.
Status
The status box indicates if a particular variable is active or not. Checked indicates that the variable is active. Un-
checked indicates that the variable is available but not active. This saves you from typing in the variable and re-
moving it.
Macros
Simulation allows you to execute custom functionality that is not included in a standard Simulation menu entry
via its Run Macro feature. The functionality is defined in a macro - a script that accesses the Simulation application
programming interface (API).
Macros can be written in Microsoft's JScript or VBScript programming languages. Several macro files are provided
with the ANSYS Workbench installation under \ANSYS Inc\v100\AISOL\DesignSpace\DSPages\macros. Macros
cannot currently be recorded from Simulation. Also see the Customization Guide for additional information about
the use of JScript.
The ANSYS Workbench API is documented and available to Workbench-licensed developers. Please contact
ANSYS, Inc. for more information on the Workbench programming capabilities.
If you open a .dsdb file that includes multi body parts (formerly known as “generalized bodies”), and was created
in ANSYS DesignSpace version 7.0 or a previous version, that file will not include any meshing data or results
data.
If you open a .dsdb file that was created in version 6.1 or 7.0 having AGP version 6.1 or 7.0 models, these models
will lose all associativity after updating the .dsdb file. You will need to re-link the Environment to the geometry.
If you created custom shortcuts in ANSYS DesignSpace version 7.0, which were based on predefined shortcuts
supported with that product (called “simulation templates”), they will need to be modified to be used as shortcuts
in Simulation under ANSYS Workbench 10.0.
Caution: Please note that meshed and/or solved databases from ANSYS Workbench 8.1, or earlier versions,
that are migrated into version 10.0 will be in an obsolete state. This means that they cannot be migrated
into the current version of Workbench in the meshed or solved state. Simply re-mesh and/or re-solve
databases prior to version 9.0 to resolve this condition.
Physics Filter
You can set a Physics Filter under the View menu. When chosen, a Physics Filter makes available toolbar and
menu options at the Environment and Solution levels that apply only to the chosen type of physics. For example,
in a thermal only analysis, you would set the Thermal Physics Filter on (depressed icon under View> Physics
Filter> Thermal), and the Structural Physics Filter to off. The following items would then be unavailable:
• Structural and Electromagnetic items in the Environment and Solution context toolbars.
• Structural loads and supports and Electromagnetic boundary conditions and excitations that you would
insert at the Environment level of the tree.
• Structural and Electromagnetic result items that you would insert at the Solution level of the tree.
An application for turning all items in the Physics Filter off is for types that are not supported in Simulation but
are supported in ANSYS. For these cases, you can have Simulation write an ANSYS input file, as described in a
related section.
Physics Filter settings are saved as program preferences and will remain unchanged from project to project
until reset. When beginning Simulation, the Physics Filter turns on all physics types by default.
Attaching Geometry
To Attach Geometry, refer to:
If the name of the geometry file is not listed, click the Browse... button.
2. Choose the part or file name and set the preferences under the Default Geometry Options group and
the Advanced Geometry Defaults group.
3. Click New simulation under the CAD Geometry Tasks group to start the attach process.
• Attaching geometry in plug-in mode: requires that the CAD system be running. To attach a geometry
in plug-in mode, open a document (part/assembly) first in a CAD system. Then select Simulation from the
ANSYS 10.0 menu to attach the geometry automatically. For this to work, it is required that the part file
exist. If the part file is not recognized, the attach process will have to go through the ANSYS Workbench
Start Page. This can also be directly activated through the Workbench menu item in the ANSYS 10.0
menu. If you have to go through the Start Page, you can create a new project, open an existing project
or import a Simulation database from a particular directory that has write access. When you are in the
Project Page, you will see your part name listed under the Link to Active CAD Geometry group. If it is
not listed, you will need to click Refresh. Once your part is listed there, click this part and then set the
preferences under the Default Geometry Options group and the Advanced Geometry Defaults group.
Afterward, click the New simulation task under the CAD Geometry Tasks group to start the attach process.
• Attaching geometry in reader mode: does not require that the CAD system be running. To attach a
geometry in reader mode, start the ANSYS Workbench (Start> Programs> ANSYS 10.0> ANSYS Work-
bench). After opening a project, click the Browse... button under the Link to Geometry File group and
select the part file whose geometry you want to attach into Simulation. Then set the preferences under
the Default Geometry Options group and the Advanced Geometry Defaults group. Afterward, click
the New simulation task under the CAD Geometry Tasks group to start the attach process.
Geometry Setup
After you attach the geometry from the Project Page, Simulation opens and displays the model, along with a
Choose Simulation Template panel on the right that allows you the opportunity to add typically used items
to the Solution object in the tree. Available templates are grouped under General Simulation (Fatigue Branch,
Frequency Branch, Shape Branch, Thermal Branch), and Structural Simulation (Stress Branch — Brittle
Material, Stress Branch — Ductile Material). Choose a template by highlighting the Solution object and
clicking on a simulation template branch. Items that are typically used for the branch that you chose are added
under the Solution object. The Simulation Wizard panel then replaces the Choose Simulation Template panel
after the items are added to the Solution object. The appearance of the Choose Simulation Template can be
turned off using the Startup category under Simulation in the Options dialog box.
You can update your geometry by also using the Geometry button:
• Update: Use Simulation Parameter Values attempts to update the CAD model to the parameter values
set currently displayed in Simulation. If successful, the updated geometry is sent back to Simulation. This
option is necessary only if Simulation is being used to drive the design of the CAD model.
• Update: Use Geometry Parameter Values synchronizes the Simulation model to the CAD model. This
will read the latest geometry and process other data (parameters, attributes, etc.) based on the current
user preferences for that model. Coordinate systems defined in DesignModeler or SolidWorks are updated
as well.
Note — If you change either the number of turns or the thickness properties associated with a
body, these changes are not updated to the CAD model when you choose either Update: Use
Simulation Parameter Values or Update: Use Geometry Parameter Values.
If you change any CAD parameters in Simulation, you must click Update: Use Simulation Parameter Values
to implement the change (and the solution will change to the unsolved state).
Model Dimensions
When you attach your geometry or model, the model dimensions display in the Section : Details View in the
Bounding Box sections of the Geometry or Part objects. Dimensions have the following characteristics:
To see the dimensions of your attached geometry, click Geometry in the Section : Tree Outline. The Section :
Details View appears, providing the details of your geometry.
Note — If density is temperature dependent, then the density value at 22oC (default reference temperature
for an environment) will be used to compute the Mass that is displayed in the Details View.
Materials
Once you have attached your geometry, you can choose a material for the simulation. When you select a part
in the tree outline, the Material entry in the Details View lists a default material for the part. You can perform
the following tasks involving materials:
• The dialog box displays a list of library files in the Data Source field.
• The default library file is the Workbench_Samples.xml library supplied with the application.
• From this option, you can Add or Remove data libraries from the list.
• As different libraries are added, they display in the list as recently used files. By selecting a source
and clicking Remove you can delete the source from this list.
• The materials associated with the selected library file are displayed in the bottom half of the dialog
box.
3. From the Material Data to Import field, choose a material to assign to the part and then click OK. The
material is assigned to the part(s).
Note — Materials are assigned to parts in Simulation, however the properties of the material can only be
changed using the Engineering Data.
Setting the Nonlinear Material Effects control in the Details View to No allows you the option of ignoring
nonlinear material effects for a particular body, avoiding the need to define a duplicate material in this situation.
The following nonlinear material effects can be ignored:
In an Electromagnetic simulation, you can orient a polarization axis for a Linear or Nonlinear Hard material in
either the positive or negative x direction with respect to a local or global coordinate system. Use the Material
Polarization setting in the Details View for each body to establish this direction. The Material Polarization
setting appears only if a hard material property is defined for the body. For a cylindrical coordinate system, a
positive x polarization is in the positive radial direction, and a negative x polarization is in the negative radial
direction.
Branches
A branch is an outline that contains appropriate results for a particular simulation type. If you choose not to use
the wizards to prompt you for a simulation type, you may choose to insert a branch. To insert an outline branch,
highlight the Environment or Solution node, then click Insert > Outline Branch. The Outline Branch Macros
wizard displays, showing the kinds of branches (simulations) you can add. The lower portion of the Outline
Branch Macros wizard panel includes fields for entering input data that is specific to the particular simulation
type you choose at the top of the panel. As an example, presented below are the input fields that appear if you
select the Transient Thermal radio button.
After choosing the Run button, the appropriate branches are added to the tree and the associated simulation
wizard is displayed in place of the Outline Branch Macros wizard.
You may freely hide, show and choose wizards any time in the simulation.
Types of Branches
Structural Simulation - Ductile Material
Structural Simulation - Brittle Material
Fatigue Branch
Thermal Branch
Transient Thermal Branch
Electromagnetic Branch
Frequency Branch
Shape Branch
Fatigue Branch
In addition to the objects found in the Structural Simulation - Ductile Material, this branch includes a Fatigue
Tool in order to determine if a failure due to fatigue is a possibility. Includes life and fatigue safety factor results
under the Fatigue Tool.
Thermal Branch
Provides temperature and total heat flux results.
Electromagnetic Branch
Calculates results for a body or assembly with electromagnetic loading, including total flux density and total
field intensity.
Frequency Branch
Determines the fundamental frequencies and mode shapes.
Shape Branch
Inserts a shape finder, which for a given structural loading scenario, gives the user some measure of the best
location to remove material from the structure to make it lighter while maximizing structural compliance.
Solids
You can process and solve solid models, including individual parts and assemblies. An arbitrary level of complexity
is supported, given sufficient computer time and resources.
Surface Models
You can import surface models from the DesignModeler, UG, Solid Edge, SolidWorks, and Pro/Engineer CAD
systems, as well as CATIA, IGES, Parasolid, and SAT files. The IGES, Parasolid, and SAT surface files may actually
come from other CAD systems, such as Solid Edge. Surface models are often generated using mid surface extrac-
tion, but not always. UG has a mid surface extraction capability. In the case of IGES, SAT, and Parasolid, surface
models can be generated in a variety of ways.
Single surfaces, multiple surfaces (connected by spot welds), surfaces and lines can be analyzed.
You should work with UG to clean and repair your surface models.
Note — If you want to retain a preference selection in the Project Page, you must first save before exiting
the ANSYS Workbench.
Parts are a grouping or a collection of bodies. Parts can include multiple bodies and are referred to as multi body
parts. The mesh for multi body parts will share nodes where the bodies touch one another, that is, they will have
common nodes at the interfaces. This is the primary reason for using multi body parts. The only viable multi
body parts include the following combinations:
• Bodies grouped into a part result in connected geometry and shared nodes in a mesh.
• Each body may be assigned a different material.
• Bodies can be hidden for easier visibility.
• Bodies in a part group can be individually suppressed, which effectively eliminates these bodies from
treatment. A suppressed body is not included in the statistics of the owning part or in the overall statistics
of the model.
• Bodies can be assigned Full or Reduced integration schemes, as described above for parts.
• When bodies in part groups touch they will share nodes where they touch. This will connect the bodies.
If a body in a part group does not touch another body in that part group, it will not share any nodes. It
will be free standing. Automatic contact detection is not performed between bodies in a part group.
Automatic contact detection is performed only between part groups.
• Hide All Other Bodies, allows you to show only selected bodies.
• Suppress All Other Bodies, allows you to unsuppress only selected bodies.
In order for multiple bodies inside a part to be properly connected by sharing a node in their mesh the bodies
must share a face or edge. If they do not share a face or an edge the bodies will not be connected for the analysis
which could lead to rigid body motion.
For a solid body within a multi body part that does not touch another body, Contact objects can be inserted to
connect the bodies. This must be done manually. Automatic contact detection is only performed between
bodies between different parts.
Startup restrictions apply when opening and updating a .dsdb file created in version 6.1 or 7.0 that contains
AGP version 6.1 or 7.0 models.
Point Mass
You can idealize the inertial effects from a body using a Point Mass. Applications include applying a force with
an acceleration or any other body load; or adding inertial mass to a structure, which affects modal and harmonic
solutions.
To insert a Point Mass, select a Geometry branch and either choose Point Mass from the toolbar, or right mouse
button click and choose Insert> Point Mass from the context menu. You then apply it on a face of a solid or
surface model, or on an edge of a surface model. The location of the Point Mass can be anywhere in space and
can also be defined in a local coordinate system if one exists.
Coordinate Systems
The following coordinate system capabilities are available in Simulation. Cartesian coordinate systems apply in
all cases. You can also apply cylindrical coordinates to parts and Forces applied to surfaces.
If a coordinate system was brought in from one of these products but changed in Simulation, the change
will not be reflected on an update. Upon an update, a coordinate system that originated from Design -
Modeler, Pro/ENGINEER, or SolidWorks will be re-inserted into the object tree. The coordinate system that
was modified in Simulation will also be in the tree.
• Apply created or imported local coordinate systems to a part, or to a Point Mass, Acceleration, Standard
Earth Gravity, Rotational Velocity, Force, Bearing Load, Remote Force, Moment, Displacement, Remote
Displacement, or Contact Reaction. This feature is useful because it avoids having to perform a calculation
for transforming to the global coordinate system.
1. Select the part, Point Mass, Acceleration, Standard Earth Gravity, Rotational Velocity, Force, Bearing
Load, Remote Force, Moment, Displacement, Remote Displacement, or Contact Reaction object in
the tree.
2. For an Acceleration, Rotational Velocity, Force, Bearing Load, or Moment, in the specific Details View,
under Define By, select Components then proceed to step 3. For the other items, proceed directly
to step 3.
3. Under Coordinate System, select the name of the local coordinate system that you want to apply.
The names in this drop-down list are the same names as those listed in the Coordinate Systems
branch of the tree outline.
Note — If you define a load by Components in a local coordinate system, changing the
Define By field to Vector will define the load in the global coordinate system. Do not change
the Define By field to Vector if you want the load defined in a local coordinate system.
Any coordinate system defined in Simulation and sent to ANSYS as part of the finite element model, will
be added to the ANSYS input file as LOCAL commands. For example:
/com,*********** Send User Defined Coordinate System(s) ***********
local,11,0,0.,0.,0.,0.,0.,0.
local,12,1,11.8491750582796,3.03826387968126,-1.5,0.,0.,0.
csys,0
If you create a coordinate system, the coordinate system reference number (first argument of the LOCAL
command) is assigned automatically. You can however specify a particular reference number for identi-
fication or quick reference of the coordinate system within the input file. You accomplish this using the
Advanced control settings in the Details View of a Coordinate System object.
1. Set Ansys System to Manual. This causes an Ansys System Number setting to appear.
2. Set Ansys System Number to a value greater than or equal to 12.
If you create more than one local coordinate system, you must ensure that you do not duplicate the
Ansys System Number.
Contact
You can transfer structural loads and heat flows across the contact boundaries and “connect” the various parts.
See the Contact section for details.
Spot Welds
Spot welds are used to connect individual surface parts together to form surface model assemblies, just as contact
is used for solid part assemblies. Structural loads are transferred from one surface part to another via the spot
weld connection points, allowing for simulation of surface model assemblies.
Spot weld objects are located in the Contact object in the Section : Tree Outline. When selected in the tree, they
appear in the graphical window highlighted by three concentric circles about the underlying vertices, with an
annotation.
If a surface model contains spot weld features in the CAD system, then spot welds are auto-generated when the
model is read into Simulation or when Generate Contact on Update is set to Yes in the Details view of the
Contact object in the Section : Tree Outline. This is similar to the way in which Simulation automatically constructs
contact condition when reading in assemblies of solid models.
You can manually generate spot welds as you would insert any new object into the Outline tree. Either insert a
spot weld object from the context menu and then pick two appropriate vertices in the model, or pick two appro-
priate vertices and then insert the spot weld object.
You can define spot welds for CAD models that do not have a spot weld feature in the CAD system, as long as
the model contains vertices at the desired locations. You must define spot welds manually in these cases.
Spot welds only transfer structural loads and structural effects between surface parts. Therefore they are appro-
priate for displacement, stress, elastic strain, and frequency solutions.
DesignModeler generates spot welds. The only CAD system whose spot welds can be fully realized in ANSYS
Workbench at this time is Unigraphics. The APIs of the remaining CAD systems either do not handle spot welds,
or the ANSYS Workbench software does not read spot welds from these other CAD systems.
Virtual Topology
You can use virtual topology to aid you in reducing the number of elements in the model, simplifying small
features out of the model, and simplifying load abstraction. See Virtual Topology Overview for details.
Graphics
Section : Annotations
Section : Controls
Section : Figures
Annotations
Basics
Highlight and Selection Graphics
Scope Graphics
Annotation Graphics and Positioning
Environment Annotations
Solution Annotations
Message Annotations
Basics
Annotations provide the following visual information:
• Boundary of the scope region by coloring the geometry for edges, surfaces or points.
• An explicit point within the scope.
• A 3D arrow to indicate direction, if applicable.
• Text description or a value.
• A color cue (structural vs. thermal, etc.).
Scope Graphics
In general, selecting an object in the Section : Tree Outline displays its Scope by painting the geometry and displays
text annotations and symbols as appropriate. The display of scope via annotation is carried over into the Section :
Report Preview if you generate a figure.
Contours are painted for results on the scoped geometry. No boundary is drawn.
Use the pointer after selecting the Label toolbar button for managing annotations and to drag the
annotation to a different location within the scope.
• If other geometry hides the 3D point (e.g. the point lies on a back face) the block arrow is unfilled (trans-
parent).
• The initial placement of an annotation is at the pick point. You can then move it by using the Label toolbar
button for managing annotations.
• Drag the label to adjust the placement of an annotation. During the drag operation the annotation moves
only if the tip lies within the scope. If the pointer moves outside the scope, the annotation stops at the
boundary.
Environment Annotations
With the Environment object selected in the Section : Tree Outline, an annotation for each load and support
appears on the geometry:
The label fill color indicates the type or state of the annotation. Here are some examples:
Solution Annotations
Solution annotations work similar to Environment Annotations. The Max annotation has red background. The
Min annotation has blue background. Probe annotations have cyan backgrounds.
• By default, annotations for Max and Min appear automatically for results but may be controlled by buttons
in the Result Context Toolbar or by Simulation preferences in the Options dialog box.
•
You may create “probe” annotations by clicking in the Result Context Toolbar. Probe an-
notations show the value of the result at the location beneath the tip, when initially constructed. They
are not saved to the database.
• If you apply a probe annotation to a very small thickness, such as when you scope results to an edge, the
probe display may seem erratic or non-operational. This is because, for ease of viewing, the colored edge
result display is artificially rendered to appear larger than the actual thickness. You can still add a probe
annotation in this situation by zooming in on the thin region before applying the probe annotation.
•
To delete a probe annotation, activate the Label button , select the probe, and then press the
[Delete] key.
• Probes will be cleared if the results are re-solved.
• See the Solution Context Toolbar for more information.
Message Annotations
If an error occurs during meshing, the application attempts to annotate the problem geometry.
Controls
When you click Model in the Section : Tree Outline, you can view details that control lighting in the Section :
Geometry window.
Figures
Figures allow you to:
Clicking the Figure button in the Section : Standard Toolbar creates a new Figure object inside the selected
object in the Section : Tree Outline. Any object that displays 3D graphics may contain figures. The new figure
object copies all current view settings and gets focus in the Outline automatically.
• Camera settings
• Result toolbar settings
• Legend configuration
A figure's view settings are fully independent from the global view settings. Global view settings are maintained
independently of figures.
Behaviors:
• If you select a figure after selecting its parent in the Outline, the graphics window transforms to the figure's
stored view settings automatically (e.g. the graphics may automatically pan/zoom/rotate).
• If you change the view while a figure is selected in the Outline, the figure's view settings are updated.
• If you reselect the figure's parent in the Outline, the graphics window resumes the global view settings.
That is, figure view settings override but do not change global view settings.
• Figures always display the data of their parent object. For example, following a geometry Update and
Solve, a result and its figures display different information but reuse the existing view and graphics options.
Figures may be moved or copied among objects in the Outline to display different information from the
same view with the same settings.
• You may delete a figure without affecting its parent object. Deleting a parent object deletes all figures
(and other children).
• In the Section : Tree Outline, the name of a figure defaults to simply Figure appended by a number as
needed.
• You may enter a caption for a figure as a string in the figure's details. It is your responsibility to maintain
custom captions when copying figures.
Applying Loads
Note — All loads and supports are applicable to a 2-D or 3-D simulation except where noted in the de-
scription of the specific load or support.
Types of Loads
Global Loads
Section : Acceleration
Section : Standard Earth Gravity
Section : Rotational Velocity
Structural Loads
Section : Pressure Loads
Section : Force Load
Remote Force Load
Section : Bearing Load
Bolt Load
Section : Moment
Section : Generalized Plane Strain
Section : Thermal Condition
Inertia Relief
Section : Motion Load
Thermal Loads
Section : Convection
Section : Temperature
Section : Radiation
Section : Internal Heat Generation
Section : Heat Flux
Section : Heat Flow
Section : Perfectly Insulated
Note — Some thermal loads are also supported for a transient simulation.
Acceleration
Translational acceleration accounts for the structural effects of a constant linear acceleration.
The global Acceleration load defines the linear acceleration of the structure in each of the global Cartesian axis
directions. To simulate gravity (by using inertial effects), accelerate the structure in the direction opposite to
gravity. Units are length/time2. For example, apply a positive acceleration to simulate gravity acting in the neg-
ative Y direction as shown below.
Resulting deformation.
Note — While loads are associative with geometry changes, load directions are not. This applies to any
load that requires a vector input, such as: moment, acceleration, rotational velocity, force, and bearing
load.
• Define the vector in terms of any of the following directions in the world coordinate system or local co-
ordinate system, if applied:+x, -x, +y, -y, +z, -z.
• Gravity is a specific example of acceleration.
• The magnitude is set: 9.80665 m/s2 (in metric units)
• The direction is changeable.
• The vector is added to acceleration when it is present.
Rotational Velocity
Rotational velocity accounts for the structural effects of a part spinning at a constant rate.
• a magnitude and an axis of rotation (based on selected geometry) [Define By: Vector]
• a point and components (in the world coordinate system or local coordinate system, if applied) [Define
By: Components]
Magnitude
Axis of rotation
Point
Vector
For 2-D plane stress and plane strain simulations, a Rotational Velocity load can be applied about an individual
x, y, or z-axis. Combinations of x and y components can be applied, but combinations of x and z components
cannot be applied, and combinations of y and z components cannot be applied.
For 2-D axisymmetric simulations, a Rotational Velocity load can only be applied about the y-axis.
Note — While loads are associative with geometry changes, load directions are not. This applies to any
load that requires a vector input, such as: moment, acceleration, rotational velocity, force, and bearing
load.
Pressure Loads
For 3-D simulations, a pressure load applies a pressure to one or more flat or curved surfaces.
Pressure is uniform and acts normal to a surface at all locations on the surface. A positive pressure acts into the
surface, compressing the solid body.
If you select multiple surfaces when defining the pressure, the same pressure value gets applied to all selected
surfaces.
If a pressurized surface enlarges due to a change in CAD parameters, the total load applied to the surface increases,
but the pressure (force per unit area) remains constant.
For 2-D simulations, a pressure load applies a pressure to one or more edges.
Force Load
There are three types of forces:
Surface
Edge
Vertex
Surface
Distributes a force vector across one or more flat or curved surfaces.
Force vector
If you select multiple surfaces when defining the force, the magnitude gets apportioned across all selected surfaces.
If a surface enlarges due to a change in CAD parameters, the total load applied to the surface remains constant,
but the pressure (force per unit area) decreases.
If you try to apply a force to a multiple surface selection that spans multiple parts, the surface selection is ignored.
The geometry property for the load object displays 'No Selection' if the load was just created, or it maintains its
previous geometry selection if there was one.
Edge
Distributes a force vector along one or more straight or curved edges.
Force vector
If you select multiple edges when defining the force, the magnitude gets apportioned across all selected edges.
If an edge enlarges due to a change in CAD parameters, the total load applied to the edge remains constant, but
the line load (force per unit length) decreases.
A force applied to an edge is not realistic and leads to singular stresses (that is, stresses that approach infinity
near the loaded edge). You should disregard stress and elastic strain values in the vicinity of the loaded edge.
If you try to apply a force to a multiple edge selection that spans multiple parts, the edge selection is ignored.
The geometry property for the load object displays 'No Selection' if the load was just created, or it maintains its
previous geometry selection if there was one.
Vertex
Applies a force vector to one or more vertices.
Force vector
If you select multiple vertices when defining the force, the magnitude gets apportioned across all selected vertices.
A force applied to a vertex is not realistic and leads to singular stresses (that is, stresses that approach infinity
near the loaded vertex). You should disregard stress and elastic strain values in the vicinity of the loaded vertex.
While loads are associative with geometry changes, load directions are not. This applies to any load that requires
a vector input, such as: moment, acceleration, rotational velocity, force, and bearing load.
If you try to apply a force to a multiple vertex selection that spans multiple parts, the vertex selection is ignored.
The geometry property for the load object displays 'No Selection' if the load was just created, or it maintains its
previous geometry selection if there was one.
A remote force load can be used as an alternative to building a rigid part and applying a force load to it. The
advantage of using a remote force load is that you can directly specify the location in space from which the force
originates.
You apply a remote force load like you apply a force load except that the location of the load origin can be replaced
anywhere in space either by picking or by entering the XYZ locations directly. The default location is at the origin
of the global coordinate system. The location and the direction of a remote force can be defined in the global
coordinate system or in a local coordinate system.
A remote force can be applied to a face of a solid model, or to an edge or a face of a shell model.
While loads are associative with geometry changes, load directions are not. This applies to any load that requires
a vector input, such as: moment, acceleration, rotational velocity, force, and bearing load.
Bearing Load
Applies a variable distribution of force to one complete right cylinder in a 3-D simulation, or to a circular edge
in a 2-D simulation.
In a 3-D simulation, a complete right cylinder is capped on both ends by circles normal to the axis of the cylinder.
Load direction
Given an arbitrary force direction, the bolt force is decomposed into two components, radial and axial. The radial
component is distributed based on the projected surface area with respect to the radial force direction. It
therefore acts on elements where the dot product between the force vector and surface normal is negative
(meaning that the force is applied to the model in a compressive fashion). The axial component is uniformly
distributed over the entire surface.
If the loaded surface enlarges (e.g., due to a change in parameters), the total load applied to the surface remains
constant, but the pressure (force per unit area) decreases.
Note —
• While loads are associative with geometry changes, load directions are not. This applies to any
load that requires a vector input, such as: moment, acceleration, rotational velocity, force, and
bearing load.
• If your CAD system split the cylinder into two or more surfaces, select all of the surfaces when
defining the bearing load.
• Use one bearing load per cylinder. Do not use multiple select to apply a bearing load to different
cylinders. If you do, the load is divided among the multiple cylindrical surfaces by area ratio, as
shown in the following example of a single bearing load applied to two cylinders. The length of
the cylinder on the right is twice the length of the cylinder on the left. Note that the reactions are
proportional to each cylinder's area as a fraction of the total load area.
Bolt Load
Available for 3-D simulations only.
Applies a pretension load to a cylindrical surface or to a body, typically to model a bolt under pretension. If you
apply the bolt load to a body, you will need to have a local Coordinate System object in the tree. The application
of the bolt load will be at the origin and along the z-axis of the local coordinate system. You can place the co-
ordinate system anywhere in the body and reorient the z-axis.
This load is applicable to pure structural (static and sequenced) or thermal-stress simulations. You specify how
the bolt load is applied by choosing one of the following options under the Define By setting in the Details View.
• Load: Applies a force as a preload. A Load field is displayed where you enter the value of the load in force
units.
• Adjustment: Applies a length as a preadjustment (for example, to model x number of threads). An Ad-
justment field is displayed where you enter the value of the adjustment in length units.
• Lock (displayed only for sequenced simulations): Fixes all displacements. For static simulations, this state
is applied automatically as a second load step (see below). For sequenced simulations, you can set this
state for any load step except the first load step.
• Open (displayed only for sequenced simulations): Use this option to leave the bolt load open so that the
load has no effect on the applied step, effectively suppressing the load for the step. Note that in order to
avoid convergence issues from having underconstrained conditions, a small load (0.01% of the maximum
load across the steps) will be applied. For sequenced simulations, you can set this state for any load step.
Presented below is the same model showing a pretension bolt load as a preload force and as a preadjustment
length:
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
The specific user interaction and Workbench process for an analysis with pretension bolt loads is as follows:
Limitations
The following limitations apply to using bolt loads:
• If you try to apply a preload on the same surface more than once, all definitions except the first one are
ignored.
• Be sure that a sufficiently fine mesh exists on a surface or body that contains pretension bolt loads so that
the mesh can be correctly partitioned along the axial direction (that is, at least 2 elements long).
• For simulating one bolt through multiple split surfaces, you should apply only one pretension bolt load
to one of the split surfaces, as the bolt load will slice though the whole cylinder even though only part of
the cylinder is selected.
• Care should be used when applying a pretension load to a cylindrical surface that has bonded contact.
There is a possibility that if you apply a pretension load to a cylinder that had a bonded contact region,
the bonded contact will block the ability of the pretension load to deform properly.
• The pretension load should be applied to cylindrical surfaces that contain the model volume (that is, do
not try to apply the pretension load to a hole).
Moment
Distributes a moment about an axis across one or more flat or curved surfaces.
Load direction
Moment load
Affected surface
The moment is applied “about” the vector. Use the right-hand rule to determine the sense of the moment.
If you select multiple surfaces when defining the moment, the magnitude gets apportioned across all selected
surfaces.
If a surface enlarges (e.g., due to a change in parameters), the total load applied to the surface remains constant,
but the load per unit area decreases.
If you try to apply a moment to a multiple selection that spans multiple parts, the selection is ignored. The geo-
metry property for the moment object displays 'No Selection' if the load was just created, or it maintains its
previous geometry selection if there was one.
Note —
• If you are using a surface model, you can apply a moment load to an edge or vertex.
• While loads are associative with geometry changes, load directions are not. This applies to any
load that requires a vector input, such as: moment, acceleration, rotational velocity, force, and
bearing load.
The Details View includes settings for controlling the items listed below. Refer to Section : Using Generalized
Plane Strain for detailed information on these settings and on the overall application of this load.
– Free
– Force
– Displacement
• Establishing the boundary conditions for rotation about the x-axis and the y-axis. Choices for the boundary
conditions are:
– Free
– Moment
– Rotation
Specific reactions are also reported in the Details View after solving.
Thermal Condition
Applies a uniform temperature (default) or non-uniform temperature throughout an environment in a static
simulation. The initial value for a uniform temperature equals the reference temperature for the environment.
The non-uniform temperature is applicable to a thermal-stress simulation where this temperature is from another
environment in the project that includes thermal results. The non-uniform temperature can be time dependent.
For example, a temperature that occurs at a specific time in the results of a thermal transient simulation can be
used as the non-uniform temperature for a Thermal Condition load applied in the environment of a static sim-
ulation.
Note —
• If the environment that includes the non-uniform temperature does not exist (for example,
if the environment was deleted), the Thermal Condition object changes to the underdefined
state.
• Convergence objects inserted under an environment that is referenced by a Thermal Con-
dition load object will invalidate the Thermal Condition object, and not allow a solution to
progress.
• Thermal Condition objects cannot be copied from a single step environment to a multiple
step sequenced environment, or vice-versa. Also, if you copy a Thermal Condition load from
one sequenced environment to another, the number of steps must match between the two
environments.
Note — If you choose Generate Static Environment with Thermal Condition to create more
than one static environment, each new environment object is named Thermal Stress. The object
title is not incremented (Thermal Stress 1, Thermal Stress 2, etc.) as is the case if the Model
object is duplicated.
Inertia Relief
Calculates accelerations to counterbalance the applied loads. Displacement constraints on the structure should
only be those necessary to prevent rigid-body motions (6 for a 3-D structure). The sum of the reaction forces at
the constraint points will be zero. Accelerations are calculated from the element mass matrices and the applied
forces. Data needed to calculate the mass (such as density) must be input. Both translational and rotational ac-
celerations may be calculated.
This option applies only to the structural, static, linear analyses. Displacements and stresses are calculated as
usual.
Motion Load
The application interacts with motion simulation software such as Dynamic Designer™ from MSC, and MotionWorks
from Solid Dynamics. Motion simulation software allows users to define and analyze the motion in an assembly
of bodies. One of the computed results from the motion simulation is forces and moments at the joints between
the bodies in the assembly. Choosing Insert Motion Loads (from the Insert menu or from a right-mouse click
menu item on an Environment) allows you to import these loads into the Environment.
Inertial State
If the part of interest is a moving part in the assembly, the frame loads file gives the inertial state of the body.
This includes gravitational acceleration, translational velocity and acceleration, and rotational velocity and accel-
eration. Of these inertial “loads” only the rotational velocity is applied in the environment. The remaining loads
are accounted for by solving with inertia relief (see below).
If the part of interest is grounded (not allowed to move) in the motion simulation, corresponding supports need
to be added in the environment before solving.
Joint Loads
For each joint in the motion simulation, the frame loads file reports the force data - moment, force, and 3D location
- for the frame. Features are also identified so that the load can be applied to the appropriate face(s) within the
application. These features are identified by the user in the motion simulation software before exporting the
frame loads file. For all nonzero moments and forces, a corresponding “Moment” and “Remote Force” are attached
to the face(s) identified in the frame loads file.
The Remote Force takes into account the moment arm of the force applied to the joint.
Weak springs are also enabled. The computed reaction forces in the weak springs should be negligible.
This option will automatically be turned on if you import any motion loads.
Note — Material properties have to be manually set to match density used in motion analysis.
Modifying Loads
You can modify loads that have been inserted, but you should only do so with great care. Modifying loads in
Simulation after importing from the motion simulation software will nullify the original loading conditions sets
in the motion simulation software. Therefore, you need to examine your results in Simulation carefully.
Convection
Available for 3-D simulations, and 2-D simulations for Plane Stress and Axisymmetric behaviors only.
Causes convective heat transfer to occur through one or more flat or curved surfaces (in contact with a fluid).
The bulk fluid temperature is uniform and measured at a distance from the surface outside of the thermal
boundary layer. The surface temperature refers to the temperature at the surface of the simulation model.
The film coefficient (also called the heat transfer coefficient or unit thermal conductance) is based on the com-
position of the fluid in contact with the surface, the geometry of the surface, and the hydrodynamics of the fluid
flow past the surface. It is possible to have a temperature dependent film coefficient. Temperature dependent
convection coefficients are defined and managed using Engineering Data application. Refer to heat transfer
handbooks or other references to obtain appropriate values for film coefficient.
The film coefficient value can be evaluated at the average film temperature (average of surface and bulk temper-
atures), the surface temperature, the bulk temperature, or the absolute value of the difference between bulk
and surface temperatures. You can specify this evaluation procedure in Engineering Data using Coefficient Type
in the Property Attributes section. Available coefficient types include:
where
• q/A is heat flux out of the surface (calculated within the application)
• h is the film coefficient (you provide)
• ts is the temperature on the surface (calculated within the application)
When the fluid temperature exceeds surface temperature, energy flows into a part. When the surface temperature
exceeds the fluid temperature, a part loses energy.
If you select multiple surfaces when defining convection, the same bulk fluid temperature and film coefficient
is applied to all selected surfaces.
Temperature
Available for 3-D simulations, and 2-D simulations for Plane Stress and Axisymmetric behaviors only.
Temperature
If you select multiple surfaces when defining the temperature, the same value gets applied to all selected surfaces.
Temperature
If you select multiple edges when defining the temperature, the same value gets applied to all selected edges.
Temperature
If you select multiple vertices when defining the temperature, the same value gets applied to all selected vertices.
Radiation
Applies thermal radiation to a face of a 3-D model, or to an edge of a 2-D model. All the radiation energy is ex-
changed with the Ambient Temperature, that is, the Form Factor1 is assumed to be 1.0.
You can set the following radiation properties in the Details View of a Radiation object:
• Emissivity: The ratio of the radiation emitted by a surface to the radiation emitted by a black body at the
same temperature.
• Ambient Temperature: The temperature of the surrounding space.
Note — 1Radiation exchange between surfaces is restricted to gray-diffuse surfaces. Gray implies that
emissivity and absorptivity of the surface do not depend on wavelength (either can depend on temper-
ature). Diffuse signifies that emissivity and absorptivity do not depend on direction. For a gray-diffuse
surface, emissivity = absorptivity; and emissivity + reflectivity = 1. Note that a black body surface has a
unit emissivity.
1 - Refer to the Radiation chapter in the ANSYS Thermal Analysis Guide within the ANSYS Help for more information.
A positive heat generation acts into a body, adding energy to it. Heat generation is defined as energy per unit
time per unit volume.
If you select multiple bodies when defining the heat generation, the same value gets applied to all selected
bodies.
If a body enlarges due to a change in CAD parameters, the total load applied to the body increases, but the heat
generation remains constant.
Heat Flux
Available for 3-D simulations, and 2-D simulations for Plane Stress and Axisymmetric behaviors only.
A positive heat flux acts into a surface, adding energy to a body. Heat flux is defined as energy per unit time per
unit area.
If you select multiple surfaces when defining the heat flux, the same value gets applied to all selected surfaces.
If a surface enlarges due to a change in CAD parameters, the total load applied to the surface increases, but the
heat flux remains constant.
Heat Flow
Available for 3-D simulations, and 2-D simulations for Plane Stress and Axisymmetric behaviors only.
A positive heat flow acts into a surface, adding energy to a body. Heat flow is defined as energy per unit time.
If you select multiple surfaces when defining the heat flow rate, the magnitude gets apportioned across all selected
surfaces.
If a surface enlarges due to a change in CAD parameters, the total load applied to the surface remains constant,
but the heat flux (heat flow rate per unit area) decreases.
If you try to apply a heat flow to a multiple surface selection that spans multiple bodies, the surface selection is
ignored. The geometry property for the load object displays No Selection if the load was just created, or it
maintains its previous geometry selection if there was one.
A positive heat flow acts into an edge, adding energy to a body. Heat flow is defined as energy per unit time.
If you select multiple edges when defining the heat flow rate, the magnitude gets apportioned across all selected
edges.
If an edge enlarges due to a change in CAD parameters, the total load applied to the edge remains constant, but
the line load (heat flow rate per unit length) decreases.
If you try to apply a heat flow to a multiple edge selection that spans multiple bodies, the edge selection is ignored.
The geometry property for the load object displays No Selection if the load was just created, or it maintains its
previous geometry selection if there was one.
A positive heat flow acts into a vertex, adding energy to the body. Heat flow is defined as energy per unit time.
If you select multiple vertices when defining the heat flow rate, the magnitude gets apportioned among all se -
lected vertices.
If you try to apply a heat flow to a multiple vertex selection that spans multiple bodies, the vertex selection is
ignored. The geometry property for the load object displays No Selection if the load was just created, or it
maintains its previous geometry selection if there was one.
Perfectly Insulated
Available for 3-D simulations, and 2-D simulations for Plane Stress and Axisymmetric behaviors only.
An insulated surface is a no load condition meant to override any thermal loads scoped to a body. The heat flow
rate is 0 across this surface. This load is useful in a case where most of a model is exposed to a given condition
(such a free air convection) and only a couple of surfaces do not share this condition (such as the base of a cup
that is grounded). This load will override only thermal loads scoped to a body. See Resolving Thermal Boundary
Condition Conflicts for a discussion on thermal load precedence.
If you select multiple surfaces when defining an insulated surface, all selected surfaces will be insulated.
Magnetic flux boundary conditions impose constraints on the direction of the magnetic flux on a model
boundary. This boundary condition may only be applied to surfaces. By default, this feature constrains the flux
to be normal to all exterior faces.
Selecting Flux Parallel forces the magnetic flux in a model to flow parallel to the selected surface. In the figure
below, the arrows indicate the direction of the magnetic flux. It can be seen that the flux flows parallel to the xy
plane (for any z coordinate).
A flux parallel condition is required on at least one surface of the simulation model. It is typically applied on the
outer faces of the air body to contain the magnetic flux inside the simulation domain or on symmetry plane
surfaces where the flux is known to flow parallel to the surface.
To set this feature, right-click on the Environment item in the Tree View and select Magnetic Flux Parallel from
the context menu or select Magnetic Flux Parallel from the drop-down Electromagnetic menu in the toolbar.
It can only be applied to geometry surfaces and Named Selections (surfaces).
Half-symmetry model of a keepered magnet system. Note that the XY-plane is a Flux Parallel boundary. The flux
arrows flow parallel to the plane.
Half-symmetry model of a keepered magnet system. Note that the YZ-plane is a Flux Normal boundary. The flux
arrows flow normal to the plane. This is a natural boundary condition and requires no specification.
Note — Applying the flux parallel boundary conditions to the exterior surfaces of the air domain may
artificially capture more flux in the simulation domain than what physically occurs. This is because the
simulation model truncates the open air domain. To minimize the effect, ensure the air domain extends
far enough away from the physical structure. Alternatively, the exterior surfaces of the air domain may
be left with an unspecified surface boundary condition. An unspecified exposed exterior surface imposes
a condition whereby the flux flows normal to the surface. Keep in mind that at least one surface in the
model must have a flux parallel boundary condition.
Conductor
Available for 3-D simulations only.
A conductor body provides current excitation to a magnetic field simulation. Conductor bodies may be defined
from solid CAD geometry, or, in special cases, from a CAD line-body.
Solid CAD geometry is typically used to model solid conductors such as bus bars, rotor cages, etc. In solid con-
ductors, the current can distribute non-uniformly due to geometry changes, hence the program performs a
simulation that solves for the currents in the solid conductor prior to computing the magnetic field.
Line bodies, created in DesignModeler and promoted to a Winding Body, can be used to represent wound coils.
Wound coils are used most often as sources of current excitation for rotating machines, actuators, sensors, etc.
When the DesignModeler geometry is attached to Simulation, all winding bodies are assigned as Winding Con-
ductor bodies. You may directly define a current for each winding conductor body.
This feature allows you to tag a solid body as a conductor. A conductor body is characterized as a body that can
carry current and possible excitation to the system. When assigned as a conductor, additional options are exposed
for applying electrical boundary conditions and excitations to the conductor. These include applying an electrical
potential (voltage) or current. (See Section : Voltage Excitation for Solid Conductors and Section : Current Excit-
ation for Solid Conductors.)
To set this condition, right-click the Environment object in the Tree View and select Conductor from the Insert
drop-down menu. Select the body you want to designate as a conductor body, then use the Details view to
scope the body to the conductor. The default Number of Turns is 1, representing a true solid conductor. To
approximate a wound conductor, you can set the Number of Turns for the coil to a value greater than 1.
After defining the conductor body, you may apply voltage and current conditions to arrive at the desired state.
Note — Conductors require two material properties: relative permeability and resistivity. They also must
not terminate interior to the model with boundary conditions that would allow current to enter or exit
the conductor. Termination points of a conductor may only exist on a plane of symmetry.
Only bodies can be scoped to a conductor. Solid conductor bodies must have at least one voltage excit-
ation and either a second voltage excitation or a current excitation. Also, two solid conductor bodies
may not 'touch' each other, i.e. they must not share vertices, edges, or surfaces.
To establish current in the conductor, you must apply excitation to at least two locations on the conductor,
typically at terminals. For example, you could
• apply a voltage drop at two terminals of a conductor body residing at symmetry planes.
• ground one end of a conductor (set voltage to zero) and apply the net current at the terminal's other end.
This feature allows you to apply an electric potential (voltage) to a conductor body. A voltage excitation is required
on a conductor body to establish a ground potential. You may also apply one to apply a non-zero voltage excit-
ation at another location to initiate current flow. Voltage excitations may only be applied to surfaces.
To apply a voltage excitation to a conductor body, right-click on the Conductor object under the Environment
object in the Tree View and select Voltage from the Insert drop-down menu.
You define the voltage by magnitude and phase angle in the Details View, according to the equation below.
V = Vocos(ωt+φ)
Vo is the magnitude of the voltage (input value Voltage), ω is the frequency, and φ is the phase angle. For a static
analysis, ωt = 0.
Note — Voltage excitations may only be applied to conductor bodies and at symmetry planes.
An applied voltage drop across the terminals of a conductor body will induce a current. In this simple example,
the current in the conductor is related to the applied voltage drop, using the equations shown below. ∆V=applied
voltage drop, I=curent, ρ=resistivity of the conductor (material property), L=length of the conductor, and
Area=cross section area of the conductor.
∆V = IR
R = (ρ*L)/Area
This feature allows you to apply a current to a conductor body. Use this feature when you know the amount of
current in the conductor.
To apply a current excitation to a conductor body, right-click on the Conductor object under the Environment
object in the Tree View and select Current from the Insert drop-down menu. A positive current applied to a
surface flows into the conductor body. A negative current applied to a surface flows out of the conductor body.
You define the current by magnitude and phase angle in the Details View, according to the equation below.
I = Iocos(ωt+φ)
Io is the magnitude of the current (input value Current), ω is the frequency, and φ is the phase angle. For a static
analysis, ωt = 0.
Note — Current excitations may only be applied to a surface of a conductor body at symmetry planes.
An excitation must be accompanied by a ground potential set at another termination point of the con-
ductor body on another symmetry plane. No current may be applied to a conductor body surface interior
to the model domain. The symmetry plane on which the current excitation is applied must also have a
magnetic flux-parallel boundary condition.
An applied current to a conductor surface will calculate and distribute the current within the conductor body.
A ground potential (voltage=0) must be applied to a termination point of the conductor body.
Both the applied current and voltage constraints must be applied at a symmetry plane.
Winding bodies are created in DesignModeler (see Section : Body Types). This is a special class of line bodies in-
tended to model wound coil forms. They can be used in lieu of three-dimensional CAD geometry to create con-
ductor sources for electromagnetic simulations. This can provide significant time savings in modeling.
When Simulation attaches to the DesignModeler geometry, winding bodies are brought into Simulation and
designated as conductor bodies. Any future update of the CAD geometry from DesignModeler will not update
the winding conductor bodies. The geometry update may reposition winding bodies, but any added or deleted
winding bodies will not be brought over as conductor bodies.
Winding conductor bodies are applicable to any magnetic field problem where the source of excitation comes
from a coil. The coil must have a rectangular cross section (defined in DesignModeler) and a defined number of
coil “turns.” Winding body geometry is limited to constructs of bars and arcs. The first image below shows a
“racetrack” conductor body constructed from four bar and four arc edges. The second image shows a winding
body created from a single circular arc. Source loading for a coil is by a defined current (per turn) and a phase
angle.
After a winding body geometry is passed to Simulation and automatically assigned as a conductor body, you
can view information about the body in the Details View. Current can be defined in the Details View as well,
by magnitude and phase angle according to the equation below.
I = Io cos(t + )
Io is the magnitude of the current (input value Current), ω is the frequency, and φ is the phase angle. For a static
analysis, ωt = 0. The direction of the current is determined by the tangent orientation vector (blue arrow) in
DesignModeler. A positive or negative assigned value of current will be respective to that orientation vector.
The winding conductor body appears as a yellow line in Simulation displays. When the model is meshed, the
body is displayed with the cross section information passed from DesignModeler.
Winding conductor bodies cannot take advantage of model symmetry like solid conductor bodies. Instead, they
must be modeled in full, even if the underlying solid geometry is modeled in symmetry. This is illustrated in the
figures below. In this case, a one-quarter symmetry CAD model of an actuator is modeled. The winding conductor
body must be modeled in full symmetry.
Harmonic Loads
You can use the following loads in a harmonic analysis:
Acceleration
Pressure
Force (applied to a surface, edge, or vertex)
Bearing load
Moment
Given (Specified) displacement
Remote Force
Remote Displacements
You can apply multiple loads to the same surface. The following restrictions apply to harmonic loads:
To create a harmonic load, select Harmonic in the drop down menu on the Environment toolbar before
choosing a load. For pressures, forces (vertex, edge, or surface), and given (specified) displacements, you can set
the Phase Angle.
Thermal Transient Simulations), use the Define As field to classify the load as either Temperature-De-
pendent for convections or Load History for transient simulations. You can modify the tabular data for
these loads in Engineering Data. You can also import engineering data, that is, new Convections or
Load Histories, into Simulation.
4. Repeat for all required loads.
The availability of the types of loads and supports you can insert is dependent on the settings in the Physics
Filter located in the View menu.
For most loads, the Details View includes settings for you to specify the Scoping Method to either the geometry
where the load is to be applied (Geometry Selection) or to a Named Selection. If you want to move a load from
one part of a model to another, click the Geometry field, click on the new model location, then click Apply.
The exported loads depend on the part geometry, the part material properties, and the part's location relative
to the coordinate system in the part document. When any of these factors change, you must solve the motion
simulation again by repeating the full procedure. Verify that material properties such as density are consistent
in the motion simulation and in the material properties.
Insert Motion Loads is intended to work with a single body only. Results with grounded bodies (bodies not in
motion in the mechanism) are not currently supported.
If an assembly feature (such as a hole) is added after Dynamic Designer generates its Joint attachments for FEA,
the attachments may become invalid. These attachments can be verified by opening the Properties dialog box
for a Joint and selecting the FEA tab. An invalid attachment will have a red “X” through the icon. To correct this
problem, manually redefine the joint attachments using the FEA tab in the Joint Properties dialog.
A .log file is created when motion loads are imported. This troubleshooting file has the same name (with an .log
extension) and file location as the load file. If the .log file already exists, it is overwritten by the new file.
Direction
There are four types of Direction:
Planar Face
Edge
Cylindrical Surface or Geometric Axis
Two Vertices
Planar Face
Note — Not applicable to rotational velocity. Rotational velocity gets aligned along the normal to a planar
face and along the axis of a cylindrical surface.
Edge
Straight Colinear to the edge
Selected cylinder
Two Vertices
2 selected vertices
Scope
Scope refers to geometry over which load/support applies. If you apply a force of 1000N in the X-direction, applied
to a vertex, the load is “scoped” to that vertex. You can “scope” that load to some other geometry such as a surface.
Environment objects in general can be scoped (such as force, pressure, temperature) to geometry that you select,
or to a named selection. Some Environment objects, such as acceleration, cannot be scoped.
Shared faces exist in the case of multi body parts. Contact regions, pressures, surface forces, surface moments,
compression only supports, bearing loads, remote forces, convections, heat fluxes, and heat flows are not allowed
to be applied to shared faces.
Types of Supports
Fixed
Section : Fixed Surface
Section : Fixed Edge
Section : Fixed Vertex
Displacement
Section : Displacement for Surfaces
Section : Displacement for Edges
Section : Displacement for Vertices
Section : Remote Displacement
Frictionless Support
Section : Frictionless Surface
Fixed Rotation
Fixed Surface Rotation
Fixed Edge Rotation
Fixed Vertex Rotation
Fixed Surface
Prevents one or more flat or curved surfaces from moving or deforming.
Immobilized surface
Fixed Edge
Prevents one or more straight or curved edges from moving or deforming.
A fixed edge is not realistic and leads to singular stresses (that is, stresses that approach infinity near the fixed
edge). You should disregard stress and elastic strain values in the vicinity of the fixed edge.
Fixed Vertex
Prevents one or more vertices from moving.
Immobilized vertex
A fixed vertex fixes both translations and rotations on surfaces or line bodies.
A fixed vertex is not realistic and leads to singular stresses (that is, stresses that approach infinity near the fixed
vertex). You should disregard stress and elastic strain values in the vicinity of the fixed vertex.
If you are using a surface model, see Section : Simply Supported Vertex.
Nonzero X-, Y-, and Z-components. The surface retains its original shape but moves relative to its original
location by the specified displacement vector. The enforced displacement of the surface causes a model to deform.
Zero Y-component. No part of the surface can move, rotate, or deform in the Y-direction.
Blank (undefined) X- and Z-components. The surface is free to move, rotate, and deform in the XZ plane.
Use multiple select to apply a displacement load to more than one surface.
Note —
Nonzero X-, Y-, and Z-components . The edge retains its original shape but moves relative to its original location
by the specified displacement vector. The enforced displacement of the edge causes a model to deform.
Zero Y-component . No part of the edge can move, rotate, or deform in the Y-direction .
Blank (undefined) X- and Z-components. The edge is free to move, rotate, and deform in the XZ plane.
Use multiple select to apply a displacement load to more than one edge.
Note —
Enforced displacement of an edge is not realistic and leads to singular stresses (that is, stresses that approach
infinity near the loaded edge). You should disregard stress and elastic strain values in the vicinity of the loaded
edge.
Nonzero X-, Y-, and Z-components. The vertex moves relative to its original location by the specified displace-
ment vector. The enforced displacement of the vertex causes a model to deform.
Blank (undefined) X- and Z-components. The vertex is free to move in the XZ plane.
Use multiple select to apply a displacement load to more than one vertex.
Note —
Enforced displacement of a vertex is not realistic and leads to singular stresses (that is, stresses that approach
infinity near the loaded vertex). You should disregard stress and elastic strain values in the vicinity of the loaded
vertex.
Remote Displacement
A Remote Displacement allows you to apply both displacements and rotations at an arbitrary remote location
in space. You specify the origin of the remote location under Scope in the Details View by picking, or by entering
the XYZ coordinates directly. The default location is at the origin of the global coordinate system. You specify
the displacement and rotation under Definition.
The location and the direction of a Remote Displacement can be defined in the global coordinate system or in
a local Cartesian coordinate system. A common application is to apply a rotation on a model at a local coordinate
system. An example is shown below along with a plot of the resulting Total Deformation.
You can also specify the Behavior of the scoped geometry for a Remote Displacement in the Details View as
either Rigid or Deformable. You must determine which Behavior best represents the actual loading. Presented
below are examples of the Total Deformation resulting from the same Remote Displacement applied first to a
Rigid body, then to a Deformable body.
Note — You are advised to check reaction forces to ensure that a Remote Displacement has been fully
applied, especially if the load shares geometry with Remote Force, Remote Mass, or Moment loads. The
underlying reason why this load may not be fully applied is because it and the other loads mentioned
all make use of MPC contact used in core ANSYS. See the ANSYS Contact Technology Guide in the core
ANSYS Help for more information.
Frictionless Surface
Prevents one or more flat or curved surfaces from moving or deforming in the normal direction.
Normal direction relative to the surface. No portion of the surface can move, rotate, or deform normal to the
surface.
Tangential directions. The surface is free to move, rotate, and deform tangential to the surface.
Consider the following model with a bearing load and supports as shown.
Note the effect of the compression only support in the animation of total deformation.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Since the region of the surfaces in compression is not initially known, a nonlinear solution is required and may
involve a substantial increase in solution time.
Cylindrical Support
For 3-D simulations, prevents one or more cylindrical surfaces from moving or deforming in combinations of
radial, axial, or tangential directions. Any combination of fixed and free radial, axial, and tangential settings are
allowed.
Radial directions relative to the cylin- Axial directions relative to the cylinder Tangential direction relative to the
der (Fixed). Such cylindrical surfaces (Fixed). Such cylindrical surfaces cannot cylinder (Fixed). Such cylindrical surfaces
cannot move, rotate, or deform radially move, rotate, or deform axially to the cannot move, rotate, or deform tangen-
to the cylinder. cylinder. tially to the cylinder.
Axial and tangential directions (Free). Radial and tangential directions (Free). Radial and axial directions (Free). The
The cylinder is free to move, rotate, and The cylinder is free to move, rotate, and cylinder is free to move, rotate, and de-
deform axially and tangentially. deform radially and tangentially. form radially and axially.
For 2-D simulations, cylindrical supports can only be applied to circular edges.
Prevents one or more straight or curved edges from moving or deforming but rotations about the line are allowed.
If you want to fix the rotations as well, use Section : Fixed Edge.
Prevents one or more vertices from moving. Rotation about the vertex is allowed. If you want to prevent rotations,
use Section : Fixed Vertex.
A simply supported vertex is not realistic and leads to singular stresses (that is, stresses that approach infinity
near the simply supported vertex). You should disregard stress and elastic strain values in the vicinity of the
simply supported vertex.
• 3-D simulations.
• Surface, edge, and vertex entities of shells.
Prevents one or more vertices from rotating. Translation of the vertex is allowed. If you want to prevent translations,
use either Section : Fixed Vertex or Section : Simply Supported Vertex.
A fixed vertex rotation support is not realistic and leads to singular stresses (that is, stresses that approach infinity
near the fixed vertex rotation support). You should disregard stress and elastic strain values in the vicinity of the
fixed vertex rotation support.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Load ANSYS
Simulation can solve most linear static 3D analyses; however, for other types of problems you will need to
transfer the model to ANSYS to complete the analysis. You can send a model to ANSYS from the Project Page by
choosing this option in the left panel. Keep in mind that only the finite element model is transferred to ANSYS.
Also, some commands that are automatically created in Workbench may not have the same default values they
have if they are created directly in ANSYS.
Finite element data (element type, nodes, elements), boundary conditions, and components are transferred to
ANSYS. Solid model information is not transferred. You can use the ANSYS Workbench's ability to create node
components based on geometry to more easily manipulate the model once in ANSYS environment.
Any named selection group from Simulation is transferred to ANSYS as a component according to specific
naming rules and conventions.
While you can go back to the ANSYS Workbench by clicking any of the Workbench tabs, no data is returned. You
receive a message stating that operations you performed while in ANSYS are not automatically recorded in ANSYS
Workbench. The message then prompts you to save a copy of the ANSYS database and command log.
Results
Depending on the type of simulation, you can view the following results:
To form results, Simulation averages across geometric discontinuities, but does not average across bodies. Also,
contact results are averaged across all contact regions, not across individual regions.
To insert a result, you must highlight a Solution object in the tree. You can then select the appropriate result:
Tools, Stress, Elastic Strain, Deformation, Thermal, or Frequency from the Solution Context Toolbar or use
the Insert menu (Insert> Solution Item> result), or use the right-mouse click option to insert an object. In ad-
dition, you can Section : Scope your results.
Note — If you Duplicate a Fatigue Tool or a Contact Tool (Edit > Duplicate or through a right mouse
button click on the tool), the result items are unsolved in the duplicated tool. After duplicating the tool,
you must choose Solve to obtain a solution for the duplicated tool.
The following table indicates which bodies can be represented by the various choices available in the drop-down
menus of the Solution toolbar.
1 - Contact results are not reported, and are not applicable to the following:
• Edges.
• MPC contact.
2 - Electric Potential, Inductance, and Flux Linkage can only be scoped to conductor bodies.
Scoping Results
Most result objects (such as stress, stress tool, fatigue life, temperature) can be scoped to edges, a single vertex,
surfaces, parts, bodies, or the entire assembly. When you scope results to contiguous edges, a graph is superim-
posed on the model that shows the variation of the result along the length of the scoped edges, except for shell
edges and closed circles. The same graph is displayed when you click on the Worksheet tab.
Frequency results cannot be scoped. Shape results can be scoped only to the assembly, parts, or bodies. Harmonic
response results can be scoped only on vertices, or edges, or faces.
Once a solution is computed, the scope of the result object cannot change. You must either add a new result
object with the desired scope, or you can right mouse click on that result item, and choose Clean to change its
scope.
Result scoping has an impact on convergence. Refinement doesn't happen outside the scope for a given conver-
gence control. Multiple convergence controls are possible, however.
Results cannot be scoped to shared faces that exist in multi body parts.
To clean all results data, simply select the Solution object and choose the Clean menu item from the File menu
or from a right-mouse click menu. You can clean individual results by selecting a result object before choosing
the Clean menu item.
• Solution Output: Determines how you want solution response results displayed. All of the options are
displayed in real time as the solution progresses:
– Solver Output (default): Displays the ANSYS solution output file (text). This option is useful for ANSYS
users who are accustomed to viewing this type of output.
Choosing any of the following options displays a graph of that option as a function of Cumulative Iteration.
– Force Convergence1
– Displacement Convergence1
– Max DOF Increment
– Line Search
– Time
– Time Increment
– CSG Convergence1 (magnetic current segments)
– Heat Convergence1
1 - All convergence plots include designations where any bisections, converged substeps, or converged
load steps occur. These designations are the red, green, and blue dotted lines shown in the example below
of a Force Convergence plot.
• Newton-Raphson Residuals: Specifies the maximum number of Newton-Raphson residual forces to return.
The default is 0 (no residuals returned). You can request that the Newton-Raphson residual restoring
forces be brought back for nonlinear solutions that either do not converge or that you aborted during
the solution. The Newton-Raphson force is calculated at each Newton-Raphson iteration and can give
you an idea where the model is not satisfying equilibrium. If you select 10 residual forces and the solution
doesn't converge, those last 10 residual forces will be brought back. The following information is available
in the Details View of a returned Newton-Raphson Residual Force object:
74
Section : Results
These results cannot be scoped and will automatically be deleted if another solution is run that either
succeeds or creates a new set of residual forces.
• Update Interval: Specifies how often any of the result tracking items under a Solution Information object
get updated while a solution is in progress. The default is 2.5 seconds.
– Contact Region: Specifies the particular contact region in the pair. Default names are Contact Region
and Contact Region 2.
– Type: Specifies the particular contact output. For each of these options, the result tracking is performed
on the Contact side of the pair. If you want to perform the result tracking on the Target side, you should
flip the source and target sides. If this occurs you can change the contact region to Asymmetric and
flip the source and target surfaces in order to specify the side of interest that is to be the contact side.
If Auto Asymmetric contact is active (either by the Behavior contact region setting equaling Auto
Asymmetric or by the Formulation setting equaling Augmented Lagrange or MPC) and the contact
side is chosen by the program to be disabled, the Results Tracker will not contain any results (as sig-
nified by a value of -2 for Number Contacting output). Contact results will be valid depending on the
type of contact (for example, edge-edge) and the contact formulation.
– X-Axis Values: Specifies either Time or Cumulative Iteration for the x-axis of the graph.
Multiple Result Tracker objects may be selected at the same time to create a combined chart assuming they
share the same X and Y output types (such as pressure for Y and time for X). An example is shown here:
The Result Tracker has an option for renaming the object based on the result and the scoping. You choose the
option in the context menu (RMB click). This option is useful in having the program create meaningful names of
the result trackers. An example would be Result Tracker 5 being renamed to Pressure on Contact Region 2.
Result Tracker objects can be exported to an Excel file by selecting Export in the context menu using a right-
mouse button click on the Result Tracker object.
76
Section : Results
Note — You must right-mouse click on the selected object in the tree to use this Export feature. On Win-
dows platforms, if you have the Microsoft Office 2002 (or later) installed, you may see an Export to Excel
option if you right-mouse click in the Worksheet tab. This is not the Simulation Export feature but rather
an option generated by Microsoft Internet Explorer.
• The graph can be zoomed by using the [ALT] key + left mouse button. Moving down and to the right
zooms in, and moving up and to the left zooms out.
• A plot can be saved by using the Image Capture toolbar button.
• If a new Result Tracker is added to an otherwise up to date solution, a new solution will not be invoked
automatically. In order for the new result to be solved, you must Clean at the Solution level and then resolve
(which will force a complete resolve and thus fill the result tracker).
Caution: Because nodes may be rotated, deformation Result Trackers may not record the expected
component of the deformation. Should this occur, a warning message alerting you to this will appear
after the solve in the Details View of the Solution object, in the Solver Messages field. This situation
can occur when Result Trackers are adjacent to supported surfaces, lines, or vertices. One possible ap-
proach to avoid this situation is to add 3 deformation Result Trackers, one for each of the x, y, and z
directions. This will ensure that the tracker is showing all deformation of that vertex of the model.
Stress Tools
You can insert any of the following stress tools in a Solution object by choosing Stress Tool under Tools in the
Solution context toolbar, or by using a right mouse button click on a Solution object and choosing Stress Tool:
After adding a Stress Tool object to the tree, you can change the specific stress tool under Theory in the Details
View.
The theory states that a particular combination of principal stresses causes failure if the maximum equivalent
stress in a structure equals or exceeds a specific stress limit:
e Slimit
If failure is defined by material yielding, it follows that the design goal is to limit the maximum equivalent stress
to be less than the yield strength of the material:
e
1
Sy
An alternate but less common definition states that fracturing occurs when the maximum equivalent stress
reaches or exceeds the ultimate strength of the material:
e
1
Su
Options
Define the stress limit in the Details View under Stress Limit Type. Use either Tensile Yield Per Material, or
Tensile Ultimate Per Material, or enter a Custom Value. By default, Stress Limit Type equals Tensile Yield
Per Material.
Choose a specific result from the Stress Tool context toolbar or by inserting a stress tool result using a right
mouse button click on Stress Tool:
Safety Factor
S
Fs = limit
e
Safety Margin
S
Ms = Fs − 1 = limit − 1
e
Stress Ratio
* e
e =
Slimit
Notes
• The reliability of this failure theory depends on the accuracy of calculated results and the representation
of stress risers (peak stresses). Stress risers play an important role if, for example, yielding at local discon-
tinuities (e.g., notches, holes, fillets) and fatigue loading are of concern. If calculated results are suspect,
consider the calculated stresses to be nominal stresses, and amplify the nominal stresses by an appropriate
stress concentration factor Kt. Values for Kt are available in many strength of materials handbooks.
• If fatigue is not a concern, localized yielding will lead to a slight redistribution of stress, and no real failure
will occur. According to J. E. Shigley (Mechanical Engineering Design, McGraw-Hill, 1973), “We conclude,
then, that yielding in the vicinity of a stress riser is beneficial in improving the strength of a part and that
stress-concentration factors need not be employed when the material is ductile and the loads are static.”
• Alternatively, localized yielding is potentially important if the material is marginally ductile, or if low
temperatures or other environmental conditions induce brittle behavior.
• Yielding of ductile materials may also be important if the yielding is widespread. For example, failure is
most often declared if yielding occurs across a complete section.
78
Section : Results
• The proper selection and use of a failure theory relies on your engineering judgment. Refer to engineering
texts such as Engineering Considerations of Stress, Strain, and Strength by R. C. Juvinall (McGraw-Hill) and
Mechanical Engineering Design by J. E. Shigley (McGraw-Hill) for in-depth discussions on the applied the-
ories.
The theory states that a particular combination of principal stresses causes failure if the Section : Maximum Shear
equals or exceeds a specific shear limit:
max f Slimit
where the limit strength is generally the yield or ultimate strength of the material. In other words, the shear
strength of the material is typically defined as a fraction (f < 1) of the yield or ultimate strength:
fS
Ms = Fs − 1 = limit − 1
max
In a strict application of the theory, f = 0.5. Expressing the theory as a design goal:
max
1
f Slimit
If failure is defined by material yielding, it follows that the design goal is to limit the shear stress to be less than
a fraction of the yield strength of the material:
max
1
f Sy
An alternate but less common definition states that fracturing occurs when the shear stress reaches or exceeds
a fraction of the ultimate strength of the material:
max
1
f Su
Options
Define the stress limit in the Details View under Stress Limit Type. Use either Tensile Yield Per Material, or
Tensile Ultimate Per Material, or enter a Custom Value. By default, Stress Limit Type equals Tensile Yield
Per Material.
Define coefficient f under Factor in the Details View. By default, the coefficient f equals 0.5.
Choose a specific result from the Stress Tool context toolbar or by inserting a stress tool result using a right
mouse button click on Stress Tool:
Safety Factor
f Slimit
Fs =
max
Safety Margin
f Slimit
Ms = Fs − 1 = −1
max
Stress Ratio
max
*
max =
f Slimit
Notes
• The reliability of this failure theory depends on the accuracy of calculated results and the representation
of stress risers (peak stresses). Stress risers play an important role if, for example, yielding at local discon-
tinuities (e.g., notches, holes, fillets) and fatigue loading are of concern. If calculated results are suspect,
consider the calculated stresses to be nominal stresses, and amplify the nominal stresses by an appropriate
stress concentration factor Kt. Values for Kt are available in many strength of materials handbooks.
• If fatigue is not a concern, localized yielding will lead to a slight redistribution of stress, and no real failure
will occur. According to J. E. Shigley (Mechanical Engineering Design, McGraw-Hill, 1973), “We conclude,
then, that yielding in the vicinity of a stress riser is beneficial in improving the strength of the part and
that stress-concentration factors need not be employed when the material is ductile and the loads are
static.”
• Alternatively, localized yielding is potentially important if the material is marginally ductile, or if low
temperatures or other environmental conditions induce brittle behavior.
• Yielding of ductile materials may also be important if the yielding is widespread. For example, failure is
most often declared if yielding occurs across a complete section.
• The proper selection and use of a failure theory relies on your engineering judgment. Refer to engineering
texts such as Engineering Considerations of Stress, Strain, and Strength by R. C. Juvinall (McGraw-Hill) and
Mechanical Engineering Design by J. E. Shigley (McGraw-Hill) for in-depth discussions on the applied the-
ories.
The theory states that failure occurs when the combination of the Section : Maximum, Middle, and Minimum
Principal equal or exceed their respective stress limits. The theory compares the maximum tensile stress to the
material's tensile limit and the minimum compressive stress to the material's compressive limit. Expressing the
theory as a design goal:
1 3
+ 1
Stensilelimit Scompressivelimit
where σ1 > σ2 > σ3; σ3 and the compressive strength limit take negative values.
Note that the Mohr-Coulomb Stress Safety tool evaluates maximum and minimum principal stresses at the same
locations. In other words, this tool does not base its calculations on the absolute maximum principal stress and
the absolute minimum principal stress occurring (most likely) at two different locations in the body. The tool
bases its calculations on the independent distributions of maximum and minimum principal stress. Consequently,
this tool provides a distribution of factor or margin of safety throughout the part or assembly. The minimum
factor or margin of safety is the minimum value found in this distribution.
80
Section : Results
For common brittle materials such as glass, cast iron, concrete and certain types of hardened steels, the com-
pressive strength is usually much greater than the tensile strength, of which this theory takes direct account.
The design goal is to limit the maximum and minimum principal stresses to their ultimate strength values by
means of the brittle failure relationship:
1 + 3 1
Sut Suc
An alternative but less common definition compares the greatest principal stresses to the yield strengths of the
material:
1 + 3 1
Syt Syc
The theory is known to be more accurate than the maximum tensile stress failure theory used in the Maximum
Tensile Stress Safety tool, and when properly applied with a reasonable factor of safety the theory is often con-
sidered to be conservative.
Options
Define the tensile stress limit in the Details View under Tensile Limit Type. Use either Tensile Yield Per Mater-
ial, or Tensile Ultimate Per Material, or enter a Custom Value. By default, Tensile Limit Type equals Tensile
Yield Per Material.
Define the compressive stress limit in the Details View under Compressive Limit Type. Use either Comp. Yield
Per Material, or Comp. Ultimate Per Material, or enter a Custom Value. By default, Compressive Limit Type
equals Comp. Yield Per Material.
Choose a specific result from the Stress Tool context toolbar or by inserting a stress tool result using a right
mouse button click on Stress Tool:
Safety Factor
1 3 −1
Fs = +
Stensilelimit Scompressivelimit
Safety Margin
1 3 −1
Ms = Fs − 1 = + −1
Stensilelimit Scompressivelimit
Stress Ratio
1 3
* = +
Stensilelimit Scompressivelimit
Notes
• The use of a yield strength limit with brittle materials is not recommended since most brittle materials do
not exhibit a well-defined yield strength.
• For ductile and some other types of materials, experiments have shown that brittle failure theories may
be inaccurate and unsafe to use. The brittle failure theories may also be inaccurate for certain brittle ma-
terials. Potential inaccuracies are of particular concern if the accuracy of calculated answers is suspect.
• The reliability of this failure criterion is directly related to treatment of stress risers (peak stresses). For
brittle homogeneous materials such as glass, stress risers are very important, and it follows that the calcu-
lated stresses should have the highest possible accuracy or significant factors of safety should be expected
or employed. If the calculated results are suspect, consider the calculated stresses to be nominal stresses,
and amplify the nominal stresses by an appropriate stress concentration factor Kt. Values for Kt are available
in many strength of materials handbooks. For brittle nonhomogeneous materials such as gray cast iron,
stress risers may be of minimal importance.
• If a part or structure is known or suspected to contain cracks, surface flaws, or is designed with sharp
notches or re-entrant corners, a more advanced analysis may be required to confirm its structural integrity.
Such discontinuities are known to produce singular (i.e., infinite) elastic stresses; if the possibility exists
that the material might behave in a brittle manner, a more rigorous fracture mechanics evaluation needs
to be performed. An analyst skilled in fracture analysis can use the ANSYS program to determine fracture
mechanics information.
• The proper selection and use of a failure theory relies on your engineering judgment. Refer to engineering
texts such as Engineering Considerations of Stress, Strain, and Strength by R. C. Juvinall (McGraw-Hill) and
Mechanical Engineering Design by J. E. Shigley (McGraw-Hill) for in-depth discussions on the applied the-
ories.
The theory states that failure occurs when the maximum principal stress equals or exceeds a tensile stress limit.
Expressing the theory as a design goal:
1
1
Slimit
The maximum tensile stress failure theory is typically used to predict fracture in brittle materials with static loads.
Brittle materials include glass, cast iron, concrete, porcelain and certain hardened steels.
The design goal is to limit the greatest principal stress to be less than the material's ultimate strength in tension:
1
1
Sut
An alternate definition compares the greatest principal stress to the yield strength of the material:
1
1
Syt
For many materials (usually ductile materials), strength in compression and in tension are roughly equal. For
brittle materials, the compressive strength is usually much greater than the tensile strength.
The Mohr-Coulomb theory used in the Mohr-Coulomb Stress Safety tool is generally regarded as more reliable
for a broader range of brittle materials. However, as pointed out by R. C. Juvinall (Engineering Considerations of
Stress, Strain, and Strength, McGraw-Hill, 1967), “There is some evidence to support its use with porcelain and
concrete. Also, it has been used in the design of guns, as some test results on thick-walled cylinders tend to agree
with this theory.”
82
Section : Results
Options
Define the stress limit in the Details View under Stress Limit Type. Use either Tensile Yield Per Material, or
Tensile Ultimate Per Material, or enter a Custom Value. By default, Stress Limit Type equals Tensile Yield
Per Material.
Choose a specific result from the Stress Tool context toolbar or by inserting a stress tool result using a right
mouse button click on Stress Tool:
Safety Factor
S
Fs = limit
1
Safety Margin
S
Ms = Fs − 1 = limit − 1
1
Stress Ratio
1
1* =
Slimit
Notes
• The use of a yield strength limit with brittle materials is not recommended since most brittle materials do
not exhibit a well-defined yield strength.
• For ductile and some other types of materials, experiments have shown that brittle failure theories may
be inaccurate and unsafe to use. The brittle failure theories may also be inaccurate for certain brittle ma-
terials. Potential inaccuracies are of particular concern if the accuracy of calculated answers is suspect.
• The reliability of this failure criterion is directly related to treatment of stress risers (peak stresses). For
brittle homogeneous materials such as glass, stress risers are very important, and it follows that the calcu-
lated stresses should have the highest possible accuracy or significant factors of safety should be expected
or employed. If the calculated results are suspect, consider the calculated stresses to be nominal stresses,
and amplify the nominal stresses by an appropriate stress concentration factor Kt. Values for Kt are available
in many strength of materials handbooks. For brittle nonhomogeneous materials such as gray cast iron,
stress risers may be of minimal importance.
• If a part or structure is known or suspected to contain cracks, surface flaws, or is designed with sharp
notches or re-entrant corners, a more advanced analysis may be required to confirm its structural integrity.
Such discontinuities are known to produce singular (i.e., infinite) elastic stresses; if the possibility exists
that the material might behave in a brittle manner, a more rigorous fracture mechanics evaluation needs
to be performed. An analyst skilled in fracture analysis can use the ANSYS program to determine fracture
mechanics information.
• The proper selection and use of a failure theory relies on your engineering judgment. Refer to engineering
texts such as Engineering Considerations of Stress, Strain, and Strength by R. C. Juvinall (McGraw-Hill) and
Mechanical Engineering Design by J. E. Shigley (McGraw-Hill) for in-depth discussions on the applied the-
ories.
Contact Tool
You can apply a Contact Tool to any assembly to verify the transfer of loads (forces and moments) across the
various contact regions. The Contact Tool is an object you can insert under a Solution branch or Solution
Combination branch that allows you to conveniently scope contact results to a common selection of geometry
or contact regions. In this way, all possible contact results (pressure, frictional stress, status, gap, penetration,
distance, and reactions), can be investigated at once for a given scoping. The Contact Tool also has provision
for including contact Reactions as objects that hold the reaction forces and moments at the contact and target
topologies for any contact region.
A Contact Tool is scoped to a given topology, and there exist two methods for achieving this: Geometry Selection
method and Worksheet method. Under Geometry Selection method, the Contact Tool can be scoped to any
geometry on the model. Under Worksheet method, the Contact Tool is scoped to one or more contact regions.
Regardless of the method, the scoping on the tool is applied to all results or reactions grouped under it.
To use a Contact Tool, prepare a structural analysis for an assembly with contacts. You then use either the
Geometry Selection or Worksheet scoping method as follows:
• Worksheet method:
1. Insert a Contact Tool in the Solution folder (Tools> Contact Tool from the Solution context toolbar,
or right mouse button click on Solution, then Insert> Contact Tool> Contact Tool). You will see a
Contact Tool inserted with a default contact result.
2. In the Details View, select Worksheet in the Method field.1 The Worksheet tab appears. Scoped
contact regions are those that are checked in the table.
3. You can modify your selection of contact regions in the Worksheet using the following procedures:
– To add or remove pre-selected groups of contact regions (All Contacts, Nonlinear Contacts, or
Linear Contacts), use the drop-down menu and the corresponding buttons.
– To add any number of contact regions, you can also drag-drop or copy-paste any number of
contact regions from the Contact folder into the Contact Tool in the Tree View. Also, one or
more contact regions can be deleted from the Contact Tool worksheet by selecting them in the
table and pressing the [Delete] key.
– To change the Contact Side of all contact regions, choose the option in the drop-down menu
(Both, Contact, or Target from the drop-down menu and click the Apply button).
84
Section : Results
– To change an individual Contact Side, click in the particular cell and choose Both, Contact, or
Target from the drop-down menu.
1
The default method will be the last one that you manually chose in the Scoping Method drop down menu. If
you have already selected geometry, the Scoping Method field automatically changes to Geometry Selection.
The default however will not change until you manually change the Scoping Method entry.
Contact Reactions are allowed for any Contact Tool scoped using Worksheet method. To test them, insert an
appropriately scoped Contact Tool and add a contact reaction table. Solve. The contact reaction table will reflect
the contact regions scoped in the Contact Tool Worksheet. Contact reactions will display the force and moment
at the summation point for every contact region.
Note — The location of the summation point may not be exactly on the contact region itself. Also, the
reaction calculations work from summing the internal forces on the underlying elements under a contact
region. Thus, a reported reaction may be inappropriate on a contact surface if that surface shares topology
with another contact surface/edge or external load (such as a force or fixed support), which would con-
tribute to the underlying elements' internal force balance.
• You can display contact Reactions in a local coordinate system. Apply a local coordinate system before
solving. The reaction forces and moments will be expressed in this local coordinate system and displayed
in the contact reaction Worksheet. Summation points are defined as the location in global or local
Cartesian coordinates about which the reaction forces and moments are reported by the ANSYS software.
• After solving, you can designate any of the forces or moments (components and/or magnitude) as para-
meters by clicking in the box adjacent to the value.
• You can view selected columns for contact Reactions.
• You can display Contact Reactions graphically on the geometry as a free body diagram. To view this, click
on the Geometry Tab on a solved contact Reactions object. Forces will display as single headed arrows,
and moments as double-headed arrows.
The configuration of the Contact Tool, in particular the location (Solution vs Solution Combination) and the
scoping method, affects the availability of results. The following are the limitations:
• Contact Tool in the Solution folder: Supports all results and reactions when using the Worksheet scoping
method. It does not support reactions when using Geometry Selection method.
• Contact Tool in the Solution Combination folder: Supports only pressure, frictional stress, penetration
and distance. No reactions are supported.
Contact Results
If your model contains Contact Regions, you can define the following contact results under the Solution object
by inserting a Contact Tool:
• Frictional Stress
• Gap
• Penetration
• Pressure (to reflect total contact pressures, you must either set the Behavior option to Asymmetric or
Auto Asymmetric, or manually create an asymmetric contact pair).
• Sliding Distance
• Status. Status codes are:
The labels Far, Near, Sliding, and Sticking are included in the legend for Status.
• When a contact result is scoped to a surface of an assembly, a contact result may not be obtained
in certain cases, especially if the scoped surface is not a part of any contact region.
• Contour contact results are not reported for 3-D edge contact.
Beam Tool
You can apply a Beam Tool to any assembly in order to view the linearized stresses on beam bodies. It is customary
in beam design to employ components of axial stress that contribute to axial loads and bending in each direction
separately. Therefore, the stress outputs (which are linearized stresses) associated with beam bodies have been
focused toward that design goal.
The Beam Tool is similar to the Contact Tool in that the tool, not the results themselves control the scoping. By
default, the scoping is to all beam bodies. You can change the scoping in the Details View, if desired.
To insert a Beam Tool, highlight the Solution object then choose Tools> Beam Tool from the Solution context
toolbar. Three beam stress results are included under the Beam Tool object: Direct Stress, Minimum Combined
Stress, and Maximum Combined Stress. You can add additional beam stress results or deformation results by
highlighting the Beam Tool object and choosing the particular result from the Beam Tool context toolbar. As
an alternative, you can right mouse button click on the Beam Tool object and, from the context menu, choose
Insert> Beam Tool> Stress or Deformation.
Presented below are definitions of the beam stress results that are available:
• Direct Stress: The stress component due to the axial load encountered in a beam element.
86
Section : Results
• Minimum Bending Stress: From any bending loads a bending moment in both the local Y and Z directions
will arise. This leads to the following four bending stresses: Y bending stress on top/bottom and Z bending
stress the top/bottom. Minimum Bending Stress is the minimum of these four bending stresses.
• Maximum Bending Stress: The maximum of the four bending stresses described under Minimum
Bending Stress.
• Minimum Combined Stress: The linear combination of the Direct Stress and the Minimum Bending
Stress.
• Maximum Combined Stress: The linear combination of the Direct Stress and the Maximum Bending
Stress.
You can view the mode shape associated with a particular frequency by drawing a picture or by animating the
deformed shape. The contours represent relative displacement of the part as it vibrates.
Mode shape pictures are helpful in understanding how a part or an assembly vibrates, but do not represent ac-
tual displacements. If there are structural loads present in the Environment, then the frequencies and m ode
shapes will depend on the loads and their magnitudes.
“Stresses” from a modal analysis do not represent actual stresses in the structure, but give you an idea of the
relative stress distributions for each mode.
Vibration Environments
Attach one or more structural supports to one or more parts. One or more zero (0 Hz) frequencies can result if
the supports allow rigid body motion of the part or assembly in space.
Note — Due to their nonlinear nature, compression only supports are not recommended in a modal
analysis. Extraneous or missed natural frequencies may result.
Prestress Effects
If structural loads, structural body loads and/or thermal loads are included in the Environment, then the frequency
results will depend on these loads. This is due to that fact that the stiffness of a structure is dependent on its
stress state. This stiffening (or weakening) of the structure due to its loads is sometimes referred to as pre
stressing, geometric stiffening, or initial stress stiffening.
The mode shape is always available for a given frequency. Optionally, you can add additional results for a specified
frequency. The result is inserted into the frequency tool in focus. You may plot any contour results except for
thermal strains, viewing structural stress, elastic strain or displacement at the desired mode.
Buckling
Buckling, a failure mechanism, can be defined as the sudden large deformation of a structure due to an increase
of an existing load. Buckling occurs from a compressive stress state in which the structure becomes geometrically
unstable. For example, an empty beverage container can withstand a somewhat large axial compression such
as standing on the can. However, a sudden collapse can occur due to a slight lateral perturbation, like a finger
pressing into the side of the can.
• You can request buckling results by inserting a Buckling Tool under a Solution object. The default number
of buckling modes is 1.
88
Section : Results
• To view the buckled mode shape, click on the result. The contours represent relative displacement of the
part as it buckles.
• Buckling mode shape pictures are helpful in understanding how a part or an assembly buckles, but do
not represent actual displacements.
• Buckling Environments
• Working with Buckling Results
Buckling Environments
Attach one or more structural supports to one or more parts. In addition, since external loads are required for
buckling to occur, one or more structural loads must be defined. If you apply unit loads, the load factor represents
the critical buckling load. If you specify actual loads, then the load factors represent the fraction of the load that
would cause buckling.
Note —
• Due to their nonlinear nature, compression only supports are not recommended in a buckling
analysis. Extraneous or missed buckling may result.
• Thermal buckling is not supported.
• Non Zero Displacements are not allowed.
Buckling shapes (relative displacement) are always available for a given load factor. Optionally, you can add ad-
ditional results for a specified load factor. The result is inserted into the buckling tool in focus. You may plot any
contour results except for thermal strains, viewing structural stress, elastic strain or displacement at the desired
mode.
Notes
• Eigenvalue buckling analysis predicts the theoretical buckling strength of an ideal linear elastic structure.
This method corresponds to the textbook approach to elastic buckling analysis. Eigenvalue buckling
analysis often yields unconservative results, as imperfections and nonlinearities prevent most real-world
structures from achieving their theoretical elastic buckling strength. A buckling analysis may be warranted
on a structure where a relatively thin member experiences compressive loads.
• Occasionally, a buckling solution may not be found and the message “Unable to Find Requested Modes”
will appear.
• Different buckling loads may be predicted from seemingly equivalent pressure and force loads in a
buckling analysis because in Simulation a force and a pressure are not treated the same. As with any nu-
merical analysis, we recommend that you use the type of loading which best models the in-service com-
ponent. For more information, see the ANSYS, Inc. Theory Reference, under Structures with Geometric Non-
linearities> Stress Stiffening> Pressure Load Stiffness.
• “Stresses” from a buckling analysis do not represent actual stresses in the structure, but give you an idea
of the relative stress distributions for each mode.
You can obtain harmonic results for the steady-state, forced vibrations of a structure. The transient vibrations,
which occur at the beginning of the excitation, are not accounted for.
Mode Superposition
This is the default method, and generally provides results faster than the Full method. It also allows solutions
to be clustered about the structure's natural frequencies. This results in a smoother, more accurate response
curves. It cannot be used if you have specified nonzero harmonic displacement load(s).
Full
The full method calculates all displacements and stresses in a single pass. Its chief disadvantages are that:
With the Harmonic Tool selected, you must define the following values in the Details View:
90
Section : Results
• Program Controlled: The modal sweep range is automatically set to 200% of the upper harmonic
limit and 50% of the lower harmonic limit. This setting is adequate for most simulations.
• Manual: Allows you to manually set the modal sweep range. Choosing Manual displays the Modal
Range Minimum and Modal Range Maximum fields where you can specify these values.
Constant Damping
The simplest way of specifying damping in the structure, this value is a constant damping ratio. If you set
this in conjunction with Beta Damping, the effects are cumulative.
Beta Damping
Defines the stiffness matrix multiplier for damping. Beta Damping is the option for Direct Input or Damping
versus Frequency. For Direct Input, enter a Beta Damping value. For Damping versus Frequency, you can
enter both a Frequency value and a Beta Damping value.
Results Types
You can insert two types of results:
Results viewed over the entire model. These include stress, elastic strain, and deformation, and are basically
the same as those for other analyses. For these results, you must specify a frequency and phase angle.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Results for a specified geometric entity (vertex, surface, or edge), viewed as a value graphed along a
specified frequency range. These include the frequency or phase results for stress, elastic strain, deformation,
or acceleration (frequency only) plotted as a graph. The number of results points plotted on the graph is set in
the Harmonic Tool Details. When you generate frequency response results, the default plot (Bode) shows the
amplitude. For phase response results, there is only one graph shown and there are no display options for them.
The following figure shows a reduced version of the Bode plot.
Optionally, you can plot the following results values: real, imaginary, amplitude, and phase angle. You can select
any of these from a drop-down list in the Details View for the results. For edges, surfaces, shells, and multiple
92
Section : Results
vertex selections (which contain multiple nodes), the results can be scoped as minimum, maximum, or average.
This is also available for frequency and phase response results scoped on a single vertex.
The Use Minimum and Use Maximum settings are based on the amplitude and thus are reported from the
location with either the largest or smallest amplitude. The Use Average setting calculates the average by calcu-
lating the real and imaginary components separately.
Note — You cannot use Simulation convergence capabilities for any results item under the Harmonic
Tool. Instead, you can first do a convergence study on a frequency analysis and reuse the mesh from
that analysis.
Right-clicking on any graph produces the Graph Property dialog. You can use this dialog to adjust the appearance
of the graph. It controls such graphing options as:
Stress/Strain
Stress solutions allow you to predict safety factors, stresses, strains, and displacements given the model and
material of a part or an entire assembly and for a particular structural loading environment.
A general three-dimensional stress state is calculated in terms of three normal and three shear stress components
aligned to the part or assembly world coordinate system.
The principal stresses and the maximum shear stress are called invariants; that is, their value does not depend
on the orientation of the part or assembly with respect to its world coordinate system. The principal stresses and
maximum shear stress are available as individual results.
The principal strains ε1, ε2, and ε3 and the maximum shear strain γmax are also available. The principal strains are
always ordered such that ε1> ε2> ε3. As with principal stresses and the maximum shear stress, the principal strains
and maximum shear strain are invariants.
• Section : Equivalent
• Section : Maximum, Middle, and Minimum Principal
• Section : Maximum Shear
• Section : Intensity
• Section : Error (Structural)
• Section : Vector Principals
• Equivalent Plastic Strain
It is assumed that whatever holds true for stress applies to strain as well. However, the relationship between
maximum shear stress and stress intensity does not hold true for an equivalent relationship between maximum
shear strain and strain intensity.
For more information about Stress/Strain, see the ANSYS, Inc. Theory Reference.
Considerations
The degree of uncertainty in the numerical calculation of Stress answers depends on your accuracy preference.
See Section : Convergence for information on available options and their effect on Stress answers.
For your convenience and future reference, Report can include stress, strain, and deformations value, convergence
histories, and any alerts for these values.
Equivalent
Equivalent stress is related to the principal stresses by the equation:
( − )2 + ( − )2 + ( 1/ 2
− 1)2
e = 1 2 2 3 3
2
Equivalent stress (also called von Mises stress) is often used in design work because it allows any arbitrary three-
dimensional stress state to be represented as a single positive stress value. Equivalent stress is part of the max-
imum equivalent stress failure theory used to predict yielding in a ductile material.
94
Section : Results
1 1 21
e = (1 − 2 )2 + (2 − 3 )2 + (3 − 1)2
1+ ’ 2
where:
• Material Poisson's ratio for elastic and thermal strains computed at the reference temperature. Each ma-
terial’s reference temperature property is used as the reference temperature. If this property does not
exist for a material then the environment’s reference temperature is used.
• 0.5 for plastic strains.
σ1 - Maximum
σ2 - Middle
σ3 - Minimum
The principal stresses are always ordered such that σ1 > σ2 > σ3.
Maximum Shear
The maximum shear stress τmax, also referred to as the maximum shear stress, is found by plotting Mohr's circles
using the principal stresses:
or mathematically through:
− 3
max = 1
2
For elastic strain, the maximum sheer elastic strain γmax is found through:
γmax = ε1 - ε3
since the shear elastic strain reported is an engineering shear elastic strain.
Intensity
Stress intensity is defined as the largest of the absolute values of σ1 - σ2, σ2 - σ3, or σ3 - σ1:
I = MAX(1 − 2 , 2 − 3 , 3 − 1 )
σI = 2τmax
Elastic Strain intensity is defined as the largest of the absolute values of ε1 - ε2, ε2 - ε3, or ε3 - ε1:
I = MAX(1 − 2 , 2 − 3 , 3 − 1 )
εI = γmax
Equivalent Stress (and Equivalent Elastic Strain) and Stress Intensity are available as individual results.
Note — Computation of Equivalent Elastic Strain uses Poisson’s ratio. If Poisson’s ratio is temperature
dependent then the Poisson’s ratio value at the reference temperature is used to compute the Equivalent
Elastic Strain.
Error (Structural)
You can insert an Error result based on stresses to help you identify regions of high error and thus show where
the model would benefit from a more refined mesh in order to get a more accurate answer. You can also use the
Error result to help determine where Workbench will be refining elements if Convergence is active. The Error
result is based on the same errors used in adaptive refinement. Information on how these errors are calculated
is included in Section 19.7, POST1 - Error Approximation Technique, in the ANSYS, Inc. Theory Reference.
Note — Scoping is limited to assembly or body scoping (that is, surface/edge/vertex scoping is not al-
lowed). The Error result is based on linear stresses and as such may be inaccurate in certain type of
nonlinear analysis (for example, when plasticity is active).
Presented below are example applications of using the Error result in a Structural simulation.
3-D Model:
96
Section : Results
Vector Principals
A Vector Principals plot provides a three-dimensional display of the relative size of the principal quantities
(stresses or elastic strains), and the directions along which they occur. Positive principals point outwards and
negative ones inwards.
Plots of Vector Principals help depict the directions that experience the greatest amount of normal stress or
elastic strain at any point in the body in response to the loading condition. The locus of directions of maximum
principal stresses, for example, suggests paths of maximum load transfer throughout a body.
Request a Vector Principals plot in the same way that you would request any other result. Scoping is also possible.
Numerical data for these plots can be obtained by exporting the result values to an .XLS file. These files have 6
fields. The first three correspond to the maximum, middle, and minimum principal quantities (stresses or elastic
strains). The last three correspond to the ANSYS Euler angle sequence (CLOCAL command in the ANSYS envir-
onment) required to produce a coordinate system whose X, Y and Z-axis are the directions of maximum, middle
and minimum principal quantities, respectively. This Euler angle sequence is ThetaXY, ThetaYZ, and ThetaZX
and orients the principal coordinate system relative to the global system. These results can be viewed using the
Graphics button, so that you can use the Vector Display toolbar.
Most common engineering materials exhibit a linear stress-strain relationship up to a stress level known as the
proportional limit. Beyond this limit, the stress-strain relationship will become nonlinear, but will not necessarily
become inelastic. Plastic behavior, characterized by nonrecoverable strain or plastic strain, begins when stresses
exceed the material's yield point. Because there is usually little difference between the yield point and the pro-
portional limit, the ANSYS program assumes that these two points are coincident in plasticity analyses.
98
Section : Results
In order to develop plastic strain, plastic material properties must be defined. You may define plastic material
properties by defining either of the following in the Engineering Data:
Note — Yield stresses defined under the Stress Limits section in the Engineering Data are used for the
post tools only (that is, Stress Safety Tools and Fatigue tools), and do not imply plastic behavior.
Deformation
Physical deformations can be calculated on and inside a part or an assembly. Fixed supports prevent deformation;
locations without a fixed support usually experience deformation relative to the original location. Deformations
are calculated relative to the part or assembly world coordinate system.
Component deformations
The three component deformations Ux, Uy, and Uz, and the deformed shape U are available as individual results.
Scoping is also possible. Numerical data is for deformation in the global X, Y, and Z directions. These results can
be viewed with the model under wireframe display, facilitating their visibility at interior nodes.
Request Vector Deformation plots in the same way that you would request any other result. After inserting the
result object in the Details View under Graphics (listed in the Definition category), choose Vector in the drop-
down menu.
Thermal
Thermal-Stress Environments
Thermal-Stress Results
Thermal Results
Error (Thermal)
Thermal-Stress Environments
To determine stress-related information, the environment must strain the part or assembly. To cause strain, the
environment must contain at least one of the following:
• a structural load
• a structural body load (acceleration or rotation)
• thermal loads causing expansion or contraction
To determine thermal information and to include the effect of thermal expansion in stress answers, the environ-
ment must either include a uniform temperature throughout the body or a temperature distribution throughout.
You can apply a uniform temperature by inserting a Thermal Condition load.
To cause a temperature distribution and heat transfer inside the body, the environment must contain two or
more thermal loads. One known temperature or convection is required.
To account for thermal expansion or contraction in stress answers, define reference temperature. The effects of
thermal expansion are calculated relative to the difference in the temperature inside the part or assembly and
the reference temperature.
Since all stress-related calculations assume static equilibrium, attach at least one structural support.
Simulation automatically restrains a part if it accelerates under load (i.e. if the supports do not prevent all rigid
body motions). The automatic restraints cause reaction forces inside the part and may in some cases permit very
large displacement of the entire part. If large displacement occurs, the automatic restraints may affect the results.
100
Section : Results
In general, when defining an environment, either use at least one fixed-type support, or a combination of supports
that prevent all possible rigid body motion of the part in space.
Thermal-Stress Results
Thermal-Stress provides access to all Section : Stress Tools, structural results, and thermal results.
In addition, given that the part exhibits a temperature distribution or a uniform temperature differs from the
reference temperature, Simulation determines strain resulting from the thermal expansion or contraction of the
part or assembly. All stress results account for the affect of thermal strains.
For uniform thermal expansion of an unsupported body, component strains are defined as:
εx = εy = εz = α(∆T)
where α is the coefficient of thermal expansion (in the material definition) and ∆T is the difference between the
temperature of the body and the reference temperature. You can input a positive or negative value for the
thermal expansion coefficient.
Thermal Results
When the environment causes heat transfer to occur inside a part or across an assembly, Simulation calculates
the temperature at all locations on and inside the body.
Additionally, Simulation calculates the heat flux (q/A, energy per unit time per unit area) throughout the body.
Scoping is also possible. Numerical data is for heat flux in the global X, Y and Z directions.
If the environment contains a single known temperature anywhere on the part or assembly, the entire body as-
sumes that temperature (given steady-state conditions). Heat flux is zero.
The following graphic illustrates an example showing a high temperature area at the top and a low temperature
area at the bottom. Note the direction of the heat flow as indicated by the arrows.
Request Vector Heat Flux plots in the same way that you would request any other result. After inserting the result
object in the tree and solving, click the Graphics button in the Result context toolbar.
Error (Thermal)
The description of this result is the same as Error (Structural) except that heat flux is the basis for the errors instead
of stresses.
Shape Environments
Available for 3-D simulations, and 2-D simulations for Plane Stress behavior only.
To determine Shape results, the Environment must strain the part or assembly. To cause strain, the environment
must contain at least one of the following:
102
Section : Results
• Structural Loads
• Structural body load (acceleration or rotation)
• Thermal Loads causing expansion or contraction
To include the effect of thermal expansion in the Shape solution, the environment must either include a uniform
temperature throughout the part or a temperature distribution throughout the assembly.
A single known temperature load attached anywhere on a part or an assembly causes a uniform temperature
distribution (given steady-state conditions).
To cause a temperature distribution and heat transfer inside the part or assembly, the environment must contain
two or more thermal loads. One known temperature or convection is required.
To account for thermal expansion or contraction in shape answers, define a reference temperature. The effects
of thermal expansion are calculated relative to the difference in the temperature inside the body and the reference
temperature.
Since all calculations assume static equilibrium, you must attach at least one structural support. Use at least one
fixed-type support, or a combination of supports that prevent all possible rigid body motion of the body in space.
Shapes Results
The Section : Details View of the Shape Finder shows the following information:
Note — If Density is temperature dependent, then the mass values reported use a density value calculated
at the reference temperature.
Shape displays results as contour plots of the original part or assembly, with regions of material to remove specially
colored.
Shape optimization pictures provide insight into the optimal layout of material to carry a given load. Use this
information as a guide in determining parametric or feature changes to improve the design of a part or the as-
sembly.
The legend indicates ranges of pseudodensity. Pseudodensity is a number from 0 to 1. Zero represents a prediction
of no material in that region of the model. One represents fully dense material in those regions of the model.
Regions falling between 1.0 and .6 (Keep) are regions of material which efficiently carry the given load. In many
cases, removing material from these regions will have the greatest impact on stress in the part.
Regions falling between .6 and .4 (Marginal) are regions of material which represent the fuzziness or uncertainty
between material to keep and material to remove. Shape predicts that marginal regions will carry a relatively
low level of load in comparison to the material to keep. Marginal regions generally decrease in size as you increase
your accuracy preference, that is, mesh density. That is, higher accuracy tends to “focus” shape optimization
pictures.
Regions falling between .4 and 0.0 (Remove) are regions of material that can be removed with the least impact
on the overall strength of the structure.
Electromagnetic
An Electromagnetic Simulation offers several Results items for viewing. Results may be scoped to bodies and,
by default, all bodies will compute results for display. You can use the Details View to view vector results in sev-
eral ways. Flux Density, Field Intensity, and Force represent the magnitude of the results vector and can be viewed
as a contour or as a directional vector. Any directional solution represents direction vector components (X, Y, Z)
of the vector. They may be displayed as a contour.
Electric Potential
Electric potential represents contours of constant electric potential (voltage) in conductor bodies. This is a scalar
quantity.
Flux Density
Flux density is computed throughout the simulation domain and is a vector quantity. Selecting this option allows
you to view the magnitude of the vector as a contour or as a directional vector.
Field Intensity
Field intensity is computed throughout the simulation domain and is a vector quantity. Selecting this option allows
you to view the magnitude of the vector as a contour or as a directional vector.
104
Section : Results
Force
Force results represent electromagnetic forces on bodies. This is a vector quantity. Selecting this option allows
you to view the magnitude of the vector as a contour or as a directional vector.
Directional Force/Torque
Force vector components are computed throughout the simulation domain. They are meaningful only on non-
air bodies. Selecting this option allows you to view individual vector components (X, Y, Z) as a contour. The total
summed forces are available in the Details view.
Torque results represent the torque on a body due to electromagnetic forces. Torque is specified about the origin
of a coordinate system. By default, the global coordinate system is used. To change the specification point, create
a local coordinate system and specify the results about the new origin. The torque result is listed in the Details
view.
Current Density
Current density can be computed for any solid conductor body. It is displayed as a vector and is best viewed in
wireframe mode. You can use the Vector toolbar to adjust the vector arrow viewing options. You can use the
element-aligned option in the Vector toolbar for current density vectors, but not the grid-aligned option.
Inductance
Inductance can be computed for conductor bodies. It is defined as a measure of the differential change in flux
linkage to the differential change in current. This is represented by the equation below, where dψ is the differential
change in flux linking conductor j produced by a differential change in current for conductor i. Note that this
is valid for linear and nonlinear systems, the inductance will be a function of current.
dij
Lij =
dii
Inductance is often used as a parameter in electric machine design and in circuit simulators.
A conduct body must have a current load to be considered in inductance calculations. All conductors with defined
currents will be considered. Inductance results are presented in the Worksheet View. The results are presented
in table form. The example below shows inductance results for a two-conductor system. The diagonal terms
represent self-inductance, while the off-diagonal terms represent mutual inductance. In this case, L11 = 1e - 4,
L22 = 8e - 4, L12 = L21 = 4e - 4 Henries.
The Details View for inductance allows you to define a Symmetry Multiplier. Use this if your simulation model
represents only a fraction of the full geometry. The multiplier should be set to compensate for the symmetry
model. For example, if you create a half-symmetry model of the geometry for simulation, set the Multiplier to
'2.' Changing the multiplier will update the Worksheet results.
Note — Computing inductance can be time-consuming and should only be used if needed.
Flux Linkage
Flux linkage can be computed for any system incorporating a conductor. Solving for flux linkage calculates the
flux, ψ, linking a conductor. This is commonly referred to as the “flux linkage.” For nonlinear systems, the flux
linkage will be a function of current. Flux linkage is also a function of stroke (e.g., displacement of an armature).
Flux linkage is often used to compute the emf (electromotive force) in a conductor, defined using the equation
below, where V is the electromotive force, typically expressed in volts.
d
v=−
dt
Conductor bodies must have defined current loads to be considered in flux linkage calculations. Flux linkage
results are presented in the Worksheet View. The results are presented in table form. The example below shows
flux linkage results for a two-conductor system.
The Details View for flux linkage allows you to define a Symmetry Multiplier. Use this if your simulation model
represents only a fraction of the full geometry. The multiplier should be set to compensate for the symmetry
model. For example, if you create a half-symmetry model of the geometry for simulation, set the Multiplier to
'2.' Changing the multiplier will update the Worksheet results.
Note — Computing flux linkage can be time-consuming and should only be used if needed.
Reactions
Simulation reports both reaction forces and reaction moments for the following types of supports (note that
reaction moments are reported at the centroid of the support):
• Fixed surface
• Fixed edge
• Fixed vertex
• Displacement for surfaces (If a Displacement is defined in a local coordinate system, the reaction forces
and moments are still reported in the global coordinate system.)
• Displacement for edges (If a Displacement is defined in a local coordinate system, the reaction forces and
moments are still reported in the global coordinate system.)
• Displacement for vertices (If a Displacement is defined in a local coordinate system, the reaction forces
and moments are still reported in the global coordinate system.)
• Remote Displacement (If a Remote Displacement is defined in a local coordinate system, the reaction
forces and moments are still reported in the global coordinate system.)
• Frictionless surface
106
Section : Results
• Convection
• Temperature
• Radiation
Note — A reported reaction may be inappropriate if that support shares a surface, edge, or vertex with
another support, contact pair, or load. This is because the underlying finite element model will have both
loads and supports applied to the same nodes.
If a model contains two or more supports that share an edge or vertex, use caution in evaluating the listed
reaction forces at those supports. Calculation of reaction forces includes the force acting along bounding
edges and vertices. When supports share edges or vertices the global summation of forces may not appear
to balance. Reaction forces may be incorrect if they share an edge or surface with a contact region.
When a Generalized Plane Strain load is applied (2-D application), Simulation reports the following reactions:
Convergence
You can control the relative accuracy of a solution in two ways. You can use the meshing tools to refine the mesh
before solving, or you can use convergence tools as part of the solution process to refine solution results on a
particular area of the model. This section discusses the latter.
Through its convergence capabilities, the application can fully automate the solution process, internally controlling
the level of accuracy for selected results. You can seek approximate results or adapted/converged results.
To add convergence, click the result you added to your solution; for example, Equivalent Stress or Total De-
formation. If you want to converge on deformation, right-click on Total Deformation and select Insert> Con-
vergence. In the Section : Details View, you can specify convergence on either the Minimum or Maximum value.
Additionally, you can specify the Allowable Change between convergence iterations.
Note — Convergence objects inserted under an environment that is referenced by an Initial Condition
object or a Thermal Condition load object, will invalidate either of these objects, and not allow a solution
to progress.
For an adaptive solution, a solution is first performed on the base mesh, and then the elements are queried for
their solution information (such as deflection, X-stress, Y-stress, etc.). If the element's results have a high Zien-
kiewicz-Zhu, or ZZ error (see the ANSYS, Inc. Theory Reference for more information on adaptivity theory), the
element is placed in the queue to be refined. The application then continues to refine the mesh and perform
additional solutions. If your mesh is initially made up of hexahedron, adaptivity will be more robust if you remesh
the model with tetrahedron before your first solve.
You can control the aggressiveness of the adaptive refinement by adjusting the Refinement Depth setting under
Adaptive Convergence in the Details View of a Solution object. The default value is 2 and the range is from 0
to 3. By default, when adaptive convergence occurs, the program will refine to a depth of 2 elements to help
ensure smooth transitions and avoid excessive element distortion for repeated refinement. However, you c an
adjust this refinement depth to a value of 0 or 1 if for a particular problem, the deep refinement is not required
and problem size is a major concern. In general the default value of 2 is highly recommended. However, you can
lower the value if too much refinement is occurring and is overwhelming the solution in terms of size of solution
time. If you use a value less than 2, be aware of the following:
• Verify that false convergence is not occurring because of too little refinement.
• More refinements may be required to achieve the desired tolerance, which may increase the total solution
time.
108
Section : Results
The following pictures show the effects of various settings of Refinement Depth on plots of Total Deformation.
General Notes
Low levels of accuracy are acceptable for demonstrations, training, and test runs. Allow for a significant level of
uncertainty in interpreting answers. Very low accuracy is never recommended for use in the final validation of
any critical design.
Moderate levels of accuracy are acceptable for many noncritical design applications. Moderate levels of accuracy
should not be used in a final validation of any critical part.
High levels of accuracy are appropriate for solutions contributing to critical design decisions.
When convergence is not sought, studies of problems with known answers yield the following behaviors and
approximated errors:
At maximum accuracy, less than 20% error for peak stresses and strains, and minimum margins and factors of
safety.
At maximum accuracy, between 5% and 10% error for average (nominal) stresses and elastic strains, and average
heat flows.
At maximum accuracy, between 1% and 5% error for average stress-related displacements and average calculated
temperatures.
At maximum accuracy, 5% or less error for mode frequencies for a wide range of parts.
When seeking highly accurate, Converged Results, more computer time and resources will be required than
Manual control, except in some cases where the manual preference approaches highest accuracy.
Given the flexible nature of the solver engine, it is impossible to explicitly quantify the effect of a particular ac-
curacy selection on the calculation of results for an arbitrary problem. Accuracy is related only to the represent-
ation of geometry. Increasing the accuracy preference will not make the material definition or environmental
conditions more accurate. However, specified converged results are nearly as accurate as the percentage criteria.
Critical components should always be analyzed by an experienced structural engineer or analyst prior to final
acceptance.
Probe Tool
The Probe Tool allows you to find results at a point on the model, or to find minimum or maximum results for
a Probe on a body, face, edge or vertex. It can be used with the following simulation types: structural, thermal,
structural sequenced, thermal transient, and electromagnetic.
You can insert a Probe Tool object under Solution in the tree, as you would any result tool. You can adjust options
in the Details View or add results for specific points/geometry.
• Structural Simulation
→ For Stress/Strain: All, Components, Principals, Normal X, Normal Y, Normal Z, XY Shear, YZ Shear,
XZ Shear, Minimum Principal, Middle Principal, Maximum Principal, Intensity, and Equivalent (von-
Mises)
→ For Deformation: All, X Axis, Y Axis, Z Axis, and Total
• Thermal
• Structural Sequenced
→ Selecting Single Time Point will also display Sequence Number where you enter the sequence
number to display results from (default = 1).
– Result Selection
110
Section : Results
→ For Stress/Strain: All, Components, Principals, Normal X, Normal Y, Normal Z, XY Shear, YZ Shear,
XZ Shear, Minimum Principal, Middle Principal, Maximum Principal., Intensity, and Equivalent (von-
Mises)
→ For Deformation: All, X Axis, Y Axis, Z Axis, and Total
• Thermal Transient
→ Selecting Single Time Point also displays the Display Time option where you enter the time to
display results from (default = End Time).
– Result Selection
• Electromagnetic
Probe Object
The result type specified under Type in the Probe Tool determines the result items that are displayed in the
Details View of the Probe object.
If Coordinate System objects are in the tree under Model, an Orientation option will be displayed that allows
you to specify a coordinate system. A Location Method option is also displayed with the following options:
• If Coordinate System is chosen, you will see a Location drop-down and the X,Y,Z Coordinates of the
location.
• If Geometry Selection is chosen, a Geometry option is displayed. You can select an x,y,z point, edges,
vertices, faces or bodies. If you select a point using the x,y,z picking method, the X,Y,Z Coordinates of
the location will still be shown.
Note — Probe objects scoped to x,y,z picking locations are achieved in such a way that a projection
of the picked location in screen coordinates occurs onto the model based on the current view
orientation, in other words, normal to the display screen onto the model at the picked location
on the screen. If the geometry is updated, the update of the projection will follow the original
vector that was established “behind the scenes” when the x,y,z pick was first made. Therefore the
update of Probe objects scoped to x,y,z picking locations may not appear to be logical since it
follows a vector that was established dependent on a view orientation when the original pick was
made.
For the other geometries, an Output option is displayed. This allows you to elect to show either Maximum
or Minimum result values across the given selection.
For sequenced or transient simulations, if you select All Time Points in the Probe Tool, you will see the
maximum and minimum result values across sequence numbers/time.
Note — The management of these windows (for example, repositioning) differs on Windows platforms
vs. Unix platforms.
Results for each probe object are charted in the Timeline controller and listed in the Tabular Data window for
all sequence steps or result time points.
The following options are also available in a context menu that displays when you click the right mouse button
within the Timeline controller and/or the Tabular Data widow. The descriptions that are linked below apply to
either step numbers for a sequenced or time points for a transient simulation.
• Copy Cell: Copies the cell data into the clipboard for a selected cell or group of cells. The data may then
be pasted into another cell or group of cells. The contents of the clipboard may also be copied into Microsoft
Excel. Cell operations are only valid on load data and not data in the Step column.
• Select All: Selects all cells in the Tabular Data window.
• Zoom to Range: Zooms in on a subset of the data in the Timeline controller. Click and hold the left mouse
at a step or time result location and drag to another step or time result location. The dragged region will
highlight in blue. Next, select Zoom to Range. The chart will update with the selected steps or time points
data filling the entire axis range.
• Zoom to Fit: If you have chosen Zoom to Range and are working in a zoomed region, choosing Zoom
to Fit will return the axis to full range covering all steps.
Partial results that are returned will be flagged as complete and up to date (green check), but the solution itself
will be obsolete. So, if you choose Solve again, a full solution will occur. The partial results are also accompanied
by an error message stating why the solution failed and a statement indicating that partial results were returned.
To post process additional results without a full solve, click the right mouse button on a Solution or Result object
in the tree and choose Evaluate Results from the context menu. Evaluate Results will recalculate results that
are based only on the current Workbench solution. It will not perform a full ANSYS solution (as it would if you
112
Section : Solving Overview
chose Solve), even if one is required. Evaluate Results can be useful to force the post processing of results in
the following three cases:
• If a partial thermal transient solution occurs, any results whose display time is past the last solved
time will be displayed at that last solved time.
• Results in Solution Combination objects that use partial solutions will not be solved. You can
view partial results but cannot use them in further post/solution work (for example, for Thermal
Condition loads, Solution Combination objects).
• There may be some instances (for example, harmonic simulations), where a full solution is required
and Evaluate Results should not be used.
Solving Overview
If you are using the Section : Simulation Wizard, you must be sure that all the tasks in the wizard are complete
before you try to solve. You can initiate a solve using programmed controlled and default settings by following
any of these procedures:
The Section : Details View of the Solution object includes settings that allow you to adjust conditions before
you initiate the solve, based on your situation. These settings are described below and apply to all static and
harmonic simulations. When solving a transient simulation, refer to Solving Overview (Transient Simulations),
where differences and special provisions are described.
Adaptive Convergence
See Convergence.
Solver Type
If you want to specify a Solver type for Simulation to use, select the Solver Type field. You can choose between
Program Controlled, Direct, or Iterative solvers. A direct solver works better with thin flexible models.
An iterative solver works better for bulky models. In most cases, the program controlled option does select the
optimal solver.
Weak Springs
For structural or shape simulations, the addition of weak springs can facilitate a solution by preventing numerical
instability, while not having an effect on real world engineering loads. The following Weak Springs settings are
available in the Details View:
• Programmed Controlled (default): Workbench determines if weak springs will facilitate the solution,
then adds a standard weak springs stiffness value accordingly.
• On: Workbench always adds a weak spring stiffness. Choosing On causes a Spring Stiffness option to
appear that allows you to control the amount of weak spring stiffness. Your choices are to use the standard
stiffness mentioned above for the Programmed Controlled setting of Weak Springs or to enter a cus-
tomized value. The following situations may prompt you to choose a customized stiffness value:
a. The standard weak spring stiffness value may produce springs that are too weak such that the solution
does not occur, or that too much rigid body motion occurs.
b. You may judge that the standard weak spring stiffness value is too high (rare case).
c. You many want to vary the weak spring stiffness value to determine the impact on the simulation.
– Programmed Controlled (default): Adds a standard weak spring stiffness (same as the value added
for the Programmed Controlled setting of Weak Springs).
– Factor: Adds a customized weak spring stiffness whose value equals the Programmed Controlled
standard value times the value you enter in the Spring Stiffness Factor field (appears only if you
choose Factor). For example, setting Spring Stiffness Factor equal to 20 means that the weak springs
will be 20 times stronger than the Programmed Controlled standard value.
– Manual: Adds a customized weak spring stiffness whose value you enter (in units of force/length) in
the Spring Stiffness Value field (appears only if you choose Manual).
• Off: Weak springs are not added. Use this setting if you are confident that weak springs are not necessary
for a solution.
Large Deflections
If you expect large deflections (as in the case of a long, slender bar under bending) or large strains, you can set
Large Deflection On. When using hyperelastic material models, you must set Large Deflection On.
• Programmed Controlled (default): Workbench automatically switches time stepping on and off as needed.
A check is performed on nonconvergent patterns. The physics of the simulation is also taken into account.
• On: You control time stepping by completing the following fields that only appear if you choose this option.
No checks are performed on nonconvergent patterns and the physics of the simulation is not taken into
account
– Initial Substeps: Specifies the size of the first substep. The default is 1.
– Minimum Substeps: Specifies the minimum number of substeps to be taken (that is, the maximum
time step size). The default is 1.
– Maximum Substeps: Specifies the maximum number of substeps to be taken (that is, the minimum
time step size). The default is 10.
• Off: No time stepping is enabled. You are prompted to enter the Number Of Substeps. The default is 1.
The RTH file is optional in that a dsdb file can be moved/copied/shared/archived without the RTH file. You can
still view the results in the tree without the RTH file, but if new results are added to the tree, you will have to re-
solve to see the results. However, if the RTH file is in place, then new results can be added to the tree without a
re-solve because they can be quickly read from the RTH file.
The RTH file name and location are displayed both in Simulation and on the Workbench Project Page. In Simulation,
you can specify the RTH file name and location in the Details View of a Solution object using the Result File
Name Selection setting (displayed only for thermal simulations). The following options are available:
• Manual: Displays an editable Result File field where you must enter the RTH file name and path location.
On each solve the program will overwrite this file. You can re-link to an RTH file by specifying it in the
Result File field. A reason for doing this is if Simulation does not know the location of the file (for example,
if the dsdb file was moved to a new directory but the RTH file was not).
• Program Controlled: The solve process decides the name and location of the RTH file. The name and
location are displayed in the read-only Result File field after the solve.
– The file name is based on the name of the dsdb file if the dsdb file has already been saved. Otherwise,
the name is based on the Model and Environment names.
– The file is placed in the same directory as the dsdb file if the dsds file has already been saved, and if
the dsdb file location is writeable. Otherwise the file will be placed in your solver working directory as
specified in the Options dialog Solution settings.
– On each solution the Result File name may change.
– Upon a first save of a dsdb file, the program will move RTH files from the solver working directory to
the dsdb file's folder so that it will be easy for you to find the result files.
– The program preserves an RTH file until it is no longer needed. For example, consider a situation where
you save aa.dsdb along with aa.rth. You then perform another solution that generates aa2.rth, and
exit without saving. The program will delete aa2.rth and retain aa.rth because aa.rth is associated
with the version of aa.dsdb that is saved on disk. If you save aa.dsdb on exit, the program will delete
aa.rth and retain aa2.rth because now aa2.rth is the result file referenced by the version of aa.dsdb
that is saved on disk.
• If you choose Manual and specify the same RTH file path for two solutions in the dsdb file, or for
two solutions in multiple dsdb files, the file will be overwritten without question for each solve.
This means when one solution is solved, the RTH file will be lost for the other solutions. To avoid
this, you must specify a different path for each solution or use the Program Controlled option
to have Simulation manage the file naming.
• A second branch may be dependent on a thermal branch through a Thermal Condition load or
an Initial Condition object. If you try to solve the second branch, the RTH file from the first branch
must be present at the specified location on disk. If the RTH file is not present, an error dialog is
displayed. You must either locate the RTH file and re-link it to the first branch, or solve the first
branch again to regenerate the RTH file.
• The RTH file must be present for the user to animate temperature results.
• A synchronous solution runs exclusively on your local machine and finalizes while you are in the particular
Workbench session. A synchronous solution is recommended for simulations that are not expected to be
extremely CPU intensive.
• An asynchronous solution can be sent to run on a remote and more powerful machine. These solutions
are queued and not restricted to run and finalize during any particular Workbench session. Asynchronous
solutions are recommended for large models or other simulations that require a large amount of processing
time and machine resources.
By default, a solution will run synchronously. The Details View of a Solution object includes the Run Solver
Process on drop down menu under the Process Settings category that allows you to set an asynchronous
solution. When set to Local Machine (the default), the solution will automatically be synchronous. When set to
any of the other options, the solution will automatically be asynchronous.
• Parameter Manager objects (in Simulation). These objects will automatically be suppressed if
an asynchronous solving option is selected.
• Convergence objects.
• Implicit Thermal Stress simulations.
• Pressure object using the CFX Load option.
Presented below are further details on choices available in the Details View of a Solution object under the Process
Settings category.
Run Process on: Specifies where the solve process will run. The following choices are available:
• Local Machine (default): Sets a synchronous solution that will run on the local desktop machine.
• LSF Cluster: Solution will be submitted to an LSF cluster (Windows only). This requires that you have LSF,
a separate product from PlatformTM Computing that manages job queues and balances machine resources.
The Workbench client machine must be a member of the LSF cluster. If you choose LSF Cluster, the fol-
lowing fields also appear in the Details View:
• WB Cluster: Solution will be submitted to local Remote Solution Manager (RSM) or a Remote Solution
Manager web service. The latter requires that you have a Remote Solution Manager configured according
to the ANSYS Workbench Products Remote Solution Manager Configuration Guide (included as part of the
ANSYS Workbench Products Installation and Configuration Guides, accessible from the main menu under
Help> Installation and Licensing Help). If you choose WB Cluster, the following fields appear in the
Details View:
– RSM Web Server: Specifies the name of the Web Service machine that is accessible on your network.
If you enter localhost, the client machine acts as the local web service and server.
– Assignment: Specifies whether the solution is to run on a Queue or on a specific Server (Note:
Server option only supported for Unix/Linux compute servers).
– Queue: (appears if Assignment is set to Queue) Specifies the name of the queue containing compute
servers.
– Compute Server: (appears if Assignment is set to Server) Specifies the name of the server where the
computation intensive portion of the solution will run (Unix/Linux only).
– User Name: Specifies a valid login name for the server name that you entered. Leave field blank if not
applicable. Leave field blank to use preconfigured value on RSM compute server.
– Password: Specifies a valid password for the server name and User Name that you entered. Leave
field blank if not applicable, or to use preconfigured value on RSM compute server.
– Working Directory: Specifies a valid directory on the machine whose name is entered in server. The
user whose name is entered in User Name must have write access to this directory. Leave field blank
to use preconfigured value on RSM compute server.
– Command: Specifies a valid command line for running ANSYS on the server machine. This field is re-
quired for Unix/Linux compute servers.
– License to Use: Specifies the name of a valid ANSYS product license (ANSYS Professional or higher)
to be used for the solution on the Remote Solution Manager server or on the compute server.[1]
[1] You need to specify an ANSYS product license because a separate instance of ANSYS is being used. The license
from your current ANSYS Workbench client session cannot be accessed from the remote ANSYS executable file.
Number Of Processors: Specifies the number of processors to use during solution. The default is 2. The range
is from 1 to 8. If you specify a number greater than the number of processors in the computer, the highest
available number of processors is used.
ANSYS Memory Settings: Specifies the amount of system memory used for the ANSYS workspace and database.
The following options are available:
• Programmed Controlled (default): Workbench determines the best memory settings for the solve. You
are advised to use this setting unless you are fully aware of the consequences resulting from manually
inputting the settings.
• Manual: Allows you to specify the memory settings. Choosing this option displays the Workspace Memory
and Database Memory fields where you can enter the values in MB.
You can perform the following tasks related to process settings through a context menu (right mouse button
click) on a Solution object:
The copied process settings are merely a starting point for the second Solution object and may be changed
further from these settings.
• To copy default settings from the Options dialog box to a Solution object:
1. Click on one or more Solution objects (hold down the [Ctrl] key for multiple selections).
2. Right mouse click on one of the Solution objects.
3. Choose Process Settings> Restore Defaults.
The copied process settings are merely a starting point and may be changed further from these settings.
• To save the process settings from one Solution object as the defaults for all newly created Solution objects:
Output Controls
The Details View of a Solution object includes an Output Controls section that allows you to suppress individual
result output types from ANSYS so that those output types are not returned to the results file. Output Controls
are applicable to result objects and affected Probe results under Solution, as well as result objects under a
Solution Combination object involving a simulation that is using Output Controls. This feature is useful for
conserving the size of the results file, especially for large simulations or transient simulations. Each result type
under Output Controls has a Yes or No option that you can change through a drop down menu or by double-
clicking in the particular result type field. Choosing Yes allows the result type from ANSYS to be included in the
results file. Choosing No suppresses the result type. If any result object under Solution depends on a result type
that was suppressed, that result object will appear as underdefined.
Solution Scenarios
This section describes Solver Process Settings for the following example solution scenarios:
Note —
• The Local queue is available out-of-the-box and configured to run one solve at a time on the
local machine.
• To run multiple simultaneous jobs on the local machine, add another server to the Local queue.
For example, add LocalHost2 and set machine to localhost so that 2 jobs can run at the same
time.
Note — If you are using the RSM Web Service, the client Workbench machine can be shutdown. You
must save the Simulation database to reconnect to the job later.
Note —
• Create servers and queues using the Solution Status monitor tray application.
• If User Name, Password, or Working Directory are blank, the settings in the server properties
are used.
• For RSM Web Server = localhost, queues containing Windows machines is supported.
• To run multiple simultaneous jobs on a Unix/Linux machine, create multiple servers in the queue
that represent the same machine.
Note —
• This scenario is basically the same as Solve to Queue Managed by Local RSM Job Manager except
the queue is created by the RSM administrator.
• If the queue consists of Windows machines, Command is ignored.
• If User Name, Password, or Working Directory are blank, the settings in the server properties
are used.
• Nonlinear Formulation - Controls how nonlinearities are to be handled for the solution. The following
options are available:
– Program Controlled (default) - Workbench automatically chooses between the Full or Quasi setting
as described below. The Quasi setting is based on a default Reformulation Tolerance of 5%.
– Full - Manually sets formulation for a full Newton-Raphson solution.
– Quasi - Manually sets formulation based on a tolerance you enter in the Reformulation Tolerance
field that appears if Quasi is chosen.
• Auto Time Stepping - For a transient simulation, these controls appear under the Transient Settings
object instead of under the Solution object. The description of their function is the same as that described
under Automatic Time Stepping for static and harmonic simulations except for the addition of a Define
By setting, which allows you to define either Time or Substeps increments. If you choose the Program
Controlled option, the default settings are as follows:
– Time increments:
– Substeps increments:
You may manually enter the Time step or Substeps increments by setting Auto Time Stepping to On.
If constant time-stepping is desired, use the Off setting and enter the Time step or Number of Substeps.
Note — Refer to the troubleshooting section if you receive a warning message stating that the
initial time increment may be too large for this problem.
• Visibility - Controls that allow you to selectively display various components of the Transient Settings
worksheet that appears when you select the Transient Settings object.
Solving
1.
Once you have defined your model, you are ready to solve. Click the Solve icon, , to Solve.
• If you want to solve all branches of your Outline, go to the project level and issue a solve.
• If you want to solve particular branches, you can multi-select those branches and solve them simul-
taneously.
• If you selected an asynchronous solution, you still see the Meshing dialog box because meshing will
first be run locally and synchronously before the solve is sent to the queue. Meshing locally allows
the same mesh to be used in each solve if multiple Solutions are being solved simultaneously under
a single Model, rather than re-meshing for each solve. For both synchronous and asynchronous
solves, you can check your mesh before solving through a right mouse click on the Mesh object and
selecting Preview Mesh in the context menu.
2. A Solution Status window in Simulation monitors solution progress for synchronous solutions. Conven-
tional progress bars are displayed in this window along with a Stop Solution button.
Under most circumstances, error messages are displayed in a dialog box immediately after attempting
the solution. If you attempt to solve for multiple branches (for example, from the Parameter Manager
object or from the Project object) error messages from invalid branches will be suppressed to allow
valid branches to proceed uninterrupted. In all cases, you can review error messages by clicking in the
Solver Messages field under the Details View of the corresponding Solution object.
The following characteristics apply to asynchronous solutions where a Solution Status monitor runs
outside of Simulation:
• While an asynchronous solution is in progress for a branch, that branch will be in a read-only state.
Other branches can be edited freely.
• You can cancel a running job and reset the state of the tree by selecting Solution in the tree and
choosing Stop Solution in the context menu (right mouse button click). Also, in the Solution Status
monitor, you can remove a selected job name from the list. This should only be used to clean up the
list. It will not impact the state of the tree.
• A down arrow status symbol indicates that a successful solution (green arrow) or failed solution (red
arrow) is ready for download.
• When the green down arrow is displayed to indicate results are ready for download, choose Get
Results from the context menu to perform the download.
• When the red down arrow is displayed to indicate a failed solution, choose Get Results from the
context menu to download any error messages.
Note — While a solve is in progress on a UNIX server, do not reboot or log off of the Windows
client machine. If you reboot or log off, the connection to the UNIX job will be lost and results
will not be retrievable. If the UNIX job has completed, or if the job is running on an LSF Cluster
or WB Cluster, then rebooting or logging off is safe.
Solving Units
There are five possible unit systems for a Simulation solution. The following table shows all the unit systems in
the column headings that are available. For a given Simulation run, one of the five systems is selected and all
quantities are converted into that system. This guarantees that all quantities, inputs and outputs to ANSYS, can
be interpreted correctly in terms of the units in the system.
m, kg, N, oC, s, V, A cm, g, dyne, oC, s, mm, kg, N, oC, s, ft, lbm, lbf, oF, s, V, in, lbm, lbf, oF, s, V,
V, A mV, mA A A
Acceleration meters/second2 centi- milli- feet/second2 [ft/s2] inches/second2
[m/s2] meters/second2 meters/second2 [in/s2]
[cm/s2] [mm/s2]
Angle radians [rad] radians [rad] radians [rad] radians [rad] radians [rad]
Angular Velocity radians/second radians/second radians/second radians/second radians/second
[rad/s] [rad/s] [rad/s] [rad/s] [rad/s]
Area meters2 [m2] centimeters2 [cm2] millimeters2 [mm2] feet2 [ft2] inches2 [in2]
Capacitance Farads [F] Farads [F] microFarads [µF] Farads [F] Farads [F]
Charge Coulombs [C] Coulombs [C] milliCoulombs [mC] Coulombs [C] Coulombs [C]
m, kg, N, oC, s, V, A cm, g, dyne, oC, s, mm, kg, N, oC, s, ft, lbm, lbf, oF, s, V, in, lbm, lbf, oF, s, V,
V, A mV, mA A A
Charge Density Coulombs/meter2 Coulombs/centi- milliCoulombs/milli- Coulombs/foot2 Coulombs/inch2
[C/m2] meter2 [C/cm2] meter2 [mC/mm2] [C/ft2] [C/in2]
Conductivity Watts/meter.degree dynes/second.de- ton.milli- (pound mass/32.2) (pound mass/386.4)
Centigrade gree Centigrade meters/second3.de- feet/second3.de- inches/second3.de-
[W/m.oC] [dyne/s.oC] gree Centigrade gree Fahrenheit gree Fahrenheit
[ton.mm/s3.oC] [(lbm/32.2)ft/s3.oF] [(lbm/386.4)in/s3.oF]
Current Amperes [A] Amperes [A] milliAmperes [mA] Amperes [A] Amperes [A]
Current Density Amperes/meter2 Amperes/centi- milliAmperes/milli- Amperes/foot2 Amperes/inch2
[A/m2] meter2 [A/cm2] meter2 [mA/mm2] [A/ft2] [A/in2]
Density kilograms/meter3 grams/cm3 [g/cm3] tons/millimeter3 (pounds (pounds
[kg/m3] [ton/mm3] mass/32.2)1/foot3 mass/386.4)1/inch3
[(lbm/32.2)1/ft3] [(lbm/386.4)1/in3]
Displacement meters [m] centimeters [cm] millimeters [mm] feet [ft] inches [in]
Electric Conductiv- Siemens/meter Siemens/centi- Siemens/millimeter Siemens/foot [S/ft] Siemens/inch [S/in]
ity [S/m] meter [S/cm] [S/mm]
Electric Field Volts/meter [V/m] Volts/centimeter milliVolts/milli- Volts/foot [V/ft] Volts/inch [V/in]
[V/cm] meter [mV/mm]
Electric Flux Dens- Coulombs/meter2 Coulombs/centi- milliCoulombs/milli- Coulombs/foot2 Coulombs/inch2
ity [C/m2] meter2 [C/cm2] meter2 [mC/mm2] [C/ft2] [C/in2]
Electric Resistivity Ohm.meters Ohm.centimeters Ohm.millimeters Ohm.Cir-mils/foot Ohm.Cir-mils/inch
[Ohm.m] [Ohm.cm] [Ohm.mm] [Ohm.Cir-mil/ft] [Ohm.Cir-mil/in]
Energy Joules [J] Ergs [erg] milliJoules [mJ] British Thermal Unit British Thermal Unit
[BTU] [BTU]
Film Coefficient Watts/meter2.de- dynes/second.centi- tons/second3.de- (pounds (pounds
gree Centigrade meter.degree Centi- gree Centigrade mass/32.2)1/second3.de- mass/386.4)1/second3.de-
[W/m2.oC] grade [ton/s3.oC] gree Fahrenheit gree Fahrenheit
[dyne/s.cm.oC] [(lbm/32.2)1/s3.oF] [(lbm/386.4)1/s3.oF]
Force Newtons [N] dynes [dyne] Newtons [N] (pound (pound
mass/32.2)feet/second2 mass/386.4)inches/second2
[(lbm/32.2)ft/s2] [(lbm/386.4)in/s2]
Force Intensity Newtons/meter dynes/centimeter tons/second2 (pounds (pounds
[N/m] [dyne/cm] [ton/s2] mass/32.2)1/second mass/386.4)1/second2
2
[(lbm/32.2)1/s2] [(lbm/386.4)1/s2]
Frequency Hertz [Hz] Hertz [Hz] Hertz [Hz] Hertz [Hz] Hertz [Hz]
Heat Flux Watts/meter2 dynes/second.centi- tons/second3 (pounds (pounds
[W/m2] meter [dyne/s.cm] [ton/s3] mass/32.2)1/second mass/386.4)1/second3
3
[(lbm/32.2)1/s3] [(lbm/386.4)1/s3]
Heat Generation Watts/meter3 dynes/second.centi- tons/second3.milli- (pounds (pounds
mass/32.2)1/second3.foot mass/386.4)1/second3.inch
[W/m3] 2 . 2 3.
meter [dyne/s cm ] meter [ton/s mm]
[(lbm/32.2)1/s3.ft] [(lbm/386.4)1/s3.in]
Heat Rate Watts [W] dyne.centi- ton.milli- (pound (pound
meters/second meters2/second3 mass/32.2)feet /second mass/386.4)inches2/second3
2 3
m, kg, N, oC, s, V, A cm, g, dyne, oC, s, mm, kg, N, oC, s, ft, lbm, lbf, oF, s, V, in, lbm, lbf, oF, s, V,
V, A mV, mA A A
Inductance Henries [H] Henries [H] milliHenries [mH] Henries [H] Henries [H]
Magnetic Field In- Amperes/meter Oersteds [Oe] milliAmperes/milli- Amperes/foot [A/ft] Amperes/inch[A/in]
tensity [A/m] meter [mA/mm]
Length meters [m] centimeters [cm] millimeters [mm] feet [ft] inches [in]
Magnetic Field In- Amperes/meter Oersteds [Oe] milliAmperes/milli- Amperes/foot [A/ft] Amperes/inch [A/in]
tensity [A/m] meter [mA/mm]
Magnetic Flux Webers [Wb] Maxwells [Mx] milliWebers [mWb] Webers [Wb] Webers [Wb]
Magnetic Flux Teslas [T] Gauss [G] milliTeslas [mT] Teslas [T] Teslas [T]
Density
Mass kilograms [kg] grams [g] tons [ton] (pounds mass/32.2) (pounds
[(lbm/32.2)] mass/386.4)
[(lbm/386.4)]
Moment Newton.meters dyne.centimeters ton.milli- (pound (pound
[N.m] [dyne.cm] meters2/second2 mass/32.2)feet /second mass/386.4)inches2/second2
2 2
[(lbm/32.2)1/s2.ft] [(lbm/386.4)1/s2.in]
Relative Permeab- unitless unitless unitless unitless unitless
ility
Relative Permittiv- unitless unitless unitless unitless unitless
ity
Section Modulus meters3 [m3] centimeters3 [cm3] millimeters3 [mm3] feet3 [ft3] inches3 [in3]
Shear Elastic radians [rad] radians [rad] radians [rad] radians [rad] radians [rad]
Strain
Specific Heat Joules/kilogram.de- dyne.centi- milli- feet2/second2.de- inches2/second2.de-
gree Centigrade meters/gram.de- meters2/second2.de- gree Fahrenheit gree Fahrenheit
.o
[J/kg C] gree Centigrade gree Centigrade [ft2/s2.oF] [in2/s2.oF]
2 2.o
[mm /s C]
[dyne.cm/g.oC]
Specific Weight Newtons/meter3 dynes/centimeter3 tons/second2.milli- (pounds (pounds
2 mass/32.2)1/second2.feet2 mass/386.4)1/second2.inch2
[N/m3] 3
[dyne/cm ] meters
[ton/s2.mm2] [(lbm/32.2)1/s2.ft2] [(lbm/386.4)1/s2.in2]
Stiffness Newtons/meter dynes/centimeter Newtons/millimeter pounds force/foot pounds force/inch
[N/m] [dyne/cm] [N/mm] [lbf/ft] [lbf/in]
m, kg, N, oC, s, V, A cm, g, dyne, oC, s, mm, kg, N, oC, s, ft, lbm, lbf, oF, s, V, in, lbm, lbf, oF, s, V,
V, A mV, mA A A
Stress Pascals [Pa] dynes/centimeter2 Mega Pascals [MPa] (pounds (pounds
2 mass/32.2)1/second2.foot mass/386.4)1/second2.inch
[dyne/cm ]
[(lbm/32.2)1/s2.ft] [(lbm/386.4)1/s2.in]
Strength Pascals [Pa] dynes/centimeter2 Mega Pascals [MPa] (pounds (pounds
2
[dyne/cm ] mass/32.2)1/second foot mass/386.4)1/second2.inch
2.
[(lbm/32.2)1/s2.ft] [(lbm/386.4)1/s2.in]
Thermal Expan- 1/degree Centi- 1/degree Centi- 1/degree Centi- 1/degree Fahren- 1/degree Fahren-
sion grade [1/oC] grade [1/oC] grade [1/oC] heit [1/oF] heit [1/oF]
Temperature degrees Centigrade degrees Centigrade degrees Centigrade degrees Fahrenheit degrees Fahrenheit
[oC] [oC] [oC] [oF] [oF]
Time seconds [s] seconds [s] seconds [s] seconds [s] seconds [s]
Velocity meters/second centimeters/second millimeters/second feet/second [ft/s] inches/second [in/s]
[m/s] [cm/s] [mm/s]
Voltage Volts [V] Volts [V] milliVolts [mV] Volts [V] Volts [V]
Volume meters3 [m3] centimeters3 [cm3] millimeters3 [mm3] feet3 [ft3] inches3 [in3]
Results of Solving
Once the solve is complete, the Simulation Wizard shows complete check marks for each task in the
simulation process.
You can Section : View Results in the Section : Geometry window. The model displays in the center of the screen.
A legend appears which indicates the meaning of the colors in the model. The Section : Triad and Rotation
Cursors appears in the lower right-hand corner, allowing you to manipulate the model. You can also use the
mouse to move the model.
Section : Graphics
Legend
Section : View Results
Section : Saving your Results in Simulation
To save your Simulation results in an ANSYS database file, click Solution on the Section : Tree Outline and
in its Details, click Yes next to Save ANSYS db. When you do this, the ANSYS db File Name box appears.
Click the to view a dialog box which allows you to name the file and specify its location. This location
is usually in your Documents and Settings\<your ID>\Local Settings\Temp folder. Note that there is
no relation between Save ANSYS db and the Save Ansys Files setting in the Options dialog box under
Solution. As mentioned above, Save ANSYS db refers to ANSYS creating and saving a database file in a
specified location. Save Ansys Files refers to files created by ANSYS during a solve.
To create an ANSYS input file (.inp), select Tools > Write Ansys Input File... from the Main Menu. The
Save As dialog box appears, allowing you to type the name of the file and specify its location. This location
is usually in your Program Files\Ansys Inc\v100\AISOL\Common Files folder.
This feature can be used to perform analyses in ANSYS while taking advantage of the meshing capabilities
within Simulation. The procedure is as follows:
Note — Any named selection group from Simulation is transferred to ANSYS as a component ac-
cording to specific naming rules and conventions.
To save your solution as a Simulation database file (.dsdb), select File> Save As. ....The Save As dialog
box appears, allowing you to type the name of the file and specify its location.
The ANSYS Workbench database file has a set of related files, specifically, the .log and .err files. These take their
names from the Initial Jobname set in the ANSYS launcher.
The various results and log files related to the solutions for each Environment Object in the model reside in
subdirectories of the working directory. These subdirectories take their name from the name of the database
file, and the filename is incremented for each environment. So, if we continue with the example above and the
beam_1.dsdb database contains two environments, the subdirectories that contain the various results files will
have the names beam_1_1 and beam_1_2.
The file and directory structure generated by a solve for the example from above would look like this:
If you loaded a file from a directory other than the specified working directory, when you save the .dsdb file, the
ANSYS Workbench will produce the Save as..., with the working directory as the default location and the current
filename as the default name. You can now save the file anywhere you wish. What occurs when you use Save
as... is covered in the following section.
Solution Combinations
You can create solutions that are calculated from other solutions. These are derived from the addition of results
coming from one or more environments, each of which can include a multiplication coefficient that you supply.
The calculated values cannot be parameterized.
To Create a Solution Combination Object You can insert one or more Solution Combination objects under
the Model object. Under the Solution Combination object, you can add the following results types:
• Stress Tool
• Fatigue Tool
• Contact Tool (for the following contact results: Frictional Stress, Penetration, Pressure, and Sliding Distance)
• Beam Tool
• Stresses
• Elastic Strains
• Deformations
Each solution object contains its own configuration spreadsheet, available through the Worksheet View.
When setting up a Solution Combination, you select the Environment Objects you wish to add together from
a drop-down list of all available environments. Enter the multiplication coefficient you wish for each environment.
The results values shown for these objects are derived from the same results objects in the referenced environ-
ments, including any defined multiplication coefficients. The basic formula for calculating the results is:
Note — At least one Environment must be checked in the Solution Combination Worksheet.
Commands Objects
If you are familiar with using ANSYS commands or APDL programming, you can input commands directly in
Simulation using a Commands object. You can insert single or multiple Commands objects under any of the
following items using a right mouse button click and choosing Insert> Commands from the context menu.
Upon inserting a Commands object, the Worksheet tab appears and displays information or special instructions
tailored to the specific parent object. For example, the following information appears if you insert a Commands
object under a Contact Region object:
*********contact region default statement*********
! Commands inserted into this file will be executed just after the contact region definition.
! The type number for the contact type is equal to the parameter "cid".
! The type number for the target type is equal to the parameter "tid".
! The real and mat number for the asymmetric contact pair is equal to the parameter "cid".
! The real and mat number for the symmetric contact pair(if it exists) is equal to the parameter "tid".
Input arguments are available on all Commands objects. There are nine arguments that you can pass to ANSYS
APDL macros. Numerical values only are supported. Input Arguments are editable on the Details View of a
Commands object under Input Arguments and listed as ARG1 through ARG9. If you enter a numerical value,
including zero, for an argument, that value is passed along to ANSYS. If you leave the argument value field empty,
no argument value is passed for that specific argument.
Note — If you are calling a user defined macro from within a Commands object, be aware of the macro's
location on the disk to make sure the macro is able to be located during the solution. Refer to the
/PSEARCH command description located in the ANSYS Commands Reference within the ANSYS Help for
more information.
For sequenced simulations, the Sequence Selection Mode control is also available in the Details View of a
Commands object when you insert the object under an Environment or Solution object. This control allows
you to specify which sequence steps are to process the Commands object. The choices are: First, Last, All, and
By Number. If you choose By Number, a Sequence Number control appears that allows you to scroll through
and select a specific numbered step that will process the Commands object.
Warning:
• Commands text cannot contain characters outside of the standard US ASCII character
set due to the fact that this text will propagate into ANSYS input files and must follow
the rules set aside for ANSYS APDL commands and input files. Use of languages
other than English for the command text may cause erratic behavior. ANSYS com-
mands should not be translated.
• Make sure that you use consistent units throughout a simulation. Commands objects
whose inputs are units-dependent will not update if you change unit systems for
solving.
Commands object input for electromagnetic simulations must be in MKS units (m,
Kg, N, C, V, A).
The following controls are also available with Commands objects. Each control is available from the toolbar or
from the context menu that appears from a right mouse button click on a Commands object:
• Export...: Exports the text in the Worksheet tab to an ASCII text file.
Note — You must right-mouse click on the selected object in the tree to use this Export feature.
On Windows platforms, if you have the Microsoft Office 2002 (or later) installed, you may see an
Export to Excel option if you right-mouse click in the Worksheet tab. This is not the Simulation
Export feature but rather an option generated by Microsoft Internet Explorer.
• Import...: Imports the text from an ASCII text file to the Worksheet tab.
You can rename the Commands object to the name of an imported or exported file by choosing Rename
Based on Definition from the context menu available through a right mouse button click. The Commands
object is renamed to the name appearing in the File Name field under the Details View.
• Refresh: Synchronizes the text in the Worksheet tab to that of the currently used ascii text file. Refresh
can be used to discard changes made to commands text and revert to a previously imported or exported
version.
• Suppress (available in context menu only): Suppressed commands will not propagate to the ANSYS input
file.
• Search Parameters (available only at the Solution level): Scans the text output and updates the list of
detected parameters. Matched ANSYS parameters can be parameterized just as other values in Workbench
can be parameterized. Refer to the next section for details.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Presented below is an example of a Commands object used to create two plots, one for unaveraged stress, and
one for element error.
! Commands inserted into this file will be executed immediately after the Ansys /POST1 command.
! If a SET command is issued, results from that load step will be used as the basis of all
! result objects appearing in the Solution folder.
/show,png ! output to png format
One example where a possible conflict between ANSYS and Workbench can occur is when Commands objects
are used to define material models. The user may have defined only linear elastic properties in Engineering Data.
However, it is possible to use ANSYS commands in a Commands object to override the material properties
defined in Engineering Data or even change the linear elastic material model to a nonlinear material model, such
as adding a bilinear kinematic hardening (BKIN) model. In that case, the solution will use the BKIN model defined
in the Commands object. However, since Simulation is unaware of the nonlinear material specified by the
Commands object, nonlinear solution quantities such as plastic strain will not be available for postprocessing.
Another example where a possible conflict between ANSYS and Workbench can occur is when Commands objects
are used to define boundary conditions. ANSYS nodal boundary conditions are applied in the nodal coordinate
system. For consistency, Workbench sometimes must internally rotate nodes. The boundary conditions specified
by the commands in the Commands object will be applied in the rotated nodal coordinate system.
Other situations can occur where ANSYS commands issued in Commands objects are inconsistent with Workbench.
It is the user’s responsibility to confirm that any ANSYS commands issued in a Commands object do not conflict
with Workbench.
View Results
You can select results in the Section : Tree Outline under Solution to display contours in the Section : Geometry.
You can also use the Result Context Toolbar to modify your view of the result.
If you click View Results on the Section : Simulation Wizard, you are directed to the area on the Section : Tree
Outline where you can view the results.
Legend
Section : Graphics
Graphics
• Result Toolbar
• Animation
Exporting Data
You can export tabular data (any information about a model or results, except for 3D graphs) from the geometry
and worksheet document tabs to an Excel spreadsheet file (.xls). The data will appear in Excel if it's currently
running, or will be written to an Excel file for later processing. You can export contour results objects through
the context menu. From the worksheet tab you can export data from the following:
Geometry folder
Contact folder
Frequency folder
Buckling folder
Harmonics folder
Environment folder
Other exportable data includes:
fatigue sensitivities
any contour result
Steps to export
1. Select an object in the tree.
2. Click the Worksheet tab to give it focus.
3. Right-mouse click the selected object in the tree to produce the menu, then select Export.
4. Specify a filename for the Excel file.
Note — You must right-mouse click on the selected object in the tree to use this Export feature.
On Windows platforms, if you have the Microsoft Office 2002 (or later) installed, you may see an
Export to Excel option if you right-mouse click in the Worksheet tab. This is not the Simulation
Export feature but rather an option generated by Microsoft Internet Explorer.
Options Settings
The Export Simulation settings in the Options dialog box allows you to:
Reporting
Section : Introduction
Section : Report Preview
Section : Outline by Tree
Section : Inserting Figures
Section : Publishing
Section : Customizing Your Reports
Section : Troubleshooting Reports
Introduction
The application provides powerful engineering tools that help you to develop concepts into well-understood
designs, refine existing designs, and test designs under a variety of real-world conditions. The importance of this
information is twofold:
In virtually all cases, you need to prepare materials to back up your design decisions and to document your
design information. The Report function does the work of producing complete engineering documentation, in-
cluding natural language discussions, tables, and color pictures, automatically, based on your work. This feature
draws on the latest Internet and expert system technologies to deliver easily understood, ready-to-use materials
in standard formats.
Report Preview
When you click on the Report Preview tab, and after clicking on the Generate Report button in the report setup
page, a report displayed in a “table” view appears on the right side of the window. When first displayed (and
following any selection in the Outline), the report scrolls to and selects the corresponding section in the Section :
Tree Outline.
Outline by Tree
Report documents the design and analysis information you created and maintained. It is divided into sections
that correspond to objects in the Section : Tree Outline. Each scenario in the report represents one complete
engineering simulation. The definition of a simulation includes known factors about a design such as material
properties per part, contact behavior between parts (in an assembly), and types and magnitudes of loading
conditions. The results of a simulation provide insight into how the parts may perform and how the design might
be improved. Multiple scenarios allow comparison of results given different loading conditions, materials, or
geometric configurations.
Report is organized according to the Section : Tree Outline. Sections are numbered based on what section of
the Section : Tree Outline they report on. For example, Model is Section 3.1, Environment is Section 3.2, Solution
is Section 3.3 and so on. Loading and Supports, which fall under the Environment heading in the Section : Tree
Outline, are Sections 3.2.1 and 3.2.2.
The report scrolls to the location corresponding to the selected object in the outline. The report provides a table
view of information, similar to Object View in Simulation.
Inserting Figures
Each solution in Simulation may have multiple images. You may want to save a particular view of your model to
insert into your report. These are called Section : Figures. The current model orientation is saved when you insert
a figure. You can rename each figure to enhance meaning. Slice Plane views can also be saved as figures.
Publishing
To post your report on a web page or save it for later use, click the Publish button on the Report Preview Context
Toolbar. Choose a location to save the report. All required files that need to be saved can be placed in the same
directory, or in a new directory with the same name as the html file. Just click the save images in separate folder
box on or off. Separate folders will be easier to manage, but difficult to e-mail since the directory structure may
not be preserved.
Report can be saved inside MS Word or E-mailed using MS Outlook by using the Send To command. This option
will save images to the same folder as the html file. The Send To> PowerPoint command will only save the images
as slides. It is meant to be used in conjunction with a printed report.
In addition to using the report setup page, you can further customize your report as follows:
• Customize table characteristics and the maximum number of digits using the Simulation Report settings
in the Options dialog box.
Note — Any changes that you make to the Simulation Report settings in the Options dialog box
can be tested by selecting the Refresh icon on the Report Preview Context Toolbar.
• Customize section titles on the Section : Tree Outline. Right-click on the name and select Rename. In the
following example, the headings have been renamed.
Language files are installed in the DesignSpace\DSPages\language folder. You may see one or more language
files, depending on the locale you selected during installation.
To create a new Report edition, first find the language folder for your active language. For example, if you are
running the US-English version, your language folder is en-us.
Open the DSStringTable.xml file in the Pages\XML folder under your active language. Add a line near the end
of the file to identify your Report edition name and folder. For example, if your edition is named “Corporate
Standard” and will be stored in the Custom-1 folder, your entry would look like this:
<string id="ID_Custom-1">Corporate Standard</string>
Important
• </stringtable> must be the last line in this file. You must add your new line before
</stringtable>.
• Remember to add “ID_” to the front of your folder name in order to define the string identifier.
Copy your active language folder to the new name specified in the previous step. This new folder must also be
located under the DesignSpace\DSPages\language folder.
The next time you start Simulation and select the Report Preview tab, your custom report should be displayed
in the Language selection box.
You may now edit the files in the Pages\Report folder under your edition folder name to create a custom Report
edition.
Troubleshooting Reports
Some common errors that can occur—
Meshing Overview
All meshes are fully automatic. Mesh controls are available to assist you in fine tuning the mesh to your analysis.
To automatically mesh your body, simply proceed through your simulation. The body is meshed at solve time.
The element size is determined based on the size of the body box (the smallest box that the body will fit in), the
proximity of other topologies, body curvature, and the complexity of the feature. If necessary, the fineness of
the mesh is adjusted up to four times (eight times for an assembly) to achieve a successful mesh.
You can also use the Mesh Preview feature before solving to see the mesh created. To do this, select Mesh from
the Section : Tree Outline and right-click your mouse. From the right-click menu, choose Preview Mesh.
If you want more control over the mesh, you can do so using the Sizing controls. These controls can be accessed
using the main menu. With the Mesh object highlighted, select Insert> Model Item and choose Mesh Control>
Sizing. You can also use a right mouse click when Mesh is highlighted in the Section : Tree Outline, or in the
Mesh Control context toolbar.
Relevance
Section : Mesh Control Tools
Section : Other Meshing Tools
Section : Mesh Sweeping
• Basic Control
– Relevance: Allows you to control the fineness of the mesh for the entire model.
To indicate a preference toward high speed (-100) or high accuracy (+100) solutions, use the slider
located in the Section : Details View next to the Header, Relevance. To see the slider, click the Relevance
value. This number is used in the report to document the relevance setting. The finer the mesh, the
more accurate the result. A coarse mesh is less accurate. Keep in mind, however, a finer mesh uses
more elements, more time, and ultimately, more system resources.
• Advanced Controls
– Element Size: Allows you to specify the element size used for the entire model. This size will be used
for all edge, face, and volume meshing.
– Curv/Proximity: Allows you to adjust parameters that determine how closely the mesh follows the
model and how many elements are generated based on the curvature of the model. This setting works
in conjunction with the Element Size control to determine the number of element divisions.
By default, the application will determine the element size for you. If given, the application will initially
mesh the edges of the model with this size, and then refine the edges based on curvature and prox-
imity. The Curv/Proximity slider gives you control over how much the application should refine the
edges based on curvature and proximity. Curvature is how curved an edge is along with how much
surface curvature there is on the surfaces attached to an edge. Proximity is how close the edges in a
body are to each other. Proximity is only affected for swept models and models with proximity controls
attached.
Note — If Element Size is the default, the curvature and proximity behave the same as Relev-
ance.
– Shape Checking: You can choose either the Standard setting (default) or the Aggressive setting.
The Standard setting uses the current Simulation shape checking criterion. This criterion has proven
to be effective for linear, modal, stress and thermal problems. The Aggressive value sets the shape
checking criterion to be much more restrictive. This will usually produce more elements, longer
meshing times, and possibly mesh failures. It is recommended that this option be used if the mesh is
intended for large deformation or material nonlinear analysis inside the ANSYS environment.
– Solid Element Order: Use this feature if lower order elements perform well in the simulation, such as
for field simulations or for highly nonlinear analyses. Lower order elements produce fewer degrees of
freedom.
→ Program Chosen (default) automatically generates lower order elements for 3-D surfaces and
lines, and higher order elements for 2-D and 3-D solids.
→ High forces all solid elements in the mesh to be higher order elements (include midside nodes).
→ Low forces all solid elements in the mesh to be lower order elements (no midside nodes).
The Solid Element Order control is grayed-out when only surfaces, lines, or a combination of surfaces
and line bodies are present in the model.
Note — Modifying a Solid Element Order control setting will always force a complete remesh.
– Straight Sided Elements (displayed only when the model includes an enclosure from DesignModeler):
specifies meshing to straight edge elements when set to Yes. You must set this option to Yes for
Electromagnetic simulations.
– Initial Size Seed: Allows you to control the initial seeding of the mesh size for each part.
→ Active Assembly (default) bases the initial seeding on the diagonal of the bounding box that en-
closes only parts that are unsuppressed (“active” parts). With this choice, the mesh could change
as you suppress and unsuppress parts because the bounding box grows and shrinks.
→ Full Assembly bases the initial seeding on the diagonal of the bounding box that encloses all as-
sembly parts regardless of the number of suppressed parts. As a result, the mesh never changes
due to part suppression.
→ Part bases the initial seeding on the diagonal of the bounding box that encloses each particular
individual part as it is meshed. The mesh never changes due to part suppression. This option typ-
ically leads to a finer mesh and is recommended for situations where the fineness of an individual
part mesh is important relative to the overall size of the part in the assembly.
• The latest mesh control tool that you add on a particular geometry overrides any prior mesh
control tools that you already have added on that geometry. For example, if you apply a Sizing
control setting of 0.5 to faces A,B,C then apply a setting of 1.0 to face B, faces A & C will retain the
0.5 setting, but the setting for face B will be 1.0.
• If you suppress a mesh control tool, the Suppress Body symbol appears ("x" adjacent to the name
of the tool) and Suppressed is set to Yes in the Details View of the tool. If you do not suppress a
mesh control tool, but the tool is either invalid or scoped to an object that is itself suppressed,
the Suppress Body symbol appears adjacent to the tool but Suppressed is set to No in the Details
View of the tool. Examples of the latter case are a tool applied to a uniform sheet mesh (not sup-
ported), a tool scoped to suppressed geometry, or a Contact Sizing tool scoped to a suppressed
Contact Region.
Method Control
The Method control is valid only for a body. The default value selects element shapes that provide a successful
automated mesh. By default, the application attempts to use auto sweeping for solid models and quadrilateral
element generation for surface models.
To set the values of shape control, click Mesh on the Section : Tree Outline, and right-click to view the menu.
Select Insert> Method. You can also click Mesh on the Section : Tree Outline, and select the Mesh Control
button on the Section : Context Toolbar. Select Method.
In the Section : Details View, you can set Method to the following:
• Auto Sweep if Possible (default), where the body will be swept or map-meshed, if possible.
• All Tetrahedrons, where an all tetrahedral mesh is created.
• Hex Dominant, where a free hex dominant mesh is created. If you are interested in a hex mesh, this option
is recommended for bodies that cannot be sweep meshed. To preview any bodies that can be sweep
meshed, click Mesh on the Section : Tree Outline and right-click the mouse. Select Preview Sweep to
display bodies that fulfill the requirements of a sweepable volume.
Hex dominant meshing adds the most value under the following conditions:
– Meshing bodies that transition from sweepable bodies in a body that has been decomposed for
sweeping.
Hex dominant meshing adds little value under the following conditions:
– Meshing thin complicated bodies (like a cellular phone case). The number of elements may actually
increase compared to a tetrahedron mesh since the element size must be much smaller for this class
of body when using hex dominant meshing to create well shaped hexes.
– A body is sweepable or can easily be decomposed to multiple sweepable bodies. The quality of a
swept mesh is usually superior to that of a hex dominant mesh.
Mesh Matching for cyclic symmetry is not supported for hex dominant meshing.
Simulation assists you in determining if hex dominant meshing is applicable to your situation. When you
apply the Hex Dominant option on a body or group of bodies, Simulation calculates the normalized
volume to surface area ratio. If it detects a ratio less than 2, Control Message appears in a highlighted
row under Definition in the Details View. If you click Yes, Click To Display, a warning message states
that a low percentage of hex elements or poorly shaped hex elements may result. Suggestions are included
for alternative meshing schemes.
The normalized volume to surface area ratio is defined by the following expression:
where factor, the ratio for a unit sphere = (4/3 π)/(4 π)3/2
– Defeaturing Tolerance - Any edge that is less than or equal to this value may be meshed over by the
mesher in a patch independent manner. A recommended setting is at least one-half the value set for
Element Size to assure a successful mesh.
– Element Size - Allows you to specify the element size used for the selected geometry.
– Fill Small Holes - By default, holes in surface bodies are not removed regardless of the Defeaturing
Tolerance setting. When Fill Small Holes is set to Yes, the mesher removes holes smaller than the
Defeaturing Tolerance setting. The mesh simply paves over the small holes.
– Quad Dominant on Failure - Setting to Yes is equivalent to the Quadrilateral Dominant setting
that includes the Element Size setting in the Method control. The Quadrilateral Dominant mesher
will be invoked on a part by part basis when the Uniform Quad/Tri mesher cannot successfully mesh
a part with the prescribed inputs.
– Control Messages - (appears only when Method controls are applied to uniform sheets) Displays an
error message when the Method control is applied to a part that contains virtual topology.
• Uniform Quad, where a uniform mesh of all quads is created over the entire part of the selected body,
depending on values that you enter for the same input fields mentioned above for the Uniform Quad/Tri
option.
In some cases, the Uniform Quad option will create some triangular meshes. If this occurs, it will be reported
in a mesh feedback message, accessible by choosing the View Mesher Feedback button.
Note — Be aware of the following regarding the Uniform Quad/Tri and Uniform Quad controls:
→ The Method mesh control tool is displayed as underdefined and an error message is dis-
played if you try to re-mesh.
→ If you try to copy or clone the Method mesh control tool to other geometries, the new
tool is forced to Quadrilateral Dominant.
– These controls are sensitive to the scoping of all other objects in Simulation. If you add a load,
support, or result to a group of surfaces, the part with either of these controls will need to be
remeshed. If you change the scoping of the load, the part will need to be remeshed. It is re-
commended that you apply loads to the model before meshing when using either of these
controls. These controls differ from the other mesh control tools in Simulation. The remaining
mesh control tools are invariant to loading and mesh every selected surface. Every surface is
not meshed when using either of these controls.
– The meshers associated with these controls will not retain the topology of named selections
with a name containing the string "problematic geometry" (localized string) regardless of case
of the string.
– Using either of these controls may allow meshing over very small bodies in a multi body part.
This may lead to a solver error if a body load is associated with that body. If this is the case,
you must suppress the body before solving your model.
– Once a uniform sheet mesh is created, deleting boundary conditions will not cause the mesh
to become obsolete.
Caution: Multiple environments with different loadings may over-constrain the Uniform Quad/Tri
and Uniform Quad meshers such that the mesher may not be able to return a mesh for the given
inputs. If discretization error is not an issue, the mesher will be less constrained if you duplicate
the model and change the environment instead of adding multiple environments under the same
model.
Sizing Control
The sizing control sets:
To Access Sizing
or
• If you selected a body or a face, the following options are available in the Type field:
– Element Size (default) allows you to enter a value directly in the Element Size field. Enter a
positive value (decimals are allowed) in this field. Smaller values generate more divisions. A value
of “0” instructs the control to use its defaults. The following series of figures shows the effect of
the sizing control applied to a face.
– Sphere of Influence allows you to apply mesh sizing within the confines of a sphere in space
that you define as follows:
a. Create a local coordinate system whose origin you intend to be the center of the sphere.
b. Select this coordinate system in the Sphere Center field.
c. Enter the radius of the sphere in the Sphere Radius field.
d. Enter a value in the Element Size field. The element size will be applied to all topologies
within the confines of the sphere. For example, if you are applying the element size to a face,
the size will also be applied to the edges of that face, and to the vertices of those edges, but
only within the confines of the sphere. An example is shown below.
• If you selected an edge, the options available in the Type field are Element Size and Sphere of Influ-
ence (as described above for when you select a body or a face), along with the Number of Divisions
option. Choosing Number of Divisions and entering a value in the Number of Divisions field is an
alternative to choosing Element Size if you are interested in having the mesh be sized according to
a discrete number of divisions along an edge.
• If you selected a vertex, the only option available in the Type field is Sphere of Influence. The de-
scription is the same as presented above for when you select a body or a face except that the center
of the sphere is the vertex. There is no need to create or use a local coordinate system to define the
center of the sphere. After applying element size to a vertex using Sphere of Influence, the element
size is applied to all topologies connected to that vertex, such as all edges and faces containing that
vertex, if they fall within the sphere. An example is shown below.
4. Specify a hard division option in the Edge Behavior field. For bodies or faces, the Edge Behavior option
allows you to either accept (default) or ignore the Curv/Proximity global meshing setting. For edges,
the size or number of divisions is fixed on the edge and cannot be changed by the meshing algorithm .
When Edge Behavior is set to No Curv/Proximity Refinement (“hard”), the likelihood of a mesh failure
increases. When Curv/Proximity is ignored on a face/body, curvature pre-refinement is not performed
on the edges of the face/body, but the edge can be split by the mesher. The hard division option is not
available for Sphere of Influence. It is also not applicable for vertices.
• Visual aids are available to assist you. When you pick an edge, the edge length is displayed. A circle is
displayed adjacent to the cursor whose diameter indicates the current setting in the Element Size field.
The scale ruler is displayed below the graphic and provides a good estimate of the scale of the model.
• When Applying Sizes to Edges: If possible, the meshing algorithm places the requested number of divi-
sions on the specified edge. Otherwise, the algorithm adjusts the number to allow a successful mesh
generation.
• When Sweeping: Consider the following when applying size controls to source and target geometry:
– If your sizing controls are scoped to either the source or target face, the mesher will transfer the size
control to the opposite face. If you have a size control on both faces, the size on one of the faces will
be used. That face is automatically determined by the software. However the size on the edges of the
target face will not be affected if no sizes are explicitly defined on these edges.
– If you have a sphere of influence on a possible source or target face, the face with the most spheres
will be chosen as the source face. The edge mesh of the source face affected by the sphere of influence
will not affect the target face. This may prevent the model from sweeping with acceptable element
quality. To avoid this, place the sphere of influence on the edges of both the source and target face.
– Applying sizes, regardless of type (that is, size, number of divisions, sphere of influence), to the edges
of possible source and target faces will only affect the faces that use these edges.
If you want to control a side area, the problem must be properly constrained such that the interval assign-
ment does not override your size control. The divisions on the edge may decrease in order to make the
volume sweepable. When using a meshing process other than swept meshing, the divisions can only in-
crease. When applying a size to a part that is sweepable, the resulting mesh may have fewer divisions on
the edge than specified due to the interval assignment logic of the sweepers.
• Using the Sphere of Influence sizing control may not have any effect on the generated mesh if the control
is scoped to the Body of a Line Body.
• Elements falling within 3 overlapping spheres of influence will be created with an averaged size. Within
4 or more spheres, the size is calculated by a radius-dependent least-squares fit of all the spheres.
• Regardless of value for the sizing control you set, other factors such as edge and face curvature and the
proximity of small features may override the effect of the sizing control.
• If several sizing controls are attached to the same edge, face, or body, the last control is applied. If a sizing
control is placed on an edge and then another is placed on a face or body that contains that edge, the
edge sizing takes precedence over the face or part sizing.
• If you have adjusted the element size, then changed length units in a CATIA, ACIS, or Autodesk Mechan-
ical Desktop model, when you choose Update or Clean at a Model or Project node in the tree outline,
you may need to re-adjust the element size. The sizing control does not automatically re-adjust to match
this situation.
Contact Sizing
Contact Sizing creates elements of relatively the same size on bodies from the surfaces of a face to face or face
to edge contact region. This control generates spheres of influence internally with automatic determination of
radius and size (if Relevance is selected for Type). You may want to apply a method control on sweepable
bodies to force the elements to be tetrahedron in the case where the sweeper is not providing enough local
sizing near your contact region. Your swept mesh may be quite dense if the contact size is small on the source
and target faces of the body. You may also see very little effect on swept bodies in the case where a contact size
is applied to a very small region of a large source face. You can apply contact sizing using either of the following
procedures:
• Choose Contact Sizing from the Mesh Control drop down menu, or from the context menu through a
RMB click on a Mesh object (Insert> Contact Sizing). Select a specific contact region under Scope in the
Details View, then under Type, choose Relevance for a relative size (using the slider), or Element Size
(and enter a value) for an absolute size.
• Drag a Contact Region object onto the Mesh object, then in the Details View, under Type, choose Relev-
ance for a relative size (using the slider), or Element Size (and enter a value) for an absolute size.
Refinement Controls
Refinement Controls specify the maximum number of meshing refinements that are applied to the initial mesh.
Refinement controls are valid for faces, edges, and vertices.
To use refinement controls, click Mesh on the Section : Tree Outline, and right-click to view the menu. Select
Insert> Refinement. You can also click Mesh on the Section : Tree Outline, and select the Mesh Control button
on the Section : Context Toolbar. Select Refinement.
In the Section : Details View, specify a Refinement number between 1 and 3, where 1 provides minimal refinement,
and 3 provides maximum refinement. If you attach several controls to the same entity, the last control applied
takes precedence.
Refined elements are always tested against stricter shape metrics than the shape metrics used to create base
elements. As an example, if you create a mesh using the Standard setting of the Shape Checking Control and
then specify a refinement, the refined elements will have to pass an even stricter shape metric than the original
elements. If you create a mesh using the Aggressive setting and then specify a refinement, the refined elements
will have to pass a shape metric that is even more aggressive than the metrics used to create the base mesh with
the Aggressive setting.
Some refinement controls can override or affect other refinements that are on connected topology. A face refine-
ment control overrides a refinement control on any of the face's edges or vertices. An edge refinement control
overrides a refinement control on either of the edge's vertices. Basically, a refinement control will lower the value
of an overridden control by its own value. For example, consider a face with a refinement control of 1 and one
of the face's edges with a refinement control of 2. One of the edge's vertices has a refinement control of 2. In this
example, the face control reduces the value of the edge control by 1. It also reduces the value of the vertex
control by 1. The edge control now has a value of 1, so it reduces the vertex's control by 1. Now the vertex has a
value of zero, so it has no effect.
To set the mapped face meshing controls, highlight Mesh in the Section : Tree Outline, and right-click to view
the menu. Select Insert> Mapped Face Meshing. You can also click Mesh in the Section : Tree Outline, and select
the Mesh Control Section : Context Toolbar, then select Mapped Face Meshing from the drop-down menu.
The blue status icon that may appear in the Section : Tree Outline indicates that a mapped mesh cannot be
provided on the scoped topology. One of three scenarios triggers the icon:
To apply Match Face Mesh, select two faces of interest, then choose Match Face Mesh from the Mesh Control
drop down menu, or from the context menu through a RMB click on a Mesh object (Insert> Match Face Mesh).
You must also select a coordinate system to choose the z-axis of rotation for the copy. A blue status icon appears
in the tree outline if the Match Face Mesh control failed on the face pair.
The Match Face Mesh control is not supported for swept parts and bodies whose Method control is set to Hex
Dominant.
Part Relevance
Part Relevance allows you to control the fineness of the mesh for an individual part. To apply Part Relevance,
select a part or any body in a multi body part, then follow the procedure for using the global Relevance control.
If applied to a body of a multi body part, the relevance will be applied to the entire part.
Part Proximity
Part Proximity performs a pre-refinement on the meshed edges of a part. Swept parts always have proximity
refinement turned on internally. The recommended use of Part Proximity is on thin parts, or parts where features
are very close together and where discretization is very important. Using Part Proximity may create a very large
number of elements, sometimes on the order of five times the number created without using the control.
To apply Part Proximity, select a part or any body within a multi body part, then choose Part Proximity from
the Mesh Control drop down menu, or from the context menu through a RMB click on a Mesh object (Insert>
Part Proximity). You can use the Relevance slider to control the amount of proximity refinement performed.
One of those conditions is tolerance, which controls the extent of contact between parts in an assembly. Tolerance
is set as a percentage of the bounding box of the assembly. The bounding box is the smallest volume that the
assembly will fit in. You can change the tolerance (between -100 and 100) in the Options dialog box under the
Simulation Contact category.
A loose tolerance generally increases the number of contact surfaces and areas of contact between parts, while
a tight tolerance will decrease the number of contact surfaces.
Each face of the part is checked against the faces of other parts in the assembly. A contact pair is generated
between any faces within the tolerance. When solving, the elements for the two faces that make up the pair are
compared. If any of the faces are within the tolerance, contact elements are generated for them.
The tool identifies face/face pairs in a multi body part and creates gap sizing controls for meshing. Within a Gap
Tool object, you can specify settings for sizing on the bodies adjacent to the gap and for refinement of the mesh
in the air gap.
Note — All Gap Tool controls and settings discussed in the following procedure are displayed only when
the model includes an enclosure from DesignModeler.
2. Enter the width of the gap region between bodies (in your working units or as an existing CAD parameter).
This entry represents the range for multiple gaps, or equals a single gap distance that varies about a
certain tolerance. Your mesh density in the air gap is a direct function of the Gap Distance so your gap
size should be quite accurate.1 The applicable settings in the Details View are the following:
• Define By: Choose Range (default) if you will be entering numerical values, or CAD Parameters if
you will be entering parameters to define the values.
• Minimum: The lower end of the range for multiple gaps, or the single gap distance.
• Maximum: (Optional) The upper end of the range for multiple gaps, or the single gap distance toler-
ance.
After you set the gap distance, a crosshair appears adjacent to the cursor in the Geometry window. The
crosshair is surrounded by a circle. The radius of the circle is a graphical indication of the maximum gap
distance. The radius will change if you change this distance. The circle also appropriately adjusts when
the model is zoomed in or out.
3. Click the right mouse button on the Gap Tool object and choose Create Gap Sizes from the context
menu. Simulation searches the model to find all occurrences of face pairs separated by the gap distance
you specified. All face pairs within an absolute distance from the minimum gap distance to the maximum
gap distance will have controls generated. Each occurrence of the gap face pairs is inserted as a Gap
Sizing object under the Gap Tool object. By changing to Wireframe mode (Graphics toolbar) and clicking
through each Gap Sizing object, you can visually inspect the selected gap face pairs for use in mesh re-
finement.
Note — If you open a version 9.0 database file that includes Gap Sizing objects, Gap Tool object(s)
are created automatically. These Gap Tool object(s) are reported in the tree with a yellow lightning
bolt status, meaning that the items are not solved.
4. Right mouse click on Mesh object and choose Preview Mesh from the context menu.
5. Use the following controls to adjust the degree of sizing and mesh refinement, as needed, for the gap
face pairs. These controls appear in the Details View of the Gap Tool object.
• Gap Aspect Ratio: Slider control that adjusts the aspect ratio of elements in the gap between faces.
The ratio represents the length of an element edge parallel to the face pairs, to the width of the ele-
ment perpendicular to the face pairs. A lower ratio (for example, 1:1) will produce significantly more
elements than a higher ratio (for example, 4:1), but will generate better quality elements. A good
compromise is a value of 3:1 (default).
• Gap Density: Controls the number of elements spanning the width of the air gap between the face
pairs. The Coarse option (default) attempts to place at least two elements through the gap width,
the Fine option attempts to place three to four elements through the gap width.
• Generate on Update: Controls whether the Gap Sizing objects are regenerated when the simulation
is updated from the geometry. By default the Gap Sizing objects are regenerated at their default
settings. You may choose to not update a Gap Sizing object by selecting No. The No option will
freeze the Gap Sizing object's face pairs and settings. This option will only work properly if there are
no topology changes for the face pairs during a geometry update. The Generate on Update feature
default setting is most applicable to rotating machines where the gap distance is constant but the
Gap Sizing object face pairs may change due to alignment. For linear devices (actuators), the No
option may be preferred since the gap distance may change during a geometry update, but the face
pairs will likely remain unchanged.
Note — For many applications, a typical Gap Aspect Ratio setting of 3:1 and Gap Density set
to Coarse will produce good results. You may need to adjust the Curv/Proximity setting (under
the Advanced Global Control option) in order to get a mesh. If this does not work, you may
need to adjust the Gap Aspect Ratio or Gap Density settings or apply other size controls to the
model.
The Generate on Update field should be set to No to generate gap sizing controls with multiple
gap distances. Use multiple Gap Tool objects in this situation.
Note — Make sure that your maximum gap size is the actual gap size. A gap size that is
too large will cause a meshing failure or incorrect size distribution.
1 - Algorithmic Notes
The size on the face pairs in regions that lie within the specified gap distance is determined as
follows:
Size = dG*GA
where:
Mesh Sweeping
This method of meshing complements the free mesher that produces tetrahedron elements. If a part's topology
is recognized as sweepable, the part can be meshed very efficiently with hexahedral and wedge elements using
this technique. The number of nodes and elements for a swept part is usually much smaller than ones meshed
with the free mesher. In addition, the time to create these elements is much smaller.
Simulation will automatically check to see if the part fulfills the topological requirements for sweeping. It will
then choose two faces that are topologically on the opposite sides of the part. These faces are called the source
and target faces. Simulation will mesh the source face with quadrilateral and triangular faces and then copy that
mesh onto the target face. It then generates either hexahedral or wedge elements connecting the two faces and
following the exterior topology of the part.
Sweepable Parts
A part cannot be swept if any of these conditions exist:
• There is more than one set of continuously connected faces in the part.
• There is a completely contained internal void in the part.
• No two faces in the body are opposite to one another in the part's topology and have edges connecting
each of the first face's vertices with the second face's vertices (in other words it cannot find a source and
target face).
• If a Sizing control is used on a body with hard edge sizing and the source and target faces contain hard
divisions which are not the same for each respective edge.
When sweeping it is only neccesary to apply hard divisions to one leg of the sweep path. If the path is multiple
edges, you should apply your controls to that path.
If the sweep path is shared by another body and that path lies on the bodies source or target face then more
hard divisions may be needed to constrain the sweeper.
To preview any parts that can be sweep meshed, click Mesh on the Section : Tree Outline and right-click the
mouse. Select Preview Sweep to display parts that fulfill the requirements of a sweepable volume. However,
even if these requirements are met, the shape of the part may at times still result in poorly shaped elements. In
these cases, the tetrahedron mesher is used to mesh the part.
Parameters
Parameters refer to the entire set of possible parameters allowable in Simulation, including CAD parameters and
engineering parameters (pressure magnitude, maximum stress, fatigue life, dimension of a part, material property
type, Young's modulus, and others).
The The Parameter Manager Worksheet collects all specified parameters and lists them in the Parameter Manager's
grids for later use and/or modification.
While engineering parameters are indicated simply by clicking the parameter box in the Section : Details View,
CAD parameters must be given some extra attention, both in the CAD package and in Simulation.
Specifying Parameters
The Section : Details View in the application window provides check boxes for items that may be parameterized.
The Parameter Manager Worksheet design provides an activity center for the enhanced definition of input and
output parameters in a unified location.
The following screen shots illustrate parameter definition for typical objects in Simulation:
Part Object
Force Object
Stress Object
Material Properties
Part Object
The screen shot below shows the details of a part object:
Force Object
The screen shot below shows the details for a Force object:
Other details, such as the Geometry, Define By and Direction cannot be parameterized.
Stress Object
The screen shot below shows the details for a Stress object.
The Maximum is not selected as an output parameter. Maximum will not appear in the The Parameter Manager
Worksheet.
Material Properties
The screen shot below, from the Engineering Data, illustrates parameter definition for material properties:
A P appears next to the definitions you are Parameterizing. Parameterizing a material definition affects all parts
that use the definition.
Parameter Restrictions
If an object has a parameterized field, and that object definition is changed in a way that makes that parameter-
ization non-meaningful, the parameterization will be removed by the program. Some examples include:
• A material in Engineering Data has a parameterized density, and then the user suppresses the material.
• A Force in Simulation has a parameterized magnitude, and then the user switches to a component
definition.
• A result in Simulation is scoped to a surface and has a parameterized maximum value, and then the user
re-scopes the result to a different topology.
Note — If the user suppresses an object, no parameter boxes will be shown for any property on that
object. If the user parameterizes the Suppressed property on an object, no parameter boxes will be
shown for any other property on that object, regardless of whether or not the object is suppressed.
The Parameter Manager worksheet appears in the Worksheet tab, replacing the graphics.
Note — In the Parameter Manager worksheet, angles and angular velocity are always displayed in units
of radians and radians/second respectively, even though they may be displayed in degrees in Simulation.
Note — If an environment includes parameters, and a second environment is formed that is coupled to
the first environment, the second environment will retain the same parameters as the first environment.
For example, if a Thermal Condition load is based on an environment with specific parameters defined
in its Parameter Manager worksheet, then the second structural environment will include the same
parameters defined in its Parameter Manager worksheet.
Parameters in general may be disabled in the Options dialog box. The Parameter Manager can be hidden or
disabled. The P boxes still appear even if the parameter Manager is disabled.
Scenario Grids
The Scenarios Table
Creating Scenarios
Editing Parameter Values
Solving Scenarios
Exporting the Scenario Table
The Scenarios section contains a table used to edit and control multiple solutions with different input parameter
values.
• Parameters are represented as columns arranged left to right in the same order as the Definitions tables:
Input Parameters first, Output Parameters, second. Columns are added or removed automatically.
• The left-most column simply numbers the rows. The numbers help to identify rows, especially if the table
spans multiple pages when printed.
• Rows are sorted (ascending or descending) by selecting one column. Clicking a column header toggles
the sort criterion. When sorting, ascending order is always used with the first column click regardless of
whether the selected column was previously sorted in ascending order. Columns containing numbers
and strings (column header plus row values) are not able to be sorted.
• Highlighting (to show focus) is by row; selecting multiple cells is not allowed.
• A row in bold indicates that the input and output parameter values match the current values in the outline.
• A Comment column (to the right of all parameters) contains any text comments entered to describe a
row.
Creating Scenarios
To create a scenario, click on the special area below the last row, as shown. This creates a new row at that location.
Parameter values for the new scenario are copied from the current values in the Outline.
You may delete any scenario by pressing the [Delete] key on the keyboard.
Solving Scenarios
Each scenario is solved independently when you choose Solve (typically from the button in the Main toolbar).
The branch containing the Parameter Manager is also solved. You may exclude a scenario from the solution by
removing the check from its second column. This essentially locks the output parameters in the scenario.
Only the information displayed in the Parameter Manager is preserved from the solution of the scenarios. To
view contours or other information, the user must solve a branch that uses the parameter values from a particular
scenario.
Note — When you choose Solve, precedence is given to scenario values that are checked over corres-
ponding values listed in the Details View. For example, if you change a parameter value in the Details
View that has a corresponding value in a checked scenario, that change is ignored and the scenario value
is “pushed back” to become the value listed in the Details View.
What Ifs
By specifying different input and output parameters and by creating different scenarios using the The Scenarios
Table, you can perform “What If” analyses.
• The default name for a parameter is the same as the Refers To name. You may arbitrarily rename para-
meters by typing in the table.
• The column Refers To shows the original name of the parameter.
• The column Current Value lists the value for each parameter as taken from the corresponding object.
The values in this column are read-only. The current value of a parameter may not necessarily match its
value in any of the scenarios below.
• The rows are sorted top-to-bottom by the order in which they appear in the Outline. This sort option
cannot be changed.
• Rows are added or removed automatically as detail items are checked or unchecked. The user cannot
delete rows to uncheck a detail item.
Failures
Handling Solution Errors in the Parameter Manager
A scenario may fail to solve for a number of reasons, including:
It is possible for more than one scenario to fail within a given solution, for different reasons.
The following screen shot of the bottom of a Parameter Manager worksheet shows one scenario that failed the
solution process:
CAD Parameters
CAD parameters are a subset of the application parameters. As the name implies, CAD parameters come from a
CAD system and are used to define the geometry in the CAD system. If identified correctly in the CAD program,
these parameters can then be managed in the application using The Parameter Manager Worksheet. Although
each CAD system assigns its parameters differently, Simulation identifies them via a key (ds or DS. This identifier
can appear either at the beginning or the end of the parameter name and does not need to be separated from
the name with an underscore or any other character. By identifying the parameters of interest you can effectively
filter CAD parameter exposure. Any of the following examples are valid CAD parameter names using DS or ds as
the key:
• DSlength
• widthds
• dsradius
DS is the default key for importing CAD parameters into the application. You can change this default via the
Personal Parameter Key option on the Geometry Preferences.
Note — If you change the key phrase to nothing all parameters are exposed.
CAD parameters must be assigned correctly in the CAD system in order to be imported. Refer to your CAD system
instructions for detailed information on assigning these parameters. Some system specific notes are included
here for your convenience. Remember that these are all actions that must be performed in the CAD system before
importing the model.
Autodesk Inventor
After a part is open in Inventor, click Tools> Parameters. In the Parameters dialog box, click a parameter name
under the Parameter Name column, modify the parameter name to include ds at either the beginning or end
of the name and click [Enter]. Click Done to close the Parameters dialog box.
Pro/ENGINEER
In Pro/Engineer, modify the parameter name by selecting Modify> DimCosmetics> Symbol and then select
the model. If the model shows numeric values, then select Info> SwitchDims so that the names are text based
instead of numeric. Click on the dimension cosmetic and enter ds or DS at the beginning or end of the string to
expose that dimension for optimizing. You must click on all of the Done buttons in Pro/Engineer before trying
to import the model.
Solid Edge
After a model is opened in Solid Edge, click Tools> Variables... If the dimensions (type Dim) are not shown in
the Variable Table dialog box, click the Filter button for the Filter dialog box. Highlight both Dimensions and
User Variables under the Type column; select Both under the Named By column and select File under the
Graphics in column. Then click OK. Click the name of a dimension (under the Name column), modify the dimen-
sion name to include ds at either the beginning or end of the name and click Enter. Close the Variable Table
dialog box.
SolidWorks
In SolidWorks, open the part and then click on the part or on the feature in the tree. Then right-click the dimension
on the model, open the Properties dialog box, and edit the name of the dimension.
Unigraphics
After a model is opened in Unigraphics, click Application> Modeling... and the Tools> Expression... In the
Edit Expressions dialog box, select the expression with the variable name that you want to rename and click
Rename. Change the expression name in the Rename Variable dialog box to include ds at either the beginning
or end of the name and click OK. Click OK/Apply to close the Edit Expressions dialog box.
Fatigue Overview
Fatigue provides life, damage, and factor of safety information and uses a stress-life or strain-life approach, with
several options for handling mean stress and specifying loading conditions. Common uses for the strain-life ap-
proach are in notched areas where, although the nominal response is elastic, the local response may become
plastic. The three components to a fatigue analysis are:
For detailed information on how these components are handled, go to the ANSYS web site.
For the strain-life approach, the materials must have strain-life parameters defined.
• To define strain-life material properties, click Data to transfer to Engineering Data, then choose Add/Re-
move Properties and make sure that Strain-Life Parameters is checked.
• To define the values for the strain-life material properties, click on the graph icon for Strain-Life Parameters
and make sure values are entered for the following four strain-life parameter properties and the two
cyclic stress-strain parameters:
– Strength Coefficient
– Strength Exponent
– Ductility Coefficient
– Ductility Exponent
– Cyclic Strength Coefficient
– Cyclic Strain Hardening Exponent
Note that in Engineering Data, under Property Attributes, in the Display Curve Type drop down menu, you
can plot either a Strain-Life or Cyclic Stress-Strain curve.
To select the fatigue analysis and loading options, you must select a Solution object. Click Fatigue Tool either
on the toolbar or via a right-mouse click. In the Section : Details View for the Fatigue Tool, you may specify the
following options:
Loading Type
Choose from the following:
• Zero-Based (r=0)
• Fully Reversed (r=-1)
• Ratio
• History Data (available only for stress-life applications)
• Non-proportional Loading (available only for stress-life applications)
The first three are all constant amplitude, proportional loading types and are illustrated with a graph in the
Geometry window.
The fourth type, history data, allows you to navigate to a file containing the data points. This option is a non -
constant amplitude proportional loading type. This data will also be depicted in a graph in the Geometry window.
The fifth option is a non-proportional constant amplitude loading type for models that alternate between two
completely different stress states (for example, between bending and torsional loading). Problems such as an
alternating stress imposed on a static stress can be modeled with this feature. Non-proportional loading is ap-
plicable on fatigue tools under Solution Combination where exactly two environments are selected.
Scale Factor
This setting scales the load magnitude. For example, if you set this to 3, the maximum amplitude of a zero-based
curve will be 1.5 times the stress in the body. The graph in the Geometry window will update to reflect this setting.
This option is useful to see the effects of different finite element loading magnitudes without having to run the
complete structural analysis repeatedly.
Analysis Type
Choose either Stress Life or Strain Life.
• If Analysis Type is set to Stress Life, choose from None, Goodman, Soderberg, Gerber, and Mean Stress
Curves. The Goodman, Soderberg, and Gerber options use static material properties along with S-N
data to account for any mean stress while Mean Stress Curves use experimental fatigue data to account
for mean stress. The default mean stress theory can be defined through the Simulation Fatigue settings
in the Options dialog box.
• If Analysis Type is set to Strain Life, choose from None, Morrow, and SWT (Smith-Watson-Topper).
Note — A sample plot of each of these theories is shown at the bottom of the Worksheet view. This plot
does not use live data, but is rather a generic representation of each theory. For more information on
these theories, see "Metal Fatigue In Engineering" by Ralph I. Stephens, et. al.
Stress Component
Because stresses are multiaxial but experimental fatigue data is usually uniaxial, the stress must be converted
from a multiaxial stress state to a uniaxial one. You can choose from several types, including component stresses,
von Mises, and a signed von Mises, which takes the sign of the absolute maximum principal stress. The signed
von Mises is useful for accounting for any compressive mean stresses.
Bin Size
This setting defines how many divisions the cycle counting history should be organized into for the history data
loading type. Strictly speaking, this is number specifies the dimensions of the rainflow matrix. A larger bin size
has greater precision but will take longer to solve and use more memory.
usually very good if a proper number of bins are used when counting. To see the effects of using quick counting,
compare the results of constant amplitude loading to simulated constant amplitude loading from a load history
file. With quick counting off, the result should match exactly but with quick counting on, there will be some error
depending on the bin size and alternating stress value in relation to the midpoint of the bin the count is sorted
into.
Infinite Life
This option defines what life will be used if the stress amplitude is lower than the lowest stress on the SN curve.
This option is only applicable for non-constant amplitude loading and may be important in how damaging small
stress amplitudes from the rainflow matrix are.
Since the strain-life method is equation based it has no built-in limit, unlike stress-life for which the Fatigue Tool
uses a maximum life equal to the last point on the SN curve. Thus to avoid skewed contour plots showing very
high lives, you can specify Infinite Life in a strain-life analysis. For example, if you set a value of 1e9 cycles as the
Infinite Life, the maximum life reported is 1e9.
• Life
• Damage
• Safety Factor
• Biaxiality Indication
• Equivalent Alternating Stress
• Rainflow Matrix (history data only)
• Damage Matrix (history data only)
• Fatigue Sensitivity
• Hysteresis
Life
This result contour plot shows the available life for the given fatigue analysis. If loading is of constant amplitude,
this represents the number of cycles until the part will fail due to fatigue. If loading is non-constant, this represents
the number of loading blocks until failure. Thus if the given load history represents one month of loading and
the life was found to be 120, the expected model life would be 120 months.
In a constant amplitude analysis, if the alternating stress is lower than the lowest alternating stress defined in
the S-N curve, the life at that point will be used.
Damage
Fatigue damage is defined as the design life divided by the available life. The default design life may be set
through the Options dialog box. A damage of greater than 1 indicates the part will fail from fatigue before the
design life is reached.
Safety Factor
This result is a contour plot of the factor of safety (FS) with respect to a fatigue failure at a given design life. The
maximum FS reported is 15.
Biaxiality Indication
This result is a stress biaxiality contour plot over the model that gives a qualitative measure of the stress state
throughout the body. A biaxiality of 0 corresponds to uniaxial stress, a value of -1 corresponds to pure shear,
and a value of 1 corresponds to a pure biaxial state.
For Non-proportional loading, you can choose between average biaxiality and standard deviation of biaxiality
in the Details View.
The Navigational Control at the bottom right-hand corner of the graph can be used to zoom and pan the graph.
You can use the double-sided arrow at any corner of the control to zoom in or out. When you place the mouse
in the center of the Navigational Control, you can drag the four-sided arrow to move the chart points within the
chart.
The Navigational Control at the bottom right hand corner of the graph can be used to zoom and pan the graph.
You can use the double-sided arrow at any corner of the control to zoom in or out. When you place the mouse
in the center of the Navigational Control, you can drag the four-sided arrow to move the chart points within the
chart.
Fatigue Sensitivity
This plot shows how the fatigue results change as a function of the loading at the critical location on the scoped
region. Sensitivity may be found for life, damage, or factory of safety. For instance, if you set the lower and upper
fatigue sensitivity limits to 50% and 150% respectively, and your scale factor to 3, this result will plot the data
points along a scale ranging from a 1.5 to a 4.5 scale factor. You can specify the number of fill points in the curve,
as well as choose from several chart viewing options (such as linear or log-log).
The Navigational Control at the bottom right hand corner of the graph can be used to zoom and pan the graph.
You can use the double-sided arrow at any corner of the control to zoom in or out. When you place the mouse
in the center of the Navigational Control, you can drag the four-sided arrow to move the chart points within the
chart.
Hysteresis
In a strain-life fatigue analysis, although the finite element response may be linear, the local elastic/plastic response
may not be linear. The Neuber correction is used to determine the local elastic/plastic response given a linear
elastic input. Repeated loading will form close hysteresis loops as a result of this nonlinear local response. In a
constant amplitude analysis a single hysteresis loop is created although numerous loops may be creat ed via
rainflow counting in a non-constant amplitude analysis. The Hysteresis result plots the local elastic-plastic re-
sponse at the critical location of the scoped result (the Hysteresis result can be scoped, similar to all result items).
Hysteresis is a good result to help you understand the true local response that may not be easy to infer. Notice
in the example below, that although the loading/elastic result is tensile, the local response does venture into
the compressive region.
Loading/Elastic Response:
Contact
Contact conditions are formed where bodies meet. You can transfer structural loads and heat flows across the
contact boundaries and “connect” the various bodies. There are no limits placed on the number of bodies that
comprise an assembly. Depending on the type of contact, the analysis can be linear or nonlinear. A nonlinear
analysis can increase runtime significantly, as the solver will internally run iterations to arrive at a converged
solution.
By default, when an assembly is imported from a CAD system, contact is automatically detected and contact regions
are assigned for face/face conditions. This default can be changed in the Options dialog box under the Simulation
Contact settings.
The contact default settings and automatic detection capabilities are sufficient for most contact problems.
However, additional contact controls are available that broaden the range of contact simulations you can perform:
• Global capabilities include controls for automatic contact detection and transparency for highlighting
contact regions. These capabilities apply to all contact regions.
• Contact region controls include scoping, defining contact type, and advanced controls such as specifying
contact formulation, normal stiffness, update stiffness, thermal conductance, and the pinball region.
Related References
Global Contact Settings
Contact Region Settings
Supported Contact Types and Formulations
Setting Contact Conditions Manually
Contact Ease of Use Features
Contact Tool and Results
Contact Option Preferences
• Generate Contact on Update: Face/face contact regions are automatically created when a model is im-
ported (updated) provided this preference is set in the Options dialog box. Setting this option to No still
allows you to manually activate automatic contact generation, or construct contact regions manually.
• Tolerance Type, Tolerance Value, and Tolerance Slider: Bodies in an assembly that were created in a
CAD system may not have been placed precisely, resulting in small overlaps or gaps along the contact
regions between bodies. You can account for any imprecision by specifying contact detection tolerance
(applicable to automatic contact detection only).
To tighten the contact detection between bodies, move the Tolerance Slider bar closer to +100. To loosen
the contact detection, move the Tolerance Slider bar closer to -100. A tighter tolerance means that the
bodies have to be within a smaller region (of either gap or overlap) to be considered in contact; a loose
tolerance will have the opposite effect. Be aware that as you adjust the tolerance, the number of contact
pairs could increase or decrease.
Contact detection tolerance can also be adjusted using an exact distance. Change Tolerance Type to
Value and enter a specific distance in the Tolerance Value field.
If you select a Contact branch in the tree and the Tolerance Type is set to Value, a circle appears around
the current cursor location as shown here.
The radius of the circle is a graphical indication of the current Tolerance Value. The circle moves with the
cursor, and its radius will change when you change the Tolerance Value or the Tolerance Slider. The
circle appropriately adjusts when the model is zoomed in or out.
• Types of Contact Detection: By default, Auto Detection will detect contact between faces of different
bodies (Face/Face). Contact can also be detected between the faces and edges (Face/Edge) of different
bodies, or between edges and edges (Edge/Edge) of different bodies. For Face/Edge detection, faces
are designated as targets and edges are designated as contacts. You can select any combination of contacts
to be detected during Create Automatic Contact. You can also set default preferences for these contact
filter options in the Options dialog box.
In addition, face to edge contact has the option to determine contact for only Solid edges or only Surface
edges. If face to edge contact only for solid body edges is selected, face to edge contact will use only the
edges of solid bodies to determine contact with all faces. Likewise, if face to edge contact only for surface
body edges is selected, face to edge contact will use only edges of surface bodies to determine contact
with all faces.
• Priority: For very large models the number of contact regions can sometimes become overwhelming
and redundant, especially when multiple types of contact are allowed. Selecting some type of priority
other than Include All will lessen the number of contact regions generated during Create Automatic
Contact by giving designated contact types precedence over other types.
Priority refers to the type of contact interaction between a given set of geometry bodies. Face Overrides
gives Face/Face contact precedence over both Face/Edge and Edge/Edge contact. Face Overrides also
gives Face/Edge contact precedence over Edge/Edge contact. In general, when Face Overrides priority
is set with Face/Edge and Edge/Edge contact, no Edge/Edge contact pairs will be detected. Edge
Overrides gives Edge/Edge contact precedence over both Face/Edge and Face/Face contact. Edge
Overrides also gives Face/Edge contact precedence over Face/Face contact. In general, when Edge
Overrides priority is set with Face/Edge and Face/Face contact, no Face/Face contact pairs will be de-
tected.
• Same Body Grouping: Allows you to control automatically generated contact regions.
With automatic detection enabled, setting Same Body Grouping to Yes (default) means that contact
surfaces and edges that lie on the same bodies will be included into a single region. Automatically generated
pairs may have multiple selections on the source side, or on the target side, or on both sides. Use this
option for most problems. It will minimize the number of contact regions created.
With automatic detection enabled, setting Same Body Grouping to No means that the grouping of
contact surfaces and edges that lie on the same bodies will not occur. Any regions generated will have
only one entity scoped to its source and target (that is, one surface or one edge). Applications for choosing
No are:
– If there are a large number of source/target surfaces in a single region. Choosing No avoids excessive
contact search times in the ANSYS solver.
– If you want to define different contact behaviors on separate regions with contact of two parts. For
example, for a bolt/bracket contact case, you may want to have bonded contact between the bolt
threads/bracket and frictionless contact between the bolt head/bracket.
Scope Settings
• Scoping Method: Specifies whether the contact region is scoped to a Geometry Selection or to a Named
Selection.
• Contact: Displays/selects what faces or edges are considered contact. This list will be automatically filled
for auto generated contact pairs, and depends on the automatic contact detection types that you have
specified. For Face/Edge contact, the edge must be designated as Contact.
• Target: Displays/selects what faces or edges are considered target. This list will be automatically filled for
auto generated contact pairs and depends on the automatic contact detection types that you have spe-
cified. For Face/Edge contact, the face must be designated as Target.
• Contact Bodies: This read only property displays which bodies have faces or edges in the Contact list.
Note that if you click on this field, the bodies are highlighted.
• Target Bodies: This read only property displays which bodies have faces or edges in the Target list. Note
that if you click on this field, the bodies are highlighted.
Definition Settings
• Type: The differences in the contact settings determine how the contacting bodies can move relative to
one another. This is the most common setting and has the most impact on what other settings are available.
Most of these types only apply to contact regions made up of faces only.
– Bonded: This is the default configuration for contact regions. If contact regions are bonded, then no
sliding or separation between faces or edges is allowed. Think of the region as glued. This type of
contact allows for a linear solution since the contact length/area will not change during the application
of the load. If contact is determined on the mathematical model, any gaps will be closed and any initial
penetration will be ignored.
– No Separation: This contact setting is similar to the bonded case. It only applies to regions of faces.
Separation of faces in contact is not allowed, but small amounts of frictionless sliding can occur along
contact faces.
– Frictionless: This setting models standard unilateral contact; that is, normal pressure equals zero if
separation occurs. It only applies to regions of faces. Thus gaps can form in the model between bodies
depending on the loading. This solution is nonlinear because the area of contact may change as the
load is applied. A zero coefficient of friction is assumed, thus allowing free sliding. The model should
be well constrained when using this contact setting. Weak springs are added to the assembly to help
stabilize the model in order to achieve a reasonable solution.
– Rough: Similar to the frictionless setting, this setting models perfectly rough frictional contact where
there is no sliding. It only applies to regions of faces. By default, no automatic closing of gaps is per-
formed. This case corresponds to an infinite friction coefficient between the contacting bodies.
– Frictional: In this setting, two contacting faces can carry shear stresses up to a certain magnitude
across their interface before they start sliding relative to each other. It only applies to regions of faces.
This state is known as “sticking.” The model defines an equivalent shear stress at which sliding on the
face begins as a fraction of the contact pressure. Once the shear stress is exceeded, the two faces will
slide relative to each other. The coefficient of friction can be any non-negative value.
Choosing the appropriate contact type depends on the type of problem you are trying to solve. If modeling
the ability of bodies to separate or open slightly is important and/or obtaining the stresses very near a
contact interface is important, consider using one of the nonlinear contact types (Frictionless, Rough,
Frictional), which can model gaps and more accurately model the true area of contact. However, using
these contact types usually results in longer solution times and can have possible convergence problems
due to the contact nonlinearity. If convergence problems arise or if determining the exact area of contact
is critical, consider using a finer mesh (using the Sizing control) on the contact faces or edges.
• Friction Coefficient: Allows you to enter a friction coefficient. Displayed only for frictional contact applic-
ations.
• Scope Mode: Read-only property that displays how the contact region was generated.
– Asymmetric: Contact will be asymmetric for the solve. All face/edge and edge/edge contacts will be
asymmetric.
Asymmetric contact has one face as Contact and one face as Target (as defined under Scope Settings),
creating a single contact pair. This is sometimes called “one-pass contact,” and is usually the most ef-
ficient way to model face-to-face contact for solid bodies.
– Symmetric: (Default) - Contact will be symmetric for the solve.
– Auto Asymmetric: Automatically creates an asymmetric contact pair, if possible. This can significantly
improve performance in some instances. When you choose this setting, during the solution phase the
solver will automatically choose the more appropriate contact face designation. Of course, you can
designate the roles of each face in the contact pair manually.
To produce meaningful contact results for contact pressure, you must either choose the Auto Asym-
metric setting or manually create an asymmetric contact pair.
• Suppressed: Specifies whether or not the contact region is included in the solution.
Advanced Settings
Note — Cases involving large gaps and surfaces bonded together can result in fictitious moments being
transmitted across a boundary.
• Formulation: Controls the underlying contact formulation method. The following choices are available:
– Augmented Lagrange: Compared to the Pure Penalty method, this method usually leads to better
conditioning and is less sensitive to the magnitude of the contact stiffness coefficient. However, in
some analyses, the Augmented Lagrange method may require additional iterations, especially if the
deformed mesh becomes too distorted.
– Pure Penalty: Basic default formulation. For some contact geometries, refer to Supported Contact
Types and Formulations.
– MPC: Multipoint constraint equations are created internally during the ANSYS solve to tie the bodies
together. This can be helpful if truly linear contact is desired or to handle the nonzero mode issue for
free vibration that can occur if a penalty function is used. For some contact geometries, refer to Sup-
ported Contact Types and Formulations. Note that this setting is valid only for Bonded contact. Also
note that contact based results (such as pressure) will be zero.
– Normal Lagrange: Enforces zero penetration when contact is closed making use of a Lagrange multipler
on the normal direction and a penalty method in the tangential direction. Normal Stiffness is not
applicable for this setting. Normal Lagrange adds contact traction to the model as additional degrees
of freedom and requires additional iterations to stabilize contact conditions. It often increases the
computational cost compared to the Augmented Lagrange setting. The Iterative setting (under
Solver Type) cannot be used with this method.
• Interface Treatment: Indicates how the contact interface for the pair is treated. The following options
are available:
– Adjust to Touch: Any initial gaps are closed and any initial penetration is ignored creating an initial
stress free state. Contact pairs are “just touching” as shown.
Contact pair before any Interface Treatment. Contact pair afterAdjust to Touch treatment.
Contact pair before any Interface Treatment. Contact pair afterAdjust to Touch treatment.
This setting is useful to make sure initial contact occurs even if any gaps are present (as long as they
are within the pinball region). Without using this setting, the bodies may fly apart if any initial gaps
exist. Although any initial gaps are ignored, gaps can still form during loading for the nonlinear contact
types. This treatment is used inherently for the linear contact types (Bonded and No Separation),
which is the reason why Interface Treatment is not displayed for these contact types. For nonlinear
contact types (Frictionless, Rough, and Frictional), Interface Treatment is displayed where the
choices are Adjust to Touch and Add Offset.
– Add Offset: Models the true contact gap/penetration plus adds in any user defined offset values. This
setting is the closest to the default contact setting used in ANSYS except that the loading is ramped.
Using this setting will not close gaps. Even a slight gap may cause bodies to fly apart. Should this occur,
use a small contact offset to bring the bodies into initial contact. Note that this setting is displayed
only for nonlinear contact and is the default value for nonlinear contact.
• Specify Offset: Defines the contact offset. Positive values move the contact closer together (increase
penetration/reduce gap) and negative values move the contacts further apart. This setting is displayed
only if Interface Treatment is set to Add Offset.
Contact pair before any Interface Treatment. Gap exists. Contact pair afterAdd Offset treatment. Gap is closed
"manually” based on value entered for Specify Offset
(positive value shown that includes some penetration).
• Normal Stiffness: Defines a contact normal stiffness factor. The usual factor range is from 0.01-10, with
the default selected programmatically. A smaller value provides for easier convergence but with more
penetration. The default value is appropriate for bulk deformation. If bending deformation dominates,
use a smaller value (0.01-0.1). If you encounter convergence difficulties or too much penetration, you can
adjust the stiffness factor.
– Program Controlled - (default) The Normal Stiffness Factor will be calculated by the program. If only
Bonded or No Separation contact exists, the value is set to 10. If any other type of contact exists, all
the program controlled regions (including Bonded or No Separation) will use the ANSYS default (Real
constant FKN).
– Manual - The Normal Stiffness Factor is input directly by the user.
• Normal Stiffness Factor: Allows input of the Normal Stiffness Factor. Only positive values are allowed.
This choice is displayed only if Manual is specified for Normal Stiffness.
• Update Stiffness: Allows you to specify if the program should update (change) the contact stiffness
during the solution. The update choices are at each equilibrium iteration or at each substep. If you choose
either of these stiffness update settings, the program will modify the stiffness (raise/lower/leave unchanged)
based on the physics of the model (that is, the underlying element stress and penetration). This choice is
displayed only if you set the Formulation to Augmented Lagrange or Pure Penalty, the two formulations
where contact stiffness is applicable.
An advantage of choosing either of the program stiffness update settings is that stiffness is automatically
determined that allows both convergence and minimal penetration. Also, if this setting is used, problems
may converge in a Newton-Raphson sense, that would not otherwise.
You can use a Result Tracker to monitor a changing contact stiffness throughout the solution.
– Never: (Default)1 Turns off the program's automatic Update Stiffness feature.
– Each Equilibrium Iteration: Sets the program to update stiffness at the end of each equilibrium iter-
ation. This choice is recommended if you are unsure of a Normal Stiffness Factor to use in order to
obtain good results.
– Each Substep: Sets the program to update stiffness at the end of each substep.
1
- The default can be changed in the Options dialog box under Contact.
• Thermal Conductance: Controls the thermal contact conductance value used in a thermal contact simu-
lation.
– Program Controlled - (default) The program will calculate the value for the thermal contact conduct-
ance. The value will be set to a sufficiently high enough value (based on the thermal conductivities
and the model size) to model perfect contact with minimal thermal resistance.
– Manual - The Thermal Conductance Value is input directly by the user.
• Thermal Conductance Value: Allows input of the Thermal Conductance Value (in units of heat transfer
film coefficient). Only positive values are allowed. This choice is displayed only if Manual is specified for
Thermal Conductance.
• Pinball Region: Allows you to specify the contact search size, commonly referred to as the pinball region.
Setting a pinball region can be useful in cases where initially, bodies are far enough away from one another
that, by default, the program will not detect that they are in contact. You could then increase the pinball
region as needed. Consider an example of a surface body that was generated by offsetting a surface of a
solid body, possibly leaving a large gap, depending on the thickness. Another example is a large deflection
problem where a considerable pinball region is required due to possible large amounts of over penetration.
In general though, if you want two regions to be bonded together that may be far apart, you should
specify a pinball region that is large enough to ensure that contact indeed occurs.
For bonded and no separation contact types, you must be careful in specifying a large pinball region. For
these types of contact, any regions found within the pinball region will be considered to be in contact.
For other types of contact, this is not as critical because additional calculations are performed to determine
if the two bodies are truly in contact. The pinball region defines the searching range where these calcula-
tions will occur. Further, a large gap can transmit fictitious moments across the boundary.
– Program Controlled - (default) The pinball region will be calculated by the program.
– Radius - Specifies that you directly enter a value for the pinball region.
The pinball radius for the contact region is shown graphically at the annotation anchor for the Radius
setting and possibly for the Program Controlled setting. You can move the annotation anchor to any
point on the contact region, which helps in the visual verification of an appropriate pinball radius.
• Pinball Radius: The numerical value for the pinball radius. This choice is displayed only if Pinball Region
is set to Radius.
• Search Direction: Allows you to specify the contact search direction when the contact region involves a
surface body edge. This choice is displayed only if Formulation is set to MPC.
– Target Normal - (default) Contact search is in a direction normal to the target face.
– Inside Pinball - Contact search is initially in a direction normal to the target face. If contact is not de-
tected, the search continues inside the pinball region. This setting is suggested for simulating bodies
in contact that do not overlap. As an example, consider searching for contact between two surface
bodies butted together with edge/edge type. If Target Normal is chosen, contact will not occur re-
gardless of how large the pinball region is. If Inside Pinball is chosen, contact will occur assuming the
pinball region is large enough.
Contact Geometry Solid Body Face Solid Body Edge Surface Body Face Surface Body Edge
Contact Geometry Solid Body Face Solid Body Edge Surface Body Face Surface Body Edge
1 - For Face/Edge contact, faces must always be designated as targets and edges must always be designated as
contacts.
Automatic contact regions represent contact only to the extent of the scope where the corresponding bodies
initially are close to one another. For automatic contact, the contact elements are “trimmed” before solution.
The trimming is based on the detection tolerance. The tighter the tolerance, the less number of generated contact
elements. Note that if you set Large Deflection effects to On in the Details View of a Solution object, no trimming
will be done due to the possibility of large sliding.
• Modeling “large sliding” contact. Contact regions created through auto-detection assume "assembly
contact," placing contact faces very near to one another. Manual contact encompasses the entire scope
so sliding is better captured. In this case, you may need to add additional contact faces.
• Auto-detection creates more contact pairs than are necessary. In this case, you can delete the unnecessary
contact regions.
• Auto-detection may not create contact regions necessary for your analysis. In this case, you must add
additional contact regions.
You can set contact conditions manually, rather than (or in addition to) letting the application automatically
detect contact regions.
Within a source or target region, the underlying geometry must be of the same geometry type (for example, all
surface body faces, all solid body faces). The source and target can be of different geometry types, but within
itself, a source must be of the same geometry type, and a target must be of the same geometry type.
2. Choose Insert> Manual Contact Region from the menu bar or via right mouse click. You can also select
the Contact button on the toolbar.
3. A Contact Region item appears in the Outline. Click that item, and under the Section : Details View,
specify the Contact and Target regions (faces or edges) and the contact type.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
3. Select Hide All Other Bodies in the menu. All bodies are hidden except those that are part of the selected
contact region.
• Rename: Allows you to change the contact region name to a name that you type (similar to renaming a
file in Windows Explorer).
• Rename Based on Geometry: Allows you to change the contact region name to include the corresponding
names of the items in the Geometry branch of the tree that make up the contact region. The items are
separated by the word “To” in the new contact region name. You can change all the contact region names
at once by clicking the right mouse button on the Contact branch, then choosing Rename Based on
Geometry from that context menu. A demonstration of this feature follows.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Note — This choice is available only if there is more than one body in your assembly.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Note — This feature is not applicable to Face/Edge contact where faces are always designated as targets
and edges are always designated as contacts.
Note — The XML file contains properties that are universally applied to contact regions. For this reason,
source and target geometries are not included in the file.
Note — This choice is available only if there is more than one body in your assembly.
Section : Introduction
Section : Virtual Cell Creation
Introduction
A CAD Model in Simulation has two parts:
1. Topology: The connectivity of a CAD model, meaning: vertices are connected to edges, which are con-
nected to faces, which are connected to volumes. Each one of these entities is referred to as a cell.
2. Geometry: The geometry of the CAD model is the underlying mathematical definition of the aforemen-
tioned cells.
A virtual cell in Simulation modifies the topology of only the local copy in Simulation. Your original CAD model
remains unchanged because the model in Simulation is a virtual image.
Note — The tesselation of models from CATIA4 may not be appropriate for virtual topology, which could
prevent the creation of virtual cells for these models.
• Region Flatness - Slider control that sets the flatness of the virtual cell region's Gauss map angle.
The range is from 0o to 180o.
• Smallest Edge Tolerance - Virtual cells will be created for any surface/edge whose edge length is
less than or equal to this value.
• Shared Boundary Ratio - Slider control that sets a threshold ratio of how much boundary is shared
as a condition for merging. Surfaces below this tolerance are not merged. The range is from 0 to 1.
• Region Size - Slider control that defines the target region size as a decimal number whose percentage
is of the total surface area. The range is from 0 to 1.
• Generate on Update - Sets whether you want to include the settings in this Details View when you
update geometry.
3. Click right mouse button on Virtual Topology object and choose Generate Virtual Cells from the
context menu. A Virtual Cell object is automatically inserted in the tree for each region containing only
sheets that meets the criteria established by the settings in step 2.
Note —
• After automatic creation of the virtual cells, the state some Contact objects may change to Under-
defined, implying that you must regenerate contact (right mouse button click on Contact object
and choosing Create Automatic Contact from the context menu).
• If Generate on Update is set to Yes and you update the geometry, all Virtual Cell objects that
were created automatically will be deleted and recreated based on the new geometry. Any loads
that were attached to geometry within the deleted Virtual Cell objects will need to be reattached
to the new geometry.
• If Generate on Update is set to No and you update the geometry, all Virtual Cell objects that
were created automatically should remain persistent barring major topology changes of the
model being updated. Reapplication of loads may not be necessary.
• When you suppress a face in a virtual cell, the virtual edges that bound the surface are suppressed.
When you unsuppress the face in the virtual cell, you must manually unsuppress the virtual edges
that bound the face.
x = supported
Reader/Plug-In Pro/ENGINEER x x x
for Pro/ENGIN- Wildfire 1
EER
x = supported
* This version processor may run on the Sun UltraSPARC 64–bit platform, but with limited performance.
Geometry Preferences
You can set the following geometry preferences on the Project Page or in the Details View of Geometry. Prefer-
ences on the Project Page are included in two categories: Default Geometry Usage Options and Advanced
Geometry Usage Defaults, as shown below. You can set default options in the Options dialog box under
Common Settings: Geometry Import.
DesignModeler
Inventor
Mechanical Desktop
Pro/ENGINEER
Solid Edge
SolidWorks
UG
DesignModeler
Inventor
Mechanical Desktop
Pro/ENGINEER
Solid Edge
SolidWorks
UG
Attributes CAD Attribute Transfer Allows import of CAD system attributes into
Simulation models. Enable this option to import
(check box) Motion Loads. The default is No. The preference
applies to the following:
Inventor
Mechanical Desktop
Pro/ENGINEER
Solid Edge (motion loads only)
SolidWorks
UG
Attributes CAD Attribute Prefixes This field can have any number of prefixes with
each prefix delimited by a semicolon. By default
(text field) the filter is set to SDFEA;DDM. If the filter is set
to an empty string all applicable entities will be
imported as CAD system attributes.
Named Selections Named Selection Processing Creates a named selection based on data gener-
ated in the CAD system or in DesignModeler.
(check box) You must set the value in the Named Selection
Prefixes field (described below) to the desired
value. Upon attaching or updating, a Named
Selection branch is added to the tree and its
name appears in the drop down display within
the Named Selection Toolbar. It is maintained
as a CAD named selection unless the branch is
altered (entities added or deleted, selection re-
named). After updating, CAD named selections
are deleted and replaced with named selections
that are imported for the updated model. [2]The
default is No. The preference applies to the fol-
lowing:
DesignModeler
Inventor
Mechanical Desktop
Pro/ENGINEER
Solid Edge
SolidWorks
UG
DesignModeler[3]
Inventor
Pro/ENGINEER
UG
[1] These preferences are on a per part basis. Parts with solid bodies and surface bodies will result in an
attach failure if both import type preferences are selected. For assemblies however, where different
components are solely solid body or surface body, import of each part will be successful.
– If you use a CAD system filter for entities, you must be able to create entities with names that correspond
to the filter.
– Named selection sets should contain entities of only a single dimension (for example, faces, edges).
– SolidWorks and Pro/ENGINEER require unique identifiers. This limits a named selection to a single
entity per part in the model.
– Refer to the Named Selection Import Based on Entities table to determine the CAD system support
for the various entities (vertex, edge, face, body).
[3] You cannot define materials directly in DesignModeler, although DesignModeler can import material
properties from Pro/ENGINEER, Inventor, or Unigraphics, and pass those properties on to Simulation.
• Project Page Advanced Geometry Defaults
Inventor Mechanical
Desktop
OneSpace Designer Modeling
Solid Edge
SolidWorks
UG
Reader mode saves updated Reader Save Part File When set to Yes, the Unigraphics reader interface
CAD file will save the part file of a model at the end of an
update process using the same file name in the
(check box) same directory. The default is No. The preference
applies to the following:
UG Reader
Smart CAD Update Do Smart Update Speeds up refresh of models that have unmodi-
fied components. If set to Yes and changes are
made to other preferences, these will not be re-
spected if the component is smart updated. The
default is No. The preference applies to the fol-
lowing:
Unigraphics
Inventor
Temporary file during attach Attach File Via Temp File Specifies whether file should be imported dir-
ectly or as a temporary file. Recommendation is
(check box) Yes for large models to decrease import time. A
file will be created and deleted during the pro-
cessing of an attach or update. The default is No.
The preference applies to the following:
None
Solid
Surface
Line
The default is None which means that if there
are bodies of mixed dimension in a multi-body
part, nothing is transferred to Simulation. Solid
means only solid(s) from the part are transferred
to Simulation. Surface means only surface(s)
from the part are transferred to Simulation.
[1] Applies to all supported CAD systems. Parts can be transferred to Simulation when:
General Information
File Name Limitation
Part names from CAD systems will be truncated to 31 characters. If the file name is not unique within the first 31
characters, problems are likely to occur when data is refreshed.
Material Properties
The CAD system interfaces will process only the isotropic material type.
This situation applies to all supported CAD systems except Pro/ENGINEER, Unigraphics, and Solid Edge. For
Unigraphics, you can set environment variables to specify the version. Solid Edge does not support the installation
of multiple versions.
ACIS
The application supports ACIS as a reader up to version 14 including all of its point releases. Based on previous
ACIS version history, any point release is likely to work also.
Notes
Although the ACIS geometry format does not have an assembly entity, the application supports ACIS files con-
taining one or multiple bodies.
Length Unit
You should specify the length unit of the parts retrieved from the ACIS file in the Geometry Details View. You
can verify length units by checking the details of the Geometry or Part, which shows the part's bounding box
size. We recommend verifying dimensions before Section : Solving.
Autodesk Inventor
The application supports Autodesk Inventor R9 and R10 as both a reader and a plug-in.
If, upon attaching, you receive the message Failed to get reference key, the attaching process will continue,
but an associative relation during update cannot be guaranteed.
Length Unit
The Geometry length unit is centimeters which is the unit used internally by Autodesk Inventor. The user or
working unit system can be changed by Main Menu> Units.
Updating Drawings
It is always recommended that you issue the AMUPDATE,ALL command before attempting to attach drawings
from Autodesk Mechanical Desktop into Simulation.
Notes
It is recommended that Autodesk Mechanical Desktop and the Simulation Plug-in be running concurrently when
attaching or updating a part or assembly.
by checking the loaded application (Assist> Load Application> Loaded Applications). If the file MD2004Plu-
gIn100NU.arx is found, the plug-in is installed properly. Try the following steps to solve the problem:
• Add the menu by choosing Assist> Customize> Menus, then click the Menu Groups tab. Browse for the
Workbench 10.0 menu (\ANSYS Inc\v100\AISOL\CAD Integration\MDT2004\WorkBench100.mnu)
and load. Then select the Menu Bar tab and add the Workbench 10.0 menu to desired location.
• If Autodesk Mechanical Desktop is still not displaying the Workbench 10.0 menu, rerun the Simulation
setup.
Note — Workbench writes its menu entries to: C:\Documents and Settings\<username>\Application
Data\Autodesk\Mechanical Desktop 2005\R16.1\enu\support, but the menus are not being read by
Autodesk Mechanical Desktop at that location.
If you open Autodesk Mechanical Desktop after installing the Workbench plugin and you do not see the
ANSYS 10.0 drop down menu, go to Assist> Options, then under the Files tab, choose Support File
Search Path, and move the entries under C:\Documents and Settings\<username>\Application
Data\Autodesk\Mechanical Desktop 2005\R16.1\enu\support to the top of the list.
Simulation cannot bring in assemblies with XRef parts. We strongly recommend that you use AMCATALOG rather
than XRef to manage external part/assembly files in Autodesk Mechanical Desktop.
To use ACIS solids (lists as 3DSOLID) with Simulation, use the Autodesk Mechanical Desktop command Part>
Part> Convert Solid to convert the solid to a part.
Length Unit
You should specify the length unit of the parts retrieved from Autodesk Mechanical Desktop in the Geometry
Details View. You can verify length units by checking the details of the Geometry or Part, which shows the part's
bounding box size. Verification of dimensions is recommended before using Solve.
CATIA V4
Simulation supports CATIA V4 files as a reader.
Notes
Simulation reads CATIA .model and .export files, but does not support .asm files. Simulation supports reading
of CATIA volumes and solid models. Although the CATIA geometry format does not have an assembly entity,
Simulation supports CATIA files containing one or multiple bodies. Simulation supports reading of CATIA de-
tails/dittos by exploding them.
Length Unit
Simulation automatically sets the length unit in the model to match the unit saved in the CATIA V4 file. No ad-
justment of length unit is necessary or possible. Multiple bodies should all be constructed using the same length
unit. We recommend verifying dimensions before Section : Solving.
CATIA V5
Simulation supports CATIA V5 releases 2 through 15 as a reader.
Notes
Simulation reads CATIA V5 parts (*.CATPart ) and assemblies (*.CATProduct ).
CATIA V5 surface bodies consisting of closed surfaces are transferred as solid bodies.
Length Unit
You should specify the length unit of the parts retrieved from the CATIA V5 file in the Geometry Details View.
You can verify length units by checking the details of the Geometry or Part, which shows the part's bounding
box size. Multiple bodies should all be constructed using the same length unit. We recommend verifying dimen-
sions before Section : Solving.
DesignModeler
Simulation supports the DesignModeler as both a reader and a plug-in.
Attaching Geometry
Coordinate systems defined in a model created in DesignModeler will automatically be created in Simulation
after importing the model to Simulation. Any planes in DesignModeler that are flagged to be exported will appear
in Simulation as a local Cartesian coordinate system upon attachment and will be inserted into the Simulation
tree. The automatic creation of the coordinate system occurs during attachment and is updated during a refresh.
Any enclosures defined with a model in DesignModeler will be retained upon attaching. Once in Simulation, the
enclosure has the following characteristics:
• A transparency value of 0.1 (subdued) is assigned to the enclosure in order to assist in the visualization
of the model items inside the enclosure.
• A default field material of Air is automatically assigned to the enclosure. You can change the default field
material in the Engineering Data. A field material is used in any open domain simulation where an artificial
boundary such as an enclosure is used to surround the model. Any fields extending from the model to
the edges of the enclosure experience the field material. Examples are antenna radiation fields or fluid
flow fields in Electromagnetic and Fluid simulations (planned for future releases of ANSYS Workbench).
If you import a model that has multi body parts (that is, parts that include multiple bodies within them as a
group), then the model will be imported using shared topology so that no contact is required and meshes on
the volume interfaces will match.
DesignModeler parameters are all set at the model level and will be displayed in Simulation under the Geometry
branch.
For line body properties that appear in Simulation, the values shown are for the raw cross section, that is, the
offset type and/or user defined offset from DesignModeler's body properties have no bearing on the calculations
shown in Simulation. They are taken directly from the cross section without applying any offset.
Surface thicknesses and material properties are transferred from DesignModeler to Simulation.
Notes
If you are using DesignModeler as a reader, Simulation will maintain associativity with the DesignModeler
model. If you modify parameters in Simulation, the DesignModeler model will change upon update.
Length Unit
Simulation automatically sets the length unit in the part or assembly to match the unit saved in the DesignModeler
file. No adjustment of length unit is necessary or possible.
IGES
The IGES reader converts IGES information written in 5.3 format and before into Parasolid data.
Closed surfaces and hollow solids from an IGES file are transferred as full solids in Simulation.
Length Unit
Simulation automatically sets the length unit in the part or assembly to meters. No adjustment of length unit is
necessary or possible.
Supported Documents
The OneSpace Designer Modeling 2005 interface supports the import of solid and surface components. The
plug-in will import all parts in the model based on body type import filters. Active CAD session models imported
from OneSpace Designer Modeling can only be updated from an active session unless the model is relinked to
a specified file. A model imported based on its file can only be updated from the file unless relinked to an active
session.
Notes
Supported extension types include (*.pkg;*.bdl;*.ses;*.sda;*.sdp;*.sdac;*.sdpc).
SES files are not portable between different versions of OneSpace Designer Modeling. They should be limited
to use on a single machine.
Parasolid
Simulation supports Parasolid as a reader up to and including version 16.1. See the release notes for updated
compatibility information.
Length Unit
Simulation automatically sets the length unit in the part or assembly to meters, which is the unit used internally
by Parasolid to dimension solid parts. No adjustment of length unit is necessary or possible.
Faceting Limitation
Generalized (non-manifold) bodies from Parasolid will not have facets with smoothly matching edges. The
model will appear to have gaps; however, this is a limitation only in the faceting capabilities from Parasolid and
does not affect meshing or accuracy.
Pro/ENGINEER
Simulation supports Pro/ENGINEER Wildfire 1 and Wildfire 2. See the release notes for updated compatibility
information.
Installation Notes
Before installing Simulation, please make sure that you have installed Pro/ENGINEER and have run the program
at least once under the user login that you will use to install Simulation.
Notes
If an active Pro/ENGINEER file does not appear under Active CAD Files, either Pro/ENGINEER is not running or
the Simulation Plug-in for Pro/ENGINEER is not loaded. For this last condition, you must re-install the Pro/Engineer
Plug-in component using the Simulation CD. For more information on attach error conditions, see CAD Related
Troubleshooting.
If a part, a component, an assembly, or a sub-assembly has one or more local coordinate systems, those coordinate
systems will get transferred into Simulation upon attaching. Once they are in Simulation, they can be modified
by updating.
Surface bodies imported into Simulation include numerical references to the parent part or assembly and
Pro/ENGINEER quilt ID. For example, a part named H103 with three Pro/ENGINEER quilts 1, 2, and 3 will be iden-
tified as H103[1], H103[2] and H103[3].
For material data to be transferred into workbench with the correct values the model and the material must be
reflecting the same unit system. This unit system must be one of the 6 standard unit systems used by Pro/ENGIN-
EER. If the unit system of the model is not supported, a warning will be displayed in Pro/ENGINEER.
If you attach surface model database files from DesignSpace 7.0, you must re-attach loads after updating.
Note — Due to a reported defect in the Pro/ENGINEER API, active models do not correctly reflect their
UNC path. To import parts into ANSYS Workbench, you must open the parts in Pro/ENGINEER from a
local or mapped drive.
If you open multiple parts in Pro/ENGINEER, select the window of the part that you want to work with before
switching to Simulation and attaching.
When using an assembly's offset as a parameter, a negative value will cause the direction of the offset to flip and
the value will be returned with a positive sign.
Updating Instances
If you wish to update a particular instance of a model, it is necessary that the active model in Pro/ENGINEER be
the desired instance, otherwise a generic version of the instance will be used for the update.
File Versions
Multiple versions of Pro/ENGINEER files are designated with a .# extension that is appended to the .prt or .asm
extension (for example, wrench.prt.1, wrench.prt.2 are names of two Pro/ENGINEER file versions). You can access
a specific version of a Pro/ENGINEER file through the Workbench Start Page.
You are strongly advised to avoid stripping the version numbers from Pro/ENGINEER files for the following
reasons:
• If you open a stripped version of the file in Pro/ENGINEER and import the file via the plug-in, it will indicate
the wrong version if there is any other version of that part file in the same directory.
• If you attempt to load a stripped version of the file by using the reader, the highest file version of that
model will be loaded.
Regarding the updating of Pro/ENGINEER file versions, updating will be version specific if you use the reader or
if you do not open a copy of that model with the same name in a Pro/ENGINEER interactive session. However, if
you open one version of a model in Pro/ENGINEER and you request the same model, but a different version for
attach or update, the currently active version will be assumed to be the one that you want. This assumption is
necessary for the following reasons:
• Pro/ENGINEER does not allow two different versions of the same part to be active at one time, using the
same name.
• If you save a model in a Pro/ENGINEER session, its version is incremented (for example, if you attach via
the plug-in with version 3, then save the model in Pro/ENGINEER, the version of the active model would
be version 4).
Length Unit
Simulation automatically sets the length unit in the part or assembly to match the unit saved in the Pro/ENGINEER
part file. No adjustment of length unit is necessary or possible. Assemblies and their component parts should all
be constructed using the same length unit.
Solid Edge
Simulation supports Solid Edge v16.0 and v17.0 as both a reader and a plug-in. See the release notes for updated
compatibility information.
Supported Documents
The Solid Edge interface supports Solid Edge part, assembly, sheet metal, and weldment documents. If more
than one document is open in Solid Edge, the top-most document, which is the active document, will be processed
by the interface.
Solid Edge recommends that each part document contain only one body, otherwise a duplicate set of parameters
and variables may be imported.
Notes
After opening a document in Solid Edge, if the ANSYS 10.0 menu is not displayed in the Solid Edge menu bar,
check if ANSYS 10.0 is listed in the Available Add-Ins list box of the Add-in Manager dialog box (Tools> Add
Ins> Add-In Manager...). If it is listed but not checked, check the box in front of it and click OK. If it is not listed,
try to register the plug-in DLL (DSPlugInSEU.dll) manually. The DLL is located in the ANSYS Workbench install-
ation folder under the CAD Integration\Solid Edge folder. If it fails to register, re-install the Solid Edge plug-in
component.
A closed surface body will be imported into Simulation as a solid body since Solid Edge considers this body as
a solid.
For a part that has a simplified model, if you have this model displayed in Solid Edge, you will need to have the
Simplify menu displayed in order to get the simplified model in Simulation.
Length Unit
The Part length unit within Simulation is meters independent of the unit system displayed in Solid Edge. The
Length Unit displayed under “Details of Geometry” in Simulation cannot be changed.
SolidWorks
Simulation supports SolidWorks 2004 and 2005 as both a reader and a plug-in. See the release notes for updated
compatibility information.
Supported Documents
The SolidWorks interface supports SolidWorks part and assembly documents. If more than one document is
open in SolidWorks, the top-most document, which is the active document, will be processed by the interface.
Notes
After opening a document in SolidWorks, if the ANSYS 10.0 menu is not displayed in the SolidWorks menu bar,
check if ANSYS 10.0 is listed in the Available Add-Ins list box of the Add-in Manager dialog box (Tools> Add
Ins...). If it is listed but not checked, check the box in front of it and click OK. If it is not listed, try to register the
plug-in DLL (DSPlugInSWU.dll) manually. The DLL is located in the ANSYS Workbench installation folder under
the CAD Integration\SolidWorks folder. If it fails to register, re-install the SolidWorks plug-in component.
Lightweight components (marked with a feather icon in the feature tree) of a SolidWorks assembly must be set
to resolved prior to attaching into Simulation.
A SolidWorks surface model attached in Simulation may loose its associativity due to a problem in a SolidWorks
API for binding back the entities. Also there is a limitation imposed by SolidWorks in relation to geometry and
the API processing. If a sketch is revolved 180 degrees, the faces generated on either portion of the revolution
are identified as the same. However if the revolution angle is changed, they now become different faces; one
retains the original identification and the second a new one. This creates an associativity break if the angle of
revolution is modified to or from 180 degrees. If this situation arises you will need to reapply loads and/or
boundary conditions.
If a part, a component, an assembly, or a sub-assembly has one or more local coordinate systems, those coordinate
systems will get transferred into Simulation upon attaching. Once they are in Simulation, they can be modified
by updating.
Motion loads can be imported by transferring CAD attributes. See Geometry Preferences for details on setting
this preference.
Length Unit
Simulation automatically locks the length unit in the part or assembly to meters, which is the unit used internally
by SolidWorks. No adjustment of length unit is necessary or possible. The Simulation user can change the unit
system for display of Simulation data.
STEP
Simulation supports STEP as a reader up to and including version AP203 and AP214. See the release notes for
updated compatibility information.
Closed surfaces and hollow solids from an STEP file are transferred as full solids in Simulation.
Length Unit
Simulation automatically sets the length unit in the part or assembly to meters. No adjustment of length unit is
necessary or possible.
Unigraphics
Simulation supports Unigraphics (UG) NX2.0 and NX3.0 as both a reader and a plug-in. See the release notes for
updated compatibility information.
• Check the existence of the menu file UgToDSpace.men in the ...\CAD Integration\Unigraphics\startup
folder of the ANSYS Workbench product installation directory.
• Check if the UGII_CUSTOM_DIRECTORY_FILE environment variable is set and the file (default ds_cus-
tom_dirs.dat) exists. The environment variable points to this file.
• Make sure the path to the ...\CAD Integration\Unigraphics folder of the ANSYS Workbench product in-
stallation directory is listed in that file.
If any of the ANSYS 10.0 menu items do not function properly, you will need to reregister the plug-in DLL using
the provided bat file, regNX.bat or regNX1.bat and regNX2.bat, which resides in the ...\CAD Integra-
tion\Unigraphics\startup directory. Replace the /s %1 with the full path of the startup folder and put this full
path and the DLL name in a pair of double quotes, for example: regsvr32 “C:\Program Files\Ansys
Inc\v100\AISOL\CAD Integration\Unigraphics\startup\DSPlugInUGNX2U.dll” or DSPlugInUGNX1U.dll.
If you don't save the parts files upon update, the loads and supports could disappear or be applied to the wrong
entities.
UGII_BASE_DIR
UGII_ROOT_DIR
The reader will use the version of Unigraphics set by these variables when processing the attach or updates.
Parts files are saved in the format designated by the above two variables. For more information concerning these
variables, consult your Unigraphics documentation.
1. Ensure you are running “UG NX V2.0 and TcEng V9.0” or “UG NX V3.0 and TcEng V9.1.2” Base (server) and
Portal (client) installed on one machine or two different machines [client-server setting] in a two-tier
configuration.
2. Double-click on the part file in the TcEng Portal. This will open the part file in Unigraphics.
3. Attach the model into Simulation using ANSYS 10.0> Simulation or ANSYS 10.0> Workbench and
optionally perform one or more analyses.
4. Save the .dsdb file into the TcEng database using File> Save to TcEng.
You must be aware of the following limitations when using the Teamcenter Engineering database:
• Only .dsdb files can be saved in the Teamcenter Engineering database. Other ANSYS Workbench database
files like .agdb, .wbdb, and .dxdb are not supported.
• When saving the .dsdb file to the Teamcenter Engineering database, the file name cannot be more than
32 characters long including the extensions.
• The .dsdb file gets saved under a Unigraphics file data set, which implies that the .dsdb file gets saved
as the Unigraphics file name.
• The .dsdb file gets saved under the dataset of the Unigraphics file sourced in the first branch of the .dsdb
file. This may lead to a situation where, for example, a .dsdb file having 4 Unigraphics files in 4 branches
can be potentially saved under the first sourced Unigraphics file dataset in the Teamcenter Engineering
database. To make the best use of the Save to TcEng menu option, have one model per .dsdb file and
do multiple analyses on that model before saving it to the Teamcenter Engineering database.
Notes
Closed surface models from Unigraphics can only be imported to ANSYS Workbench Products through UG NX
1.0.1.2 and up.
If your Unigraphics surface model has a thickness defined and it does not get transferred to Simulation, this
could mean that you do not have a Unigraphics Scenario (Structural) license.
When you transfer Unigraphics expressions/parameters into Simulation, make sure that all feature parameter
names are unique within a part and all non-feature parameter names are unique within an assembly. The non-
feature parameters could be from one or more components of the assembly.
The non-feature parameters of a part or a component of an assembly are displayed under the Geometry branch
in Simulation version 10.0 and in DesignSpace version 7.0. When you resume a .dsdb file from a version prior to
7.0, you will need to click Update first, from the Update menu upon resuming before performing any updates
with one or more parameter changes from Simulation.
Material Properties
The Unigraphics interface will not process any temperature dependent or varying material properties. Yield and
ultimate tensile strength values will not get transferred since there are no APIs available for obtaining this data.
Length Unit
Simulation automatically sets the length unit in the part or assembly to match the unit saved in the Unigraphics
file. No adjustment of length unit is necessary or possible.
Problem Situations
A Load Transfer Error Has Occurred.
Although the Solution Failed to Solve Completely at all Time Points.
An Error Occurred Inside the SOLVER Module: Invalid Material Properties
An Error Occurred While Starting the ANSYS Solver Module
An Internal Solution Magnitude Limit Was Exceeded.
An Iterative Solver Was Used for this Analysis
Assemblies Missing Parts
CATIA V5 and IGES Surface Bodies
Illogical Reaction Results
Large Deformation Effects are Active
One or More Contact Regions May Not Be In Initial Contact
One or more contact regions using MPC formulation may have conflicts
One or More Parts May Be Underconstrained
Problems Unique to Asynchronous Solutions
Problems Using Solution
Running Norton AntiVirusTM Causes Simulation to Crash
The Correctly Licensed Product Will Not Run
The Deformation is Large Compared to the Model Bounding Box
The Initial Time Increment May Be Too Large for This Problem
The License Manager Server Is Down
The Solution Combination Folder
The Solver Engine was Unable to Converge
The Solver Fills My Disk With Temporary Files
Unable to Find Requested Modes
• In a sequenced simulation where the solution was able to solve for at least one of the sequence steps but
was unable to solve all the defined steps due to reasons such as non-convergence or the user choosing
the Stop button.
• In a thermal transient simulation where the model was able to solve at least one time point and write
results to the result file.
If such a condition occurs, any applicable results in the tree that you request will be calculated (that is, they are
defined at a sequence number or time that has been solved). These results will be assigned a green check state
(up to date) but the solution itself will still be in an obsolete state because it is not fully complete. Use the Eval-
uate Results right mouse button option on a Solution object or a result object in order to additionally postprocess
the partial solution.
Material Definition
Check the Details View for each part to see that you selected the correct material for each part. Go to the Engin-
eering Data to edit and check your material files and data and to verify the material definitions (including numbers
and units). Note that, depending on the type of result, you will have a minimum of properties to be set.
Thermal Results:
Thermal conductivity is required. Can be constant or temperature-dependent.
For all materials in an electromagnetic simulation, one of the following four conditions must be met. These
conditions are mutually exclusive of each other so only one condition can exist at a time for a material.
• Linear “Soft” Magnetic Material properties specified: Either Relative Permeability or Linear Ortho-
tropic Permeability are set.
• Linear “Hard” Magnetic Material properties specified. Only Linear “Hard” Magnetic Material property
is set.
• Nonlinear “Soft” Magnetic Material properties specified: Either only BH Curve or BH Curve and Non-
linear Orthotropic Permeability are set.
• Nonlinear “Hard” Magnetic Material properties specified: Only Demagnetization BH Curve is set.
Insufficient Memory
You may not have enough virtual memory assigned to your system. To increase the allocation of virtual memory
(total paging file size), go to Settings> Control Panel> System (on your Windows Start Menu). Click the Advanced
tab and then click Performance Options. Increase the size of your virtual memory.
Another scenario that includes the following conditions can also prompt this message:
If the above conditions are met and you receive this message, do one of the following:
By default, the program will either choose a direct or iterative solver based on analysis type and geometric
properties. (In general, thin models perform better with a direct solver while bulky models perform better with
an iterative solver.) However, sometimes the iterative solver is chosen when the direct solver would have performed
better. In such cases, you may want to force the use of the direct solver. You may specify the solver type in the
Details View of the Solution folder.
4
Section : Problem Situations
Reason
It is unclear or ambiguous as to which reaction should be attributed to which support, load, or contact item.
Refer to this Note for details.
The user is responsible for determining if any nodal rotation at the support is significant enough to cause undesired
results.
The following is a list of supports which only fix the movement of a node partially and thus are susceptible to
large deformation effects:
• Frictionless Support
• Displacement
• Cylindrical support
In addition a Compression Only Support may be susceptible to large deformation effects because if large sliding
occurs, the surface can literally "slide off" the compression only support.
• This message is expected if a contact pair is meant to be initially open and may become closed after the
load application.
• If initial contact was desired and the contact pair has a significant geometric gap, setting the Pinball Ra-
dius manually to a sufficiently large value may be required.
• If shell edge contact is involved and the Search Direction is set to Target Normal, setting the direction
to Inside Pinball may be required depending on the geometry configuration.
• If symmetric contact is active, it is possible that one pair may be initially open and its symmetric pair be
initially in contact. Check the solution output to confirm this.
One or more contact regions using MPC formulation may have conflicts
... With applied boundary conditions or other contact regions. Refer to
Troubleshooting in the Help System for more details.
During solution it was found that one or more contact pairs using MPC (multi point constraint) contact formulation
overlaps with another contact region or boundary condition. Due to the fact that MPC formulation can cause
over constraint if applied to the same nodes more than once, the program may have not been able to completely
bond the desired entities together. You may check the solution output located in the Worksheet tab of a Solution
Information object to determine which pairs and nodes are affected by this condition. Specifically this can
happen when:
• A contact pair entity (either an edge or surface) also has a Dirichlet (prescribed displacement/temperature)
boundary condition applied to it. In this case the MPC constraints will not be created at nodes that have
prescribed conditions thus possibly causing parts to lose contact. Sometimes this warning may be disreg-
arded in cases such as a large surface with a fixed support at one edge and a contact pair on another. If
it is determined that overlap does indeed exist, consider relocating the applied support or using a formu-
lation other than MPC.
• Two MPC contact pairs share topology (such as a surface or an edge). Again it is possible for one or both
of these pairs to lose contact. This message may especially occur when edge/face contact is automatically
generated by the program because often 2 complementary contact pairs (that is, edge part 1/face part 2
and edge part 2/face part 1) are created. Often in this case the message can be ignored after verifying
result correctness and if necessary, deleting/suppressing one of the inverse pairs. This condition may also
occur when 1 part (typically a shell), is being contacted by 2 or more parts in the same spatial region. In
this case it is possible for one or more of the parts to lose contact. Consider reducing the Pinball Radius
to avoid overlap or changing one or more of the regions in question to use a contact formulation other
than MPC.
6
Section : Problem Situations
• It may sometimes be necessary for you to enter the full path to the ANSYS executable file in the Solve
Command field of the Solution object.
• It may sometimes be necessary for you to enter the full path to the UNIX working directory in the UNIX
Working Directory field of the Solution object (under Process Settings). Common shortcuts like ~/ may
not work on some systems.
• The LSF administrator should configure the Workbench job server to disallow multiple, simultaneous jobs.
Two solves running on the same server will interfere with each other, preventing successful completion
of each.
• To help in debugging ANSYS startup problems on the remote machine, it is sometimes useful for you to
insert a Solution Information object under the Solution object in the Simulation tree. The Solution In-
formation object will show the contents of the solve.out file that the remote ANSYS produced, if the
executable was able to start.
• When using the Stop Solution option to stop a solve running on a UNIX machine, it is possible that the
ANSYS executable file will continue to run on that machine even though the Simulation session thinks it
has stopped. If this happens and you don't want the solve job to continue on the UNIX machine it will be
necessary for you to kill the process manually. The ability to solve to two different UNIX machines simul-
taneously is not allowed.
• The solve command may have failed to execute on the remote UNIX server. Verify the command's spelling
and/or path. Solve commands are issued to the remote server using the rexec interface. Failures may occur
if the resulting path ($path) is insufficient. $path can be verified by issuing rexec on the command prompt
on the local machine. For example:
The machinename and username match the entries in the Process Settings for the Solution folder, and
diagnosticsfile corresponds to the recipient on the local machine for the command output.
Note — After issuing rexec, if you receive the following message, rexec isn't enabled on the remote
UNIX server. This feature must be enabled on the remote UNIX server in order for the solution to
proceed.
> rexec:connect:Connection refused
rexec: can't establish connection
If the path to the solve command is unavailable on the remote server, it can be added to user or system-
wide files that initialize the startup shell (for example, .cshrc or /etc/csh.login on C-shells). Consult the
UNIX server's rexec interface and appropriate shell manual pages for details.
• If you cannot make ASCII transfers to a UNIX server, changes need to be made on the server. Asynchronous
solutions on a remote UNIX server use file transfer protocol (ftp). Therefore, the system administrator must
install ftp and enable it. Ftp uses ASCII transfer mode to convert PC text to UNIX text. If ASCII mode is dis-
abled, it is not obvious because error messages do not imply this. On some ftp servers (vsftpd, for example),
by default, the server will pretend to allow ASCII mode, but in fact, will ignore the request. You will need
to ensure that the ASCII upload and download options are enabled to have the server actually do ASCII
mangling on files when in ASCII mode. To enable these options, the system administrator should consult
the operating system documentation. The following vsftp.conf modification procedure is Linux platform
specific and is provided as an example only.
1. In /etc/vsftpd/vsftpd.conf, uncomment the following lines (that is, remove the # at the beginning
of these lines):
ascii_upload_enable=YES
ascii_download_enable=YES
2. Restart the server.
You can verify the environment quickly by looking at the icons adjacent to each environment item in the Tree
Outline. A green check indicates that the requirements are met. A indicates that the requirements were
not met.
• Set the variable DSMESH DEFEATUREPERCENT to 1e-5. To set variables, click Tools> Variable Manager.
• If that fails, change the setting to 1e-6.
If the geometry that is notated looks valid, but is small compared to the rest of the model, adjusting the Sizing
Control may correct the problem.
8
Section : Problem Situations
This situation can occur if you install DesignSpace before creating your license file. In this case, DesignSpace will
run only in read-only mode. When you create your license file later, you must choose a license under ANSYS
Product Launcher in the Start menu. Once there, select the product that you have licensed to reset the default
to the correct product. Otherwise, DesignSpace will continue to run in read-only mode.
This situation can also occur if you upgrade your license to a higher DesignSpace product. Again, you must
choose a license under ANSYS Product Launcher in the Start menu. Then reset to the appropriate product.
Otherwise, DesignSpace will continue to run as the lower, previously-licensed product.
The Initial Time Increment May Be Too Large for This Problem
... Check results carefully. Refer to Troubleshooting in the Help System for more
details.
This message will appear if the program determines that the initial time increment used in the thermal transient
analysis may be too large based on the "Fourier modulus" (Fo). This dimensionless quantity can be used as a
guideline to define a conservative time step based on thermal material properties and element sizes. It is defined
as:
Fo = k (∆t) / ρ c (lengthe )
2
where:
Specifically this warning will be issued if the program finds that the Fourier modulus is greater than 100, that is,
Fo > 100. Stated in terms of the initial time step (ITS), this warning appears when the ITS is 100 times greater
than the time step suggested by the Fourier modulus in the form expressed below:
∆t = lengthe2 / (k / (c ρ))
This check is done on a per body basis and the results are echoed in the ANSYS output listing. For example:
********* Initial Time Increment Check And Fourier Modulus *********
Specified Initial Time Increment: .75
Estimated Increment Needed, le*le/alpha, Body 1: 0.255118
Estimated Increment Needed, le*le/alpha, Body 2: 1.30416
Estimated Increment Needed, le*le/alpha, Body 3: 0.158196
Estimated Increment Needed, le*le/alpha, Body 4: 0.364406
If this warning is issued make sure that the specified time step sizes are sufficiently fine to ac curately capture
the transient phenomenon. The proper use of this guideline depends on the type of problem being solved and
on accuracy expectations.
Resolution
When this error message appears, start the license manager on the other machines designated as license servers.
If you get this message and determine that the license manager is still running, and you are running in a one-
server environment, then the IP address of the license server machine was changed while the application
(DesignSpace) was running (this is usually caused by connecting to or disconnecting from an Internet Service
Provider (ISP) that dynamically allocates IP addresses). To correct this situation, you must return the IP address
to the same address that the license server had when DesignSpace was started. If the IP address changes after
you start DesignSpace (either because you connected to or disconnected from your ISP), you can correct the
error by restarting DesignSpace. You should not need to restart the license manager.
You can avoid this problem by remaining connected to or disconnected from the ISP the entire time you are
running the application.
10
Section : Problem Situations
Recommendations
• When Advanced Contact is NOT Present in the Model ...
Check for sufficient supports to prevent rigid body motion (structural) or check for thermal material curves
or convection curves which rise and/or fall sharply over the temperature range (thermal).
• When Advanced Contact IS Present in the Model ...
1. Check for sufficient supports to prevent rigid body motion or that contact with other parts will prevent
rigid motion.
2. Check that the loading is of a reasonable nature. Unlike linear problems whose results will scale linearly
with the loading, advanced contact is nonlinear and convergence problems may arise if the loading
is too big or small in a real world setting.
3. If the contact type is frictionless, try setting the type to rough. This may help some problems to
converge if any possible sliding is not constrained.
4. Check that the mesh is sufficiently fine on surfaces that may be in contact. Too coarse a mesh may
cause inaccurate answers and convergence difficulties.
5. Consider softening the normal contact stiffness KN to a value of .1. The default value is 1 and may
be changed by setting the Normal Stiffness. Smaller KN multipliers will allow more contact penet-
ration which may cause inaccuracies but may allow problems to converge that would not otherwise.
6. If symmetric contact is being used (by default the contact is symmetric), consider using asymmetric
contact pairs. This may help problems that experience oscillating convergence patterns due to contact
chattering. The program can be directed to automatically use asymmetric contact in the Details view
of the Contact Folder.
If this message occurs in a buckling analysis, verify that the loading is in the correct direction (that is, compressive)
and that the structure is well constrained so that no rigid body motion can occur. If the applied boundary condi-
tions appear to be correct, it is likely that a buckling failure will not occur.
General Errors
The following is a list of the more common CAD errors and their cause. Other errors may occur. If the meaning
of any error is unclear, please respond through TECS.
12
Section : CAD Related Troubleshooting
ACIS
Error Message Cause of Error
Unable to initialize (ACIS or Parasolid) libraries. Current file structure has missing or erroneous elements.
File does not exist. Entered file does not exist.
Failed to read the (ACIS or Parasolid) file. File is corrupt.
No valid bodies found in the file. Only wires or independent faces.
Autodesk Inventor
Error Message Cause of Error
Failed to get reference key. Unable to get reference data from Autodesk Inventor. Not a
fatal error. The attach process continues, but an associative
relation during update cannot be guaranteed.
Attach failed. Attach aborted.
CATIA
Error Message Cause of Error
System Error Current file structure has missing or erroneous elements.
File is not a CATIA export file Simulation can import only CATIA export type files, the
entered file is not of that type.
Mechanical Desktop
Error Message Cause of Error
Mechanical Desktop must be set in Model Mode. Plug-in is operable only when Mechanical Desktop is in
model mode.
An error occurred accessing the Mechanical Desktop data- Query of Mechanical Desktop returned error message.
base.
An error occurred getting the DWG file name. Query of Mechanical Desktop for the name of the drawing
returned error.
Look for later releases to handle sheets. User attempted to attach a sheet model from Mechanical
Desktop (not supported).
Unable to add database attribute to Mechanical Desktop. Plug-in was unsuccessful in adding associative attribute to
Mechanical Desktop database.
Subentity error: part may need to be converted to solid. Likely an imported model that needs to be converted to a
solid model. To see how, see the ANSYS Workbench Mechan-
ical Desktop plug-in documentation.
Pro/ENGINEER
Error Message Cause of Error
Cannot activate different model with same name as model User is attempting to activate a model of same name and
in session. different path for Simulation attach
Unable to add required information to config.pro file. During installation, if unable to write data to config.pro file.
This will indicate that the plug-in will not be operational after
install is over. The ANSYS 10.0 Menu will not appear in
Pro/ENGINEER if the config.pro file does not contain the re-
quired information.
Parasolid
Error Message Cause of Error
Schema access error. Probably saved model in later version of Parasolid or schema
directory is missing.
Solid Edge
Error Message Cause of Error
Workbench Plug-In disabled. Plug-in has been disabled and unable to be used for attach
process.
SolidWorks
Error Message Cause of Error
Rebuild of Part Failed. Regeneration failed on update with parameter changes.
Unigraphics
Error Message Cause of Error
Could not lock Unigraphics. Unigraphics is already locked by some other process
Could not unlock Unigraphics. If the Simulation process did not successfully lock Unigraphics,
this unlock error is also likely to be displayed as it does not
have the right to unlock Unigraphics.
Context Menu Provides a short list of options applicable to a specific object or window. To view
a context menu, click the right mouse button on an object or in a window.
Context Toolbar A toolbar containing options appropriate for the current level in the Section :
Tree Outline.
Details View Provides information on the highlighted object in the Section : Tree Outline.
Displacement A vector quantity used to measure the movement of a point from one location
to another. The basic unit for displacement is (Length).
Drag Moving an on-screen object in the Section : Tree Outline from one location to
another using the mouse cursor while holding down the left button. The drag is
interpreted as “move” if the object is dragged from the outline and “copy” if the
object is dragged from the outline while holding down the Ctrl key
Edge A selectable entity on a part that occurs at the intersection of two surfaces. In a
surface model, an edge can also exist on the edge of one surface.
Elastic Strain Normal elastic strain is a measure of the elongation or contraction of a hypothet-
ical line segment inside a body per unit length. Normal elastic strain is dimension-
less, however in practice it is common to assign normal elastic strain the basic
unit of (Length / Length). Shear elastic strain is a measure of the change in angle
that occurs between two initially perpendicular hypothetical line segment inside
a body. The basic unit for shear elastic strain is radians.
Factor of Safety Factor of safety is defined as the ratio of the limit strength of a material to the
maximum stress predicted for the design. This definition of factor of safety as-
sumes that the applied load is linearly related to stress (an assumption implicit
in all calculations performed in the application). A factor of safety of less than
one generally predicts failure of the design; in practice a factor of safety of one
or greater is required to help avoid the potential for failure.
FEA Finite Element Analysis. A robust and mature technique for approximating the
physical behavior of a complex system by representing the system as a large
number of simple interrelated building blocks called elements.
Fundamental Frequencies The fundamental frequencies are the frequencies at which a structure under free
vibration will vibrate into its fundamental mode shapes. The fundamental fre-
quencies are measured in Hertz (cycles per second).
Heat Flux A measure of heat flow per unit area. The basic unit for heat flux is (Heat /
Length*Length).
Margin of Safety Margin of safety is always equal to the factor of safety minus one.
Multiple Select Select more than one surface, edge or vertex by holding the Ctrl key.
Object A set of information displayed visually as an icon (usually in the Section : Tree
Outline).
Reference Temperature The reference temperature defines the temperature at which strain in the design
does not result from thermal expansion or contraction. For many situations, ref-
erence temperature is adequately defined as room temperature. Define reference
temperature in the properties of an environment or as a property of a material.
A material reference temperature overrides an environment reference temperat-
ure.
Right-Hand Rule The right-hand rule is a convenient method for determining the sense of a rotation
defined by a vector: close your right hand and extend your thumb in the direction
of the vector defining the rotation. Your fingers will indicate the sense or direction
of the rotation. The direction in which your fingers curl is the positive direction.
Rigid Body Motion Might occur when the part is free to translate or rotate in one or more directions.
For example, a body floating in space is free to move in the X-, Y-, and Z-directions
and to rotate about the X-, Y-, and Z-directions.
Stress A measure of the internal forces inside a body. The basic unit for stress is (Force
/ Length*Length).
Surface A selectable area on a part bordered on all sides by edges. Periodic, non-
boundary edged surfaces (like spheres) may occasionally appear.
Temperature A scalar quantity used to measure the relative hotness or coldness of a point
from one location to another. The basic units for temperature are degrees
Fahrenheit or Celsius.
Vertex A selectable entity on a part that occurs at the intersection of two or more edges.
World Coordinate System The fixed global Cartesian (X, Y, Z) coordinate system defined for a part by the
CAD system.
• 10-node tetrahedrals
• 20-node hexahedrals
• 13-node pyramids
• 15-node wedge elements
• 4-node quadrilateral shells
• 3-node triangle shells
While the corresponding meshing algorithms originated from the meshing capabilities present in the ANSYS
family of products, over time these algorithms have diverged from those in ANSYS Prep7. The divergence was
due to the different focus of the Simulation product, which was previously concerned with linear elastic materials,
linear modal, linear buckling, and steady-state heat transfer analyses. The ANSYS Workbench and its mesher are
now being transitioned to support the full ANSYS general-purpose, finite element code that supports all levels
of the multiphysics disciplines. The Shape Checking option found in the Advanced meshing control allows the
user to set the level of shape checking the ANSYS Workbench will perform in generating the mesh. This does
not mean that elements generated by the default value of the Shape Checking control's Standard setting
cannot be used to solve other idealizations. However, it does mean the default setting of the Shape Checking
control will produce meshes for the ANSYS Workbench that easily pass the requirements necessary to fulfill the
early DesignSpace product mission.
The default shape checking acceptance criterion that is used by the ANSYS Workbench was produced by an ex-
tensive and thorough study that correlated different element shape metrics to the quality of the solution achieved
with a distorted mesh. The ANSYS Workbench shape parameters included many that the ANSYS Prep7 program
uses in the shape-checking (SHPP command) portion of the meshing code. The study concluded that the ANSYS
program, which supports many different types element formulations (such as p-elements), must enforce stricter
shape parameter values than the ANSYS Workbench, which only needed to support the solid and shell elements
for the aforementioned analyses. One particular shape metric predicted whether the quality of the element
would affect the numerical solution time and again. This metric was the calculation of the Jacobian ratio at the
integration points of the element. At a certain level of the Jacobian ratio, we determined that the element solution
would degrade and give results that would produce an unacceptable result. While many other shape metrics
are used for the generation of the mesh in the ANSYS Workbench, the Jacobian ratio is the primary metric used
to determine the acceptability of the mesh.
When elements are imported into the ANSYS environment, the shape checking command is turned off. This is
done for two reasons:
1. The elements have already undergone extensive shape checking in the Workbench product
2. As stated previously, the ANSYS environment requires different and much more conservative criteria for
a few element shapes and a few idealizations. However, in the vast majority of cases the metrics used in
the ANSYS Workbench are valid.
The major difference is that ANSYS requires that the Jacobian ratio be valid at the corner nodes of the elements
(this is to support the p-element technology). The Aggressive setting of the Shape Checking control will check
the Jacobian ratios at the nodes.
The ANSYS Workbench's quality acceptance plan includes solving hundreds of problems where the numerical
solution is known. The solution produced by the ANSYS Workbench is compared to the analytical or test solution
of the model. Besides these engineering tests, the meshing process is tested against over a thousand user
models. These models are set up to seek out errors related to element distortion.
We feel that the current ANSYS Workbench shape metric will produce results that are minimally affected by errors
due to element distortions for linear static, modal, and transient analysis. It is suggested that the Shape Checking
control's Aggressive setting be used if the mesh is intended for large deformation or material nonlinear analysis
inside the ANSYS environment.
• Material Data
• Load Data
Introduction
Engineering Data provides access and storage for most of the information or data that is independent of your
model's geometry. This data falls into two general classes:
• Material properties will include Young's Modulus, Poisson's Ratio, and other material-specific data. You
use the Engineering Data feature to create, modify, and maintain external libraries of this information.
You can access these libraries during your analysis, or during other ANSYS Workbench analyses.
• Load data includes thermal load histories (load versus time) and convection data (convection coefficient
versus temperature).
Like other ANSYS Workbench applications, Engineering Data is accessed via a tab along the top of the user interface
and displays independently as a separate control panel, and provides navigation tools and specifications areas
to input and store your data. All material and load history information associated with a project resides in and
can be accessed from the Engineering Data tab.
• Creating and Maintaining Engineering Data Libraries - You can use this application to create a library
made up of the material properties and load data that you use most often.
• Assigning Engineering Data During Analysis - You can select and assign stored material and load data
to your model during an analysis. You can also review and modify the data used in a project.
Menu Bar
The Engineering Data menu bar provides the following functions.
Toolbar
The Engineering Data toolbar provides the following operational features.
Button Description
New A drop-down menu that allows you to create a new Material, Convection, or Load History into
the Project Tree. You must then enter the engineering data for the new Material, Convection, or
Load History.
Import A drop-down menu that allows you to import Materials, Convections, or Load Histories from the
Engineering Data source.
Export Drop-down menu that allows you to select materials, convections, or load histories and “write
them out” to an external library file in an .xml format. It does not change the current project or
library and is typically used to create libraries from existing project data. If an existing library file
is opened and modified, selected items can either be appended to the library or the library file
can be overwritten and replaced.
Close Curve Closes the tabular data and graph for a material property and returns to the material summary
Data View. Only available for material properties that have tabular data.
Note — Engineering Data database files and Workbench projects are linked. Engineering data saves
automatically to a file based on the project's name (<Project Name>.eddb) when the Workbench project
(.wbdb) is saved. Opening a project automatically retrieves engineering data information from the cor-
responding .eddb file.
Selecting any folder in the project tree (Project, Materials, Convections, or Load Histories) displays the mater-
ials and/or load data associated with the project and the location of their source files.
A state icon is displayed next to the name of the materials ( ), convections ( ) and, load histories
( ) that indicates the state of the engineering data. There are three possible states indicated:
Materials, Convections and Load Histories in the project tree may display a link icon next to the state icon.
This link indicates that the data is saved on hard disk space. If engineering data is not synchronized the link icon
appears as broken, as illustrated above. This state indicates that the data in use does not match the data on the
source disk space. You may reload the original data by using the context menu (right-click) option Update From
Source.
The Add/Remove Properties option displays a dialog box that allows you to add and/or remove material
properties.
The Close Curve button closes the tabular display and returns you to the property display.
Note — You can also highlight the Materials folder, the Convections folder, or the Load Histories
folder in the Project Tree, right-click the mouse, and then select the Import option on the menu
to display the associated import dialog box.
3. Select the appropriate Material or Convection data or Load History library to import from the Data
Source field. A list of materials, convections or load histories available in the selected library file displays
in the bottom half of the dialog box. You can Add or Remove source files from the list as desired.
Note — Three types of sources are supported: Library files, ANSYS CDB files, and folders containing
.xml files developed prior to ANSYS 9.0.
4. Select the appropriate Material or Convection data, or Load History library to import from the dialog
box.
5. Click OK. A list of materials, convections, or load histories available in the selected library file is displayed
in the bottom half of the import dialog.
6. Choose the engineering data that you want to use in the project. Clicking OK adds the newly selected
engineering data to the project tree.
Task Actions
Append all engineering data to 1. Display the Export drop-down list and select All Engineering Data to an
an existing library Existing Library to append all Project Tree data.
2. An Open dialog box displays. Select a folder location for the library and name
the new file.
3. Click OK. The materials, convections and load histories are appended to the
existing library file.
Export selected engineering data 1. Select any combination of individual data items or folders such as the Materials
folder and the convection Stagnate Air. Use the Shift or Ctrl keys to highlight
multiple folders and/or individual data items. Display the Export drop-down
list and choose Selected Engineering Data to a Library.
2. A Save As dialog box displays. Select a folder location for the library and name
the new file.
3. Click OK. The materials, convections, or load histories are saved to a new library
.xml file.
Append selected engineering 1. Highlight the individual materials, convections, or load histories of interest.
data Use the Shift or Ctrl keys to highlight multiple folders and/or individual data
items
2. Display the Export drop-down list and choose Selected Engg Data to an
Existing Library.
3. An Open dialog box displays. Select a folder location for the library and select
an existing library file.
4. Click OK. The materials, convections and load histories are appended to the
existing library file.
Task Actions
Export engineering data 1. Select any combination of individual data items or folders in the project tree,
such as the Materials folder and the convection Stagnate Air.
2. Right-click the mouse, and select Export.
3. A Save As dialog box displays. Select a folder location for the library and name
the new file.
4. Click OK. The materials or convections are saved to a new library .xml file.
To change the Unit System, make a new selection in the Units menu on the menu bar.
1. In the Project Tree, highlight the material or convection that you want to make the default for new
projects.
2. Right-click the mouse and choose Default for New Projects from the menu.
Note — Only one material and one convection may be set as the default.
You can also mark a set of materials or convections or load histories as favorites. Engineering data items marked
as favorites are the first data source in the Import dialog box, enabling quick selection of often used data. To
mark items as favorites:
1. Display the project folder and highlight the material(s), convection(s), and/or load histories that you
want to be available in all projects.
2. Right-click the mouse and choose Include as Favorite.
Note — These changes affect all subsequent projects opened in the Workbench.
The .eddb file allows you to save project materials, convections, load history, and other pertinent project inform-
ation. It provides a means to archive the engineering data used in a project. Because Simulation and DesignXplorer
databases utilize engineering data, material and load information is also stored in the Simulation database file
(.dsdb).
Engineering data parameters are also saved in the .eddb file. You can retrieve these parameters by first saving,
then resuming the .wbdb file. Simulation creates material parameters only in legacy .dsdb files (version 8.1 and
earlier).
Note — You can export engineering data to a library file for future use.
Caution: Because this file is updated automatically, you do not access the .eddb file directly.
Or...
b. Click the New button and then select Material.
3. A New Material entry displays in the Project Tree. Rename the new material.
4. A list of common properties with zero values is shown in the property view. You will need to enter values
for the displayed properties. You can also add and/or remove properties from the default list. In addition,
you can select further classifications for material properties using the Add/Remove Properties option.
See Section : Supported Material Properties for more information about material properties.
All current properties have a check mark beside the property name.
Each property is preceded by a check box that you can select or unselect to add or remove properties from a list
of supported properties. When you are finished making selections, click the OK button to add or remove the
properties from the summary view. Click Cancel if you did not add or delete properties.
View Options
In addition, there are two ways to view the material properties.
1. Select the Organizational Structure radio button (as shown above) to view material properties in a tree
structure of three main material categories: Structural, Thermal, and Electromagnetics. This also
provides further classification of the properties within the individual categories.
2. Select the Alphabetic List radio button to display a list of all available material properties in alphabetical
order.
A Filter is also available on the Add or Remove Properties dialog box. This field allows you to filter all of the
available properties by the spelling of the property names.
You can also parameterize properties for later use in DesignXplorer from the summary view by selecting the box
to the left of the property name. Parameterization is indicated with a P as shown here:
Properties with an associated graph icon contain tabular data. Properties with the graph icon also have a corres-
ponding graph thumbnail in the right portion of the view. Clicking the icon or the thumbnail graph replaces the
content of the view with an enlarged graph and a table that you may use to edit the tabular values of the property.
To return to the summary view, click the Close Curve button.
Like constant properties, you can parameterize temperature-dependent and nonlinear properties by selecting
the box to the left of the property name. In DesignXplorer, you will see two parameters, a scale factor and an
offset value for each property . You can parameterize one or both of these values. The scale value varies the
curve by multiplying the y-axis value of each point on the curve. The offset adds or subtracts to/from a y-axis
value for each point on the curve. Thus, the equation for varying the property value is:
If an invalid property value exists, the corresponding property field is highlighted in yellow, such as a negative
Young's Modulus, and the validation icon beside the material in the Project Tree also changes.
Parameterization Notes:
• DX-VT supports only Young’s Modulus, density, and Poisson’s Ratio for parameterization.
• DS parameter manager supports all constant properties for parameterization.
• DX-DOE supports the parameterization of all properties including tabular and nonlinear properties.
• If a Multilinear Isotropic Hardening (MISO) stress-strain curve is used for a material, then Young's Modulus
cannot be parameterized.
Suppress/Unsuppress Properties
Items in the property list can be suppressed. Suppression allows you to define a property but not include it in a
simulation. Suppressed property names are shown with a “strikethrough” through the property name, as shown
here.
Only defined, unsuppressed properties are sent to simulation for use during analysis.
To suppress a property, place your cursor over the property, right-click, and select Suppress.
Perform the same steps and select Unsuppress to reverse the action.
Any property of a material can be suppressed. However, some properties are mutually exclusive and the selection
of one of these properties automatically suppresses the other, mutually exclusive, property. For example, defining
bilinear isotropic hardening plasticity and multilinear isotropic hardening plasticity for the same material represents
redundant plasticity behavior. Only one behavior can be active for the material. When such conflict occurs, the
last defined property is used and the previously defined, conflicting properties are automatically suppressed.
The properties that are mutually exclusive include the following:
Materials:
• Air
• Aluminum Alloy
• Concrete
• Copper Alloy
• Gray Cast Iron
• Magnesium Alloy
• Polyethylene
• Stainless Steel
• Structural Steel
• Titanium Alloy
• Neoprene Rubber
• hymu49
• Ingot iron, annealed
• M14 Steel
• M19 Steel
• M2 Steel
• M22 Steel
• M27 Steel
• M3 Steel
• M4 Steel
• M43 Steel
• M47 Steel
• M50 Steel
• M54 Steel
• M6 Steel
• Moly permalloy
• Monel Annealed
• Mu metal
• Nodular Cast Iron
• Pure Iron Annealed
• Pure Nickel Annealed
• SA1008
• SA1010
• SA1020
• Sintered material 80HP
• SS416
• Supermendure
In addition, you can derive coefficients from supplied test data for your materials so that you can select the most
closely matched material model for a solution using the Material Curve Fitting feature.
• If the material is isotropic: You must enter Young's modulus and Poisson's ratio. There are no default values
for either property. Poisson's ratio should not be equal to or greater than 0.5.
• If the material is orthotropic: Nine property values (Young’s Modulus in the X, Y, and Z directions, three
major Poisson’s ratios and three shear moduli) must be defined. There are no defaults. For 2D, the X and
Y related components must be entered.
Temperature Dependence
Temperature-dependent properties are input in a tabular form (value vs. temperature). Once defined, these
tabular properties are available to the elements during solution. Structural material properties are evaluated at
the integration points. If the temperature of a integration point falls below or rises above the defined temperature
range of tabular data, the solver assumes the defined extreme minimum or maximum value, respectively, for
the material property outside the defined range.
• Linear Elastic
If experimental SN data was collected at constant mean stress for individual SN curves, select the Mean
Stress option for Mean Curve Type. However, if multiple SN curves were collected at a constant r-ratio,
then select R-Ratio. R-ratio is defined as the ratio of the second loading to the first: r = L2 / L1. Typical ex-
perimental r-ratios are -1 (fully reversed), 0 (zero-based), and .1 (to ensure that a tensile stress always exists
in the part). The values of mean stress/r-ratio are only important if multiple curves are done and the SN-
Mean Stress Curves correction using experimental data option is chosen in the Fatigue Tool.
• Strain-Life Parameters
• Stress Limits
• Tensile Yield Strength
6
Section : Supported Material Properties
– Plasticity
→ Bilinear Isotropic Hardening: This material model is often used in large strain analyses. A Bilinear
Stress-Strain (BISO) curve requires that you input the Yield Strength and Tangent Modulus. The
slope of the first segment in a BISO curve is equivalent to the Young's modulus of the material
while the slope of the second segment is the tangent modulus.
→ Multilinear Isotropic Hardening: This material model is often used in large strain analyses. Do
not use this model for cyclic or highly nonproportional load histories in small-strain analyses.
Data must be supplied in the form of Plastic Strain vs. Stress. The first point specified must have
zero (0) plastic strain and the yield.
The slopes of all segments must be less than or equal to the Young's Modulus. No segment can
have a slope of less than zero. Workbench performs checks to ensure that these criteria are met.
Hyperelasticity can be used to analyze rubber-like materials (elastomers) that undergo large strains
and displacements, as shown below, with small volume changes (nearly incompressible materials).
Large strain theory is required [NLGEOM,ON].
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
The material response in ANSYS hyperelastic models is always assumed to be isotropic and isothermal.
The hyperelastic materials are also assumed to be nearly or purely incompressible. Material thermal
expansion is also assumed to be isotropic.
The following hyperelastic material models are supported. Data can be input in the form of test data
and the coefficients calculated via a Material Curve Fit or the coefficients can be directly input.
→ Mooney-Rivlin
8
Section : Supported Material Properties
• Mooney-Rivlin 2 Parameter
• Mooney-Rivlin 3 Parameter
• Mooney-Rivlin 5 Parameter
• Mooney-Rivlin 9 Parameter
→ Neo-Hookean
→ Polynomial 1st order
→ Polynomial 2nd order
→ Polynomial 3rd order
→ Yeoh 1st order
→ Yeoh 2nd order
→ Yeoh 3rd order
→ Ogden 1st Order
→ Ogden 2nd Order
→ Ogden 3rd Order
Please see the next section for additional information about Hyperelastic Material Models.
– Uniaxial test
– Biaxial test
– Shear test
– Volumetric test
Engineering Data allows you to directly input the engineering stress/engineering strain data as properties
of the material.
Once the test data is input, the Fit to Test Data button is used to perform a curve fit of the test data and
compute the coefficients for the chosen material model. The resultant graph shows the test data points
superimposed on the fitted curves to show the degree of accuracy of the curve fit. If you know the coeffi-
cient values then you may input them directly in the corresponding material model. Make sure that you
set Engineering Data’s Unit System to the units in which the constants were derived.
Mooney-Rivlin
• Mooney-Rivlin 2 Parameter
Input values for Material Constant C10, Material Constant C01, and Incompressibility Parameter D1
as defined by the following form of the strain energy potential, W:
1
W = c10 ( I1 − 3) + c01( I 2 − 3) + (J − 1)2
d
where:
10
Section : Supported Material Properties
µ = 2(c10 + c01)
K = 2/d
where:
d = (1-2*ν)/(c10 + c01)
• Mooney-Rivlin 3 Parameter
Input values for Material Constant C10, Material Constant C01, Material Constant C11, and Incom-
pressibility Parameter D1 as defined by the following form of the strain energy potential, W:
1
W = c10 ( I1 − 3) + c01( I 2 − 3) + c11( I1 − 3)( I 2 − 3) + (J − 1)2
d
where:
c10, c01, c11 = material constants characterizing the deviatoric deformation of the material.
d = material incompressibility parameter.
• Mooney-Rivlin 5 Parameter
Input values for Material Constant C10, Material Constant C01, Material Constant C20, Material
Constant C11, Material Constant C02, and Incompressibility Parameter D1 as defined by the following
form of the strain energy potential, W:
W = c10 ( I1 − 3) + c01( I 2 − 3) + c20 ( I1 − 3)2
1
+c11( I1 − 3)( I 2 − 3) + c02 ( I1 − 3)2 + (J − 1)2
d
where:
c10, c01, c20, c11, c02 = material constants characterizing the deviatoric deformation of the material.
d = material incompressibility parameter.
• Mooney-Rivlin 9 Parameter
Input values for Material Constant C10, Material Constant C01, Material Constant C20, Material
Constant C11, Material Constant C02, Material Constant C30, Material Constant C21, Material Con-
stant C12, Material Constant C03, and Incompressibility Parameter D1 as defined by the following
form of the strain energy potential, W:
W = c10 ( I1 − 3) + c01( I 2 − 3) + c20 ( I1 − 3)2
+c11( I1 − 3)( I 2 − 3) + c02 ( I 2 − 3)2 + c30 ( I 2 − 3)3
1
+c21( I1 − 3)2( I 2 − 3) + c12 ( I1 − 3)( I 2 − 3)2 + c03 ( I 2 − 3)3 + (J − 1)2
d
where:
c10, c01, c20, c11, c02, c30, c21, c12, c03 = material constants characterizing the deviatoric deformation of
the material.
d = material incompressibility parameter.
Neo-Hookean
Neo-Hookean: Input values for Initial Shear Modulus Mu and Incompressibility Parameter D1 as defined by
the following form of the strain energy potential per unit reference volume, W:
1
W = ( I1 − 3) + (J − 1)2
2 d
where:
Polynomial
• Polynomial 1st order
Input values for Material Constant C10, Material Constant C01, and Incompressibility Parameter D1
as defined by the following form of the strain energy potential, W:
N N 1
W = cij ( I1 − 3)i( I 2 − 3)j + (J − 1)2k
i+ j=1 k=1 dk
Input values for Material Constant C10, Material Constant C01, Material Constant C20, Material
Constant C11, Material Constant C02, Incompressibility Parameter D1, and Incompressibility Para-
meter D2 as defined by the following form of the strain energy potential, W:
N N 1
W = cij ( I1 − 3)i( I 2 − 3)j + (J − 1)2k
i+ j=1 k=1 dk
Input values for Material Constant C10, Material Constant C01, Material Constant C20, Material
Constant C11, Material Constant C02, Material Constant C30, Material Constant C21, Material Con-
stant C12, Material Constant C03, Incompressibility Parameter D1, Incompressibility Parameter D2,
andIncompressibility Parameter D3 as defined by the following form of the strain energy potential, W:
N N 1
W = cij ( I1 − 3) ( I 2 − 3)j +
i (J − 1)2k
i+ j=1 k=1 dk
12
Section : Supported Material Properties
Yeoh
• Yeoh 1st order: Input values for Material Constant C10 and Incompressibility Parameter D1 as defined
by the following form of the
1 strain2kenergy potential, W:
W= N c ( I − 3)i + N (J − 1)
i0 1
i=1 k=1 dk
where:
N = 1.
I1 = first deviatoric strain invariant
J = determinant of the elastic deformation gradient F.
c10, d1 = material constants.
µ = 2c10
K = 2/d1
: Input values for Material Constant C10, Material Constant C20, Incompressibility Parameter D1, and
Incompressibility Parameter 1 D2 as defined by the following form of the strain energy potential, W:
W = cN ( I − 3)i
+ N (J − 1)2k
i0 1
i=1 k=1 dk
where:
N = 2.
c10, c20, d1, d2 = material constants.
: Input values for Material Constant C10, Material Constant C20, Material Constant C30, Incompress-
ibility Parameter D1, Incompressibility Parameter D2, and Incompressibility Parameter D3 as defined
by the following form of the 1 strain2kenergy potential, W:
W= N c ( I − 3)i + N (J − 1)
i0 1
i=1 k=1 dk
where:
N = 3.
c10, c20, c30, d1, d2, d3 = material constants.
Ogden
• Ogden 1st Order
Input values for Material Constant Mu1 PA, Material Constant A1, and Incompressibility Parameter
D1 as Ndefined
i by the following formNof the
1 strain2kenergy potential, W:
W= ( i + i + i − 3) + (J − 1)
i=1 i
1 2 3
k=1 dk
where:
1
-
p (p = 1,2,3) = deviatoric principal stretches, defined as p = J 3 p
The initial
1 N shear modulus, µ, is given as:
=
2 i=1
i i
where:
N=1
µ1, α1, d1
Input values for Material Constant Mu1 PA, Material Constant Mu2 PA, Material Constant A1, Mater-
ial Constant A2, Incompressibility Parameter D1, and Incompressibility Parameter D2 as defined by
the following
N form of the strain energy
N 1potential, W:
W= i (i + i + i − 3) + (J − 1)2k
i=1 i
1 2 3
k=1 dk
where:
N=2
14
Section : Supported Material Properties
: Input values for Material Constant Mu1 PA, Material Constant Mu2 PA, Material Constant Mu3 PA,
Material Constant A1, Material Constant A2, Material Constant A3, Incompressibility Parameter D1,
Incompressibility Parameter D2, and Incompressibility Parameter D3 as defined by the following
form ofN the
i strain energy potential,N W:1
W= (i + i + i − 3) + (J − 1)2k
i=1 i
1 2 3
k=1 dk
where:
N=3
Temperature Dependence
Temperature-dependent properties are input in a tabular form (value vs. temperature). Once defined, these
tabular properties are available during solution. If the temperature at a node falls below or rises above the defined
temperature range of tabular data, the solver assumes the defined extreme minimum or maximum value, re-
spectively, for the material property outside the defined range.
• Steady state: You must enter a Thermal Conductivity value (either constant or temperature dependent).
• Transient: You must enter Thermal Conductivity, Density and Specific Heat properties. Each of these can
either be constant or temperature dependent.
directions (orthotropic), then select Linear Orthotropic Permeability and enter values for three ortho-
gonal directions (X, Y, Z). When the material is applied to a part in Simulation, you must apply a coordinate
system to the part. The material orthogonal properties will align with the coordinate system assigned to
the part. For orthogonal properties, the Y and Z values will default to the X value if not specified. An X
direction value is required.
• Linear “Hard” Magnetic Material: This classification characterizes hard magnetic materials such as per-
manent magnets. The demagnetization curve of the permanent magnet is assumed to have a constant
slope. The demagnetization curve intersects the H axis at a value corresponding to the coercive force, Hc.
The curve also intersects the B-axis at a value corresponding to the residual induction, Br. You must enter
the Coercive Force and Residual Induction values. (Use a positive value for the Coercive Force). A per-
manent magnet is polarized along an axis of the part. In Simulation, you must apply a coordinate system
to the part. Align the X-axis of the coordinate system in the direction of the North pole of the magnet.
The coordinate system may be Cartesian or cylindrical. A cylindrical system may be used for radially oriented
permanent magnets.
• Nonlinear “Soft” Magnetic Material: This classification characterizes soft materials that exhibit nonlinear
behavior between B and H. Select BH Curve to enter nonlinear B-H data. The nonlinear behavior is described
by a single B-H curve. You may create a curve by entering B and H data points in the Engineering Data,
or you may choose from a library of B-H curves for typical properties. For material exhibiting orthotropic
behavior, you may also select Nonlinear Orthotropic Permeability. You may elect to apply the B-H curve
in any one or all three orthotropic directions, and specify a constant relative permeability in the other
directions. If you use the orthotropic option, you must apply a coordinate system to the part in Simulation.
When creating B-H curves, please observe the following guidelines:
• Nonlinear “Hard” Magnetic Material: This classification characterizes hard magnetic materials such as
permanent magnets. The demagnetization curve of the permanent magnet is described by a series of B-
H data points located in the second quadrant. Select Demagnetization B-H Curve to enter this data. The
first data entry point should be at B = 0, H = -Hc. A permanent magnet is polarized along an axis of the
part. In Simulation, you must apply a coordinate system to the part. Align the X-axis of the coordinate
system in the direction of the North pole of the magnet. The coordinate system may be Cartesian, cylindrical.
A cylindrical system may be used for radially oriented permanent magnets. When creating B-H curves,
please observe the following guidelines:
• Electric: This classification defines electrical properties of materials, specifically electrical resistivity. If the
material exhibits constant properties in all directions (isotropic behavior), then select Resistivity and
enter the appropriate value. If the material exhibits different resistivity in different orthogonal directions
(orthotropic), then select Orthotropic Resistivity and enter values for three orthogonal directions (X, Y,
16
Section : Supported Material Properties
Z). When the material is applied to a part in Simulation, you must apply a coordinate system to the part.
The material orthogonal properties will align with the coordinate system assigned to the part. For ortho-
gonal properties, the Y and Z values will default to the X value if not specified. An X-direction value is re-
quired.
To perform curve fitting, you define the type(s) of test data supported for hyperelastic curve fitting, choose a
model from one of several supplied hyperelastic models, perform regression analysis, and then graphically view
and compare the curve fitting results to the experimental data. The fitted coefficients may then be used for
subsequent finite element analyses.
For hyperelastic material models, stress-strain curves can be converted to any of the following hyperelastic
models:
• Mooney-Rivlin
• Ogden
• Neo-Hookean
• Polynomial
• Yeoh
Note — Volumetric Strain equals the ratio of the current volume to that of the original volume and all
Solution data displayed for postprocessing are true stresses and logarithmic strains.
Once the data is input the material can be saved to a library and reused.
18
Section : Supported Material Properties
Note — For Ogden properties, Workbench will supply initial seed values for the Material Constants in an
effort to determine the curve fit and the calculated coefficients. You may also choose your own seed
values by entering initial values for the coefficients. It is suggested that you attempt to use seed values
based on experience if possible. An Ogden curve fit will most often converge to a local error norm min-
imum. It may take several attempts, trial seed values, to achieve the desired fit.
HINT
Use the values from a lower-order curve fit as seed values for a higher order fit. Use Ogden 1st order
curve fit values to seed an Ogden 2nd order curve fit, and Ogden 2nd order values for Ogden 3rd order
fit.
Note — The table enables you to cut or copy and paste data from spreadsheets, such as Excel.
Click the Fit to Test Data button to perform the curve fit. Your error norms can be either Normalized or Absolute.
Normalized error norms (the default regression option) generally provide better results than absolute error
norms, since normalized error norms give equal weight to all of your data points.
Once the curve-fit is complete, the graph overlays the fitted curves derived using the computed coefficients on
the test data points. This provides a visual indication of how close the fit is over the strain range of interest. You
can perform curve fit on several hyperelastic models and choose the one that best meets your needs, such as
the examples shown below.
20
Section : Supported Material Properties
22
Load Data
This section examines the role of Engineering Data when you apply loads to a simulation. Please select one of
the following links to learn more about that topic.
Convections
Load History
Convections
Convection information resides and is defined in Engineering Data. You use this information to create, modify,
and maintain libraries of convection data. As needed, Workbench applications retrieve convection information
from the libraries for use during simulation analyses. This section examines the following convection topics:
Create New Convections
ANSYS Supplied Convection Sample Library
Or...
b. Click the New button and then select Convection.
3. A New Convection entry displays in the Project Tree. Rename the new convection.
4. The right pane on the window displays property and tabular data fields. Define the Coefficient Type,
Temperature, and Convection Coefficients data.
5. Return to your simulation or create new convections, materials, or load histories.
Note — Convection loads are assigned in Simulation. However, the tabular data associated with the
convection is always modified in Engineering Data.
• Stagnant_Air_Horizontal_Cylinder_Turbulent.xml
• Stagnant_Air_Simplified_Case.xml
• Stagnant_Air_Vertical_Planes_Laminar_1.xml
• Stagnant_Air_Vertical_Planes_Laminar_2.xml
• Stagnant_Air_Vertical_Planes_Turbulent.xml.
• Stagnant_Water_Simplified_Case.xml
Load History
Load history data refers to variation of load with respect to time. This data is defined in a tabular form as TIME
versus a load parameter. Like other material and load data, Engineering Data provides an area where this data
can be input, stored, modified and used again in a modified or completely different analysis. This section examines
the following load history topics:
Create New Load Histories
Supported Load History Properties
Or...
b. Click the New button and then select Load History.
Note — You can also insert a specific type of load history, such as Temperature, Heat Flux, etc., into a
project by selecting the desired load history folder in the Project Tree and performing the above steps.
Note — Load histories are assigned in Simulation. However, the data is always modified in Engineering
Data.
• Specified temperature
• Heat flux
• Heat generation rate
• Heat flow (on a surface in 3D; on an edge in 2D)
• Film Coefficient for convection
• Ambient temperature for convection or radiation load
• Import an FE model from a NASTRAN bulk data file or ABAQUS Input file.
• Import FE information from Simulation.
• Navigate and visualize the data contained in the model.
• Create named components based on element selections.
• Generate an ANSYS, NASTRAN, or ABAQUS input deck for downstream analysis.
FE Modeler Licensing
FE Modeler capabilities are available for users with an ANSYS Professional license or above. FE Modeler capabil-
ities are also available at any license level if a CAE Templates Add-on license is purchased.
1. To open an existing FE Modeler database or to import NASTRAN or ABAQUS data, perform one of the
following:
a. From the Start Page, click the Finite Element Model icon.
b. Open an FE Modeler database, file extension .fedb, a NASTRAN bulk data file or an ABAQUS input
file.
c. Select an appropriate Unit System and click OK.
OR
Note — An existing FE Modeler database file can also be opened by double-clicking a file
from its directory location.
During import, FE Modeler dynamically builds a report summarizing the information obtained from
NASTRAN, ABAQUS, or Simulation. The report also includes a list of issues raised during the import process.
Carefully review these issues to determine their effect on the FE model.
Use the toolbar to print the report or export the document as an HTML file.
3. Define the export specifications using the Target System drop-down list on the toolbar and select one
of the following templates:
• ANSYS - Default
• ABAQUS
• NASTRAN
• Template - Customizable option for one of the above output selections.
4. Choose Generated Data from the Reports field to preview the input deck for the targeted system
constructed from the current data in the FE model. The preview prohibits text editing to maintain fidelity
between the FE model and the generated data.
5. Use the toolbar to print the preview or export the data in the form of the target system’s commands to
an .inp file.
Note — Because it is not unusual to encounter large gaps in node and element numbering in finite element
models, Generated Data, by default, compresses any such gaps when exporting to ANSYS. You can
disable the option that changes the ID's of all of nodes and elements that are sent to the target system
from FE Modeler through the Tools> Options feature. However, sending large entity numbers such as
node or element ID's may not be memory efficient in ANSYS.
Element Selection
Use the following tools to interactively select elements in the Graphics Window:
• Single Select mode (Click) - selects the element under the cursor. Hold the Ctrl key to add or remove
elements from the selection set.
• Drag - "paint selects" a group of elements by pointing, clicking and dragging the cursor over a region
adjacent elements. Note that moving the cursor quickly may cause sporadic selection due to system
processing limitations.
• Box Select mode - selects a group of elements by clicking and dragging the cursor over a region of ele-
ments. Box Select mode filters out interior and back-facing elements.
• Box Volume Select, for Elements mode - similar to Box Select mode except that all (interior and back-
facing) elements captured by the box are selected throughout the model. When defining the box, the
direction from which you drag the mouse, either left or right, from the starting point determines what
elements are selected.
• Select Nodes mode - selects one node to display its properties (Entities View only - please see the Note
shown below). Multiple nodes may be selected by holding the Ctrl key and then clicking multiple nodes.
• Select Element Faces mode - selects one element face to display its properties. Multiple element faces
may be selected by holding the Ctrl key and then clicking multiple element faces. In addition, similar to
Drag select, you may "paint select" a group of elements.
• Select Elements mode - selects one element to display its properties. Multiple elements may be selected
by holding the Ctrl key and then clicking multiple elements.
Note — Element properties are displayed only when one element is selected and in Entities View only.
The toolbar contains the following selection tools: Rotate, Pan, Zoom, Box Zoom, Zoom to Fit, Fit, Magnifier
Window, Previous View, Next View, and ISO (Set) view.
The status bar at the bottom of the model display window displays a count of the selected elements and nodes.
In addition to toolbar options, you may also use the right mouse button to quickly display selection and view
options. Place your cursor over the model and click the right mouse button. A menu displays Cursor Mode and
Fit. Selecting Cursor Mode provides the following:
These options are also available when using the Magnifier Window feature.
• Resolution - Allows you to define the quality of the image's resolution as: Normal Image Resolution,
Enhanced Image Resolution, or High Resolution.
• Print - Allows you to print the image as displayed in the Print Preview display when you are viewing a
model (entities, elements types, etc.). The Print button is active only after you have chosen the Print
Preview button.
Note — When you are viewing the content of the Import Summary or Generated Data sections,
choosing the Print button allows you to print this text content.
• Print Preview - Displays how the model will appear in print. Once you select the Print Preview button,
the Print button becomes active. To exit the Print Preview display, make a selection from the Views menu.
• Image Capture - Saves the image to a file (.png, .jpg, .tif, .bmp, .eps).
The Print Preview and Image Capture buttons are only available when you are viewing a model (entities, elements
types, etc.). If elements, faces, or nodes are selected on the model, these selection designations do not appear
in either the print preview or on the captured image.
Filtering
Filtering displays excluded elements as translucent or invisible. Interactive selection applies only to opaque
elements.
Adding Components
Sometimes it is convenient to group portions of the model to form components, and give the components re-
cognizable names, such as FLANGE, WHEEL2, FIN7.
When one or more elements have been selected, click the Component button in the toolbar. A dialog box displays
that provides a text field in which you may name a component to the FE model. The generated ANSYS input
deck includes all defined components for use in working with the data in subsequent analyses. The animation
shown below illustrates the steps to create a Component. Please take a moment to watch the entire process.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Element quality is measured in different ways. For example, measurements can be based on an element’s aspect
ratio or upon the interior angles. A quality factor is then computed for each element of a model (excluding line
and point elements). FE Modeler’s Mesh Metrics feature provides a composite quality metric that ranges between
0 and 1. This metric is based on the ratio of the volume to the edge length for a given element. A value of 1 in-
dicates a perfect cube or square while a value of 0 indicates that the element has a zero or negative volume. The
results are displayed in a bar chart that enables you to graphically evaluate the mesh.
The Mesh Metrics feature allows users to confidently import and analyze NASTRAN, ABAQUS, and Simulation
models. Once a NASTRAN, ABAQUS, or Simulation model is imported, simply select the Mesh Metrics option
under Tools. This action displays a bar chart, as illustrated in the example below, labeled with color-coded bars
for each element shape represented in the model’s mesh.
The X-axis defines composite quality and the Y-axis is the percentage of the volume of the model represented
by each bar. The graph can be filtered based on bodies (from Simulation) and element shapes.
The Y-axis represents the elements’ volumes that have a particular quality factor as a percentage of total volume.
For example, a model could have a large number of poorly shaped elements that are confined to a small local
area. The total volume of these elements might not be significant compared to the volume of the entire model.
As a result, the bar corresponding to this low quality factor may not be significant.
Note — For shell Mesh Metrics, the Y-axis displays a percentage of surface area instead of a volume per-
centage.
The bar chart is based on element shape rather than element type. In addition, 3D solids and shells are included
within the bar chart.
• Constraints
• Number of modes (to find)
• Frequency range
• Solver technique
NASTRAN: require models to have SOL equal to 103 in the executive control to display the modal options.
ABAQUS: the *FREQUENCY keyword should be defined in the input deck in order to display the modal options.
1. Import a NASTRAN bulk data deck, an ABAQUS input file, or a Simulation model into FE Modeler. FE
Modeler displays the Import Summary.
2. Select Modal Simulation under the Tools section located in the lower-left portion of the screen and
select Enable. Any modal analysis specifications associated with the imported file (ABAQUS, NASTRAN
or Simulation) are displayed.
Note — If the input file does not contain modal analysis specifications, you must select the En-
abled check box to be able to set new specifications for a modal analysis.
3. Verify the contents of the following fields. If necessary, modify the values.
• Number of Modes
• Frequency Range
• Mode Extraction Method
4. Select a Constraint Set for the modal analysis. By default, a Free-Free configuration is defined and no
constraints are written to the ANSYS input file.
• Only one constraint set can be used to generate the ANSYS input.
• For Simulation models, only one constraint set (other than Free-Free) is available.
• For ABAQUS and NASTRAN files, all constraint sets from the bulk data input are displayed in
the Constraint Sets field.
5. Select Generated Data contained in the Reports section of the screen. Modal analysis specifications
are now included.
By selecting each of these components you can visualize the nodes that are constrained in all directions, as well
as those constrained in direction 1(UX) , 2 (UY) and 3 (UZ) only. All of these values compose Constraint Set 9.
Most views include a list of items that manage the data available in the view. Selecting a subset of items in the
list filters subsequent data, graphic displays and selectable entities.
• Add or remove selections from the list by using the Ctrl key. Should you have the need to clear all selections
from a list, you must use the Ctrl key.
• Use the Shift key to select ranges within the list.
Initially, highlighted items in the list correspond to data applicable to the existing element selection. For example,
if no element selection exists the view highlights all items automatically.
Entities View
Purpose:
• Listing of element types present in the model, along with corresponding element counts.
• Visualization of element type usage in the model.
• Element selection filtered by one or more element types.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Bodies View
Notes:
• For models based on Simulation data, each Part corresponds to one body.
• For models based on NASTRAN and ABAQUS data, one and only one body exists.
Purpose:
Contacts View
Note —
Purpose:
Materials View
The purpose of the Materials View is to provide a:
The material properties associated with models in FE Modeler can be viewed and edited in Workbench's Engin-
eering Data. Engineering Data provides a centralized storage area for material data that can be shared across
other Workbench applications. The Data button on the FE Modeler toolbar provides access to Engineering Data.
When you import ABAQUS and/or NASTRAN data, you must select the same unit system as the original model
because the unit system is used to interpret material property values in Engineering Data. For example, if you
choose the MKS system, Engineering Data interprets the imported material properties in the MKS system.
Note —
• Generated Data always uses the same unit system as the imported data. Therefore, if you use FE
Modeler as a translator, the property values are the same as those of the imported file. For example,
if a source file contains a Young's Modulus of 1e7 then the Generated Data always creates a
Young's Modulus of 1e7 regardless of the unit system chosen.
• The material properties of imported models are assumed to have a consistent unit system. However,
in some unit systems this may cause the values displayed in Engineering Data to be different than
the one in the imported file. For example if a density value of 0.00073 in British Inch units is read
in from an ABAQUS input file, this value gets multiplied by 386.4 and a value of 0.282072 lbm/in3
is displayed in Engineering Data.
• FE Modeler supports Reference Temperature as a material property but unlike Simulation, does
not support a global reference temperature.
An option for a custom unit system is available if the unit system of imported NASTRAN or ABAQUS data files
does not match the five standard unit systems available in Workbench. If you customize the unit system, you
must supply any scale factors that relate length, mass, and time units custom unit system to meters, kilograms,
and seconds respectively. Custom units are created on the Project Page once a model has been imported into
Workbench. Once imported, you can view imported data in Engineering Data using the ANSYS Workbench
standard unit systems, however custom unit systems are not available or displayed from Engineering Data.
Note —
• For models based on NASTRAN data, the materials retain their original ID number but are given
a default name with the prefix Unnamed. These materials can be renamed in Engineering Data.
• For models based on ABAQUS data, materials display their original name from the ABAQUS input.
Thicknesses View
Note —
Purpose:
Composites View
Note —
Purpose:
• Provides a listing of all composite properties (e.g., offset, non-structural mass, thickness, orientation angle,
and material ID) for each layer.
• Displays grouping of composites with identical properties.
• Provides a visualization of composite elements in a model.
• Filters element selection for composite elements only.
• Differentiates elements with different composite properties by color.
Note — Bar properties retain the original ID numbering from NASTRAN data.
Purpose:
• Provides a listing of bar properties (e.g., area of cross-section, Inertia terms, Torsion constant and non-
structural mass).
• Provides a grouping of bars with identical properties.
• Provides a visualization of bar elements within a model.
• Filters element selection for specified set of bar elements only.
• Differentiates bar elements with different properties by color.
Note — Beam properties retain the original ID numbering from NASTRAN data.
Purpose:
• Provides a listing of beam properties (e.g., number of beam sections, Location along the beam, Area of
cross-section, Inertia terms, Torsion constant and non-structural mass for each beam section).
• Provides a grouping of beams with identical properties.
• Provides a visualization of beam elements within a model.
• Filters element selection for a specified set of beam elements only.
• Differentiates beam elements with different properties by color.
• Displays Mass properties from CONM2 element type of NASTRAN. Mass properties are assigned
an arbitrarily large ID number.
• Displays mass properties from the *MASS and *ROTARY INERTIA keywords of ABAQUS. ID numbers
are automatically assigned by FE Modeler.
Purpose:
• Displays a listing of mass properties (e.g., mass value, Coordinate system ID used for offset and inertia
terms, [x, y, z] offsets , 6 terms of the inertia tensor).
• Provides a grouping of mass elements with identical properties.
• Filters element selection for specified set of mass elements only.
• Differentiates elements with different properties by color.
Components View
Note —
• Models based on Simulation contain components corresponding to Named Selections and for
loads and supports.
• Models based on ABAQUS contain node and element sets. Components are also created by FE
Modeler for loads and boundary conditions not defined by a set.
Models based on ABAQUS contain node and element sets for loads and boundary conditions.
• Models based on NASTRAN may contain components that automatically group features of interest
(such as rotated nodes), or features that are only partially supported (such as elements with variable
thickness, non-zero material orientation angles, etc.). Loads and boundary conditions also define
components.
• Component names in FE Modeler and in ANSYS are the same as the entity names in Simulation
and ABAQUS sets. NASTRAN components are named by FE Modeler.
• For Generated Data or when transferring the model to ANSYS, any characters that ANSYS com-
ponent names do not allow are replaced with an underscore. If the name starts with a space or a
number, a prefix FEM is added automatically.
Purpose:
1. From the main menu, choose Tools> Options. The Options dialog box shown below appears.
2. Select the plus (+) symbol beside FE Modeler to expand the option.
3. Highlight Miscellaneous to display the available FE Modeler options.
4. Change any of the option settings by clicking directly in the option field on the right.
5. Click OK.
• Miscellaneous
• Templates
Miscellaneous Option
You can disable the option that changes the ID's of all of nodes and elements that are sent to the target system
from FE Modeler by selecting Tools> Options> FE Modeler> Miscellaneous and changing Compress Numbers
Sent To ANSYS from Yes to No. See the Export Specifications section for more information.
Note — It is highly recommended that you maintain the default setting to avoid sending large numbers
to ANSYS.
Templates Option
You can change a target system template by selecting Tools> Options> FE Modeler> Templates and modifying
the directory path of the target template file.
Unit Systems
When you transfer models from Simulation to FE Modeler, the:
• Unit system from the Simulation model is used to create the FE Modeler Generated Data.
• FE Modeler displayed data is always in the MKS System. However, the generated data is in the Simulation
Unit System. For example, a node selected in FE Modeler displays its coordinates in the MKS system even
though the Generated Data may appear in inches.
• Generated Data in FE Modeler always uses the unit system of the imported file. For example, if the source
file contains a Young's Modulus of 1e7, in British inch units, then the Generated Data always creates a
Young's Modulus of 1e7.
• Imported unit system information is only used to transfer the given material information to Engineering
Data. It can then be used by Simulation.
• Material data from NASTRAN/ABAQUS is interpreted in a consistent unit system. As a result, the values
displayed in Engineering Data can be different.
• Material data imported into FE Modeler from ABAQUS/NASTRAN is the only data for which the unit system
can be recognized.
• MPC
• PARAM - The only parameter name supported is “WTMASS”. The value of this parameter is multiplied by
all items associated with the mass (such as material density).
Note — If Tri- and Quad-shell elements are missing one or more mid-side nodes, FE Modeler will ignore
(not process) all mid-side nodes.
– A non-normal orientation is displayed in the GUI as a force, but is sent to ANSYS as a pressure. A non-
normal orientation is supported only on a 3D solid element face.
– Variable pressure distribution is not supported.
• SPC
• SPC1
• PROD
• PSHEAR - No effectiveness factors for extensional stiffness.
• PSHELL - Only MID1 and T are read.
• PSOLID - No material coordinate system, integration network, integration scheme or stress data is read.
Note — Rod/Bar/Beam properties are displayed in the GUI and used when exporting to ANSYS. If the
NASTRAN model contains PBEAM tapered beams, when exporting to ANSYS the tapered properties are
defined as a constant cross-section with the properties being "averaged" from the first and last cross-
section to represent the taper. Also, for both PBEAM and PBEAML tapered beams, the intermediate cross-
sections properties are ignored.
– Only the first instance defined in a model is read in. All other instances and data are ignored. Element
and node sets, as well as materials, associated with this instance are also processed.
• *INCLUDE supported
• *INSTANCE
• *END ASSEMBLY
• *END PART
• *END INSTANCE
• *PARAMETER supported - Independent parameters only (constants).
Note — These parameters are not stored and used in ANSYS, the values are substituted “on the
fly.”
• *PART
• *TRANSFORM supported
• *SYSTEM
• *SURFACE
• *SURFACE DEFINITION
• *NSET
• *ELSET
• *FREQUENCY supported
• *EQUATION supported
• *MPC supported
Note — Please see the ABAQUS Element Types Supported by FE Modeler section for the specific
ABAQUS Elements that are supported by FE Modeler.
• *ELASTIC
• *DENSITY
• *EXPANSION
• *PLASTIC
• * CONDUCTIVITY
• *SPECIFIC HEAT
– Any thicknesses defined by this keyword supersedes the constant thickness value defined by the
*SHELL SECTION keyword. The constant shell thickness is still defined, but is not used by any of the
elements.
• *SOLID SECTION
• *SHELL SECTION
→ A constant thickness definition will exist but is not used by the elements. The definition from the
*NODAL THICKNESS keyword is used instead.
– Material supported.
– Thickness supported.
– Linear only.
– SPRINGA NOT supported.
– The degree of freedom (DOF) associated with the first node will be stored with the definition. The DOF
for the second node (used with SPRING2 elements) is ignored.
→ ENCASTRE
→ PINNED
→ XSYMM
→ YSYMM
→ ZSYMM
→ XASYMM
→ YASYMM
→ ZASYMM
• *CLOAD
• *DLOAD - Pressure loading only as signified by Pn, where n is the face ID.
• *CONTACT PAIR
1. The first is the contact interaction name for that contact pair (specified on the *CONTACT PAIR
command and used in the *SURFACE INTERACTION card).
2. The second part is the “Slave” set name.
3. The third is the “Master” set name.
Each part of the contact name is separated by an underscore. For example, the ABAQUS command se-
quence would appear as follows:
*SURFACE, NAME=Surf1
*SURFACE, NAME=Surf2
• *CONTACT INTERFERENCE
• *FRICTION support
– Only used in conjunction with the *SURFACE INTERACTION keyword (contact only).
– Friction coefficient is supported and only read from data lines.
– The following parameters are supported:
→ ROUGH
→ EXPONENTIAL DECAY
→ TAUMAX
→ SLIP TOLERANCE
→ LAGRANGE
• *SURFACE BEHAVIOR
→ HARD
→ Linear
• *SURFACE INTERACTION
Each unique ABAQUS element type is defined by an FE Modeler element type and each FE Modeler element type
is processed in ANSYS as a unique ANSYS element type. ABAQUS elements can be further defined into the specified
categories. For example, Point Mass has four ABAQUS element types that define a mass element. If ABAQUS
MASS and ROTARY1 elements, as shown below, are defined, the result is two distinct FE Modeler element types
and both are processed in ANSYS as MASS21, however ANSYS defines two separate MASS21 element types for
the given ABAQUS element types.
ABAQUS Element Type Category ABAQUS Element Type Exported ANSYS Element Type
Point Mass MASS, HEATCAP, ROTARY1, ASI1 MASS21
Point Spring SPRING1, DASHPOT1 COMBIN14
2D Linear Line ASI2, B21, B21H, B23, B23H, PIPE21, BEAM3
PIPE21H, F2D2, FRAME2D, R2D23,
RB2D23, T2D2, T2D2H, T2D2T, T2D2E,
CONN2D2, JOINT2D
2D Line Gasket GK2D21, GK2D2N1 BEAM3
Axisymmetric Linear Line DCCAX2, DCCAX2D, ASI2A, SAX1, DSAX1, SHELL208
FAX2, MAX1, MGAX1, RAX23, SFMAX1,
SFMGAX1, SAXA1N
Axisymmetric Line Gasket GKAX21, GKAX2N1 SHELL208
ABAQUS Element Type Category ABAQUS Element Type Exported ANSYS Element Type
3D Linear Line DC1D2, DCC1D2, DCC1D2D, DC1D2E, BEAM188
AC1D2, B31, B31H, B33, B33H, PIPE31,
PIPE31H, B31OS, B31OSH, DASHPOTA,
DASHPOT2, GAPUNI, GAPCYL, GAP-
SPHER, GAPUNIT, DGAP, ELBOW31, EL-
BOW31B, ELBOW31C, FLINK, FRAME3D,
RB3D23, SPRINGA, SPRING2, T3D2,
T3D2H, T3D2T, T3D2E, CONN3D2,
JOINT3D, JOINTC
3D Line Gasket GK3D21, GK3D2N1 BEAM188
2D Quadratic Line ASI3, B22, B22H, PIPE22, PIPE22H, T2D3, BEAM3
T2D3H, T2D3T, T2D3E
Axisymmetric Quadratic Line ASI3A, SAX2, DSAX2, SAX2T, MAX2, SHELL208
MGAX2, SFMAX2, SFMGAX2, SAXA2N
3D Quadratic Line DC1D3, DC1D3E, AC1D3, B32, B32H, BEAM188
PIPE32, PIPE32H, B32OS, B32OSH, EL-
BOW32, T3D3, T3D3H, T3D3T, T3D3E
2D Linear Triangle CPE3, CPE3H, CPS3, CPEG3, CPEG3H, PLANE182
CPE3T, CPS3T, CPEG3T, CPEG3HT,
DC2D3, DC2D3E, AC2D3, CPE3E, CPS3E,
WARP2D3
Axisymmetric Linear Triangle CAX3, CAX3H, CGAX3, CGAX3H, DCAX3, PLANE182, KEYOPT(3)=1
DCAX3E, CAX3T, CGAX3T, CGAX3HT,
ACAX3, CAX3E
3D Linear Triangle STRI3, S3, S3R, S3RS, DS3, F3D3, M3D3, SHELL181
R3D33, SFM3D3
2D Quadratic Triangle CPE6, CPE6H, CPE6M, CPE6MH, CPS6, PLANE183
CPS6M, CPEG6, CPEG6H, CPEG6M,
CPEG6MH, CPE6MT, CPE6MHT, CPS6MT,
CPEG6MT, CPEG6MHT, DC2D6, DC2D6E,
CPE6MP, CPE6MPH, AC2D6, CPE6E,
CPS6E
Axisymmetric Quadratic Triangle CAX6, CAX6H, CAX6M, CAX6MH, CGAX6, PLANE183, KEYOPT(3)=1
CGAX6H, CGAX6M, CGAX6MH, DCAX6,
DCAX6E, CAX6MT , CAX6MHT ,
CGAX6MT, CGAX6MHT, CAX6MP,
CAX6MPH, ACAX6, CAX6E
3D Quadratic Triangle STRI65, DS6, M3D6, SFM3D6 SHELL93
2D Linear Quadratic CPE4, CPE4H, CPE4I, CPE4iH, CPE4R, PLANE182
CPE4RH, CPS4, CPS4I, CPS4R, CPEG4,
CPEG4H, CPEG4I, CPEG4IH, CPEG4R,
CPEG4RH, CPE4T, CPE4HT, CPE4RT,
CPE4RHT, CPS4T, CPS4RT, CPEG4T,
CPEG4HT, CPEG4RT, CPEG4RHT, DC2D4,
DCC2D4, DCC2D4D, DC2D4E, CPE4P,
CPE4PH, CPE4RP, CPE4RPH, AC2D4,
AC2D4R, CPE4E, CPS4E, WARP2D4
2D Quadratic Gasket GKPS4, GKPE4, GKPS4N, GKPS62, GKPE62, INTER192
GKPS6N2
ABAQUS Element Type Category ABAQUS Element Type Exported ANSYS Element Type
Axisymmetric Linear Quadratic CAX4, CAX4H, CAX4I, CAX4IH, CAX4R, PLANE182, KEYOPT(3)=1
CAX4RH, CGAX4, CGAX4H, CGAX4R,
CGAX4RH, DCAX4, DCCAX4, DCCAX4D,
DCAX4E, CAX4T, CAX4HT, CAX4RT,
CAX4RHT, CGAX4T, CGAX4HT, CGAX4RT,
CGAX4RHT, CAX4P, CAX4PH, CAX4RP,
CAX4RPH, ACAX4, ACAX4R, CAX4E,
CAXA4N, CAXA4HN, CAXA4RN,
CAXA4RHN
Axisymmetric Quadratic Gasket GKAX4, GKAX4N, GKAX62, GKAX6N2 INTER192, KEYOPT(3)=1
3D Linear Quadrilateral ASI4, S4, S4R, S4RS, S4RSW, S4R5, DS4, SHELL181
M3D4, M3D4R, MCL6, R3D4, SFM3D4,
SFM3D4R, SFMCL6, F3D4
3D Quadrilateral Gasket GK3D4L1, GK3D4LN1, GK3D6L1, SHELL181
GK3D6LN1
2D Quadratic Quadrilateral CPE8, CPE8H, CPE8R, CPE8RH, CPS8, PLANE183
CPS8R, CPEG8, CPEG8H, CPEG8R,
CPEG8RH, CPE8T, CPE8HT, CPE8RT,
CPE8RHT, CPS8T, CPS8RT, CPEG8T,
CPEG8HT, CPEG8RHT, DC2D8, DC2D8E,
CPE8P, CPE8PH, CPE8RP, CPE8RPH,
AC2D8, CPE8E, CPE8RE, CPS8E, CPS8RE
Axisymmetric Quadratic Quadrilateral CAX8, CAX8H, CAX8R, CAX8RH, CGAX8, PLANE183, KEYOPT(3)=1
CGAX8H, CGAX8R, CGAX8RH, DCAX8,
DCAX8E, CAX8T, CAX8HT, CAX8RT,
CAX8RHT, CGAX8T, CGAX8HT, CGAX8RT,
CGAX8RHT, CAX8P, CAX8PH, CAX8RP,
CAX8RPH, ACAX8, CAX8E, CAX8RE,
CAXA8N, CAXA8HN, CAXA8RN,
CAXA8RHN, CAXA8PN, CAXA8RPN
3D Quadratic Quadrilateral ASI8, S8R, S8R5, S9R5, DS8, S8RT, M3D8, SHELL93
M3D8R, M3D9, M3D9R, MCL9, SFM3D8,
SFM3D8R, SFMCL9
Linear Tetrahedral C3D4, C3D4H, C3D4T, DC3D4, DC3D4E, SOLID185
AC3D4, C3D4E
Linear Wedge C3D6, C3D6H, C3D6T, DC3D6, DC3D6E, SOLID185
AC3D6, C3D6E, SC6R
Wedge Gasket GK3D61, GK3D6N1, GK3D12M1, SOLID185
GK3D12MN1
Linear Hexahedral C3D8, C3D8H, C3D8I, C3D8IH, C3D8R, SOLID185
C3D8RH, C3D8T, C3D8HT, C3D8RT,
C3D8RHT, DC3D8, DCC3D8, DCC3D8D,
DC3D8E, C3D8P, C3D8PH, C3D8RP,
C3D8RPH, AC3D8, AC3D8R, C3D8E, SC8R
Hexahedral Gasket GK3D8, GK3D8N, GK3D182, GK3D18N2 INTER195
Quadratic Tetrahedral C3D10, C3D10H, C3D10M, C3D10MH, SOLID187
C3D10MT, C3D10MHT, DC3D10,
DC3D10E, C3D10MP, C3D10MPH,
AC3D10, C3D10E
ABAQUS Element Type Category ABAQUS Element Type Exported ANSYS Element Type
Quadratic Wedge C3D15, C3D15H, C3D15V, C3D15VH, SOLID186
DC3D15, DC3D15E, AC3D15, C3D15E
Quadratic Hexahedral C3D20, C3D20H, C3D20R, C3D20RH, SOLID186
C3D27, C3D27H, C3D27R, C3D27RH,
C3D20T, C3D20HT, C3D20RT, C3D20RHT,
DC3D20, DC3D20E, C3D20P, C3D20PH,
C3D20RP, C3D20RPH, AC3D20, C3D20E,
C3D20RE
[1] There is no equivalent ANSYS element gasket type for these ABAQUS elements, so the closest ANSYS element
by shape is used.
[2] Gasket elements that have mid-side nodes will not have the mid-side nodes transferred.
[3] Rigid elements are not translated as a rigid element, but use the element type closest to the ANSYS element
shape and dimension. Also, the reference node defined on the *RIDID BODY keyword is ignored.
Note — MESH200 is also supported and used when importing only a mesh to FE Modeler, or whenever
the analysis type, as reported by Simulation, is Unknown. MESH200 is also used whenever there is not
enough information in the Simulation branch to deduce the analysis type.
FORCE • On Vertex
• On Surface
PRESSURE • On Surface
• On Edge
• ANSYS
• ABAQUS
• NASTRAN
• Template
See the FE Modeler Options section for information on how to change the path to a target system template.
Shown below are the commands contained in the Workbench provided default template for each of the supported
target systems that you will use as the basis for a customize template. In addition, samples of the template are
provided.
Note — Not all entities imported into FE Modeler can be exported to all of the available systems.
Sample Templates
ANSYS as the target system
<WBTEMPLATE>
!HEADING
! File created at @TimeStamp@
!
! This template extracts the FEModeler mesh in a format
! compatible with ANSYS input
!
@MeshNodes@
!
@MeshElements@
!
@ElelemntType@
!
@MaterialProperties@
!
@Components@
!
@InterfaceRegions@
!
@Loads@
!
@BoundaryConditions@
!
@PhysicalProperties@
!
Sample templates are provided to perform a large deflection analysis using ANSYS, NASTRAN or ABAQUS.
Sensitivities..................................................................................................................... 5–13
Theory ............................................................................................................................ 5–15
Robust Design .................................................................................................................................. 6–1
What is Robust Design? .......................................................................................................... 6–1
Guidelines and Best Practices ................................................................................................. 6–4
Theory .................................................................................................................................... 6–6
Parameter Manager .......................................................................................................................... 7–1
What-if Parameter Studies ...................................................................................................... 7–1
Walkthroughs ................................................................................................................................... 8–1
Design of Experiment Walkthrough ......................................................................................... 8–1
DesignXplorer VT Walkthrough ............................................................................................... 8–3
Discrete Optimization Walkthrough ......................................................................................... 8–6
APDL and Goal Driven Optimization Walkthrough ................................................................... 8–7
APDL and Six Sigma Analysis Walkthrough........................................................................... 8–10
APDL and Robust Design Walkthrough ................................................................................. 8–11
Troubleshooting............................................................................................................................... 9–1
Appendices .................................................................................................................................... 10–1
Glossary of General Terms ................................................................................................... 10–1
List of Figures
1. Histograms for the Snow Height H1 and H2 ..................................................................................................... 2–4
1. 6,000 Sample Points Generated by Screening Method.................................................................................... 4–2
2. Final Sample Set After 5,100 Evaluations by Advanced Method ..................................................................... 4–2
3. Pareto Optimal Front Showing Two Non-dominated Solutions ................................................................... 4–3
4. Case Where the Advanced Option Cannot be Activated ................................................................................. 4–4
5. Case Where GDO Solves a Constraint Satisfaction Problem ............................................................................ 4–5
6. Typical MOO Case .................................................................................................................................................... 4–6
7. Primary Postprocessing Options for GDO......................................................................................................... 4–7
8. Typical TradeOff Study of Sample Showing First Pareto Front ........................................................................ 4–8
9. Selection of a Subset of the First Pareto Front ................................................................................................. 4–9
10. User-Selected Sample Set From the First Pareto Front ................................................................................ 4–10
11. Decision Support as Performed on User-Selected Sample Set .................................................................... 4–11
12. Two-dimensional TradeOff Plot Showing Feasible and Infeasible Points ................................................... 4–12
13. Three-dimensional TradeOff Plot Showing Feasible and Infeasible Points ................................................. 4–12
1. Illustration of cumulative distribution function .......................................................................................... 5–12
2. Probability Tables ............................................................................................................................................ 5–13
List of Tables
1. Number of Automatic Design Points as a Function of the Number of Input Parameters ............................ 2–11
2. Goals and Their Meanings for Continuous Input Parameters ........................................................................ 2–29
3. Goals and Their Meanings for Discrete Input Parameters .............................................................................. 2–29
4. Goals and Their Meanings for Response and Derived Parameters (Y = Output Parameters) ....................... 2–30
1. Different Types of Kurtosis .............................................................................................................................. 5–16
Systems Support
DesignXplorer and DesignXplorer VT are only supported on the Windows platform. A complete listing of operating
system requirements is listed in the ANSYS Workbench Products Installation and Configuration Guide for Windows.
Limitations
DesignXplorer, DesignXplorer VT and the DesignXplorer Parameter Manager are not localized.
What is DesignXplorer?
DesignXplorer is a powerful tool for designing and understanding the analysis response of parts and assemblies.
DesignXplorer is based on Design of Experiment (DOE) and various optimization methods, and uses parameters
as its basic language. These parameters can come from Simulation, DesignModeler, and various supported CAD
systems. (For a complete list of supported CAD systems, see CAD Systems.) Structural and thermal responses
can be studied, quantified, and graphed. Using a goal-driven optimization method, DesignXplorer can obtain a
multiplicity of robust design points. You can also explore the calculated response surface and generate design
sets directly from there.
Design of Experiment
DOE is a technique used to determine the location of sampling points. There are several versions of design of
experiment available in engineering literature. These techniques all have one common characteristic: they try
to locate the sampling points such that the space of random input parameters is explored in the most efficient
way, or obtain the required information with a minimum of sampling points. Sample points in efficient locations
will not only reduce the required number of sampling points, but also increase the accuracy of the response
surface that is derived from the results of the sampling points. DesignXplorer uses a central composite design,
which combines one center point, points along the axis of the input parameters, and the points determined by
a fractional factorial design.
Variational Technology
The results of a finite element analysis depend on several input variables, such as material properties, CAD
parameters, and shell thickness properties. In a design optimization based on DOE, each change of the value of
any input variable requires a new finite element analysis. A response surface is generated which is an explicit
approximation function of the finite element results expressed as a function of all selected input variables. The
DOE method generates a response surface using curve- and surface-fitting algorithms to “fit” output data as a
function of input data. This requires a group of design points where each point is generated via a finite element
solve.
DesignXplorer VT provides a much more efficient approach by providing a response surface that is based on a
single finite element solve combined with the use of mesh morphing and the Taylor series expansion approxim-
ation. Because the derivatives are also calculated, this “extended” finite element analysis may take longer than
a regular solve. However, this one “extended” finite element analysis takes considerably less time compared to
the many solution runs that are required for a regular DOE solve.
A Six Sigma Analysis allows you to determine the extent to which uncertainties in the model affect the results
of an analysis. An “uncertainty” (or random quantity) is a parameter whose value is impossible to determine at
a given point in time (if it is time-dependent) or at a given location (if it is location-dependent). An example is
ambient temperature: you cannot know precisely what the temperature will be one week from now in a given
city.
In a Six Sigma Analysis, statistical distribution functions (such as the Gaussian or normal distribution, the uniform
distribution, etc.) describe uncertain parameters.
Robust Design
Robust Design studies combine Goal Driven Optimization and Six Sigma Analysis to optimize Six Sigma Analysis
results to minimize the probability of failure.
Views
The available views expose all of the important objects of DesignXplorer. Several of the views are pictured below
as they appear in the Views pane.
• Parameters: When you select Parameters in the Views pane, the parameters you set in Simulation are
visible in View Details, sorted by input and output. When a parameter is selected, information about the
parameter appears in the right pane.
• Automatic Design Points: When you select Automatic Design Points in the Views pane, Summary and
Geometry appear in View Sub-options while a list of designs appears in View Details. Information about,
if you have Summary selected, or a picture of, if you have Geometry selected, the selected design appears
in the right pane.
• Responses: When you select Responses in the Views pane, three options appear in View Sub-options:
Response Charts, Single Parameter Sensitivities, and Spider Charts. Selecting Response Charts displays
a response chart, showing the effect varying input parameters has on an output parameter, in the right
pane. Selecting Single Parameter Sensitivities displays charts in the right pane which show which input
parameter(s) have the greatest effect on a selected output parameter. Selecting Spider Charts displays
a spider chart in the right pane, allowing you to visualize the impact that changing the input parameter(s)
has on all of the output parameters simultaneously.
• Custom Design Points: When you click on Custom Design Points in the Views pane, design points that
you have generated from response charts or stated design goals are displayed.
• Goal Driven Optimization: When you select Goal Driven Optimization in the Views pane, three options
appear in View Sub-options: Goals & Candidates, Sensitivities, and TradeOff Study. Details of the sample
set appear in View Details. Before you are able to select any of these options, you must have generated
a sample set. Selecting Goals & Candidates allows you to set the importance of and goals for each para-
meter before generating designs. Selecting Sensitivities displays the sensitivity charts in the right pane.
Selecting TradeOff study allows you to perform a tradeoff study.
• Six Sigma Analysis: When you run a solve in DesignXplorer with one or more input parameters set as
uncertainty variables, you will see Six Sigma Analysis in the Views pane. There will be three options in
View Sub-options: Tables, Charts, and Sensitivities. Before selecting one, you must generate a sample
set. Once that is done, selecting Tables or Charts will display statistical charts for the set in the right pane.
Selecting Sensitivities will display statistical sensitivity charts.
• Robust Design: When you select Robust Design in the Views pane, three options appear in View Sub-
options: Goals & Candidates, Sensitivities, and TradeOff Study. Details of the sample set appear in
View Details. Before you are able to select any of these options, you must have generated a sample set.
Selecting Goals & Candidates allows you to set the importance of and goals for each parameter before
generating designs. Selecting Sensitivities displays the sensitivity charts in the right pane. Selecting
TradeOff study allows you to perform a tradeoff study.
• Snapshots: When Snapshots is selected in the Views pane, three options appear in View Sub-options:
Responses, Sensitivities, and TradeOff Study. Choosing one of these options displays all snapshots
from the selected category. The Snapshots view can be used to quickly access related graphs and delete
or rename snapshots.
• Solution Messages: When Solution Messages is selected in the Views pane, errors that occurred while
DesignXplorer was solving are displayed. General Errors are not selectable.
• Report: When you select Report in the Views pane, DesignXplorer will automatically generate a report
for you. The report will display in the right pane.
Parameters
The following types of parameters are used in DesignXplorer:
• Input Parameters
• Response Parameters
• Derived Parameters
• Parameters associated with ANSYS Parametric Design Language (APDL)
Input Parameters
Input parameters are those parameters that define the geometry or inputs to the analysis for the structure under
investigation. Input parameters have predefined ranges that may be changed. These include (and are not limited
to) CAD parameters, Simulation parameters, and DesignModeler parameters. CAD and DesignModeler input
parameters might include length, radius, etc.; Simulation input parameters might include pressure, material
properties, materials, sheet thickness, etc.
Input parameters can be discrete or continuous, and each of these have specific forms. Discrete parameters are
those that are not continuous in nature (for example, the number of holes in a part, or the material the part is
made of). Continuous parameters can be any value defined by the range you set.
Because the parameter manager will not delete existing usability values from the values set when you generate
a run, the reset ranges are interpreted as new usability levels. Output values that are evaluated with usability
input parameters outside of the reset ranges are not guaranteed to have +/- 2% accuracy in a DesignXplorer VT
design study.
Response Parameters
Response parameters are those parameters that result from the geometry or are the response outputs from the
analysis. These include (and are not limited to) volume, mass, frequency, stress, heat flux, and so forth.
Derived Parameters
Derived parameters are an analytical combination of response or input parameters. As the definition suggests,
derived parameters are calculated from other parameters by using equations that you provide. Basing derived
parameters upon other derived parameters is not supported.
Design Points
A Design Point is defined by a snapshot of parameter values. These include input parameters, response parameters,
and derived parameters. A complete definition of a design point also includes its name, a description, and its
identification as either an automatic or custom design point.
Work Flow
The following procedures provide overviews of work flow:
• from a modeling system (either DesignModeler or other CAD software), through Simulation, and then
into DesignXplorer for design optimization.
• through DesignXplorer, creating candidate designs that meet the stated design goals.
• verifying the validity of custom/candidate design points in Simulation, with the final design ultimately
reflected in the modeling system.
1. Set design goals and generate candidate design points based on the current goals (from the Goals
& Candidates view).
and/or
2. Generate new custom design points from the various response views.
The goals method provides a way of optimizing your design based on goals that you set. Generating
design points from the response data graphs allows you to explore the response surface and choose
designs based on the values in the graphs.
4. Create snapshots of the response charts. You can include the snapshots in your reports, as well as reload
them on demand.
5. Create reports based on the response data for candidate designs.
DesignXplorer Options
You can control the behavior of functions in DesignXplorer through the Options dialog box. To access
DesignXplorer options:
1. From the main menu, choose Tools>Options. An Options dialog box appears and the DesignXplorer
options are displayed on the left.
2. Click on a specific option.
3. Change any of the option settings by clicking directly in the option field on the right. You will first see a
visual indication for the kind of interaction required in the field (examples are drop-down menus, sec-
ondary dialog boxes, and direct text entries).
4. Click OK.
Other help information is available that describes the Options dialog box:
• Common Settings
• DesignModeler
• CFX-Mesh
• Simulation
6
Section : DesignXplorer Options
• Licensing
• Design Type: Specifies a Central Composite Design (CCD) type to help improve the response surface fit
for DOE studies. For each CCD type, the alpha value is defined as the location of the sampling point that
accounts for all quadratic main effects. The following choices are available:
– Face-Centered: A three-level design with no rotatability. The alpha value equals 1.0. The Enhanced
Template option automatically appears when Face-Centered is selected from the drop-down menu.
Select Yes to enable the enhanced template.
– Rotatable: A five-level design that includes rotatability. The alpha value is calculated based on the
number of input variables and a fraction of the factorial part. A design with rotatability has the same
variance of the fitted value regardless of the direction from the center point. The Enhanced Template
option automatically appears when Rotatable is selected from the drop-down menu. Select Yes to
enable the enhanced template.
– VIF-Optimality: A five-level design in which the alpha value is calculated by minimizing a measure
of non-orthogonality known as the Variance Inflation Factor (VIF). The more highly correlated the input
variable with one or more terms in a regression model, the higher the Variance Inflation Factor.
– G-Optimality: Minimizes a measure of the expected error in a prediction and minimizes the largest
expected variance of prediction over the region of interest.
– Auto Defined (default): The DesignXplorer program automatically selects the Design Type based on
the number of input variables. Use of this option is recommended for most cases as which it automat-
ically switches between the G-Optimal (if the number of variables is 5) or VIF-optimal otherwise.
However, the rotational design may be used if the default option does not provide good values for
the goodness of fits from the response surface plots. Also, the Enhanced Template may be used if the
default standard template does not fit the response surfaces too well.
The Enhanced Template option may be used for Face-Centered and Rotable if the default standard template
does not fit the response surfaces. The default is No.
Note — To view the current Central Composite Design type, click on the Automatic Design Points view.
The CCD type is displayed above the summary of automatic design points.
Changing the CCD type in the Options dialog box will generate new automatic design points provided
the study has not yet been solved.
Graph
The Axis category includes:
• Number of Gridlines: Changes the number of points used by the continuous input parameter axes in
the 2-D/3-D response surface charts. This enhances the viewing of these charts. The range is from 2 to
100. The default is 10.
• Color Usage: Controls the number of colors used by 2-D and 3-D tradeoff charts. Choosing more colors
provides a better color quality display at the expense of slower chart rendering. Choosing less colors
provides faster chart rendering at the expense of lower color quality. The following choices are available:
– Use 8 Colors
– Use 16 Colors
– Use 32 Colors (default)
– Use 64 Colors
– Use Maximum Colors possible (Graph display will be slow)
• Repeatability: Seeds the random number generator to the same value each time you generate uncertainty
analysis samples. With repeatability set to No, the random number generator is seeded with the system
time every time you generate samples. This applies to all methods in DesignXplorer where random
numbers are needed, as in Six Sigma Analysis or optimization using Goal Driven Optimization. The default
is No.
Solution
The Variational Technology Method category includes:
• Mesh Morphing Type: To use mesh morphing, DesignXplorer VT must include the initial geometry with
an initial mesh, as well as several updated geometries. The values of the CAD parameters must be different
from the initial geometry values.
– Classic Method (default): DesignXplorer VT minimizes the number of configurations to minimize the
time required for mesh morphing. Only one parameter is varied in each configuration.
– CCD Matrix Method: DesignXplorer VT chooses the parameter configurations using the CCD (Central
Composite Design) matrix to calculate the value of each parameter for each configuration. For some
cases, especially when CAD parameters are coupled, this method is more precise, because more con-
figurations are used.
• Approximation Type
– Auto (default): DesignXplorer will automatically pick Taylor series approximation or Pade approximation
type.
– Reduced Order Model Sweep (ROMS): This method is the most accurate.
• Solver Type for Approximation Type ROMS: This is only taken into account with ROMS. With Taylor and
Pade, the solver type is always DIRECT (SPARSE solver) and this option is ignored.
– Inherited from Simulation (default): Means the Solver Type picked in Tools>Options>Simulation>Solu-
tion>Solver Type is used.
– Direct: The Sparse Direct (SPARSE) Solver will be used.
– Iterative: The Preconditioned Conjugate Gradient (PCG) Solver will be used.
8
Section : DesignXplorer Options
• Solution Type
– Full (default): When selected, the solution evaluates the derivatives for the Series Xpansion method,
including mixed-derivatives, addressing the interactions between the input variables. When set to
Independent, the solver will evaluate the derivatives assuming that the input variables are independent,
so mixed derivatives will be neglected.
– Independent: Mixed input variable interaction will not be calculated.
• Accuracy: Increasing the accuracy will increase the time of the solution run in DesignXplorer.
• Maximum Mesh Distortion: Controls the overall mesh quality in DesignXplorer VT to prevent the deform-
ation of your mesh. This will limit the relative variation of the volume of a solid (3-D) element or of the
surface of a shell (2-D) element. The default is 90. The range is from 1 to 150.
Note — If, during the morphing of the mesh, the mesh quality is worse than the maximum mesh
distortion setting, the parameter causing this distortion will be suppressed. However, in some
situations, a few elements in the mesh can be of poor quality without affecting the overall quality
of the solution. If you increase the distortion setting, the solution proceeds while including the
bad elements.
• Out-of-core Post-processing: The default is No. Allows you to choose if the Variational Technology
evaluations are done in memory (out-of-core = no) or directly using the results file on the disk (out-of-
core = yes). The goal is not to increase performances, but to allow the evaluation of larger models and/or
on machines having a small amount of memory and swapping very quickly. You must close and reopen
your DesignXplorer project to see the effect of this option.
Sensitivity
The Global Sensitivity category includes:
• Significance Level: Controls the relative importance or significance of input variables. The allowable
range is from 0.0, meaning all input variables are to be significant, to 1.0, meaning all input variables are
to be insignificant. The default is 0.025.
• Correlation Coefficient Calculation Type: Specifies the calculation method for determining sensitivity
correlation coefficients. The following choices are available:
– Rank Order (Spearman) (default): Correlation coefficients are evaluated based on the rank of samples.
– Linear (Pearson): Correlation coefficients are evaluated based on the samples.
Optimization
The Optimization category includes:
This option can be used for any optimization or robust design application and is best thought of as a
“constraint satisfaction” filter either on samples generated from the “Screening” or the “Advanced” runs.
This is especially useful for “Screening” samples to detect the edges of solution feasibility for highly con-
strained nonlinear optimization problems.
– As goals (default): Implies that the upper, lower and equality constrained goals of the candidate
designs shown in the “Goals and Candidates” page are treated as goals (or objective functions), thus
any violation of the goals is still considered feasible.
– As hard constraints: When chosen, the upper, lower and equality constrained goals are treated as
hard constraints, that is, if any of them are violated then the candidate is no longer displayed. So, in
some cases no candidate designs may be displayed depending on the extent of Constraint violation.
Parameter Options
The Parameter Settings category includes:
• Parameter Naming Convention: Sets the naming style of parameters within DesignXplorer.
– Taguchi Style: Names the parameters as Continuous Variables and Noise Variables.
– Uncertainty Management Style (default): Names the parameters as Design Variables and Uncertainty
Variables.
– Reliability Based Optimization Style: Names the parameters as Design Variables and Random Vari-
ables.
10
Using DesignXplorer
The topics in this section cover the basics of using DesignXplorer. Details on the use of DesignXplorer VT can be
found in the Variational Technology section.
Starting DesignXplorer
There are two ways to start DesignXplorer:
1. Start DesignXplorer from the Start Page by clicking the link for opening an existing DesignXplorer database
file.
2. From within Simulation, click the Project tab, highlight the row representing the Simulation file on the
Project Page, and click New DesignXplorer Study.
When started from Simulation, defined Parameters are automatically made available for use in DesignXplorer.
Note — Your screen should be set to a minimum resolution of 1152 x 864 pixels when using DesignXplorer.
All parameters shown under the Geometry node in the CAD Parameters section of the Details View in Simulation
will become input parameters in DesignXplorer. These include those parameters that you specify in Simulation
using a check box, as well as parameters that you choose to filter from a CAD system. From an active CAD file or
DesignModeler file, you can access the Default Geometry Usage Options section of the Project Page to select
filtering for Simulation and DesignXplorer.
Note — After creating a DesignXplorer VT design study, you cannot return to Simulation to adjust a
DesignXplorer Design Study.
Certain parameters (e.g., sheet thickness) defined in Simulation affect how the mesh is displayed in Simulation,
but will have no effect on the actual geometry. You must select such parameters via the check boxes in the Details
View for them to transfer to DesignXplorer.
Input Parameters
Click a parameter you wish to edit. Editing functions include:
Caution: Using the DOE Method, the number of design points is directly related to the number of se-
lected input parameters. The design and analysis Workflow shows that specifying many input parameters
will make heavy demands on computer time and resources, including Simulation analysis, DesignModeler
geometry generation, and/or CAD system generation. Also, large input parameter ranges may lead to
inaccurate results.
For uncertainty variables, you must specify the type of statistical distribution function used to describe its ran-
domness as well as the parameters of the distribution function. For the distribution type, you can select one of
the following:
• Uniform
• Triangular
• Gaussian
• Truncated Gaussian
• Log Normal
• Exponential
• Beta
• Weibull
For more information on the distribution types, see Section : Distribution Functions.
In the example below of a beam supporting a roof with a snow load, you could measure the snow height on
both ends of the beam 30 different times. Suppose the histograms from these measurements look like the figures
given below.
From these histograms, you can conclude that an exponential distribution is suitable to describe the scatter of
the snow height data for H1 and H2. Suppose from the measured data we can evaluate that the average snow
height of H1 is 100 mm and the average snow height of H2 is 200 mm. The parameter λ can be directly derived
by 1.0 divided by the mean value, which leads to λ1 = 1/100 = 0.01 for H1, and λ1 = 1/200 = 0.005 for H2.
Response Parameters
Click a response parameter you wish to edit. Just like input parameters, response parameters may be renamed
and you can use them to create derived parameters.
As the name suggests, each response parameter corresponds to a response surface and they are expressed as
functions of the input parameters. All output parameters in Simulation which were marked by a “P” are automat-
ically imported into DesignXplorer. Some typical response parameters are: Equivalent Stress, Displacement,
Maximum Shear Stress, etc.
Shape optimization parameters from Simulation cannot be imported into DesignXplorer because DesignXplorer
has its own Goal Driven Optimization system which can optimize those parameters.
Note — Contact tool reaction force component table parameters and contact tool reaction moment
component table parameters are not transferred from Simulation. Remote displacement is not recognized
as a parameter.
As the name implies, derived parameters are values created through expressions that reference existing input
and/or response parameters. They cannot reference other derived parameters. Insert the derived parameter as
described in the current DesignXplorer Help and illustrated below. Input the derived equation string into the
text box, or click the grey buttons.
This option can be used for any optimization or robust design application. This actually works like a "constraint
satisfaction" filter either on samples generated from the "Screening" or the "Advanced" runs. This is especially
useful for "Screening" samples to detect the edges of solution feasibility for highly constrained nonlinear optim-
ization problems.
+ Addition
- Subtraction
* Multiplication
/ Division
^ Power
The precedence of operations is in the following order: ^, *, /, +, -. You can use parentheses to ensure that oper-
ations are grouped properly.
Parameters are referenced by their names. You must use the parameter ID when specifying a derived parameter:
“P1 + P2” is acceptable, “length + width” is not.
There is no enforced dimensional consistency and the inclusion or exclusion of the derived parameters does not
affect response surface generation strategies, like Variational Technology (used in DesignXplorer VT) and DOE
(used in DesignXplorer), in any way. Also, if a particular parameter, for example, P1, has a 0 value anywhere and
the derived parameter involves a term 1/P1, then this will give erroneous values in the response charts.
The following restrictions are placed on derived parameters in order to maintain consistency between derived
parameters and samples:
• Robust Design parameters can only be created for a single Six Sigma Analysis sample set.
• Once you have generated a Robust Design sample set, you will not be able to create any new Robust
Design parameters, unless you delete all Robust Design sample sets.
• The Six Sigma Analysis samples are always based on the current values of the design variables in the system.
To change the values of the design variables, change the input parameter sliders in the Chart Navigator.
• Six Sigma Analysis sample sets that are used to create Robust Design parameters cannot be deleted if a
Robust Design sample set has been generated.
For more details about the values showing as the range of the parameter, see Section : Automatic Design Points.
You can stop execution with the Stop button in the toolbar and you can restart at a later time.
During execution a small progress Execution Status bar appears in the DesignXplorer status bar. This continuously
reports the status of the execution. If solution errors exist, the Solution Error view will be available. Click this
view to examine solution error information.
In order to obtain a solution for each Design Set, DesignXplorer must transfer parameters to Simulation and any
geometry package used by Simulation. One consequence of this is that if the Simulation database or the geometry
file is saved after a DesignXplorer run, the parameter values in Simulation or the geometry file will reflect the
parameter values of the last solved Design Set in DesignXplorer.
You can run DesignXplorer Design of Experiment (DOE) solutions on a single machine or distributed across
several machines by changing the appropriate settings in Simulation. These settings are located under Run
Process on in the Details View of a Solution tree object. All DesignXplorer DOE solutions will assume these
settings. You can monitor the status of a solution in progress using the Solution Status monitor, which is accessible
from the Windows system tray.
Note — If you want to change unit systems, start a new DesignXplorer study. Clearing the database does
not take into account an update of units. If the parameters are not correct, the study will still run. However,
the results may not be correct.
Note — If material properties from Simulation are used as parameters in a DesignXplorer analysis, at the
end of each DesignXplorer run, the material properties are reset to their original values. This may cause
the last run of solution items in Simulation (run using the last set of parameters from DesignXplorer) to
be marked as needing to be solved because the property value used in the solution is different from the
original property value.
• For DesignXplorer VT there is only one Automatic Design Point, located at the initial design configuration
(the values of all input parameters are equal to their initial values). Also, in DesignXplorer VT the Run
button includes three steps. You should execute all of these steps.
• For the DesignXplorer DOE method, the locations of the automatic design points are determined according
to a design-of-experiment method that is called a central composite design with a fractional factorial
design. The number of generated automatic design points is calculated using the number of input para-
meters selected in the parameters view. DesignXplorer automatically generates the response surfaces as
part of the execution process and displays them as shown below.
1. The degree of non-orthogonality of regression terms can inflate the variance of model coefficients.
2. The position of sample points in the design can be influential based on its position with respect to others
of the input variables in a subset of the entire set of observations.
An optimal CCD design should minimize both the degree of non-orthogonality of term coefficients and the op-
portunity of sample points having abnormal influence. In minimizing the degree of non-orthogonality, the
Variation Inflation Factor (VIF) of regression terms is used. For a VIF-Optimality design, the maximum VIF of the
regression terms is to be minimized, and the minimum value is 1.0. In minimizing the opportunity of influential
sample points, the leverage value of each sample points is used. Leverages are the diagonal elements of the Hat
matrix, which is a function of the design matrix. For a G-Optimality design, the maximum leverage value of
sample points is to be minimized.
For a VIF-Optimality design, the alpha value/level is selected such that the maximum VIF is minimum. Likewise,
for a G-Optimality design, the alpha value/level is selected such that the maximum leverage is minimum. The
rotatable design is found to be a poor design in terms of VIF- and G-Efficiences.
For an optimal CCD, the alpha value/level is selected such that both the maximum VIF and the maximum levergae
are minimum possible. For the Auto-Defined design, the alpha value is selected from either VIF- or G-Optimality
design that meets the criteria. Since it is a multi-objective optimization problem, in many cases, there is no unique
alpha value such that; both criteria reach their minimum. However, the alpha value is evaluated such that one
criterion reaches minimum while another approaches minimum.
For the current Auto-Defined setup (except for a problem with five variables that uses G-Optimality design) all
other multi-variable problems use VIF-Optimality. In some cases, despite the fact that Auto-Defined provides
an optimal alpha meeting the criteria, an Auto-Defined design might not give as good of a response surface as
anticipated due to the nature of physical data used for fitting in the regression process. In that case, you should
try other design types that might give a better response surface approximation.
Note — CCD Types can be selected via the Automatic Design Points section of the Options control panel
in the Tools menu.
It is a good practice to always verify some selected points on the response surface with an actual simulation
evaluation to determine its validity of use for further analyses in Design for Six Sigma and/or Robust Design. In
some cases, a good response surface does not mean a good representation of an underlying physics problem
since the response surface is generated according to the predetermined sampling points in the design space,
which sometimes misses capturing an unexpected change in some regions of the design space. In that case, you
should try Extended DOE. In Extended DOE, a mini CCD is appended to a standard CCD design, where a second
alpha value is added, and is set to half the alpha value of the Standard CCD. The mini CCD is set up in a way that
the essences of CCD design (rotatability and symmetry) are still maintained. The appended mini CCD serves two
purposes:
The two purposes seem to be conflicting in some cases where the response surface might not be as good as
that of the Standard DOE due to the limitation of a quadratic response surface in capturing a drastic change
within the design space.
Solving in DesignXplorer
Simulation solution process settings are carried through to DesignXplorer. For more information, see Section :
Solving Overview.
For example, for goal driven optimization, the DOE points should be located close to where the optimum design
is determined to be. For a Six Sigma Analysis, the DOE points should be close to the area where failure is most
likely to occur. In both cases, the location of the DOE points depends upon the outcome of the analysis. Not
having that knowledge at the start of the analysis, you can determine the location of the points as follows:
• For a design variable, the upper and lower levels of the DOE range coincide with the bounds specified for
the input parameter.
It often happens in optimization that the optimum point is at one end of the range specified for one or
more input parameters.
• For an uncertainty variable, the upper and lower levels of the DOE range are the quantile values corres-
ponding to a probability of 0.1% and 99.9%, respectively.
This is the standard procedure whether the input parameter follows a bounded (e.g., uniform) or unbounded
(e.g., Gaussian) distribution. Because the probability that the input variable value will exactly coincide
with the upper or lower bound (for a bounded distribution) is exactly zero. That is, failure can never occur
when the value of the input variable is equal to the upper or lower bound. Failure typically occurs in the
tails of a distribution, so the DOE points should be located there, but not at the very end of the distribution.
DOE Theory
For the DesignXplorer DOE method, response surfaces for all response parameters are generated in two steps:
• Solving the response parameters for all automatic design points as defined by a design-of-experiment.
• Fitting the response parameters as a function of the input parameters using regression analysis techniques.
The fraction f of the factorial design and the resulting number of automatic design points are given in the fol-
lowing table:
9 2 147
10 3 149
11 4 151
12 4 281
13 5 283
14 6 285
15 7 287
16 8 289
17 9 291
18 9 549
19 10 551
20 11 553
A regression analysis assumes that there are a total of n sampling points and for each sampling point the corres-
ponding values of the response parameters are known. Then the regression analysis determines the relationship
between the input parameters and the response parameter based on these sample points. This relationship also
depends on the chosen regression model. Typically for the regression model, a second-order polynomial is pre-
ferred. In general, this regression model is an approximation of the true input-to-output relationship and only
in special cases does it yield a true and exact relationship. Once this relationship is determined, the resulting
approximation of the output parameter as a function of the input variables is called the response surface.
1. General Definitions
where:
The regression
n sum2 of squares SSR is:
SSR = (y − y)
^
i (2)
i=1
where:
1 n
y= y
n i=1
i
For linear regression analysis the relationship between these sums of squares is:
SST = SSR + SSE
(4)
For a linear regression analysis, the regression model at any sampled location {x}i, with i = 1, ... , n in the
m-dimensional space of the input variables can be written as:
yi = ti {c} +
(5)
where:
t i = row vector of regression terms of the response surface model at the ith sampled location
c c ...c T
{c} = 1 2 p = vector of the regression parameters of the regression model
p = total number of regression parameters. For linear regression analysis, the number of regression
parameters is identical to the number of regression terms.
3. Forward-Stepwise-Regression
In the forward-stepwise-regression, the individual regression terms are iteratively added to the regression
model if they are found to cause a significant improvement of the regression results. In DesignXplorer,
a partial F test is used to determine the significance of the individual regression terms.
4. Improving the regression model with transformation functions
Only in special cases can response parameters of a finite element analysis, such as displacements or
stresses, be exactly described by a second-order polynomial as a function of the input parameters. Usually
a second order polynomial provides only an approximation. The quality of the approximation can be
significantly improved by applying a transformation function input parameter as well as the response
parameters. In DesignXplorer, the Yeo-Johnson transformation is used. The parameter λ of the Yeo-
Johnson transformation for the individual input parameters and response parameters is determined
using a nonlinear optimization algorithm.
Responses
There is one Response Surface or Curve for every response parameter and derived parameter. Response para-
meters are represented in terms of the input parameters, which are treated as independent variables.
Procedure
These graph types are supported:
• Response Charts
– X-Y Graphs
– 2-D Contour Graphs
– 3-D Contour Graphs
• Spider Charts
• Sensitivity Charts
Graphs can be generated and inserted in the Design View as snapshots. These snapshots are static and become
part of the Design Report. However, they also serve as links back to the response graph from which they were
generated.
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Snapshots
You can snapshot the current state of any response chart, sensitivity chart, spider chart, FEA result, or tradeoff
chart. Taking a snapshot will enter it into the list of snapshots available through the Snapshots view.
Snapshots are presented in reports and also provide a way of quickly accessing their related response graphs
again (simply double-click the snapshot). To create a snapshot, click on the Snapshots button in the toolbar
( ). The snapshot will appear in the corresponding section of the Snapshots view, where snapshots are
sorted by type: Responses, Sensitivities, and TradeOff Study. Single parameter sensitivities are included under
Responses.
Snapshots can be renamed in the Snapshots view. To rename a snapshot, you must first click the snapshot to
select it and then click the title to place the insertion point in the text. Note that this is a click, pause, click action.
Double-clicking will cause the snapshot to load the related response graph, as will selecting the snapshot and
clicking Activate Selected Chart.
Imprinting
For X-Y graphs only, you can imprint multiple curves and annotations on the graph.
To create an imprint:
1. Using the input parameters check box in the chart navigator, select the curve that you wish to imprint.
2. Type the desired annotation into the XY Curve Imprints input box.
3. Click Imprint the current curve and notation.
You can repeat the above procedure to add as many curves as are necessary. The result will look something like
this:
( ). The custom design point is added to the list of custom design points.
Response Charts
The various response charts allow you to graphically view impact that parameters have on one another. There
are currently three forms of charts available: response charts, spider charts, and sensitivity charts. These charts
share several features:
The various response charts allow you to see the impact that changing each input parameter has on the response
parameter. Spider charts are available from the sub-options in the Responses view. Spider charts are useful for
visualizing all output parameter values simultaneously.
You can change the parameter values to explore other designs by moving the slider bars, or entering specific
values in the accessible value boxes.
The navigational control at the bottom right in the chart window allows you to zoom in on or isolate any part of
the chart. The mini-window lets you see what part of the total picture you are currently viewing.
The Section : Goodness of Fit information is also available in the DOE Method.
Goodness of Fit
• Coefficient of Determination: The percent of the variation of the output parameter that can be explained
by the response surface regression equation. That is, coefficient of determination is the ratio of the explained
variation to the total variation.
The automatic design points used to create the response surface are likely to contain variation for each
output parameter (unless all the output values are the same, which will result in a flat response surface).
This variation is explained by the response surface that DesignXplorer generates. If the response surface
were to pass directly through each automatic design point, the coefficient of determination would be 1
or 100%, meaning that all variation is explained.
• Maximum Relative Residual: The maximum distance (relatively speaking) out of all of the automatic
design points from the calculated response surface to each automatic design point.
In the chart navigator, select one Input Parameter (for example, X2). The graph of Z versus X2 will be shown for
the current values of X1, X3, etc. Adjusting the values of X1, X3, and so on, will change the shape and position
of the Z-X2 graph. The chart navigator allows imprinting of curves with notations, so that very simple or elaborate
sets of response curves can be created.
Also indicated in the chart navigator are the values of the remaining response and derived parameters. Thus,
instantaneous design and analysis is possible, leading to the generation of additional design points.
The actual appearance of the graph will vary depending on the input parameter pair you select — discrete vs.
discrete, continuous vs. continuous, or discrete vs. continuous. Two examples of this are shown below.
Spider Charts
Spider charts allow you to visualize the impact that changing the input parameter(s) has on all of the output
parameters simultaneously. Spider charts are available from the Responses sub-options.
You can use the slider bars to adjust the value for the input parameter(s) to visualize different designs. The
parameter box at the top right in the chart window allows you to select the parameter that is in the primary (top)
position.
You can change the parameter values to explore other designs by moving the slider bars, or entering specific
values in the value boxes.
To set the target values, use Goal Driven Optimization (shown below); the targets are shown on the spider chart
as black boxes on each parameter spoke. When a parameter hits the target, the parameter number is given a
green background; if the parameter is close to the target (without exceeding it), the parameter number gets a
yellow background. If the parameter exceeds or is too far short of the target value, the parameter number gets
a red background.
For discrete parameters, you can change the parameter values to explore other designs by moving the slider
bars, or entering specific values in the value boxes.
If you Generate a hard reference... design from a custom design, the resulting design will be accessible through
the Custom Designs View.
Viewing Geometry
To display a geometry view for any design point, select the design point in the pertinent design list, then click
the Geometry sub-option.
The conversion takes place at the pertinent custom design point object in the Custom Design Points option in
the Selection View. Click Generate a hard reference... in the Design View.
Note — DesignXplorer cannot be used if you created virtual topology automatically in Simulation and
set Generate on Update to Yes. Setting this option to Yes deletes all Virtual Cell objects that were
automatically generated.
Sample Generation
To generate samples for a Goal Driven Optimization ( ), Six Sigma Analysis ( ), or Robust Design ( )
study, click the button for the desired sample set type from the toolbar or select the desired type from the Insert
menu. The sample generation interface opens. Use it to set the number of samples for optimization from the
minimum (equal to the number of Input Parameters) to a maximum 1e6. For Goal Driven Optimization and Robust
Design sample sets, you will be presented with two options, Screening and Advanced, as shown below.
For GDO or Robust Design problems containing only continuous input parameters, the Advanced option (shown
above) can be used to generate samples.
The Initial Samples drop-down menu allows you to either start a completely new sample generation (Generate
Initial Samples) or from an existing Screening sample.
If you wish to start from a new set, first set the Number of Initial Samples. This number should be at least 10
times the number of continuous input parameters, but not more than 300. If you want to use an existing
Screening sample set, you cannot edit the Number of Initial Samples field.
Before clicking Generate, you must also set Number of Samples Per Iteration, Maximum Number of Iterations,
and Maximum Allowable Pareto Percentage.
The Number of Samples Per Iteration setting must be less than or equal to the number of initial samples. This
is the number of samples that are iterated and updated at every iteration.
Maximum Number of Iterations determines the maximum possible number of iterations the algorithm executes.
If convergence happens before this number is reached, the iterations will cease. This also provides an idea of
the maximum possible number of function evaluations that are needed for the full cycle, as well as the maximum
possible time it may take to run the optimization. For example, the absolute maximum number of evaluations
is given by: Number of Initial Samples + Number of Samples Per Iteration * (Maximum Number of Iterations - 1).
Maximum Allowable Pareto Percentage indicates the approximate maximum percentage of first Pareto front
points (computed with respect to the Number of Samples Per Iteration) that you wish to compute. For example,
if the Maximum Allowable Pareto Percentage is set to 70 and the Number of Samples Per Iteration is set to
200, then you can expect to have, at most, approximately 140 first Pareto front points. If the Maximum Allowable
Pareto Percentage is too low (below 30), then there is a chance that the iterations will converge slowly. If the
value is too high (above 80), then the problem may converge prematurely. The value of the Maximum Allowable
Pareto Percentage depends on the number of output and input parameters of the problem, in addition to the
nature of the design space itself. Using a value between 55 and 75 works best for most problems.
For generating Six Sigma Analysis sample sets, you only need to select the sample size and click Generate.
Min/Max Search
Performing a Min/Max search will examine the entire output parameter space to approximate the minimum and
maximum of each output parameter. You can perform this search at any time.
To run a Min/Max search, click Perform Min/Max Search ( ) in the toolbar or Insert menu. The Min/Max values
are automatically generated and displayed in a table in the Design View. Min/Max Search will appear in the
Views pane.
This item will also be automatically inserted in the Views pane if you generate samples for either a Goal Driven
Optimization or Six Sigma Analysis. In this case, an actual search will not be performed, but the sample set will
be examined for the maximum and minimum values for each parameter. To indicate this lack, there will be an
asterisk (*) next to Min/Max Search in the Views pane. There will also be a message at the bottom of the Min/Max
search page in the Design View stating that the results are approximated.
If you insert a derived parameter, you must perform a new Min/Max search, because you cannot assume that
the existing values in the search are sufficient to generate accurate values for the derived parameter's minimum
and maximum. When a derived parameter is inserted, a message will be displayed at the bottom of the Min/Max
search page in the Design View stating that the search results may not be accurate for the new parameter values.
If you click the blue “Search” in either of the above warning messages, a Min/Max search will be performed.
Min/Max search values are always approximated for Six Sigma Analysis output variables. These variables are in-
serted from the Six Sigma Analysis view. When an output variable is inserted, a message will be displayed at
the bottom of the Min/Max search page in the Design View stating that the search results may not be valid for
Six Sigma Analysis output parameters and that Robust Design samples must be generated to approximate
Min/Max values. If you click the blue “here” in this warning message, you will be taken to the Robust Design
page. For more information on Six Sigma Analysis output variables, see Section : Parameterizing Six Sigma Ana-
lysis Results.
The optimization approach used in the DesignXplorer departs in many ways from traditional optimization
techniques. Many goals are allowed and can be assigned to each Response Parameter and each Derived Para-
meter. Goals may be weighed in terms of importance.
This departure from traditional optimization also accounts for preferences for the input parameters, which are
independent variables, allowing flexibility in obtaining the desired design configuration.
The following tables show the goals that may be applied to input parameters, and to response parameters and
derived parameters. For purposes of space, response parameters and derived parameters are collectively called
output parameters.
Table 4 Goals and Their Meanings for Response and Derived Parameters (Y = Output
Parameters)
Goal Meaning Mathematical Meaning GDO Treatment
No Preference No goals are specified N/A N/A
Minimum Possible Achieve the lowest possible value for Minimize Y Goal (TradeOff always on)
the output parameter
Maximum Possible Achieve the highest possible value Maximize Y Goal (TradeOff always on)
for the output parameter
Less than Target If a Target Value is specified, then Y <= YTarget Inequality constraint (TradeOff
achieve an output parameter value always off)
that is less than the Target Value
Greater than Target If a Target Value is specified, then Y > =YTarget Inequality constraint (TradeOff
achieve an output parameter value always off)
that is greater than the Target Value
Near Target If a Target Value is specified, then Y →YTarget Goal (TradeOff on) or equality
achieve an output parameter value constraint (Tradeoff off)
that is close to the Target Value
(Y = output parameter, YTarget = Target Value)
Specifying more Sample Designs directly increases the time required to generate optimized designs but also
produces more accurate Candidate Designs.
Sensitivities
To perform a global sensitivity study, select Goal Driven Optimization from the Views pane, then select Sens-
itivities from the View Sub-options. Global sensitivities quantify the concurrent influence of all the input
parameters on an input parameter.
By checking the box next to a parameter in Response and Derived Parameters, you can see the global sensit-
ivities of the parameter with respect to the input parameters. The sensitivities are displayed in both bar chart
and pie chart representations.
TradeOff Study
To perform a tradeoff study, select Goal Driven Optimization from the Views pane, then generate samples as
done in Section : Sensitivities. After the samples have been created, the Goals & Candidates page will display
in the right pane.
On this page, you can change the Target and Desired Value settings for response parameters. You can also
change the Target and Importance settings for input parameters, as these values do not affect the tradeoff
study. Definitions for response parameter goals are given in the table below.
For the meaning of each goal, see Section : Defining Design Goals.
You can insert a custom design point from the TradeOff charts. Select a point by clicking on it, then click
in the toolbar. The custom design point will be inserted in the Summary section of Custom Design Points.
You can also insert a custom sample set. Select more than one point in the graph, then click . You can select
points by clicking on them or by adjusting the slider to display fewer Pareto front points. If you use the slider
method, the points will not be highlighted. The new sample set will be inserted in the list of sample sets.
In order to perform a TradeOff Study, at least one output parameter should have a Desired Value of anything
other than No Preference. Importance settings do not affect TradeOff studies. Input parameter settings do not
affect the studies, either.
• Run the automatic design by clicking the Run — Solve Automatic Design Points button in the toolbar.
After the automatic design points are finished solving, the Views pane will include Six Sigma Analysis.
• Click Six Sigma Analysis in the Views pane.
• Generate samples.
• If you have created multiple sample sets this way, you will need to select the one you want to use for
postprocessing.
Tables
If you select the Tables sub-option, you are able to view the probability and inverse probability tables of each
variable, both of which you can modify by adding or deleting values. To add a value to the table, type the desired
value into the text box below the table and click on Insert New Parameter Value. A row with the value you
entered will be added to the table. To add a new value to the inverse probability table, type the desired value
into the text box below the table and click on the appropriate choice, Insert New Probability Value or Insert
New Sigma Level. To delete a row from either table, select the check box next to the row and click on Delete
Selected Row(s). The row will be deleted from the table.
Note — You cannot add a value to a probability table that falls outside the range of the table. Values you
add must be greater than the minimum and less than the maximum values specified for a variable.
For information on parameterizing statistics in the Parameter Statistics table, see Section : Parameterizing Six
Sigma Analysis Results.
Charts
If you select the Charts sub-option, you can review the statistical results of the analysis. In the right pane you
can select a variable from a drop-down menu. The results of a Six Sigma Analysis are visualized using histogram
plots and cumulative distribution function plots. For information on parameterizing statistics in the Parameter
Statistics table, see Section : Parameterizing Six Sigma Analysis Results.
A drop-down menu lets you choose which way the probability axis will be displayed. If the sampling data includes
only positive values, the choices in the drop-down will be Empirical Distribution Function, Normal Probability
Plot, Log-Normal Probability Plot, Exponential Probability Plot, and Weibull Probability Plot. If the sampling data
includes negative values, then the choices will be limited to Empirical Distribution Function, Normal Probability
Plot, and Exponential Probability Plot.
These plot types differ in how they plot the sample data on the x-axis and the probability data on the y-axis. The
table below explains the plot types, with the following assumptions: If the sample data is sorted in ascending
order, xi denotes the ith sample value, Fi is the corresponding probability value (as calculated by Equation 15),
and Φ-1(Fi) is the inverse cumulative distribution function of the standard normal distribution.
Sensitivities
If you select the Sensitivities sub-option, you can review the sensitivities derived from the samples generated
for the Six Sigma Analysis. The Six Sigma Analysis sensitivities are global, not Section : Single Parameter Sensitiv-
ities. In the left pane you can choose the response or derived parameter for which you want to review sensitivities.
The sensitivity charts appear in the right pane. The global sensitivities displayed there distinguish between sig-
nificant and insignificant input parameters. If all input parameters are significant, all parameters will be displayed.
If not, the sensitivity plot will show only the significant parameters and the insignificant parameters will be listed
below the sensitivity plot. For details on how the distinction between significant and insignificant is made, see
Section : Theory.
Statistical Measures
You can parameterize Shannon's entropy and Taguchi's signal-to-noise ratios for a robust design study. To do
so, perform a Section : Using Six Sigma Analysis analysis, then select Six Sigma Analysis from the Views pane
and Charts from the View Sub-options. From there you can select one of the following features to be paramet-
erized/optimized.
• Mean
• Standard Deviation
• Skewness
• Kurtosis
• Shannon Entropy (Complexity)
• Signal-Noise Ratio (Smaller is Better)
• Signal-Noise Ratio (Nominal is Best)
• Signal-Noise Ratio (Larger is Better)
• Minimum
• Maximum
Note — The three signal-to-noise ratios are mutually exclusive. Therefore, for a given parameter, only
one of them can be parameterized.
Caution: The three signal-to-noise ratios inherently tie the goal of variation reduction together with the
overall optimization problem, which makes them insufficient and inflexible for use in robust design.
Note — You may only parameterize Six Sigma Analysis results in one sample set. Otherwise there might
be contradictions, if you happened to select the mean value of a parameter from one sample set and
tried to maximize that under Robust Design while minimizing the mean value of the very same para-
meter from another sample set.
On the Tables page, you can also parameterize values from the probability tables (as shown below).
Note — You may only parameterize either the probability or sigma-level value, not both, for each row
in the probability tables.
To run a Robust Design analysis, you must have parameterized one or more of the statistical results of a Six Sigma
Analysis. Until you do so, the Robust Design node will not appear in the Views pane.
For information on specifying goals and candidates, see Section : Defining Design Goals.
Errors
Topology Errors
Topology Errors show the topology changes that have caused DesignXplorer VT to cut parameter ranges or fail
to generate a solution.
General Errors
General errors are not selectable.
Connectivity
Connectivity denotes a connection between two entities. If connectivity has been removed, the entities are no
longer touching.
Report
To generate a design report, click Report in the Views pane. The Design Report shows summaries of all Parameters,
Design Sets, and Response Charts saved as snapshots. You can then use Publish Report to write the report as
an HTML file in a designated directory.
1. Open the ANSYS Workbench and Create a new project and then open the Project Page. Generally the
APDL input file will be in the project folder on your hard drive.
2. On the Project Page, click the Link to an ANSYS APDL input file….
3. In the Open dialog box, open the appropriate APDL input file (filename.inp).
4. On the Project Page click Edit mapping of APDL parameters under ANSYS APDL Tasks.
This action will open an APDL filtering page for your project.
5. Identify the appropriate Input Parameters and Response Parameters from the APDL Parameters list and
add them to the respective DesignXplorer lists (you can use standard Windows functionality for multiple
selecting using the [Shift] and [Ctrl] keys). Also define the initial values of the Input Parameters.
6. Return to the Project Page. DesignXplorer automatically creates an XML file containing the input and
response parameters you chose. The file is saved in the project directory. Click Create a new
DesignXplorer study under ANSYS APDL Tasks. At this point, you will enter the DesignXplorer applic-
ation.
Please note that for steps 4 and 5, DesignXplorer will parse your APDL input file and search for APDL parameter
names. The parsing process does not include APDL macros that are called from your input file. This means that
APDL parameters defined in those APDL macros will not be included in the APDL filtering page. However, you
can manually add APDL parameters that are not automatically detected by filling in the name and value of the
parameters in the Input Parameter or Response Parameter table of the APDL list.
• ABC = 10
• *SET,ABC(1,2,3), 12.3,10.3, I
• *GET,MAX_STRESS,NODE,STR_POINT,S,EQV
• *VGET,MAX_STRESS(1,2,3),NODE,1,S,X
There are some cases where an APDL parameter will not show up in your APDL Parameters list. These are:
• The case where APDL Parameters are used as part of the parameter assignment. For example:
ABC(1,I,J)=10.345.
• If the APDL parameter is a character value or a character array. For example: ABC='ANSYS'.
The parser will also attempt to determine an Initial Value for the Input Parameters list. The parsing process
cannot determine the initial value if a parameter is defined by an APDL function and/or by using another para-
meter on the right hand side of the equal sign. The parsing process can only determine the initial value if the
Input Parameter is directly defined by “Name=value.” If the parsing process was able to determine the initial
value, then this value will be used in the Input Parameters list. If the parsing process was not able to determine
the initial value, then a value of 1.0 will be used.
If you change the input file and then click the APDL Parameters tab, then the values in the APDL Parameters
list do not update until you click the Refresh button.
The following error message appears if you change either the XML file (created at step 6 above) or the APDL input
file:
Input file has been changed since you last exposed the input and response parameters to DesignXplorer.
Do you want to populate the old input and response parameters?
• Click Yes if you want to use the old XML file to populate the Input Parameters and Response Parameters
lists.
• Click No to remove the selections that you previously had in the Input Parameters and Response Para-
meters lists and reparse the file.
Note — For more information on Extensible Markup Language (XML), please read Understanding XML.
A mechanism is in place which allows DesignXplorer to interact with executables and codes that are not native
to the WorkBench environment. This is referred to as the DesignXplorer 3rd Party Plug-In. Any executable that
supports a command line that can specify a text based input file and output file can be used by DesignXplorer
in a DOE optimization. Alternatively, any scriptable (ActiveX) objects can be accessed by wrapping a simple script
file around the object. Both of these methods of interaction are detailed below.
In order to accomplish generic interaction between process level components, an XML instruction language for
DesignXplorer has been developed. Using this language, it is possible to chain a sequence of actions (each may
occur in a separate executable or code component) together to define a full process. This process will be used
to define a single DOE point which will be treated just as a standard Simulation design point in a traditional
DesignXplorer DOE study. As a result of this, all optimization (Six Sigma Analysis, Robust Design, Goal Driven
Optimization, GA, NLPQL, and Monte-Carlo sampling) in DesignXplorer is compatible with a user defined process.
XML Instructions
All XML instructions have an outer layer which must be defined for any process. This outer layer includes a
working directory (the location is assumed to be central for all project files) as well as information that is stored
internally in DesignXplorer for future reference.
1. [Process Name] — Will be used internally by DesignXplorer. This can be any string which contains any
character in the Unicode character set.
2. [Method Type] — The method type can be the following value.
DX_DOE: Will perform the traditional DOE looping with the defined process and fit response surfaces
based on the results of the analysis.
3. [Directory Name] — The path of the working directory, with or without the trailing slash.
Inside the global <Instructions> XML node, the actual process sequence will be defined.
Stage Node
The first part of the process sequence is a stage definition, which will simply specify the text that is displayed in
the DesignXplorer toolbar. The stage definition has some advanced functionality which can be used to set up a
multi-stage analysis, however, for process sequencing it is only necessary to have a single item as a child of the
main stage node.
<Instruction Type="Global" Category="Stages">
<Stage Flags="[Value]" Property="" PlugIn="">[User Text]</Stage>
</Instruction>
1. [User Text] — The text which will be displayed in the DesignXplorer Run menu.
2. [Value] — Any numerical value greater than 20,000. Values 0 through 20,000 are reserved for
DesignXplorer. This is a simple ID that will be used internally by DesignXplorer, or in Conditional Instruc-
tions (explained below.)
Initialization Instructions
Following the stage node will be a list of initialization instructions that tell DesignXplorer which plug-ins will be
used for the analysis. For third party integration, the “Generic” plug-in will be used.
<Instruction Type="Init" PlugIn="Generic">
<Name>[Plug-In Name]</Name>
<ExePath>[Executable Path]</ExePath>
<ParameterParsingRules>
1. [Plug-In Name] — The user defined name of the generic Plug-In. This name must be unique throughout
the instruction file. Basically, this just defines a way for DesignXplorer to identify this instance of the
Generic Plug-In, because it is possible to have several instances (several third party applications or codes)
of the third party Plug-In in the process sequence.
2. [Executable Path] — The location of the executable file that the 3rd party Plug-In will interact with. This
can be either the full path, or the relative path of the executable with respect to the Working Directory
for the instruction file.
3. [Node Name] — A name given to the XML node that defines the parsing information for a single para-
meter. This name does not have to be unique, but must only adhere to the naming rules for XML nodes
(no spaces, special characters, etc.)
4. [Parameter Name] — A unique name that represents a single parameter in DesignXplorer. This is the
name that will be used to identify the parameter throughout the UI.
5. [Type] — The general type of the parameter. Must be one of two possible values.
a. “Input”: Signifies that the parameter will be treated as an input parameter, exactly as input parameters
are handled in DesignXplorer.
b. “Output”: Signifies that the parameter will be treated as an output or response parameter in
DesignXplorer. Note: When chaining generic Plug-Ins together, each instance of the generic Plug-
In can contain input and output parameters.
6. [Rule Name] — A name given to the XML node that represents a single parsing rule for the parameter
defined by the rule's parent node. This name must not be unique, but only adhere to the naming rules
for XML nodes (no spaces, special characters, etc.) Multiple rules can (and in most cases must) be defined
for each parameter. The only restriction is that only one rule of each type (detailed below) can exist for
each parameter.
7. [Rule Type] — The type of the rule defined. This can be one of the following values.
a. “File”: The 'file' rule defines the text file that contains the parameter value. This file can be the full
path to the file, or the relative path to the file with respect to the Working Directory. Concerning
"Input" type parameters, the file MUST exist before initializing DesignXplorer.
b. “StartLine”: The line number in the text file that DesignXplorer will begin parsing. For instance, if
the first 500 lines of a file contain only comments, begin parsing the file at line 501 to avoid wasting
system resources.
c. “PreString”: The text that immediately precedes the actual parameter value in the file. For instance,
if the file defines a parameter as “Cf = 12.555” the “PreString” for the parameter would be “Cf =”.
This text does not need to include any white space immediately preceding the parameter value.
d. “DataType”: Describes the type of data that represents the parameter. Must be one of the following
values.
i. float :The value of the parameter is a floating point (decimal) number. This is used for continuous
variables.
ii. long: The value of the parameter is an integer. This is used for discrete variables (number of
holes, number of ribs, etc.) DesignXplorer will physically interpret these as Discrete Parameters.
e. “Precision”: The number of significant digits that will be respected when reading from or writing
to the text file.
f. “SkipOccurrences”: The number of occurrences of “PreString” to skip before parsing begins.
8. [Value] — The value of the rule. No quotes are needed to delimit this value, as per the XML parsing rules.
For instance, a “Precision” node would look like
<Rule Type="Precision">8</Rule>
where “8” is the [Value] for the rule, signifying that parameters should be read and written from the in-
put/output text files with 8 significant digits.
Processing Instructions
After each Plug-In has been initialized, DesignXplorer can begin a processing phase with each Plug-In. The pro-
cessing phase defines the instructions necessary to fully run one complete design from start to finish. This means,
that for a DesignXplorer DOE run, the processing instructions will be executed several times by DesignXplorer.
Since XML is processed sequentially, DesignXplorer will process each instruction sequentially. This does not
mean that a simple linear chain of Plug-Ins is the only type of process chain that is supported. For instance, all
of the following are acceptable chains:
In any case, the instructions for multiple Plug-Ins will not be processed in parallel. For instance, in the second
example, the instructions for 'Exe 1' will be processed, then the instructions for 'Exe 2' will be processed, and
then 'Exe 3' will use the output of both 'Exe 1' and 'Exe 2' as inputs for its processing phase.
1. [Plug-In Name] — The user defined name of the generic Plug-In, which was defined in an existing 'Ini-
tialization' instruction. The processing instruction will fail if the Plug-In is not already initialzed.
2. [Argument Node Name] — A name given to the XML node that defines a command line argument for
the executable specified in a Plug-In initialization node. This node must not be unique, but only adhere
to the rules for XML node naming (no space, special characters, etc.) There will probably be multiple
rules defining multiple arguments, or a single rule defining all command line arguments.
3. [Argument Value] — A string representing the argument value. Any file paths in these argument lists
must be a full path to the file. The working directory will not be respected in the argument list. For instance
if you have a simple executable which handles a qualifier, an input file, and a location for an output file
you could specify the instructions in either of the following ways.
<Instruction Type="Processing" PlugIn="Generic">
<Name>[Plug-In Name]</Name>
<Argument>-i,</Argument>
<Argument>C:\Temp\myFile.input</Argument>
<Argument>-o</Argument>
<Argument>C:\Temp\myFile.outputC:\Temp\myFile.output</Argument>
</Instruction>
OR
<Instruction Type="Processing" PlugIn="Generic">
<Name>[Plug-In Name]</Name>
<Argument>-i C:\Temp\myFile.input -o C:\Temp\myFile.output</Argument>
</Instruction>
Conditional Instructions
Conditional instructions can be defined to execute processing instructions when a criterion is satisfied. From an
XML standpoint, a conditional instruction is an XML node whose children will not be processed unless the criterion
is satisfied. These instructions can have either a global or a process specific context.
<IF Property="[Property Name]" Location="[File Name]" [Comparison]="[Value]">
[Instructions]
</IF>
1. [Property Name] — The name of the property that will determine the criterion for the conditional in-
struction. The method must return only a single value.
2. [File Name] — Optional. If this does not exist, the instruction will be processed as a global instruction.
Currently only one property is supported at the global level, "ProcessingFlags", which determines the
current stage of execution. Otherwise, this value is the full path of the JavaScript file that cont ains the
property. This must be a path to a valid JavaScript file. If [File Name] has a value of "localscript" the
property must either be physically appended to the existing DesignXplorer scripts or added to the con-
fig.xml file for DesignXplorer as a JavaScript file. Using "localscript" will require a Workbench customization
license. In either case, the script file will automatically contain a global variable 'WB' which is the current
instance of Workbench. This will allow the script to interact with Workbench just as a traditional Workbench
macro can.
3. [Comparison] — The comparison type. This property is optional. If it does not exist the property is pro-
cessed as a Boolean true/false property. Other values for this parameter are as follows.
a. EQUALTO: Conditional Instruction processes the child instructions if [Property Name] evaluates
to [Value].
b. NOTEQUALTO: Conditional Instruction processes the child instructions if [Property Name] does
not evaluate to [Value].
c. LESSTHAN: Conditional Instruction processes the child instructions if [Property Name] evaluates
to a value less than [Value].
d. GREATERTHAN: Conditional Instruction processes the child instructions if [Property Name] evaluates
to a value greater than [Value].
e. LESSTHANEQUALTO: Conditional Instruction processes the child instructions if [Property Name]
evaluates to a value less than or equal to [Value].
f. GREATERTHANEQUALTO: Conditional Instruction processes the child instructions if [Property
Name] evaluates to a value greater than or equal to [Value].
Stop Instructions
If a Stop Instruction is processed, all processing will immediately stop and control of the DesignXplorer User In-
terface will return to the user. This is useful for trapping errors or processing multiple phases of execution.
<Instruction Type="Global" Category="Stop">
</Instruction>
1. [Property Name] — The property that signifies whether or not the phase of processing has been com-
pleted. If this property evaluates to 'true' then the item in the DesignXplorer run menu will be disabled.
Multiple stages are supported. Usually, a property validated stage instruction will be accompanied by a
conditional instruction and a stop instruction. For instance, if two phases are needed this can be accom-
plished with the following XML. Here, the first stage is given Flags of 1001. The item in the DesignXplorer
toolbar will be finished when the Stage1Done function in C:\File.js evaluates to true. Additionally, after
some processing, DesignXplorer checks to see what phase is currently running (which item the user
clicked in the DesignXplorer run menu.) DesignXplorer will stop execution if the ProcessingFlags (from
the Stage node) are equal to "1001".
<Instruction Type="Global" Category="Stages">
<Stage Flags="1001" Property="Stage1Done" Location="C:\File.js">Stage 1<Stage>
<Stage Flags="1002" Property="Stage2Done" Location="C:\File.js">Stage 2<Stage>
</Instruction>
[Initialization Instructions]
[Processing Instructions]
2. [Location] — The location of the script file, just as in conditional instructions. This can also use the value
of “localscript”.
3. [Value] and [User Text] — Described in the previous section “Stage Node”.
• Material properties
• Physical parameters (for example, the thickness of a plate)
• Geometry
• Loads
In a design optimization based on DOE (used in DesignXplorer), each change of the value of any input variable
requires a new finite element analysis. To perform a "what-if study" where several input variables are varied in
a certain range, a considerable number of finite element analyses may be required to satisfactorily evaluate the
finite element results over the space of the input variables. A response surface is generated that is an explicit
approximation function of the finite element results expressed as a function of all selected input variables. The
DOE method generates a response surface using curve and surface fitting algorithms to “fit” output data as a
function of input data. This requires a group of design points where each point is generated via a finite element
solve.
Variational Technology (used in DesignXplorer VT) provides a much more efficient approach by providing a re-
sponse surface that is based on a single finite element solve. For shape modifications, combined with the use of
mesh morphing and the Taylor series expansion approximation, Variational Technology can handle up to 10 input
variables, and can be used with multiple input variables or shape parameters. For non-shape parameters, Vari-
ational Technology can handle 50 to 100 parameters.
The Taylor series expansion technique depends on the order of the approximation function. Naturally, the
higher the order of the approximation, the more accurate the approximation will be. Variational Technology as
implemented in ANSYS Workbench automatically determines the necessary order of the approximation based
on the requested accuracy of the expected results.
To determine the response surfaces, it is necessary to evaluate higher-order derivatives of the finite element
results with respect to the selected input variables, where the order of the derivatives corresponds to the order
of the approximation function. It is a unique key feature of Variational Technology implemented in ANSYS
Workbench that all necessary derivatives of any order are calculated automatically within one single finite element
analysis. Because the derivatives are also calculated, this “extended” finite element analysis may take longer than
a regular solve. However, this one finite element analysis will take a considerably shorter time than the many
solution runs that are required for the “what-if study” mentioned above. Depending on the analysis problem,
typical speed-up factors may be on the order of ten or even up to several thousand.
DesignXplorer VT uses Variational Technology, and is available for structural applications, providing a response
surface of finite element results for linear, elastic, and static analysis types and eigenfrequency analyses.
DesignXplorer VT
• Section : What is DesignXplorer VT?
• Section : Good Practices
• Section : General Procedure for Using DesignXplorer VT
• Section : Results Viewing in DesignXplorer VT
• Section : Modifying DesignXplorer VT Input Variables
• Section : Viewing .rsx Files
• Material properties for a static structural analysis, including elastic modulus, material density, and minor
Poisson's ratio
• Shell thickness
• Mass
• CAD Parameters
• Acceleration and Rotation Velocity Parameters
• Discrete Parameters
Postprocessing in DesignXplorer VT provides the following tools for design evaluation and optimization:
• Design Curves
• Response Surfaces
• Contour Plots
• Spider Charts
• Sensitivity Charts
Good Practices
Run a Simulation Solution Before a DesignXplorer VT analysis: Running a single Simulation run first helps
“weed out” any problems that might cause the analysis to fail. For example, this will help locate such problems
as poorly applied loads, distorted elements, or coincident nodes not merged. You should eliminate any such
problems before performing a DesignXplorer VT analysis.
Review Parameters: Before performing a DesignXplorer VT analysis, you should inspect the parameters listed
on the Parameters Page to ensure that they are defined as intended. Variations can exist in how different CAD
packages display the parameters. Edit any parameters, as needed, before proceeding to the analysis. For example,
CAD parameters listed as “Unknown CAD” must be changed to the specific type of parameter (angle, coordinate
system, length, radius, thickness, etc.).
Effect of Additional Parameters: After doing a DesignXplorer VT study with a certain set of parameters, if
you wish to see the effect of additional parameters in DesignXplorer VT, you need to create a new DesignXplorer
VT study. Additional parameters cannot be added to existing DesignXplorer study.
Using Virtual Topology: DesignXplorer VT will not block models containing virtual topology. However, you
should not use virtual topology to circumvent topological changes in the model. Models containing virtual edges
will produce invalid results or cause mesh morphing to fail.
Original Configuration
• Topological Placement: Avoid creating topology where an outer loop and an inner loop share a common
definition point, as pictured below.
Outer Loop
Inner Loop
• Meshing: In general, ANSYS Workbench finite element meshes that show highly distorted elements tend
to not work well in DesignXplorer VT studies. However, this situation is problem-dependent. If parameter
changes do not cause changes in the distorted elements, then there will not be a problem with using
DesignXplorer VT. Also, free tetrahedron meshes tend to work better than hexahedron meshes. Once
again, however, this may not be true in all cases. In a DesignXplorer VT study, the mesh is based on the
original CAD geometry to perform mesh morphing.
• Recommendation Summary for Initial treatment of a New CAD Geometry
– Use independent parameter variation to determine the sensitivity of the input parameters independ-
ently before attempting a full run. The parameters that have very low sensitivity with respect to the
output parameters can be eliminated from the full analysis to save computing time and reduce solution
complexity.
– Keep the geometry parameter ranges small.
– Make sure that the ANSYS Workbench mesh is not overly distorted and the Simulation results are lo-
gical and correct.
– Use the Simulation Parameter Manager to test that CAD refreshes and simulation results make sense
over the parameter ranges of interest.
– Use the standard DesignXplorer methodology, which is based on Design of Experiment (DOE), to
quantify the problem setup and the selection of CAD parameters and their ranges.
Note — If the vector magnitude is modified for acceleration and rotational velocity input para-
meters, after solving, the upper and lower bounds will display as scaled values (e.g., 0.9 and 1.1
instead of 9 and 11).
To view contour plots, click Responses in the Views pane, then select FEA Result from the View Sub-options.
The contour plot that displays represents the result item checked in View Details. Check the box of a different
result item to change the contour display to the new result item. Viewing contour plots can assist you in displaying
the instantaneous effects of varying your input parameters. By dragging the slider to change an input parameter,
you will see the output parameters change accordingly in the View Details, and the contour plot will reflect the
change as well. After dragging the input parameter slider, the output parameter value will change, and changes
in the contour plot will occur instantly when you upclick.
When you click FEA Result in the View Sub-options of Responses to view contour plots, you activate a viewing
toolbar, a legend next to the contour plot, and a triad in the lower right corner. Most of these items are standard
viewing tools available in other modules within the ANSYS Workbench. Their arrangement in the toolbar may
differ across the modules, but their individual functions are the same. Presented below are links to sections of
the Simulation help where descriptions of these tools are included.
Toolbars
Graphics Toolbar: Rotate, Pan, Zoom, Box Zoom, Zoom to Fit, Magnifier Window
Animation
Also, the last two animation buttons are unique to DesignXplorer VT. They involve “animation sets” that allow
you to define an animation over a specific range of an input parameter. You define an animation set by dragging
the slider of the input parameter to the beginning of your intended range, and clicking the button. This
adds a “keyframe” to the animation set. Drag the input parameter slider to the end of your intended range and
click again. The animation will only include this range when you click . Click the clear animation
Legend
When viewing DesignXplorer VT result contours, an additional feature of the legend is its ability to readjust its
colors and numerical divisions to the current maximum and minimum of the selected output parameter. To ac-
tivate this feature, click Reset legend MIN/MAX after you adjust an input parameter slider. The min/max on the
Legend will update only when the minimum or maximum has been exceeded in the model. To reset the min/max
to that of the model, click Reset Min/Max in View Details.
Next, click View Results in DesignXplorer VT under DesignXplorer VT Results File Tasks. This opens
DesignXplorer VT. Notice that there are no output parameters listed in the Parameters view. This is because the
.rsx file contains general solution information and you must select exactly which outputs you want to see.
To view a result, click Insert Output Parameter ( ) in the toolbar or Insert menu. After clicking, you'll see a
default output parameter in the parameter list. DesignXplorer VT inserts the most general quantity possible.
Therefore, if you have stress or displacement results, you'll see a total displacement parameter. If you have fre-
quency results, DesignXplorer VT will insert the first mode shape. You can then specify the exact output quant-
ities by adjusting the fields on the output parameter page, as shown below.
Note — If the .rsx file was created from an ANSYS run and not a DesignXplorer VT run, there may be
certain element types that are not supported by DesignXplorer VT.
DesignXplorer VT cannot use .rsx files that do not contain solution information (i.e., ANSYS ParaMesh
.van files cannot be imported).
Depending on the type of output, more options may be available than are shown above.
• Output Type: The type of output. For example, Stress, Displacement, Normal Stress, Shear Stress, etc.
• Output Scoping: The nodes that the output is scoped to. Any components defined in the input file will
be available here, but it does not make sense for certain outputs to be scoped to all components.
• Output Orientation: The orientation of the output. For a deformation, the possibilities are X, Y, Z, or
Total. For shear stress, the possibilities are XY, XZ, or YZ. Essentially, this is the directional component of
the output.
• Nodal Search Value: Sets whether to search for the minimum or maximum of the output for response
surfaces and single output quantities.
• Frequency Mode: Sets the frequency mode to be viewed.
This feature can be used for FEA problems containing spot welds, support beams, spars, ribs, etc., and multibody
parts with “holes” represented by fill areas.
To perform an optimization using discrete input parameters, parameterize the “suppressed” property of the spot
weld, part, or body in the Simulation Details View. Create a new DesignXplorer VT study from the Project page
and the discrete parameters will be imported into DesignXplorer VT.
If n parameters are selected, the total number of points displayed on the scatter chart is 2n. Therefore, to allow
for a reasonable solution time, the maximum number of parameters that can be checked at the same time is 10.
Sample Generation
This section explains the use of the Advanced option (shown below) of sample generation for problems with
discrete (boolean) parameters.
As with other sampling methods, this technique features both Screening and Advanced options. The Screening
option generates all possible combinations of the parameters (i.e., for n Boolean parameters, the total number
of combinations is 2n). However, for problems with 32 or more parameters, the Screening option is disabled, as
the exhaustive sampling is extremely time-consuming.
The Advanced option is a multi-objective Boolean optimizer based on Bayesian sampling updates. For information
on how to set Initial Samples, Number of Samples Per Iteration, and Maximum Number of Iterations, see
Section : Sample Generation. You must also specify Training Set Percentage, which controls the convergence
rate of the algorithm. The value of the percentage depends on the number of TradeOff output parameters. For
problems with only one or two output parameters, the value should be set within 5%. With each additional
TradeOff output parameter, the percentage should be increased 2%. With this value set low, the convergence
is quicker, as the method is more exploitative. As the value increases, the study becomes more explorative. You
must choose the balance between explorative and exploitative. One option is to perform several exploitative
runs with different sample sizes and, depending on the differences between the solutions, run an explorative
search.
You can choose whether to set Target Number of Parameters and the corresponding Desired Value depending
on how many of the Boolean parameters you wish to see in the final design. This is a way to control the geometry
configurations in the final design.
You may also choose whether to set Maximum Cache Size. This is a mechanism by which duplicate configurations
generated during optimization are not reevaluated, but are copied from a cached set of solutions. The larger the
cache size, the faster the optimization gets as the iterations progress. However, a large cache involves a large
use of memory, and vice versa. You should keep this in mind when choosing a cache size.
Click Generate to start the iterations. If you wish to stop the iterations before they converge, click the Stop
button.
Theory
This section describes the algorithm developed to perform multiobjective constrained optimization of discrete
problems in DesignXplorer VT.
In DesignXplorer VT, discrete parameters are essentially Boolean in nature. That is, they can assume only two
values: “active” or “inactive,” represented by the values 1 and 0, respectively. For a problem which has n discrete
parameters, an exhaustive evaluation search space involves 2 n evaluations of the DesignXplorer VT response
surface. This optimizer is intended to report the optimal solution (a Pareto front in the case of multiobjective
optimization) by using fewer evaluations.
The optimizer accepts only discrete (Boolean) variables as input, and the outputs can be any DesignXplorer
output. You can use an additional constraint with this optimizer to force the optimal results to suppress a user-
defined number of discrete parameters.
Note — For a Pareto-ranked sample, the “best” solutions are found by partial rank ordering using
crowding distances.
6. Each column of the training sample is used to update the probability of the corresponding variable. The
probability of a column is calculated as the sum of the boolean values in a column divided by the training
sample size.
7. Check for convergence. If the solution has not converged, return to step 2.
The results of the optimization are shown as Pareto charts and sensitivities.
Limitations
Presented below are DesignXplorer VT limitations.
Check the ANSYS Workbench 10.0 Errata for the possibility of additional limitations.
• Static stress and modal analyses are supported (thermal analyses are not supported).
• Pre-stress normal mode analyses are not supported. This includes using applied loads such as nonzero
displacements, forces, pressures, etc.
• All types of nonlinearity in the model (i.e., nonlinear geometry, etc.) are not supported.
• Multiple environments leading to multiple solves (for example, one structural analysis and one modal
analysis together) are not supported. These analyses must be performed separately.
• Mass and volume are not available in normal modes (frequency).
• Only bonded MPC contact is supported.
• In Simulation, if you use a Method mesh control tool set to Uniform Quad/Tri, some models will not
mesh morph correctly because of the patch-independent nature of the Uniform Quad/Tri setting. The
node is limited to being morphed only on it's first topology.
1003 Hz.
1003 Hz.
1546 Hz.
2412 Hz.
2412 Hz.
For this part, you should not make a parameter of the 1st 2412 Hz. frequency without selecting the 2nd
2412 Hz. frequency.
Accuracy
DesignXplorer VT results and response surfaces are highly accurate over a wide range of input parameters. That
range is normally characterized as a “radius” of convergence. Once the input parameters fall outside of the con-
vergence radius, the results become more approximate. In a problem with n input parameters, there are 2 n
“corners.” For example, consider a problem with 2 input parameters, X and Y, as indicated in the response surface
below. Clearly, n = 2 and there are 22 or 4 corners. Inside the radius of convergence (r), the response surface results
are very accurate, while in the area of the corners (that is, outside the radius) the results are approximate. Of
course, this is more difficult to visualize in a general, n-dimensional space of input parameters, but the effect on
accuracy is similar. Therefore, if all input parameters are simultaneously pushed to their extremes, the results
will be less accurate. It follows that if the results are desired in a corner, the design center should be shifted by
modifying the ranges of the input parameters.
The radius of accuracy for DesignXplorer results can be visualized in the View Details by the shaded portions of
the Input Parameters slider bars. All displacement values within the radius are expected to be +/- 2% accurate.
The GDO process allows you to determine the effect on input parameters with certain preferences applied for
the output parameters. For example, in a structural engineering design problem, you may want to determine
which set of designs (in terms of geometric problem dimensions and material types) best satisfy minimum mass,
maximum natural frequency, maximum buckling and shear strengths, and minimum cost, with maximum value
constraints on the von Mises stress and maximum displacement.
This section describes the GDO tool and its use in performing MOO.
Principles
GDO can be used for design optimization in two ways: the Screening approach or the Advanced approach. The
Screening approach is a non-iterative direct sampling method by a quasi-random number generator based on
the Hammersley algorithm. The Advanced approach is an iterative Multi-objective Genetic Algorithm (MOGA),
which can optimize problems with continuous input parameters. Problems with mixed parameter types (i.e.,
usability, discrete, or scenario parameters with continuous parameters) or discrete problems cannot currently
be handled by the Advanced technique and in these cases you will only be able to use the Screening technique.
The GDO framework also allows you to use a Decision Support Process (DSP) based on satisfying criteria as applied
to the parameter attributes using a weighted aggregate method. In effect, the DSP can be viewed as a postpro-
cessing action on the Pareto fronts as generated by the Advanced or Screening process.
Usually the Screening approach is used for preliminary design, which may lead you to apply the Advanced ap-
proach for more refined optimization results. In either approach, the TradeOff Study option, as applied to the
resulting sample set, shows the Pareto-dominant solutions. However, in the Advanced approach, the Pareto
fronts are better articulated and most of the solutions lie on the first front, as opposed to the usual results of the
Screening approach, where the solutions are distributed across all the Pareto fronts. This is illustrated in Fig-
ure 1: “6,000 Sample Points Generated by Screening Method” and Figure 2: “Final Sample Set After 5,100 Evalu-
ations by Advanced Method”. Figure 1: “6,000 Sample Points Generated by Screening Method” shows the sample
as generated by the Screening method, and Figure 2: “Final Sample Set After 5,100 Evaluations by Advanced
Method” shows a sample set generated by the Advanced method for the same problem.
Figure 3: “Pareto Optimal Front Showing Two Non-dominated Solutions” shows the necessity of generating
Pareto fronts. The two axes represent two output parameters that are conflicting by nature. Two optimal solutions,
marked “1” and “2,” are shown. Both of these solutions are “non-dominated.” That is, they are equally good in
terms of Pareto optimality. Point 1 corresponds to a better solution in terms of the output marked “v.” Point 2
corresponds to a better solution in terms of the output marked “buck.”
If this is not done, then the optimization problem is either undefined (Desired Value for each parameter set to
No Preference) or is merely a constraint satisfaction problem (Desired Value set to Above Target or Below
Target or Near Target with TradeOff set to off). When the problem is not defined, as in Figure 4: “Case Where
the Advanced Option Cannot be Activated”, the Advanced option cannot be activated for sample generation.
If the problem defined is only one of constraint satisfaction, as in Figure 5: “Case Where GDO Solves a Constraint
Satisfaction Problem”, the Pareto fronts displayed (from the TradeOff option) may not be very clearly articulated,
as there are no objectives to be traded off. However, this is a good way to demonstrate the feasibility boundaries
of the problem in the output space (i.e., to determine the boundaries of the design envelope that reflects your
preferences).
As shown in Figure 4: “Case Where the Advanced Option Cannot be Activated”, if the entire Desired Value
column is set to “No Preference,” the optimization process will not be activated, as no outputs have goals specified
which could drive the algorithm.
As shown in Figure 5: “Case Where GDO Solves a Constraint Satisfaction Problem”, some combinations of Desired
Value and Target settings specify that the problem is one of constraint satisfaction. The results obtained from
these settings indicate only the boundaries of the feasible region in the design space. Currently the Advanced
option cannot be used to solve a pure constraint satisfaction problem.
As shown in Figure 6: “Typical MOO Case”, some selections allow either Screening or Advanced options to be
used for optimization. Typically, the “Near Target” option can be used either as a goal-based objective with
TradeOff turned on, or as an equality constraint with TradeOff turned off. The Screening process does not
make a distinction between the two scenarios. However, this setting does affect the Advanced method of GDO
because of the way the method handles objective functions and constraints.
The Target and Desired Value settings of the input parameters do not affect the sample generation part of the
Advanced method. However, these settings will affect the ranking of the samples which generate the three
candidate designs, if the Generate or update candidate designs based on the current goals button is clicked
on the Goals & Candidates page.
Sample generation using the Screening method is not affected by any parameter setting. However, the para-
meter settings do still affect the generation of candidate designs.
The TradeOff option indicates which output parameter is to be treated as an objective function for the optimiz-
ation. Setting the Desired Value to Maximum Possible or Minimum Possible automatically sets the TradeOff
option to on. If Desired Value is set to Near Target, then you can either treat it as an objective function (TradeOff
turned on), which will treat the output as a goal, or treat the output as an equality constraint (TradeOff turned
off). Output parameters for which the Desired Value has been set to Above Target or Below Target are auto-
matically assigned as constraints and the TradeOff option is turned off.
The tradeoff study option is affected by the Desired Value set for the output parameters. It is also affected by
whether the TradeOff option is set on or off. If the Desired Value for each output parameter is set to “No Pref-
erence,” then a tradeoff study cannot be performed. If the sample generation performed prior to the study used
the Screening method, you can freely change the attributes of the output parameters. However, if the study is
preceded by an Advanced sample generation, the output parameters are locked and cannot be changed.
Typically, the Screening method is best suited for conducting a preliminary design study, because it is a low-
resolution, fast, and exhaustive study that can be useful in locating approximate solutions quickly. The solutions
may then be used as a starting sample for the Advanced method. Ideally, as the Screening method does not
depend on any parameter settings, several such settings may be used successively in Screening runs to perform
preliminary design studies.
For example, you may run the Screening process for 3,000 samples, then use a tradeoff Study to generate and
view the Pareto fronts. The solutions slider can be used on the TradeOff page to display only the prominent
points you may be interested in (usually the first few fronts) and these can be saved as a new sample set by se-
lecting Insert Custom Sample Set. This new sample can then be selected in the Initial Samples drop-down
menu and the Advanced method of sample generation can proceed from there. In this case, the final Pareto
fronts generated will be very well articulated.
Because the GDO algorithm works off of response surfaces, you should validate the best obtained optimization
results by generating the corresponding hard designs and comparing the results.
Postprocessing
Postprocessing of GDO optimization results is explained below. The postprocessing phase follows the generation
of samples. If the Screening method of sample generation is used, the samples can be generated before goals
are selected. However, if the Advanced method is used, the goals must be set before the samples are generated.
For more information, see Section : Sample Generation.
• Generate non-dominated Pareto fronts by the tradeoff study or use the Decision Support Process (DSP)
to generate three candidate designs.
• Manually select specific points or automatic selection of point set from the tradeoff chart and save them
as Advanced or Screening sample sets, depending on how they were generated. (The full sample set
may also be saved this way.)
• Generate the best solutions from your specified preferences using the DSP with weighted goals on the
filtered tradeoff study samples.
• Save the best solutions from the DSP and generate hard designs from them for validation.
Figure 7: “Primary Postprocessing Options for GDO” shows the options offered for primary postprocessing of
the sampling results. These can be conducted on either Screening or Advanced sample generation results.
If TradeOff Study is selected after sample generation, the samples are ranked by non-dominated Pareto fronts
and the tradeoffs which concern you may be viewed. To make sense of the true nature of the tradeoffs, the plots
must be viewed with the output parameters as the axes. This shows which output goals can be ac hieved and
whether this entails sacrificing the goal attainment of other outputs. Typically, a tradeoff study gives you a choice
of possible, conflicting solutions from which to choose.
If you wish to bypass the tradeoff study process and only want to view and archive the three best solutions from
the generated sample set, you can click Generate or update candidate designs based on current goals. This
performs a weighted aggregate ranking of the solutions based on your specified preferences and reports the
three best solutions available. However, these results are not truly representative of the solution set, as this ap-
proach obtains results by ranking the solution by an aggregated, weighted method. Schematically, this represents
only a section of the available Pareto fronts. Changing the weights (i.e., Importance) will display different such
sections. This postprocessing step helps in selecting solutions if you are sure of your preferences for each para-
meter.
Figure 8: “Typical TradeOff Study of Sample Showing First Pareto Front” shows the results of the tradeoff study
performed on an Advanced sample set. The first Pareto front (non-dominated solutions) are shown as blue
boxes in the output-axis plot as the default output. The slider can be moved to the right to add more fronts, ef-
fectively adding more points to the tradeoff chart. The additional points added this way are inferior to the points
in the first Pareto front in terms of the goals you specified, but in some cases, where there are not enough first
Pareto front points, these may be necessary to obtain the final design.
At this point it is possible to save a sub-sample, i.e., the displayed points in the tradeoff chart, by clicking the Insert
a Custom Sample Set button. You can also select any group of points from the chart and use this option to save
a sub-sample. Alternatively, if only one point is needed from the chart, select it and click the Insert a Custom
Design Point button to save it.
In Figure 9: “Selection of a Subset of the First Pareto Front”, some points (yellow) have been selected from the
first Pareto front to be saved as a custom sample that can optionally be used in the DSP. Once a custom sample
is selected, fresh tradeoff studies can no longer be performed on it, because the sample set has already been
optimized in the Pareto sense and any further Pareto-based operations would not yield better results. Any further
tradeoff study operations on this sample set would only resume the previously-ranked points from the database.
8
Section : Postprocessing
As shown in Figure 10: “User-Selected Sample Set From the First Pareto Front”, only the points that are selected
from the first Pareto front of an existing sample set and saved (by using Insert Custom Sample Set) are saved
as a new sample set. The visible point set can now be used for the DSP, which will select the three best solutions
from this set according to your specified preferences. In order to do this, select Goals & Candidates.
In the decision support process, the settings for Desired Value and Target for output parameters cannot be
modified because the sample set obtained by the Advanced process has already narrowed down the sample
space to reflect your specified preferences. However, the Importance settings of the input and output parameters
and the Desired Value and Target settings for the input parameters can be changed. Only the Desired Value
and Target settings for the outputs affect the Advanced search.
In Figure 11: “Decision Support as Performed on User-Selected Sample Set”, you set the Importance value for
each output. You can also set values for Importance, Desired Value, and Target for the input parameters now.
10
Section : Postprocessing
Next, click Generate or update candidate designs of the current goals to generate three candidate designs.
Of the three designs generated, you may save whichever you want by selecting it and clicking Insert selected
candidate as a soft design.
It is also important to discuss the representation of feasible and infeasible points. The Advanced algorithm always
ensures that feasible points are shown as being of better quality than the infeasible points, and different markers
are used to indicate them in the chart. In the 3-D tradeoff chart, cubes denote feasible points and pyramids denote
infeasible ones. In the 2-D tradeoff chart, square markers denote the feasible points and triangular markers denote
the infeasible points.
Also, in both types of charts, the best Pareto front is blue and the fronts gradually transition to red (worst Pareto
front). Additionally, in the 3-D charts, the best Pareto front is opaque and the opacity reduces as progressively
worse fronts are identified.
Figure 12: “Two-dimensional TradeOff Plot Showing Feasible and Infeasible Points” is a typical 2-D tradeoff chart
with feasible and infeasible points.
Figure 13: “Three-dimensional TradeOff Plot Showing Feasible and Infeasible Points” is a typical 3-D tradeoff plot
with feasible and infeasible points. Once the specific tradeoff points are selected, automatically or manually,
they can be saved as a custom sample, as discussed earlier.
Theory
In this section, theoretical aspects of goal driven optimization are briefly discussed.
12
Section : Theory
For example, consider the integer 687459, which can be represented this way as n0 = 6, n1 = 8, and so on. Because
this integer is represented with radix 10, we can write it as 687459 = 9 + 5 * 10 + 4 * 100 and so on. In general,
for a radix R representation, the equation is:
n = nm + nm−1 * R + ⋯ + n0 (2)
The inverse radical function is defined as the function which generates a fraction in (0, 1) by reversing the order
of the digits in Equation 2 about the decimal point, as shown below.
R(n) = 0 nm nm−1 nm−2 ⋯n0
= nm * R−1 + nm−1 * R−2 + ⋯ + n0 * R−(m−1) (3)
Thus, for a k-dimensional search space, the Hammersley points are given by the following expression:
Hk (i) = [i / N,R1(i),R2 (i),⋯, Rk−1(i)]
(4)
where i = 0, ..., N indicates the sample points. Now, from the plot of these points, it is seen that the first row
(corresponding to the first sample point) of the Hammersley matrix is zero and the last row is not 1. This implies
that, for the k-dimensional hypercube, the Hammersley sampler generates a block of points that are skewed
more toward the origin of the cube and away from the far edges and faces. To compensate for this bias, a point-
shifting process is proposed that shifts all Hammersley points by the amount below:
1
= N
2 (5)
This moves the point set more toward the center of the search space and avoids unnecessary bias. Thus, the
initial population always provides unbiased, low-discrepancy coverage of the search space.
Taking a closer, more formal look at the multi-objective optimization problem, let the following denote the set
of all feasible (i.e., do not violate constraints) solutions:
X := {x : g(x) 0,h(x) = 0, xi x xu }
(6)
If there exists x' X such that for all objective functions x* is optimal. This, for i = 1, ..., k, is expressed:
f i(x*) f i(x)x X,
(8)
This indicates that x* is certainly a desirable solution. Unfortunately, this is a utopian situation that rarely exists,
as it is unlikely that all f 1(x) will have minimum values for X at a common point (x*). The question is left: What
solution should be used? That is, how should an “optimal” solution be defined? First, consider the so-called ideal
(utopian) solution. In order to define this solution, separately attainable minima must be found for all objective
functions. Assuming there is one, let x'1 be the solution of the scalar optimization problem:
min f i(x) = f i*
xX (9)
* * * i
Here f1' is called the individual minimum for the scalar problem i; the vector f = (f i ,…, f k ) is called ideal for a
multi-objective optimization problem; and the points in X which determined this vector is the ideal solution.
It is usually not true that Equation 10 holds, although it would be useful, as the multi-objective problem would
have been solved by considering a sequence for scalar problems. It is necessary to define a new form of optim-
ality, which leads to the concept of Pareto Optimality. Introduced by V. Pareto in 1896, it is still the most important
part of multi-objective optimization.
f * = (f *,…, f * )i
i k (10)
A point x' X is said to be Pareto Optimal for the problem if there is no other vector x X such that for all i =
1, ..., k,
f i(x) f i(x* )
(11)
This definition is based on the intuitive conviction that the point x* X is chosen as the optimal if no criterion
can be improved without worsening at least one other criterion. Unfortunately, the Pareto optimum almost always
gives not a single solution, but a set of solutions. Usually Pareto optimality is spoken of as being global or local
depending on the neighborhood of the solutions X, and in this case, almost all traditional algorithms can at best
guarantee a local Pareto optimality. However, this MOGA-based system, which incorporates global Pareto filters,
yields the global Pareto front.
The first Pareto front solutions are archived in a separate sample set internally and are distinct from the evolving
sample set. This ensures minimal disruption of Pareto front patterns already available from earlier iterations. You
can control the selection pressure (and, consequently, the elitism of the process) to avoid premature convergence
by altering the parameter Percent Pareto.
Given n input parameters, m output parameters, and their individual targets, the collection of objectives is com-
bined into a single, weighted objective function, Φ, which is sampled by means of a direct Monte Carlo method
using uniform distribution. The candidate designs are subsequently ranked by ascending magnitudes of the
values of Φ. The proposed function for Φ (where all continuous input parameters have usable values of type
“continuous”) is given by the following:
n m
wiNi + w jMj (13)
i=1 j=1
where:
The output parameters include response and derived parameters. The normalized objectives (metrics) are:
N = xt − x
i xu − x (14)
l i
M = yt − y
j y − ymin (15)
max j
where:
The fuzziness of the combined objective function derives from the weights w, which are simply defined as follows:
1.000, if the Importance is "Higher"
w i = w j = 0.666, if the Importance is "Default"
0.333, (16)
if the Importance is "Lower"
The targets represent the desired values of the parameters, and are defined for the continuous input parameters
as follows:
x,
x , if Desired Value is "No Preference"
if Desired Value is "Near Lower Bound"
l
x=
t 1
2 (xl + xu ), if Desired Value is "Near Midpoint" (17)
xu , if Desired Value is "Near Upper Bound"
and, for the output parameters we have the following desired values:
y, if Desired Value is "No Preference"
y , if Desired Value is "Minimum Possible" and a "Target" value is not defined
l*
y , if Desired Value is "Less Than Target" and "Target" is defined and y y*
t t
yt y,* if Desired Value is "Less Than Target" and "Target" is defined and y
*
yt
= y, if Desired Value is "Near Target" (18)
t
*
if Desired Value is "Greater Than Target" and "Target" is defined and y y t
y,* *
y, if Desired Value is "Greater Than Target" and "Target" is defined and y y
t t
yu, if Desired Value is "Maximum Possible" and a "Target" value is not defined
where:
*
yt
= user-specified target value
Thus, Equation 16 and Equation 17 constitute the input parameter goals for the continuous input parameters
and Equation 16 and Equation 18 constitute the response parameter goals.
The following section considers the case where the continuous input parameters have discrete Usable Values
(menu item “List of Discrete Values”) and there may be discrete input parameters of type “Discrete.” Let us consider
the case where the Usable Values of the continuous input parameter are defined as the following:
{X} = {x0, x1,..., xl−1}
(19)
where, as before,
Thus, the GDO objective equation becomes the following (for parameters with discrete Usable Values).
n m p
w iNi + w jMj + w lPl (22)
i=1 j=1 l=1
Therefore, Equation 15, Equation 16, and Equation 20 constitute the input parameter goals for parameters which
may be continuous or possess discrete usable values.
The norms and goals as in equations Equation 20 and Equation 20 are also adopted to define the input goals for
the discrete input parameters of the type “Discrete”; i.e., those discrete parameters whose Usable Alternatives
indicate a whole number of some particular design feature (number of holes in a plate, number of stiffeners,
etc.). Discrete input parameters of type “Scenario,” where the Usable Alternatives may indicate some discrete
configuration or type (like material name) and for which, consequently, no specific whole value can be attached,
are treated differently. The following metric is defined for “Scenario” parameters, where N q is the total number
of “Scenario” parameter Usable Alternatives.
0 if Desired Value = "Near Target" and current Usable Alternative = Target
Q k= 0 if Desired Value = "No Preference" (23)
1/N if Desired Value = "Near Target" and current Usable Alternative Target
q
Thus, equations Equation 15, Equation 16, and Equation 20 constitute the input parameter goals for “Discrete”
parameters and equations Equation 15, Equation 16, and Equation 22 constitute the input parameter goals for
“Scenario” parameters.
Therefore, the GDO objective function equation for the most general case (where there are continuous and discrete
parameters) can be written as the following:
n m
w iNi + w jMj
i=1 (Continuous Input) j=1 (Continuous Output)
l s (24)
+ wfPf
f =1 (Usability + Discrete) (Scenarios)
+ wkQk k=1
where:
From the normed values it is obvious that the lower the value of Φ, the better the design with respect to the
desired values and importances. Thus, a quasi-random uniform sampling of design points is done by a Hammersley
algorithm and the samples are sorted in ascending order of Φ. The desired number of designs are then drawn
from the top of the sorted list. A crowding technique is employed to ensure that any two sampled design points
are not very close to each other. The crowding is done for all parameter studies except for the case where pref-
erences are activated only on “Scenario” parameters.
A Six Sigma Analysis uses statistical distribution functions (such as the Gaussian, or normal, distribution, the
uniform distribution, etc.) to describe uncertain parameters.
Six Sigma Analysis allows you to determine whether your product satisfies Six Sigma quality criteria. A product
has Six Sigma quality if only 3.4 parts out of every 1 million manufactured fail. This quality definition is based on
the assumption that a response parameter relevant to the quality and performance assessment follows a Gaus-
sian distribution, as shown below.
A response parameter that characterizes product performance is typically used to determine whether a product's
performance is satisfactory. The parameter must fall within the interval bounded by the lower specification limit
(LSL) and the upper specification limit (USL). Sometimes only one of these limits exists.
An example of this is a case when the maximum von Mises stress in a component must not exceed the yield
strength. The relevant response parameter is, of course, the maximum von Mises stress and the USL is the yield
strength. The lower specification limit is not relevant. The area below the probability density function falling
outside the specification interval is a direct measure of the probability that the product does not conform to the
quality criteria, as shown above. If the response parameter does follow a Gaussian distribution, then the product
satisfies a Six Sigma quality criterion, if both specification limits are at least six standard deviations away from
the mean value.
In reality, a response parameter rarely exactly follows a Gaussian distribution. However, the definition of Six
Sigma quality is inherently probabilistic -- it represents an admissible probability that parts do not conform to
the quality criteria defined by the specified limits. DesignXplorer can calculate the non-conformance probability
no matter which distribution the response parameter actually follows. For distributions other than Gaussian, the
Six Sigma level is not really six standard deviations away from the mean value, but it does represent a probability
of 3.4 parts per million, which is consistent with the definition of Six Sigma quality.
This section describes the Six Sigma Analysis tool and how to use it to perform a Six Sigma Analysis.
While scatter and uncertainty naturally occur in every aspect of an analysis, deterministic analyses do not take
them into account. To deal with uncertainties and scatter, use Six Sigma Analysis, which you can use to answer
the following questions:
• If the input variables of a finite element model are subject to scatter, how large is the scatter of the output
parameters? How robust are the output parameters? Here, output parameters can be any parameter that
ANSYS Workbench can calculate. Examples are the temperature, stress, strain, or deflection at a node, the
maximum temperature, stress, strain, or deflection of the model, etc.
• If the output is subject to scatter due to the variation of the input variables, then what is the probability
that a design criterion given for the output parameters is no longer met? How large is the probability that
an unexpected and unwanted event takes place (i.e., what is the failure probability)?
• Which input variables contribute the most to the scatter of an output parameter and to the failure prob-
ability? What are the sensitivities of the output parameter with respect to the input variables?
Six Sigma Analysis can be used to determine the effect of one or more variables on the outcome of the analysis.
In addition to the Six Sigma Analysis techniques available, ANSYS Workbench offers a set of strategic tools to
enhance the efficiency of the Six Sigma Analysis process. For example, you can graph the effects of one input
variable versus an output parameter, and you can easily add more samples and additional analysis loops to refine
your analysis.
In traditional deterministic analyses, uncertainties are either ignored or accounted for by applying conservative
assumptions. You would typically ignore uncertainties if you know for certain that the input parameter has no
effect on the behavior of the component under investigation. In this case, only the mean values or some nominal
values are used in the analysis. However, in some situations, the influences of uncertainties exists but is still
neglected, as for the thermal expansion coefficient, for which the scatter is usually ignored.
σtherm = E α ∆T
because the thermal stresses are directly proportional to the Young's modulus as well as to the thermal expansion
coefficient of the material.
The table below shows the probability that the thermal stresses will be higher than expected, taking uncertainty
variables into account.
Uncertainty variables taken into Probability that the thermal Probability that the thermal
account stresses are more than 5% high- stresses are more than 10%
er than expected higher than expected
Young's modulus (Gaussian distri- ~16% ~2.3%
bution with 5% standard devi-
ation)
Young's modulus and thermal ex- ~22% ~8%
pansion coefficient (each with
Gaussian distribution with 5%
standard deviation)
Reliability is typically a concern when product or component failures have significant financial consequences
(costs of repair, replacement, warranty, or penalties) or worse, can result in injury or loss of life.
If you use a conservative assumption, the difference in thermal stresses shown above tells you that uncertainty
or randomness is involved. Conservative assumptions are usually expressed in terms of safety factors. Sometimes
regulatory bodies demand safety factors in certain procedural codes. If you are not faced with such restrictions
or demands, then using conservative assumptions and safety factors can lead to inefficient and costly over-
design. By using Six Sigma Analysis methods, you can avoid over-design while still ensuring the safety of the
component.
Six Sigma Analysis methods even enable you to quantify the safety of the component by providing a probability
that the component will survive operating conditions. Quantifying a goal is the necessary first step toward
achieving it.
Measured Data
If you have measured data, then you must first know how reliable that data is. Data scatter is not just an inherent
physical effect, but also includes inaccuracy in the measurement itself. You must consider that the person taking
the measurement might have applied a “tuning” to the data. For example, if the data measured represen ts a
load, the person measuring the load may have rounded the measurement values; this means that the data you
receive are not truly the measured values. The amount of this tuning could provide a deterministic bias in the
data that you need to address separately. If possible, you should discuss any bias that might have been built into
the data with the person who provided that data to you.
If you are confident about the quality of the data, then how you proceed depends on how much data you have.
In a single production field, the amount of data is typically sparse. If you have only a small amount of data, use
it only to evaluate a rough figure for the mean value and the standard deviation. In these cases, you could
model the uncertainty variable as a Gaussian distribution if the physical effect you model has no lower and upper
limit, or use the data and estimate the minimum and maximum limit for a uniform distribution.
In a mass production field, you probably have a lot of data. In these cases you could use a commercial statistical
package that will allow you to actually fit a statistical distribution function that best describes the scatter of the
data.
Sometimes the scatter of data is also specified by a mean value and an exceedance confidence limit. The yield
strength of a material is sometimes given in this way; for example, a 99% exceedance limit based on a 95%
confidence level is provided. This means that, from the measured data, we can be sure by 95% that in 99% of all
cases the property values will exceed the specified limit and only in 1% of all cases will they drop below the
specified limit. The supplier of this information is using the mean value, the standard deviation, and the number
of samples of the measured data to derive this kind of information. If the scatter of the data is provided in this
way, the best way to pursue this further is to ask for more details from the data supplier. Because the given ex-
ceedance limit is based on the measured data and its statistical assessment, the supplier might be able to provide
you with the details that were used.
If the data supplier does not give you any further information, then you could consider assuming that the number
of measured samples was large. If the given exceedance limit is denoted with x1 - α/2 and the given mean value
is denoted with xµ, then the standard deviation can be derived from the equation:
x1 − / 2 − x
=
C
Exceedance Probability C
99.5% 2.5758
99.0% 2.3263
97.5% 1.9600
95.0% 1.6449
90.0% 1.2816
No Data
In situations where no information is available, there is never just one right answer. Below are hints about which
physical quantities are usually described in terms of which distribution functions. This information might help
you with the particular physical quantity you have in mind. Also below is a list of which distribution functions
are usually used for which kind of phenomena. Keep in mind that you might need to choose from multiple options.
Geometric Tolerances
• If you are designing a prototype, you could assume that the actual dimensions of the manufactured parts
would be somewhere within the manufacturing tolerances. In this case it is reasonable to use a uniform
distribution, where the tolerance bounds provide the lower and upper limits of the distribution function.
• If the manufacturing process generates a part that is outside the tolerance band, one of two things may
happen: the part must either be fixed (reworked) or scrapped. These two cases are usually on opposite
ends of the tolerance band. An example of this is drilling a hole. If the hole is outside the tolerance band,
but it is too small, the hole can just be drilled larger (reworked). If, however, the hole is larger than the
tolerance band, then the problem is either expensive or impossible to fix. In such a situation, the parameters
of the manufacturing process are typically tuned to hit the tolerance band closer to the rework side,
steering clear of the side where parts need to be scrapped. In this case, a Beta distribution is more appro-
priate.
• Often a Gaussian distribution is used. The fact that the normal distribution has no bounds (it spans minus
infinity to infinity), is theoretically a severe violation of the fact that geometrical extensions are described
by finite positive numbers only. However, in practice, this lack of bounds is irrelevant if the standard devi-
ation is very small compared to the value of the geometric extension, as is typically true for geometric
tolerances.
Material Data
Load Data
For loads, you usually only have a nominal or average value. You could ask the person who provided the nominal
value the following questions: Out of 1000 components operated under real life conditions, what is the lowest
load value any one of the components sees? What is the most likely load value? That is, what is the value that
most of these 1000 components are subject to? What is the highest load value any one component would be
subject to? To be safe you should ask these questions not only of the person who provided the nominal value,
but also to one or more experts who are familiar with how your products are operated under real-life conditions.
From all the answers you get, you can then consolidate what the minimum, the most likely, and the maximum
value probably is. As verification, compare this picture with the nominal value that you would use for a determ-
inistic analysis. The nominal value should be close to the most likely value unless using a conservative assumption.
If the nominal value includes a conservative assumption (is biased), then its value is probably close to the max-
imum value. Finally, you can use a triangular distribution using the minimum, most likely, and maximum values
obtained.
You also have to distinguish if the load values are random fields or single random variables. If the load is different
from node to node (element to element), then it is most appropriate to include the program calculating the load
in the analysis file. If the load is described by one or very few constant values, then you can also consider perform-
ing a Six Sigma Analysis with the program calculating these load values. Again, you need to provide an interface
to transfer input data to this program and get output data (the loads) back to ANSYS. If there is more than just
one single load value generated by the program, then you should also check for potential correlations.
Distribution Functions
Beta Distribution
You provide the shape parameters r and t and the lower and the upper limit xmin and xmax of the random variable
x.
The Beta distribution is very useful for random variables that are bounded at both sides. If linear operations are
applied to random variables that are all subjected to a uniform distribution, then the results can usually be de-
scribed by a Beta distribution. For example, if you are dealing with tolerances and assemblies where the compon-
ents are assembled and the individual tolerances of the components follow a uniform distribution (a special case
of the Beta distribution), the overall tolerances of the assembly are a function of adding or subtracting the geo-
metrical extension of the individual components (a linear operation). Hence, the overall tolerances of the assembly
can be described by a Beta distribution. Also, as previously mentioned, the Beta distribution can be useful for
describing the scatter of individual geometrical extensions of components as well.
Exponential Distribution
You provide the decay parameter λ and the shift (or lower limit) xmin of the random variable x.
The exponential distribution is useful in cases where there is a physical reason that the probability density
function is strictly decreasing as the uncertainty variable value increases. The distribution is mostly used to describe
time-related effects; for example, it describes the time between independent events occurring at a constant rate.
It is therefore very popular in the area of systems reliability and lifetime-related systems reliability, and it can be
used for the life distribution of non-redundant systems. Typically, it is used if the lifetime is not subjected to
wear-out and the failure rate is constant with time. Wear-out is usually a dominant life-limiting factor for mech-
anical components that would preclude the use of the exponential distribution for mechanical parts. However,
where preventive maintenance exchanges parts before wear-out can occur, then the exponential distribution
is still useful to describe the distribution of the time until exchanging the part is necessary.
You provide values for the mean value µ and the standard deviation σ of the random variable x.
The Gaussian, or normal, distribution is a fundamental and commonly-used distribution for statistical matters.
It is typically used to describe the scatter of the measurement data of many physical phenomena. Strictly
speaking, every random variable follows a normal distribution if it is generated by a linear combination of a very
large number of other random effects, regardless which distribution these random effects originally follow. The
Gaussian distribution is also valid if the random variable is a linear combination of two or more other effects if
those effects also follow a Gaussian distribution.
Lognormal Distribution
ξδ
You provide values for the logarithmic mean value ξ and the logarithmic deviation δ. The parameters ξ and δ are
the mean value and standard deviation of ln(x): 2
1 ln x -
1
f(x,,) = exp -
2 x 2
The lognormal distribution is another basic and commonly-used distribution, typically used to describe the
scatter of the measurement data of physical phenomena, where the logarithm of the data would follow a normal
distribution. The lognormal distribution is suitable for phenomena that arise from the multiplication of a large
number of error effects. It is also used for random variables that are the result of multiplying two or more random
effects (if the effects that get multiplied are also lognormally distributed). It is often used for lifetime distributions
such as the scatter of the strain amplitude of a cyclic loading that a material can endure until low-cycle-fatigue
occurs.
Uniform Distribution
You provide the lower and the upper limit xmin and xmax of the random variable x.
The uniform distribution is a fundamental distribution for cases where the only information available is a lower
and an upper limit. It is also useful to describe geometric tolerances. It can also be used in cases where any value
of the random variable is as likely as any other within a certain interval. In this sense, it can be used for cases
where “lack of engineering knowledge” plays a role.
Triangular Distribution
You provide the minimum value xmin, the most likely value limit xmlv and the maximum value xmax.
The triangular distribution is most helpful to model a random variable when actual data is not available. It is very
often used to capture expert opinions, as in cases where the only data you have are the well-founded opinions
of experts. However, regardless of the physical nature of the random variable you want to model, you can always
ask experts questions like “Out of 1000 components, what are the lowest and highest load values for this random
variable?” and other similar questions. You should also include an estimate for the random variable value derived
from a computer program, as described above. For more details, see Section : Choosing a Distribution for a
Random Variable.
You provide the mean value µ and the standard deviation σ of the non-truncated Gaussian distribution and the
truncation limits xmin and xmax.
The truncated Gaussian distribution typically appears where the physical phenomenon follows a Gaussian distri-
bution, but the extreme ends are cut off or are eliminated from the sample population by quality control measures.
As such, it is useful to describe the material properties or geometric tolerances.
Weibull Distribution
You provide the Weibull characteristic value xchr , the Weibull exponent m and the minimum value xmin. Special
cases: For xmin = 0 the distribution coincides with a two-parameter Weibull distribution. The Rayleigh distribution
is a special case of the Weibull distribution with α = xchr - xmin and m = 2.
In engineering, the Weibull distribution is most often used for strength or strength-related lifetime parameters,
and is the standard distribution for material strength and lifetime parameters for very brittle materials (for these
very brittle material the “weakest-link theory” is applicable). For more details, see Section : Choosing a Distribution
for a Random Variable.
Sample Generation
For Six Sigma Analysis, the sample generation is based on the Latin Hybercube Sampling (LHS) technique. The
LHS technique is a more advanced and efficient form of Monte Carlo Simulation methods. The only difference
between LHS and the Direct Monte Carlo Sampling technique is that LHS has a sample “memory,” meaning it
avoids repeating samples that have been evaluated before (it avoids clustering samples). It also forces the tails
of a distribution to participate in the sampling process. Generally, the LHS technique requires 20% to 40% fewer
simulations loops than the Direct Monte Carlo Simulation technique to deliver the same results with the same
accuracy. However, that number is largely problem-dependent.
Histogram
A histogram plot is most commonly used to visualize the scatter of a Six Sigma Analysis variable. A histogram is
derived by dividing the range between the minimum value and the maximum value into intervals of equal size.
Then Six Sigma Analysis determines how many samples fall within each interval, that is, how many “hits” landed
in each interval.
Six Sigma Analysis also allows you to plot histograms of your uncertainty variables so you can double-check that
the sampling process generated the samples according to the distribution function you specified. For uncertainty
variables, Six Sigma Analysis not only plots the histogram bars, but also a curve for values derived from the dis-
tribution function you specified. Visualizing histograms of the uncertainty variables is another way to verify that
enough simulation loops have been performed. If the number of simulation loops is sufficient, the histogram
bars will:
However, if the probability density function is flattening out at the far ends of a distribution (for example, the
exponential distribution flattens out for large values of the uncertainty variable) then there might logically be
gaps. Hits are counted only as positive integer numbers and as these numbers gradually get smaller, a zero hit
can happen in an interval.
The value of the cumulative distribution function at the location x0 is the probability that the values of X stay
below x0. Whether this probability represents the failure probability or the reliability of your component depends
on how you define failure; for example, if you design a component such that a certain deflection should not exceed
a certain admissible limit, then a failure event occurs if the critical deflection exceeds this limit. Thus, for this ex-
ample, the cumulative distribution function is interpreted as the reliability curve of the component. On the
other hand, if you design a component such that the eigenfrequencies are beyond a certain admissible limit,
then a failure event occurs if an eigenfrequency drops below this limit. So for this example, the cumulative dis-
tribution function is interpreted as the failure probability curve of the component.
The cumulative distribution function also lets you visualize what the reliability or failure probability would be if
you chose to change the admissible limits of your design.
A cumulative distribution function plot is an important tool to quantify the probability that the design of your
product does or does not satisfy quality and reliability requirements. The value of a cumulative distribution
function of a particular response parameter represents the probability that the response parameter will remain
below a certain level as indicated by the values on the x-axis of the plot.
Example 2
As shown in Figure 1: “Illustration of cumulative distribution function”, the probability that the Shear Stress
Maximum will remain less than a limit value of 1.71E+5 is about 93%, which also means that there is a 7% prob-
ability that the Shear Stress Maximum will exceed the limit value of 1.71E+5.
Note — Both tables will have more rows, i.e., include more data, if the number of samples is increased.
If you are designing for high product reliability, i.e., a low probability that it does not conform to quality
or performance requirements, then the sample size must be adequately large to address those low
probabilities. Typically, if your product does not conform to the requirements denoted with “Preq,” then
the minimum number of samples should be determined by: Nsamp = 10.0 / Preq.
For example, if your product has a probability of Preq=1.0 e-4 that it does not conform to the requirements,
then the minimum number of samples should be Nsamp = 10.0 / 1.0e-4 = 10e+5.
Sensitivities
The sensitivity plots available in DesignXplorer allow you to efficiently improve your design toward a more reliable
and better quality design, or to save money in the manufacturing process while maintaining the reliability and
quality of your product. You can request a sensitivity plot for any response or derived parameter in your model.
The sensitivities available under the Six Sigma Analysis and the Goal Driven Optimization views are statistical
sensitivities. Statistical sensitivities are global sensitivities, whereas the single parameter sensitivities available
under the Responses view are local sensitivities. The global, statistical sensitivities are based on a correlation
analysis using the generated sample points, which are located throughout the entire space of input parameters.
The local single parameter sensitivities are based on the difference between the minimum and maximum value
obtained by varying one input parameter while holding all other input parameters constant. As such, the values
obtained for single parameter sensitivities depends on the values of the input parameters that are held constant.
Global, statistical sensitivities do not depend on the settings for the input parameters, because all possible values
for the input parameters are already taken into account when determining the sensitivities.
To display statistical sensitivities, DesignXplorer groups the input parameters into two groups: significant and
insignificant. DesignXplorer displays sensitivities as both a bar chart and pie chart. Sensitivities are ranked such
that the most important input parameters appear first.
In the bar charts, the most important uncertainty variable (with the highest sensitivity) appears at the top and
the others follow below in the order of their importance. The charts describe the sensitivities in an absolute
fashion (taking the signs into account); a positive sensitivity indicates that increasing the value of the uncertainty
variable increases the value of the result parameter for which the sensitivities are plotted. Conversely, a negative
sensitivity indicates that increasing the uncertainty variable value reduces the result parameter value.
In the pie charts, sensitivities are relative to each other. The most important uncertainty variable (with the highest
sensitivity) will appear first after the 12 o'clock position, and the others follow in clockwise direction in the order
of their importance.
Using a sensitivity plot, you can answer the following important questions.
How can I make the component more reliable or improve its quality?
If the results for the reliability or failure probability of the component do not reach the expected levels, or if the
scatter of an output parameter is too wide and therefore not robust enough for a quality product, then you
should make changes to the important input variables first. Modifying an input variable that is insignificant
would be waste of time.
Of course, you are not in control of all uncertainty parameters. A typical example where you have very limited
means of control are material properties. For example, if it turns out that the environmental temperature (outdoor)
is the most important input parameter, then there is probably nothing you can do. However, even if you find
out that the reliability or quality of your product is driven by parameters that you cannot control, this data has
importance -- it is likely that you have a fundamental flaw in your product design! You should watch for influential
parameters like these.
If the input variable you want to tackle is a geometry-related parameter or a geometric tolerance, then improving
the reliability and quality of your product means that it might be necessary to change to a more accurate manu-
facturing process or use a more accurate manufacturing machine. If it is a material property, then there might
be nothing you can do about it. However, if you only had a few measurements for a material property and con-
sequently used only a rough guess about its scatter, and the material property turns out to be an important
driver of product reliability and quality, then it makes sense to collect more raw data.
How can I save money without sacrificing the reliability or the quality of the product?
If the results for the reliability or failure probability of the component are acceptable or if the scatter of an output
parameter is small and therefore robust enough for a quality product, then there is usually the question of how
to save money without reducing the reliability or quality. In this case, you should first make changes to the input
variables that turned out to be insignificant, because they do not effect the reliability or quality of your product.
If it is the geometrical properties or tolerances that are insignificant, you can consider applying a less expensive
manufacturing process. If a material property turns out to be insignificant, then this is not typically a good way
to save money, because you are usually not in control of individual material properties. However, the loads or
boundary conditions can be a potential for saving money, but in which sense this can be exploited is highly
problem-dependent.
Theory
The purpose of a Six Sigma Analysis is to gain an understanding of the impact of uncertainties associated with
the input parameter of your design. This goal is achieved using a variety of statistical measures and postprocessing
tools.
Statistical Postprocessing
Convention: Set of data xi.
1. Mean Value
Mean is a measure of average for a set of observations. The mean of a set of n observations is defined as
follows:
1 n
^ = y
i (1)
ni=1
2. Standard Deviation
Standard deviation is a measure of dispersion from the mean for a set of observations. The standard
deviation of a set of n observations is defined as follows:
1 n ^ 2
^ = (y i − )
(n − 1) i=1 (2)
3. Skewness
Skewness is a measure of degree of asymmetry around the mean for a set of observations. The observa-
tions are symmetric if distribution of the observations looks the same to the left and right of the mean.
Negative skewness indicates the distribution of the observations being left-skewed. Positive skewness
indicates the distribution of the observations being right-skewed. The skewness of a set of n observations
is defined as follows:
3
n n y
− ^
^ = i (3)
(n − 1)(n − 2) i=1
4. Kurtosis
5. Shannon Entropy
where Pi represents mass density of a parameter. In the context of statistics/probability, entropy becomes
a measure of complexity and predictability of a parameter. A more complex, and less predictable, para-
meter carries higher entropy, and vice versa. For example, a parameter characterized with uniform dis-
tribution has higher entropy than that with truncated triangular distribution (within the same bounds).
Hence, the parameter characterized with uniform distribution is less predictable compared to the trian-
gular distribution. In the context of robust design, a response parameter is more robust if the Shannon
entropy is minimized.
Ni
Pi=
N w (6)
DesignXplorer uses the probability mass in a normalized fashion, such that not only the shape, but the
range of variability, or the distribution is accounted for. This is shown in Equation 6, where N i/N is the
relative frequency of the parameter falling into a certain interval, and ∆w is the width of the interval. As
a result, Shannon entropy can have a negative value. Below are some comparisons of the Shannon entropy,
where S2 is smaller than S1.
Signal-to-noise ratios were introduced by Genichi Taguchi as a quality control measure for robust design.
In robust design, the relationship between design parameters and product performance is explored to
perform correctly and predictably in the presence of controllable design parameters and uncontrollable
noise factors. In essence, robust design is seeking to design a product or a process which is insensitive,
or robust, to the causes of quality problems by maximizing performance and minimizing variation. The
signal-to-noise ratio has the following three forms:
• Larger is Better. A measure used for characterizing response parameters such as material yield. Robust
design seeks to maximize the measure, which is defined as follows:
1 n 1
= −10 log n 2 (7)
i=1 y
i
• Smaller is Better. A measure used for characterizing response parameters such as model deformation.
Robust design seeks to maximize the measure, which is defined as follows:
1 n
= −10 log y2i
n i=1 (8)
• Nominal is Best. A measure used for characterizing design parameters such as model dimension in
a tolerance design, in which a specific dimension is required, with an acceptable standard deviation.
Robust design seeks to maximize this measure. However, it is noted that the maximization can happen
to either the standard deviation, the mean value, or both. Therefore, achieving the goal of maximiz-
ation may not necessarily mean having an optimum design because the targeted/specified value
may be off. The measure is defined as follows:
^
= 20 log
^ (9)
The three signal-to-noise ratios are mutually exclusive. Therefore, for a given parameter, only one of
them can be parameterized.
Caution: The three signal-to-noise ratios inherently tie the goal of variation reduction together
with the overall optimization problem, which makes them insufficient and inflexible for use in
robust design.
Note — The minimum and maximum values strongly depend on the number of samples. If you
generate a new sample set with more samples, then chances are that the minimum value will
be lower in the larger sample set. Likewise, the maximum value of the larger sample set will most
likely be higher than for the original sample set. Hence, the minimum and maximum values
should not be interpreted as absolute physical bounds.
The sensitivity charts displayed under the Six Sigma Analysis view are global sensitivities based on
statistical measures (see Single Parameter Sensitivities). Generally, the impact of an input parameter on
a response parameter is driven by:
• The amount by which the output parameter varies across the variation range of an input parameter.
• The variation range of an input parameter. Typically, the wider the variation range is, the larger the
impact of the input parameter will be.
The statistical sensitivities used under Six Sigma Analysis are based on the Spearman-Rank Order Correl-
ation coefficients that take both those aspects into account at the same time.
Basing sensitivities on correlation coefficients follows the concept that the more strongly a response
parameter is correlated with a particular input parameter, the more sensitive it is with respect to changes
of that input parameter.
9. Spearman Rank-Order Correlation Coefficient
where:
T
Ri = rank of xi within the set of observations 1 2 n
x x ...x
T
Si = rank of yi within the set of observations 1 2 n
y y ...y
R, S
= average ranks of a Ri and Si respectively
10. Significance of Correlation Coefficients
Since the sample size n is finite, the correlation coefficient rp is a random variable itself. Hence, the cor-
relation coefficient between two random variables X and Y usually yields a small, but nonzero value,
even if X and Y are not correlated at all in reality. In this case, the correlation coefficient would be insig-
nificant. Therefore, we need to find out if a correlation coefficient is significant or not. To determine the
significance of the correlation coefficient, we assume the hypothesis that the correlation between X and
Y is not significant at all, i.e., they are not correlated and rp = 0 (null hypothesis). In this case the variable:
t = rP n−2
1− rP2 (13)
is approximately distributed like the student's t-distribution with ν = n - 2 degrees of freedom. The cu-
mulative distribution function student's t-distribution is:
+1
t 2 − 2
1 x
A(t | ) =
1 1+ dx
B , (14)
−t
2 2
where:
There is no closed-form solution available for Equation 14. See Abramowitz and Stegun (Pocketbook of
Mathematical Functions, abridged version of the Handbook of Mathematical Functions, Harry Deutsch,
1984) for more details.
The larger the correlation coefficient rp, the less likely it is that the null hypothesis is true. Also, the larger
the correlation coefficient rp, the larger is the value of t from Equation 13 and consequently also the
probability A(t|ν) is increased. Therefore, the probability that the null hypothesis is true is given by 1-
A(t|ν). If 1-A(t|ν) exceeds a certain significance level, for example 2.5%, then we can assume that the null
hypothesis is true. However, if 1-A(t|ν) is below the significance level, then it can be assumed that the
null hypotheses is not true and that consequently the correlation coefficient rp is significant. This limit
can be changed in Section : DesignXplorer Options.
11. Cumulative Distribution Function
The cumulative distribution function of sampled data is also called the empirical distribution function.
To determine the cumulative distribution function of sampled data, you need to order the sample values
in ascending order. Let xi be the sampled value of the random variable X having a rank of i, i.e., being
the ith smallest out of all n sampled values. The cumulative distribution function Fi that corresponds to
xi is the probability that the random variable X has values below or equal to x i. Since we have only a
limited amount of samples, the estimate for this probability is itself a random variable. According to Ke-
cecioglu (Reliability Engineering Handbook, Vol. 1, 1991, Prentice-Hall, Inc.), the cumulative distribution
function Fi associated with xi is:
n
n! Fk (1− F )n−k = 50%
(n − k)!k! i i (15)
k=i
The cumulative distribution function of sampled data can only be given at the individual sampled values
x1, x2, ..., xi, xi+1, ..., xn using Equation 15. Hence, the evaluation of the probability that the random variable
is less than or equal to an arbitrary value x requires an interpolation between the available data points.
If x is, for example, between xi and xi+1, then the probability that the random variable X is less or equal
to x is:
x − xi
P(X x) = Fi + (Fi+1− Fi )
xi+1 − xi (16)
The cumulative distribution function of sampled data can only be given at the individual sampled values
x1, x2, ..., xi, xi+1, ..., xn using Equation 15. Hence, the evaluation of the inverse cumulative distribution
function for any arbitrary probability value requires an interpolation between the available data points.
The evaluation of the inverse of the empirical distribution function is most important in the tails of the
distribution, where the slope of the empirical distribution function is flat. In this case, a direct interpolation
between the points of the empirical distribution function similar to Equation 16 can lead to inaccurate
results. Therefore, the inverse standard normal distribution function Φ-1 is applied for all probabilities
involved in the interpolation. If p is the requested probability for which we are looking for the inverse
cumulative distribution function value, and p is between Fi and Fi+1, then the inverse cumulative distri-
bution function value can be calculated using:
−1(p) − −1(Fi )
x = xi + (xi+1 − xi ) (17)
−1 i −1 i
(F + 1) − (F )
Robust Design is based on assumptions regarding scatter, or uncontrollable uncertainties. Scatter in the input
parameters that affect the response parameters will cause the response parameters to also be uncertain and
therefore less predictable. Robust Design is based on the result parameters of a Six Sigma Analysis. Therefore,
before you run a Robust Design analysis, you must first parameterize the results of a Six Sigma Analysis. To un-
derstand which Six Sigma Analysis parameters should be parameterized, look at how robustness can be defined
and measured.
• Reduction of Variability: If the input parameters that affect response parameters are subjected to uncertainty
and scatter, the response parameters are also uncertain; i.e., they will show variability to some degree.
Used to reduce the variability of product behavior, you can use the following Six Sigma Analysis result
parameters:
– Standard Deviation: The standard deviation is a measure of how wide the scatter, or how large the
variability, of the response parameter is. Minimizing the standard deviation will lead to a smaller range
of variability; i.e., the chance that the response parameters will differ largely from the mean value de-
creases. Therefore, the goal of a Robust Design analysis is to minimize the standard deviation of a re-
sponse parameter, as shown below.
– Kurtosis: Kurtosis is a measure of how peaked a distribution is. When kurtosis increases, the distribution
is more peaked, and fewer samples will be located further away from the mean value. Therefore, the
goal of a Robust Design analysis is to maximize the kurtosis of a response parameter, as shown below.
You should read Section : Guidelines and Best Practices before using kurtosis.
– Signal-to-Noise Ratios: The goal of minimizing the standard deviation (or noise) of a response parameter
is inherently coupled with the goal of shifting the mean value (or signal). Different ratios are appropriate
for different shifts of the mean (e.g., for maximizing the mean, minimizing the mean, etc.). The goal
of a Robust Design analysis is to minimize the noise, which means the signal-to-noise ratio of a response
parameter must be maximized. You should read Section : Guidelines and Best Practices before using
signal-to-noise ratios.
– Shannon Entropy: Shannon entropy is a measure of the complexity or predictability of the distribution
of a response parameter. Entropy is a measure of the irreversible loss a real engineering system exper-
iences as compared to a perfectly efficient, lossless system. For the distribution of a response parameter,
entropy is a measure of the loss of information for a result subjected to uncertainty as compared to a
completely predictable result. For example, if you knew that a response parameter always has a value
of 5.0, regardless of the input parameter values, the response parameter would be completely predict-
able and very easy to describe, because a single scalar value sufficiently characterizes its behavior as
a function of the input parameters. When the response parameter is affected by randomness, the
predictability is lost and its behavior as a function of the input parameters is no longer characterized
by a single value, but is more complex. The wider the scatter of the response parameter, the more
predictability is lost and the more complex its behavior characterization. Therefore, the goal of a Robust
Design analysis is to minimize the Shannon entropy of a response parameter.
• Six Sigma Analysis: Robust Design that is interpreted from a Six Sigma Analysis leads to an optimization
problem that tries to achieve or enforce a design that satisfies Six Sigma Analysis quality goals, as outlined
in Six Sigma Analysis. In this case, sigma levels (in probability and inverse probability tables) are used as
Robust Design parameters. Depending on whether your focus is on the lower or upper specification limit,
a Robust Design analysis will try to minimize the sigma level to below -6 or above +6, or both, as shown
below. If +/- 6 is too strict (or not strict enough) for your study, you can adjust the value.
• Reliability-based Optimization: In a more general probabilistic sense, a product can be considered robust
if it is reliable. If interpreted this way, Robust Design becomes an optimization tool to improve product
reliability. Here, reliability is the probability that the product functions as expected; i.e., conforms to the
specification criteria. This is very similar to Six Sigma Analysis, except that here you deal directly with the
probabilities as parameters (in probability and inverse probability tables) in one of two ways:
– Insert the value of the lower or upper specification limit in the probability table. You will then obtain
the probability of the response parameter dropping below that limit, which can be parameterized.
Depending on whether it is the lower or upper limit, the analysis will try to either minimize or maximize
the probability. See Section : Guidelines and Best Practices for more details.
– Insert the targeted non-conformance probability into the inverse probability table. You will get a value
for the response parameter corresponding to that non-conformance probability, which you can then
parameterize. For a design that is not robust enough, the value will be outside the specified interval.
Depending on whether it is the lower or upper limit, the analysis will try to either minimize or maximize
the probability. See Section : Guidelines and Best Practices for more details.
For example, to ensure that the maximum stress does not exceed an admissible limit, you might make the
component thicker in some places, which makes it heavier and more expensive. So, if your Robust Design ana-
lysis tries to reduce the standard deviation, increase a sigma level, or reduce the non-conformance probability,
do not just minimize or maximize the quantities. Instead, if you have a target value for those quantities, use the
analysis to find a design that is just on the correct side of the target; i.e., less or greater than the target value.
and
Because a 32-bit computer can usually represent 8 or 9 significant digits. Since both numbers have more than
8 or 9 significant digits, they would both be rounded to 1.0. Therefore, if you work with the probabilities in the
probability tables, you should use derived parameters to avoid this problem.
If you are working with a lower specification limit, then a Robust Design analysis might try to reduce the probab-
ility of dropping below that limit. In this case, you are working with the lower tail of the distribution of the response
parameter, thus avoiding a rounding problem.
If you are working with the upper specification limit, you can avoid the rounding problem by using a derived
parameter with the following equation.
YDerived = YUSL - Y
Here, YDerived is the name of the derived parameter, YUSL is the value of the upper specification limit for the response
parameter, and Y is the name of the response parameter itself. If the value of the response parameter exceeds
the upper specification limit, the derived parameter becomes negative. The more the value of the response
parameter exceeds the upper specification limit, the smaller the value of the derived parameter. Parameterizing
the probability that the derived parameter is less than zero and then reducing that probability will not cause a
rounding problem because you will be working with the lower tail of the distribution.
If you have a response parameter that is supposed to be bounded by both lower and upper specification limits,
you should define a derived parameter with the following equation.
This derived parameter will become negative whether the value of the response parameter drops below the
lower limit or exceeds the upper limit. As above, you avoid the rounding problem.
If you are working with probabilities that are only moderately close to 1.0, such as 0.999 or 0.9999, you will not
typically have a rounding problem, but you may still want to use a derived parameter.
You can also avoid the rounding problem by using sigma levels instead of probabilities. For example, a sigma
level of 10.0 is approximately equivalent to a probability of 1.0 - 7.6e-24, which is a number so close to 1.0 that
it would be rounded to 1.0. However, using the 10.0 sigma level can be represented without the rounding
problem.
• Parameterizing the mean value and either a probability, sigma level, or inverse probability value of the
same response parameter at the same time.
Sometimes it makes sense to try to increase a mean value while at the same time reduce the probability
of exceeding an upper limit time, as shown below. However, trying to increase a mean value and decrease
the value of a response parameter at a probability of 50% is a conflict, because those two values are usually
not far from each other. In fact, for symmetric distributions, the mean value and the 50% value are always
identical.
• Parameterizing two probabilities, sigma levels, or inverse probability values for the same parameter at
the same time.
If you are trying to achieve a design that is bounded by both lower and upper specification limits and you
want a small probability of non-conformance on both sides, then you can insert both the lower and the
upper specification limits in a probability table, parameterize both resulting probabilities, and run a Robust
Design analysis that tries to push both probabilities to the desired levels. However, you may encounter
the rounding problem mentioned above. Additionally, if you use probabilities that are too close to each
other and try to push them apart in a Robust Design analysis. You may encounter convergence problems.
You could encounter similar difficulties if you parameterize two sigma levels or inverse probability values.
Theory
Robust Design is a combination of Goal Driven Optimization and Six Sigma Analysis. For theory information,
refer to Goal Driven Optimization theory and Six Sigma Analysis theory.
Modify the parameter values and click Insert a new “What-If” design point under the table.
When done inserting design points, click Run in the toolbar. This will run an analysis of the design points that
you captured. When the analysis is finished, click What-If Charts in the Views task pane to explore the results.
The charts are designed to support plotting any input or output versus any other input or output.
A standard Simulation is performed after importing the model from its CAD system, followed by a DesignXplorer
analysis. The following steps begin before a Simulation solution is obtained.
Task Action
1. While in Simulation, specify the following as parameters: Check the boxes to the left of the items in the Details View.
See Section : Specifying Parametersfor details.
• Number of small holes
• Large hole radius
• Depth
• Small hole radius
• Distance of holes from center
• Equivalent stress, Maximum
• Maximum principal stress, Maximum
• Middle principal stress, Maximum
• Minimum principal stress, Maximum
• Total deformation, Maximum
• Stress intensity, Maximum
• Normal stress, Maximum
• Shear stress, Maximum
2. Obtain a Simulation solution. Click the Solve button. See Section : Solving for details.
3. Start DesignXplorer. Click the [Project] tab, then click Create a new
DesignXplorer study.
4. Modify parameters as follows: Click Parameters in the Views pane and modify the paramet-
ers.
• Number of small holes (Discrete)
– Values: 9, 10, 3, 4, 5, 6, 7, 8
– Lower bound = 67
– Upper bound = 83
• Depth (Continuous)
– Lower bound = 45
– Upper bound = 55
– Lower bound = 27
– Upper bound = 33
Task Action
5. Solve the DesignXplorer analysis. Click Run in the toolbar, then click:
6. View a response surface of the DesignXplorer results. • Click Responses in the Views pane.
• Click Response Charts in the Responses sub-options
menu.
• Move the cursor as shown in DesignXplorer VT.
DesignXplorer VT Walkthrough
The following example builds the model shown with a pressure load and a fixed support.
A standard Simulation is then performed, followed by a DesignXplorer VT analysis. The following steps begin
before a Simulation solution is obtained.
One of the most useful features of DesignXplorer VT is its ability to recalculate nodal results “on the fly” without
the need for repeated solutions. This feature is illustrated in steps 6 and 7 below, where you can view the results
of varying input parameters in real time.
Task Action
1. While in Simulation, specify the following as parameters: Check the boxes to the left of the items in the Details View.
See Section : Specifying Parameters for details.
• Hole radius
• Back height
• Front height
• Equivalent stress, Maximum
• Maximum principal stress, Maximum
• Middle principal stress, Maximum
• Minimal principal stress, Maximum
• Total deformation, Maximum
2. Obtain a Simulation solution. Click the Solve button. See Section : Solving for more details.
3. Start DesignXplorer VT. Click the [Project] tab, then click Create a new
DesignXplorer VT study.
Task Action
4. Modify parameters as follows: Click Parameters in the Views pane and modify the paramet-
ers.
• Hole radius
• Back height
• Front height
5. Solve the DesignXplorer VT analysis. Click Run in the toolbar, then click:
6. View a response surface of the DesignXplorer VT results. • Click Responses in the Views pane.
• Click Response Charts in the Responses sub-options
menu.
• Move the cursor as shown.
7. View an animation of the DesignXplorer VT results. • Click Responses in the Views pane.
•
Click the Animate button to display the anim-
ation.
To solve a DesignXplorer VT analysis, click the Run button on the toolbar, and then click:
• Verify Geometry Parameters: Checks to assure that parameter ranges are valid and do not cause any
topological changes in the model. If you see errors after performing this stage of the execution, adjust
the parameter ranges and try again.
• Mesh Morph: Performs the mesh morphing. Errors in this phase indicate that the input parameter ranges
deform the elements too much. Ranges will be automatically adjusted.
Note — Clicking this choice automatically performs the previous two choices.
Response Surface
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
Moving the cursor allows you to pan or zoom to various portions of the chart. Shown here is zooming.
Animation
The following is an animated GIF. Please view online if you are reading the PDF version of the help.
The animation shows another instantaneous rendering of how varying the input parameters changes the output
parameter.
Task Action
1. While in Simulation, specify the following as parameters: Check the boxes to the left of the items in the Details View.
See Section : Specifying Parameters for details.
• Columns
• Maximum Displacement
2. Obtain a Simulation solution. Click the Solve button. See Section : Solving for more details.
3. Start DesignXplorer VT. Click the [Project] tab, then click Create a new
DesignXplorer VT study.
4. Select (by checkbox) all the input parameters. Click Parameters in the Views pane and modify the paramet-
ers.
5. Solve the DesignXplorer VT analysis. Click Run in the toolbar.
6. Generate a Screening sample set. • Click Goal Driven Optimization in the Views pane.
• Select Screening and click Generate.
7. Set the response parameter goal. • Set the Desired Value for the maximum deformation
to Minimum Possible.
• Click Generate or update candidate designs based
on current goals.
8. View the Pareto fronts. Click TradeOff Study in the View Sub-options.
9. Create an Advanced sample set. •
Click in the toolbar.
• Set the Desired Value for maximum deformation to
No Preference.
• Click Generate.
10. View the first Pareto front. Click TradeOff Study in the View Sub-options.
This example uses a typical APDL problem illustrating a Bernoulli-Euler beam under a concentrated load, as
shown below. The volume of the beam, natural frequency, buckling strength, and tip deflection are used as
output parameters. The input parameters are shown below.
Task Action
1. Start ANSYS Workbench and link to the existing APDL file. Start an empty project, then click on Link to ANSYS APDL
Input... in the [Project] tab.
8
Section : APDL and Goal Driven Optimization Walkthrough
Task Action
2. Define input and response parameters included in the APDL Click on Edit mapping of APDL parameters... in the [Project]
file. tab. This will add a new [APDL Parameter] tab to the view.
In this tab you can select input and output parameters.
3. Start DesignXplorer. Click the [Project] tab, then click Create a new
DesignXplorer study.
4. Set all parameters to have be continuous with 10% vari- Click Parameters in the Views pane and modify the paramet-
ation. ers.
5. Solve. Click Run in the toolbar.
6. Generate a sample set. Click Goal Driven Optimization in the Views pane and Goals
& Candidates in the View Sub-options. Select the Screening
option with 6000 samples, then click Generate.
7. View the three best candidate designs. Click Generate or update candidate designs based on the
current goals.
8. View the non-dominated Pareto fronts. Click TradeOff Study in the View Sub-options.
9. Generate an Advanced sample set.
Click in the toolbar, then generate an Advanced sample
set with 200 samples and 30 iterations.
10. View the Pareto fronts for the Advanced sample set. • Select the new sample set.
• Click TradeOff Study in the View Sub-options.
• Select the output axes marked TradeOff On.
11. Save a new sample set. • Move the slider to the far left to see only the first
Pareto front.
•
Click in the toolbar to save this front as a separate
sample set.
12. Update candidate designs. • Select the sample set you've just created.
• Click Goals & Candidates, then Generate or update
candidate designs based on the current goals. This
will display the three best candidate designs for the
first Pareto front based on the preferences you set.
Task Action
14. View the Pareto fronts for the new Advanced sample set. • Click TradeOff Study.
• Move the slider all the way to the left to display only
the first Pareto front.
•
Click to save the front as a new sample set.
15. Update the candidate designs. • Select the sample set you've just created.
• Click Goals & Candidates, then Generate or update
candidate designs based on the current goals. This
will display the three best candidate designs for the
first Pareto front based on the preferences you set.
Task Action
1. Start ANSYS Workbench and link to the existing APDL file. Start an empty project, then click on Link to ANSYS APDL
Input... in the [Project] tab.
2. Define input and response parameters included in the APDL Click on Edit mapping of APDL parameters... in the [Project]
file. tab. This will add a new [APDL Parameter] tab to the view.
In this tab you can select input and output parameters.
3. Start DesignXplorer. Click the [Project] tab, then click Create a new
DesignXplorer study.
4. Modify parameters as follows: Click Parameters in the Views pane and modify the paramet-
ers.
• Set the parameters to be Uncertainty variables.
• Change associated distributions with the Distribution
Type drop-down menu.
• Parameters of a distribution can be edited in the
Parameter Properties table. Resulting statistics are
displayed in the Distribution Attributes table.
10
Section : APDL and Robust Design Walkthrough
Task Action
6. Generate a sample set. • Click Six Sigma Analysis in the Views pane.
• Set the number of samples to 10000.
• Click Generate.
7. Review the Six Sigma Analysis results. • Select Charts from the View Sub-options to display
distribution charts for input and output parameters,
as well as the histogram and cumulative distribution
function plots, shown below.
• Select Tables from the View Sub-options to display
probability tables.
8. Add a value to the Probability Table. Type a new parameter value in the field above Insert New
Parameter Value and click the button. Review the new table
information.
Task Action
1. Start ANSYS Workbench and link to the existing APDL file. Start an empty project, then click on Link to ANSYS APDL
Input... in the [Project] tab.
2. Define input and response parameters included in the APDL Click on Edit mapping of APDL parameters... in the [Project]
file. tab. This will add a new [APDL Parameter] tab to the view.
In this tab you can select input and output parameters.
3. Start DesignXplorer. Click the [Project] tab, then click Create a new
DesignXplorer study.
4. Modify parameters as follows: Click Parameters in the Views pane and modify the paramet-
ers.
• Set the parameters to be Uncertainty variables, except
for one, which must be a Design variable.
• Change associated distributions with the Distribution
Type drop-down menu.
• Parameters of a distribution can be edited in the
Parameter Properties table. Resulting statistics are
displayed in the Distribution Attributes table.
7. Review and parameterize the Six Sigma Analysis results. • Select Charts from the View Sub-options to display
distribution charts for input and output parameters,
as well as the histogram and cumulative distribution
function plots, shown below. Specific rows in the
output distributions can be parameterized by clicking
the box next to them.
• Select Tables from the View Sub-options to display
probability tables. Values in the tables can be paramet-
erized by clicking the box next to them.
8. Generate a Robust Design sample set. • Click Robust Design in the Views pane and Goals &
Candidates in the View Sub-options.
• Generate a Screening sample set with 6000 samples.
Task Action
9. View the three best candidate designs. Click Goals & Candidates in the View Sub-options to set goals
and update candidate designs.
10. View the Pareto fronts. Click TradeOff Study in the View Sub-options.
11. Create an Advanced sample set. •
Click in the toolbar.
• Click Generate.
12. View the Pareto fronts. • Click TradeOff Study in the View Sub-options.
• Select the output axes marked TradeOff On.
13. View the Pareto fronts for the new Advanced sample set. • Click TradeOff Study.
• Move the slider all the way to the left to display only
the first Pareto front.
•
Click to save the front as a new sample set.
14. Update the candidate designs. • Select the sample set you've just created.
• Click Goals & Candidates, then Generate or update
candidate designs based on the current goals. This
will display the three best candidate designs for the
first Pareto front based on the preferences you set.
17. Update the candidate designs. • Select the sample set you've just created.
• Click Goals & Candidates, then Generate or update
candidate designs based on the current goals. This
will display the three best candidate designs for the
first Pareto front based on the preferences you set.
Note — Make sure the personal parameter key in the control panel is consistent with your geometry
parameters.
Custom Design Point A design point which has parameter values calculated in DesignXplorer. As such,
the parameter values are approximate and calculated from response charts.
Design of Experiments Optimization method (used in DesignXplorer) where each change of the value
(DOE) of any input variable requires a new finite element analysis. To perform a “what-
if study” where several input variables are varied in a certain range, a considerable
number of finite-element analyses may be required to satisfactorily evaluate the
finite-element results over the space of the input variables. The DOE method
generates a response surface using curve and surface fitting algorithms to “fit”
output data as a function of input data. This requires a group of design points
where each point is generated via a finite element solve.
Input Parameters Those parameters that define the geometry (e.g., length, width, thickness) to the
analysis for the structure under investigation.
In each loop, the Six Sigma Analysis tool uses the values of the uncertainty vari-
ables from one sample and executes the user-specified analysis. The Six Sigma
Analysis tool collects the values for the uncertainty variables following each loop.
Mean Value A measure of location often used to describe the general location of the bulk of
the scattering data of a random output parameter or of a statistical distribution
function.
Mathematically, the mean value is the arithmetic average of the data. The mean
value also represents the center of gravity of the data points. Another name for
the mean value is the expected value.
Median Value The statistical point where 50% of the data is below the value and 50% is above.
For symmetrical distribution functions (Gaussian, uniform, etc.) the median value
and the mean value are identical, but for nonsymmetrical distributions, they are
different.
Output Parameters Parameters that define the response outputs (e.g., volume) from the analysis.
Pareto Set A concept used in multi-objective optimization, especially where some or all of
the objectives are mutually conflicting. In such a case, there is no single point
which simultaneously yields the “best” value of all the objectives. Instead, the
best solutions, called a Pareto or non-dominated set, are a group of solutions
such that selecting any one of them in place of another will always sacrifice the
quality of at least one objective while improving at least one other.
Response Surface The empirical relationship between a variable of interest, y, and a set of independ-
ent variables, x1, x2, x3, ... Usually the function y = F(x1, x2, x3, . . . ) is a polynomial
or some other well-defined relationship, which forms the response surface
model of y. When applied to design and analysis in the realm of CAD and CAE,
a response surface is the representation of the physical behavior of a structure
in terms of its independent variables. For example, a response surface can be
devised for the fundamental frequency (F) of a structure as a function of CAD
geometry parameters (R, L) and the modulus of elasticity (E); that is, F = G(R,L,E).
The result parameters are typically a function of the uncertainty variables; that
is, changing the values of the uncertainty variables should change the value of
the result parameters.
Sample A unique set of parameter values that represents a particular model configuration.
In statistics, however, sample also has a wider and more general use. For example,
any single measured value of any physical property is considered to be one
sample. Because a Six Sigma Analysis is based on a statistical evaluation of the
result parameters, the values of the result parameters are also called samples.
Standard Deviation A measure of variability (i.e., dispersion or spread) about the arithmetic mean
value, often used to describe the width of the scatter of a random output para-
meter or of a statistical distribution function.
The larger the standard deviation, the wider the scatter, and the more likely it is
that there are data values further apart from the mean value.
In a Six Sigma Analysis, uncertainty variables are often called "drivers" because
they drive the result of an analysis. You must specify the type of statistical distri-
bution the uncertainty variables follow and the parameter values of their distri-
bution functions.
Variational Technology Optimization method (used in DesignXplorer VT) that is based on a single finite-
element solve, combined with the use of mesh morphing and the Taylor series
expansion approximation. The Taylor series expansion handles up to 10 input
variables, and can be used with multiple input variables or shape parameters.
See Variational Technology for further details.
View Details Bottom frame of left pane. Offers detailed choices when an item is selected from
the Views pane and/or View Sub-options.
Views Pane Top of left pane. The Views pane is used to choose sections of DesignXplorer to
view.
View Sub-options Middle of left pane. When an option is chosen in the Views pane, sub-options, if
available, will be displayed.
The solutions for the test cases have been verified, however, certain differences may exist with regard to the
references. These differences have been examined and are considered acceptable. The workbench analyses
employ a balance between accuracy and solution time. Improved results can be obtained in some cases by em-
ploying a more refined finite element mesh but requires longer solution times. For the tests, an error rate of 3%
or less has been the goal.
These tests were run on an Intel Xeon processor using Microsoft Windows XP Professional. These results are re-
ported in the test documentation. Slightly different results may be obtained when different processor types or
operating systems are used.
The tests contained in this manual are a partial subset of the full set of tests that are run by ANSYS developers
to ensure a high degree of quality for the Workbench product. The verification of the Workbench product is
conducted in accordance with the written procedures that form a part of an overall Quality Assurance program
at ANSYS, Inc.
You are encouraged to use these tests as starting points when exploring new Workbench features. Geometries,
material properties, loads, and output results can easily be changed and the solution repeated. As a result, the
tests offer a quick introduction to new features with which you may be unfamiliar.
Some test cases will require different licenses, such as DesignModeler, Emag, or DesignXplorer. If you do not
have the available licenses, you may not be able to reproduce the results. The Educational version of Workbench
should be able to solve most of these tests. License limitations are not applicable to Workbench Education version
but problem size may restrict the solution of some of the tests.
The working directories for each of the Verification Manual tests are available on the installation media at
<drive>:/ansys_inc/v100/aisol/Samples/AWEVM
. These databases provide all of the necessary elements for running a test, including geometry parts, material
files and workbench databases. To open a test case in workbench, locate the working directory and double-click
the Workbench database (.wbdb).
You can use these tests to verify that your hardware is executing the ANSYS Workbench tests correctly. The results
in the databases can be cleared and the tests solved multiple times. The test results should be checked against
the verified results in the documentation for each test.
ANSYS Inc. offers the Workbench Verification and Validation package for users that must perform system validation.
This package automates the process of test execution and report generation. If you are interested Readers inter-
ested in contracting for such services may contact the ANSYS, Inc. Quality Assurance Group.
Test Case
An assembly of three prismatic bars is supported at both end faces and is axially loaded with forces F1 and F2.
Force F1 is applied on the face between Parts 2 and 3 and F2 is applied on the face between Parts 1 and 2. Apply
advanced mesh control with element size of 0.5”.
Results Comparison
Results Target DS Error (%)
Y Reaction Force at Top Fixed 900 901.14 0.127
Support (lbf)
Y Reaction Force at Bottom Fixed 600 598.86 -0.190
Support (lbf)
Test Case
A rectangular plate with a circular hole is fixed along one of the end faces and a tensile pressure load is applied
on the opposite face. A convergence with an allowable change of 10% is applied to account for the stress con-
centration near the hole. The Maximum Refinement Loops is set to 2 and the Refinement mesh control is added
on the cylindrical surfaces of the hole with Refinement = 1.
Find the Maximum Normal Stress in the x direction on the cylindrical surfaces of the hole.
Results Comparison
Results Target DS Error (%)
Maximum Normal X Stress (Pa) 312.5 313.85 0.432
Test Case
An assembly of three annular plates has cylindrical support (fixed in the radial, tangential, and axial directions)
applied on the cylindrical surface of the hole. Sizing control with element size of 0.5” is applied to the cylindrical
surface of the hole.
Results Comparison
Results Target DS Error (%)
1st Frequency Mode (Hz) 310.911 311.03 0.038
2nd Frequency Mode (Hz) 318.086 316.34 -0.549
3rd Frequency Mode (Hz) 318.086 316.81 -0.401
4th Frequency Mode (Hz) 351.569 347.77 -1.081
5th Frequency Mode (Hz) 351.569 348.26 -0.941
6th Frequency Mode (Hz) 442.451 437.97 -1.013
Test Case
A rectangular plate (1300 x 1300 mm) with a hole is modeled with one-quarter symmetry. It has frictionless
support applied on the two flat faces along the thickness near the hole. Pressure loads are applied on the remaining
two flat faces along the thickness as shown below. Apply advanced mesh control with element size of 29 mm
to get accurate results.
Results Comparison
Results Target DS Error (%)
Optimized Mass (kg) 23.8984 24.115 0.906
Test Case
A furnace wall consists of two layers: fire brick and insulating brick. The temperature inside the furnace is 3000°F
(Tf) and the inner surface convection coefficient is 3.333e-3 BTU/s ft2°F (hf). The ambient temperature is 80°F (Ta)
and the outer surface convection coefficient is 5.556e-4 BTU/s ft2°F (ha).
Results Comparison
Results Target DS Error (%)
Minimum Temperature (°F) 336 336.69 0.205
Maximum Temperature (°F) 2957 2957.2 0.007
Test Case
A liquid is boiled using the front face of a flat electric heater plate. The boiling temperature of the liquid is 212°F.
The rear face of the heater is insulated. The internal energy generated electrically may be assumed to be uniform
and is applied as internal heat generation.
Results Comparison
Results Target DS Error (%)
Maximum Temperature (°F) 476 480.57 0.960
Maximum Total Heat Flux (BTU/s 10 9.9998 -0.002
in2)
Test Case
A long bar has thermal conductivity that varies with temperature. The bar is constrained at both ends by frictionless
surfaces. A temperature of T°C is applied at one end of the bar (End A). The reference temperature is 5°C. At the
other end, a constant convection of h W/m2°C is applied. The ambient temperature is 5°C. Advanced mesh control
with element size of 2 m is applied.
• Minimum temperature
• Maximum thermal strain in z direction (on the two end faces)
• Maximum deformation in z direction
• Maximum heat flux in z direction at z = 20 m
Analysis
Temperature at a distance “z” from rear face is given by:
Tz = −171.82 + 73886.82 − 1492.13x(z)
Deformation
z in the z direction is given by:
u = (1.425 10−5 (T − 5)) dz
z z
0
Results Comparison
Results Target DS Error (%)
Minimum Temperature (°C) 38.02 38.014 -0.016
Maximum Thermal strain (z = 20) 0.000495 0.00049521 0.042
(m/m)
Maximum Thermal strain (z = 0) 0.001425 0.001425 0.000
(m/m)
Maximum Z Deformation (m) 0.00232 0.002341 0.905
Maximum Z Heat Flux (z = 20) 0.165 0.16507 0.042
(W/m2)
Test Case
A steel cooling spine of cross-sectional area A and length L extend from a wall maintained at temperature Tw.
The surface convection coefficient between the spine and the surrounding air is h, the air temper is Ta, and the
tip of the spine is insulated. Apply advanced mesh control with element size of 0.025'.
Find the heat conducted by the spine and the temperature of the tip.
Results Comparison
Results Target DS Error (%)
Temperature of the Tip (°F) 79.0344 79.078 0.055
Heat Conducted by the Spine 6.364e-3 6.3614e-3 -0.041
(Heat Reaction) (BTU/s)
Test Case
A multibody of four bars connected end to end has one of the end faces fixed and a pressure is applied to the
opposite face as given below. The multibody is used to nullify the numerical noise near the contact regions.
Find the maximum equivalent stress for the whole multibody and the safety factor for each part using the max-
imum equivalent stress theory with tensile yield limit.
Material Properties
Material E (Pa) ν Tensile Yield (Pa)
Part 1 1.93e11 0 2.07e8
Part 2 7.1e10 0 2.8e8
Part 3 2e11 0 2.5e8
Part 4 1.1e11 0 2.8e8
Results Comparison
Results Target DS Error (%)
Maximum Equivalent Stress (Pa) 2.5e8 2.5e8 0.000
Safety Factor for Part 1 0.828 0.828 0.000
Safety Factor for Part 2 1.12 1.12 0.000
Safety Factor for Part 3 1 1 0.000
Safety Factor for Part 4 1.12 1.12 0.000
Test Case
A rectangular plate is simply supported on both the smaller edges and fixed on one of the longer edges as shown
below. Sizing mesh control with element size of 6.5 mm is applied on all the edges to get accurate results.
Results Comparison
Results Target DS Error (%)
1st Frequency Mode (Hz) 595.7 590.17 -0.928
2nd Frequency Mode (Hz) 1129.55 1119.8 -0.863
3rd Frequency Mode (Hz) 2051.79 2042.8 -0.438
Test Case
A circular plate is subjected to a uniform pressure on its flat surface. The circular edge of the plate is fixed. To get
accurate results, apply sizing control with element size of 5 mm on the circular edge.
Results Comparison
Results Target DS Error (%)
Total deformation (m) 0.00125 0.0012365 -1.080
Test Case
A stepped rod is fixed at one end face. It is axially loaded by two forces: a tensile load at the free end and a
compressive load on the flat step face at the junction of the two cross sections. To get accurate results, apply
sizing control with element size of 6.5 mm.
Results Comparison
Results Target DS Error (%)
Load Multiplier 22.5 22.958 2.036
Test Case
A circular arch of a rectangular cross section (details given below) is subjected to a pressure load as shown below.
Both the straight edges of the arch are fixed.
Results Comparison
Results Target DS Error (%)
Load Multiplier 544 548.05 0.744
Test Case
An assembly where four cylinders represent massless springs in series and a point mass simulates a spring mass
system. The flat end face of the cylinder (Shaft 1) is fixed. Harmonic force is applied on the end face of another
cylinder (Shaft 4) as shown below.
Find the z directional Deformation Frequency Response of the system on the face to which force is applied for
the frequency range of 0 to 500 Hz for the following scenarios using Mode Superposition. Solution intervals =
20.
Material Properties
Material E (Pa) ν ρ (kg/m3)
Shaft 1 1.1e11 0.34 1e-8
Shaft 2 1.1e11 0.34 1e-8
Shaft 3 4.5e10 0.35 1e-8
Shaft 4 4.5e10 0.35 1e-8
Results Comparison
Results Target DS Error (%)
Maximum Amplitude without 0.1404 0.1412 0.570
damping (m)
Phase angle without damping 0 0 0.000
(degrees)
Maximum Amplitude with damp- 0.14 0.14078 0.557
ing (m)
Phase angle with damping (de- 175.6 175.58 0.000
grees)
Test Case
A two-story building has two columns (2K and K) constituting stiffness elements and two slabs (2M and M) con-
stituting mass elements. The material of the columns is assigned negligible density so as to make them as
massless springs. The slabs are allowed to move only in the y direction by applying frictionless supports on all
the faces of the slabs in the y direction. The end face of the column (2K) is fixed and a harmonic force is applied
on the face of the slab (M) as shown in the figure below.
Find the y directional Deformation Frequency Response of the system at 70 Hz on each of the vertices as shown
below for the frequency range of 0 to 500 Hz using Mode Superposition. Use Solution intervals = 50.
Material Properties
Material E (Pa) ν ρ (kg/m3)
Block 2 2e18 0.3 7850
Shaft 2 4.5e10 0.35 1e-8
Block 1 2e18 0.3 15700
Shaft 1 9e10 0.35 1e-8
Results Comparison
Results Target DS Error (%)
Maximum Amplitude for vertex A 0.20853 0.21002 0.715
(m)
Maximum Amplitude for vertex B 0.074902 0.074902 0.684
(m)
Test Case
A bar of rectangular cross section has the following loading scenarios.
• Scenario 1: One of the end faces is fixed and a force is applied on the opposite face as shown below in
Figure 16.1: “Scenario 1”.
• Scenario 2: Frictionless support is applied to all the faces of the three standard planes (faces not seen in
Figure 16.2: “Scenario 2”) and a pressure load is applied on the opposite faces in positive y- and z-directions.
Find the life, damage, and safety factor for the normal stresses in the x, y, and z directions for non-proportional
fatigue using the Soderberg theory. Use a design life of 1e6 cycles, a fatigue strength factor or 1, a scale factor
of 1, and 1 for coefficients of both the environments under Solution Combination.
Material Properties
E = 2e11 Pa
ν = 0.3
Ultimate Tensile Strength = 4.6e8 Pa
Yield Tensile Strength = 3.5e8 Pa
Endurance Strength = 2.2998e6 Pa
Number of Cycles Alternating Stress (Pa)
1000 4.6e8
1e6 2.2998e6
Analysis
Non-proportional fatigue uses the corresponding results from the two scenarios as the maximum and minimum
stresses for fatigue calculations. The fatigue calculations use standard formulae for the Soderberg theory.
Results Comparison
Results Target DS Error (%)
Stress Component - Life 3335.1049 3329.9 -0.156
Component X Damage 299.8406 300.31 0.157
Safety Factor 0.019 0.019025 0.132
Stress Component - Life 14765.7874 14653 -0.764
Component Y Damage 67.724 68.247 0.772
Safety Factor 0.04569 0.045378 -0.683
Stress Component - Life 14765.7874 14766 0.001
Component Z Damage 67.724 67.725 0.001
Test Case
A cylindrical rod assembly of four cylinders connected end to end has frictionless support applied on all the cyl-
indrical surfaces and both the flat end faces are fixed. Other thermal and structural loads are as shown below.
Find the Deformation in the x direction of the contact surface on which the remote force is applied. To get accurate
results apply a global element size of 1.5 m.
Results Comparison
Results Target DS Error (%)
Maximum X Deformation (m) 0.101815 0.10018 -1.606
Test Case
A long bar assembly is fixed at one end and subjected to a tensile force at the other end as shown below. Turn
on Inertia Relief.
Analysis
PL PL2
z = −
AE 2mE
where:
Results Comparison
Results Target DS Error (%)
Maximum Z Deformation (m) 2.5e-6 2.5038e-6 0.152
Test Case
A mixed model (shell and beam) has one shell edge fixed as shown below. Bending loads are applied on the free
vertex of the beam as given below. Apply a global element size of 80 mm to get accurate results.
Find the deformation in the y direction under Solution Combination with the coefficients for both the environments
set to 1.
Analysis
23 Fl 3 19 Ml 2
y = +
384 EI 128 EI
where:
Results Comparison
Results Target DS Error (%)
Maximum Y-Deformation (mm) -7.18742 -7.2542 0.929
Test Case
Two collinear beams form a spring mass system. The density of the longer beam is kept very low so that it acts
as a massless spring and the smaller beam acts as a mass. The end vertex of the longer beam (acting as a spring)
is fixed. The cross section details are as shown below.
Material Properties
Material E (Pa) ν ρ (kg/m3)
Spring 1.1e11 0.34 1e-8
Mass 2e11 0 7.85e5
Results Comparison
Results Target DS Error (%)
Natural Frequency of Axial Mode 1188.6 1190.5 0.160
(Hz)
Test Case
A beam fixed at one end and is subjected to two compressive forces. One of the forces is applied on a portion
of the beam of length 50 mm (L1) from the fixed end and the other is applied on the free vertex, as shown below.
Results Comparison
Results Target DS Error (%)
Load Multiplier 10.2397 10.198 -0.407
Test Case
An assembly of two parts with a gap has a Frictionless Contact defined between the two parts. The end faces of
both the parts are fixed and a given displacement is applied on the contact surface of Part 1 as shown below.
Find the Normal stress and Directional deformation - both in the z direction for each part for the following
scenarios:
Validate all of the above scenarios for Augmented Lagrange and Pure Penalty formulations.
Results Comparison
The same results are obtained for both Augmented Lagrange and Pure Penalty formulations.
Test Case
An assembly of two curved beams, each having an included angle of 45°, has a square cross-section. It is fixed
at one end and at the free end a Force F and a Moment M are applied. Also, a UDL of “w ” N / mm is applied on
both the beams. Use a global element size of 30 mm to get accurate results. See the figure below for details.
Equivalent Loading:
Analysis
The deflection in the y direction is in the direction of the applied force F and is given by:
1
[Fr3 (0.142699) + Mr2(0.29289) + r4(0.039232)]
2E I
= − 11 3 2 4
+ [Fr (0.642699) + Mr (0.707 + r (0.293564247]
E2I
where:
Results Comparison
Results Target DS Error (%)
Minimum Y Deformation (mm) -8.416664 -8.4688 0.619
Test Case
Two collinear beams form a spring-mass system. The density of the longer beam is kept very low so that it acts
as a massless spring and the smaller beam acts as a mass. The end vertex of the longer beam (acting as a spring)
is fixed. A Harmonic force F is applied on the free vertex of the shorter beam in z direction. Both beams have
hollow circular cross-sections, as indicated below.
Find the z directional deformation of the vertex where force is applied at frequency F = 500 Hz for the above
scenarios with solution intervals = 25 and a frequency range of 0 to 2000 Hz. Use both Mode Superposition and
Full Method.
Material Properties
Material E (Pa) ν ρ (kg/m3)
Spring 1.1e11 0.34 1e-8
Mass 2e11 0 7.85e5
Results Comparison
Results Target DS Error
(%)
Mode Superposition Maximum z directional deformation 4.11332e-3 4.0654e-3 -1.165
without damping (m)
Maximum z directional deformation 4.11252e-3 4.064e-3 -1.180
with damping (m)
Full Method Maximum z directional deformation 4.11332e-3 4.1132e-3 -0.003
without damping (m)
Maximum z directional deformation 4.11252e-3 4.0695e-3 -1.046
with damping (m)
Test Case
One hollow cylinder is shrink fitted inside another. Both cylinders have length L and both the flat faces of each
cylinder are constrained in the axial direction. They are free to move in radial and tangential directions. An internal
pressure of P is applied on the inner surface of the inner cylinder. To get accurate results, apply a global element
size of 0.8 inches.
Note — Tangential stresses can be obtained in Simulation using a cylindrical coordinate system.
To simulate interference, set Contact Type to Rough with interface treatment set to add offset with Offset
= 0.
Results Comparison
Results Target DS Error (%)
Maximum normal y stress, inner cylinder 35396.67 35849 1.278
(psi)
Maximum normal y stress, outer cylinder 42281.09 42295 0.033
(psi)
Test Case
A plate of length L, width W, and thickness T is fixed along the width on one edge and a moment M is applied
on the opposite edge about the z-axis.
Find the maximum Bending Stress sx and maximum Total Deformation d of the plate. Also find the part life and
the factor of safety using Goodman, Soderberg, & Gerber criteria. Use the x-stress component. Consider load
type as fully reversed and a Design Life of 1e6 cycles, Fatigue Strength factor of 1, and Scale factor of 1.
Material Properties
E = 2e11 Pa
ν = 0.0
Ultimate tensile strength = 2.5e8 PA
Endurance strength = 1.38e8 Pa
No. of Cycles Alternating Stresses (Pa)
1000 1.08e9
1e6 1.38e8
Results Comparison
Results Target DS Error
(%)
Maximum normal x-stress (Pa) 9e8 9e8 0.000
Maximum total deformation 6.48e-4 6.49e-4 0.279
SN-Goodman Safety factor 0.1533 0.15333 0.020
Life 1844.3 1844.4 0.005
SN-Soderberg Safety factor 0.1533 0.15333 0.020
Life 1844.3 1844.4 0.005
SN-Gerber Safety Factor 0.1533 0.15333 0.020
Life 1844.3 1844.4 0.005
Test Case
A plate of length (L), width (W), and thickness (T) is fixed along the width on one edge and heat flow (Q) is applied
on the same edge. The opposite edge is subjected to a temperature of 20 °C. Ambient temperature is 20 °C. To
get accurate results, apply a sizing control with element size = 2.5e-2 m.
Find the maximum temperature, maximum total heat flux, maximum total deformation, and heat reaction at
the given temperature.
Analysis
Heat Reaction = -(Total heat generated)
Results Comparison
Results Target DS Error
(%)
Maximum Temperature (°C) 86.1157 86.116 0.000
Maximum Total Heat Flux (W/m2) 2e4 2e4 0.000
Maximum Total Deformation 7.93386e-5 7.9963e-5 0.787
Heat Reaction (W) -5 -5 0.000
Test Case
A half-cylinder 1 m long having a diameter of 0.05 m is fixed at both the end faces. The longitudinal faces have
frictionless support. A pretension bolt load is applied on the semi-cylindrical face. To get accurate results, apply
sizing control with element size = 0.01 m.
Find the z-directional deformation and the adjustment reaction due to the pretension bolt load.
Analysis
The pretension bolt load applied as a preload is distributed equally to both halves of the bar. Therefore the z-
directional deformation due to pretension is given by:
Pretension Load L / 2
Pretension =
AE
Adjustment = Pretension 2
Results Comparison
Results Target DS Error
(%)
Minimum z-directional deformation (m) -0.5e-7 -0.50002e-7 0.004
Adjustment Reaction (m) 1e-7 1e-7 0.000
Test Case
A rectangular beam is loaded in pure bending fashion. For an elastic, perfectly plastic stress-strain behavior,
show that the beam remains elastic at M = Myp = σypbh2 / 6 and becomes completely plastic at M = Mult = 1.5
Myp. To get accurate results, set the advanced mesh control element size to 0.5 inches.
Analysis
The load is applied in three increments: M1 = 24000 lbf-in, M2 = 30000 lbf-in, and M3 = 36000 lbf-in.
Results Comparison
M/Myp Target DS Error (%)
State Equivalent Stress State Equivalent Stress
(psi) (psi)
1 fully elastic 36000 fully elastic 36059 0.164
1.25 fully elastic 36000 elastic- 36288 0.800
plastic
1.5 plastic solution not con- plastic solution not con- -
verged verged
Test Case
A long, rectangular plate is fixed along the longitudinal face and the opposite face is subjected to a moment of
5000 lbf-in about the z-axis. To get accurate results, set the advanced mesh control element size to 0.5 inches.
Find x-normal stress 0.5 inches from the fixed support. Also find total deformation and reaction moment.
Analysis
Since the loading is uniform and in one plane (the x-y plane), the above problem can be analyzed as a plane
strain problem. Therefore, the moment applied will be per unit length (5000/1000 = 5 lbf-in). Analysis takes into
account the unit length in the z-direction.
Figure 30.2 Plane Strain Model (analyzing any cross section (40” x 1”) along the length)
Results Comparison
Results Target DS Error (%)
Maximum Normal Stress in the X- 30 30 0.000
Direction (psi)
Maximum Total Deformation (in) 0.1655e-2 0.16553e-2 0.018
Reaction Moment (lbf-in) -5 -5 0.000
Test Case
A long, rectangular bar assembly is fixed at one of the faces and the opposite face is subjected to a force of 1e9
N in the negative x-direction. To get accurate results, set the advanced mesh control element size to 1 m.
Find the maximum equivalent stress for the whole assembly and safety factor, safety margin, and safety ratio for
the first and last part using the maximum equivalent stress theory with Tensile Yield Limit.
Material Properties
Material E (Pa) ν Tensile Yield (Pa)
Part 1 1.93e11 0 2.07e8
Part 2 7.1e10 0 2.8e8
Part 3 2e11 0 2.5e8
Part 4 1.1e11 0 2.8e8
Analysis
Since the loading is uniform and in one plane, the above problem can be analyzed as a plane stress problem.
Analysis takes into account the thickness of 2 m along the z-direction.
Figure 31.2 Plane Stress Model (Analyzing any cross section along Z)
Results Comparison
Results Target DS Error (%)
Maximum Equivalent Stress (Pa) 2.5e8 2.5e8 0.000
Part 1 Safety Factor 0.828 0.828 0.000
Safety Margin -0.172 -0.172 0.000
Safety Ratio 1.207 1.2077 0.058
Part 4 Safety Factor 1.12 1.12 0.000
Safety Margin 0.12 0.12 0.000
Safety Ratio 0.892 0.89286 0.096
Test Case
A copper disk with thickness t and radii Ri and Ro is insulated on the flat faces. It has a heat-generating copper
coaxial cable (of radius Ri) passing through its center. The cable delivers a total heat flow of Q to the disk. The
surrounding air is at a temperature of To with convective film coefficient h. To get accurate results, set the advanced
mesh control element size to 0.002 m.
Find the disk temperature and heat flux at inner and outer radii.
Analysis
Because the geometry and loading are symmetric about the y-axis, the above problem can be analyzed as an
axisymmetric problem.
Figure 32.2 Plane Stress Model (Analyzing any cross section along Z)
Results Comparison
Results Target DS Error (%)
Maximum Temperature (°C) 38.9 38.896 -0.010
Minimum Temperature (°C) 30 30.007 0.023
Maximum Heat Flux (W/m2) 1.98943e5 1.9808e5 -0.434
Test Case
A C-shaped magnet has a coil with 400 turns and a cross section of the core with area 4 cm2. A current of 0.1 A
flows through the coil. The air gap is 0.2 cm and the coil details are given in Figure 33.2: “Coil Details in cm”. Flux
parallel is applied on the nine outer faces as shown in Figure 33.4: “Flux Parallel Applied on 9 Outer Faces”. To
get accurate results, set the advanced mesh control element size to 0.003 m.
Material Properties
Young's Modulus Poisson's Ratio Density (kg/m3) Relative Permeabil- Electric Resistivity
(Pa) ity (ohm-m)
Air Body 1e7 0 0 1 0
Coil 1.1e11 0.34 8300 1 2e-7
Core 2e11 0.3 7850 500 0
Analysis
Using the analogy of Ohm's law of Magnetism, we have the following equation:
NI
Magnetic flux is: =
L c + La
c Ac aAa
where:
N = number of turns
I = current
Lc = mean core length
La = air gap
Ac = cross-sectional area of core
Aa = apparent area of air gap
µc = permeability of core
µa = permeability of air
Ba =
Aa
Results Comparison
Results Target DS Error (%)
Total Flux Density (T) 4.061e-2 4.0556e-2 -0.133
Total Field Intensity (A/m) 32320.0585 32273 -0.146
Test Case
An L-shaped beam with dimensions 30 x 25 mm with 4 mm as the rib thickness and 300 mm in length has the
surface fixed at one end. A force of 10,000 N is then applied to the opposite end of the beam.
Analysis
Beam volume:
V = L(4W + 4H + 16)
L = Length = 0.250 m
W = Width = 0.030 m
H = Height = 0.035 m
Results Comparison
Results Target DX Error (%)
Volume (V) 6.9e-5 m3 6.9643e-5 0.932
Deformation (D) 4.5290e-5 m 4.6029e-5 m 1.632
Stress (σ) 3.62319e7 Pa 3.6338e7 Pa 0.296
Test Case
A long bar 2 X 2 X 20 m is made up of material having thermal conductivity linearly varying with the temperature
K = k0*(1 + a*T) W/m-°C, k0 = 0.038, a = 0.00582. The bar is constrained on all faces by frictionless support. A
temperature of 100°C is applied at one end of the bar. The reference temperature is 5°C. At the other end, a
constant convection coefficient of 0.005 W/m 2°C is applied. The ambient temperature is 5°C. (Esize of 1 m)
Input Parameters: Convection coefficient and coefficient of thermal expansion length (CAD Geometry)
Analysis
Temperature:
Ts = −4521.613 hal − 171.8213 + 2.0445 107 h2al2 + 1.6 106 hal + 73887.8
Thermal strain:
= (Ts − Ta ) = (Ts − 5)
l = beam length = 25 m
h = convection coefficient = 0.006 W/m2°C
α = coefficient of thermal expansion = 1.4e-5/°C
Results Comparison
Results Target DX Error (%)
Length (l) 25 m 24.938 m -0.248
Convection coefficient (h) 0.006 W/m2°C 0.0059711 -0.482
W/m2°C
Coefficient of thermal expansion 1.4e-5/°C 1.4062e-5°C 0.443
(α)
Temperature (T) 29.6528°C 29.694°C 0.148
Thermal strain (ε) 3.4514e-4 3.4724e-4 m/m 0.608
m/m
Test Case
A uniform column of rectangular cross section b and d m is to be constructed for supporting a water tank of
mass M. It is required to:
Design the column to avoid failure due to direct compression (should be less than maximum permissible com-
pressive stress) and buckling (should be greater than direct compressive stress). Assume the maximum permissible
compressive stress as σmax. The design vector is defined as:
{X} = {X1, X2}T = [b,d}T
where:
Input Parameters:
Analysis
Minimize:
Mass of the column = M = b d l
Maximize:
1/ 2
Ebd 3
Natural frequency of transverse vibrations of the water tank w = 3 33
4l M + lb d
140
Subject to constraints:
M g
Direct_Stress = max − 0
b d
2 E d2 M g
and Buckling_Stress = − 0
2 bd
48 l
b = 0.36102 m
d = 1.3181 m
M = (minimum) = 21890 kg
W = (maximum) = 0.87834 rad/sec
Direct stress = 2.0386e7 Pa
Buckling stress = 6.1526e6 Pa
Results Comparison
Results Target DX Error (%)
Width b 0.36102 m 0.36102 m 0.000
Depth d 1.3181 m 1.3181 m 0.000
Mass of column M 21890 kg 21890 kg 0.000
Natural frequency w 0.87834 rad/sec 0.87834 rad/sec -0.020
Direct stress 2.0386e7 Pa 2.0383e7 Pa -0.015
Buckling stress 6.1526e6 Pa 6.15260e6 Pa -0.015
Test Case
A square plate with following dimensions is subjected to boundary conditions as given below:
Length a = 250 mm
Width b = 250 mm
Thickness h = 5 mm
Analysis
First Natural Frequency:
w = 7.122 Eh3 1/ 2
2 12h(1− 2 )
2
Results Comparison
Results Target DX Error (%)
Young's Modulus E 1.8e11 Pa 1.8254e11 Pa 1.411
Poisson's Ratio µ 0.27 0.27373 1.381
Density ρ 8635 kg/m3 8611.3 kg/m3 -0.274
First Natural Frequency w 124.0913 rad/s 124.63 rad/s 0.434
Test Case
The cantilever bar of length 25 feet is loaded by uniformly distributed axial force p = 11 lbf on one of the vertical
face of the bar in negative Z-direction. The bar has a cross-sectional area A is 0.0625 ft2.
Input Parameters: Side of Square C/S , Length of Cantilever Bar and Young's Modulus
Analysis
Assuming that under the action of uniform axial load a slight lateral bucking occurs.
where:
2 2 2
(1.122l) (1.122) .(l) l2
Pcr
The load multiplier is given by the ratio of critical load to applied load p .
Results Comparison
Results Target DX Error (%)
First buckling mode load multiplier 3083.32 3002.9 -2.608