ML_DGEBAL – Vyvážení obecné reálné matice

Symbol blokuPotřebná licence: MATRIX

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

DGEBAL(sJOB, N, uA, LDA, ilo, ihi, uSCALE, info);

kde parametry funkce DGEBAL jsou nastaveny následovně:

Celočíselný vstup job je mapován na řetězec sJOB: ${0, 1} \to$ "N", ${2} \to$ "P", ${3} \to$ "S" a ${4} \to$ "B".
N je počet sloupců čtvercové matice referencované uA.
LDA je hlavní rozměr matice referencované uA.
ilo a ihi jsou vrácené dolní a horní indexy řádků a sloupců vyvážené submatice matice referencované uA.
info je návratový kód z funkce DGEBAL.

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

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

Upozorňujeme, že indexy ilo a ihi začínají od nuly na rozdíl od verze FORTRAN, kde začínají od jedné. 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
uSCALE	Vstupní odkaz na vektor SCALE	Reference
job	Specifikuje operace, které mají být provedeny s maticí A $↓$ 0 $↑$ 4	Long (I32)
HLD	Pozastavení	Bool

Výstup

yA	Výstupní odkaz na matici A	Reference
ySCALE	Výstupní odkaz na vektor SCALE	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)
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ší]