streamparticles
ストリーム粒子のプロット
構文
説明
streamparticles(___, は 1 つ以上の名前と値の引数を使用してプロパティを設定して、ストリーム粒子のアニメーションと外観を変更します。たとえば、Name,Value)Marker プロパティを使用して粒子の形状を設定できます。前述の任意の構文で、すべての引数の後に名前と値の引数を指定します。プロパティの一覧については、Line のプロパティ を参照してください。
streamparticles( はターゲット オブジェクトを使用してストリーム粒子プロットを作成します。ターゲット オブジェクトが target,___)Axes オブジェクトである場合、MATLAB® は、現在の座標軸 (gca) ではなく指定された座標軸にプロットします。ターゲット オブジェクトが Line オブジェクトの場合、新しい Line オブジェクトを作成するのではなく、ライン プロパティが更新されてストリーム粒子が作成されます。
lineobj = streamparticles(___)Line オブジェクトを返します。
例
15 行 2 列の行列で "x" 座標と "y" 座標として指定した 2 本の流線の頂点を作成します。streamparticles への頂点の入力は cell 配列として定義します。各要素は 1 本の流線を表します。
x = linspace(0,2*pi,15);
y1 = sin(x);
y2 = sin(x) + 1;
s1 = [x;y1]';
s2 = [x;y2]';
verts = {s1,s2};流線の各頂点に粒子をプロットします。
streamparticles(verts);
位置と速度の行列を使用してベクトル場を定義します。streamslice を使用してベクトル場に流線の頂点を生成し、頂点を verts に格納します。
[x,y] = meshgrid(-10:10); u = 2.*x.*y; v = y.^2 - x.^2; [verts,~] = streamslice(x,y,u,v);
streamline で流線をプロットします。次に、streamparticles で 100 個の粒子をプロットします。既定では、粒子はすべての頂点上に等間隔に配置されます。
streamline(verts); streamparticles(verts,100);
同じベクトル場で、ParticleAlignment プロパティを "on" に設定して、最も多くの頂点をもつ流線上に 5 個の粒子を均等にプロットします。関数 streamparticles はその間隔を使用して、残りの流線上に粒子をプロットします。
streamline(verts); streamparticles(verts,5,"ParticleAlignment","on");
同じベクトル場で、流線の頂点の 5% を粒子としてプロットします。
streamline(verts); streamparticles(verts,0.05);
ベクトル場の頂点を作成し、その流線およびストリーム粒子をプロットします。Animate プロパティと FrameRate プロパティをそれぞれ設定して、1 秒あたり 30 フレームで 5 回反復して粒子をアニメーション化します。
[x,y] = meshgrid(-10:10); u = 2.*x.*y; v = y.^2 - x.^2; [verts,~] = streamslice(x,y,u,v); streamline(verts); streamparticles(verts,100,"Animate",5,"FrameRate",30);
ベクトル場の頂点を作成し、その流線およびストリーム粒子をプロットします。Marker プロパティおよび MarkerEdgeColor プロパティを設定して、粒子に緑のアスタリスク マーカーを使用します。
[x,y] = meshgrid(-10:10); u = 2.*x.*y; v = y.^2 - x.^2; [verts,~] = streamslice(x,y,u,v); streamline(verts); streamparticles(verts,150,"Marker","*","MarkerEdgeColor",[0 0.5 0]);
入力引数
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
例: streamparticles(verts,MarkerFaceColor="blue") は、ストリーム粒子に青いマーカーを指定します。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: streamparticles(verts,"MarkerFaceColor","blue") は、ストリーム粒子に青いマーカーを指定します。
メモ
ここで示したライン プロパティは、粒子の外観を変更できるプロパティの一部に過ぎません。完全な一覧については、Line のプロパティ を参照してください。
アニメーションの反復回数。非負の整数として指定します。既定では、Animate の値は 0 であり、ストリーム粒子の動きがないことを指定します。値が Inf の場合、アニメーションは "Ctrl+C" が押されるまで続きます。
アニメーションの 1 秒あたりのフレーム数。非負の整数として指定します。既定では、FrameRate の値は Inf です。この場合、streamparticles を実行しているマシンの制限を考慮して、できる限り高速にアニメーションを描画します。
流線上の粒子の配置。"off" または "on" として指定します。
ParticleAlignmentが"off"の場合、nにより、すべての流線の頂点上に等間隔にプロットされる粒子の数が決まります。ParticleAlignmentが"on"の場合、nにより、最も多くの頂点をもつ流線に対して等間隔にプロットされる粒子の数が決まります。関数streamparticlesはその間隔を使用して、残りの流線上に粒子をプロットします。
マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、粒子は円として表示されます。"*" のようにマーカー記号に塗りつぶし領域がない場合、マーカーのエッジの色を指定する必要があります。
| マーカー | 説明 | 結果のマーカー |
|---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
"none" | マーカーなし | 該当なし |
マーカーの輪郭の色。"none"、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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
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 進数カラー コードを取得します。
マーカーの塗りつぶし色。"red"、"none"、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" |
|
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
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 進数カラー コードを取得します。
拡張機能
バージョン履歴
R2006a より前に導入
