PLNSOL

PLNSOL, Item, Comp, KUND, Fact, FileID, Avg, DataKey
Displays solution results as continuous element contours.

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

Item

Label identifying the item. Valid item labels are shown in the table below. Some items also require a component label. For selected result output, specify SRES and see Table 217: PLNSOL - Selected Result (SRES) Component Labels.

Comp

Component of the item (if required). Valid component labels are shown in the table below.

KUND

Undisplaced shape key:

0

 — 

Do not overlay undeformed structure display.

1

 — 

Overlay displaced contour plot with undeformed display (appearance is system-dependent).

2

 — 

Overlay displaced contour plot with undeformed edge display (appearance is system-dependent).

Fact

Scale factor for 2D display for contact items. Default value is 1. A negative scaling factor inverts the display.

FileID

The file index number (obtained via NLDIAG,NRRE,ON). Valid only for Item = NRRE.

Avg

Specifies whether random acoustic results are averaged. Valid only for Item = U and PRES.

(blank)

 — 

No averaging (default).

AVG

 — 

Display averaged results for random acoustics.

DataKey

Key to specify which data is plotted:

AUTO

 — 

Nodal-averaged results are used, if available; otherwise, the element-based data is used, if available. (Default.)

ESOL

 — 

Only element-based results are used. If they are not available, the command is ignored.

NAR

 — 

Only nodal-averaged results are used. If they are not available, the command is ignored.

Notes

PLNSOL displays the solution results as continuous contours across element boundaries for the selected nodes and elements.

For example, PLNSOL,S,X displays the X component of stress S (that is, the SX stress component). Various element results depend upon the recalculation method and the selected results location (AVPRIN, RSYS, LAYER, SHELL, and NSEL).

Contours are determined by linear interpolation within each element from the nodal values, averaged at a node whenever two or more elements connect to the same node. (The exception is FMAG, which is summed at the node.)

For reinforcing elements (REINFnnn), contours are determined by interpolation within each reinforcing member of reinforcing elements from the results of the base elements. Element results of members within the same reinforcing element are smoothed based on the order of its base element. PLNSOL displays constant results for a reinforcing element if the base elements are low-order, and linear results when the base elements are high-order.

For PowerGraphics displays (/GRAPHICS,POWER), results are plotted for the model exterior surface only. Items not supported by PowerGraphics are noted in Table 216: PLNSOL - Valid Item and Component Labels.

To plot midside nodes, first issue /EFACET,2.

If nodal-averaged results (OUTRES,NAR or another nodal-averaged label) are in the database, then PLNSOL uses the nodal-averaged data for the applicable items (S, EPEL, EPPL, EPCR, EPTH, EPSW) by default. You can change this behavior via the DataKey argument. Keep these points in mind when using nodal-averaged results:

  • The LAYER and RSYS,SOLU commands are not valid with nodal-averaged results. If these commands are used, the element solution is plotted instead if applicable.

  • Issuing ESEL before plotting nodal-averaged results has no effect on the output.

  • PowerGraphics is supported. The output is equivalent to the full model graphics output, but only the appropriate surface nodes are plotted. See Postprocessing Nodal-Averaged Results in the Element Reference.)

For Item = SRES, selected result (OSRESULT) values are output. See Table 217: PLNSOL - Selected Result (SRES) Component Labels.

Table 216: PLNSOL - Valid Item and Component Labels

General Item and Component Labels PLNSOL, Item, Comp
ItemCompDescription
Valid item and component labels for nodal degree of freedom results are:
UX, Y, Z, SUMX, Y, or Z structural displacement or vector sum.
ROTX, Y, Z, SUMX, Y, or Z structural rotation or vector sum.
TEMP[a][b] Temperature.
PRES Pressure.
GFV1, GFV2, GFV3 Nonlocal field values 1, 2, and 3.
VOLT Electric potential.
MAG Magnetic scalar potential.
CONC Concentration. [c]
VX, Y, Z, SUMX, Y, or Z fluid velocity or vector sum in a fluid analysis.
AX, Y, Z, SUMX, Y, or Z magnetic vector potential or vector sum in an electromagnetic analysis.
VELX, Y, Z, SUMX, Y, or Z velocity or vector sum in a structural transient dynamic analysis (ANTYPE,TRANS). 
ACCX, Y, Z, SUMX, Y, or Z acceleration or vector sum in a structural transient dynamic analysis (ANTYPE,TRANS).
OMGX, Y, Z, SUMX, Y, or Z rotational velocity or vector sum in a structural transient dynamic analysis (ANTYPE,TRANS). 
DMGX, Y, Z, SUMX, Y, or Z rotational acceleration or vector sum in a structural transient dynamic analysis (ANTYPE,TRANS).
WARP Warping.
NRREFX, FY, FZ, FNRM, MX, MY, MZ, MNRM Plot the Newton-Raphson residuals from the file you obtained via the NLDIAG,NRRE,ON command. The FNRM and MNRM labels are computed as the square root of the sum of the squares of the residual component forces or moments (FX,FY,FZ, MX, MY, MZ).[d]
 When KUND = 0, use the absolute value of the residual from the files (default).
SPL Sound pressure level.
SPLA A-weighted sound pressure level (dBA).
VNS Normal velocity on the structural surface.[e]
ENKE Acoustic diffusion energy density
Valid item and component labels for element results are:
SX, Y, Z, XY, YZ, XZComponent stress.[f]
1, 2, 3Principal stress.[f]
INTStress intensity.[f]
EQVEquivalent stress.[f]
EPELX, Y, Z, XY, YZ, XZComponent elastic strain.[f]
1, 2, 3Principal elastic strain.[f]
INTElastic strain intensity.[f]
EQVElastic equivalent strain.[f]
EPTHX, Y, Z, XY, YZ, XZComponent thermal strain.[f]
1, 2, 3Principal thermal strain.[f]
INTThermal strain intensity.[f]
EQVThermal equivalent strain.[f]
EPDIX, Y, Z, XY, YZ, XZComponent diffusion strain.[c]
1, 2, 3Principal diffusion strain.
INTDiffusion strain intensity.
EQVDiffusion equivalent strain.
EPPLX, Y, Z, XY, YZ, XZComponent plastic strain.[f]
1, 2, 3Principal plastic strain.[f]
INTPlastic strain intensity.[f]
EQVPlastic equivalent strain.[f]
EPCRX, Y, Z, XY, YZ, XZComponent creep strain.[f]
1, 2, 3Principal creep strain.[f]
INTCreep strain intensity.[f]
EQVCreep equivalent strain.[f]
EPSW Swelling strain.[f]
EPTOX, Y, Z, XY, YZ, XZComponent total mechanical strain (EPEL + EPPL + EPCR).
1, 2, 3Principal total mechanical strain.
INTTotal mechanical strain intensity.
EQVTotal mechanical equivalent strain.
EPTTX, Y, Z, XY, YZ, XZComponent total mechanical, thermal, diffusion, and swelling strain (EPEL + EPPL + EPCR + EPTH + EPDI + EPSW).
1, 2, 3Principal total, mechanical, thermal, diffusion, and swelling strain.
INTTotal mechanical, thermal, diffusion, and swelling strain intensity.
EQVTotal mechanical, thermal, diffusion, and swelling equivalent strain.
ESIGX,Y,Z,XY,YZ,ZXComponents of Biot’s effective stress.
1, 2, 3Principal stresses of Biot’s effective stress.
INTStress intensity of Biot’s effective stress.
EQVEquivalent stress of Biot’s effective stress.
DPARTPORTotal porosity (Gurson material model).
GPORPorosity due to void growth.
NPORPorosity due to void nucleation.
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[g]Elastic strain energy density. (For viscoelastic and sintering materials, the stored energy.)
PLASTIC Plastic strain energy density.
CREEPCreep strain energy density.
DAMAGEDamage strain energy density.
VDAM[g]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.
FAILMAXMaximum of all active failure criteria defined at the current location. (See FCTYP.)[c][h]
EMAXMaximum Strain Failure Criterion.[c][h]
SMAXMaximum Stress Failure Criterion.[c][h]
TWSITsai-Wu Strength Index Failure Criterion.[c][h]
TWSRInverse of Tsai-Wu Strength Ratio Index Failure Criterion.[c][h]
HFIBHashin Fiber Failure Criterion.[c][h][i]
HMATHashin Matrix Failure Criterion.[c][h][i]
PFIBPuck Fiber Failure Criterion.[c][h][i]
PMATPuck Matrix Failure Criterion.[c][h][i]
L3FBLaRc03 Fiber Failure Criterion.[c][h][i]
L3MTLaRc03 Matrix Failure Criterion.[c][h][i]
L4FBLaRc04 Fiber Failure Criterion.[c][h][i]
L4MTLaRc04 Matrix Failure Criterion.[c][h][i]
USR1, USR2, ..., USR9User-defined failure criteria.[c][h][i][j]
PFCMAX[k]Maximum of all failure criteria defined at current location.
FT[k]Fiber tensile failure criteria.
FC[k]Fiber compressive failure criteria.
MT[k]Matrix tensile failure criteria.
MC[k]Matrix compressive failure criteria.
PDMGSTATDamage status (0 = undamaged, 1 = damaged, 2 = completely damaged).
FTFiber tensile damage variable.
FCFiber compressive damage variable.
MTMatrix tensile damage variable.
MCMatrix compressive damage variable.
SShear damage variable (S).
SEDEnergy dissipated per unit volume.
SEDVEnergy per unit volume due to viscous damping.
SVAR1, 2, 3, ... NState variable.[c]
GKSX, XY, XZGasket component stress.
GKDX, XY, XZGasket component total closure.
GKDIX, XY, XZGasket component total inelastic closure.
GKTHX, XY, XZGasket component thermal closure.
SSX, XY, XZInterface traction (stress).
SDX, XY, XZInterface separation.
FICTTEMPFictive temperature.
CONT[l][m]STATContact status[n]:
3 = closed and sticking
2 = closed and sliding
1 = open but near contact
0 = open and not near contact
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[o]X, Y, Z, SUMComponent thermal gradient or vector sum.
TF[o]X, Y, Z, SUMComponent thermal flux or vector sum.
PGX, Y, Z, SUMComponent or vector sum of velocity or energy density flux (room acoustics).
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.[c]
DFX, Y, Z, SUMComponent diffusion flux density or vector sum.[c]
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 flow flux in poromechanics.
FGRAX,Y,ZFluid pore-pressure gradient in poromechanics.
FMAGX, Y, Z, SUMComponent electromagnetic force or vector sum.[c]
JCX, Y, Z, SUMConduction current density for elements that support conduction current calculation. Components (X, Y, Z) and vector sum (SUM).[c]
BFETEMPBody temperatures (calculated from applied temperatures) as used in solution (area and volume elements only).
PMSVVRAT, PPRE, DSAT, RPERVoid volume ratio, pore pressure, degree of saturation, and relative permeability for coupled pore-pressure-thermal elements.
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
SNDIX, Y, Z, SUMComponent sound intensity or vector sum.[c]
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.

[a] For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use the labels TBOT, TE2, TE3, . . ., TTOP instead of TEMP to view the individual temperature degree of freedom. When other thermal elements are included in the model, deselect them to avoid plotting undefined information. To view all temperatures in the same plot, set /ESHAPE,1 and /GRAPHICS,POWER and issue PLNSOL,TEMP.

[b] For SHELL294 elements, use the labels TBOT and TTOP in addition to TEMP.

[c] Not supported by PowerGraphics.

[d] When plotting Newton-Raphson residual items (Item = NRRE) from a file on the deformed geometry, the displacements are based on the current set of results in the database. These displacements may not correspond to the loadstep and substep in the .nrxxxxx file. (For more information about .nrxxxxx files and nonlinear diagnostics postprocessing, see the description of the NLDPOST command and Performing Nonlinear Diagnostics.)

[e] Valid only for SHELL181, SOLID185, SOLID186, SOLID187, SOLSH190, and SHELL281.

[f] This item plots the solution using nodal-averaged results if they are available on the results file.

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

[h] Works only if failure criteria are provided (FC and TB).

[i] Must first be added (FCTYP).

[j] USR1 through USR9 require a failure-criteria routine.

[k] Failure criteria are based on the effective stresses in the damaged material.

[l] For contact results, PowerGraphics is supported for 3D models only.

[m] For the CONT items for elements CONTA172, CONTA174, CONTA175, and CONTA177, the reported data is averaged across the element. To obtain a more meaningful STAT value, use PLESOL.

[n] For MPC-based contact definitions, the value of STAT can be negative, indicating that one or more contact constraints were intentionally removed to prevent overconstraint. STAT = -3 is used for MPC bonded contact; STAT = -2 is used for MPC no-separation contact.

[o] Comp = SUM is not supported for coupled pore-pressure-thermal (CPTnnn) elements.


Table 217: PLNSOL - Selected Result (SRES) Component Labels

PLNSOL,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>General Postproc>Plot Results>Contour Plot>Nodal Solu
Utility Menu>Plot>Results>Contour Plot>Nodal Solution
Utility Menu>PlotCtrls>Animate>Animate Over Results
Utility Menu>PlotCtrls>Animate>Animate Over Time
Utility Menu>PlotCtrls>Animate>Deformed Results
Utility Menu>PlotCtrls>Animate>Dynamic Results
Utility Menu>PlotCtrls>Animate>Isosurfaces
Utility Menu>PlotCtrls>Animate>Mode Shape
Utility Menu>PlotCtrls>Animate>Q-Slice Contours
Utility Menu>PlotCtrls>Animate>Time-harmonic