このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

eye

単位行列

構文

I = eye

I = eye(n)

I = eye(n,m)

I = eye(sz)

I = eye(___,typename)

I = eye(___,'like',p)

説明

I = eye はスカラー 1 を返します。

I = eye(n) は、主対角に 1 をもち、それ以外に 0 をもつ n 行 n 列の単位行列を返します。

I = eye(n,m) は、主対角に 1 をもち、それ以外に 0 をもつ n 行 m 列の行列を返します。

I = eye(sz) は、主対角に 1 をもち、それ以外に 0 をもつ配列を返します。サイズ ベクトル sz は size(I) を定義します。たとえば、eye([2,3]) は、主対角に 1 をもち、それ以外に 0 をもつ 2 行 3 列の配列を返します。

I = eye(___,typename) は、上記の任意の構文で、I のデータ型 (クラス) も指定します。たとえば、eye(5,'int8') は、8 ビット整数からなる 5 行 5 列の単位行列を返します。

I = eye(___,'like',p) は、I が数値変数 p と同じデータ型、スパース性、実数/複素数をもつように指定します。

例

正方単位行列

4 行 4 列の単位行列を作成します。

I = eye(4)

I = 4×4

     1     0     0     0
     0     1     0     0
     0     0     1     0
     0     0     0     1

方形行列

2 行 3 列の単位行列を作成します。

I = eye(2,3)

I = 2×3

     1     0     0
     0     1     0

単位ベクトル

3 行 1 列の単位ベクトルを作成します。

sz = [3,1];
I = eye(sz)

I = 3×1

     1
     0
     0

既定以外の数値データ型

要素が 32 ビット符号なしの整数である 3 行 3 列の単位行列を作成します。

I = eye(3,'uint32'),

I = 3x3 uint32 matrix

   1   0   0
   0   1   0
   0   0   1

class(I)

ans = 
'uint32'

複素単位行列

実数値ではなく、既存の配列と同種の複素数値である 2 行 2 列の単位行列を作成します。

複素数ベクトルを定義します。

p = [1+2i 3i];

p と同種の複素数である単位行列を作成します。

I = eye(2,'like',p)

I = 2×2 complex

   1.0000 + 0.0000i   0.0000 + 0.0000i
   0.0000 + 0.0000i   1.0000 + 0.0000i

スパース単位行列

5 行 5 列のスパース行列を定義します。

p = sparse(5,5,pi);

P と同種のスパースである 5 行 5 列の単位行列を作成します。

I = eye(5,'like',p)

I = 
   (1,1)        1
   (2,2)        1
   (3,3)        1
   (4,4)        1
   (5,5)        1

既存の配列で定義されるサイズと数値データ型

単精度の 2 行 2 列の行列を定義します。

p = single([1 3 ; 2 4]);

P とサイズおよびデータ型が同じである単位行列を作成します。

I = eye(size(p),'like',p),

I = 2x2 single matrix

     1     0
     0     1

class(I)

ans = 
'single'

入力引数

n — I の最初の次元のサイズ

整数値

I の最初の次元のサイズ。整数値として指定します。

• 整数の入力引数が n だけの場合、I は n 行 n 列の単位行列です。

• n が 0 の場合、I は空の行列です。

• n が負の場合、0 として扱われます。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

m — I の 2 番目の次元のサイズ

整数値

I の 2 番目の次元のサイズ。整数値として指定します。

• m が 0 の場合、I は空の行列です。

• m が負の場合、0 として扱われます。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

sz — I のサイズ

2 つ以下の整数値の行ベクトル

I のサイズ。2 つ以下の整数値の行ベクトルとして指定します。

• sz の要素が 0 の場合、I は空行列です。

• sz の要素が負の場合、その要素は 0 として扱われます。

例: sz = [2 3] は、I を 2 行 3 列の行列として定義します。

データ型: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

typename — 出力クラス

'double' (既定値) | 'single' | 'logical' | 'int8' | 'uint8' | ...

出力クラス。'double'、'single'、logical、'int8'、'uint8'、'int16'、'uint16'、'int32'、'uint32'、'int64' または 'uint64' として指定します。

p — プロトタイプ

数値変数

プロトタイプ。数値変数として指定します。

データ型: double | single | logical | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
複素数のサポート: あり

拡張機能

C/C++ コード生成

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

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

• typename は組み込みの MATLAB^® 数値型でなければなりません。他のクラスの静的 eye メソッドを呼び出しません。たとえば、eye(m, n, 'myclass') は myclass.eye(m,n) を呼び出しません。

• サイズの引数は固定サイズでなければなりません。

GPU コード生成

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

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

• typename は組み込みの MATLAB 数値型でなければなりません。他のクラスの静的 eye メソッドを呼び出しません。たとえば、eye(m, n, 'myclass') は myclass.eye(m,n) を呼び出しません。

• サイズの引数は固定サイズでなければなりません。

GPU 配列

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

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

• eye (Parallel Computing Toolbox) を参照してください。

分散配列

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

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

• eye (Parallel Computing Toolbox) を参照してください。

参考

speye | ones | zeros

トピック

• 配列作成関数に対するクラス サポート

R2006a より前に導入

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい