combine#

Mapdl.combine(filetype='', **kwargs)[source]#

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.