Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

SGER(3dxml)  —  Subroutines

Name

sger, dger, cgerc, zgerc, cgeru, zgeru − Rank-one update of a general matrix

FORMAT

{S,D}GER (m, n, alpha, x, incx, y, incy, a, lda) {C,Z}GER{C,U} (m, n, alpha, x, incx, y, incy, a, lda)

Arguments

minteger∗4
On entry, the number of rows of the matrix A; m >= 0.
On exit, m is unchanged. 

ninteger∗4
On entry, the number of columns of the matrix A; n >= 0.
On exit, n is unchanged. 

alphareal∗4 | real∗8 | complex∗8 | complex∗16
On entry, the scalar alpha∗.
On exit, alpha is unchanged. 

xreal∗4 | real∗8 | complex∗8 | complex∗16
On entry, a one-dimensional array X of length at least (1+(m-1)∗|incx|).  Array X contains the vector x.
On exit, x is unchanged. 

incxinteger∗4
On entry, the increment for the elements of X; incx must not equal zero.
On exit, incx is unchanged. 

yreal∗4 | real∗8 | complex∗8 | complex∗16
On entry, a one-dimensional array of length at least (1+(n-1)∗|incy|).  The incremented array Y must contain the vector y.
On exit, y is unchanged. 

incyinteger∗4
On entry, the increment for the elements of Y; incy must not equal zero.
On exit, incy is unchanged. 

areal∗4 | real∗8 | complex∗8 | complex∗16
On entry, a two-dimensional array with dimensions lda by n. The leading m by n part of the array contains the elements of the matrix A.
On exit, a is overwritten by the updated matrix. 

ldainteger∗4
On entry, the first dimension of A; lda >= MAX(1,m).
On exit, lda is unchanged. 

Description

SGER and DGER perform a rank-one update of a real general matrix: A  = alpha∗x∗transp(y) + A

CGERU and ZGERU perform a rank-one update of an unconjugated complex general matrix: A  = alpha∗x∗transp(y) + A

CGERC and ZGERC perform a rank-one update of a conjugated complex general matrix: A  = alpha∗x∗conjug_transp(y) + A

alphais a scalar, x is an m-element vector, y is an n-element vector, and A is an m by n matrix. 

EXAMPLES

REAL∗4 A(10,10), X(10), Y(5), alpha
INCX = 1
INCY = 1
LDA = 10
M = 3
N = 4
alpha = 2.3
CALL SGER(M,N,alpha,X,INCX,Y,INCY,A,LDA)

This FORTRAN code computes the rank-1 update A  =  alpha∗x∗transp(y)
 + A.  Only the upper left submatrix of A, of dimension (3,4) and starting at location A(1,1), is updated.

COMPLEX∗8 A(10,10), X(10), Y(5), alpha
INCX = 1
INCY = 1
LDA = 10
M = 3
N = 4
alpha = (2.3, 1.2)
CALL CGERC(M,N,alpha,X,INCX,Y,INCY,A,LDA)

This FORTRAN code computes the rank-1 update A  =  alpha∗x∗conjug_transp(y) + A. Only the upper left submatrix of A, of dimension (3,4) and starting at location A(1,1), is updated.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026