combine

Mapdl.combine(filetype='', **kwargs)

Combines distributed memory parallel (Distributed ANSYS) files.

APDL Command: COMBINE

Parameters

filetype

Type of solution file to combine. There is no default; if (blank), the command is ignored.

RST - Structural results file (.RST)

RTH - Thermal results file (.RTH)

RMG - Magnetics results file (.RMG)

RSTP - Linear perturbation results file (.RSTP)

EMAT - Element matrix file (.EMAT).

ESAV - Element saved data file (.ESAV)

MODE - Modal results file (.MODE)

MLV - Modal load vector file (.MLV)

IST - Initial state file (.IST)

FULL - Full matrix file (.FULL)

RFRQ - Reduced complex displacement file (.RFRQ)

RDSP - Reduced displacement file (.RDSP)

Notes

The COMBINE command is used within the AUX2 auxiliary processor to combine local solution files from a distributed memory parallel solution into a single, global file. Before using this command, you must enter the AUX2 processor by issuing the /AUX2 command.

In a distributed memory parallel (Distributed ANSYS) solution, you can use the DMPOPTION command to bypass the file combination step, causing all individual local files to be kept on the local disks in the current working directory. Later on, you can start a new distributed memory parallel solution and use the COMBINE command to combine local files into a global file for a downstream solution or another operation (e.g., postprocessing with /POST1). For example, the command COMBINE,RST will combine local results files (JobnameN.RST) into a global results file (Jobname.RST).

When the COMBINE command is used in a subsequent Distributed ANSYS session, the number of processors must be the same as in the distributed memory parallel solution that generated the files.

When running on a cluster, the local solution files must be available in the working directory on each node in the subsequent session. As an example, consider the following command line used to generate local solution files:

Different machines can be used in the subsequent session to combine these files. However, the total number of cores must remain unchanged (seven in the above case), and the local files must be copied to the working directory (or directories) on each of the machines used in the subsequent session.