*VEC

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

APDL: Matrix Operations

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

Val1 Val2 Val3 Val4 Val5 Description

FULL

File 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)

Import a load vector or nodal mapping vector from an existing FULL file.

MODE File name ^[a] Mode number (not used) (not used) Import a mode from an existing MODE file.

RST

File 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.

RFRQ

File 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.

ANS File name ^[a] Loc - Location in the File Base - 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.

DMIG

File 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.

SUB File name ^[a] RHS - Load vector (not used) (not used) Import a load vector from an existing SUB file.

EMAT File name ^[a] RHS - Load vector Element number (not used) Import an element load vector from an existing EMAT file.

MAT File name ^[a] (not used) (not used) (not used) Restore from a previous *EXPORT (FORMAT = MAT) command.

APDL Array parameter name (not used) (not used) (not used) Import an existing array parameter.

HBMAT

File name ^[a]

File format:

ASCII

BINARY

(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.