OUTRES

OUTRES, Item, Freq, Cname, -- , NSVAR, DSUBres
Controls the solution-result data written to the database.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Item

Solution item for database and file-write control:

ALL

 — 

All solution items except LOCI, SVAR, and NAR (default).

BASIC

 — 

Write only NSOL, RSOL, NLOAD, STRS, FGRAD, and FFLUX records to the results file and database.

ERASE

 — 

Resets OUTRES specifications to their default values.

STAT

 — 

Lists the current OUTRES specifications.

NSOL

 — 

Nodal degree-of-freedom solution.

RSOL

 — 

Nodal reaction loads.

V

 — 

Nodal velocity (applicable to structural transient analysis only (ANTYPE,TRANS)).

A

 — 

Nodal acceleration (applicable to structural transient analysis only (ANTYPE,TRANS)).

CINT

 — 

All available results generated by CINT.

SVAR

 — 

State variables (used with supported subroutines that customize material behavior).

ESOL

 — 

Enables or disables all of the following element-solution items. (These items can also be individually enabled or disabled.)

NLOAD

 — 

Element nodal, input constraint, and force loads (also used with 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.

VENG

 — 

Element energies.

MISC

 — 

Element miscellaneous data (ETABLE SMISC and NMISC items).

FMAG

 — 

Electromagnetic nodal forces.

CURD

 — 

Element source current density.

NLDAT

 — 

Element nonlinear data.

EHEAT

 — 

Element heat generation rate.

ETMP

 — 

Element temperatures.

SRFS

 — 

Element surface stresses.

CONT

 — 

Element contact data.

BKSTR

 — 

Element backstresses. Enabling this output also requires that you enable EPPL.

EANGL

 — 

Element Euler angles.

AESO

 — 

Enables or disables all of the following advanced element-solution output items. (These items cannot be individually enabled or disabled.)

BKS - Back-stress for kinematic hardening.
CDM - Damage variable for Mullins effect.
ESIG - BIOT's effective stress.
FFLX - Fluid flow flux in poromechanics.
FICT - Fictive temperature.
FSVAR - Fluence state variables.
MPLS - Microplane damage.
NS - Nominal strain.
PDMG - Progressive damage parameters.
PFC - Failure criteria based on the effective stresses in the damaged material.
PMSV - Permeability state variables.
SEND - Energy record.
TF - Thermal flux.
TG - Thermal gradient.
YSIDX - Yield status for geomechanical materials.

NAR

 — 

Enables or disables all of the following nodal-averaged solution items. (These items can also be individually enabled or disabled.)

NDST

 — 

Nodal-averaged stresses.

NDEL

 — 

Nodal-averaged elastic strains.

NDPL

 — 

Nodal-averaged plastic strains.

NDCR

 — 

Nodal-averaged creep strains.

NDTH

 — 

Nodal-averaged thermal and swelling strains.

DSUB

 — 

Enables Jobname.dsub file writing for all superelements if the nodal degree-of-freedom solution (Item = NSOL) file writing is disabled (see notes for details and an example).

Freq

Specifies how often (that is, at which substeps) to write the specified solution item.

LAST

 — 

Writes the specified solution item only for the last substep of each load step (default).

n

 — 

Writes the specified solution item every nth (and the last) substep of each load step.

-n

 — 

Writes up to n equally spaced solutions.

The time range is divided into equally spaced time points. The first solution at or just past the time point is written. If the time steps span two time points, only one is written.

NONE

 — 

Suppresses writing of the specified solution item for all substeps.

ALL

 — 

Writes the solution of the specified solution item for every substep. This value is the default for a harmonic analysis (ANTYPE,HARMIC) and for any expansion pass (EXPASS,ON).

%array%

 — 

Where array is the name of an n x 1 x 1 dimensional array parameter defining n key times, the data for the specified solution item is written at those key times.

Key times in the array parameter must appear in ascending order. Values must be greater than or equal to the beginning values of the load step, and less than or equal to the ending time values of the load step.

For multiple-load-step problems, either change the parameter values to fall between the beginning and ending time values of the load step or erase the current settings and reissue the command with a new array parameter.

For more information about defining array parameters, see *DIM.

Cname

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

--

Reserved.

NSVAR

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.

DSUBres

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

Blank

 — 

Write the nodal degree-of-freedom solution in Jobname.dsub (default).

ALL

 — 

In addition to the nodal degree-of-freedom 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.

Command Default

Writes the specified solution item for every substep. Exceptions to the default behavior are as follows:

  • For static (ANTYPE,STATIC) or transient (ANTYPE,TRANS) analyses, the default is to write the specified solution item for the last substep of each load step.

  • For a harmonic analysis (ANTYPE,HARMIC) and any expansion pass, the default is to write the specified solution item for every substep.

  • For a mode-superposition transient analysis, the default is to write the reduced displacements file for every fourth substep (as well as the last substep).

Notes

OUTRES controls following output parameters:

  • 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.

The command generates a specification for controlling data storage for each substep, activating storage of the specified solution item for the specified substeps of the solution and suppressing storage of that item for all other substeps.

You can issue OUTRES multiple times in an analysis. After the initial command creating the storage specification, subsequent OUTRES commands modify the specification set for each substep. The command processes your specifications at each substep in the order in which you input them. If you specify a given solution item twice, output is based upon the last specification. Therefore, issue multiple OUTRES commands carefully and in the proper sequence.

In addition to OUTRES, these commands also control solution output: OUTPR, OUTGEOM, and OSRESULT.

You can issue up to 50 output-control commands for OUTRES, OUTPR, OUTGEOM in an analysis. There is no limit on the number of OSRESULT commands.

OUTRES,ERASE erases the existing output specifications and resets the counted number of OUTRES commands to zero. The ERASE argument works in a similar manner for OUTPR, OUTGEOM, and OSRESULT.

A given OUTRES command generally has no effect on solution items not specified. For example, an OUTRES,ESOL,LAST command does not affect NSOL data; that is, it neither activates nor suppresses NSOL data storage in any substep. An exception to this behavior involves the EANGL solution item.

OUTRES controls element Euler angle (EANGL) data output as follows:

  • When Freq = NONE, no element Euler angles are output at any substeps.

    Without Euler angles, element results postprocessing can occur in the element solution coordinate system only (that is, RSYS has no effect on element results); therefore, nodal averaging of element solution items may not be applicable when element solution coordinate systems are not uniform.
  • When Freq = any other value (including the command default), element Euler angles are output at substeps specified by Freq, and at any substeps where one or more tensorial element solution items (STRS, EPEL, EPTH, EPPL, EPCR, EPDI, FGRAD, FFLUX, and AESO) are output.

Additional results in the Jobname.dsub file (DSUBres = ALL) can only be requested in the first load step.


Important:  In the results-item hierarchy, certain items are subsets of other items. For example, element solution (ESOL) data is a subset of all (ALL) solution data. An OUTRES,ALL command can therefore affect ESOL data. Likewise, an OUTRES command that controls ESOL data can affect a portion of all data.

The example OUTRES commands illustrate the interrelationships between solution items and why it is necessary to issue OUTRES thoughtfully.


To suppress all data at every substep, issue the OUTRES,ALL,NONE command. (OUTRES,ERASE does not suppress all data at every substep.)

The NSOL, RSOL, V, and A solution items are associated with nodes. The CINT solution item is associated with fracture. All remaining solution items are associated with elements.

Enabling nodal-averaged results (Item = NAR or any of the associated labels) generally reduces the results file size, provided the equivalent element-based results are concurrently disabled. When nodal-averaged results are enabled, element values for stress and strain are averaged and stored as nodal values. Some limitations apply when using nodal averaged results. For more information and an example, see Nodal-Averaged Results in the Element Reference.

The boundary conditions (constraints and force loads) are written to the results file only if either nodal or reaction loads (NLOAD or RSOL items) are also written.

Usage considerations when specifying Freq:

  • The only valid labels for Freq are NONE or ALL for the following:

    • Modal analysis

    • Component mode synthesis (CMS) generation pass with Elcalc = YES on the CMSOPT command

    • Any expansion pass (EXPASS,ON)

  • When superelements exist in the model, the Freq specified for Item = NSOL controls the write frequency of the nodal degree-of-freedom solution to the Jobname.rst file and the superelements reduced nodal degree-of-freedom solution to the Jobname.dsub file. The program only considers a Freq specification for Item = DSUB if file writing for Item = NSOL is disabled.

    Example 11: To enable Jobname.dsub file writing (Item = DSUB at a specified Freq ), first disable nodal DOF solution writing to the Jobname.rst file (Item = NSOL)

    OUTRES,ERASE        !reset specifications to default values 
    OUTRES,ALL,NONE     !disable writing of all solution items, including NSOL 
    OUTRES,DSUB,ALL     !enable Jobname.dsub file writing at every substep

    After issuing the above commands, the nodal degree-of-freedom solutions are not written to Jobname.rst, but the reduced nodal degree-of-freedom solutions are written to Jobname.dsub for every substep.


For additive manufacturing analyses during the build step (AMSTEP,BUILD), Freq refers to the layer number (for example, output ALL layers, LAST layer, or every Nth layer).

If the minimum time step value is small (DELTIM,,DTMIN) while Freq contains a large value, then the time steps will not be written to the .rst file due to the resulting calculation of these set of values.

To specify selected results to output to the database, see OSRESULT.

OUTRES is also valid in PREP7.

Example

When issuing an OUTRES command, think of a matrix in which you set switches on and off. When a switch is on, a solution item is stored for the specified substep. When a switch is off, a solution item is suppressed for a specified substep.

Assuming a static (ANTYPE,STATIC) analysis, this example shows how the matrix looks after issuing each OUTRES command in this six-substep solution.

NSUBST,6
OUTRES,ERASE
OUTRES,NSOL,2
OUTRES,ALL,3
OUTRES,ESOL,4
SOLVE

To simplify the example, only a subset of the available solution items appears in the matrix.

OUTRES,ERASE -- After issuing this command, the default output specifications are in effect, as shown:

SubstepResults Item Specification
ALL
BASIC
NSOLRSOLESOL
NLOADSTRSFGRADEPELEPTH
1offoffoffoffoffoffoff
2offoffoffoffoffoffoff
3offoffoffoffoffoffoff
4offoffoffoffoffoffoff
5offoffoffoffoffoffoff
6ONONONONONONON

OUTRES,NSOL,2 -- This command modifies the initial specifications so that NSOL is enabled for substeps 2, 4 and 6, and disabled for substeps 1, 3 and 5, as shown:

SubstepResults Item Specification
ALL
BASIC
NSOLRSOLESOL
NLOADSTRSFGRADEPELEPTH
1offoffoffoffoffoffoff
2ONoffoffoffoffoffoff
3offoffoffoffoffoffoff
4ONoffoffoffoffoffoff
5offoffoffoffoffoffoff
6ONONONONONONON

OUTRES,ALL,3 -- This command further modifies the specifications so that ALL is enabled for substeps 3 and 6, and disabled for substeps 1, 2, 4 and 5, as shown:

SubstepResults Item Specification
ALL
BASIC
NSOLRSOLESOL
NLOADSTRSFGRADEPELEPTH
1offoffoffoffoffoffoff
2offoffoffoffoffoffoff
3ONONONONONONON
4offoffoffoffoffoffoff
5offoffoffoffoffoffoff
6ONONONONONONON

OUTRES,ESOL,4 -- This command once again modifies the specifications so that ESOL is enabled for the fourth and last substeps, and disabled for substeps 1, 2, 3 and 5, as shown:

SubstepResults Item Specification
ALL
BASIC
NSOLRSOLESOL
NLOADSTRSFGRADEPELEPTH
1offoffoffoffoffoffoff
2offoffoffoffoffoffoff
3ONONoffoffoffoffoff
4offoffONONONONON
5offoffoffoffoffoffoff
6ONONONONONONON

SOLVE

When obtaining the solution, results data are stored as follows:

SubstepResults Items Stored
1No data
2No data
3NSOL and RSOL data
4ESOL data
5No data
6ALL data

Menu Paths

Main Menu>Preprocessor>Loads>Analysis Type>Sol'n Controls>Basic
Main Menu>Preprocessor>Loads>Load Step Opts>Output Ctrls>DB/Results File
Main Menu>Solution>Analysis Type>Sol'n Controls>Basic
Main Menu>Solution>Load Step Opts>Output Ctrls>DB/Results File