vlen#
- Mapdl.vlen(nrow='', ninc='', **kwargs)#
Specifies the number of rows to be used in array parameter operations.
APDL Command:
*VLEN
- Parameters:
- nrow
Number of rows to be used with the
*VXX
or*MXX
operations. Defaults to the number of rows needed to fill the result array.- ninc
Perform the operation on every NINC row (defaults to 1).
Notes
Specifies the number of rows to be used in array parameter operations. The size of the submatrix used is determined from the upper left starting array element (defined on the operation command) to the lower right array element (defined by the number of rows on this command and the number of columns on the
*VCOL
command).NINC
allows skipping row operations for some operation commands. Skipped rows are included in the row count. The starting row number must be defined on the operation command for each parameter read and for the result written.The default
NROW
is calculated from the maximum number of rows of the result array (the*DIM
row dimension) minus the starting location + 1. For example,*DIM,R,,10
and a starting location ofR(7)
gives a default of 4 loops (fillingR(7)
,R(8)
,R(9)
, andR(10)
). Repeat operations automatically terminate at the last row of the result array. Existing values in the rows and columns of the results matrix remain unchanged where not overwritten by the requested input or operation values.The stride (
NINC
) allows operations to be performed at regular intervals. It has no effect on the total number of row operations. Skipped operations retain the previous result. For example,*DIM,R,,6,
with a starting location ofR(1)
,NROW = 10
, andNINC = 2
calculates values for locationsR(1)
,R(3)
, andR(5)
and retains values for locationsR(2)
,R(4)
, andR(6)
. A more general skip control may be done by masking[*VMASK]
. The row control settings are reset to the defaults after each*VXX
or*MXX
operation. Use*VSTAT
to list settings.This command is valid in any processor.