vfun#
- Mapdl.vfun(parr='', func='', par1='', con1='', con2='', con3='', **kwargs)#
Performs a function on a single array parameter.
APDL Command:
*VFUN
- Parameters:
- parr
The name of the resulting numeric array parameter vector. See
*SET
for name restrictions.- func
Function to be performed:
ACOS Arccosine:
ACOS(Par1)
.ASIN
Arcsine:ASIN(Par1)
.ASORT
Par1
is sorted in ascending order.*VCOL
,*VMASK
,*VCUM
, and*VLEN,,NINC
do not apply.*VLEN,NROW
does apply.ATAN
Arctangent:ATAN(Par1)
COMP
Compress: Selectively compresses data set. “True” (*VMASK
) values ofPar1
(or row positions to be considered according to theNINC
value on the*VLEN
command) are written in compressed form toParR
, starting at the specified position.COPY
Copy:Par1
copied toParR
.COS
Cosine:COS(Par1)
.COSH
Hyperbolic cosine:COSH(Par1)
.DIRCOS
Direction cosines of the principal stresses (nX9).Par1
contains the nX6 component stresses for then
locations of the calculations.DSORT
Par1
is sorted in descending order.*VCOL
,*VMASK
,*VCUM
, and*VLEN,,NINC
do not apply.*VLEN,NROW
does apply.EURLER
Euler angles of the principal stresses (nX3).Par1
contains the nX6 component stresses for then
locations of the calculations.EXP
Exponential:EXP(Par1)
.EXPA
Expand: Reverse of the COMP function. All elements ofPar1
(starting at the position specified) are written in expanded form to corresponding “true” (*VMASK
) positions (or row positions to be considered according to theNINC
value on the*VLEN
command) ofParR
.LOG
Natural logarithm:LOG(Par1)
.LOG10
Common logarithm:LOG10(Par1)
.NINT
Nearest integer: 2.783 becomes 3.0, -1.75 becomes -2.0.NOT
Logical complement: values 0.0 (false) become 1.0 (true). Values > 0.0 (true) become 0.0 (false).PRIN
Principal stresses (nX5).Par1
contains thenX6
component stresses for then
locations of the calculations.PWR
Power function:Par1**CON1
. Exponentiation of any negative number in the vectorPar1
to a non-integer power is performed by exponentiating the positive number and prepending the minus sign. For example,-4**2.3
is-(4**2.3)
.SIN
Sine:SIN(Par1)
SINH
Hyperbolic sine:SINH(Par1)
.SQRT
Square root:SQRT(Par1)
.TAN
Tangent:TAN(Par1)
.TANH
Hyperbolic tangent:TANH(Par1)
.TANG
Tangent to a path at a point: the slope at a point is determined by linear interpolation half way between the previous and next points. Points are assumed to be in the global Cartesian coordinate system. Path points are specified in arrayPar1
(having 3 consecutive columns of data, with the columns containing thex
,y
, andz
coordinate locations, respectively, of the points). Only the starting row index and the column index for the x coordinates are specified, such asA(1,1)
. The y and z coordinates of the vector are assumed to begin in the corresponding next columns, such asA(1,2)
andA(1,3)
. The tangent result,ParR
, must also have 3 consecutive columns of data and will contain the tangent direction vector (normalized to 1.0); such as 1,0,0 for an x-direction vector.NORM
Normal to a path and an input vector at a point: determined from the cross-product of the calculated tangent vector (seeTANG
) and the input direction vector (with thei
,j
, andk
components input asCON1
,CON2
, andCON3
). Points are assumed to be in the global Cartesian coordinate system. Path points are specified in arrayPar1
(having 3 consecutive columns of data, with the columns containing thex
,y
, andz
coordinate locations, respectively, of the points). Only the starting row index and the column index for thex
coordinates are specified, such asA(1,1)
. They
andz
coordinates of the vector are assumed to begin in the corresponding next columns, such asA(1,2)
andA(1,3)
. The normal result,ParR
, must also have 3 consecutive columns of data and will contain the normal direction vector (normalized to 1.0); such as1,0,0
for an x-direction vectorLOCAL
Transforms global Cartesian coordinates of a point to the coordinates of a specified system: points to be transformed are specified in arrayPar1
(having 3 consecutive columns of data, with the columns containing thex
,y
, andz
global Cartesian coordinate locations, respectively, of the points). Only the starting row index and the column index for thex
coordinates are specified, such asA(1,1)
. The y and z coordinates of the vector are assumed to begin in the corresponding next columns, such asA(1,2)
andA(1,3)
. Results are transformed to coordinate systemCON1
(which may be any valid coordinate system number, such as 1,2,11,12, etc.). The transformed result,ParR
, must also have 3 consecutive columns of data and will contain the corresponding transformed coordinate locations.GLOBAL
Transforms specified coordinates of a point to global Cartesian coordinates: points to be transformed are specified in arrayPar1
(having 3 consecutive columns of data, with the columns containing the local coordinate locations (x
,y
,z
orr
,θ
,z
or etc.) of the points). Only the starting row index and the column index for the x coordinates are specified, such asA(1,1)
. The y and z coordinates (orθ
andz
, or etc.) of the vector are assumed to begin in the corresponding next columns, such asA(1,2)
andA(1,3)
. Local coordinate locations are assumed to be in coordinate systemCON1
(which may be any valid coordinate system number, such as 1,2,11,12, etc.). The transformed result,ParR
, must also have 3 consecutive columns of data, with the columns containing the global Cartesianx
, y, and z coordinate locations, respectively.
- par1
Array parameter vector in the operation.
- con1, con2, con3
Constants (used only with the PWR, NORM, LOCAL, and GLOBAL functions).
Notes
Operates on one input array parameter vector and produces one output array parameter vector according to:
ParR = f(Par1)