Module 2 Array Parameters 2. Array Parameters Training Manual • They can be 1-D, 2-D, or 3-D. – 1-D: m rows x 1 column – 2-D: m rows x n columns – 3-D: m rows x n columns x k planes 17.1 -47.6 AA = -5.2 25.0 107.9 5x1 array BB = 814 17 1057 -47 1033 -52 7141 25 622 107 386 704 348 -66 111 5x3 array CC = mxnx3 array INTRODUCTION TO ANSYS 6.0 - Part 2 • Array Parameters are parameters that can take on multiple values. October 30, 2001 Inventory #001571 2-2 ...Array Parameters Training Manual • Topics covered: A. Types of Array Parameters B. How to Define C. Retrieving Database Information D. Array Operations E. Workshop INTRODUCTION TO ANSYS 6.0 - Part 2 • In this chapter, we will discuss how to define array parameters and how to perform operations among them. October 30, 2001 Inventory #001571 2-3 Array Parameters A. Types of Array Parameters Training Manual – Array – Table – Character • Type array is a standard 1-D, 2-D, or 3-D matrix of numeric values, such as BB shown here. – BB(2,3) = 704 – BB(3,1) = 1033 – etc. BB = 814 1057 1033 7141 622 17 -47 -52 25 107 386 704 348 -66 111 5x3 array INTRODUCTION TO ANSYS 6.0 - Part 2 • There are three types of array parameters: October 30, 2001 Inventory #001571 2-4 Array Parameters ...Types of Array Parameters – Requires the “zeroth” row, column, and plane to be filled with numbers. – Useful to define time-dependent loads and other similar functions. – Primary variables include X, Y, Z, temperature, velocity, pressure and time. – For example, the table array FORCE could represent a force-vs-time function, with the zeroth column representing time values. • FORCE(0.4) = 279.9996 • FORCE(6.5) = 560.0 • FORCE(8.9) = 119.25 • etc. INTRODUCTION TO ANSYS 6.0 - Part 2 • Type table is similar to array, except that its row, column, and plane indices can be real numbers, allowing you to interpolate values. Training Manual October 30, 2001 Inventory #001571 2-5 Array Parameters ...Types of Array Parameters Training Manual – Useful for storing file names, DOF labels, etc. – Each string can have up to eight characters. JOB1 JOB2 jobs = JOB3 JOB4 JOB5 UX UY dofs = UZ ROTY ROTZ INTRODUCTION TO ANSYS 6.0 - Part 2 • A character array is a 1-D, 2-D, or 3-D matrix of alphanumeric strings. October 30, 2001 Inventory #001571 2-6 Array Parameters B. How to Define 1. Specify name, type and dimension. – Utility Menu > Parameters > Array Parameters > Define/Edit > Add – or *DIM command. Example: *dim,aa,array,4 ! 4x1x1 array *dim,force,table,5 ! 5x1x1 table *dim,bb,array,5,3 ! 5x3x1 array *dim,dofs,char,6 ! 6x1x1 character array – parameter name can not exceed 32 characters INTRODUCTION TO ANSYS 6.0 - Part 2 Two steps to define an array parameter: Training Manual October 30, 2001 Inventory #001571 2-7 Array Parameters ...How to Define – Utility Menu > Parameters > Array Parameters > Define/Edit > Edit – Or *VEDIT command – Or “=”command. Example: bb(1,1)=11,21,31,41,51 bb(1,2)=12,22,32,42,52 bb(1,3)=13,23,33,43,53 INTRODUCTION TO ANSYS 6.0 - Part 2 2. Fill in the array values. Training Manual October 30, 2001 Inventory #001571 2-8 Array Parameters ...How to Define – For example: force(1,1)=0,560,560,238.5,0 force(1,0)=1E-6,0.8,7.2,8.5,9.3 force(0,1)=0 INTRODUCTION TO ANSYS 6.0 - Part 2 • For table type arrays, you must fill in values for the zeroth locations. Otherwise, their values will default to the “tiny” number 7.8886E-31. Training Manual October 30, 2001 Inventory #001571 2-9 Array Parameters ...How to Define – Use the “=”command to type in the values, then use *STAT to list them. – Each string must be enclosed in single quotes. – Example: dofs(1) = ‘ux’, ‘uy’, ‘uz’, ‘rotx’, ‘roty’, ‘rotz’ *stat,dofs INTRODUCTION TO ANSYS 6.0 - Part 2 • For character arrays, there is no graphical way to fill in the strings. Training Manual October 30, 2001 Inventory #001571 2-10 Array Parameters ...How to Define – Predefined functions in *VFILL command (Utility Menu > Parameters > Array Parameters > Fill) • ramp function • random function • etc. – Read data from a file: • *VREAD for arrays • *TREAD for tables • Or Utility Menu > Parameters > Read from File – Retrieve data from the database (discussed next). INTRODUCTION TO ANSYS 6.0 - Part 2 • There are many other ways to fill arrays: Training Manual October 30, 2001 Inventory #001571 2-11 Array Parameters C. Retrieving Database Information Training Manual – Or Utility Menu > Parameters > Get Array Data • First dimension the array, then retrieve the data. • Example: *dim,dispval,array,20,3 ! 20x3 array *vget,dispval(1,1),node,1,u,x ! UX of nodes 1-20 in column 1 *vget,dispval(1,2),node,1,u,y ! UY in column 2 *vget,dispval(1,3),node,1,u,z ! UZ in column 3 INTRODUCTION TO ANSYS 6.0 - Part 2 • Just as *GET retrieves scalar data from the database, you can use *VGET to retrieve array information. October 30, 2001 Inventory #001571 2-12 Array Parameters …Retrieving Database Information Training Manual – nodal and keypoint coordinates (in the active CSYS) – attributes of elements, volumes, areas, etc. – select status of entities (1 if selected, 0 if not selected) – nodal stresses, strains, thermal gradients, thermal flux, etc. – element table data – and so on… INTRODUCTION TO ANSYS 6.0 - Part 2 • Other types of array information you can retrieve: October 30, 2001 Inventory #001571 2-13 Array Parameters D. Array Operations Training Manual – Utility Menu > Parameters > Array Operations – Or *VFUN, *VOPER, *VSCFUN, *VWRITE, etc. INTRODUCTION TO ANSYS 6.0 - Part 2 • Once you have defined array parameters, you can perform a variety of operations among them. October 30, 2001 Inventory #001571 2-14 Array Parameters ...Array Operations *VFUN operates on a single array parameter. – *vfun,b(1),sin,a(1) will result in b(j)=sin(a(j)) – Other operations include: • natural log, common log, exponential • Square root, sort, copy • Conversion from local to global coordinates and vice-versa • Tangent and normal vectors to a path • etc. INTRODUCTION TO ANSYS 6.0 - Part 2 • Training Manual October 30, 2001 Inventory #001571 2-15 Array Parameters ...Array Operations *VOPER operates on two array parameters. – *voper,c(1),a(1),sub,b(1) will result in c(k)=a(k)-b(k) – Other operations include: • addition, subtraction, multiplication, division • min, max, logical operations • derivatives, integrals • dot and cross products INTRODUCTION TO ANSYS 6.0 - Part 2 • Training Manual October 30, 2001 Inventory #001571 2-16 Array Parameters ...Array Operations *VSCFUN determines properties of an array parameter. – *vscfun,maxval,max,a(1) will result in a scalar parameter maxval = max(a(i)) – Other operations include: • sum of all the elements of an array • statistical quantities such as mean, median, standard deviation, variance and rms • min/max, index location of min/max • index locations of first and last non-zero entry INTRODUCTION TO ANSYS 6.0 - Part 2 • Training Manual October 30, 2001 Inventory #001571 2-17 Array Parameters ...Array Operations *VWRITE writes data to a file in a formatted sequence. – Utility Menu > Parameters > Array Parameters > Write to File – Example: *cfopen,wing,dat *vwrite (/,3x,’Node Number’,4x,’Temperature’,/) *vwrite,nnum(1),tval(1) (5x,f6.0,6x,e14.8) *cfclose will create a file called wing.dat with the nnum and tval arrays written in specified format. INTRODUCTION TO ANSYS 6.0 - Part 2 • Training Manual October 30, 2001 Inventory #001571 2-18 Array Parameters ...Array Operations Training Manual • Please refer to your APDL Programmer’s Guide for details. INTRODUCTION TO ANSYS 6.0 - Part 2 • There are many, many more array operations available. October 30, 2001 Inventory #001571 2-19 Array Parameters E. Workshop Training Manual W1. Axisymmetric Wheel INTRODUCTION TO ANSYS 6.0 - Part 2 • Refer to your Workshop Supplement for instructions on: October 30, 2001 Inventory #001571 2-20
