Man page - lartgp(3)

Packages contains this manual

Package: liblapack-doc
apt-get install liblapack-doc

Manuals in package:

Documentations in package:

Manual

lartgp

NAME
SYNOPSIS
Functions
Detailed Description
Function Documentation
subroutine dlartgp (double precision f, double precision g, doubleprecision cs, double precision sn, double precision r)
subroutine slartgp (real f, real g, real cs, real sn, real r)
Author

NAME

lartgp - lartgp: generate plane rotation, more accurate than BLAS rot

SYNOPSIS

Functions

subroutine dlartgp (f, g, cs, sn, r)
DLARTGP generates a plane rotation so that the diagonal is nonnegative.
subroutine slartgp (f, g, cs, sn, r)
SLARTGP generates a plane rotation so that the diagonal is nonnegative.

Detailed Description

Function Documentation

subroutine dlartgp (double precision f, double precision g, doubleprecision cs, double precision sn, double precision r)

DLARTGP generates a plane rotation so that the diagonal is nonnegative.

Purpose:

DLARTGP generates a plane rotation so that

[ CS SN ] . [ F ] = [ R ] where CS**2 + SN**2 = 1.
[ -SN CS ] [ G ] [ 0 ]

This is a slower, more accurate version of the Level 1 BLAS routine DROTG,
with the following other differences:
F and G are unchanged on return.
If G=0, then CS=(+/-)1 and SN=0.
If F=0 and (G .ne. 0), then CS=0 and SN=(+/-)1.

The sign is chosen so that R >= 0.

Parameters

F is DOUBLE PRECISION
The first component of vector to be rotated.

G is DOUBLE PRECISION
The second component of vector to be rotated.

CS is DOUBLE PRECISION
The cosine of the rotation.

SN is DOUBLE PRECISION
The sine of the rotation.

R is DOUBLE PRECISION
The nonzero component of the rotated vector.

This version has a few statements commented out for thread safety
(machine parameters are computed on each entry). 10 feb 03, SJH.

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

subroutine slartgp (real f, real g, real cs, real sn, real r)

SLARTGP generates a plane rotation so that the diagonal is nonnegative.

Purpose:

SLARTGP generates a plane rotation so that

[ CS SN ] . [ F ] = [ R ] where CS**2 + SN**2 = 1.
[ -SN CS ] [ G ] [ 0 ]

This is a slower, more accurate version of the Level 1 BLAS routine SROTG,
with the following other differences:
F and G are unchanged on return.
If G=0, then CS=(+/-)1 and SN=0.
If F=0 and (G .ne. 0), then CS=0 and SN=(+/-)1.

The sign is chosen so that R >= 0.

Parameters

F is REAL
The first component of vector to be rotated.

G is REAL
The second component of vector to be rotated.

CS is REAL
The cosine of the rotation.

SN is REAL
The sine of the rotation.

R is REAL
The nonzero component of the rotated vector.