NAG Library Routine Document

f06tff  (zmcopy)

 Contents

    1  Purpose
    7  Accuracy
    10  Example

1
Purpose

f06tff performs the matrix-copy operation
BA  
where A and B are m by n complex general or trapezoidal matrices.

2
Specification

Fortran Interface
Subroutine f06tff ( matrix, m, n, a, lda, b, ldb)
Integer, Intent (In):: m, n, lda, ldb
Complex (Kind=nag_wp), Intent (In):: a(lda,*)
Complex (Kind=nag_wp), Intent (Inout):: b(ldb,*)
Character (1), Intent (In):: matrix
C Header Interface
#include nagmk26.h
void  f06tff_ ( const char *matrix, const Integer *m, const Integer *n, const Complex a[], const Integer *lda, Complex b[], const Integer *ldb, const Charlen length_matrix)

3
Description

None.

4
References

None.

5
Arguments

1:     matrix – Character(1)Input
On entry: the matrix type.
matrix='G'
General matrix.
matrix='U'
Upper trapezoidal matrix (upper triangular if m=n).
matrix='L'
Lower trapezoidal matrix (lower triangular if m=n).
Constraint: matrix='G', 'U' or 'L'.
2:     m – IntegerInput
On entry: m, the number of rows of the matrices A and B.
Constraint: m0.
3:     n – IntegerInput
On entry: n, the number of columns of the matrices A and B.
Constraint: n0.
4:     alda* – Complex (Kind=nag_wp) arrayInput
Note: the second dimension of the array a must be at least n.
On entry: the m by n general or trapezoidal matrix A.
  • If matrix='U', A is upper trapezoidal and the elements of the array below the diagonal are not referenced.
  • If matrix='L', A is lower trapezoidal and the elements of the array above the diagonal are not referenced.
5:     lda – IntegerInput
On entry: the first dimension of the array a as declared in the (sub)program from which f06tff is called.
Constraint: lda max1,m .
6:     bldb* – Complex (Kind=nag_wp) arrayOutput
Note: the second dimension of the array b must be at least n.
On exit: the m by n general or trapezoidal matrix B.
  • If matrix='U', B is upper trapezoidal and the elements of the array below the diagonal are not referenced.
  • If matrix='L', B is lower trapezoidal and the elements of the array above the diagonal are not referenced.
7:     ldb – IntegerInput
On entry: the first dimension of the array b as declared in the (sub)program from which f06tff is called.
Constraint: ldb max1,m .

6
Error Indicators and Warnings

None.

7
Accuracy

Not applicable.

8
Parallelism and Performance

f06tff is not threaded in any implementation.

9
Further Comments

None.

10
Example

None.
© The Numerical Algorithms Group Ltd, Oxford, UK. 2017