Download Read the User`s Guide - BeBOP (Berkeley Benchmarking and

Transcript
B.2
Vector object creation
45
Example:
See Listing 1 on page 9.
B.2
Vector object creation
oski vecview t
oski CreateVecView( oski value t∗ x, oski index t length,
oski index t inc );
Creates a valid view on a single dense column vector x.
Parameters:
length [input]
Number of vector elements.
length ≥0
inc [input]
inc > 0
Stride, or distance in the user’s dense array, between logically consecutive elements of x. Specifying
STRIDE UNIT is the same as setting inc = 1.
x [input]
x 6= NULL
A pointer to the user’s dense array representation of the vector x. Element xi of the logical vector
x, for all 1 ≤ i ≤length, lies at position x[(i−1)∗inc].
Actions and Returns:
Returns a valid vector view object for x, or INVALID VEC on error.
Error conditions and actions:
An error occurs if any of the argument preconditions are not satisfied [ERR BAD ARG].
Example:
See Listing 1 on page 9.
oski vecview t
oski CreateMultiVecView( oski value t∗ X,
oski index t length, oski index t num vecs,
oski storage t orient, oski index t lead dim );
Creates a view on k dense column vectors X = x1 · · · xk , stored as a submatrix in the user’s data.
Parameters:
length [input]
Number of elements in each column vector.
num vecs [input]
The number of column vectors, i.e., k as shown above.
length ≥0
num vecs ≥0
orient [input]
Specifies whether the multivector is stored in row-major (LAYOUT ROWMAJ) or column-major
(LAYOUT COLMAJ) order.
lead dim [input]
lead dim ≥0
This parameter specifies the leading dimension, as specified in the BLAS standard. The leading
dimension is the distance in X between the first element of each row vector, and must be at least