1: $a (mn)$ – double array: The elements of the $m$ by $n$ matrix $A$ , stored by columns.
2: $m$ – int64int32nag_int scalar: $m$ , the number of rows of the matrix $A$ .
3: $n$ – int64int32nag_int scalar: $n$ , the number of columns of the matrix $A$ .

Optional Input Parameters

1: $mn$ – int64int32nag_int scalar: Default: the dimension of the array a.
$n$ , the value $m \times n$ .

Output Parameters

1: $a (mn)$ – double array: The elements of the transpose matrix, also stored by columns.
2: $ifail$ – int64int32nag_int scalar: $ifail = 0$ unless the function detects an error (see Error Indicators and Warnings).

Error Indicators and Warnings

Errors or warnings detected by the function:

$ifail = 1$

On entry,

mn \neq m \times n

$ifail = 2$

On entry,

lmove \leq 0

$ifail < 0$: A serious error has occurred. Check all function calls and array sizes. Seek expert help.

$ifail = - 99$: An unexpected error has been triggered by this routine. Please contact NAG.

$ifail = - 399$: Your licence key may have expired or may not have been installed correctly.

$ifail = - 999$: Dynamic memory allocation failed.

Accuracy

Exact results are produced.

Further Comments

The time taken by nag_matop_real_gen_trans_inplace (f01cr) is approximately proportional to

m n

Example

This example transposes a

7

3

matrix and prints out, for convenience, its transpose.

Open in the MATLAB editor: f01cr_example

function f01cr_example


fprintf('f01cr example results\n\n');

a = [ 1    2    3    4    5    6    7;
      8    9   10   11   12   13   14;
     15   16   17   18   19   20   21];
[m,n] = size(a);

[atrans, ifail] = f01cr(a, int64(m), int64(n));

atrans = reshape(atrans,[n,m]);
disp('Transpose of A');
disp(atrans);

f01cr example results

Transpose of A
     1     8    15
     2     9    16
     3    10    17
     4    11    18
     5    12    19
     6    13    20
     7    14    21

PDF version (NAG web site, 64-bit version, 64-bit version)

Chapter Contents

Chapter Introduction

NAG Toolbox