eye
単位行列
説明
I = eye
はスカラー 1
を返します。
例
正方単位行列
方形行列
単位ベクトル
既定以外の数値データ型
要素が 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)
を呼び出しません。サイズの引数は固定サイズでなければなりません。
スレッドベースの環境
MATLAB® の backgroundPool
を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool
を使用してコードを高速化します。
この関数はスレッドベースの環境を完全にサポートしています。詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。
GPU 配列
Parallel Computing Toolbox™ を使用してグラフィックス処理装置 (GPU) 上で実行することにより、コードを高速化します。
使用上の注意事項および制限事項:
typename
を'gpuArray'
として指定できます。typename
を'gpuArray'
として指定する場合、配列の基となる型は既定ではdouble
になります。基となる型が
datatype
の GPU 配列を作成するには、typename
の前に追加の引数として基となる型を指定します。たとえば、I = eye(3,datatype,'gpuArray')
は、基となる型がdatatype
の 3 行 3 列の GPU 単位行列を作成します。基となる型
datatype
は次のオプションのいずれかとして指定できます。'double'
'single'
'logical'
'int8'
'uint8'
'int16'
'uint16'
'int32'
'uint32'
'int64'
'uint64'
数値変数
p
についても、gpuArray
として指定できます。p
をgpuArray
として指定する場合、返される配列の基となる型はp
と同じになります。
詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。
使用上の注意事項および制限事項:
typename
を'codistributed'
または'distributed'
として指定できます。typename
を'codistributed'
または'distributed'
として指定する場合、返される配列の基となる型は既定ではdouble
になります。基となる型が
datatype
の分散配列または対話型分散配列を作成するには、typename
の前に追加の引数として基となる型を指定します。たとえば、I = eye(3,datatype,'distributed')
は、基となる型がdatatype
の 3 行 3 列の分散単位行列を作成します。基となる型
datatype
は次のオプションのいずれかとして指定できます。'double'
'single'
'logical'
'int8'
'uint8'
'int16'
'uint16'
'int32'
'uint32'
'int64'
'uint64'
p
についても、codistributed
またはdistributed
の配列として指定できます。p
をcodistributed
またはdistributed
の配列として指定する場合、返される配列の基となる型はp
と同じになります。codistributed
の追加の構文の詳細については、eye (codistributed)
(Parallel Computing Toolbox) を参照してください。
詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。
バージョン履歴
R2006a より前に導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)