spy

行列のスパース パターンの可視化

• 

構文

spy(S)

spy(S,LineSpec)

spy(___,MarkerSize)

説明

spy(S) は、行列 S のスパース パターンをプロットします。非ゼロの値に色が付けられ、ゼロの値は白色になります。プロットには、行列内の非ゼロの数 nz = nnz(S) が表示されます。

spy(S,LineSpec) はさらに LineSpec を指定し、プロットで使用するマーカーの記号と色を設定します。たとえば、spy(A,'r*') は、非ゼロに赤のアスタリスクを使用します。

spy(___,MarkerSize) は、前述のいずれかの入力引数の組み合わせを使用し、MarkerSize を指定してマーカーのサイズを設定します。

例

スパース パターンのプロット

Buckminster Fuller のジオデシック ドームの連結性グラフの 60 行 60 列のスパース隣接行列をプロットします。この行列は、C60 フラーレン分子およびサッカー ボールも表現します。

B = bucky;
spy(B)

色とマーカーを指定します。

spy(B,'ro')

マーカー サイズも指定します。

spy(B,'ro',2)

入力引数

S — 入力行列

行列

入力行列。S は通常スパース行列ですが、完全とスパースのいずれでも構いません。

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

MarkerSize — マーカー サイズ

正の整数スカラー

マーカー サイズ。正の整数スカラーとして指定します。

例: spy(A,3) はサイズ 3 のマーカーを使用します。

LineSpec — マーカーの記号および色

文字ベクトル | string

マーカーの記号および色。記号を含む文字ベクトルまたは string として指定します。記号は任意の順序で表記できます。特性 (マーカーと色) の両方を指定する必要はありません。たとえば、色を省略してマーカーを指定した場合、プロットでは既定の色と指定したマーカーが使用されます。

例: 'or' では、赤い円形マーカーが使用されます。

マーカー	説明	結果のマーカー
"o"	円
"+"	プラス記号
"*"	アスタリスク
"."	点
"x"	十字
"_"	水平線
"|"	垂直線
"square"	正方形
"diamond"	菱形
"^"	上向き三角形
"v"	下向き三角形
">"	右向き三角形
"<"	左向き三角形
"pentagram"	星形五角形
"hexagram"	星形六角形

色名	省略名	外観
'red'	'r'
'green'	'g'
'blue'	'b'
'cyan'	'c'
'magenta'	'm'
'yellow'	'y'
'black'	'k'
'white'	'w'

ヒント

• format + は、小さな行列の非ゼロ構造を表示するテキストベースの代替方法です。

  format +
  eye(4)

  ans =
  
  +   
   +  
    + 
     +

拡張機能

GPU 配列

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

spy 関数は GPU 配列入力をサポートしますが、次の使用上の注意および制限があります。

• この関数は GPU 配列を受け入れますが、GPU 上では実行されません。

詳細については、GPU での MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

分散配列

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

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

• この関数は分散配列に対して演算を行いますが、クライアントの MATLAB^® で実行されます。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2006a より前に導入

R2023a: 縦横比およびマーカー サイズの変更

spy プロットの縦横比には 1 対 10 の制限があり、この制限に達すると、プロットは行列の形状を調整しなくなります。特別な縦横比がない場合は pbaspect("auto") を使用できます。あるいは、非常に "圧縮された" ケースでも縦横比を一致させる以前の動作にする場合は pbaspect([size(A,2) size(A,1) 1]) を使用できます。

また、既定のマーカー サイズは行列サイズにのみ基づきます。以前は、作成時における座標軸の点のサイズもマーカー サイズに影響することがありました。

参考

find | nonzeros | sparse

トピック

• スパース行列の並べ替え