*GET

*GET, Par, Entity, ENTNUM, Item1, IT1NUM, Item2, IT2NUM
Retrieves a value and stores it as a scalar parameter or part of an array parameter.

Compatible Products: DesSpc | Pro | Premium | Enterprise | Ent PP | Ent Solver | DYNA

Par

The name of the resulting parameter. See *SET for name restrictions.

Entity

Entity keyword. Valid keywords are NODE, ELEM, KP, LINE, AREA, VOLU, etc., as shown for Entity = in the tables below.

ENTNUM

The number or label for the entity (as shown for ENTNUM = in the tables below). In some cases, a zero (or blank) ENTNUM represents all entities of the set.

Item1

The name of a particular item for the given entity. Valid items are as shown in the Item1 columns of the tables below.

IT1NUM

The number (or label) for the specified Item1 (if any). Valid IT1NUM values are as shown in the IT1NUM columns of the tables below. Some Item1 labels do not require an IT1NUM value.

Item2, IT2NUM

A second set of item labels and numbers to further qualify the item for which data are to be retrieved. Most items do not require this level of information.

Notes

*GET retrieves a value for a specified item and stores the value as a scalar parameter, or as a value in a user-named array parameter. An item is identified by various keyword, label, and number combinations. Usage is similar to the *SET command except that the parameter values are retrieved from previously input or calculated results. For example, *GET,A,ELEM,5,CENT,X returns the centroid x-location of element 5 and stores the result as parameter A. *GET command operations, along with the associated Get functions return values in the active coordinate system unless stated otherwise. A Get function is an alternative in-line function that can be used to retrieve a value instead of the *GET command (see Using In-line Get Functions for more information).

Both *GET and *VGET retrieve information from the active data stored in memory. The database is often the source, and sometimes the information is retrieved from common memory blocks that the program uses to manipulate information. Although POST1 and POST26 operations use a *.rst file, *GET data is accessed from the database or from the common blocks. Get operations do not access the *.rst file directly. For repeated gets of sequential items, such as from a series of elements, see the *VGET command.

Most items are stored in the database after they are calculated and are available anytime thereafter. Items are grouped according to where they are usually first defined or calculated. Preprocessing data will often not reflect the calculated values generated from section data. Do not use *GET to obtain data from elements that use calculated section data, such as beams or shells. Most of the general items listed below are available from all modules. Each of the sections for accessing *GET parameters are shown in the following order:

The *GET command is valid in any processor.

General Items

*GET General Entity Items

Table 126:  *GET General Items, Entity = ACTIVE

Entity = ACTIVE, ENTNUM = 0 (or blank)
*GET, Par, ACTIVE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
INT Current interactive key: 0=off, 2=on.
IMME Current immediate key: 0=off, 1=on.
MENU Current menu key: 0=off, 1=on.
PRKEY Printout suppression status: 0=/NOPR, 1=/GOPR or /GO
UNITS Units specified by /UNITS command: 0 = USER, 1 = SI, 2 = CGS, 3 = BFT, 4 = BIN, 5 = MKS, 6 = MPA, 7 = uMKS.
ROUT Current routine: 0 = Begin level, 17 = PREP7, 21 = SOLUTION, 31 = POST1, 36 = POST26, 52 = AUX2, 53 = AUX3, 62 = AUX12, 65 = AUX15.
TIMEWALL,CPUCurrent wall clock or CPU time. Current wall clock will continue to accumulate during a run and is not reset to zero at midnight.
DBASELDATEDate of first modification of any database quantity required for POST1 operation. The parameter returned is Par = YEAR*10000 + MONTH*100 + DAY.
DBASELTIMETime of last modification of any database quantity required for POST1 operation. The parameter returned is Par = HOURS*10000 + MINUTES*100 + SECONDS.
REV Minor release revision number (5.6, 5.7, 6.0 etc.). Letter notation (e.g., 5.0A) is not included.
TITLE0,1,2,3,4Item2: START IT2NUM: N Current title string of the main title (IT1NUM=0 or blank) or subtitle 1, 2, 3, or 4 (IT1NUM=1,2,3, or 4). A character parameter of up to 8 characters, starting at position N, is returned.
JOBNAM Item2: START IT2NUM:N Current Jobname. A character parameter of up to 8 characters, starting at position N, is returned. Use *DIM and *DO to get all 32 characters.
PLATFORM The current platform.
NPROCCURR, MAX, MAXPThe number of processors being used for the current session, or the maximum total number of processors (physical and virtual) available on the machine, or the maximum number of physical processors available on the machine. This only applies to shared memory parallelism.
NUMCPU Number of Distributed ANSYS processes being used (distributed memory parallel).

Table 127:  *GET General Items, Entity = CMD

Entity = CMD, ENTNUM = 0 (or blank)

The following items are valid for all commands except star (*) commands and non-graphics slash (/) commands.

*GET, Par, CMD, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
STAT Status of previous command: 0=found, 1=not found (unknown).
NARGS Field number of last nonblank field on the previous command.
FIELD2,3...NNumerical value of the Nth field on the previous command. Field 1 is the command name (not available)

Table 128:  *GET General Items, Entity = COMP

Entity = COMP, ENTNUM = 0 (or blank)
*GET, Par, COMP, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NCOMP Total number of components and assemblies currently defined.
Entity = COMP, ENTNUM = n (nth component)
*GET, Par,  COMP, n,  Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NAME Name of the Nth item (component or assembly) in the list of components and assemblies. A character parameter is returned.
Entity = COMP, ENTNUM = Cname (component or assembly name)
*GET, Par, COMP, Cname, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Type of component Cname: 1=Nodes, 2=Elements, 6=Keypoints, 7=Lines, 8=Areas, 9=Volumes, 11-15=Subcomponents (11=subcomponent at level 1, 12=subcomponent at level 2, etc.).
NSCOMP Number of subcomponents (for assemblies).
SNAMENName of Nth subcomponent of assembly Cname. A character parameter is returned.

Table 129:  *GET General Items, Entity = GRAPH

Entity =GRAPH, ENTNUM = N (window number)
*GET, Par, GRAPH, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ACTIVE /WINDOW status: 0=off, 1=on.
ANGLE /ANGLE THETA angle.
CONTOUR Name/CONTOUR value for Name, where Name = VMIN, VINC, or NCONT.
DIST /DIST DVAL value.
DSCALEDMULT/DSCALE DMULT value.
EDGE /EDGE KEY value.
FOCUSX, Y, Z/FOCUS XF, YF, or ZF value.
GLINE /GLINE STYLE value.
MODE /USER or /AUTO setting: 0=user, 1=auto.
NORMAL /NORMAL KEY value.
RANGEXMIN, XMAX, YMIN, YMAX/WINDOW XMIN, XMAX, YMIN , or YMAX screen coordinates.
RATIOX, Y/RATIO RATOX or RATOYvalue.
SSCALESMULT/SSCALE SMULT value.
TYPE /TYPE Type value.
VCONEANGLE/VCONE PHI angle.
VIEWX, Y, Z/VIEW XV, YV, or ZV value.
VSCALEVRATIO/VSCALE VRATIO value.
Entity =GRAPH, ENTNUM = 0 (or blank)
*GET, Par, GRAPH, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
DISPLAY /SHOW VECT setting: 0=raster, 1=vector.
ERASE /ERASE or /NOERASE setting: 0=no erase, 1=erase.
NDIST Largest nodal range for current model (DX, DY, or DZ of the model).
NUMBER /NUMBER NKEY value.
PLOPTSName/PLOPTS setting of Name, where Name=LEG1, LEG2, LEG3, INFO, FRAM, TITL, MINM, or VERS.
SEG Segment capability of graphics driver: 0=no segments available, 1=erasable segments available, 2=non-erasable segments available.
SHRINK /SHRINK RATIO value.

Table 130:  *GET General Items, Entity = PARM

Entity, = PARMENTNUM = 0 (or blank)
*GET, Par, PARM, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MAX Total number of parameters currently defined.
BASIC Number of scalar parameters (excluding parameters beginning with an underscore _, array parameters, and character parameters).
LOCNumName of the parameter at the Num location in the parameter table. A character parameter is returned.
Entity = PARM, ENTNUM = Name (parameter name)
*GET, Par, PARM, Name, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Parameter type: 0 = scalar, 1 = array, 2 = table, 3 = character scalar, 4 = character array, -1 = undefined
DIMX(1), Y(2), Z(3), (4), (5) Row (X or 1), Column (Y or 2), Plane (Z or 3), Book (4), or Shelf (5) dimension of array parameter.
CSYS Local coordinate system number
VAR1, 2, 3, 4, 5Name of primary variables 1-5. Primary variable names are character strings.

If Item1 = DIM and ITNUM refers to a dimension that does not exist, the program assigns a value of -1 to Par.

If Item1 = CSYS and no local coordinate system number was assigned to the array parameter (Name), the program assigns a value of ZERO to Par.

If Item1 = VAR and if IT1NUM refers to a primary variable that does not exist, the program assigns a blank value to Par.


Table 131:  *GET General Items, Entity = TBTYPE

Entity = TBTYPE , ENTNUM = MatID

(where TBTYPE is the material table type as defined via the TB command, such [ELASTIC, CTE, etc.], and MatID is the material ID)

Evaluates a material property coefficient for a given set of input field variables.

*GET, Par, TBTYPE, MatID, Item1, IT1NUM, Item2, IT2NUM, Fld1, Fld2,...
Item1IT1NUMDescription
TBEV: Material table evaluation for query at a given field variableSINDEX = Subtable index (1 - max number of subtables)Item2: CINDEX = Coefficient index

IT2NUM: N = Number of field variables input

Fld1, Fld2, … : Val = Value of the field variable(s), entered in the same order specified via the TBFIELD command(s)


Preprocessing Items

*GET Preprocessing Entity Items

Table 132:  *GET Preprocessing Items, Entity = ACTIVE

Entity = ACTIVE, ENTNUM = 0 (or blank)
*GET, Par, ACTIVE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
SEG Segment capability of graphics driver: 0=no segments available, 1=erasable segments available, 2=non-erasable segments available.
CSYS Active coordinate system.
DSYS Active display coordinate system.
MAT Active material.
TYPE Active element type.
REAL Active real constant set.
ESYS Active element coordinate system.
SECT Active section.
CP Maximum coupled node set number in the model (includes merged and deleted sets until compressed out).
CE Maximum constraint equation set number in the model (includes merged and deleted sets until compressed out).

Table 133:  *GET Preprocessing items, Entity = AREA

Entity = AREA, ENTNUM = N (area number)
*GET, Par, AREA, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ATTRNameNumber assigned to the attribute, Name, where Name=MAT, TYPE, REAL, ESYS, KB,KE,SECN, NNOD, NELM, or ESIZ. (NNOD=number of nodes, NELM=number of elements, ESIZ=element size.)
ASEL Select status of area N: -1=unselected, 0=undefined, 1=selected. Alternative get function: ASEL(N).
NXTH Next higher area number above N in selected set (or zero if none found).
NXTL Next lower area number below N in selected set (or zero if none found).
AREA Area of area N. (ASUM or GSUM must have been performed sometime previously with at least this area N selected).
LOOP1,2,...,IItem2: LINE, IT2NUM: 1,2,...,p Line number of position p of loop I
Entity = AREA, ENTNUM = 0 (or blank)
*GET, Par, AREA, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX, MINHighest or lowest area number in the selected set.
NUMMAXD, MINDHighest or lowest area number defined.
COUNT Number of areas in the selected set.
AREA Combined areas (from last ASUM or GSUM).
VOLU Combined volume of areas (from last ASUM or GSUM. For 3-D area elements, thickness is determined from area attributes [AATT]. For 2-D elements, area attributes are ignored and unit thickness is assumed.
CENTX, Y, ZCentroid X, Y, or Z location of areas (from last ASUM or GSUM).
IORX, Y, Z, XY, YZ, ZXMoments of inertia about origin (from last ASUM or GSUM).
IMCX, Y, Z, XY, YZ, ZXMoments of inertia about mass centroid (from last ASUM or GSUM).
IPRX, Y, ZPrincipal moments of inertia (from last ASUM or GSUM).
IXVX, Y, ZPrincipal orientation X vector components (from last ASUM or GSUM).
IYVX, Y, ZPrincipal orientation Y vector components (from last ASUM or GSUM).
IZVX, Y, ZPrincipal orientation Z vector components (from last ASUM or GSUM).

Table 134:  *GET Preprocessing Items, Entity = AXIS

Entity = AXIS, ENTNUM = 0 (or blank)
*GET, Par, AXIS, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT-- Number of defined sections.
NUMMAXLargest section number defined.
Entity = AXIS, ENTNUM = ID (axis section identifier)
*GET, Par, AXIS, ID, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE-- Section type, for ID -- SECTYPE command (always AXIS for axis sections).
NAME-- Name defined for the given section ID number.
DATAnnnWhere nnn is the location in the SECDATA command for the given section ID number.

Table 135:  *GET Preprocessing Items, Entity = CDSY

Entity = CDSY, ENTNUM = N (coordinate system number)
*GET, Par, CDSY, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
LOCX, Y, ZX, Y, or Z origin location in global Cartesian system.
ANGXY, YZ, ZXTHXY, THYZ, or THZX rotation angle (in degrees) relative to the global Cartesian coordinate system.
ATTRNameNumber assigned to Name, where Name=KCS, KTHET, KPHI, PAR1, or PAR2. The value -1.0 is returned for KCS if the coordinate system is undefined.
NUMMAXThe maximum coordinate system number

Table 136:  *GET Preprocessing Items, Entity = CE

Entity = CE, ENTNUM = N (constraint equation set)
*GET, Par, CE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
If N = 0, then
MAX  

Maximum constraint equation number

NUM 

Number of constraint equations

If N > 0, then
NTERM  

Number of terms in this constraint equation

CONST 

Constant term for this constraint equation

TERMnumber

Item2 = NODE: Gives the node for this position in the constraint equation.

Item2 = DOF: Gives the DOF number for this position in the constraint equation. (1–UX, 2–UY, 3–UZ, 4–ROTX, etc.)

Item2 = COEF: Gives the coefficient for this position in the constraint equation.


Table 137:  *GET Preprocessing Items, Entity = CMPB

Entity = CMPB, ENTNUM = N (composite beam section identification number)
*GET, Par, CMPB, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Number of defined sections. If Item1 = COUNT, then N is blank.
NUMMAXLargest section number defined. If IT1NUM = MAX, then N is blank.
EXIS Returns a 1 if the section exists and if it is a CMPB section.
NAME The 8-character section name defined via the SECTYPE command.

One of the following:

CBMX
CBTE
CBMD
 Item2 = NTEM (the number of temperatures for CBMX, CBTE, or CBMD data).

One of the following:

CBMX
CBTE
CBMD
 Item2 = TVAL; IT2NUM = nnn

where nnn is the temperature value (< = NTEM).

One of the following:

CBMX
CBTE
CBMD
nnnItem2 = TEMP; IT2NUM = tval

Where nnn is the location in the CBMX, CBTE, or CBMD command for the given coefficient number, and tval is the temperature value.


Table 138:  *GET Preprocessing Items, Entity = CP

Entity = CP, ENTNUM = N (coupled node set)
*GET, Par, CP, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
If N = 0, then
MAX  

Maximum coupled set number

NUM 

Number of coupled sets

If N > 0, then
DOF 

The degree of freedom for this set (1–UX, 2–UY, 3–UZ, 4–ROTX, etc.)

NTERM  

Number of nodes in this set.

TERMnumber

Item2 = NODE: Gives the node for this position number in the coupled set.


Table 139:  *GET Preprocessing Items, Entity = CSEC

Entity = CSEC, ENTNUM = 0 (or blank)
*GET, Par, CSEC, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT-- Number of defined sections.
NUMMAXLargest section number defined.
Entity = CSEC, ENTNUM = ID (contact section identifier)
*GET, Par, CSEC, ID, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE-- Section type, for ID -- SECTYPE command (always CONT for contact sections).
NAME-- Name defined for the given section ID number.
DATAnnnWhere nnn is the location in the SECDATA command for the given section ID number.

Table 140:  *GET Preprocessing Items, Entity = EDCC

Entity = EDCC, ENTNUM = N (contact entity number, obtained by issuing the EDCLIST command)
*GET, Par, EDCC, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COMP1, 2Component name for the contact (1) or target (2) surface of contact entity N. A character parameter is returned.
PART1, 2PART number for contact (1) or target (2) surface of contact entity N.
Entity = EDCC, ENTNUM = 0 (or blank)
*GET, Par, EDCC, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Total number of contact definitions.

Table 141:  *GET Preprocessing Items, Entity = ELEM

Entity = ELEM, ENTNUM = N (element number)
*GET, Par, ELEM, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NODE1, 2, ... 20Node number at position 1,2,... or 20 of elementN. Alternative get function: NELEM(n,npos), where npos is 1,2,...20.
CENTX, Y, Z Centroid X, Y, or Z location (based on shape function) in the active coordinate system. The original locations is used even if large deflections are active. Alternative get functions: CENTRX(N), CENTRY(N), and CENTRZ(N) always retrieve the element centroid in global Cartesian coordinates, and are determined from the selected nodes on the elements.
ADJ1, 2, ... 6Element number adjacent to face 1,2,...6. Alternative get function: ELADJ(N,face). Only elements (of the same dimensionality) adjacent to lateral faces are considered.
ATTRNameNumber assigned to the attribute Name, where Name = MAT, TYPE, REAL, ESYS, PSTAT, LIVE, or SECN. Returns a zero if the element is unselected. If Name = LIVE, returns a 1 if the element is selected and active, and a -1 if it is selected and inactive. Name = SECN returns the section number of the selected beam element.
LENG Length of line element (straight line between ends).
LPROJX, Y, ZProjected line element length (in the active coordinate system). X is x-projection onto y-z plane, Y is y projection onto z-x plane, and Z is z-projection onto x-y plane.
AREA Area of area element.
APROJX, Y, ZProjected area of area element area (in the active coordinate system). X is x-projection onto y-z plane, Y is y projection onto z-x plane, and Z is z-projection onto x-y plane.
VOLU 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.

Note:  If results data are in the database, the volume returned is the volume calculated during solution.

ESEL Select status of element N: -1 = unselected, 0 = undefined, 1 = selected. Alternative get function: ESEL(N).
NXTH Next higher element number above N in selected set (or zero if none found). Alternative get function: ELNEXT(N)
NXTL Next lower element number below N in selected set (or zero if none found).
HGEN Heat generation on selected element N.
DGEN Diffusing substance generation on selected node N (returns 0.0 if node is unselected, or if the DOF is inactive).
HCOEfaceHeat coefficient for selected element N on specified face. Returns the value at the first node that forms the face.
TBULKfaceBulk temperature for selected element N on specified face. Returns the value at the first node that forms the face.
PRESfacePressure on selected element, N on specified face. Returns the value at the first node that forms the face.
SHPARTestElement shape test result for selected element N, where Test = ANGD, ASPE (aspect ratio), JACR (Jacobian ratio), MAXA (maximum corner angle), PARA (deviation from parallelism of opposite edges), or WARP (warping factor).
Entity = ELEM, ENTNUM = 0 (or blank)
*GET, Par, ELEM, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX,MINHighest or lowest element number in the selected set.
NUMMAXD, MINDHighest or lowest element number defined.
COUNT Number of elements in the selected set.
MATM Highest material number that is referenced by an element.
TYPM Highest element type number that is referenced by an element.
RELM Highest real constant number that is referenced by an element.
ESYM Highest element coordinate system number that is referenced by an element.
SECM Highest section ID number that is referenced by an element.
PRTM Highest part number that is referenced by an element.

Table 142:  *GET Preprocessing Items, Entity = ETYP

Entity = ETYP, ENTNUM = N (element type number)
*GET, Par, ETYP, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ATTR NameNumber assigned to the attribute Name, where Name=ENAM, KOP1, KOP2, ..., KOP9, KO10, KO11, etc.
Entity = ETYP, ENTNUM = 0 (or blank)
*GET,Par,ETYP, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAXMaximum element type.

Table 143:  *GET Preprocessing Items, Entity = GCN

Entity = GCN, ENTNUM = 0 (or blank)
*GET, Par, GCN, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MATSect1Item2 = 0 or blank; IT2NUM = Sect2. Material ID to be used for general contact between Sect1 and Sect2. Alternative get function: SECTOMAT(Sect1,Sect2).
REALSect1Item2 = 0 or blank; IT2NUM = Sect2. Real constant ID to be used for general contact between Sect1 and Sect2. Alternative get function: SECTOREAL(Sect1,Sect2).
DEFSect1Item2 = 0 or blank; IT2NUM = Sect2. Number indicating the type of contact for the general contact definition between Sect1 and Sect2:
= 0 - “Excluded” general contact between Sect1 / Sect2
= 1 - Asymmetric general contact between Sect1 (contact) / Sect2 (target)
= 2 - Asymmetric general contact between Sect1 (target) / Sect2 (contact)
= 3 - Symmetric general contact between Sect1 / Sect2
Sect1 and Sect2 are section numbers associated with general contact surfaces.

Table 144:  *GET Preprocessing Items, Entity = GENB

Entity = GENB, ENTNUM =N (nonlinear beam general section identification number)
*GET, Par, GENB, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT(Blank)Number of defined sections. If Item1 = COUNT, then N is blank.
NUMMAXLargest section number defined. If IT1NUM = MAX, then N is blank.
EXIS(Blank)Returns a 1 if the section exists and if it is a GENB section.
SUBTYPE(Blank)Section subtype for the section ID specified via the SECTYPE command.
NAME(Blank)The 8-character section name defined via the SECTYPE command.
One of the following:
BSAX
BSM1
BSM2
BSTQ
BSS1
BSS2
BSMD
BSTE
(Blank)Item2 = NTEM, the number of temperatures for BSAX, BSM1, BSM2, BSTQ, BSS1, BSS2, BSMD, or BSTE data.
One of the following:
BSAX
BSM1
BSM2
BSTQ
BSS1
BSS2
BSMD
BSTE
(Blank)Item2 = TVAL;  IT2NUM = nnn

Where nnn is the temperature value (<= NTEM).

One of the following:
BSAX
BSM1
BSM2
BSTQ
BSS1
BSS2
BSMD
BSTE
nnnItem2 = TEMP;  IT2NUM = tval

Where nnn is the location in the BSAX, BSM1, BSM2, BSTQ, BSS1, BSS2, BSMD, or BSTE command for the given coefficient number, and tval is the temperature value.

Examples for nnn:

nnn = 1 for STRAIN(1)
nnn = 2 for STRESS(1)
nnn = 3 for STRAIN(2)
nnn = 4 for STRESS(2)
nnn = 5 for STRAIN(3)
...
One of the following:
BSAX
BSM1
BSM2
BSTQ
BSS1
BSS2
BSMD
BSTE
(Blank)Item2 = TEMP;  IT2NUM = tval;  Item3 = NCONST

The number of constants at tval.


Table 145:  *GET Preprocessing Items, Entity = GENS

Entity = GENS, ENTNUM =N (preintegrated shell general section identification number)
*GET, Par, GENS, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT(Blank)Number of defined sections. If Item1 = COUNT, then N is blank.
NUMMAXLargest section number defined. If IT1NUM = MAX, then N is blank.
EXIS(Blank)Returns a 1 if the section exists and if it is a GENS section.
NAME(Blank)The 8-character section name defined via the SECTYPE command.
One of the following:
SSPA
SSPB
SSPD
SSPE
SSMT
SSBT
SSPM
(Blank)Item2 = NTEM, the number of temperatures for SSPA, SSPB, SSPD, SSPE, SSMT, SSBT, or SSPM data.
One of the following:
SSPA
SSPB
SSPD
SSPE
SSMT
SSBT
SSPM
(Blank)Item2 = TVAL;  IT2NUM = nnn

Where nnn is the temperature value (<= NTEM).

One of the following:
SSPA
SSPB
SSPD
SSPE
SSMT
SSBT
SSPM
nnnItem2 = TEMP;  IT2NUM = tval

Where nnn is the location in the SSPA, SSPB, SSPD, SSPE, SSMT, SSBT, or SSPM command for the given coefficient number, and tval is the temperature value.


Table 146:  *GET Preprocessing Items, Entity = KP

Entity = KP, ENTNUM = N (keypoint number)
*GET, Par, KP, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
LOCX, Y, ZX, Y, or Z location in the active coordinate system. Alternative get functions: KX(N), KY(N), KZ(N). Inverse get function: KP(x,y,z) returns the number of the selected keypoint nearest the x,y,z location (in the active coordinate system, lowest number for coincident keypoints).
ATTRNameNumber assigned to the attribute Name, where Name = MAT, TYPE, REAL, ESYS, NODE, or ELEM.
KSEL Select status of keypoint N: -1 = unselected, 0 = undefined, 1 = selected. Alternative get function: KSEL(N).
NXTH Next higher keypoint number above N in selected set (or zero if none found). Alternative get function: KPNEXT(N).
NXTL Next lower keypoint number below N in selected set (or zero if none found).
DIV Divisions (element size setting) from KESIZE command.
Entity = KP, ENTNUM = 0 (or blank)
*GET, Par, KP, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX, MINHighest or lowest keypoint number in the selected set.
NUMMAXD, MINDHighest or lowest keypoint number defined
COUNT Number of keypoints in the selected set.
CENTX, Y, ZCentroid X, Y, or Z location of keypoints (from last KSUM or GSUM).
IORX, Y, Z, XY, YZ, ZXMoments of inertia about origin (from last KSUM or GSUM).
IMCX, Y, Z, XY, YZ, ZXMoments of inertia about mass centroid (from last KSUM or GSUM).
IPRX, Y, ZPrincipal moments of inertia (from last KSUM or GSUM).
IXVX, Y, ZPrincipal orientation X vector components (from last KSUM or GSUM).
IYVX, Y, ZPrincipal orientation Y vector components (from last KSUM or GSUM).
IZVX, Y, ZPrincipal orientation Z vector components (from last KSUM or GSUM).
MXLOCX, Y, ZMaximum X, Y, or Z keypoint coordinate in the selected set (in the active coordinate system).
MNLOCX, Y, ZMinimum X, Y, or Z keypoint coordinate in the selected set (in the active coordinate system).
NRELMmKeypoint number of meshed region nearest centroid of element m.

Table 147:  *GET Preprocessing Items, Entity = LINE

Entity = LINE, ENTNUM = N (line number)
*GET, Par, LINE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
KP1,2Keypoint number at position 1 or 2.
ATTRNameNumber assigned to the attribute, Name, where Name=MAT, TYPE, REAL, ESYS, NNOD, NELM, NDIV, NDNX, SPAC, SPNX, KYND, KYSP, LAY1, or LAY2. (NNOD=number of nodes, returns --1 for meshed line with no internal nodes, NELM=number of elements, NDIV=number of divisions in an existing mesh, NDNX=number of divisions assigned for next mesh, SPAC=spacing ratio in an existing mesh, SPNX=spacing ratio for next mesh, KYND=soft key for NDNX, KYSP=soft key for SPNX, LAY1=LAYER1 setting, LAY2=LAYER2 setting.)
LSEL Select status of line N: -1=unselected, 0=undefined, 1=selected. Alternative get function: LSEL(N).
NXTH Next higher line number above N in the selected set (or zero if none found). Alternative get function: LSNEXT(N)
NXTL Next lower line number below N in selected set (or zero if none found).
LENG Length. A get function LX(n,lfrac) also exists to return the X coordinate location of line N at the length fraction lfrac (0.0 to 1.0). Similar LY and LZ functions exist.
Entity = LINE, ENTNUM = 0 (or blank)
*GET, Par, LINE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX, MINHighest or lowest line number in the selected set.
NUMMIND, MAXDHighest or lowest line number defined.
COUNT Number of lines in the selected set.
LENG Combined length of lines (from last LSUM or GSUM).
CENTX, Y, ZCentroid X, Y, or Z location of lines (from last LSUM or GSUM).
IORX, Y, Z, XY, YZ, ZXMoments of inertia about origin (from last LSUM or GSUM).
IMCX, Y, Z, XY, YZ, ZXMoments of inertia about mass centroid (from last LSUM or GSUM).
IPRX, Y, ZPrincipal moments of inertia (from last LSUM or GSUM).
IXVX, Y, ZPrincipal orientation X vector components (from last LSUM or GSUM).
IYVX, Y, ZPrincipal orientation Y vector components (from last LSUM or GSUM).
IZVX, Y, ZPrincipal orientation Z vector components (from last LSUM or GSUM).

Table 148:  *GET Preprocessing Items, Entity = LINK

Entity = LINK, ENTNUM = 0 (or blank)
*GET, Par, LINK, NUM, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Number of defined sections.
NUMMAXLargest section number defined.
Entity = LINK, ENTNUM = id (link section identification number)
*GET, Par, LINK, id, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Section type (SECTYPE) (always LINK for link sections) associated with the section identified via id
NAME Name defined for the given section identification number
DATAnnnLocation in the SECDATA command for the given id
PROPAREAArea value
ADDMASAdded mass per unit length
TENSKEYTension/compression key

Table 149:  *GET Preprocessing Items, Entity = MAT

Entity = MAT, ENTNUM = 0 (or blank)
*GET, Par, MAT, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Number of materials.
NUMMAXLargest material number defined.

Table 150:  *GET Preprocessing Items, Entity = MPLAB

Entity = MPlab, ENTNUM =N (MPlab = material property label from MP command; N = material number.)
*GET, Par, MPlab, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TEMPvalMaterial property value at temperature of val. For temperature dependent materials, the program interpolates the property at temperature input for val.

Table 151:  *GET Preprocessing Items, Entity = NODE

Entity = NODE, ENTNUM = N (node number)
*GET, Par, NODE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
LOCX, Y, ZX, Y, Z location in the active coordinate system. Alternative get functions: NX(N), NY(N), NZ(N). Inverse get function. NODE(x,y,z) returns the number of the selected node nearest the x,y,z location (in the active coordinate system, lowest number for coincident nodes).
ANGXY, YZ, ZXTHXY, THYZ, THZX rotation angle.
NSEL Select status of node N: -1=unselected, 0=undefined, 1=selected. Alternative get function: NSEL(N).
NXTH Next higher node number above N in selected set (or zero if none found). Alternative get function: NDNEXT(N).
NXTL Next lower node number below N in selected set (or zero if none found).
FFX, MX, ... Applied force at selected node N in direction IT1NUM (returns 0.0 if no force is defined, if node is unselected, or if the DOF is inactive). If ITEM2 is IMAG, return the imaginary part.
DUX, ROTX, ...Applied constraint force at selected node N in direction IT1NUM (returns a large number, such as 2e100, if no constraint is specified, if the node is unselected, or if the DOF is inactive). If ITEM2 is IMAG, return the imaginary part.
HGEN Heat generation on selected node N (returns 0.0 if node is unselected, or if the DOF is inactive).
NTEMP Temperature on selected node N (returns 0.0 if node is unselected)
CPSLabCouple set number with direction Lab = any active DOF, which contains the node N.
DGEN Diffusing substance generation on selected node N (returns 0.0 if node is unselected, or if the DOF is inactive).
Entity = NODE, ENTNUM = 0 (or blank)
*GET, Par, NODE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX, MINHighest or lowest node number in the selected set.
NUMMAXD, MINDHighest or lowest node number defined.
COUNT Number of nodes in the selected set.
MXLOCX, Y, ZMaximum X, Y, or Z node coordinate in the selected set (in the active coordinate system).
MNLOCX, Y, ZMinimum X, Y, or Z node coordinate in the selected set (in the active coordinate system).
Note: If the application creates internal nodes during solution, the internal nodes will not be included. You can include them by using KINTERNAL. The command syntax is:

*GET, Par, NODE, 0, Item1, IT1NUM, Item2, IT2NUM, KINTERNAL

The options for the KINTERNAL key are (blank), which counts all nodes except internal nodes, and INTERNAL, which counts all nodes including internal nodes.


Table 152:  *GET Preprocessing Items, Entity = OCEAN

Entity = OCEAN, ENTNUM = Type (where Type is a valid label on the DataType field of the OCTYPE command)
*GET, Par, OCEAN, 0, Type, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NAME Name defined for a given Type
DATA1Depth when Type = BASI
2Material ID when Type = BASI
8KFLOOD when Type = BASI
9Cay when Type = BASI
10Cb when Type = BASI
11Zmsl when Type = BASI
13Caz when Type = BASI
14Ktable when Type = BASI
1KWAVE when Type = WAVE
2THETA when Type = WAVE
3WAVELOC when Type = WAVE
4KCRC when Type = WAVE
5KMF when Type = WAVE
6PRKEY when Type = WAVE
PROPNROWNumber of rows defined by OCTABLE command
TABLiData in table defined by OCTABLE command i = row number; Item2 = column number

Entity = OCEAN, ENTNUM = 0 (or blank)
*GET, Par, OCEAN, Item1, IT1NUM, Item2, IT2NUM
COUNT Number of defined global ocean entities (BASIC/CURRENT/WAVE)
It may be necessary to determine Cay, Caz, CMy, or CMz during the solution process. In such cases, a negative value (-1.0) is returned to Par if the item is not specified in the database.

Table 153:  *GET Preprocessing Items, Entity = OCZONE

Entity = OCZONE, ENTNUM = Name (where Name is a valid label on the ZoneName field of the OCZONE command)
*GET, Par, OCZONE, Name, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
DATA8KFLOOD for a given ENTNUM = Name
9Cay for a given ENTNUM = Name
10Cb for a given ENTNUM = Name
13Caz for a given ENTNUM = Name
PROPNROWNumber of rows defined by OCTABLE command
TABLiData in table defined by OCTABLE command i = row number; Item2 = column number
TYPE Ocean zone type (returns 1, 2 or 3 for ZLOC-, COMP-, or PIP-type zones, respectively)
COMP Component name when the given ocean zone type is COMP, or internal component name when the given ocean zone type is PIP
COMP2 External component name when the type of given ocean zone is PIP

Entity = OCZONE, ENTNUM = N
*GET, Par, OCZONE, N, Item1, IT1NUM, Item2, IT2NUM
NAME Name defined for a given zone ID (ENTNUM)
Entity = OCZONE, ENTNUM = 0 (or blank)
*GET, Par, OCZONE, 0, Item1, IT1NUM, Item2, IT2NUM
COUNT Number of defined zones
If a requested item is not specified in the database, a negative value (-1.0) is returned to Par.

Table 154:  *GET Preprocessing Items, Entity = PIPE

Entity = PIPE, ENTNUM = 0 (or blank)
*GET, Par, PIPE, NUM, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Number of defined sections
NUMMAXLargest section number defined
Entity = PIPE, ENTNUM = id (pipe section identification number)
*GET, Par, PIPE, id, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Section type, for id - SECTYPE command (always PIPE for pipe sections)
SUBTYPE Section type for id - SECTYPE command
NAME Name defined for the given section id number
DATAnnnWhere nnn is the location in the SECDATA command for the given section id number
SFLEXnnnWhere nnn is the location in the SFLEX command for the given section ID number
PROPAREAArea value
IYY, IYZ, IZZMoments of inertia
TORSTorsion constant
SCYY, SCYZ, SCZZShear correction factors
OFFYSection offset in the Y direction.
OFFZSection offset in the Z direction.
ADDMASAdded mass per unit length

Table 155:  *GET Preprocessing Items, Entity = PART

Entity = PART, ENTNUM = N (PART number)
*GET, Par, PART, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Element type number assigned to PART N.
MAT Material number assigned to PART N.
REAL Real constant number assigned to PART N.
Entity = PART, ENTNUM = 0 (or blank)
*GET, Par, PART, 0, Item1, IT1NUM, Item2, IT2NUM
NUMP Total number of parts in the model.

Table 156:  *GET Preprocessing Items, Entity = RCON

Entity = RCON, ENTNUM = N (real constant set number)
*GET, Par, RCON, N, Item1, IT1NUM, Item2, IT2NUM
CONST1, 2, ..., m Value of real constant number m in set N.
*GET, Par, RCON, 0, Item1, IT1NUM, Item2, IT2NUM
NUMMAXThe maximum real constant set number defined

Table 157:  *GET Preprocessing Items, Entity = REIN

Entity = REIN, ENTNUM = N (reinforcing section identification number)
*GET, Par, REIN, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Section type, for ID -- SECTYPE command (always REIN for reinforcing sections).
SUBTYPE Section subtype for ID -- SECTYPE command.
NAME Name defined for a given ID number.
NREIN Number of reinforcing fibers.
TABLReinfNumber,IReinforcing fiber data, as defined by the SECDATA command.

Table 158:  *GET Preprocessing Items, Entity = SCTN

Entity = SCTN, ENTNUM = N (pretension section ID number)
*GET, Par, SCTN, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
1 Section ID number.
2 Section type (always 5 for pretension section).
3 Pretension node number.
4Coordinate system number.Section normal NX.
5Coordinate system number.Section normal NY.
6Coordinate system number.Section normal NZ.
7 or 8 Eight character section name.
9 Initial action key. Returns 0 or 1 for lock, 2 for "free-to-slide," or 3 for tiny.
10 Force displacement key. Returns 0 or 1 for force, or 2 for displacement.
11 First preload value.
12 Load step in which first preload value is to be applied.
13 Load step in which first preload value is to be locked.
14... 14 through 17 is a repeat of 10 through 13, but for the second preload value; 18 through 21 is for the third preload value; and so forth.

Table 159:  *GET Preprocessing Items, Entity = SECP

Entity = SECP, ENTNUM = 0 (or blank)
*GET, Par, SECP, NUM, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
COUNT Number of defined sections
NUMMAXLargest section number defined
Entity = SECP, ENTNUM = id (beam section identification number)
*GET, Par, SECP, id, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Section type, for id - SECTYPE command (always BEAM for beam sections)
SUBTYPE Section type for id - SECTYPE command
NAME Name defined for the given section id number
DATAnnnWhere nnn is the location in the SECDATA command for the given section id number
PROPAREAArea value
IYY, IYZ, IZZMoments of inertia
WARPWarping constant
TORSTorsion constant
CGY, CGZY or Z coordinate center of gravity
SHCY, SHCZY or Z coordinate shear center
SCYY, SCYZ, SCZZShear correction factors
OFFSETOffset location:
1 = Centroid
2 = Shear Center
3 = Origin
0 = User Defined
OFFYSection offset in the Y direction.
OFFZSection offset in the Z direction.
TXYUser transverse shear stiffness XY
TXZUser transverse shear stiffness XZ
ADDMASAdded mass per unit length

Table 160:  *GET Preprocessing Items, Entity = SHEL

Entity = SHEL, ENTNUM = N (shell section identification number)
*GET, Par, SHEL, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
TYPE Section type, for id — SECTYPE command. (always SHEL for shell sections)
NAME Name defined for a given id number.
PROPTTHKTotal thickness.
NLAYNumber of layers.
NSPNumber of section integration points.
POSNode position (as defined by SECOFFSET).
0 = User Defined.
1 = Middle.
2 = Top.
3 = Bottom.
OFFZUser-defined section offset (POS = 0).
TS11Transverse shear stiffness factors.
TS22Transverse shear stiffness factors.
TS12Transverse shear stiffness factors.
HORCHomogeneous or complete section flag.
0 = Homogeneous.
1 = Composite.
FUNCTabular function name for total thickness.
UT11User transverse shear stiffness 11.
UT22User transverse shear stiffness 22.
UT12User transverse shear stiffness 12.
AMASAdded mass.
MSCFHourglass control membrane scale factor.
BSCFHourglass control bending scale factor.
DSTFDrill stiffness scale factor.
LDENLaminate density.
FKCNKCN field value from the SECFUNCTION command, in which the array or table is interpreted.
ABDSection membrane and bending stiffness matrix. Valid ITEM2 = 1,6 and IT2NUM = 1,6.
ESection transverse shear stiffness matrix. Valid ITEM2 = 1,2 and IT2NUM = 1,2.
LAYDLayerNumber,THICLayer thickness.
LayerNumber,MATLayer material.
LayerNumber,ANGLLayer orientation angle.
LayerNumber,NINTNumber of layer integration points.

Table 161:  *GET Preprocessing Items, Entity = TBFT

Entity = TBFT, ENTNUM = blank
*GET, Par, TBFT, , Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
nmat Number of defined material models.
matnumindexMaterial number in array (index varies for 1 to num materials).
Entity = TBFT, ENTNUM = matid (For getting names of constitutive function, matid = the material ID number)
*GET, Par, TBFT, matid, nfun, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
nfun Number of constitutive functions for this material.
Entity = TBFT, ENTNUM = matid (To query constitutive function data, matid = the material ID number)
*GET, Par, TBFT, matid, func, fname, Item2, IT2NUM
Item1IT1NUMDescription
funcindexif Item2 = fname, the name of the constitutive function is returned.
funcfunction nameIf Item2 = ncon, the number of constants is returned for the function specified in IT1NUM by the constitutive function name.
If Item2 = cons, set Item2num to index to return the value of the constant.
If Item2 = fixe, set Item2num to index to return the fix flag status.
If Item2 = RESI, returns the residual error while fitting the data.
If Item2 = type, returns the category of the constitutive model (moon, poly, etc.)
If Item2 = sord, returns the shear order of the prony visco model.
If Item2 = bord, returns the bulk order of the prony visco model.
If Item2 = shif, returns the shift function name of the prony visco model.
Entity = TBFT, ENTNUM = matid (To query experimental data, matid = the material ID number))
*GET, Par, TBFT, matid, func, fname, Item2, IT2NUM
Item1IT1NUMDescription
expe(blank)If Item2 = nexp, returns number of experiments in a material model.
expindexIf Item2 = type, returns index of experiment.
If Item2 = numrow, returns number of rows in the data.
If Item2 = numcol, returns the number of cols in a row (set Intem2num = Row index)
If Item2 = data, returns the value of the data in row, col of exp expindex (set item2Num = row index and item3 = column index. All indices vary from 1 to the maximum value.
If Item2 = natt, returns the number of attributes.
If Item2 = attname, returns the attribute name (set Item2Num = Attr index).
If Item2 = attvald, returns double value of attribute (set Item2Num = Attr index).
If Item2 = attvali, returns integer valud of attribute (set Item2Num = Attr index).
If Item2 = attvals, returns the string value of the attribute (set Item2Num = Attr index).

Table 162:  *GET Preprocessing Items, Entity = TBLAB

Entity = TBLAB, ENTNUM = N..(TBlab = data table label from the TB command; N = material number.)
*GET, Par, TBlab, N, Item1, IT1NUM, Item2, IT2NUM, TBOPT
Item1IT1NUMDescription
TEMPTItem2: CONST IT2NUM: Num Value of constant number Num in the data table at temperature T. For constants, input an X,Y point; the constant numbers are consecutive with the X constants being the odd numbers, beginning with one.

Important:  To get all necessary output for materials defined via the TB command, you must specify the final argument TBOPT as indicated in the syntax description above.



Table 163:  *GET Preprocessing Items, Entity = VOLU

Entity = VOLU, ENTNUM = N (volume number)
*GET, Par, VOLU, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ATTRNameNumber assigned to the attribute Name, where Name=MAT, TYPE, REAL, ESYS, NNOD, or NELM. (NNOD=number of nodes, NELM=number of elements.)
VSEL Select status of volume N: -1=unselected, 0=undefined, 1=selected. Alternative get function: VSEL(N).
NXTH Next higher volume number above N in selected set (or zero if none found). Alternative get function: VLNEXT(N).
NXTL Next lower volume number below N in selected set (or zero if none found).
VOLU Volume of volume N. (VSUM or GSUM must have been performed sometime previously with at least this volume N selected).
SHELL1, 2, ..., mItem2: AREA IT2NUM: 1,2,...,p Line number of position p of shell m
Entity = VOLU, ENTNUM = 0 (or blank)
*GET, Par, VOLU, 0, Item1, IT1NUM, Item2, IT2NUM
NUMMAX, MINHighest or lowest volume number in the selected set.
NUMMAXD, MINDHighest or lowest volume number defined.
COUNT Number of volumes in the selected set.
VOLU Combined volumes (from last VSUM or GSUM).
CENTX, Y, ZCentroid X, Y, or Z location of volumes (from last VSUM or GSUM).
IORX, Y, Z, XY, YZ, ZXMoments of inertia about origin (from last VSUM or GSUM).
IMCX, Y, Z, XY, YZ, ZXMoments of inertia about mass centroid (from last VSUM or GSUM).
IPRX, Y, ZPrincipal moments of inertia (from last VSUM or GSUM).
IXVX, Y, ZPrincipal orientation X vector components (from last VSUM or GSUM).
IYVX, Y, ZPrincipal orientation Y vector components (from last VSUM or GSUM).
IZVX, Y, ZPrincipal orientation Z vector components (from last VSUM or GSUM).

Table 164:  *GET Preprocessing Items, Entity = WELD

Entity = WELD, ENTNUM = N (weld number)

Only valid in an LS-DYNA analysis.

*GET, Par, WELD, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NODE1, 2First or second node number for spot weld N.
NXTH Next higher spotweld number above N (or 0 if none found).
Entity = WELD, ENTNUM = 0 (or blank)
*GET, Par, WELD, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NUMMAX, MINHighest or lowest spotweld number.
COUNT Total number of spotwelds in model.

Solution Items

*GET Solution Entity Items

Table 165:  *GET Solution Items, Entity = ACTIVE

Entity = ACTIVE, ENTNUM = 0 (or blank)
*GET, Par, ACTIVE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ANTY Current analysis type.
SOLUDTIMETime step size.
NCMLSCumulative number of load steps.
NCMSSNumber of substeps. NOTE: Used only for static and transient analyses.
EQITNumber of equilibrium iterations.
NCMITCumulative number of iterations.
CNVGConvergence indicator: 0=not converged, 1=converged.
MXDVLMaximum degree of freedom value.
RESFRQResponse frequency for 2nd order systems.
RESEIGResponse eigenvalue for 1st order systems.
DSPRMDescent parameter.
FOCVForce convergence value.
MOCVMoment convergence value.
HFCVHeat flow convergence value.
MFCVMagnetic flux convergence value.
CSCVCurrent segment convergence value.
CUCVCurrent convergence value.
FFCVFluid flow convergence value.
DICVDisplacement convergence value.
ROCVRotation convergence value.
TECVTemperature convergence value.
VMCVVector magnetic potential convergence value.
SMCVScalar magnetic potential convergence value.
VOCVVoltage convergence value.
PRCVPressure convergence value.
VECVVelocity convergence value.
CRPRATMaximum creep ratio.
PSINCMaximum plastic strain increment.
CGITERNumber of iterations in the PCG and symmetric JCG (non-complex version) solvers.

Table 166:  *GET Solution Items, Entity = ELEM

Entity = ELEM, ENTNUM = 0 (or blank)
*GET, Par, ELEM, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MTOTX, Y, ZTotal mass components.
MCX, Y, ZCenter of mass components.
IORX, Y, Z, XY, YZ, ZXMoment of inertia about origin.
IMCX, Y, Z, XY, YZ, ZXMoment of inertia about the center of mass.
IPRINX, Y, ZPrincipal moments of inertia.
IANGXY, YZ, ZXAngles of the moments of inertia principal axes.
FMCX, Y, ZForce components at mass centroid (1).
MMORX, Y, ZMoment components at origin (1).
MMMCX, Y, ZMoment components at mass centroid (1).


Note:  Items (1) are available only after inertia relief solution (IRLF,1) or pre-calculation of masses (IRLF,-1).

Item values are consistent with the mass summary printed in the output file. They are based on unscaled mass properties (see MASCALE command).


Table 167:  *GET Solution Items, Entity = MODE

Entity = MODE, ENTNUM = N (mode number)
*GET, Par, MODE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
FREQ Frequency of mode N.

Returned values are valid for modal analyses which calculate real eigensolutions.

STAB Stability value of mode N.

Returned values are valid for modal analyses which calculate complex eigensolutions. The stability value is the real part of the complex eigenvalue. It contains information on the mode damping in a damped modal analysis.

DFRQ Damped frequency of mode N.

Returned values are valid for modal analyses which calculate complex eigensolutions. The damped frequency is the imaginary part of the complex eigenvalue.

PFACT Participation factor of mode N.
  • If retrieved after a modal analysis, the real part of the participation factor is returned unless IT1NUM = IMAG. The direction is specified using Item2 = DIREC and IT2NUM = X, Y, Z, ROTX, ROTY, or ROTZ

  • If retrieved after a spectrum analysis, the spectrum number M is specified using Item2 = SPECT and IT2NUM = M.

For a PSD analysis with spatial correlation or wave excitation, the retrieved participation factors will correspond to the first degree of freedom that is excited.

MODM Effective mass of mode N.

Returned values are valid only after a modal analysis with effective mass calculation has been solved. The direction is specified using Item2 = DIREC and IT2NUM = X, Y, Z, ROTX, ROTY, or ROTZ.

MCOEF Mode coefficient of mode N.

Returned values are valid only after a spectrum analysis has been solved. The spectrum number M is specified using Item2 = SPECT and IT2NUM = M. In a SPRS analysis, the values returned are based on the curve with the lowest damping.

After a PSD analysis, the diagonal of the dynamic modal covariance matrix is retrieved for the displacement solution.

DAMP Damping ratio of mode N. If retrieved after a modal analysis that creates complex solutions (DAMP, QRDAMP, or UNSYM eigensolvers) returned value is calculated from the complex frequencies.

If retrieved after a spectrum analysis, returned value is the effective damping ratio.

Not a function of direction. Also retrievable following a harmonic analysis or transient analysis with mode-superposition.

For all items except PFACT and MCOEF (as noted above), only the first 10000 values corresponding to significant modes will be returned.

The MODE file must be available to retrieve items PFACT and MCOEF with specified Item2. If Item2 is not specified, the last calculated value will be returned.

All values retrieved correspond to the first load step values. For a Campbell diagram analysis (multistep modal), *GET with Entity = CAMP must be used.

Table 168:  *GET Solution Items, Entity = DDAM

Entity = DDAM, ENTNUM = N (mode number)
*GET,Par,DDAM,N, Item1, IT1NUM
Item1IT1NUMDescription
DSHOCK Shock design value of mode N.

If multiple DDAM analyses are performed, the last calculated value will be returned.

Postprocessing Items

*GET Postprocessing Entity Items

Table 169:  *GET Postprocessing Items, Entity = ACTIVE

Entity = ACTIVE, ENTNUM = 0 (or blank)
*GET,Par, ACTIVE, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
SETLSTPCurrent load step number.
SBSTCurrent substep number.
TIMETime associated with current results in the database.
FREQFrequency (for ANTYPE=MODAL, HARMIC, SPECTR; load factor for ANTYPE=BUCKLE).
NSETIf Item2 is blank, number of data sets on result file.
If Item2 = FIRST, IT2NUM = Loadstep, get set number of first substep of loadstep
If Item2 = LAST, IT2NUM = Loadstep, get set number of last substep of loadstep
RSYS Active results coordinate system.

Table 170:  *GET Postprocessing Items, Entity = CAMP

Note:  Available after PLCAMP or PRCAMP command is issued.

Entity = CAMP, ENTNUM = N (mode number)
*GET,Par, CAMP, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NBMO Number of modes in the Campbell diagram (ENTNUM not required). This value is the maximum value for N.
NBST Number of steps in the Campbell diagram: modal load steps with rotational velocity (ENTNUM not required). This value is the maximum value for M (see Item1 = FREQ).
WHRL Whirl of mode N: -1 is backward whirl, 1 is forward whirl, and 0 is undetermined. It corresponds to the whirl at the maximum rotational velocity.
VCRI 

Critical speed for mode N. This value is available if an excitation is defined via the PLCAMP or PRCAMP command's SLOPE argument. (The unit of speed depends upon the UNIT value specified in those commands.)

Note:  N does not correspond to the mode number if FREQB (PRCAMP or PLCAMP command) is used. Instead, it represents the Nth mode number listed in the output of PRCAMP or PLCAMP.

FREQMNatural frequency of mode (Hz) N at step M. It represents the complex part of the eigenvalue.
STABMStability value (Hz) of mode N at step M. It represents the real part of the eigenvalue.
UKEY Instability key for mode N: 0 is stable and 1 is unstable. It corresponds to the stability over the whole rotational velocity range.
VSTA 

Stability limit for mode N. This value is available when SLOPE is zero on the PLCAMP or PRCAMP command. (The unit of speed depends upon the UNIT value specified in those commands.)

Note:  N does not correspond to the mode number if FREQB (PRCAMP or PLCAMP command) is used. Instead, it represents the Nth mode number listed in the output of PRCAMP or PLCAMP.



Note:  If the sorting is activated (Option=ON on the PRCAMP and PLCAMP commands), all the parameters retrieved are in the sorted order.


Table 171:  *GET Postprocessing Items, Entity = CINT

Entity = CINT, ENTNUM = CrackId (required Crack ID number)
*GET,Par, CINT, CrackId, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
CTIPctnum

IT1NUM = Crack tip node number (required)

Item2 = CONTOUR

IT2NUM = Contour number (default 1)

Returns JINT value if crack ID is JINT type, otherwise returns 0

Item1 defaults to CTIP, Item2 defaults to CONTOUR

Entity = CINT, ENTNUM = CrackID (required Crack ID number)
*GET, Par, CINT, CrackId, Item1, IT1NUM, Item2, IT2NUM, Item3, IT3NUM, Item4, IT4NUM
Item1IT1NUMDescription
CTIPctnum

IT1NUM = Crack tip node number (required)

Item2 = CONTOUR

IT2NUM = Contour number (default 1)

Item3 = DTYPE

IT3NUM = Data type (JINT, IIN1, IIN2, IIN3, K1, K2, K3, G1, G2, G3, GT, MFTX, MFTY, MFTZ, TSTRESS, CEXT, STTMAX, PSMAX, CSTAR, TOTA, TOTN, DLTK)

FOR IT3NUM = PSMAX or STTMAX:

  • Item4 = AINDEX (angle index)

  • IT4NUM = Index value (1 to N+1; N = Maximum number of intervals for the sweep (CINT,RSWEEP).

Returns specified data type value.

FOR IT3NUM =TOTA or TOTN or DLTK:

  • Set IT2NUM = 1.

Returns specified data type value.

Item1 defaults to CTIP, Item2 defaults to CONTOUR, Item3 defaults to DTYPE

Entity = CINT, ENTNUM = CrackID (required Crack ID number)
*GET, Par, CINT, CrackId, Item1, IT1NUM, Item2, IT2NUM,
Item1IT1NUMDescription
NNOD Maximum number of nodes along the crack front.
Entity = CINT, ENTNUM = CrackID (required Crack ID number)
*GET, Par, CINT, CrackId, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NODEiposIT1NUM = Position along the crack front (from 1 to NNOD). Default = 1. Returns node number at the given position along the crack front. (For XFEM, an internal node number is returned.)

Table 172:  *GET Postprocessing Items, Entity = ELEM

Entity = ELEM, ENTNUM = N (element number)
*GET,Par, ELEM, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
SERR[1] Structural error energy.
SDSG[1] Absolute value of the maximum variation of any nodal stress component.
TERR[1] Thermal error energy.
TDSG[1] Absolute value of the maximum variation of any nodal thermal gradient component.
SENE "Stiffness" energy or thermal heat dissipation. Same as TENE.
TENE Thermal heat dissipation or "stiffness" energy. Same as SENE.
KENE Kinetic energy.
JHEAT Element Joule heat generation (coupled-field calculation).
JSX, Y, ZSource current density (coupled-field calculation) in the global Cartesian coordinate system.
HSX, Y, ZAverage element magnetic field intensity from current sources.
VOLU Element volume, as calculated during solution.
ETABLabValue of element table item Lab for element N (see ETABLE command).
EFORNnum

Element force at node Nnum. The force label is specified using Item2 = FX, FY, FZ, MX, MY, MZ, or HEAT.

In a dynamics analysis, the element forces returned are based on the type of force requested. It is specified using the FORCE command for all dynamics analyses, except for spectrum analyses where ForceType is used on the combination commands (SRSS, PSDCOM, etc.).

SMISCSnumValue of element summable miscellaneous data at sequence number Snum (as used on ETABLE command).
NMISCSnumValue of element non-summable miscellaneous data at sequence number Snum (as used on ETABLE command).
FSOU Element fluid flow source loading (poromechanics).

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

Table 173:  *GET Postprocessing Items, Entity = ETAB

Entity = ETAB, ENTNUM = N (column number)
*GET,Par, ETAB, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
LAB Label for column N of the element table [ETABLE]. Returns a character parameter.
ELEMEValue in ETABLE column N for element number E.
Entity = ETAB, ENTNUM = 0 (or blank)
*GET,Par,ETAB,0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NCOLMAXTotal number of ETABLE columns.
NLENGMAXLargest element number defined.

Table 174:  *GET Postprocessing Items, Entity = FSUM

Entity = FSUM, ENTNUM = 0 (or blank)
*GET, Par, FSUM, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ITEMLabValue of item Lab from last FSUM command. Valid labels are FX, FY, FZ, MX, MY, MZ, FLOW, HEAT, FLUX, etc.

Table 175:  *GET Postprocessing Items, Entity = GSRESULT

Entity = GSRESULT, ENTNUM = 0 (or blank) for generalized plane strain results in fiber direction
*GET, Par, GSRESULT, 0, Item1, IT1NUM
Item1IT1NUMDescription
LFIBER Fiber length change at ending point.
ROTX,YRotation angle of end plane about X or Y axis.
F Reaction force at ending point.
MX,YReaction moment on ending plane.

Table 176:  *GET Postprocessing Items, Entity = INTSRF

Entity = INTSRF, ENTNUM = 0 (or blank)
*GET, Par, INTSRF, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
PRESLabValue of item Lab from last INTSRF,PRES command. Valid labels are FX, FY, FZ, MX, MY, and MZ.
TAUWLabValue of item Lab from last INTSRF,TAUW command. Valid labels are FX, FY, FZ, MX, MY, and MZ.

Table 177:  *GET Postprocessing Items, Entity = KCALC

Entity = KCALC, ENTNUM = 0 (or blank)
*GET, Par, KCALC, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
K1, 2, 3Value of KI, KII, or KIII stress intensity factor from last KCALC command.

Table 178:  *GET Postprocessing Items, Entity = NODE

Entity = NODE, ENTNUM = N (node number) for nodal degree of freedom results:
*GET, Par, NODE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
UX, Y, Z, SUMX, Y, or Z structural displacement or vector sum. Alternative get functions: UX(N), UY(N), UZ(N).
ROTX, Y, Z, SUMX, Y, or Z structural rotation or vector sum. Alternative get functions: ROTX(N), ROTY(N), ROTZ(N).
TEMP Temperature. For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, use TBOT, TE2, TE3, . . ., TTOP instead of TEMP. Alternative get functions: TEMP(N), TBOT(N), TE2(N), etc.
PRES Pressure. Alternative get function: PRES(N).
VOLT Electric potential. Alternative get function: VOLT(N).
CONC Concentration.
MAG Magnetic scalar potential. Alternative get function: MAG(N).
VX, Y, Z, SUMX, Y, or Z fluid velocity or vector sum in a fluid analysis. X, Y, or Z nodal velocity or vector sum in a structural transient analysis (LS-DYNA analysis or analysis with ANTYPE,TRANS). Alternative get functions: VX(N), VY(N), VZ(N).
AX, Y, Z, SUMX, Y, or Z magnetic vector potential or vector sum in an electromagnetic analysis. X, Y, or Z nodal acceleration or vector sum in a structural transient analysis (LS-DYNA analysis or analysis with ANTYPE,TRANS). Alternative get functions: AX(N), AY(N), AZ(N).
CURR Current.
EMF Electromotive force drop.
RFFX, FY, FZ, MX, MY, MZ, CSGX, CSGY, CSGZ, BMOM, RATE, DVOL, FLOW, HEAT, AMPS or CHRG, FLUX, CURT, VLTGNodal reaction forces in the nodal coordinate system.  The reaction forces returned are the total forces: static, plus damping, plus inertial, as appropriate based on analysis type (see PRRSOL command). The first exception is modal analyses and mode-superposition transient analyses where static forces are returned. The second exception is spectrum analyses where the PRRFOR logic is used internally. In this case, the reaction forces are based on the type of force requested (using ForceType with combination commands, such as SRSS, PSDCOM, etc.).
ORBTA, B, PSI, PHI, YMAX, ZMAX

Whirl orbit characteristics:

A is the semi-major axis.
B is the semi-minor axis.
PSI is the angle between the local axis y and the major axis Y.
PHI is the angle between initial position (t = 0) and major axis.
YMAX is the maximum displacement along local y axis.
ZMAX is the maximum displacement along local z axis.

Angles PSI and PHI are in degrees and within the range of -180 through +180.

Orbits are available only after issuing a PRORB command.

Note:  This command should be used very carefully when N represents an internal node because the nodal DOFs may have different physical meanings.

Entity = NODE, ENTNUM = N (node number) for averaged nodal results based on selected elements:
*GET, Par, NODE, N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
SX, Y, Z, XY, YZ, XZComponent stress.
1, 2, 3Principal stress.
INT, EQVStress intensity or equivalent stress.
MAXFMaximum stress failure criterion.
TWSITsai-Wu strength failure criterion.
TWSRInverse of Tsai-Wu strength ratio index failure criterion.
EPTOX, Y, Z, XY, YZ, XZ,Component total strain (EPEL + EPPL + EPCR).
1, 2, 3Principal total strain.
INT, EQVTotal strain intensity or total equivalent strain.
EPELX, Y, Z, XY, YZ, XZComponent elastic strain.
1, 2, 3Principal elastic strain.
INT, EQVElastic strain intensity or elastic equivalent strain.
MAXFMaximum strain failure criterion.
EPPLX, Y, Z, XY, YZ, XZComponent plastic strain.
1, 2, 3Principal plastic strain.
INT, EQVPlastic strain intensity or plastic equivalent strain.
EPCRX, Y, Z, XY, YZ, XZComponent creep strain.
1, 2, 3Principal creep strain.
INT, EQVCreep strain intensity or creep equivalent strain.
CDMDMGDamage variable
LMMaximum previous strain energy for virgin material
GKSX, XY, XZGasket component stress.
GKDX, XY, XZGasket component total closure.
GKDIX, XY, XZGasket component total inelastic closure.
GKTHX, XY, XZGasket component thermal closure.
EPTHX, Y, Z, XY, YZ, XZComponent thermal strain.
1, 2, 3Principal thermal strain.
INT, EQVThermal strain intensity or thermal equivalent strain.
EPSW Swelling strain.
FAILMAXMaximum of all failure criterion defined for this node.
EMAXMaximum Strain failure criterion.
SMAXMaximum Stress failure criterion.
TWSITsai-Wu Failure Criterion Strength Index failure criterion.
TWSRInverse of Tsai-Wu Strength Ratio Index failure criterion.
USR1, USR2, ..., USR9User-defined failure criteria.
HFIBHashin Fiber Failure Criterion.
HMATHashin Matrix Failure Criterion.
PFIBPuck Fiber Failure Criterion.
PMATPuck Matrix Failure Criterion.
L3FBLaRc03 Fiber Failure Criterion.
L3MTLaRc03 Matrix Failure Criterion.
L4FBLaRc04 Fiber Failure Criterion.
L4MTLaRc04 Matrix Failure Criterion.
NLSEPLEquivalent stress (from stress-strain curve).
SRATStress state ratio.
HPRESHydrostatic pressure.
EPEQAccumulated equivalent plastic strain.
PSVPlastic state variable or plastic work/volume.
PLWKPlastic work/volume.
TGX, Y, Z, SUMComponent thermal gradient and sum.
TFX, Y, Z, SUMComponent thermal flux and sum.
PGX, Y, Z, SUMComponent pressure gradient and sum.
EFX, Y, Z, SUMComponent electric field and sum.
DX, Y, Z, SUMComponent electric flux density and sum.
HX, Y, Z, SUMComponent magnetic field intensity and sum.
BX, Y, Z, SUMComponent magnetic flux density and 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 force and sum.
HSX, Y, ZComponent magnetic field intensity from current sources (in the global Cartesian coordinate system).
BFETEMPBody temperatures (calculated from applied temperatures) as used in solution.
FICTTEMPFictive temperature.
PMSVVRAT, PPRE, DSAT, RPERVoid volume ratio, pore pressure, degree of saturation, and relative permeability for coupled pore-pressure CPT elements.

Element nodal results are the average nodal value of the selected elements.


Table 179:  *GET Postprocessing Items, Entity = PATH

Entity = PATH, ENTNUM = 0 (or blank)
*GET, Par, PATH, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MAXLabMaximum value of path item Lab from last path operation. Valid labels are the user-defined labels on the PDEF or PCALC command.
MAXPATH Returns the maximum path number defined.
MINLabMinimum value of path item Lab from last path operation. Valid labels are the user-defined labels on the PDEF or PCALC command.
LASTLabLast value of path item Lab from last path operation. Valid labels are the user-defined labels on the PDEF or PCALC command.
NODE Value providing the number of nodes defining the path referenced in the last path operation.
ITEMLabItem2 = PATHPT, IT2NUM = n The value of Lab at the nth data point from the last path operation.
POINTnItem2 = X,Y,Z, or CSYS. Returns information about the nth point on the current path.
NVAL The number of path data points (the length of the data table) from the last path operation.
SETnItem2 = NAME. Returns the name of the nth data set on the current path.
NUMPATH Returns the number of paths defined.
Entity = PATH, ENTNUM = n (path number)
Item1IT1NUMDescription
NAME Returns the name of the nth path.
Entity = PATH, ENTNUM = 0 (or blank)
*GET,Par,KCALC,0,...
K1, 2, 3Value of KI, KII, or KIII stress intensity factor from last KCALC command.

Table 180:  *GET Postprocessing Items, Entity = PLNSOL

Entity = PLNSOL, ENTNUM = 0 (or blank)
*GET, Par, PLNSOL, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MAX Maximum value of item in last contour display [PLNSOL, PLESOL].
MIN Minimum value of item in last contour display [PLNSOL, PLESOL].
BMAX Maximum bound value of item in last contour display [PLNSOL, PLESOL].
BMIN Minimum bound value of item in last contour display [PLNSOL, PLESOL].

Table 181:  *GET Postprocessing Items, Entity = PRERR

Entity = PRERR, ENTNUM = 0 (or blank)
*GET, Par, PRERR, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
SEPC[1] Structural percent error in energy norm [PRERR].
TEPC[1] Thermal percent error in energy norm [PRERR].
SERSM[1] Structural error energy summation [PRERR].
TERSM[1] Thermal error energy summation [PRERR].
SENSM[1] Structural energy summation [PRERR].
TENSM[1] Thermal energy summation [PRERR].

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

Table 182:  *GET Postprocessing Items, Entity = RAD

Entity = RAD, ENTNUM = 0 (or blank)
*GET, Par, RAD, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
VFAVG Value of the average view factor computed from the previous VFQUERY command.
Entity = RAD, ENTNUM = n (enclosure number)
*GET, Par, RAD, n, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NETHF Value of the net heat rate lost by an enclosure.

Table 183:  *GET Postprocessing Items, Entity = RSTMAC

Note:  Available after RSTMAC command is issued.

Entity = RSTMAC, ENTNUM= N (solution number on File1)
*GET, Par, RSTMAC, 0 or N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NS1 

Total number of solutions (modes for example) read on File1. See Sbstep1 on the RSTMAC command. This value is the maximum value for N.

NS2 

Total number of solutions (modes for example) read on File2. See Sbstep2 on the RSTMAC command. This value is the maximum value for M

MACM

Modal assurance criterion value (MAC) between the solution N read on File1 and the solution M read on File2.

Note:  N and M do not correspond to the substep (or mode) numbers if NS1 and NS2 are different from the total number of substeps (or modes).


Table 184:  *GET Postprocessing Items, Entity = SECR

Entity = SECR, ENTNUM = n (element number)  

For beam and pipe (including elbow) section results, return values for all elements

if the element number (n) is blank or ALL.

*GET, Par, SECR, n, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescriptionItem2IT2NUM
S X, Y, Z, XY, YZ, XZ Component total stress

MAX – Returns maximum

MIN – Returns minimum

MAXY – Returns section Y location of maximum

MAXZ – Returns section Z location of maximum

MINY – Returns section Y location of minimum

MINZ – Returns section Z location of minimum

IVAL – Returns value at node or integration point at element I node

JVAL – Returns value at node or integration point at element J node

KVAL – Returns value at node or integration point at element K node (ELBOW290)

---

For IVAL, JVAL, and KVAL: The ALL (or blank) option for the element number is not valid. You must specify an element (n).

These values are applicable only when Item2 = IVAL, JVAL, or KVAL:

When KEYOPT(15) = 0, this value is the section node number.

When KEYOPT(15) = 1 (or when using elbow elements), this value is the integration point number.

1, 2, 3 Principal stress value
INTStress intensity value
EQVEquivalent stress value
EPTOX, Y, Z, XY, YZ, XZ Component total strain
1, 2, 3Principal total strain value
INTTotal strain intensity value
EQVEquivalent total strain value
EPELX, Y, Z, XY, YZ, XZ Component elastic strain
1, 2, 3Principal elastic strain value
INTElastic strain intensity value
EQVEquivalent elastic strain value
EPTHX, Y, Z, XY, YZ, XZ Component thermal strain
1, 2, 3Principal thermal strain value
INTThermal strain intensity value
EQVEquivalent thermal strain value
EPPLX, Y, Z, XY, YZ, XZ Component plastic strain
1, 2, 3Principal plastic strain value
INTPlastic strain intensity value
EQVEquivalent plastic strain value
EPCRX, Y, Z, XY, YZ, XZ Component creep strain
1, 2, 3Principal component creep strain value
INTComponent creep strain intensity value
EQVEquivalent component creep strain value
EPTTX, Y, Z, XY, YZ, XZ Component total mechanical and thermal and swelling strain
1, 2, 3Principal total mechanical and thermal and swelling strain value
INTTotal mechanical and thermal and swelling strain intensity value
EQVEquivalent total mechanical and thermal and swelling strain value
EPDIX, Y, Z, XY, YZ, XZ Component diffusion strain
1, 2, 3Principal diffusion strain value
INTDiffusion strain intensity value
EQVEquivalent diffusion strain value
NLSEPLPlastic yield stress
SRATPlastic yielding (1 = actively yielding, 0 = not yielding)
HPRESHydrostatic pressure
EPEQAccumulated equivalent plastic strain
CREQAccumulated equivalent creep strain
PLWKPlastic work/volume
YSIDXTENS,SHEAYield surface activity status: 1 for yielded and 0 for not yielded.
FPIDXTF01,SF01, TF02,SF02, TF03,SF03, TF04,SF04Failure plane surface activity status: 1 for yielded and 0 for not yielded. Tension and Shear failure status are available for all four sets of failure planes.

Table 185:  *GET Postprocessing Items, Entity = SECTION

Entity = SECTION,ENTNUM = component (listed below).

Generate data for section stress results, using PRSECT before retrieving these items. Valid labels for ENTNUM are MEMBRANE, BENDING, SUM (Membrane+Bending) , PEAK, and TOTAL. (The following items are not stored in the database and the values returned reflect the last quantities generated by PRSECT or PLSECT.) Only MEMBRANE, BENDING, and SUM data are available after a PLSECT command. The MEMBRANE label is only valid with Item1 = INSIDE.

*GET, Par, SECTION, component, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMItem2Description
INSIDESX, Y, Z, XY, YZ, XZStress component at beginning of path.
1, 2, 3Principal stress at beginning of path.
INT, EQVStress intensity or equivalent stress at beginning of path.
CENTERSX, Y, Z, XY, YZ, XZStress component at midpoint of path.
1, 2, 3Principal stress at midpoint of path.
INT, EQVStress intensity or equivalent stress at midpoint of path.
OUTSIDESX, Y, Z, XY, YZ, XZStress component at end of path.
1, 2, 3Principal stress at end of path.
INT, EQVStress intensity or equivalent stress at end of path.

Table 186:  *GET Postprocessing Items, Entity = SORT

Entity = SORT, ENTNUM = 0 (or blank)
*GET, Par, SORT, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
MAX Maximum value of last sorted item (NSORT or ESORT command).
MIN Minimum value of last sorted item (NSORT or ESORT command).
IMAX Node/Element number where maximum value occurs.
IMIN Node/Element number where minimum value occurs.

Table 187:  *GET Postprocessing Items, Entity = SSUM

Entity = SSUM, ENTNUM = 0 (or blank)
*GET, Par, SSUM, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
ITEMLabValue of item Lab from last SSUM command. Valid labels are the user-defined labels on the ETABLE command.

Table 188:  *GET Postprocessing Items, Entity = VARI

Entity = VARI, ENTNUM = N (variable number after POST26 data storage) (for complex values, only the real part is returned with Item1 = EXTREM)
*GET,Par,VARI,N, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
EXTREMVMAXMaximum extreme value.
TMAXTime or frequency corresponding to VMAX.
VMINMinimum extreme value.
TMINTime or frequency corresponding to VMIN.
VLASTLast value.
TLASTTime or frequency corresponding to VLAST.
CVARCovariance
REALfReal part of variable N at time or frequency f.
IMAGfImaginary part of variable N at frequency f.
AMPLfAmplitude value of variable N at frequency f
PHASEfPhase angle value of variable N at frequency f
RSETSnumReal part of variable N at location Snum.
ISETSnumImaginary part of variable N at location Snum.
Entity = VARI, ENTNUM = 0 (or blank) (after POST26 data storage)
*GET,Par,VARI,0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
NSETS Number of data sets stored.

Table 189:  *GET Postprocessing Items, Entity = ACUS

Entity = ACUS, ENTNUM = 0 (or blank)

*GET, Par, ACUS, 0, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMDescription
PWL Radiated sound power level
PRES Far-field pressure at a given point
PHASE Far-field pressure phase at a given point
SPL Far-field sound pressure level at a given point
SPLA Far-field a-weighted sound pressure level at a given point
DG Far-field directivity at a given point
PS Far-field scattered pressure at a given point
TS Far-field target strength at a given point
DFIN Diffuse sound field incident power
SIMP Magnitude of specific acoustic impedance on the selected surface
AIMP Magnitude of acoustic impedance on the selected surface
MIMP Magnitude of mechanical impedance on the selected surface
APRES Magnitude of average pressure on the selected surface
FORC Magnitude of average force on the selected surface
POWER Acoustic power through the selected surface
BSPL SPL over frequency band
BSPA A-weighted SPL over frequency band
PWRF Reference sound power

Item1 = PRES, SPL PHASE, DG, PS, and TS are available after issuing the corresponding PRFAR/PLFAR command at a defined point (PHI2 = PHI1 and THETA2 = THETA1).The values are obtained at the current frequency, or at the last frequency for multiple load step and substep cases.

Item1 = SIMP, AIMP, MIMP, APRES, FORC, and POWER are available after issuing the corresponding PRAS command at the current frequency. The values are obtained at the current frequency, or at the last frequency for multiple load step and substep cases.

Item1 = DFIN is available after the diffuse sound field solution.


Table 190:  *GET Postprocessing Items, Entity = CYCCALC

Entity = CYCCALC, ENTNUM = CYCSPEC specification number

Generate date for cyclic results using CYCCALC before retrieving those items.

*GET,Par,CYCCALC,spec, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMItem2IT2NUMDescription
FREQfrequency pointSECTORsectorCYCSPEC result at the IT1NUM frequency and IT2NUM sector
SECMAX-CYCSPEC maximum result at the IT1NUM frequency
SECNUM-CYCSPEC sector with the maximum result at the IT1NUM frequency
SECNODE-CYCSPEC node in the sector with the maximum result at the IT1NUM frequency
The frequency point refers to the harmonic solution data set number (NSET on the SET command)

Table 191:  *GET Postprocessing Items, Entity = XFEM

Entity = XFEM, ENTNUM = 0 (or blank)
*GET, Par, XFEM, 0, Item1, IT1NUM
Item1IT1NUMDescription
STATElement NumberStatus of the element: 0 = uncracked, 1 = cracked
Entity = XFEM, ENTNUM = NODE
*GET, Par, XFEM, NODE, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMItem2IT2NUMDescription
ELEMElement NumberPOS (or blank)

1-4 (for 2-D elements)

1-8 (for SOLID185)

Node number at position IT2NUM of cracked element
Entity = XFEM, ENTNUM = PHI
*GET, Par, XFEM, PHI, Item1, IT1NUM, Item2, IT2NUM
Item1IT1NUMItem2IT2NUMDescription
ELEMElement NumberNODENode NumberLSM Phi value for this node number of this element

Menu Paths

Utility Menu>Parameters>Get Scalar Data

Release 18.2 - © ANSYS, Inc. All rights reserved.