ML_DGEHRD – Redukce reálné obecné matice A na horní Hessenbergovu formu

Symbol blokuPotřebná licence: MATRIX

Popis funkce
Výstupní reference yA, yTAU a yWORK jsou vždy nastaveny na odpovídající vstupní reference uA, uTAU a uWORK. Pokud HLD = on, pak není provedeno nic jiného, jinak je interně zavolána funkce LAPACK DGEHRD:

DGEHRD(N, ilo, ihi, uA, LDA, uTAU, uWORK, LWORK, info);

kde parametry funkce DGEHRD jsou nastaveny následovně:

N je počet sloupců čtvercové matice referencované uA.
Pokud je vstup ihi $\neq$ 0, pak je ihi nastaveno na ihi, jinak je ihi nastaveno na $N - 1$ .
LDA je hlavní rozměr matice referencované uA.
LWORK je počet prvků vektoru referencovaného uWORK.
info je návratový kód z funkce DGEHRD.

Chybový příznak E je nastaven na on, pokud:

reference uA nebo uTAU nebo uWORK není definována (tj. vstup uA nebo uTAU nebo uWORK není připojen),
matice referencovaná uA není čtvercová,
počet prvků vektoru referencovaný pomocí uTAU je menší než $N - 1$ ,
volání funkce DGEHRD vrátí chybu pomocí funkce XERBLA, viz návratový kód info a systémový log.

Důrazně upozorňujeme, že indexy ilo a ihi začínají od nuly na rozdíl od FORTRAN verze, kde začínají od jedničky. Více informací naleznete v dokumentaci knihovny LAPACK [10] (pouze anglicky).

Tento blok nepropaguje kvalitu signálu. Více informací je uvedeno v sekci 1.4.

Vstup

uA	Vstupní odkaz na matici A	Reference
uTAU	Vstupní reference na vektor skalárních faktorů elementárních reflektorů	Reference
uWORK	Vstupní odkaz na pracovní vektor WORK	Reference
ilo	Dolní index (od nuly) řádku a sloupce pracovní submatice	Long (I32)
ihi	Horní index (od nuly) řádku a sloupce pracovní submatice	Long (I32)
HLD	Pozastavení	Bool

Výstup

yA	Výstupní odkaz na matici A	Reference
yTAU	Výstupní reference na vektor skalárních faktorů elementárních reflektorů	Reference
yWORK	Výstupní odkaz na pracovní vektor WORK	Reference
E	Příznak chyby	Bool
info	Informace o výsledku funkce LAPACKu. Je-li info = -i, pak i-tý argument měl nepřípustnou hodnotu	Long (I32)

[Předchozí] [Na začátek] [Výše] [Další]