ESOL

ESOL, NVAR, ELEM, NODE, Item, Comp, Name
Specifies element data to be stored from the results file.

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

NVAR

Arbitrary reference number assigned to this variable (2 to NV (NUMVAR)). Overwrites any existing results for this variable.

ELEM

Element for which data are to be stored. If ELEM = P, graphical picking is enabled (valid only in the GUI).

NODE

Node number on this element for which data are to be stored. If blank, store the average element value (except for FMAG values, which are summed instead of averaged). If NODE = P, graphical picking is enabled (valid only in the GUI).

Item

Label identifying the item. General item labels are shown in Table 111: ESOL - General Result Item and Component Labels. Some items also require a component label. For selected result output, specify SRES and see Table 112: ESOL - Selected Result (SRES) Component Labels.

Comp

Component of the item (if required). General component labels are shown in Table 111: ESOL - General Result Item and Component Labels below. If Comp is a sequence number (n), the NODE field is ignored.

Name

32-character name for identifying the item on the printout and displays. Defaults to a label formed by concatenating the first four characters of the Item and Comp labels.

Notes

See Table 111: ESOL - General Result Item and Component Labels for a list of item and component labels for element (excluding line element) results. See Table 112: ESOL - Selected Result (SRES) Component Labels for a list of valid selected result (Item = SRES) components.

ESOL defines element results data to be stored from a results file (FILE). Not all items are valid for all elements. To see the available items for a given element, refer to the input and output summary tables in the documentation for that element.

Two methods of data access are available via the ESOL command. You can access some data by using a generic label (component name method), while others require a label and number (sequence number method).

Use the component name method to access general element data (that is, element data generally available to most element types or groups of element types). Element results are in the element coordinate system, except for layered elements where results are in the layer coordinate system. Element forces and moments are in the nodal coordinate system. Results are obtainable for an element at a specified node. Further location specifications can be made for some elements via SHELL, LAYERP26, and FORCE.

The sequence number method is required for data that is not averaged (such as pressures at nodes and temperatures at integration points), or data that is not easily described generically (such as all derived data for structural line elements and contact elements, all derived data for thermal line elements, and layer data for layered elements).

In a 2D to 3D analysis, this command not supported in the POST26 postprocessor and is ignored.

Table 111: ESOL - General Result Item and Component Labels

Component Name Method
ItemCompDescription
SX, Y, Z, XY, YZ, XZComponent stress.
1, 2, 3Principal stress.
INTStress intensity.
EQVEquivalent stress.
EPELX, Y, Z, XY, YZ, XZComponent elastic strain.
1, 2, 3Principal elastic strain.
INTElastic strain intensity.
EQVElastic equivalent strain.
EPTHX, Y, Z, XY, YZ, XZComponent thermal strain.
1, 2, 3Principal thermal strain.
INTThermal strain intensity.
EQVThermal equivalent strain.
EPPLX, Y, Z, XY, YZ, XZComponent plastic strain.
1, 2, 3Principal plastic strain.
INTPlastic strain intensity.
EQVPlastic equivalent strain.
EPCRX, Y, Z, XY, YZ, XZComponent creep strain.
1,2,3Principal creep strain.
INTCreep strain intensity.
EQVCreep equivalent strain.
EPDIX, Y, Z, XY, YZ, XZComponent diffusion strain.
1, 2, 3Principal diffusion strain.
INTDiffusion strain intensity.
EQVDiffusion equivalent strain.
NLSEPLEquivalent stress (from stress-strain curve).
SRATStress state ratio.
HPRESHydrostatic pressure.
EPEQAccumulated equivalent plastic strain.
CREQAccumulated equivalent creep strain.
PSVPlastic state variable.
PLWKPlastic work/volume.
SENDELASTIC[a]Elastic strain energy density. (For viscoelastic and sintering materials, the stored energy.)
PLASTICPlastic strain energy density.
CREEPCreep strain energy density.
DAMAGEDamage strain energy density.
VDAM[a]Viscoelastic dissipation energy density.
VREGVisco-regularization strain energy density.
DISSStructural-thermal dissipation.
ENTOTotal strain energy density (sum of ELASTIC, PLASTIC, and CREEP strain energy densities).
CDMDMGDamage variable.
LMMaximum previous strain energy for virgin material.
GKSXGasket component stress (also gasket pressure).
GKDXGasket component total closure.
GKDIXGasket component total inelastic closure.
GKTHXGasket component thermal closure.
SSX, XY, XZInterface traction (stress).
SDX,XY,XZInterface separation.
CONTSTAT[b]Contact status.
PENEContact penetration.
PRESContact pressure.
SFRICContact friction stress.
STOTContact total stress (pressure plus friction).
SLIDEContact sliding distance.
GAPContact gap distance.
FLUXTotal heat flux at contact surface.
CNOSTotal number of contact status changes during substep.
FPRSFluid penetration pressure.
TG[c]X, Y, Z, SUMComponent thermal gradient or vector sum.
TF[c]X, Y, Z, SUMComponent thermal flux or vector sum.
PGX, Y, Z, SUMComponent pressure gradient or vector sum.
EFX, Y, Z, SUMComponent electric field or vector sum.
DX, Y, Z, SUMComponent electric flux density or vector sum.
HX, Y, Z, SUMComponent magnetic field intensity or vector sum.
BX, Y, Z, SUMComponent magnetic flux density or vector sum.
CGX, Y, Z, SUMComponent concentration gradient or vector sum.
DFX, Y, Z, SUMComponent diffusion flux density or vector sum.
FMAGX, Y, Z, SUMComponent electromagnetic forces or vector sum.
PX, Y, Z, SUMPoynting vector components or vector sum
FX, Y, ZComponent structural force.
MX, Y, ZComponent structural moment.
HEAT[c] Heat flow.
FLOW Fluid flow.
AMPS Current flow.
FLUX Magnetic flux.
CSGX, Y, ZComponent magnetic current segment.
RATE Diffusion flow rate.
SENE "Stiffness" energy.
STEN Elemental energy dissipation due to stabilization.
KENE Kinetic energy.
ASENE Amplitude stiffness energy.
PSENE Peak stiffness energy.
AKENE Amplitude kinetic energy.
PKENE Peak kinetic energy.
DENE Damping energy.
WEXT[d] Work due to external load.
AENE Artificial energy due to hourglass control/drill stiffness or due to contact stabilization.
JHEAT Element Joule heat generation.
JCX, Y, Z, SUMConduction current density for elements that support conduction current calculation. Components (X, Y, Z) and vector sum (SUM).
JSX, Y, ZSource current density for low-frequency magnetic analyses. Total current density (sum of conduction and displacement current densities) in low-frequency electric analyses. Components (X, Y, Z).
JTX, Y, Z, SUMTotal measurable current density in low-frequency electromagnetic analyses. (Conduction current density in a low-frequency electric analysis.) Components (X, Y, Z) and vector sum (SUM).
MRE Magnetics Reynolds number.
VOLU Volume of volume element.
BFETEMPBody temperatures (calculated from applied temperatures) as used in solution (area and volume elements only).
FICTTEMPFictive temperature.
CAPC0,X0,K0,ZONE, DPLS,VPLSMaterial cap plasticity model only: Cohesion; hydrostatic compaction yielding stress; I1 at the transition point at which the shear and compaction envelopes intersect; zone = 0: elastic state, zone = 1: compaction zone, zone = 2: shear zone, zone = 3: expansion zone; effective deviatoric plastic strain; volume plastic strain.
EDPCCSIG,CSTRMaterial EDP creep model only (not including the cap model): Equivalent creep stress; equivalent creep strain.
FFLXX, Y, ZFluid flux flow in poromechanics.
FGRAX, Y, ZFluid pore pressure gradient in poromechanics.
PMSVVRAT, PPRE, DSAT, RPERVoid volume ratio, pore pressure, degree of saturation, and relative permeability for coupled pore-pressure-thermal elements.
YSIDXTENS,SHEAYield surface activity status for Mohr-Coulomb, soil, concrete, and joint rock material models: 1 = yielded, 0 = not yielded.
FPIDXTF01,SF01, TF02,SF02, TF03,SF03, TF04,SF04Failure plane surface activity status for concrete and joint rock material models: 1 = yielded, 0 = not yielded. Tension and shear failure status are available for all four sets of failure planes.
NSX, Y, Z, XY, YZ, XZNominal strain for hyperelastic material, reported in the current configuration (unaffected by RSYS).
MPLADMAC, DMAXMicroplane damage, macroscopic and maximum values.
MPDPTOTA, TENS, COMP, RWMicroplane homogenized total, tension, and compression damages (TOTA, TENS, COMP), and split weight factor (RW).
DAMAGE1,2,3,MAXDamage in directions 1, 2, 3 (1, 2, 3) and the maximum damage (MAX).
GDMG Damage
IDIS Structural-thermal dissipation rate
BKSX, Y, Z, XY, YZ, XZTotal nonlinear kinematic backstress reported in the current configuration (unaffected by RSYS). Available for 3D, plane strain, and axisymmetric elements.
BKS1, . . . ,BKS5X, Y, Z, XY, YZ, XZSuperimposed components of the total nonlinear kinematic backstress reported in the current configuration (unaffected by RSYS). Available for 3D, plane strain, and axisymmetric elements when more than one superimposed back-stress component is defined.
EPFR Free strain in porous media
FC1S1,2,3,4,5,6First set of six components of FCC crystal slip. Available for 3D elements only.
FC2S1,2,3,4,5,6Second set of six components of FCC crystal slip. Available for 3D elements only.
HC1S1,2,3,4,5,6Six components of HCP crystal slip on basal and prismatic systems. Available for 3D elements only.
HC2S1,2,3,4,5,6Six components of HCP crystal slip on pyramidal system. Available for 3D elements only.
HC3S1,2,3,4,5,6First set of six components of HCP crystal slip on the first-order pyramidal system. Available for 3D elements only.
HC4S1,2,3,4,5,6Second set of six components of HCP crystal slip on the first-order pyramidal system. Available for 3D elements only.
HC5S1,2,3,4,5,6Six components of HCP crystal slip on the second-order pyramidal system. Available for 3D elements only.
BC1S1,2,3,4,5,6First set of six components of BCC slip on 111 plane. Available for 3D elements only.
BC2S1,2,3,4,5,6Second set of six components of BCC slip on 111 plane. Available for 3D elements only.
BC3S1,2,3,4,5,6First set of six components of BCC slip on 112 plane. Available for 3D elements only.
BC4S1,2,3,4,5,6Second set of six components of BCC slip on 112 plane. Available for 3D elements only.
BC5S1,2,3,4,5,6First set of six components of BCC slip on 123 plane. Available for 3D elements only.
BC6S1,2,3,4,5,6Second set of six components of BCC slip on 123 plane. Available for 3D elements only.
BC7S1,2,3,4,5,6Third set of six components of BCC slip on 123 plane. Available for 3D elements only.
BC8S1,2,3,4,5,6Fourth set of six components of BCC slip on 123 plane. Available for 3D elements only.
FC1H1,2,3,4,5,6First set of six components of FCC crystal hardness. Available for 3D elements only.
FC2H1,2,3,4,5,6Second set of six components of FCC crystal hardness. Available for 3D elements only.
HC1H1,2,3,4,5,6Sixcomponents of HCP crystal hardness on basal and prismatic systems. Available for 3D elements.
HC2H1,2,3,4,5,6Six components of HCP crystal hardness on pyramidal system. Available for 3D elements only.
HC3H1,2,3,4,5,6First set of six components of HCP crystal hardness on the first-order pyramidal system. Available for 3D elements only.
HC4H1,2,3,4,5,6Second set of six components of HCP crystal hardness on the first-order pyramidal system. Available for 3D elements only.
HC5H1,2,3,4,5,6Six components of HCP crystal hardness on the second-order pyramidal system. Available for 3D elements only.
BC1H1,2,3,4,5,6First set of six components of BCC hardness on 111 plane. Available for 3D elements only.
BC2H1,2,3,4,5,6Second set of six components of BCC hardness on 111 plane. Available for 3D elements only.
BC3H1,2,3,4,5,6First set of six components of BCC hardness on 112 plane. Available for 3D elements only.
BC4H1,2,3,4,5,6Second set of six components of BCC hardness on 112 plane. Available for 3D elements only.
BC5H1,2,3,4,5,6First set of six components of BCC hardness on 123 plane. Available for 3D elements only.
BC6H1,2,3,4,5,6Second set of six components of BCC hardness on 123 plane. Available for 3D elements only.
BC7H1,2,3,4,5,6Third set of six components of BCC hardness on 123 plane. Available for 3D elements only.
BC8H1,2,3,4,5,6Fourth set of six components of BCC hardness on 123 plane. Available for 3D elements only.
XELG1,2,3,45,6,EQVCrystal Lagrangian strain in 11, 22, 33, 12, 23,13 directions and its equivalent. Available for 3D elements only.
SINTRHO, ETA, SSTR, GRAINSintering relative density, viscosity, sintering stress, and average grain size values.
Sequence Number Method
ItemCompDescription
SMISCsnumSummable items.
NMISCsnumNonsummable items.
LSsnumLine element elastic stresses.
LEPELsnumLine element strains.
LEPTHsnumLine element thermal strains.
LEPPLsnumLine element plastic strains.
LEPCRsnumLine element creep strains.
LBFEsnumLine element temperatures.

[a] The results for this postprocessing SEND component are invalid for ELBOW290 if that element is used with viscoelastic or viscohyperelastic materials.

[b] For more information about the meaning of contact status and its possible values, see Reviewing Results in POST1 in the Contact Technology Guide.

[c] For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use the labels HBOT, HE2, HE3, . . ., HTOP instead of HEAT.

[d] WEXT is calculated for element-based loading only (and not for nodal-force loading). WEXT is stored on elements to which loading has been applied; if surface elements are added on top of other elements, for example, and pressure loading is applied to the surface elements, WEXT is available for the surface elements only.


Table 112: ESOL - Selected Result (SRES) Component Labels

ESOL,NVAR,ELEM,NODE,SRES,Comp
CompDescription
SVARnThe nth state variable.
FLDUF0nThe nth user-defined field variable.
ItemComp (concatenated Item + Comp label) from Table 210: OSRESULT - Item and Component Labels[a]See the table for the combined item and component description.

Menu Paths

Main Menu>TimeHist Postpro>Define Variables
Main Menu>TimeHist Postpro>Elec&Mag>Circuit>Define Variables