streamline
2 次元または 3 次元ベクトル データからの流線のプロット
構文
説明
streamline( は、頂点配列の cell 配列 (verts)stream2、stream3、または streamslice によって返される) として指定される頂点から流線をプロットします。
streamline(___, は、options)step または [step maxvert] という形式をもつ 1 要素ベクトルまたは 2 要素ベクトルとして定義される指定オプションを使用して、流線をプロットします。ここで、step はベクトル データを内挿するためのデータ単位のステップ サイズで、maxvert は流線内の頂点の最大数です。この引数は、前述の構文にある任意の入力引数の組み合わせと共に使用します。
streamline(___, は、1 つ以上の名前と値の引数を使用して流線のプロットのプロパティを設定します。たとえば、流線の色と太さを指定できます。プロパティの一覧については、Line のプロパティ を参照してください。 (R2024b 以降)Name=Value)
streamline( は、流線を現在の axes オブジェクト (ax,___)gca) にではなく、指定された座標軸にプロットします。
lineobj = streamline(___)Line オブジェクトのベクトルを返します。流線のプロパティを作成した後に変更するには lineobj を使用します。プロパティの一覧については、Line のプロパティ を参照してください。
例
北アメリカ各地での大気の流れの測定値を含む wind データ セットを読み込みます。
3-D 配列
x、y、zは、大気の流れの測定値の場所を表します。3-D 配列
u、v、wは、3-D ベクトル場での大気の流れの速度を表します。
16 個の架空粒子の開始位置を定義します。この場合、粒子はすべて x = 80 からスタートし、20 ～ 50 の範囲の開始 y 位置と 0 ～ 15 の範囲の開始 z 位置をもちます。
load wind
[startX,startY,startZ] = meshgrid(80,20:10:50,0:5:15);大気の流れにおける startX、startY、startZ という一連の開始位置に置かれた架空粒子について、3-D 流線の頂点データを計算します。
verts = stream3(x,y,z,u,v,w,startX,startY,startZ);
streamline を使ってベクトル場の 3-D ボリュームを可視化します。line オブジェクトを変数 lineobj に返します。これにより、後でプロパティを変更できます。
lineobj = streamline(verts); view(3)
特定のラインの特性を変更するには、返されたいずれかの line オブジェクトのプロパティを設定します。たとえば、10 番目のラインの色を緑に変更し、その太さを 3 に変更します。
lineobj(10).Color = "g";
lineobj(10).LineWidth = 3;
北アメリカ各地での大気の流れの測定値を含む wind データ セットを読み込みます。
3-D 配列
xおよびyは、大気の流れの測定値の場所を表します。3-D 配列
uおよびvは、3-D ベクトル場での大気の流れの速度を表します。
配列の 5 ページ目を使用します。4 つの架空粒子の開始位置を定義します。この場合、4 つの開始位置は (80, 20)、(80, 30)、(80, 40)、(80, 50) です。
load wind
x5 = x(:,:,5);
y5 = y(:,:,5);
u5 = u(:,:,5);
v5 = v(:,:,5);
[startX,startY] = meshgrid(80,20:10:50);stream2 を使って、大気の流れに置かれた架空粒子の 2-D 流線の頂点データを計算します。
verts = stream2(x5,y5,u5,v5,startX,startY);
streamline を呼び出して、ベクトル場の 2-D 行列を可視化します。line オブジェクトを変数 lineobj に返します。これにより、後でプロパティを変更できます。
lineobj = streamline(verts);
特定のラインの特性を変更するには、返されたいずれかの line オブジェクトのプロパティを設定します。たとえば、2 番目のラインの色をマゼンタに変更し、そのスタイルを破線に変更します。
lineobj(2).Color = "m"; lineobj(2).LineStyle = "--";
wind データセットを読み込み、平面 x = 80 上の等間隔に置かれた点から始まる流線の頂点を計算します。次に、頂点データから流線をプロットします。
load wind [startX,startY,startZ] = meshgrid(80,20:10:50,0:5:15); verts = stream3(x,y,z,u,v,w,startX,startY,startZ); streamline(verts) axis tight view(3);
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: streamline(verts,LineWidth=2) は、2 ポイントのラインの太さで流線をプロットします。
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Line のプロパティ を参照してください。
ラインの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。
カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。
RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は
[0,1]の範囲でなければなりません。たとえば[0.4 0.6 0.7]のようになります。16 進数カラー コードは、ハッシュ記号 (
#) で始まり、3 桁または 6 桁の0からFまでの範囲の 16 進数が続く string スカラーまたは文字ベクトルです。この値は大文字と小文字を区別しません。したがって、カラー コード"#FF8800"、"#ff8800"、"#F80"、および"#f80"は等価です。
あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。
| 色名 | 省略名 | RGB 3 成分 | 16 進数カラー コード | 外観 |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
拡張機能
バージョン履歴
R2006a より前に導入流線のプロットを作成すると、MATLAB は他のほとんどのプロットと同様に色とライン スタイルを自動的に割り当てます。たとえば、streamline で作成された最初のライン セットはソフト ブルー色になりました。
以前のリリースの外観を維持するには、関数 set を使用して Color プロパティを [0 0 1] に設定します。
lineobj = streamline(verts); set(lineobj,Color=[0 0 1])
