ANSYS内嵌函数总汇.doc

1、ANSYS 内嵌函数总汇Appendix B. GET Function SummaryA “get function“ is available for some items, and can be used instead of the *GET command. The function returns the value and uses it where the function is input (bypassing the need for storing the value with a parameter name and inputting the parameter na

2、me where the value is to be used). For example, assume the average X-location of two nodes is to be calculated. Using the *GET command, parameter L1 can be assigned the X location of node 1 (*GET, L1, NODE, 1, LOC, X), and parameter L2 can be assigned the X location of node 2, then the mid location

3、can be computed from MID = (L1+L2)/2. However, using the node location “get function“ NX(N), which returns the X location of node N, MID can be computed directly from MID = (NX(1)+NX(2)/2, without the need for intermediate parameters L1 and L2. Get functions return values in the active coordinate sy

4、stem unless stated otherwise. Get function arguments may themselves be parameters or other get functions. The get function NELEM(ENUM,NPOS) returns the node number in position NPOS for element ENUM. Combining functions, NX(NELEM(ENUM,NPOS) returns the X location of that node. Get functions (where av

5、ailable) are shown with the corresponding *GET items in the tables below and are summarized at the end of this command description. Get functions are described at the beginning of this command (see “Notes“) and are shown as alternatives to the *GET items where they apply. They are summarized here (g

6、rouped by functionality) for convenience. Table B.1 *GET - Get Function Summary“Get Function“ Summary Entity Status Get Function DescriptionNSEL(N) Status of node N: -1=unselected, 0=undefined, 1=selected.ESEL(E) Status of element E: -1=unselected, 0=undefined, 1=selected.KSEL(K) Status of keypoint

7、K: -1=unselected, 0=undefined, 1=selected.LSEL(L) Status of line L: -1=unselected, 0=undefined, 1=selected.ASEL(A) Status of area A: -1=unselected, 0=undefined, 1=selected.VSEL(V) Status of volume V: -1=unselected, “Get Function“ Summary Entity Status Get Function Description0=undefined, 1=selected.

8、Next Selected EntityNDNEXT(N) Next selected node having a node number greater than N.ELNEXT(E) Next selected element having an element number greater than E.KPNEXT(K) Next selected keypoint having a keypoint number greater than K. LSNEXT(L) Next selected line having a line number greater than L.ARNE

9、XT(A) Next selected area having an area number greater than A.VLNEXT(V) Next selected volume having a volume number greater than V.LocationsCENTRX(E) Centroid X-coordinate of element E in global Cartesian coordinate system. Centroid is determined from the selected nodes on the element.CENTRY(E) Cent

10、roid Y-coordinate of element E in global Cartesian coordinate system. Centroid is determined from the selected nodes on the element.CENTRZ(E) Centroid Z-coordinate of element E in global Cartesian coordinate system. Centroid is determined from the selected nodes on the element.NX(N) X-coordinate of

11、node N in the active coordinate system.NY(N) Y-coordinate of node N in the active coordinate system.NZ(N) Z-coordinate of node N in the active coordinate system.KX(K) X-coordinate of keypoint K in the active coordinate systemKY(K) Y-coordinate of keypoint K in the active coordinate systemKZ(K) Z-coo

12、rdinate of keypoint K in the active coordinate systemLX(L,LFRAC) X-coordinate of line L at length fraction “Get Function“ Summary Entity Status Get Function DescriptionLFRAC (0.0 to 1.0).LY(L,LFRAC) Y-coordinate of line L at length fraction LFRAC (0.0 to 1.0).LZ(L,LFRAC) Z-coordinate of line L at le

13、ngth fraction LFRAC (0.0 to 1.0).LSX(L,LFRAC) X slope of line L at length fraction LFRAC (0.0 to 1.0).LSY(L,LFRAC) Y slope of line L at length fraction LFRAC (0.0 to 1.0).LSZ(L,LFRAC) Z slope of line L at length fraction LFRAC (0.0 to 1.0).Nearest to LocationNODE(X,Y,Z) Number of the selected node n

14、earest the X,Y,Z point (in the active coordinate system, lowest number for coincident nodes).KP(X,Y,Z) Number of the selected keypoint nearest the X,Y,Z point (in the active coordinate system, lowest number for coincident nodes).DistancesDISTND(N1,N2) Distance between nodes N1 and N2.DISTKP(K1,K2) D

15、istance between keypoints K1 and K2.DISTEN(E,N) Distance between the centroid of element E and node N. Centroid is determined from the selected nodes on the element.Angles (in radians by default - see the *AFUN command)ANGLEN(N1,N2,N3) Subtended angle between two lines (defined by three nodes where

16、N1 is the vertex node). Default is in radians.ANGLEK(K1,K2,K3) Subtended angle between two lines (defined by three keypoints where K1 is the vertex keypoint). Default is in radians.Nearest to EntityNNEAR(N) Selected node nearest node N.KNEAR(K) Selected keypoint nearest keypoint K.ENEARN(N) Selected

17、 element nearest node N. The element position is calculated from the selected nodes.AreasAREAND(N1,N2,N3) Area of the triangle with vertices at nodes N1, N2, and N3.AREAKP(K1,K2,K3) Area of the triangle with vertices at keypoints “Get Function“ Summary Entity Status Get Function DescriptionK1, K2, a

18、nd K3.ARNODE(N) Area at node N apportioned from selected elements attached to node N. For 2-D planar solids, returns edge area associated with the node. For axisymmetric solids, returns edge surface area associated with the node. For 3-D volumetric solids, returns face area associated with the node.

19、 For 3D, select all the nodes of the surface of interest before using ARNODE.NormalsNORMNX(N1,N2,N3) X-direction cosine of the normal to the plane containing nodes N1, N2, and N3.NORMNY(N1,N2,N3) Y-direction cosine of the normal to the plane containing nodes N1, N2, and N3.NORMNZ(N1,N2,N3) Z-directi

20、on cosine of the normal to the plane containing nodes N1, N2, and N3.NORMKX(K1,K2,K3) X-direction cosine of the normal to the plane containing keypoints K1, K2, and K3.NORMKY(K1,K2,K3) Y-direction cosine of the normal to the plane containing keypoints K1, K2, and K3.NORMKZ(K1,K2,K3) Z-direction cosi

21、ne of the normal to the plane containing keypoints K1, K2, and K3.ConnectivityENEXTN(N,LOC) Element connected to node N. LOC is the position in the resulting list when many elements share the node. A zero is returned at the end of the list.NELEM(E,NPOS) Node number in position NPOS (1-20) of element

22、 E.NODEDOF(N) Returns the bit pattern for the active DOFs at the specified node. bit 0 is UX, bit 1 is UY,. bit 5 is ROTZbits 6,7,8 are AX,AY,AZbits 9,10,11 are VX,VY,VZbit 18 is PRES, bit 19 is TEMP, bit 20 is VOLT, bit 21 is MAGbit 24 is EMF, bit 25 is CURRFor a node with UX,UY,UZ the return value

23、 will be 7 (bits 0,1,2)For a node with “Get Function“ Summary Entity Status Get Function DescriptionUX,UY,UZ,ROTX,ROTY,ROTZ the return value will be 63 (bits 0,1,2,3,4,5)FacesELADJ(E,FACE) For 2-D planar solids and 3-D volumetric solids, element adjacent to a face (FACE) of element E. The face numbe

24、r is the same as the surface load key number. Only elements of the same dimensionality and shape are considered. A -1 is returned if more than one is adjacent. NDFACE(E,FACE,LOC) Node in position LOC of a face number FACE of element E. The face number is the same as the surface load key number. LOC

25、is the nodal position on the face (for an IJLK face, LOC=1 is at node I, 2 is at node J, etc.)NMFACE(E) Face number of element E containing the selected nodes. The face number output is the surface load key. If multiple load keys occur on a face (such as for line and area elements) the lowest load k

26、ey for that face is output.ARFACE(E) For 2-D planar solids and 3-D volumetric solids, returns the area of the face of element E containing the selected nodes. For axisymmetric elements, the area is the full (360 degree) area.Degree of Freedom ResultsUX(N) UX structural displacement at node N.UY(N) U

27、Y structural displacement at node N.UZ(N) UZ structural displacement at node N.ROTX(N) ROTX structural rotation at node N.ROTY(N) ROTY structural rotation at node N.ROTZ(N) ROTZ structural rotation at node N.TEMP(N) Temperature at node N. For SHELL131 and SHELL132 elements with KEYOPT(3) = 0 or 1, u

28、se TBOT(N), TE2(N), TE3(N), . . ., TTOP(N) instead of TEMP(N).PRES(N) Pressure at node N.VX(N) VX fluid velocity at node N.VY(N) VY fluid velocity at node N.VZ(N) VZ fluid velocity at node N.ENKE(N) Turbulent kinetic energy (FLOTRAN) at node “Get Function“ Summary Entity Status Get Function Descript

29、ionN.ENDS(N) Turbulent energy dissipation (FLOTRAN) at node N.VOLT(N) Electric potential at node N.MAG(N) Magnetic scalar potential at node N.AX(N) AX magnetic vector potential at node N.AY(N) AY magnetic vector potential at node N.AZ(N) AZ magnetic vector potential at node N.Returns information abo

30、ut the data base managerVIRTINQR(1) Number of pages in core.VIRTINQR(4) Page size in integer words.VIRTINQR(7) Maximum number of pages allowed on disk.VIRTINQR(8) Number of read/write operations on page.VIRTINQR(9) Maximum record number on page.VIRTINQR(11) Maximum pages touched.Returns the current

31、value of ANSYS filtering keywords.KWGET(KEYWORD) Returns the current value the keyword specified by KEYWORD. See the ANSYS UIDL Programmers Guide for a list of keywords and values.Character String Functions Strings must be dimensioned (see *DIM) as a character parameter or enclosed in single apostro

32、phes (char). Functions which return a double precision value of a numeric character string. VALCHR(a8) a8 is a decimal value expressed in a string. VALOCT (a8) a8 is an octal value expressed in a string. VALHEX(a8) a8 is a hex value expressed in a string.Functions which return an 8 character string

33、of a numeric value. CHRVAL (dp) dp is a double precision variable. CHROCT (dp) dp is an integer value. CHRHEX(dp) dp is an integer value. Functions which manipulate strings: StrOut is the output string (or character parameter) Str1 and Str2 are input strings. Strings are a maximum of 128 characters.

34、 (see *DIM)StrOut = STRSUB(Str1, nLoc,nChar) Get the nChar substring starting at character nLoc in Str1. StrOut = STRCAT(Str1,Str2) Add Str2 at the end of Str1.StrOut = STRFILL(Str1,Str2,nLoc) Add Str2 to Str1 starting at character nLoc. StrOut = STRCOMP(Str1) Remove all blanks from Str1“Get Functio

35、n“ Summary Entity Status Get Function DescriptionStrOut = STRLEFT(Str1) Left-justify Str1nLoc = STRPOS(Str1,Str2) Get starting location of Str2 in Str1. nLoc = STRLENG(Str1) Location of last nonblank characterStrOut = UPCASE(Str1) Upper case of Str1StrOut = LWCASE(Str1) Lower case of Str1The followi

36、ng functions manipulate file names.Path String = JOIN (directory,filename,extension) Produces a contiguous pathstring. e.g. directory/filename.extPath String = JOIN (directory,filename)Produces a contiguous pathstring. e.g. directory/filenameSPLIT(PathString, DIR) Produces a separate output of the d

37、irectory from the pathstring. SPLIT(PathString, FILE) Produces a separate output of the complete filename (with extension) from the pathstring. SPLIT(PathString, NAME) Produces a separate output of the filename from the pathstring. SPLIT(PathString, EXT) Produces a separate output of the file extension from the pathstring.