Automation in Ansys EnSight

Computational Engineering International, Inc. (CEI) originally developed a suite of products that included EnSight and was acquired by Ansys in 2017. EnSight is a market leading post-processor for Computational Fluid Dynamics (CFD) with multiphysics visualization capabilities. It is easy to use with a modern interface that has transient capabilities and can efficiently handle very large data sets, which are common in CFD simulations, especially transient ones.

EnSight has continued to improve their Python integration over the years and continues to lead in automation capabilities for the world of CFD post processing. Any action that takes place in EnSight is recorded in what is referred to as the command language. Whether the action is a zoom, translate, or rotate of the camera, or the creation of post processing objects like a clip plane, vector arrow plot, or contour – the action is saved in the command language. See below Command Panel:

The command language is a comprehensive journaling language in EnSight that contains all the detailed information associated with the operations or actions taken place in the current session. This command language can be converted into a Python script which can be executed using the built-in interpreter. The user will copy the commands to be converted into Python and paste them into a new file.

The actions are more human-readable in Python and allow for logic operations and loops. The user can make changes to the Python script as appropriate and save for use in other EnSight sessions to automate processes, which can be a huge time saver in certain situations. For example, if you need to create several post processing objects in EnSight for a variety of result files for use in a report, you will only need to do it once because you can reuse the commands for all results files.

Check out this YouTube video on automating the creation images of post-processing objects in EnSight using Python.

Utilizing the built-in Python interpreter in EnSight is a great way to automate repetitious post-processing procedures.

Troubleshooting Unphysical Solution Results and Identifying Poor Mesh Elements

Not if, but when you run into CFD convergence issues, it is often due to a poor-quality mesh, an ill-posed problem, or inappropriate solver settings. There are a variety clues that indicate lack of solution convergence such as high residuals, solution monitors that do not make sense, and mass or energy imbalance. When residuals are high or increasing (diverging) it is a good indication that there is unphysical behavior in the solution that is the cause. You will need to identify where this unphysical behavior is occurring in the model so that it can be remedied.

Often reporting minimum and maximum values of the solution variables (velocity, pressure, temperature, etc.) is a good place to start when attempting to identify unphysical behavior. For example, if the maximum flow speed is measuring much higher than you’re expecting, you will want to identify where in the domain this unexpected behavior is occurring. An iso-surface is a good tool to use for identifying the location of odd behavior in the solution field.

You can compute the range of a particular solution variable in the iso-surface panel. If the range is not what you expect or does not make physical sense, it is a good idea to create an iso-surface to identify where the potential unphysical behavior is occurring. You can use the iso-surface in concert with other mesh objects in a scene and take a look at where the unexpected behavior is occurring:

 

In this example the location of high flow speed appears to be unphysical. You will want to interrogate the mesh in that particular region to look for clues – this can be done in the solver or mesher. Everyone is in a hurry to get results and it can be tempting to move forward with a poor-quality mesh in the solver, but you run an increased risk of solution convergence issues in the solver when doing so. It is best to start with a good quality mesh to accelerate solution convergence. Meshing is somewhere between an art and a science, but there are four primary mesh metrics that are used in concert when judging overall mesh quality – orthogonal quality, skewness, aspect ratio, and size change. To avoid mesh-related convergence issues, it is best to keep the minimum orthogonal quality above 0.1, skewness below 0.95, aspect ratio below 100, and size changes below 5.

To inspect the mesh quality inside of Ansys Fluent meshing, open the Display Grid panel from the menu bar, select the specific mesh quality metric to measure, then choose the quality range before hitting the display button. The elements within the specified range will be displayed in the graphics window as shown below:

To inspect the mesh quality in the Ansys Workbench mesher you will display the mesh histogram from within the mesh tab then choose the mesh metric to measure as shown in the figure below.

You can limit the range of the histogram to only contain the poorest quality elements by clicking the control button to access the range controls. From here you can limit the range of the x-axis then hit the reset button adjust the y-axis range. You may also want to consider reducing the number of bars in the histogram as well. Click the bars of the histogram to display the elements of that quality indicated:

Customizing the Output in Ansys Mechanical With User Defined Results (UDR)

In many situations, we have seen customers ask for ways to output custom results from ANSYS Mechanical. The usual results like Total Deformation, Equivalent Stress or Equivalent Plastic Strain may not be enough for your needs. Depending on the requirements (say a specification you are designing a part to), you can create a User Defined Result to output the needed result. ANSYS already outputs various quantities via User Defined Results that can be viewed in the Worksheet. Here is a quick look at some of what is available:

These quantities are used to create your own results output. User Defined Results can be operated on in several ways. Here is an excerpt from the ANSYS Help documentation (Mechanical Applications > Mechanical User’s Guide > Using Results > User Defined Results > User Defined Results Expressions):

 

Just as a simple example, say Total Deformation is required and is not output automatically (it is, just an example). If you add an UDR to the results, then type in the expression sqrt(Ux^2+Uy^2+Uz^2), keeping in mind these expressions are case sensitive, you get to resultant deformation from all three component values. Compare this to Total Deformation.

One can also do something more complex, say safety factor calculations. If your specified safety factor is not directly related to the Yield Strength or Ultimate Strength of the material, but some factor of, an UDR can be used; constants can be created and used just like any User Defined Result in the Worksheet. An example is shown here, where a safety factor is calculated based on a value of 6,200 psi. The safety factor looks at the First Principal Stress output, computes the safety factor, then caps the display at 7. Values less than 0 psi (compression when looking at the First Principal Stress) are set to the highest safety factor allowed (7 in this case).

A small note on the equation written in the graphic, in order to display a constant value (0 or 7 in this example), it must be multiplied by the identity matrix (matrix of 1’s). If you are just using a constant for equation manipulation, the identity matrix is not required.

User Defined Results can be a powerful tool if the output from Ansys Mechanical isn’t quite tailored to your needs.

Slip Slidin’ Away! Modifying Friction Coefficients During a Mechanical Simulation

There are situations in which it may be necessary to tweak friction coefficient in a nonlinear contact analysis during the simulation. Currently, the Ansys Workbench GUI does not support this capability directly; however, it is possible to vary the friction coefficient using a command object.

The Ansys documentation has several references of doing this as listed under the Help section; Mechanical APDL > Material Reference > Nonlinear Material Properties > Contact Friction as shown below.

This section on the documentation describes defining contact friction using TB,FRIC which is a material property used with current technology contact elements. It can be used to define coefficient of friction for both isotropic or orthotropic friction models. It further discusses varying friction coefficient in a multiple load step scenario, as well as implementing user defined friction  using TB,FRIC with TBOPT = USER.

The example presented here will show how to use commands object within Workbench to vary friction coefficient. The friction coefficient is defined via the TB,FRIC command. To define the friction that is function of temperature, time, normal pressure, sliding distance, etc. you can use the TBFIELD command in conjunction with the TB,FRIC. In this example presented, the friction is varied with time (to simulate it’s change through the load step).

Below is a graphic of the nonlinear contact between the Aluminum housing and steel ring gear.

 

The command object used to modify friction as a function of time is shown below.

This command object uses the information in the table below to modify friction :

Time                Friction Coefficient
0                      0
0.2                  0.1
0.4                  0.3
0.6                  0
0.8                  0.15
1                      0

As an example of the friction can vary, notice the friction coefficient is zero for time = 0.6 and time = 1.0.

During the run, the output controls under Analysis Settings was set to Yes for Nodal Forces, Contact Miscellaneous and General Miscellaneous.

A quick look at the contact results confirms our findings. The contour plot for contact friction stress shows zero results for time = 0.6 and 1 which m

Another sanity check is to check for reaction force through the frictional contact with the extraction method set to contact element option; this also reveals zero (nearly zero reaction force at these time points). The very small discrepancy noted on the reaction force is due to a few overlapping nodes on a boundary condition.

Restarts in Ansys Mechanical Can Save Time and Effort!

‘Restarting’ the process in ANSYS Mechanical Products by which a model is solved starting from a previously solved point. The previously solved point contains data for all nodes/elements in the model; there is no results mapping and interpolation when a restart is performed. This is the most accurate method for starting an analysis from a previously solved point.

By default, restarts are not kept when a simulation finishes. The user must modify the Analysis Settings in ANSYS Mechanical to keep the restarts points that will be needed. Those options are shown below:

Restarts do have limitations. For instance, modification of loads in a step before a restart point is to be used invalidates that restart point. Several tables in the ANSYS Help documentation characterize what happens to restart points if objects in the model tree are changed. This section can be found in Mechanical Applications > Understanding Solving > Solution Restarts, as shown.

 

Here’s one of the tables showing where restarts can be used followed by common questions we related to restarts.

What can solution restarts be used for?
For cases where some subset of the loads does not change and only a few loads change/vary. This is commonly referred to as load case modeling. ANSYS Mechanical FEA can do load case modeling.

Can you give an example of load case modeling?
A model that solves bolt pretension in the first several steps and then locks them in place. Commonly, service loads are applied after the bolt tightening is simulated. The service loads can represent multiple load cases, say one load case is a pressure load, another is a force load.

Another example is a ROPS (Roll Over Protection System) analysis, where loads are sequentially applied on a structure until some criteria is met (usually energy dissipated by the structure). Once the criteria are met for one load case, the load is removed and another load is applied. This process can also be done via restarts.

Why would we do this?
This saves time on solving models. Using the example above, without restarts, the bolt pretension steps would need to be solved every time a load case is added/modified. With restarts, loads can just be activated/deactivated in a step following the bolt pretension and the bolt pretension final step used as the restart point.

Things to know before attempting this method:
All of the load cases that will be solved should be known beforehand. The restart analyses require that ALL loads are defined in the initial model. In ANSYS Mechanical, loads cannot be added to the model tree without invalidating the previous results (ignoring the ability to use restarts).

Newly added loads also will not be applied in a restart analysis as the restart method does not create new elements for these new loads.

If bolt pretension is to be used, any loads defined for a load case should be applied in a step after the final bolt pretension, as usual.

Also, if bolt pretension is used, a step after the final pretension occurs IS REQUIRED. If this is not included, ANSYS assumes the last bolt pretension will be Loaded and not Locked. This means that ANSYS would modify the pretension to maintain whatever preload you have assigned, rather than applying the service loads as a working load on the bolt. Physically, it would be like tightening/loosening the bolt as the service loads are applied.

Method:
The general steps to this method are as follows:

  1. Set up a model with all of the loads applied to the structure. This includes bolt pretensions and any loads that need to be simulated for the load cases. Set up the Analysis Settings as required for the analysis (multiple load steps, Large Deflections, etc.).
  2. Modify the Restart Controls to keep all restart points once the model is solved.
  3. Modify the loads for the load case studies to be inactive.
  4. Solve the model.
  5. Duplicate the analysis, sharing the Engineering Data, Geometry and Model cells. This guarantees the model setup remains the same for all models.
  6. In the new system, activate the load for the first load case study.
  7. Use the Tools > Read Results File… and locate the file.rst from the previously run analysis. This imports the results data into the model.
  8. Modify the Restart Analysis options in Analysis Settings to restart from the end of the first simulation (the final bolt pretension loading, for example).
  9. Solve the model.

Example:
The example shown here uses an oil field fluid end model with bolt pretensions applied. There are two load cases: 1) a pressure load on the cylinder bore, 2) a force load applied on one side of the fluid end body.

Transferring Deformed Geometry Between Ansys Applications

Often there is a need to export the deformed geometry from Ansys Mechanical. Possibly to a 3D printer to show to customers, or maybe a new CAD geometry file is needed that can be used for drawings or further design evaluation. Ansys Mechanical offers two options for users for doing this task.

Exporting STL (Standard Tessellation Language) files from the deformed results is one option. The STL file may be opened within Ansys Discovery and reverse engineered to create deformed solid geometry from the STL facets.

I have posted a YouTube video that demonstrates this technique. In the video, I have a rubber cushion that is compressed between two metal plates as shown. The rubber geometry gets deformed and the goal here is to export the deformed faceted geometry and create smooth solid geometry from that.

Ansys Mechanical can also export a deformed geometry in a proprietary PMDB (Part Manager Database) format which can be opened up within Ansys Discovery and modified further, or it can simply be opened up within Mechanical for further analysis.

I have also posted a YouTube video that shows how to work with this PMDB file format. In this video, we transfer the deformed geometry shown above from a previously solved FEA and then link its Solution cell to the Model cell of a new Static Structural block.