This section is intended to provide you with tips and strategies for avoiding and handling problems that may occur when using the Meshing application. Topics include:
When you generate mesh, the mesh is generated as a separate process per part (unless using assembly meshing where all parts are meshed in one process). If there are multiple parts, each part can be meshed in parallel. While meshing, the status window provides details on what is happening in the meshing process. Other information, such as the amount of memory used can be found by using a task manager.
While the mesher is working at certain points it will highlight topology (edges, faces, bodies). If the mesher gets stuck for a long time on a particular topology, you should inspect the highlighted topology and possibly merge it with another topology using virtual cells, or adjust the mesh sizes in that area.
For details about topology highlighting during the meshing process, refer to Generating Mesh. For information about how to set the default for topology highlighting, refer to Meshing Options on the Options Dialog Box.
The following approaches are recommended to improve the mesh quality and obtain a valid mesh:
Set the Display Style to identify quality by color.
Use the Mesh Metric option to view information about a number of quality statistics and set Min/Max values to find poor quality elements.
Use the Worksheet as your Scoping Method and use worksheet data to define criterion-based measurements.
If your mesh generation fails, it may be a partial or complete meshing failure. Your first course of action should be to examine any messages that the mesher returns to the Messages window. The messages include hints that explain why the meshing completely or partially failed. In some cases, you can right-click on the message and select Show Problematic Geometry to highlight any entities associated with the message in the Geometry window and see what the failed mesh looks like.
The mesher also provides visual cues to identify obsolete and/or failed meshes. As shown in the figures below, failed meshes are shaded in maroon and obsolete meshes are colored yellow. The approximate location of the cause of the meshing failure is identified by a convergence of white lines.
If the entities are very small, you can refer to the status bar at the bottom of the window to view statistics related to the entities. Then create a Named Selection to retain information about the problematic entities. Continue reading below for more information about messaging.
The Messages window prompts you with feedback concerning meshing operations. Every message returned from the mesher is not necessarily an error. Messages come in three forms:
Error: Requires action from you to obtain a mesh.
Warning: Guides you in best practices or alternative courses of action. A warning does not require you to fix any problems, but may give an indication of a subsequent related error.
Information: Helps you make better decisions related to meshing your model or provides you with information about the approach the mesher used to mesh your model.
Once messages are displayed, you can:
Double-click a message to display its contents in a pop-up dialog box.
Highlight a message and then press the key combination CTRL+C to copy its contents to the clipboard.
Press the Delete key to remove a selected message from the window.
Select one or more messages and then use the right mouse button click to display the following context menu options:
- Selects the object in the Tree Outline that is responsible for the message.
- Highlights the geometry in the Geometry window that is responsible for the message. This option is not always available.
- Displays the selected message in a pop-up dialog box.
- Copies the selected messages to the clipboard.
- Removes the selected messages.
- Refreshes the contents of the Messages window as you edit objects in the Tree Outline.
Sometimes the mesher returns an invalid mesh. Refer to the state of the body in the Tree Outline to determine whether a body was meshed:
A check mark
denotes a body in a fully defined but unmeshed state.
A check mark with a hash
denotes a meshed body.
A question mark
denotes a body that needs more
information before it can be sent to the solver.
When your model contains an active unmeshed body, the Mesh object in the Tree Outline is preceded by a lightning bolt to indicate a body is out-of-date and requires action:

When your model is fully meshed (i.e., all bodies are in a meshed state), the Mesh object is preceded by a check mark to indicate that the meshing data is fully defined and ready for the next stage of your analysis (i.e., an update in the Meshing application or a solve in the Mechanical application):

Mesh connections and contact matches use the following symbols to denote mesh state:
A check mark
denotes a
connection or match that is fully defined and ready to be connected or
matched.
A check mark with a hash
denotes a successful connection or
match.
A question mark
denotes a
connection or match that is invalid that needs more information before it can be
connected or matched.
A circle with a bar in it
denotes a connection or match that is ignored. Check the Details view of the mesh
connection or contact match for the reason.
A lightning bolt
indicates that the connection or match is out-of-date and requires action.
An ‘X’
denotes a suppressed connection or match. Unsuppressing the connection or match
requires it to be reconnected or rematched even if it was previously connected or
matched.
Meshing may fail if the mesh quality does not meet the criterion of the defined shape checks. The following approaches are recommended to improve the mesh quality and obtain a valid mesh:
To identify faces that do not meet the shape checking criteria, right-click the warning message and select .
Use a different shape check setting.
Some shape checks have a stricter set of criterion than others. By using a different shape check setting a mesh might be generated, and the mesh metrics bar graph can be used to find the mesh violating the stricter shape checks. In this way, locating the problem is the first step to fixing it.
Use the methods described in Identifying Poor Quality Mesh to determine the quality of the mesh.
Use the Preview Surface Mesh and/or Preview Inflation features.
With this approach the boundary mesh is generated even if the mesh would violate the defined shape checks. Once the previewed mesh is generated, use the mesh metrics bar graph to determine the location of bad quality elements. Generally, fixing the bad quality surface mesh is the best way to fix the volume mesh because bad quality mesh is usually a result of the geometry over-constraining the mesh topology. Using defeaturing controls (such as Loop Removal and Mesh Defeaturing), pinch controls, and virtual topologies are all good strategies to remove geometry features that may cause problems for the meshing algorithms.
For additional information about the shape checking acceptance criterion used by ANSYS Workbench, refer to ANSYS Workbench and Mechanical APDL Application Meshing Differences.
Selective meshing may lead to unexpected results in cases where a mesh control change affects only one body. This may in turn lead to sweep mesh failure because the source and target meshes no longer align or the resultant change makes a body unsweepable. If desired, you can set the Allow Selective Meshing option to No to disable selective meshing and allow the mesh control changes to ripple through the entire part.
Selective meshing is not persistent for a geometry update or re-mesh operation. However, you can use the Mesh worksheet to create a selective meshing history so that your meshing steps can be repeated in the desired sequence. Otherwise, you may need to go through your body meshing steps manually if the single mesh update does not satisfy your meshing requirements. Refer to Using the Mesh Worksheet to Create a Selective Meshing History for details.
If there are gaps in your geometry and Patch Independent meshing fails, the mesh size may be set smaller than the size of the gaps in the geometry. In such cases, try adjusting the size of the mesh in those regions so they are larger than the geometry gap size.
Some mesh failures are due to an inappropriate defeature size (either default or user input) or dirty geometry. Use the following guidelines to determine which issue is the cause of the failure:
With Size Function turned off:
Determine whether the model is a multiple part assembly, a multibody part, or a single body part.
If a message provides “Problematic Geometry” information, use it to determine which portions of the model fail. Quite often, one or more faces fail to mesh.
If a face fails to mesh, check whether the face is “regular”; that is, make sure that it is not too skinny or has skinny sections with misaligned edge spacings which would make it difficult to get a good mesh. Use of virtual topologies, pinch controls, etc. may help in these situations.
If a face fails to mesh, check to see if the edges attached to that face may be problematic. For example:
Turn on the Show Vertices and Close Vertices options to see if any edge is significantly faceted (i.e., has many edge splits in comparison to mesh size), or if there are any unexpected clusters of vertices. The mesher will try to place a node on each vertex, so unnecessary vertices can lead to complications in meshing that may be avoidable. Use of virtual topologies, pinch controls, and so on may help in these situations.
Turn on the Edge Coloring > By Connection option to see if the edge connectivity is unusual. In some cases, the geometry connectivity may not be as expected, and this may create problems during meshing. These problems could be fixed in the DesignModeler application, the CAD package, or possibly through the use of virtual topologies or pinch controls.
For a multibody part, turn on the Edge Coloring > By Body Connection option to see if the edge connectivity is unusual between bodies.
In the event of a sweep mesh failure, the following approaches are recommended:
Check for contradicting edge sizings.
For Src/Trg Selection, use a manual setting instead of automatic.
Check side faces to see if they are mappable. Use of virtual topologies can help make bodies sweepable:
Turn on the Show Vertices and Close Vertices options to see if any edges have unnecessary splits. Extra edge splits can make faces that appear to be mappable more difficult to map. Virtual edges can help in these cases.
Use of virtual face splits can help make faces more mappable, as can use of the mapped face mesh control and its advanced options.
Turn on the Edge Coloring > By Connection option to see if the edge connectivity is unusual. In some cases, the geometry connectivity may not be as expected, and this may create problems during meshing. These problems could be fixed in the DesignModeler application, the CAD package, or possibly through the use of virtual topologies.
For a multibody part, turn on the Edge Coloring > By Body Connection option to see if the edge connectivity is unusual between bodies.
For detailed information about the requirements and characteristics of sweep meshing, refer to Mesh Sweeping.
For additional information, refer to Figure 7.36: Strategies for Avoiding Stretched Elements in the Mechanical APDL help.
In the event of a thin sweep mesh failure, first refer to Thin Model Sweeping for detailed information about the requirements and characteristics of thin sweep meshing.
The and features do not support the thin model sweeper. Thus, if a failure occurs, you must use the feedback in the Messages window to determine the problem:
If Src/Trg Selection is set to Automatic Thin, determine whether the correct source/target faces are being used. You can review the source/target faces by right-clicking the appropriate message. If incorrect source/target faces are being used, select the Manual Thin option on the sweep method and pick the correct faces manually.
In many cases, the messages tell you to use virtual topology to merge an edge/face. Thin sweeping requires one division through the thickness. Side edges must connect directly from source to target to comply with this rule.
If a message tells you the target faces are not meshed, try swapping the source/target faces.
In cases where a thin sweep body and a general sweep body are neighbors, the general sweep body has higher priority and is meshed first. The general sweep operation may place nodes on the side area/edge of the thin sweep body. If you receive a message describing this situation, you must apply additional mesh controls to prevent it.
If both source and target areas are meshed, thin sweep will fail. In this case, you must find some way to eliminate the situation.
Thin sweep may issue warning messages telling you that the source you picked was swapped with the target, and that some controls on the target faces were ignored as a result. These types of warning messages are for your reference only.
In the event of a MultiZone mesh failure, the following approaches are recommended:
If using automatic source face selection, try using manual source face selection (or vice versa). For manual source face selection, ensure that all sources and targets are selected. Refer to Using MultiZone for more information.
Ensure that all side faces are mappable. Refer to MultiZone Face Mappability Guidelines for more information. Use of virtual topologies can help make bodies sweepable:
Turn on the Show Vertices and Close Vertices options to see if any edges have unnecessary splits. Extra edge splits can make faces that appear to be mappable more difficult to map. Virtual edges can help in these cases.
Use of virtual face splits can help make faces more mappable, as can use of the mapped face mesh control.
If MultiZone doesn’t respect edge biasing, as shown in Figure 249: Edge Biasing Not Respected by MultiZone below, it may be because the opposite edge is split. To work around this, perform the edge biasing on the opposite edges to get a better edge distribution, as shown in Figure 250: Edge Biasing Respected by MultiZone.
Note: When a curve with bigeometric distribution is split, the curve is split into GEO1 and GEO2 starting at the split point.
Turn on the Edge Coloring > By Connection option to see if the edge connectivity is unusual. In some cases, the geometry connectivity may not be as expected, and this may create problems during meshing. These problems could be fixed in the DesignModeler application, the CAD package, or possibly through the use of virtual topologies.
For a multibody part, turn on the Edge Coloring > By Body Connection option to see if the edge connectivity is unusual between bodies.
For detailed information about the requirements and characteristics of MultiZone, refer to MultiZone Meshing.
In the event of a mesh connection failure, refer to Diagnosing Failed Mesh Connections.
In the event of a contact match failure, refer to Troubleshooting Failed Contact Matches.
In some cases, you may encounter bad feature capturing when using assembly meshing in the Meshing application, even though the faceting of the same model looks fine in ANSYS Fluent. The bad faceting may be apparent in ANSYS Fluent only if you turn off the viewing of edges and view surfaces only. The following approaches are recommended to avoid bad feature capture:
If you are experiencing bad feature capture, increasing facet quality can help. If you are using the DesignModeler application, increasing the value of the Facet Quality option () from 5 (the default) to 10 can lead to significant improvements. This Facet Quality option affects models entering the Meshing application via DesignModeler only; CAD packages have their own separate faceting controls. In particular, you should increase facet quality in DesignModeler or your CAD package if your model contains high order NURBS surfaces and/or your applications require the highest fidelity to your input CAD (i.e., aerospace applications, external aero applications, etc.). However, be aware that higher settings create large numbers of facets, which may slow down processing or possibly lead to failures in facet generation due to insufficient memory. Refer to Facet Quality for details about this setting in DesignModeler.
In cases of tolerant models, the Tessellation Refinement control tries to avoid re-projections to the underlying curves and surfaces at locations where the CAD tolerance exceeds the desired refinement tolerance. In cases of significant tolerances, you may want to relax the Tessellation Refinement tolerance or even set it to None to avoid re-projections that may contribute to problems with faceting. In cases of accurate models, the default settings typically work well.
The Sharp Angle Tool can be used to control the capture of features with sharp angles, as well as to improve feature capture in general.
Failure in the assembly meshing algorithms is almost always related to faceting issues in relation to minimum size. Make sure that the values of the Min Size and Proximity Min Size options truly represent the smallest sizes that you want the curvature and proximity size functions to capture. By default, many meshing features operate based on the smaller of these two minimum size values. Consider the following:
It is strongly recommended that you ALWAYS adjust the value of Min Size/Proximity Min Size as appropriate for your problem. Make sure that the minimum size is 1/2 of any small feature or gap that you need to capture. Similarly, the minimum size should be about 1/10 of the diameter of the smallest pipe. For very simple cases, make sure to increase the minimum size appropriately. Failure to do so may result in an over-refined mesh with a huge number of facets.
Use local (scoped) size controls to ensure two layers of elements in any gap/thickness. If the scoped sizing is smaller than the minimum size, you must adjust the Tessellation Refinement accordingly. If you add a hard size that is smaller than the minimum size, make sure that the tolerance specified by the Tessellation Refinement control is now 10 times smaller than the specified hard size.
If you receive a warning about missing tessellations, it may help to lower the tessellation tolerance by 50%.
In some cases, small defects in the faceting may lead to bad quality meshes. In many of these cases, a minor modification of the minimum size or tessellation tolerance can rectify the problem.
Virtual bodies are used with assembly meshing to represent flow volumes in a model so that you can mesh flow regions without having to model geometry to represent them. These flow volumes are extracted during meshing; however, an extraction failure may occur if there are gaps between bodies and/or faces such that the extracted flow volume would not be watertight and therefore would leak. If a leak is present, the flow volume mesh will contain only elements from the leak path (that is, surface and line elements will be returned but volume elements will not). As a result, assembly mesh generation will be unsuccessful and an error message will be issued. In such cases, the assembly meshing algorithms detect and trace the leaks and display their leak paths graphically as follows:
Any time there is an exterior leak (that is, the mesh leaks to the outside of the model), it will be detected by the Meshing application. However, the leak path will be displayed only if you have defined a virtual body and specified a material point in the flow volume void. For exterior leaks, tracing occurs from the bounding box to all defined material points.
When a material point is inside a virtual body, you must also set Used By Fluid Surface to Yes when defining the virtual body, and then define the appropriate set of fluid surfaces by selecting the faces of the virtual body and assigning them to the group.
Interior leaks involve leak tracing between material points; thus for an interior leak to be identified, you must define two or more virtual bodies and specify a material point in each flow volume void.
If a leak is detected, the leak path should clearly indicate its location, in which case you should return the model to the DesignModeler application or your CAD system to close the gap that is causing the leak (for example, by adding a face or moving a body).
If you suppress a virtual body, any leak path associated with it will be hidden from view in the Geometry window.
In some assembly meshing cases, contact sizing can also be used for closing leaks discovered during meshing. Refer to Applying Contact Sizing for details.
The figure below shows the leak path for a failed assembly mesh.
The figure below shows a closer view of the leak.
If a high aspect ratio is obtained for cells in the inflation layer when an assembly meshing algorithm is being used, reducing the value of Gap Factor may help. Refer to the discussion of inflation controls in Selecting an Assembly Mesh Method for more information about specifying Gap Factor for assembly meshing algorithms.
The CutCell algorithm does not support very thick inflation layers, so instead of using an Inflation Option of First Layer Thickness or Total Thickness, use aspect ratio-based inflation.
Virtual topology surfaces made up of two loops are not automatically mappable. For a faceted surface made up of two loops to be map meshed, a mapped Face Meshing control must be scoped to it or it must be a side area of a general sweep body.
Meshing a complicated model may require special attention and experimentation. In such cases, the following strategies and guidelines are recommended for obtaining a successful mesh:
Analyze the model to determine its complexity:
Identify the small features that you do (and do not) want to retain.
Consider the model's size and its relationship to the element size transitions that are appropriate for the mesh. A smoother transition from the fine element size to the coarse element size will result in a larger number of elements, which should be considered (especially if the model is quite large). Coarser transitions will result in a smaller number of elements. You must determine what is acceptable.
Refer to the value in the Minimum Edge Length field. This field provides a read-only indication of the minimum edge length in the model.
Think about the element size that you expect to obtain, especially the desired minimum element size. To help you determine the desired size, in the Geometry window, select the edges of small features that you want to retain and refer to the status bar for feedback about the selections.
Perform a low-effort mesh evaluation by using appropriate sizes as determined from #1, but without controls such as inflation, match mesh controls, etc. that add constraints to the mesher. Also, try to start with a coarser mesh size and refinement in later steps.
If the mesh is successful, examine it to see whether the mesh size and transition rates are acceptable. In most cases, you will need to make some adjustments to obtain the desired results.
If the mesh fails, examine any messages that the mesher returned to the Messages window, as described elsewhere in this Troubleshooting section.
Adjust settings to retain desired small features:
In many cases, small features are either small holes or channels in the model and are associated with high curvature. For this reason, using the Size Function with Curvature is a good strategy for retaining these features.
Be careful when using the Size Function with Proximity. If the value of Minimum Edge Length is too small, using Proximity may lead to meshing problems.
Adjust settings to defeature (remove) unimportant small features:
The Meshing application automatically defeatures small features according to the specified Defeature Size. Refer to the Minimum Edge Length value to help determine which small features will be defeatured automatically.
For solid models, Defeature Size is set to 50% of the value of Min Size by default. If you set a larger Defeature Size, you must also set a larger Min Size because the defeature size cannot be as large as the minimum element size.
Adjust the mesh settings to achieve the desired quality.
Continue making adjustments until your results are satisfactory. Try adjusting controls such as face sizing, edge sizing, transition rate, and smoothing. You may also want to experiment with virtual topology.
If you are using a localized operating system (such as French or German) on Linux, you must perform additional steps in order for the Meshing application to recognize the correct numerical format. Refer to the platform details section of the ANSYS, Inc. Linux Installation Guide for details.
Meshing application projects created prior to Release 16.0 need to be updated before they can be used on Lustre parallel file systems on Linux. To do this:
Load the project into Release 16 software on a system that does not use a Lustre parallel file system.
Perform an operation that changes each model in the Meshing application (for example, hide and then show a part). If systems share the same model, the change needs to be done for only one of the systems.
Save the project.