*VEC

*VEC, Vector, Type, Method, Val1, Val2, Val3, Val4, Val5
Creates a vector.

Valid Products: Pro | Premium | Enterprise | PrepPost | Solver | AS add-on

Argument Descriptions

Vector

Name used to identify the vector. Must be specified.

Type

Vector type:

D -- 

Double precision real values (default).

Z -- 

Complex double precision values.

I -- 

Integer values.

Method

Method used to create the vector:

ALLOC -- 

Allocate space for a vector (default).

RESIZE -- 

Resize an existing vector to a new length. Values are kept from the original vector. If the length specified by Val1 is greater than the original vector length, the additional rows are assigned a value of zero.

COPY -- 

Copy an existing vector.

IMPORT -- 

Import the vector from a file.

LINK -- 

Link to a column of an existing dense *DMAT matrix and use it in subsequent vector calculations. Any changes to the vector are also made to the corresponding matrix column (memory is shared).

Val1, Val2, Val3, Val4, Val5

Additional input. The meaning of Val1 through Val5 will vary depending on the specified Method. See details below.

The following Valx field is used with Method = ALLOC or Method = RESIZE:

Val1

Number of rows in the vector.

The following Valx field is used with Method = COPY:

Val1

Name of the vector to copy.

Val2

Optional argument to specify either the real or the imaginary part of the values to be copied. This option only applies when copying a complex value vector to a real value vector.

REAL

Copy the real part of the vector to the output vector.

IMAG

Copy the imaginary part of the vector to the output vector.

The following table describes the Valx fields used with Method = IMPORT.

Method = IMPORT
Val1Val2Val3Val4Val5Description
FULLFile name [a]
RHS - Load vector
GVEC - Constraint equation constant terms
BACK - nodal mapping vector (internal to user)
FORWARD - nodal mapping vector (user to internal)
(not used)(not used)Import a load vector or nodal mapping vector from an existing FULL file.
MODEFile name [a]Mode number(not used)(not used)Import a mode from an existing MODE file.
RSTFile name [a]Data set number(not used)

Result Type:

NSL - Nodal Solution
VSL - Transient velocity solution
ASL - Transient acceleration solution
RF - Reaction Forces
Import degree of freedom results from an existing RST file.
RFRQFile name [a]

FRQ - Frequencies of the modal analysis

DSP - reduced complex displacement

-

Iteration number

(not used)

Import the vector of frequencies of the modal analysis.

Import a reduced complex displacement, at a given iteration number.

ANSFile name [a]Loc - Location in the FileBase - base pointer(not used)Import a record in an Ansys File, specifying its location. If Base is not 0, Loc is a relative value from this base pointer.
DMIGFile name [a]

- Separator character (default=blank)

- or ‘F’ means formatted file (see *DMAT command notes)

if Val3 == 'F', length of the fields.

(not used)Import a vector (typically a load vector) from an existing Nastran DMIG file.
SUBFile name [a]RHS - Load vector(not used)(not used)Import a load vector from an existing SUB file.
EMATFile name [a]RHS - Load vectorElement number(not used)Import an element load vector from an existing EMAT file.
MATFile name [a](not used)(not used)(not used)Restore from a previous *EXPORT (FORMAT = MAT) command.
APDLArray parameter name (not used)(not used)(not used)Import an existing array parameter.
HBMATFile name [a]File format:
ASCII
BINARY
(not used)(not used)Import a load vector from an existing Harwell-Boeing format file.

[a] File name is case-sensitive with a 32-character maximum.

The following Valx fields are used with Method = LINK:

Val1

Name of the *DMAT matrix.

Val2

Column number of the matrix to link to.

Notes

Use the *DMAT command to create a matrix.

For more information on the BACK and FORWARD nodal mapping vectors, see Degree of Freedom Ordering in the Ansys Parametric Design Language Guide.

Menu Paths

This command cannot be accessed from a menu.