quiver
矢印プロットまたはベクトル プロット
構文
説明
quiver(___, は、次のように矢印の長さを調整します。scale)
scaleが正の数値のとき、関数quiverは、矢印が重なり合わないように矢印の長さを自動的に調整してから、係数scaleで長さを伸ばします。たとえば、scaleが 2 の場合、矢印の長さは 2 倍になり、scaleが 0.5 の場合、矢印の長さは半分になります。quiver(X,Y,U,V,'off')のように、scaleが'off'または0の場合、自動スケーリングは無効になります。
quiver(___, は、LineSpec,'filled')LineSpec で指定したマーカーを塗りつぶします。
quiver(___, は、1 つ以上の名前と値のペアの引数を使用して、矢印のプロパティを指定します。プロパティの一覧については、Quiver のプロパティ を参照してください。名前と値のペアの引数は、その他すべての入力引数の後に指定します。名前と値のペアの引数は、その矢印プロット内のすべての矢印に適用されます。Name,Value)
q = quiver(___) は Quiver オブジェクトを返します。このオブジェクトは、矢印プロットを作成後に、矢印プロットのプロパティを制御するのに便利です。
例
北アメリカの大気の流れを表すサンプル データを読み込みます。この例では、データのサブセットを選択します。
load('wind','x','y','u','v') X = x(11:22,11:22,1); Y = y(11:22,11:22,1); U = u(11:22,11:22,1); V = v(11:22,11:22,1);
選択したサブセットの矢印プロットを作成します。ベクトル X と Y は各矢印の末尾の位置を表し、U と V は各矢印の方向成分を表します。既定では、関数 quiver は、矢印が重なり合わないよう矢印の長さを短くします。axis equal を呼び出し、各軸で等しい長さのデータ単位を使用します。これにより、矢印が正しい方向を指すようになります。
quiver(X,Y,U,V)
axis equal
既定では、関数 quiver は、矢印が重なり合わないよう矢印の長さを短くします。自動スケーリングを無効にして、矢印の長さが U と V のみによって決まるようにするには、scale 引数を 0 に設定します。
たとえば、関数 meshgrid を使用して、X 値と Y 値のグリッドを作成します。これらの値を使用して、方向成分を指定します。次に、自動スケーリングなしで、矢印プロットを作成します。
[X,Y] = meshgrid(0:6,0:6); U = 0.25*X; V = 0.5*Y; quiver(X,Y,U,V,0)
関数 の勾配と等高線をプロットします。関数 quiver を使用して勾配をプロットし、関数 contour を使用して等高線をプロットします。
まず、等間隔の x 値と y 値のグリッドを作成します。それらを使用して z を計算します。次に、点の間隔を指定することによって、z の勾配を特定します。
spacing = 0.2; [X,Y] = meshgrid(-2:spacing:2); Z = X.*exp(-X.^2 - Y.^2); [DX,DY] = gradient(Z,spacing);
勾配ベクトルを矢印プロットとして表示します。次に、同じ座標軸上に等高線を表示します。axis equal を呼び出して、勾配ベクトルが等高線に対して垂直に表示されるよう表示を調整します。
quiver(X,Y,DX,DY) hold on contour(X,Y,Z) axis equal hold off
矢印プロットを作成し、矢印の色を指定します。
[X,Y] = meshgrid(-pi:pi/8:pi,-pi:pi/8:pi);
U = sin(Y);
V = cos(X);
quiver(X,Y,U,V,'r')
X 値と Y 値のグリッドを作成してから、方向成分 U および V を 2 組作成します。
[X,Y] = meshgrid(0:pi/8:pi,-pi:pi/8:pi); U1 = sin(X); V1 = cos(Y); U2 = sin(Y); V2 = cos(X);
2 つの座標軸 ax1 と ax2 をもつプロットのタイル レイアウトを作成します。各座標軸に矢印プロットとタイトルを追加します "(R2019b より前では、tiledlayout および nexttile の代わりにsubplotを使用してください)。"
tiledlayout(1,2) ax1 = nexttile; quiver(ax1,X,Y,U1,V1) axis equal title(ax1,'Left Plot') ax2 = nexttile; quiver(ax2,X,Y,U2,V2) axis equal title(ax2,'Right Plot')
矢印プロットを作成し、quiver オブジェクトを返します。次に、矢じりを削除し、各末尾の終端にドット マーカーを追加します。
[X,Y] = meshgrid(-pi:pi/8:pi,-pi:pi/8:pi); U = sin(Y); V = cos(X); q = quiver(X,Y,U,V); q.ShowArrowHead = 'off'; q.Marker = '.';
入力引数
ライン スタイル、マーカー、および色。記号を含む文字ベクトルまたは string として指定します。記号は任意の順序で表記できます。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。
LineSpec を使用してマーカーを指定する場合、quiver は矢じりを表示しません。マーカーを指定し、かつ矢じりを表示するには、代わりに Marker プロパティを設定します。
例: '--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] |
|
矢印のスケーリング係数。非負の数値または 'off' として指定します。既定では、関数 quiver は、矢印が重なり合わないように矢印を自動的にスケーリングします。関数 quiver は、矢印を自動的にスケーリングした後に、スケーリング係数を適用します。
scale を指定することは、quiver オブジェクトの AutoScaleFactor プロパティを設定することと同じです。たとえば、scale を 2 に指定すると、矢印の長さが 2 倍になります。scale を 0.5 に指定すると、矢印の長さが半分になります。
自動スケーリングを無効にするには、scale を 'off' または 0 に指定します。それらの値のいずれかを指定すると、quiver オブジェクトの AutoScale プロパティが 'off' に設定され、矢印の長さが U と V のみによって決まるようになります。
ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定しない場合、関数 quiver は現在の座標軸を使用します。
名前と値の引数
ヒント
極座標を使用して矢印プロットを作成するには、先に、関数 pol2cart を使用して直交座標に変換します。
拡張機能
バージョン履歴
R2006a より前に導入
