ANSOL

ANSOL, NVAR, NODE, Item, Comp, Name, Mat, Real, Ename, DataKey
Specifies averaged element nodal data to be stored from the results file.

POST26: Set Up

NVAR

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

NODE

Node number for which data are to be stored.

Item

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

Comp

Component of the item (if required). General component labels are shown in Table 101: ANSOL - General Result Item and Component Labels. Selected result components (Item = SRES) are shown in Table 102: ANSOL - Selected Result (SRES) Component Labels.

Name

32-character name to identify the item on the printout and displays. Default: An eight-character label formed by concatenating the first four characters of the Item and Comp labels.

Mat

Material number. Average is calculated based on the subset of elements with the specified material number. Default: Use all elements in the active set unless Real and/or Ename is specified.

Real

Real number. Average is calculated based on the subset of elements with the specified real number. Default: Use all elements in the active set unless Mat and/or Ename is specified.

Ename

Element type name. Average is calculated based on the subset of elements with the specified element type name. Default: Use all elements in the active set unless Mat and/or Real is specified.

DataKey

Key to specify which data is stored:

AUTO	—	Nodal-averaged results are used if they are available for the first applicable time step; 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.

Mat, Real, and Ename are ignored when nodal-averaged results are used.

Notes

Valid item and component labels for element nodal results are listed in Table 101: ANSOL - General Result Item and Component Labels.

ANSOL defines element nodal results data to be stored from a results file (FILE). Not all items are valid for all nodes. See the input and output summary tables of each element attached to the node for the available items.

If nodal-averaged results (OUTRES,NAR or another nodal-averaged label) are available, then ANSOL uses the nodal-averaged data for the applicable items (S, EPEL, EPPL, EPCR, EPTH) as dictated by the by DataKey argument. By default, (DataKey = AUTO), the availability of nodal-averaged results or element-based data is determined at the first load step that has results for the associated item. For more information, see Postprocessing Nodal-Averaged Results in the Element Reference.

Coordinate systems: Generally, element nodal quantities stored by ANSOL are obtained in the solution coordinate system (RSYS, SOLU) and then averaged. There are some exceptions as listed below. ANSOL does not transform results from RSYS,SOLU (or from the coordinate systems described for the exceptions below) to other coordinate systems. Verify that all elements attached to the subject node have the same coordinate system before using ANSOL.

Layered element results are in the layer coordinate system (RSYS,LSYS). You can further specify the element nodal results, for some elements, with the SHELL, LAYERP26, and FORCE commands.
When ANSOL is used to store nodal-averaged result data (based on the DataType setting), the global Cartesian coordinate system (RSYS,0) is used.

Shell elements: The default shell element coordinate system is based on node ordering. For shell elements the adjacent elements could have a different RSYS,SOLU, making the resultant averaged data inconsistent. A message to this effect is issued when ANSOL is used in models containing shell elements. Ensure that consistent coordinate systems are active for all associated elements used by the ANSOL command.

Derived quantities: Some of the result items supported by ANSOL (Table 101: ANSOL - General Result Item and Component Labels) are derived from the component quantities. Issue AVPRIN to specify the principal and vector sum quantity averaging methods.

Default: If Mat, Real, and Ename are not specified, all elements attached to the node are considered. When a material ID, real constant ID, or element-type discontinuity is detected at a node, a message is issued. For example, in a FSI analysis, a FLUID30 element at the structure interface would be considered; however, because it contains no SX result, it is not used during STORE operations.

Table 101: ANSOL - General Result Item and Component Labels

General Item and Component Labels ANSOL, `NVAR,NODE,Item,Comp,Name,Mat,Real,Ename,DataType`
Item	Comp	Description
S	X, Y, Z, XY, YZ, XZ	Component stress.^[a]
	1, 2, 3	Principal stress.^[a]
	INT	Stress intensity.^[a]
	EQV	Equivalent stress.^[a]
EPEL	X, Y, Z, XY, YZ, XZ	Component elastic strain.^[a]
	1, 2, 3	Principal elastic strain.^[a]
	INT	Elastic strain intensity.^[a]
	EQV	Elastic equivalent strain.^[a]
EPPL	X, Y, Z, XY, YZ, XZ	Component plastic strain.^[a]
	1, 2, 3	Principal plastic strain.^[a]
	INT	Plastic strain intensity.^[a]
	EQV	Plastic equivalent strain.^[a]
EPCR	X, Y, Z, XY, YZ, XZ	Component creep strain.^[a]
	1,2,3	Principal creep strain.^[a]
	INT	Creep strain intensity.^[a]
	EQV	Creep equivalent strain.^[a]
EPTH	X, Y, Z, XY, YZ, XZ	Component thermal strain.^[a]
	1, 2, 3	Principal thermal strain.^[a]
	INT	Thermal strain intensity.^[a]
	EQV	Thermal equivalent strain.^[a]
ESIG	X, Y, Z, XY, YZ, XZ	Components of Biot’s effective stress.
	1, 2, 3	Principal stresses of Biot's effective stress.
	INT	Stress intensity of Biot's effective stress.
	EQV	Equivalent stress of Biot's effective stress.
NL	SEPL	Equivalent stress (from stress-strain curve).
	SRAT	Stress state ratio.
	HPRES	Hydrostatic pressure.
	EPEQ	Accumulated equivalent plastic strain.
	CREQ	Accumulated equivalent creep strain.
	PSV	Plastic state variable.
	PLWK	Plastic work/volume.
CONT	STAT^[b]	Contact status.
	PENE	Contact penetration.
	PRES	Contact pressure.
	SFRIC	Contact friction stress.
	STOT	Contact total stress (pressure plus friction).
	SLIDE	Contact sliding distance.
	GAP	Contact gap distance.
	FLUX	Total heat flux at contact surface.
	CNOS	Total number of contact status changes during substep.
	FPRS	Fluid penetration pressure.
TG	X, Y, Z, SUM^[c]	Component thermal gradient or vector sum.
TF	X, Y, Z, SUM^[c]	Component thermal flux or vector sum.
PG	X, Y, Z, SUM	Component pressure gradient or vector sum.
EF	X, Y, Z, SUM	Component electric field or vector sum.
D	X, Y, Z, SUM	Component electric flux density or vector sum.
H	X, Y, Z, SUM	Component magnetic field intensity or vector sum.
B	X, Y, Z, SUM	Component magnetic flux density or vector sum.
CG	X, Y, Z, SUM	Component concentration gradient or vector sum.
DF	X, Y, Z, SUM	Component diffusion flux density or vector sum.
JC	X, Y, Z, SUM	Conduction current density for elements that support conduction current calculation. Components (X, Y, Z) and vector sum (SUM).
FFLX	X, Y, Z	Fluid-flow flux in poromechanics.
FGRA	X, Y, Z	Fluid pore-pressure gradient in poromechanics.
PMSV	VRAT, PPRE, DSAT, RPER	Void volume ratio, pore pressure, degree of saturation, and relative permeability for coupled pore-pressure-thermal elements.
NS	X, Y, Z, XY, YZ, XZ	Nominal strain for hyperelastic material, reported in the current configuration (unaffected by RSYS).
MPLA	DMAC, DMAX	Microplane damage, macroscopic and maximum values.
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
DAMAGE	1,2,3,MAX	Damage in directions 1, 2, 3 (1, 2, 3) and the maximum damage (MAX).
GDMG		Damage
IDIS		Structural-thermal dissipation rate

^[a]This item stores nodal-averaged results if they are available on the results file.

^[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]Comp = SUM is not supported for coupled pore-pressure-thermal (CPTnnn) elements.

Table 102: ANSOL - Selected Result (SRES) Component Labels

ANSOL,`NVAR`,`NODE`,SRES,`Comp`,`Name`,`Mat`,`Real`,`Ename`
Comp	Description
SVAR`n`	The `n`th state variable.
FLDUF0`n`	The `n`th 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.

^[a]See Example 10: Specifying and Retrieving Selected Result Output.

Menu Paths

Main Menu>TimeHist Postpro>Variable Viewer