rot(3)

📦
version 3.12.1 · 9 versions
, in arch rolling

🌸 NAME 🌸

rot — rot: apply plane rotation ([cz]rot in LAPACK).

okay so this is the rot(3) page from the Library Functions Manual, and yes bestie, it is literally the whole plane-rotation squad. 💅

✨ SYNOPSIS ✨

Functions

  • subroutine csrot (n, cx, incx, cy, incy, c, s) — CSROT
  • subroutine drot (n, dx, incx, dy, incy, c, s) — DROT
  • subroutine srot (n, sx, incx, sy, incy, c, s) — SROT
  • subroutine zdrot (n, zx, incx, zy, incy, c, s) — ZDROT
  • subroutine crot (n, cx, incx, cy, incy, c, s) — CROT applies a plane rotation with real cosine and complex sine to a pair of complex vectors.
  • subroutine zrot (n, cx, incx, cy, incy, c, s) — ZROT applies a plane rotation with real cosine and complex sine to a pair of complex vectors.

🦋 Detailed Description 🦋

This section is literally just a heading in the original — no extra lore, no side quest, nothing. The real content is right below under Function Documentation. Slay for minimalism, I guess. 💀

👑 Function Documentation 👑

crot — complex vectors, real cos, complex sin 💫

subroutine crot (integer n, complex, dimension( * ) cx, integer incx,
    complex, dimension( * ) cy, integer incy, real c, complex s)

CROT applies a plane rotation with real cosine and complex sine to a pair of complex vectors.

Purpose

CROT applies a plane rotation, where the cos (C) is real and the sin (S) is complex, and the vectors CX and CY are complex. 🌀

Parameters

  • N — is INTEGER. The number of elements in the vectors CX and CY.
  • CX — is COMPLEX array, dimension (N). On input, the vector X. On output, CX is overwritten with C*X + S*Y.
  • INCX — is INTEGER. The increment between successive values of CX. INCX <> 0.
  • CY — is COMPLEX array, dimension (N). On input, the vector Y. On output, CY is overwritten with -CONJG(S)*X + C*Y.
  • INCY — is INTEGER. The increment between successive values of CY. INCX <> 0.
  • C — is REAL.
  • S — is COMPLEX. C and S define a rotation:
[  C          S  ]
[ -conjg(S)   C  ]

where C*C + S*CONJG(S) = 1.0.

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 102 of file crot.f.

csrot — real cos and sin on complex vectors 🍓

subroutine csrot (integer n, complex, dimension( * ) cx, integer incx,
    complex, dimension( * ) cy, integer incy, real c, real s)

CSROT

Purpose

CSROT applies a plane rotation, where the cos and sin (c and s) are real and the vectors cx and cy are complex. jack dongarra, linpack, 3/11/78. ✨

Parameters

  • N — is INTEGER. On entry, N specifies the order of the vectors cx and cy. N must be at least zero.
  • CX — is COMPLEX array, dimension at least ( 1 + ( N - 1 )*abs( INCX ) ). Before entry, the incremented array CX must contain the n element vector cx. On exit, CX is overwritten by the updated vector cx.
  • INCX — is INTEGER. On entry, INCX specifies the increment for the elements of CX. INCX must not be zero.
  • CY — is COMPLEX array, dimension at least ( 1 + ( N - 1 )*abs( INCY ) ). Before entry, the incremented array CY must contain the n element vector cy. On exit, CY is overwritten by the updated vector cy.
  • INCY — is INTEGER. On entry, INCY specifies the increment for the elements of CY. INCY must not be zero.
  • C — is REAL. On entry, C specifies the cosine, cos.
  • S — is REAL. On entry, S specifies the sine, sin.

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 97 of file csrot.f.

drot — double-precision plane rotation 🔥

subroutine drot (integer n, double precision, dimension(*) dx, integer incx,
    double precision, dimension(*) dy, integer incy, double precision c,
    double precision s)

DROT

Purpose

DROT applies a plane rotation. 🎀

Parameters

  • N — is INTEGER. number of elements in input vector(s)
  • DX — is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
  • INCX — is INTEGER. storage spacing between elements of DX
  • DY — is DOUBLE PRECISION array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
  • INCY — is INTEGER. storage spacing between elements of DY
  • C — is DOUBLE PRECISION
  • S — is DOUBLE PRECISION

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Further Details

jack dongarra, linpack, 3/11/78.

modified 12/3/93, array(1) declarations changed to array(*)

Definition at line 91 of file drot.f.

srot — single-precision plane rotation 🌈

subroutine srot (integer n, real, dimension(*) sx, integer incx, real,
    dimension(*) sy, integer incy, real c, real s)

SROT

Purpose

SROT applies a plane rotation. ⭐

Parameters

  • N — is INTEGER. number of elements in input vector(s)
  • SX — is REAL array, dimension ( 1 + ( N - 1 )*abs( INCX ) )
  • INCX — is INTEGER. storage spacing between elements of SX
  • SY — is REAL array, dimension ( 1 + ( N - 1 )*abs( INCY ) )
  • INCY — is INTEGER. storage spacing between elements of SY
  • C — is REAL
  • S — is REAL

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Further Details

jack dongarra, linpack, 3/11/78.

modified 12/3/93, array(1) declarations changed to array(*)

Definition at line 91 of file srot.f.

zdrot — double-complex vectors, real cos and sin 🧚

subroutine zdrot (integer n, complex*16, dimension( * ) zx, integer incx,
    complex*16, dimension( * ) zy, integer incy, double precision c, double
    precision s)

ZDROT

Purpose

Applies a plane rotation, where the cos and sin (c and s) are real and the vectors cx and cy are complex. jack dongarra, linpack, 3/11/78. 💜

Parameters

  • N — is INTEGER. On entry, N specifies the order of the vectors cx and cy. N must be at least zero.
  • ZX — is COMPLEX*16 array, dimension at least ( 1 + ( N - 1 )*abs( INCX ) ). Before entry, the incremented array ZX must contain the n element vector cx. On exit, ZX is overwritten by the updated vector cx.
  • INCX — is INTEGER. On entry, INCX specifies the increment for the elements of ZX. INCX must not be zero.
  • ZY — is COMPLEX*16 array, dimension at least ( 1 + ( N - 1 )*abs( INCY ) ). Before entry, the incremented array ZY must contain the n element vector cy. On exit, ZY is overwritten by the updated vector cy.
  • INCY — is INTEGER. On entry, INCY specifies the increment for the elements of ZY. INCY must not be zero.
  • C — is DOUBLE PRECISION. On entry, C specifies the cosine, cos.
  • S — is DOUBLE PRECISION. On entry, S specifies the sine, sin.

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 97 of file zdrot.f.

zrot — double-complex vectors with real cos and complex sin 💎

subroutine zrot (integer n, complex*16, dimension( * ) cx, integer incx,
    complex*16, dimension( * ) cy, integer incy, double precision c,
    complex*16 s)

ZROT applies a plane rotation with real cosine and complex sine to a pair of complex vectors.

Purpose

ZROT applies a plane rotation, where the cos (C) is real and the sin (S) is complex, and the vectors CX and CY are complex. 🌀

Parameters

  • N — is INTEGER. The number of elements in the vectors CX and CY.
  • CX — is COMPLEX*16 array, dimension (N). On input, the vector X. On output, CX is overwritten with C*X + S*Y.
  • INCX — is INTEGER. The increment between successive values of CX. INCX <> 0.
  • CY — is COMPLEX*16 array, dimension (N). On input, the vector Y. On output, CY is overwritten with -CONJG(S)*X + C*Y.
  • INCY — is INTEGER. The increment between successive values of CY. INCX <> 0.
  • C — is DOUBLE PRECISION.
  • S — is COMPLEX*16. C and S define a rotation:
[  C          S  ]
[ -conjg(S)   C  ]

where C*C + S*CONJG(S) = 1.0.

Author

Univ. of Tennessee

Univ. of California Berkeley

Univ. of Colorado Denver

NAG Ltd.

Definition at line 102 of file zrot.f.

💖 Author 💖

Generated automatically by Doxygen for LAPACK from the source code.

that's the whole page, bestie 💅 LAPACK Version 3.12.0 — rot(3) — go rotate something safely, ily 🌈🫶

📦 where this page comes from