naginterfaces.library.blast.ddot

naginterfaces.library.blast.ddot(conj, alpha, x, beta, y, r)[source]

ddot updates a scalar by a scaled dot product of two real vectors.

For full information please refer to the NAG Library document for f16ea

https://www.nag.com/numeric/nl/nagdoc_27.3/flhtml/f16/f16eaf.html

Parameters
conjint

is not referenced and need not be set. The presence of this argument in the BLAST standard is for consistency with the interface of the complex variant of this function.

alphafloat

The scalar .

xfloat, array-like, shape

The -element vector .

If , must be stored in , for .

If or , is not referenced.

betafloat

The scalar .

yfloat, array-like, shape

The -element vector .

If , must be stored in , for .

If , must be stored in , for .

Intermediate elements of are not referenced.

If or , is not referenced.

rfloat

The initial value, , to be updated. If , need not be set on entry.

Returns
rfloat

The value , scaled by and updated by the scaled dot product of and .

Raises
NagValueError
(errno )

On entry, error in parameter .

Constraint: .

(errno )

On entry, error in parameter .

Constraint: .

Notes

ddot performs the operation

where and are -element real vectors, and , and real scalars. If is less than zero, or, if is equal to one and either or is equal to zero, this function returns immediately.

References

Basic Linear Algebra Subprograms Technical (BLAST) Forum, 2001, Basic Linear Algebra Subprograms Technical (BLAST) Forum Standard, University of Tennessee, Knoxville, Tennessee, https://www.netlib.org/blas/blast-forum/blas-report.pdf