istriu

行列が上三角行列かどうかを判別

構文

tf = istriu(A)

説明

tf = istriu(A) は、A が上三角行列である場合、logical 1 (true) を返します。その他の場合は logical 0 (false) を返します。

例

上三角行列のテスト

5 行 5 列の行列を作成します。

A = triu(magic(5))

A = 5×5

    17    24     1     8    15
     0     5     7    14    16
     0     0    13    20    22
     0     0     0    21     3
     0     0     0     0     9

行列が上三角行列かどうかをテストします。

istriu(A)

ans = logical
   1

主対角の下側の要素がすべてゼロなので、行列は上三角行列です。

ゼロの行列のテスト

5 行 5 列のゼロの行列を作成します。行列が上三角行列かどうかをテストします。

Z = zeros(5);
istriu(Z)

ans = logical
   1

上三角行列は主対角上に任意の数のゼロを含むことがあるので、結果は logical 1 (true) になります。

入力引数

A — 入力配列

配列

入力配列。A が 2 つを超える次元をもつ場合、istriu は logical 0 (false) を返します。

データ型: single | double | logical
複素数のサポート: あり

詳細

上三角行列

主対角の下側の要素がすべてゼロの行列は、上三角行列です。また、主対角上の任意の数の要素も、ゼロである可能性があります。

たとえば、この行列は上三角行列です。

$$A=\left(\begin{array}{cccc}1& -1& -1& -1\\ 0& 1& -2& -2\\ 0& 0& 1& -3\\ 0& 0& 0& 1\end{array}\right)$$

対角行列は、上三角行列であると同時に下三角行列でもあります。

ヒント

• 関数 triu を使用して、istriu が logical 1 (true) を返す上三角行列を作成します。

• 関数 isdiag、istriu、istril は関数 isbanded の特殊形です。この関数の上方と下方のバンド幅を適切に定義して、同じテストをすべて実行することができます。たとえば、istriu(A) == isbanded(A,0,size(A,2)) のようになります。

拡張機能

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

GPU コード生成

GPU Coder™ を使用して NVIDIA® GPU のための CUDA® コードを生成します。

使用上の注意および制限:

• コード生成では、この関数のスパース行列入力はサポートされません。

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

GPU 配列

Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。

istriu 関数は、GPU 配列を完全にサポートします。GPU 上で関数を実行するには、入力データを gpuArray (Parallel Computing Toolbox) として指定します。詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

この関数は分散配列を完全にサポートしています。詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2014a で導入

R2025a: スパース行列のコード生成のサポート

istriu では、スパース行列入力の C/C++ コード生成がサポートされます。

参考

isdiag | istril | diag | triu | tril | isbanded | bandwidth