OSRESULT
OSRESULT, Item,
Comp, Freq,
Cname
Controls the selected result data written to the database.
ItemItem to output to the database. See Table 210: OSRESULT - Item and Component Labels.
CompComponent of
Itemto output to the database. See Table 210: OSRESULT - Item and Component Labels.FreqFrequency to output to the database.
n—
Writes every
nth and last substep of each load step.-n—
Writes up to
nequally spaced substeps of each load step.ALL
—
Writes every substep.
LAST
—
Writes the last substep of each load step (default).
CnameThe name of an element component (CM) defining the set of elements for which this specification is active. If not specified, the set is all elements.
Notes
OSRESULT controls output to the results database for the selected result defined by the item and component combination. The command activates output of the selected result for the specified substeps and elements. Multiple commands for the same result are cumulative. No selected results are written to the database unless specified via OSRESULT.
The saved selected quantities are accessible via standard postprocessing commands (ANSOL, ETABLE, ESOL, PLESOL, PLNSOL, PRESOL, and PRNSOL).
OSRESULT,ERASE deletes the existing output specifications.
OSRESULT,STATUS lists the current set of selected result specifications.
The output of selected results is valid for static (ANTYPE,STATIC) and transient (ANTYPE,TRANS) analysis types.
To select other results to output to the database, see OUTRES. (Element quantities specified via OUTRES can be redundant to those specified via OSRESULT. Avoid specifying redundant quantities, as they are stored and processed separately.)
All OSRESULT results are in the solution coordinate system.
This command is also valid in PREP7.
Table 210: OSRESULT - Item and Component Labels
| Component Name Method | ||
|---|---|---|
| Item | Comp | Description |
| ERASE | -- | Erases all selected result output specifications |
| STATUS | -- | Lists the current set of selected result output specifications |
| SVAR | 1,2,3, …, N | State variable number |
| FLD | UF01, UF02, ... , UF09 | User-defined field variables |
| S | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent ) stresses |
| EPEL | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent) elastic strains |
| EPPL | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent) plastic strains |
| EPCR | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent) creep strains |
| EPTH | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent) thermal strains |
| CDM | DMG, LM | Mullins effect damage variable (DMG) and maximum previous strain energy for virgin material (LM) |
| PMSV | VRAT, PPRE, DSAT, RPER | Initial void volume ratio (VRAT), pore pressure (PPRE), degree of saturation (DSAT), and relative permeability (RPER) for coupled pore-pressure-thermal CPT elements |
| FFLX | X, Y, Z | Fluid flow flux components in poromechanics |
| FGRA | X, Y, Z | Fluid pore pressure gradient components in poromechanics |
| BKS | X, Y, Z, XY, YZ, XZ | Total nonlinear kinematic backstress components |
| GDMG | ETA, ETAC, IDRA, DUCT | Generalized and ductile damage value (leave Comp Blank), local internal variable eta representing the local deformation (ETA), threshold of eta (ETAC), inelastic dissipation rate (IDRA), and ductile damage criterion (DUCT) |
| ESIG | X, Y, Z, XY, YZ, XZ, 1, 2, 3, INT, EQV | Component and derived (principal, intensity, equivalent) Biot’s effective stresses |
| SEND | ELAS, PLAS, CREE, DAMA, VDAM, VREG, DISS, ENTO | Elastic strain energy density (ELAS), plastic strain energy density (PLAS), creep strain energy density (CREE), damage strain energy density (DAMA), viscoelastic dissipation energy density (VDAM), visco-regularization strain energy density (VREG), structural-thermal dissipation (DISS), and total strain energy density (ENTO) |
| MPLA | DMAC, DMAX | Microplane damage, macroscopic (DMAC) and maximum (DMAX) values. |
| TF[a] | X, Y, Z | Thermal flux components |
| TG[a] | X, Y, Z | Thermal gradient components |
| MPDP | TOTA, TENS, COMP, RW | Microplane homogenized total, tension, and compression damages (TOTA, TENS, COMP), and split weight factor (RW). |
| EPFR | Free strain in porous media (leave Comp Blank) | |
| DAMA | 1, 2, 3, MAX | Damage in directions 1, 2, 3 (1, 2, 3) and the maximum damage (MAX). |
| IDIS | Structural-thermal dissipation rate (leave Comp Blank) | |
Example 10: Specifying and Retrieving Selected Result Output
/SOLU
OUTRES,ALL,NONE ! Here we want only selected results output,
! so we suppress solution-result data written
! to the database via OUTRES.
! Issue OSRESULT to specify selected results.
OSRESULT,S,Y,ALL ! Item = S, Comp = Y
OSRESULT,S,EQV,ALL ! Item = S, Comp = EQV
OSRESULT,EPPL,INT,ALL ! Item = EPPL, Comp = INT
...
/POST1
! When issuing postprocessing commands to retrieve selected
! results (SRES), specify ItemComp (Item + Comp combined)
! from OSRESULT.
PRESOL,SRES,SY
PRESOL,SRES,SEQV
PRNSOL,SRES,EPPLINT
...