(800) 566-9190 Contact Us Follow SimuTech Group on LinkedIn Follow SimuTech Group on Facebook SimuTech Group’s Twitter account SimuTech Group’s YouTube Channel

SimuTrain® is ANSYS training on demand!

  • Basic & Advanced Level Training Modules
  • ANSYS & SimuTech Training Videos
  • Lectures, Tutorials & Workshops
  • 1 hour Web-based ANSYS Sessions to Practice Hands-on Workshops

Learn more about SimuTrain or get started today by purchasing your subscription.


Follow SimuTech Group on LinkedIn Follow SimuTech Group on Facebook Follow SimuTech on Twitter SimuTech Group’s YouTube Channel

Post-processing APDL Models inside ANSYS® Workbench v15.0

ANSYS Postprocessing APDL 1

Figure 1: External Model in ANSYS Workbench Mechanical v15.0

ANSYS Workbench Mechanical v15.0 supports “External Model” – a facility for directly importing an ANSYS Mechanical APDL model’s CDB mesh file into Workbench for subsequent study or results postprocessing in a Workbench Mechanical schematic. This includes the ability to read a results RST or RTH file that corresponds to the CDB file that has been attached as an External Model. The approach applies to solid and shell models. This article describes an approach with solid elements.

This article reviews steps in creating a CDB file in ANSYS Mechanical APDL, and reading in the CDB file in Workbench, plus importing results from an associated RST results file. This permits the Workbench Mechanical environment’s tools to be employed in postprocessing a model that originated in ANSYS Mechanical APDL, as well as generating a report to automate generation of data that might be of interest in the appendix to an engineering report. Good quality modern graphics images of models, animations, results scoping, and other features of the Workbench Mechanical interface may be of interest to users.

Using an ANSYS APDL External Model in Workbench 15.0

Workbench Mechanical at release 15.0 has a new External Model component system that can take a solid or shell finite element mesh from a CDB file, and generate a solid model with a mesh for use in Workbench Mechanical. Users should review the ANSYS v15.0 Help system for information on this External Model feature. It contains information on reading an external model, as well as on rotating and translating the geometry that is imported.

ANSYS PostProcessing APDL 2

Figure 2: External Model Help Documentation in ANSYS v15.0

The External Model approach for model review is not an officially supported feature of the ANSYS software, so users intended to use this facility must do their own quality control if this feature is employed.

To use this feature, a CDB file that contains a supported mesh type must be generated in ANSYS Mechanical APDL. The CDWRITE command of ANSYS is used in /PREP7 to generate the CDB file. Arguments are set to generate the mesh, without the geometry data, for example:

CDWRITE, Option, Fname, Ext, --, Fnamei, Exti, Fmat
Writes geometry and load database items to a file

The following example generates a mesh file only (no associated geometry):


The following example model contains SOLID185 8-node brick solid structural elements subject to pressure loading and to constraint on node movements. It could be solved in ANSYS Mechanical APDL, in which case an RST structural results file would be generated in the working directory:

ANSYS PostProcessing APDL 3

Figure 3: ANSYS Mechanical APDL Model with SOLID185 Elements and Loads

In the ANSYS Mechanical APDL interface, the following menu item will generate a CDB file for the above mesh:

ANSYS PostProcessing APDL 4

Figure 4: Creating a CDB File of the Mesh via the ANSYS Mechanical APDL Menu System 


Workbench v15.0 is capable of reading the CDB file of the mesh, fitting a geometry to the mesh, and sending the resulting model of geometry and mesh into Workbench Mechanical for study in that environment, making the various tools of Workbench Mechanical available for further studies on models that originate in the APDL interface.

For simplicity, start by setting Units to those employed in the CDB file—the user must know this in advance:

ANSYS PostProcessing APDL 5

Figure 5: Set Units before Starting


In the Workbench project page, drag an External Model component system into the Project Schematic.

ANSYS PostProcessing APDL 6

Figure 6: Drag External Model into the Project Schematic


Then, drag an appropriate analysis system into the Project Schematic, such as the Static Structural. Next, drag the Setup cell of the External Model to the Model branch of the Static Structural system:

ANSYS PostProcessing APDL 7

Figure 7: Drag the Setup Cell of the External Model to the Model Cell of the Static Structural System 


Right-click the Setup cell of the External Model system, and choose Edit:

ANSYS PostProcessing APDL 8

Figure 8: Edit Setup for the External Model Schematic


A Data Source window opens; Browse to the CDB file of interest:

ANSYS PostProcessing APDL 9

Figure 9: Browse to the CDB File to be Imported


Find the CDB file for import, click it, and click Open. Now, close the window by clicking the X:

ANSYS PostProcessing APDL 10

Figure 10: Exit this Window


Click the linked Model cell in the Static Structural system, right click, and choose Properties:

ANSYS PostProcessing APDL 11

Figure 11: Adjust Properties for the Geometry to be Fitted


In the Properties window that opens on the right, choose the Length Unit as in the CDB file, tweak the Tolerance Angle if needed to aid in fitting geometry faces to the mesh in a complex model, and indicate whether the analysis is 3D or 2D. Nodal Components will be included by default and might be desired to use as Named Selections:

ANSYS PostProcessing APDL 12

Figure 12: Model Properties and CDB Import Options


Note the “Process Nodal Components” entry above. Nodal components in the APDL model (see the CM command) become Named Selections in Workbench Mechanical, corresponding to faces in 3D. To postprocess results on these components, ensure the check mark is set as in the figure above.

Now, the External Model can be updated by clicking Setup, right-clicking, and choosing Update.

ANSYS PostProcessing APDL 13

Figure 13: Updating the Setup Cell


Geometry will have been fitted to the mesh, and the Static Structural system can be opened to commence work:

ANSYS PostProcessing APDL 14
Figure 14: Ready to Open Workbench Mechanical for the Resulting Model


Right-click Model in the Static Structural system, and choose Edit:

ANSYS PostProcessing APDL 15

Figure 15: Open Workbench Mechanical


The Workbench Mechanical window is exposed. Elements from the CDB file are present, as is the geometry that was fitted to the elements. The materials used are not those of the CDB file—they are taken from the Engineering Data branch of the Static Structural system, and defaults will be assigned. Loads are not read from the CDB file, either. Note that the Static Structural system in the figure below is not ready to be solved—neither loads nor boundary conditions are present.

ANSYS PostProcessing APDL 16

Figure 16: Meshed Model Imported into Workbench Mechanical—Not Ready to Solve


Here is the mesh that came from the CDB file in this example:

ANSYS PostProcessing APDL 17

Figure 17: Mesh on which Geometry Was Built in Workbench


As stated neither loads nor materials are imported from the CDB model. At this point, a user could assign Engineering Data materials to geometric entities, place loads and boundary conditions on the model, and solve the FEA model. Alternatively, the CDB model’s RST results file can be imported, which will be illustrated next.

The model indicates that it is not ready to be solved because of the absence of loads and boundary conditions:

ANSYS PostProcessing APDL 18

Figure 18: The Environment Is Not Ready to Solve


Place an empty APDL Commands Object in the Static Structural environment. Its presence lets Workbench Mechanical assume loading exists, so that a user can load results from an RST file. This is seen in the figure below:

ANSYS PostProcessing APDL 19
Figure 19: An APDL Commands Object Lets a User Continue


Highlight the Solution branch, and go to Tools > Read Results Files… to access the RST file:

ANSYS PostProcessing APDL 20
Figure 20: Access the RST File of the CDB Model


The RST file is selected, usually from the working directory in which the CDB file was found. Note that the .ERR error file for the model must exist there. If none exists, a dummy file with the correct job name can be created there, using the .ERR extension.

ANSYS PostProcessing APDL 21

Figure 21: Select the RST File for the CDB Model


The above window closes when the Open button is clicked. This is followed by a dialog box requesting that the user indicate the Units employed... the user must ensure that the correct choice is made, and click OK:

ANSYS PostProcessing APDL 22
Figure 22: Indicate Units in the CDB File and RST File


With this done, a user can begin to request results below the Solution branch.

Branches for results such as Deformation or Stress might be inserted:

ANSYS PostProcessing APDL 23

Figure 23: Create Branches for Results of Interest.


A request to Evaluate All Results is made next:

ANSYS PostProcessing APDL 24

Figure 24: Evaluate Results


Users can employ the various tools of Workbench Mechanical to review results from the RST file.

ANSYS PostProcessing APDL 25

Figure 25: Results Imported from the RST File


If desired, a user can work directly from an RST file, without a CDB or database DB file. Start ANSYS Mechanical APDL, go to /POST1, and use the File command to indicate an RST results file of interest. Use the SET command to read a result of interest—this works for RST files that, by default in APDL, contain element and node data for the model. Go to /PREP7 and use CDWRITE to write a CDB mesh file. Workbench can now read the CDB file, fit geometry to the mesh, and read the RST file (the .ERR file must exist—create a blank jobname.err file if necessary matching the CDB file). Workbench Mechanical can now postprocess a model for which only an old RST file exists. (RST files generated by Workbench Mechanical will not contain this mesh data, for size efficiency.) As seen in Figure 25 above, this approach can display degree of freedom data (displacement in a structure). It can display stress and strain if they exist in the RST file. Probes cannot be created for reaction forces and forces across contacts since no such objects exist in the Outline—APDL Commands Objects would review such things.

During model review, Construction Geometry can be used to create Paths and Surfaces to be used in postprocessing objects. Figure 26 below illustrates stress on a surface object.

ANSYS PostProcessing APDL 26

Figure 26: Result on a Surface

A Path can be created by various techniques, and results or linearized results shown on the path, for example:

ANSYS PostProcessing APDL 27

Figure 27: Linearized Result on a Path


Results can also be presented as scoped onto selected geometry:

ANSYS PostProcessing APDL 28

Figure 28: An Example: Scoped Results Can Be Examined 


An imported CDB file could contain contacts. If the RST file contains contact results, these can be inspected in the Workbench Mechanical model. The following figure shows two bodies in contact. A contact pair is created as a result of geometric proximity of parts—this does not reflect what contacts existed in the CDB file. In this example, the contact pair has been given the same “Type” as that in the CDB file.

They have been squeezed together in the ANSYS Mechanical APDL model:

ANSYS PostProcessing APDL 29

Figure 29: Bodies in Contact as Imported from CDB and RST Files


A Contact Tool can be created for a contact pair, and if the “contact” surface of the pair in the CDB file contains a result, the contact result can be reviewed in Workbench Mechanical:

ANSYS PostProcessing APDL 30

Figure 30: Contact Result as Imported from CDB and RST Files



Workbench Mechanical v15.0 can use External Model to read an ANSYS Mechanical APDL model’s CDB file for a mesh (as written by the CDWRITE command) for typical solid and shell elements. Geometry can be fitted to the mesh, and Workbench Mechanical can receive the meshed model. An associated results file (RST file for structures) can be read into Workbench Mechanical, so that the tools of Workbench Mechanical can be used for model review.

Generating a Report within Workbench Mechanical can produce extensive model information of potential interest, which would be tedious to generate manually.

Many creative applications for this External Model capability can be developed, in addition to merely using Workbench Mechanical to review the results of ANSYS Mechanical APDL models. Note that inside ANSYS Mechanical APDL, the UPGEOM and UPCOORD commands can be used to move nodes of an unstressed model into the positions calculated by a SOLVE. A factor can be applied to the movements, using values other than a default 1.0. If a negative factor of -1.0 is used, nodes are moved into a position such that when loaded, a structure moves into the position of the original geometry (in a linear analysis). This might be used, for example, to find how to shape a structure so that it moves into a desired geometric shape after loading. Workbench Mechanical and FE Modeler could be used to find the geometry that fits that pre-deformed mesh. A more complex procedure could be used if large deflection effects were relevant for accuracy.

This External Model approach permits the tools of Workbench Mechanical to be used to examine the results of old ANSYS APDL models with the various advantages of the Workbench interface.

Looking for more ANSYS Tips & Tricks?

Check out 300+ more videos and articles on our SimuTrain® Portal.

Get SimuTrain Now!