Functions & parameters (*FUNCTION only)

Functions & parameters (*FUNCTION only)

The following functions are only supported by the command FUNCTION.

Function / parameter Description
crv(cid,x) Returns the ordinata of curve cid at abscissa x
dist_surf(xn,yn,zn) Distance to material surface (see examples at FUNCTION_STATIC)
dmg Damage
dnorm Spring elongation in CONNECTOR_SPRING
dt Current time step size
epsp Effective plastic strain
epsp_part(pid, 0) Largest effective plastic strain in part pid
epsp_part(pid, 1) x-coordinate of integration point with largest effective plastic strain in part pid
epsp_part(pid, 2) y-coordinate of integration point with largest effective plastic strain in part pid
epsp_part(pid, 3) z-coordinate of integration point with largest effective plastic strain in part pid
eint Specific internal energy
fxc(cid) Total contact force in x-direction in contact interface cid
fyc(cid) Total contact force in y-direction in contact interface cid
fzc(cid) Total contact force in z-direction in contact interface cid
fc(cid) Total contact force in contact interface cid
fxr(bcid) Reaction force in x-direction in *BC_MOTION definition bcid
fyr(bcid) Reaction force in y-direction in *BC_MOTION definition bcid
fzr(bcid) Reaction force in z-direction in *BC_MOTION definition bcid
fr(bcid) Total reaction force force in *BC_MOTION definition bcid
txr(bcid) Torque around x-axis in *BC_MOTION definition bcid
tyr(bcid) Torque around y-axis in *BC_MOTION definition bcid
tzr(bcid) Torque around z-axis in *BC_MOTION definition bcid
tr(bcid) Resultant torque a in *BC_MOTION definition bcid
fxj(jid) Force in x-direction in *RIGID_BODY_JOINT definition jid
fyj(jid) Force in y-direction in *RIGID_BODY_JOINT definition jid
fzj(jid) Force force in z-direction in *RIGID_BODY_JOINT definition jid
txj(jid) Torque around x-axis in *RIGID_BODY_JOINT definition jid
tyj(jid) Torque around y-axis in *RIGID_BODY_JOINT definition jid
tzj(jid) Torque around z-axis in *RIGID_BODY_JOINT definition jid
rxj(jid) Rotation around x-axis in *RIGID_BODY_JOINT definition jid
ryj(jid) Rotation around y-axis in *RIGID_BODY_JOINT definition jid
rzj(jid) Rotation around z-axis in *RIGID_BODY_JOINT definition jid
sxj(jid) Spin around x-axis in *RIGID_BODY_JOINT definition jid
syj(jid) Spin around y-axis in *RIGID_BODY_JOINT definition jid
szj(jid) Spin around z-axis in *RIGID_BODY_JOINT definition jid
pres Contact pressure or hydrostatic pressure in material (LOAD_PRESSURE)
pres_part(pid, 0) Highest pressure in part pid
pres_part(pid, 1) x-coordinate of integration point with highest pressure in part pid
pres_part(pid, 2) y-coordinate of integration point with highest pressure in part pid
pres_part(pid, 3) z-coordinate of integration point with highest pressure in part pid
sigy0 Initial yield stress (can be unique for each integration point if using INITIAL_STATE_WELDSIM)
t Current time
volfs(fsid) Volume enclosed by face set fsid
vol_geo(gid, tol, dir) Volume enclosed by the element faces in geometry gid. tol is an optional dimensionless tolerance. Gaps in the surface will result in errors. If the estimated (relative) error is larger than tol then the function will return a zero. The optional parameter dir is used to avoid the volume calculation in specific global directions (divergence theorem). This is necessary if the control volume is located on symmetry planes. The global x-direction is avoided if dir=1, 4 or 6, the global y-direction is avoided if dir=2,4 or 5 and the global z-direction is avoided if dir = 3,5 or 6.
vol_geo0(gid, tol, dir) Initial volume enclosed by the element faces in geometry gid. The function arguments are the same as for function vol_geo.
vnorm Local velocity in the normal direction to the surface of the structure or rate of elongation in CONNECTOR_SPRING
vtang Relative tangential sliding velocity (for use with CONTACT)
vx Local velocity in x-direction (e.g. velocity of an element face in LOAD_PRESSURE or a node in BC_MOTION)
vy Local velocity in y-direction
vz Local velocity in z-direction
vxn(nid) Velocity in x-direction of node nid
vyn(nid) Velocity in y-direction of node nid
vzn(nid) Velocity in z-direction of node nid
vn(nid) Velocity of node nid
xs(sid) x-coordinate of *OUTPUT_SENSOR sid
ys(sid) y-coordinate of *OUTPUT_SENSOR sid
zs(sid) z-coordinate of *OUTPUT_SENSOR sid
dxs(sid) x-displacement of *OUTPUT_SENSOR sid
dys(sid) y-displacement of *OUTPUT_SENSOR sid
dzs(sid) z-displacement of *OUTPUT_SENSOR sid
vxs(sid) Velocity in x-direction of *OUTPUT_SENSOR sid
vys(sid) Velocity in y-direction of *OUTPUT_SENSOR sid
vzs(sid) Velocity in z-direction of *OUTPUT_SENSOR sid
axs(sid) Acceleration in x-direction of *OUTPUT_SENSOR sid
ays(sid) Acceleration in y-direction of *OUTPUT_SENSOR sid
azs(sid) Acceleration in z-direction of *OUTPUT_SENSOR sid
ps(sid) Pressure of *OUTPUT_SENSOR sid
sig1s(sid) First principal stress of *OUTPUT_SENSOR sid
epsps(sid) Effective plastic strain of *OUTPUT_SENSOR sid
depsps(sid) Effective plastic strain increment of *OUTPUT_SENSOR sid
vxp(pid) Velocity in x-direction of part pid
vyp(pid) Velocity in y-direction of part pid
vzp(pid) Velocity in z-direction of part pid
rxp(pid) Rotation around x-axis of rigid part pid
ryp(pid) Rotation around y-axis of rigid part pid
rzp(pid) Rotation around z-axis of rigid part pid
mpp(pid) Physical mass of part pid
mpa(pid) Non-physical mass added to part pid
wip(pid) Internal energy of part pid
xmaxp(pid, xn, yn, zn) Maximum coordinate of part pid, measured from (0,0,0) in direction (xn,yn,zn)
wkp(pid) Kinetic energy of part pid
x Current x-coordinate (e.g. location of an element face in LOAD_PRESSURE or a node in BC_MOTION)
y Current y-coordinate
z Current z-coordinate
X Initial x-coordinate (e.g. location of an element face in LOAD_PRESSURE or a node in BC_MOTION)
Y Initial y-coordinate
Z Initial z-coordinate
xnorm x-component of local surface normal direction
ynorm y-component of local surface normal direction
znorm z-component of local surface normal direction
xn(nid) x-coordinate of node nid
yn(nid) y-coordinate of node nid
zn(nid) z-coordinate of node nid
smooth_d($d_{max}, t_0, t_1$) Smooth displacement function going from 0 at time $t_0$ to $d_{max}$ at $t_1$
smooth_v($d_{max}, t_0, t_1$) Smooth velocity function that is obtained by differentiating smooth_d with respect to time
smooth_a($d_{max}, t_0, t_1$) Smooth acceleration function that is obtained by differentiating smooth_v with respect to time
mine_dry($m, x, y, z, z_0$) Pressure function that mimics a cylindrical mine buried in dry soil (TNT equivalent mass $m$, height/diameter ratio 1/3, charge center coordinate $(x,y,z)$ and ground surface at coordinate $z_0$)