Mapdl.outres(item='', freq='', cname='', nsvar='', dsubres='', **kwargs)[source]#

Controls the solution data written to the database.



Results item for database and file write control:

ALL - All solution items except LOCI and SVAR. This behavior is the default.

CINT - All available results generated by the CINT command

ERASE - Resets OUTRES specifications to their default values.

STAT - Lists the current OUTRES specifications.

BASIC - Write only NSOL, RSOL, NLOAD, STRS, FGRAD, and FFLUX records to the results

file and database.

NSOL - Nodal DOF solution.

RSOL - Nodal reaction loads.

V - Nodal velocity (applicable to structural full transient analysis only


A - Nodal acceleration (applicable to structural full transient analysis only


ESOL - Element solution (includes all items following):

NLOAD - Element nodal, input constraint, and force loads (also used with the /POST1

commands PRRFOR, NFORCE, and FSUM to calculate reaction loads).

STRS - Element nodal stresses.

EPEL - Element elastic strains.

EPTH - Element thermal, initial, and swelling strains.

EPPL - Element plastic strains.

EPCR - Element creep strains.

EPDI - Element diffusion strains.

FGRAD - Element nodal gradients.

FFLUX - Element nodal fluxes.

LOCI - Integration point locations.

SVAR - State variables (used only by UserMat).

MISC - Element miscellaneous data (SMISC and NMISC items of the ETABLE command).


Specifies how often (that is, at which substeps) to write the specified solution results item. The following values are valid:


The name of the component, created with the CM command, defining the selected set of elements or nodes for which this specification is active. If blank, the set is all entities. A component name is not allowed with the ALL, BASIC, or RSOL items.

Reserved for future use.


The number of user-defined state variables (TB,STATE) to be written to the results file. Valid only when Item = SVAR and user-defined state variables exist. The specified value cannot exceed the total number of state variables defined; if no value is specified, all user-defined state variables are written to the results file. This argument acts on all sets of user-defined state variables that exist for the model.


Specifies whether to write additional results in Jobname.DSUB during a substructure or CMS use pass in transient or harmonic analysis.

Blank - Write the nodal DOF solution in Jobname.DSUB (default).

ALL - In addition to the nodal DOF solution, also write necessary data to compute

quantities using nodal velocity and nodal acceleration (damping force, inertial force, kinetic energy, etc.) in the subsequent expansion pass. For more information, see Step 3: Expansion Pass in the Substructuring Analysis Guide.


The OUTRES command allows you to specify the following:

The solution item (Item) to write to the database (and to the reduced displacement and results files)

The frequency (Freq) at which the solution item is written (applicable to static, transient, or full harmonic analyses)

The set of elements or nodes (Cname) to which your specification applies.