Mapdl.reswrite(fname='', cflag='', **kwargs)

Appends results data from the database to a results file.


  • fname

    File name and directory path (248 characters maximum, including the characters needed for the directory path). An unspecified directory path defaults to the working directory; in this case, you can use all 248 characters for the file name. The file name extension varies as follows:

    • .RST for structural, fluid, or coupled-field analyses

    • .RTH for thermal or electrical analyses

    • .RMG for magnetic analyses

  • cflag

    0 - The complex results flag is set to 0 in the results file header. This is the default option.

    1 - The complex results flag is set to 1 in the results file header.


The RESWRITE command appends a data set to the specified file by writing the results data currently in the database. If the intended results file does not exist, it will be created and will include the geometry records. The current load step, substep, and time (or frequency) value are maintained. All data (summable and nonsummable) are written.

When complex results are appended, cFlag must be set to 1 so that the header is consistent with the results written on the file.

The command is primarily intended for use in a top-down substructuring analysis, where the full model is resumed and the results data read from the use pass results file (SET), and subsequently from all substructure expansion pass results files (APPEND). The full set of data in memory can then be written out via the RESWRITE command to create a complete results file (as though you had run a nonsubstructured analysis).

The RESWRITE command can also be used to write a global results file for a distributed parallel (Distributed ANSYS) solution. This should only be necessary if the RESCOMBINE command was used to combine results from local results files into the database. The RESWRITE command can then be used to write the combined results into a new results file. This new results file will essentially contain the current set of results data for the entire (i.e., global) model.