tb_add_i(3PI) Sun Interval Performance Library tb_add_i(3PI)NAMEtb_add_i - Triangular band matrix add and scale.
DESCRIPTION
C = ALPHA * A + BETA * B
The routine TB_ADD_I scales triangular band interval matrices A and B
and stores the sum in the interval matrix C. This routine returns imme‐
diately if N is equal to zero or K is less than zero.
SYNOPSIS
SUBROUTINE TB_ADD_I( A, B, C [, UPLO] [, DIAG] [, ALPHA] [, BETA] )
INTERVAL, INTENT(IN) :: A(:,:), B(:,:)
INTERVAL, INTENT(OUT) :: C(:,:)
INTERVAL, INTENT(IN), OPTIONAL :: ALPHA, BETA
TYPE(blas_uplo_type), INTENT(IN), OPTIONAL :: UPLO
TYPE(blas_diag_type), INTENT(IN), OPTIONAL :: DIAG
where
assuming A, B and C all triangular matrices with the same shape (K+1,N)
where K = band width.
ARGUMENTS
A (input)
On entry, A is array of DIMENSION (K+1,N)
where K = band width.
Unchanged on exit.
B (input)
On entry, B is array of DIMENSION (K+1,N)
where K = band width.
Unchanged on exit.
C (output)
C is array of DIMENSION (K+1,N)
where K = band width.
On exit, C = ALPHA * A + BETA * B
ALPHA (input)
On entry, ALPHA specifies the scalar ALPHA.
Default value is ALPHA = [1,1].
Unchanged on exit.
BETA (input)
On entry, BETA specifies the scalar BETA.
Default value is BETA = [0,0].
Unchanged on exit.
UPLO(input)
Scalar element.
Specifies if the matrix operand is an upper or
lower tringular part of the matrix.
Possible values:
UPLO = blas_upper (default)
UPLO = blas_lower
Unchanged on exit.
DIAG (input)
Scalar element.
Specifies whether or not the matrix operand
has unit diagonal entries.
Possible values:
DIAG = blas_non_unit_diag (default)
DIAG = blas_unit_diag
Unchanged on exit.
ERRORS
blas_error_alloc
A, B or C is unallocated array
blas_error_shape
shape(A) /= shape(B) /= shape(C)
6 Mar 2009 tb_add_i(3PI)