compass

(非推奨) 原点から発生する矢印

• 

compass は推奨されません。代わりに compassplot を使用してください。 (R2024b 以降)

コードの更新の詳細については、バージョン履歴を参照してください。

構文

compass(U,V)

compass(Z)

compass(___,LineSpec)

compass(ax,___)

c = compass(___)

説明

compass(U,V) は点 (0, 0) から発生する矢印をプロットします。直交座標 U と V を使用して矢印の方向を指定します。U は x 座標を示し、V は y 座標を示します。矢印の数は U の要素数と一致します。

関数 compass は Axes オブジェクト内の theta 軸と r 軸の目盛りラベルを使用して、円形グリッド上に矢印をプロットします。したがって、指定する座標はプロットに表示されるラベルと一致しません。

compass(Z) は Z で指定された複素数値の実数部と虚数部を使用して矢印をプロットします。実数部は x 座標を示し、虚数部は y 座標を示します。この構文は compass(real(Z),imag(Z)) と等価です。

compass(___,LineSpec) は、矢印のライン スタイル、マーカー記号および色を設定します。

compass(ax,___) は、現在の座標軸ではなく、指定された座標軸に矢印をプロットします。

c = compass(___) は、Line オブジェクトのベクトルを返します。この構文は矢印の外観を制御する場合に便利です。

例

直交座標を使用したコンパス プロットの作成

各矢印の直交座標を指定して、コンパス プロットを作成します。

u = [5 3 -4 -3 5];
v = [1 5 3 -2 -6];
compass(u,v)

1 つの矢印の外観の指定

矢印を変数に割り当ててからそのプロパティを設定することにより、単一の矢印のライン幅と色を指定します。これを行うには、最初にコンパス プロットを作成して、Line オブジェクトの配列を返します。

u = [3 5 -4 -3 5];
v = [5 1 3 -2 -6];
c = compass(u,v);

最初の矢印を変数 c1 に割り当てます。最初の矢印は u と v の最初の要素に対応します。次に、ライン幅と色を変更します。

c1 = c(1);
c1.LineWidth = 2;
c1.Color = "red";

入力引数

U — x 座標

スカラー | ベクトル | 行列

x 座標。スカラー、ベクトルまたは行列として指定します。直交座標の値を指定します。極座標から直交座標にデータを変換するには、pol2cart を使用します。

U のサイズは V のサイズと同じでなければなりません。

V — y 座標

スカラー | ベクトル | 行列

y 座標。スカラー、ベクトルまたは行列として指定します。直交座標の値を指定します。極座標から直交座標にデータを変換するには、pol2cart を使用します。

V のサイズは U のサイズと同じでなければなりません。

Z — 複素数値

スカラー | ベクトル | 行列

複素数値。スカラー、ベクトルまたは行列として指定します。Z の実数部は矢印の x 座標を示し、虚数部は y 座標を示します。

LineSpec — ライン スタイル、マーカー、色

string スカラー | 文字ベクトル

ライン スタイル、マーカー、および色。記号を含む string スカラーまたは文字ベクトルとして指定します。記号は任意の順序で表記できます。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、ライン スタイルを省略してマーカーを指定する場合、プロットはラインなしでマーカーのみを表示します。

例: "--or" は円形マーカー付きの赤い破線です。

ライン スタイル	説明	結果として得られる線
"-"	実線
"--"	破線
":"	点線
"-."	一点鎖線

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

色名	省略名	RGB 3 成分	外観
"red"	"r"	[1 0 0]
"green"	"g"	[0 1 0]
"blue"	"b"	[0 0 1]
"cyan"	"c"	[0 1 1]
"magenta"	"m"	[1 0 1]
"yellow"	"y"	[1 1 0]
"black"	"k"	[0 0 0]
"white"	"w"	[1 1 1]

ax — ターゲット座標軸

Axes オブジェクト

ターゲット座標軸。Axes オブジェクトとして指定します。

拡張機能

GPU 配列

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

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

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

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

分散配列

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

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

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

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

バージョン履歴

R2006a より前に導入

R2024b: 非推奨

compass は推奨されません。代わりに関数 compassplot を使用してください。compassplot 関数は、より多くのカスタマイズ オプションが用意されている PolarAxes オブジェクトを使用します。たとえば、度またはラジアンの theta 単位を表示するように PolarAxes プロパティを設定したり、theta および r 軸の範囲を調整したり、目盛りラベルの特性を調整したりできます。ただし、compass 関数を削除する予定はありません。

他の極座標プロット関数と同様に、compassplot は直交座標の代わりに極座標を受け入れます。cart2pol 関数を使用してデータを変換します。次の表に、いくつかの一般的な使用方法と、compassplot を使用するようにコードを更新する方法を示します。

シナリオ	非推奨	推奨
座標のベクトルをプロットする — 直交座標値 u および v を compassplot に渡す前に極座標に変換します。	compass(u,v)	[theta,rho] = cart2pol(u,v); compassplot(theta,rho)
座標の行列をプロットする — compass 関数は、すべての矢印を同じ色でプロットします。compassplot は、行列の列ごとに異なる色を使用します。すべての矢印を同じ色にするには、名前と値の引数 SeriesIndex を 1 に設定します。	compass(u,v)	[theta,rho] = cart2pol(u,v); compassplot(theta,rho,SeriesIndex=1)
複素数値をプロットする	compass(Z)	compassplot(Z)
ライン スタイルと色を指定する	compass(u,v,"--r")	[theta,rho] = cart2pol(u,v); compassplot(theta,rho,LineStyle="--",Color="r")

参考

関数

• compassplot | feather | polarplot | polarhistogram | view | pol2cart

プロパティ

• Line のプロパティ | PolarCompassPlot Properties