Mechanical APDL

You can use ANSYS Workbench to launch the Mechanical APDL application (formerly known as the ANSYS software), and therefore to manage the various files often used and created by Mechanical APDL, especially when working with a linked analysis (for example, thermal-stress, substructuring, submodeling, and so on). It is important that you understand the types of files that the Mechanical APDL application uses and generates, because the actions you take in ANSYS Workbench will act on these files. These files fall into three broad categories: input, reference, and output.

Input Files Files that are consumed directly by the Mechanical APDL application. Examples include:


Note:  In some cases, the Mechanical APDL solver will overwrite one of its input files with its generated output (for example, the file .rst file from a Modal system in a Modal to Response Spectrum analysis linked to a Mechanical APDL component system). If this occurs, subsequent updates of the Mechanical APDL component system will fail. To copy the correct input from an upstream system, perform a Reset operation on the Mechanical APDL component system.


Referenced Files Files that are referenced by the execution of an input file. Examples include:

Output Files Files that are produced by all Mechanical APDL application runs. Primary output files include:

Working with a Mechanical APDL Analysis

To add a Mechanical APDL analysis to your project, double-click the Mechanical APDL object or drag-and-drop it from the Component Systems area of the Toolbox into the Project Schematic. A Mechanical APDL system appears in the Project Schematic.

You can easily connect other systems to a Mechanical APDL system by using the Transfer Data From New or Transfer Data To New context menu options. You can also drag systems from the toolbox, or manually create links between systems. When transferring data to a Mechanical APDL system from another system, you can transfer data from the following cell sources:


Note:  For Model, Setup (Mechanical Systems), and Solution transfer cells, if you solve within Mechanical, you will still need to run an Update on the appropriate cell in the Mechanical system in order to the obtain the correct state on the schematic.

In most cases, Model and Setup components from the same Mechanical system should not be linked to one Mechanical APDL system. Doing so will cause the Mechanical system to provide two different (and possibly conflicting) input files to the Mechanical APDL system.



Important:  The Mechanical APDL system consumes all input data without unit system knowledge. You must assure that all input data being used by the Mechanical APDL system is in a consistent unit system. See Solving Units for more information on unit system.


When transferring data from a Mechanical APDL system to another Mechanical APDL system, you can transfer four types of data:

You can also transfer data to a new Finite Element Model system, which uses the .cdb file(s).

These files are simply copied to the new system if they exist; ANSYS Workbench does not generate the files. Before transferring data to a new system, be sure that you have an input file that generates the necessary files from the existing Mechanical APDL system.

When you transfer data to or from another system, right-mouse click the link connecting the systems and select Properties. The Properties window will open, detailing the nature of the transfer (such as Transfer CDB File).

Note on connecting to Mechanical systems Named Selections and Coordinate Systems that are added to a solved Mechanical system will not be immediately reflected in downstream Mechanical APDL systems. They will be available in future solution attempts.

To open the Components workspace to select Mechanical APDL parameters, double-click the Analysis cell or right mouse-click and select Edit. From the Components workspace, you can select Mechanical APDL parameters or specify setup properties (such as command line options, memory settings, number of processors, etc.).

When you add an input file via the context menu, ANSYS Workbench automatically searches the file for potential parameters (*SET, *GET, = assignments, etc.). Those parameters are then displayed in the Properties view when that input file is selected in the Outline view. To use one of those parameters, check that parameter's check box in the Property view and indicate whether it should be used as an input or an output parameter. Input parameters are sent to Mechanical APDL with the value specified upon Update. After the Update, ANSYS Workbench retrieves the output values from Mechanical APDL and sets those values in ANSYS Workbench.


Note:  The presence of a /EXIT command in the input file causes state and parameters to malfunction. Make sure you remove this command before adding the input file.


To launch the Mechanical APDL application interactively, right mouse-click and select Edit in Mechanical APDL or Open in Mechanical APDL as explained below in Mechanical APDL Context Menu Options.

To launch the Mechanical APDL application with input and reference files specified, right mouse-click the Analysis cell and select Add Input File or Add Reference File. Then select Edit in Mechanical APDL. The Mechanical APDL application will launch in interactive mode, and the input file(s) specified will be piped to the Mechanical APDL application, and processed in the order listed. After all of these files are processed, the Mechanical APDL application remains active and you can continue your analysis using the standard Mechanical APDL application interface. Any action you take in the Mechanical APDL application will not be reflected in ANSYS Workbench state indicators or parameters.

Be aware that any time you launch the Mechanical APDL application, ANSYS Workbench does not log or record the actions that occur in the Mechanical APDL application. If you make changes in the Mechanical APDL application, be sure that the changes are reflected appropriately in the input files. To maintain connectivity (such as to read output parameters), use the Update capability, either at the project level or at the appropriate system/cell level.

To save Mechanical APDL changes from an open session, you must include a SAVE command in one of your input files. The ANSYS Workbench save capability does not invoke the Mechanical APDL SAVE command.

When you add an input file, you will see the files listed in the files detail view. Files will be processed in the order shown. You can change the order in which the files are processed by dragging the files into the proper order. To delete files, right-mouse click the file to be deleted and select Delete.

To stop a Mechanical APDL batch run, view the Progress window. Click the Stop button on the Progress cell.

Mechanical APDL Context Menu Options

When the Mechanical APDL system is active in the schematic, use the right mouse button to initiate the following Analysis cell actions.

Edit

Opens the Components workspace, where you can specify Mechanical APDL parameters and setup properties. This is the default action.

Edit in Mechanical APDL

Launches the Mechanical APDL application interactively and reads the input files. If the state is currently up to date, ANSYS Workbench sets the state to Update Required at this time, even if you do not make any changes in the Mechanical APDL application.

Open in Mechanical APDL

Launches the Mechanical APDL application interactively without reading any input files. Any action you take in the Mechanical APDL application will not be reflected in ANSYS Workbench state indicators.

Add Input File

Displays a Browse… dialog box to add an input file. When you add an input file, the file is immediately copied into the project directory. To make changes to this file, change the file in the project directory, not the original file. If you have a large input file and have disk space concerns, keep the file in the directory of your choice and use a separate input file to reference it (via the /INPUT command).

Add Referenced File

Displays a Browse… dialog box to add a referenced file. When you add a referenced file, the file is immediately copied into the project directory. To make changes to this file, change the file in the project directory, not the original file. If you have a large reference file and have disk space concerns, keep the file in the directory of your choice and reference it manually.

Track Solution

During an Update, this option launches the Results Tracking tool, allowing you to monitor diagnostics results of interest in real time during the solution. For more information, see the NLHIST command.

Update

Update runs the Mechanical APDL application in batch mode, processing all input files in the order listed. If you make changes in the Mechanical APDL application, be sure that the changes are reflected appropriately in the input files before running an Update. Otherwise, an Update could potentially overwrite the work you've done in the Mechanical APDL application.


Note:  An Update will launch the Mechanical APDL application in batch mode, using all input and referenced files in the order shown in the Outline pane. After all files are processed, the Mechanical APDL application exits. Updating will capture any output parameters generated in the Mechanical APDL application and allow you to continue working in ANSYS Workbench.


Refresh

Copies the latest transfer files into the project directory. Input and referenced files are not re-copied from their original locations. If you change an upstream system after you make changes to the Mechanical APDL application, a refresh could potentially overwrite your Mechanical APDL application changes. Be sure that any changes you do in the Mechanical APDL application are reflected appropriately in the input files before running a Refresh. Only changes that occur within the schematic are captured with a Refresh Required state; ANSYS Workbench will not indicate Refresh Required for changes made directly to a file (such as manually editing an input file).

Clear Generated Data

Deletes all files on disk in the system directory except input or reference files. It will not affect any input or reference files.

Rename, Reset

Standard actions as described in Common Context Menu Options.

Properties

Launches the Properties window, where you can define graphics settings, command line options, database and tab memory, and other settings. Be aware when selecting graphics settings that some options are potentially platform-specific and must be changed when switching platforms before running the project with Mechanical APDL in interactive mode.

Note on the solver input file generated from the Setup cell of a Mechanical APDL system The solver input file transferred from the Setup cell contains all the commands needed to execute a complete run, including any SOLVE commands that are necessary. However, the input also contains a conditional /EOF statement to halt reading of the file and thus not execute the solve. This conditional statement will be executed when the Mechanical APDL application is invoked from the Edit in Mechanical APDL context menu option, therefore running the analysis to the point just prior to the SOLVE command. If a different behavior is desired, you can edit the input file in the Mechanical APDL system folder to obtain a different behavior or to add an additional input file containing the SOLVE command.


Release 18.2 - © ANSYS, Inc. All rights reserved.