ETABLE ETABLE, Lab, Item, CompFills a table of element values for further processing. POST1: Element Table MP ME ST PR PRN <> <> FL EM EH DY PP <> EME MFS Lab

Any unique user defined label for use in subsequent commands and output headings (maximum of eight characters and not a General predefined Item label). Defaults to an eight character label formed by concatenating the first four characters of the Item and Comp labels. If the same as a previous user label, this result item will be included under the same label. Up to 200 different labels may be defined. The following labels are predefined and are not available for user-defined labels: REFL, STAT, and ERAS. Lab = REFL refills all tables previously defined with the ETABLE commands (not the CALC module commands) according to the latest ETABLE specifications and is convenient for refilling tables after the load step [SET] has been changed. Remaining fields will be ignored if Lab is REFL. Lab = STAT displays stored table values. Lab = ERAS erases the entire table.

Item

Label identifying the item. General item labels are shown in the table below. Some items also require a component label. Character parameters may be used. Item = ERAS erases a Lab column.

Comp

Component of the item (if required). General component labels are shown in the table below. Character parameters may be used.

Notes

Defines a table of values per element (the element table) for use in further processing (see POST1 Element Table commands). The element table is organized as a "worksheet," with the rows representing all selected elements, and the columns consisting of result items which have been moved into the table (Item,Comp) with ETABLE. Each column of data is identified by a user-defined label (Lab) for listings and displays.

After entering the data into the element table, you are not limited to merely listing or displaying your data [PLESOL, PRESOL, etc.]. You may also perform many types of operations on your data, such as adding or multiplying columns [SADD, SMULT], defining allowable stresses for safety calculations [SALLOW], or multiplying one column by another [SMULT]. See the Getting Started with ANSYS in theBasic Analysis Guide for further details.

There are different types of results data that may be stored in the element table. For example, many items for an element are inherently single-valued (i.e., there is only one value per element). The single-valued items include: SERR, SDSG, TERR, TDSG, SENE, SEDN, TENE, KENE, JHEAT, JS, VOLU, and CENT. All other items are multivalued (i.e., they vary over the element, such that there is a different value at each node). Since only one value is stored in the element table per element, an average value (based on the number of contributing nodes) is calculated for multivalued items. Exceptions to this averaging procedure are FMAG and all element force items, which represent the sum only of the contributing nodal values.

There are two methods of data access that may be used with the ETABLE command. The method you choose will depend upon the type of data that you wish to store. Some results can be accessed just with the use of a generic label (Component Name method), while others require a label and number (Sequence Number method).

The Component Name method is used to access the General element data (that is, element data which is generally available to most element types or groups of element types). All of the single-valued items and some of the more general multivalued items are

accessible with the Component Name method. Various element results depend on the calculation method and the selected results location (AVPRIN, RSYS, LAYER, SHELL, and ESEL).

Although nodal data is readily available for listings and displays [PRNSOL, PLNSOL] without using the element table, you may also use the Component Name method to enter these results into the element table for further "worksheet" manipulation (see the Getting Started with ANSYS in theBasic Analysis Guide for more details). A listing of the General Item and Comp labels for the Component Name method is shown below.

The Sequence Number method allows you to view results for data that is not averaged (such as pressures at nodes, temperatures at integration points, etc.), or data that is not easily described in a generic fashion (such as all derived data for structural line elements and contact elements, all derived data for thermal line elements, layer data for layered elements, etc.). A table illustrating the Items (such as LS, LEPEL, LEPTH, SMISC, NMISC, SURF, etc.) and corresponding sequence numbers for each element is shown in the Output Data section of each element description found in the Element Reference.

Some element table data are reported in the results coordinate system. These include all component results (for example, UX, UY, etc.; SX, SY, etc.). The solution writes component results in the database and on the results file in the solution coordinate system. When you issue the ETABLE command, these results are then transformed into the results coordinate system [RSYS] before being stored in the element table. The default results coordinate system is global Cartesian [RSYS,0]. All other data are retrieved from the database and stored in the element table with no coordinate transformation.

Use the PRETAB, PLETAB, or ETABLE,STAT commands to display the stored table values. Issue ETABLE,ERAS to erase the entire table. Issue ETABLE,Lab,ERAS to erase a Lab column.

When the GUI is on, if a Delete operation in a Define Element Table Data dialog box writes this command to a log file

(Jobname.LOG or Jobname.LGW), you will observe that Lab is blank, Item = ERASE, and Comp is an integer number. In this case, the GUI has assigned a value of Comp that corresponds to the location of a chosen variable name in the dialog box's list. It is not intended that you type in such a location value for Comp in an ANSYS session. However, a file that contains a GUI-generated ETABLE command of this form can be used for batch input or for use with the /INPUT command.

Table: ETABLE - General Item and Component Labels

General Item and Component Labels ETABLE, Lab, Item, Comp

Item Comp DescriptionValid Item Labels for Degree of Freedom ResultsU X, Y, Z X, Y, or Z structural displacement.ROT X, Y, Z X, Y, or Z structural rotation.TEMP[1]

Temperature.

PRES Pressure.VOLT Electric potential.MAG Magnetic scalar potential.V X, Y, Z X, Y, or Z fluid velocity.A X, Y, Z X, Y, or Z magnetic vector potential.CURR Current.EMF Electromotive force drop.ENKE Turbulent kinetic energy.ENDS Turbulent energy dissipation.SP0n Mass fraction of species n, where n = 1

to 6. If a species is given a user-defined name [MSSPEC], use that name instead of SP0n.

Valid Item Labels for FLOTRAN Nodal ResultsTTOT Total temperature.HFLU Heat flux.HFLM Heat transfer (film) coefficient.COND Fluid laminar conductivity.

PCOE Pressure coefficient.PTOT Total (stagnation) pressure.MACH Mach number.STRM Stream function. (2-D applications

only.)DENS Fluid density.VISC Fluid laminar viscosity.EVIS Fluid effective viscosity.ECON Fluid effective conductivity.YPLU Y+, a turbulent law of the wall

parameter.TAUW Shear stress at the wall.LMDn Laminar mass diffusion coefficient for

species n, where n = 1 to 6.EMDn Effective mass diffusion coefficient for

species n, where n = 1 to 6.Valid Item and Component Labels for Element ResultsS X, Y, Z, XY, YZ,

XZComponent stress.

" 1, 2, 3 Principal stress." INT Stress intensity." EQV Equivalent stress.

EPEL X, Y, Z, XY, YZ, XZ

Component elastic strain.

" 1, 2, 3 Principal elastic strain." INT Elastic strain intensity." EQV Elastic equivalent strain.

EPTH X, Y, Z, XY, YZ, XZ

Component thermal strain.

" 1, 2, 3 Principal thermal strain." INT Thermal strain intensity." EQV Thermal equivalent strain.

EPPL X, Y, Z, XY, YZ, XZ

Component plastic strain.

" 1, 2, 3 Principal plastic strain." INT Plastic strain intensity.

" EQV Plastic equivalent strain.EPCR X, Y, Z, XY, YZ,

XZComponent creep strain.

" 1, 2, 3 Principal creep strain." INT Creep strain intensity." EQV Creep equivalent strain.

EPSW Swelling strain.EPTO X, Y, Z, XY, YZ,

XZComponent total mechanical strain (excluding thermal) (EPEL + EPPL + EPCR).

" 1, 2, 3 Principal total mechanical strain." INT Total mechanical strain intensity." EQV Total equivalent mechanical strain.

EPTT X, Y, Z, XY, YZ, XZ

Component total strain including thermal (EPEL + EPTH + EPPL + EPCR).

" 1, 2, 3 Principal total strain." INT Total strain intensity." EQV Total equivalent strain.

NL SEPL Equivalent stress (from stress-strain curve).

" SRAT Stress state ratio." HPRES Hydrostatic pressure." EPEQ Accumulated equivalent plastic strain.

SEND ELASTIC Elastic strain energy density." PLASTIC Plastic strain energy density." CREEP Creep strain energy density.

CDM DMG Damage variable" LM Maximum previous strain energy for

virgin materialFAIL MAX Maximum of all active failure criteria

defined at the current location (See the FCTYP command for details.) [1][3]

" EMAX Maximum Strain Failure Criterion. [1][3]

" SMAX Maximum Stress Failure Criterion. [1]

[3]" TWSI Tsai-Wu Strength Index Failure

Criterion. [1][3]" TWSR Inverse of Tsai-Wu Strength Ratio

Index Failure Criterion. [1][3]" HFIB Hashin Fiber Failure Criterion. [1][3][5]" HMAT Hashin Matrix Failure Criterion. [1][3]

[5]" PFIB Puck Fiber Failure Criterion. [1][3][5]" PMAT Puck Matrix Failure Criterion. [1][3][5]" USR1,

USR2, ..., USR9User-defined failure criteria. [1][3][4][5]

FCMX LAY Layer number where the maximum of all active failure criteria over the entire element occurs. [1][3]

" FC Number of the maximum-failure criterion over the entire element [1][3]:

1 - EMAX2 - SMAX3 - TWSI4 - TWSR5 - HFIB6 - HMAT7 - PFIB8 - PMAT9~17 - USR1~USR9

" VAL Value of the maximum failure criterion over the entire element. [1][3]

TG X, Y, Z, SUM Component thermal gradient or vector sum.

TF X, Y, Z, SUM 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.

FMAG[4]

X, Y, Z, SUM Component electromagnetic forces or vector sum.

SERR[5]

Structural error energy.

SDSG5 Absolute value of maximum variation of any nodal stress component.

TERR5 Thermal error energy.TDSG5 Absolute value of the maximum

variation of any nodal thermal gradient component.

F X, Y, Z Component structural force. Sum of element nodal values.

M X, Y, Z Component structural moment. Sum of element nodal values.

HEAT Heat flow. Sum of element nodal values.

FLOW Fluid flow. Sum of element nodal values.

AMPS Current flow. Sum of element nodal values.

FLUX Magnetic flux. Sum of element nodal values.

CSG X, Y, Z Component magnetic current segment.

SENE "Stiffness" energy or thermal heat dissipation (applies to all elements where meaningful). Same as TENE.

SEDN Strain energy density.AENE Artificial energy of the element. This

includes the sum of hourglass control

energy and energy generated by in-plane drilling stiffness from shell elements (applies to all elements where meaningful). The energy is used for comparisons to SENE energy to predict the solution error due to artificial stiffness. See the Theory Reference for the Mechanical APDL and Mechanical Applications.

TENE Thermal heat dissipation or "stiffness" energy (applies to all elements where meaningful). Same as SENE.

KENE Kinetic energy (applies to all elements where meaningful).

STEN Elemental energy dissipation due to stabilization.

JHEAT Element Joule heat generation.JS X, Y, Z, SUM Source 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) and vector sum (SUM).

JT X, Y, Z, SUM Total measureable current density in low-frequency electromagnetic analyses. (Conduction current density in a low-frequency electric analysis.) Components (X, Y, Z) and vector sum (SUM).

JC X, Y, Z, SUM Conduction current density for elements that support conduction current calculation. Components (X, Y, Z) and vector sum (SUM).

MRE Magnetics Reynolds numberVOLU Element volume. Based on unit

thickness for 2-D plane elements (unless the thickness option is used)

and on the full 360 degrees for 2-D axisymmetric elements.

CENT X, Y, Z Undeformed X, Y, or Z location (based on shape function) of the element centroid in the active coordinate system.

BFE TEMP Body temperatures (calculated from applied temperatures) as used in solution (area and volume elements only).

SMISC snum Element summable miscellaneous data value at sequence number snum (shown in the Output Data section of each applicable element description in the Element Reference).

NMISC snum Element non-summable miscellaneous data value at sequence number snum (shown in the Output Data section of each applicable element description found in the Element Reference).

SURF snum Element surface data value at sequence number snum (shown in Surface Solution of the Element Reference).

CONT STAT Contact status[3]:3-closed and sticking2-closed and sliding1-open but near contact0-open and not near contact

" PENE Contact penetration (zero or positive)." PRES Contact pressure." SFRIC Contact friction stress." STOT Contact total stress (pressure plus

friction)." SLIDE Contact sliding distance." GAP Contact gap distance (0 or negative)." FLUX Total heat flux at contact surface.

" CNOS Total number of contact status changes during substep.

" FPRS Fluid penetration pressureTOPO Densities used for topological

optimization.CAP C0,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.

EDPC CSIG,CSTR Material EDP creep model only (not including the cap model): Equivalent creep stress; equivalent creep strain.

ESIG X,Y,Z,XY,YZ,ZX 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.DPAR TPOR Total porosity (Gurson material

model)." GPOR Porosity due to void growth." NPOR Porosity due to void nucleation.

FFLX X,Y,Z Fluid flow flux in poromechanics.FICT TEMP Fictive temperature.

1. For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use labels TBOT, TE2, TE3, . . ., TTOP instead of TEMP.

2. For the CONT items for elements CONTA171 through CONTA177, the reported data is averaged across the element.

3. For MPC-based contact definitions, the value of STAT can be negative. This indicates 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.

4. When using the EMFT procedure to calculate electromagnetic force (SOLID117, PLANE121, SOLID122, SOLID123, PLANE233, SOLID236 or SOLID237 elements only), the FMAG sum will be zero or near zero.

5. Some element- and material-type limitations apply. For more information, see the documentation for the PRERR command.

Menu Paths

Main Menu>General Postproc>Element Table>Define TableMain Menu>General Postproc>Element Table>Erase Table

Release 13.0 - © 2010 SAS IP, Inc. All rights reserved.