fmesh

3 次元メッシュをプロット

ページ内をすべて折りたたむ

構文

fmesh(f)

fmesh(f,[min max])

fmesh(f,[xmin xmax ymin ymax])

fmesh(funx,funy,funz)

fmesh(funx,funy,funz,[uvmin uvmax])

fmesh(funx,funy,funz,[umin umax vmin vmax])

fmesh(___,LineSpec)

fmesh(___,Name,Value)

fmesh(ax,___)

obj = fmesh(___)

説明

例

fmesh(f) は、シンボリック式 f(x,y) のメッシュプロットを x と y の既定の区間 [-5 5] で作成します。

fmesh(f,[min max]) は、f(x,y) を x と y の区間 [min max] でプロットします。

例

fmesh(f,[xmin xmax ymin ymax]) は、f(x,y) を x の区間 [xmin xmax] と y の区間 [ymin ymax] でプロットします。関数 fmesh は symvar を使用して、変数を並べ替え、区間を割り当てます。

例

fmesh(funx,funy,funz) は、パラメトリックメッシュ x = x(u,v)、y = y(u,v)、z = z(u,v) を u と v の区間 [-5 5] でプロットします。

fmesh(funx,funy,funz,[uvmin uvmax]) は、パラメトリックメッシュ x = x(u,v)、y = y(u,v)、z = z(u,v) を u と v の区間 [uvmin uvmax] でプロットします。

fmesh(funx,funy,funz,[umin umax vmin vmax]) は、パラメトリックメッシュ x = x(u,v)、y = y(u,v)、z = z(u,v) を u の区間 [umin umax] と v の区間 [vmin vmax] でプロットします。関数 fmesh は symvar を使用して、パラメトリック変数を並べ替え、区間を割り当てます。

fmesh(___,LineSpec) は、LineSpec を使用してラインスタイル、マーカー記号、プロットの色を設定します。

fmesh(___,Name,Value) は、1 つ以上の Name,Value 引数ペアを使用して、表面プロパティを指定します。このオプションは、前述の構文のすべての入力引数の組み合わせで使用できます。

fmesh(ax,___) は、現在の axes オブジェクト gca ではなくオブジェクト ax をもつ座標軸にプロットします。

obj = fmesh(___) は、関数表面オブジェクトまたはパラメーター化された関数表面オブジェクトを返します。このオブジェクトを使用して、特定のメッシュのプロパティのクエリと変更を行います。

例

すべて折りたたむ

シンボリック式の 3 次元のメッシュプロット

ライブスクリプトを開く

既定の区間 $- 5 < x < 5$ および $- 5 < y < 5$ に入力 $\sin (x) + \cos (y)$ のメッシュをプロットします。

syms x y
fmesh(sin(x)+cos(y))

Figure contains an axes object. The axes object contains an object of type functionsurface.

シンボリック関数の 3 次元のメッシュプロット

ライブスクリプトを開く

既定の区間 $- 5 < x < 5$ および $- 5 < y < 5$ に ${t a n}^{- 1} (x + i y)$ の実数部の 3 次元メッシュをプロットします。

syms f(x,y)
f(x,y) = real(atan(x + i*y));
fmesh(f)

Figure contains an axes object. The axes object contains an object of type functionsurface.

メッシュプロットのプロット区間の指定

ライブスクリプトを開く

プロット区間を fmesh の 2 番目の引数に与えることで、 $\sin (x) + \cos (y)$ を区間 $- π < x < π$ と $- 5 < y < 5$ にプロットします。

syms x y
f = sin(x) + cos(y);
fmesh(f, [-pi pi -5 5])

Figure contains an axes object. The axes object contains an object of type functionsurface.

パラメーター化されたメッシュプロット

ライブスクリプトを開く

次のパラメーター化されたメッシュのプロットを

$\begin{array}{c} x = r \cos (s) \sin (t) \\ y = r \sin (s) \sin (t) \\ z = r \cos (t) \\ w h e r e r = 8 + \sin (7 s + 5 t) \end{array}$

$0 < s < 2 π$ と $0 < t < π$ で行います。axis equal を使用して、座標軸の縦横比を同じにします。alpha を使用して、メッシュを部分的に透明にしてメッシュ全体を表示します。

syms s t
r = 8 + sin(7*s + 5*t);
x = r*cos(s)*sin(t);
y = r*sin(s)*sin(t);
z = r*cos(t);
fmesh(x, y, z, [0 2*pi 0 pi], 'Linewidth', 2)
axis equal
alpha(0.8)

Figure contains an axes object. The axes object contains an object of type parameterizedfunctionsurface.

入力引数

すべて折りたたむ

`f` — プロットする 3 次元式または関数
シンボリック式 | シンボリック関数

プロットする式または関数。シンボリック式またはシンボリック関数として指定します。

`[min max]` — x 軸と y 軸のプロット区間
[–5 5] (既定値) | 2 つの数値のベクトル

x 軸と y 軸のプロット区間。2 つの数値のベクトルとして指定します。既定値は [-5 5] です。

`[xmin xmax ymin ymax]` — x 軸と y 軸のプロット区間
[–5 5 –5 5] (既定値) | 4 つの数値のベクトル

x 軸と y 軸のプロット区間。4 つの数値のベクトルとして指定します。既定値は [-5 5 -5 5] です。

`funx,funy,funz` — `u` と `v` のパラメトリック関数
シンボリック式 | シンボリック関数

u と v のパラメトリック関数。シンボリック式またはシンボリック関数として指定します。

`[uvmin uvmax]` — `u` と `v` のプロット区間
[–5 5] (既定値) | 2 つの数値のベクトル

u 軸と v 軸のプロット区間。2 つの数値のベクトルとして指定します。既定値は [-5 5] です。

`[umin umax vmin vmax]` — `u` と `v` のプロット区間
[–5 5 –5 5] (既定値) | 4 つの数値のベクトル

u と v のプロット区間。4 つの数値のベクトルとして指定します。既定値は [-5 5 -5 5] です。

`ax` — axes オブジェクト
axes オブジェクト

axes オブジェクト。axes オブジェクトを指定しない場合、fmesh は現在の座標軸を使用します。

`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]`

名前と値の引数

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は関係ありません。

R2021a より前では、コンマを使用して名前と値の各ペアを区切り、Name を引用符で囲みます。

例: 'Marker','o','MarkerFaceColor','red'

`MeshDensity` — 方向ごとの評価点の数
35 (既定値) | 数値

方向ごとの評価点の数。数値として指定します。既定値は 35 です。fmesh オブジェクトは適応評価を使用するため、評価点の数は実際の数の方が大きくなります。

例: 100

`ShowContours` — プロットの下に等高線図を表示
`'off'` (既定値) | on/off logical 値

プロットの下に等高線図を表示。'on' または 'off' として指定するか、数値または 1 (true) か 0 (false) の logical 値として指定します。値 'on' は true と等価で、'off' は false と等価です。したがって、このプロパティの値は logical 値として使用できます。値は、matlab.lang.OnOffSwitchState 型の on/off logical 値として保存されます。

`EdgeColor` — ラインの色
`'interp'` (既定値) | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

ラインの色。'interp'、RGB 3 成分、16 進数のカラーコード、色の名前、または省略名として指定します。既定値 'interp' では ZData のプロパティ値に基づいてエッジをカラーリングします。

カスタム色には、RGB 3 成分または 16 進数のカラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数のカラーコードは、string スカラー、またはハッシュ記号 (#) の後に 3 つまたは 6 つの 0 から F までの範囲の 16 進数の桁を続けた文字ベクトルです。この値では大文字と小文字は区別されません。そのため、カラーコード "#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"`	適用不可	適用不可	適用不可	色なし

MATLAB^® で多くの種類のプロットで使用されている既定の色の RGB 3 成分および 16 進数のカラーコードを次に示します。

RGB 3 成分	16 進数のカラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

例: 'blue'

例: [0 0 1]

例: '#0000FF'

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

ラインスタイル。次の表のいずれかのオプションに指定します。

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

`LineWidth` — ライン幅
`0.5` (既定値) | 正の値

ライン幅。ポイント単位の正の値として指定します。1 ポイント = 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカーエッジにも影響します。

ライン幅はピクセルの幅よりも細くすることはできません。ライン幅をシステムのピクセル幅よりも小さい値に設定すると、線は 1 ピクセルの幅で表示されます。

`Marker` — マーカー記号
`"none"` (既定値) | `"o"` | `"+"` | `"*"` | `"."` | ...

マーカー記号。この表にリストされたいずれかの値として指定します。既定では、オブジェクトにマーカーが表示されません。マーカー記号を指定すると、各データ点または頂点にマーカーが追加されます。

マーカー	説明	結果として得られるマーカー
`"o"`	円
`"+"`	プラス記号
`"*"`	アスタリスク
`"."`	点
`"x"`	十字
`"_"`	横線
`"\|"`	縦線
`"square"`	正方形
`"diamond"`	菱形
`"^"`	上向き三角形
`"v"`	下向き三角形
`">"`	右向き三角形
`"<"`	左向き三角形
`"pentagram"`	星形五角形
`"hexagram"`	星形六角形
`"none"`	マーカーなし	適用不可

`MarkerEdgeColor` — マーカーの輪郭の色
`'auto'` (既定値) | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

マーカーの輪郭の色。'auto'、RGB 3 成分、16 進数のカラーコード、色の名前、または省略名として指定します。既定値 'auto' では EdgeColor プロパティと同じ色が使用されます。

カスタム色には、RGB 3 成分または 16 進数のカラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数のカラーコードは、string スカラー、またはハッシュ記号 (#) の後に 3 つまたは 6 つの 0 から F までの範囲の 16 進数の桁を続けた文字ベクトルです。この値では大文字と小文字は区別されません。そのため、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

色の名前	省略名	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"`	適用不可	適用不可	適用不可	色なし

MATLAB で多くの種類のプロットで使用されている既定の色の RGB 3 成分および 16 進数のカラーコードを次に示します。

RGB 3 成分	16 進数のカラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

例: [0.5 0.5 0.5]

例: 'blue'

例: '#D2F9A7'

`MarkerFaceColor` — マーカーの塗りつぶし色
`'none'` (既定値) | `'auto'` | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

マーカーの塗りつぶし色。'auto'、RGB 3 成分、16 進数のカラーコード、色の名前、または省略名として指定します。'auto' の値には MarkerEdgeColor プロパティと同じ色が使用されます。

カスタム色には、RGB 3 成分または 16 進数のカラーコードを指定します。

RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。
16 進数のカラーコードは、string スカラー、またはハッシュ記号 (#) の後に 3 つまたは 6 つの 0 から F までの範囲の 16 進数の桁を続けた文字ベクトルです。この値では大文字と小文字は区別されません。そのため、カラーコード "#FF8800"、"#ff8800"、"#F80"、および "#f80" は等価です。

色の名前	省略名	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"`	適用不可	適用不可	適用不可	色なし

MATLAB で多くの種類のプロットで使用されている既定の色の RGB 3 成分および 16 進数のカラーコードを次に示します。

RGB 3 成分	16 進数のカラーコード	外観
`[0 0.4470 0.7410]`	`"#0072BD"`
`[0.8500 0.3250 0.0980]`	`"#D95319"`
`[0.9290 0.6940 0.1250]`	`"#EDB120"`
`[0.4940 0.1840 0.5560]`	`"#7E2F8E"`
`[0.4660 0.6740 0.1880]`	`"#77AC30"`
`[0.3010 0.7450 0.9330]`	`"#4DBEEE"`
`[0.6350 0.0780 0.1840]`	`"#A2142F"`

例: [0.3 0.2 0.1]

例: 'green'

例: '#D2F9A7'

`MarkerSize` — マーカーサイズ
`6` (既定値) | 正の値

マーカーサイズ。ポイント単位の正の値として指定します。1 ポイント = 1/72 インチです。

出力引数

すべて折りたたむ

`obj` — 1 つ以上のオブジェクト
スカラー | ベクトル

1 つ以上のオブジェクト。スカラーまたはベクトルとして返されます。このオブジェクトは、プロットのタイプによって、関数表面オブジェクトかパラメーター化されたメッシュオブジェクトのいずれかになります。これらのオブジェクトを使用して、特定のラインのプロパティのクエリと変更を行います。詳細は FunctionSurface のプロパティおよび ParameterizedFunctionSurface のプロパティを参照してください。

ヒント

fmesh と fsurf は同じ構文を使用するため、その他の例については fsurf のページに従ってください。fsurf のページのすべての例は fmesh にあてはまります。

アルゴリズム

fmesh は f のシンボリック変数を x 軸に、次に y 軸に割り当て、symvar は割り当てられる変数の順番を決定します。そのため、変数名と軸名が対応しない場合があります。fmesh が x または y を対応する軸に割り当てるように強制するには、プロットするシンボリック関数を作成し、そのシンボリック関数を fmesh に渡します。

たとえば、次のコードは f(x,y) = sin(y) のメッシュを 2 つの方法でプロットします。1 つ目の方法では、y 軸に対して波形を振動させます。つまり、1 つ目のプロットでは変数 y を対応する y 軸に割り当てます。2 つ目のプロットでは、y を x 軸に割り当てます。これがシンボリック関数内で最初の (および唯一の) 変数であるためです。

syms x y;
f(x,y) = sin(y);

figure;
subplot(2,1,1)
fmesh(f);
subplot(2,1,2)
fmesh(f(x,y)); % Or fmesh(sin(y));

Two mesh plots showing f(x,y) = sin(y), one plot with respect to the y-axis and the other plot with respect to the x-axis

バージョン履歴

R2016a で導入

参考

fmesh

構文

説明

例

シンボリック式の 3 次元のメッシュ プロット

シンボリック関数の 3 次元のメッシュ プロット

メッシュ プロットのプロット区間の指定

パラメーター化されたメッシュ プロット

入力引数

f — プロットする 3 次元式または関数 シンボリック式 | シンボリック関数

[min max] — x 軸と y 軸のプロット区間 [–5 5] (既定値) | 2 つの数値のベクトル

[xmin xmax ymin ymax] — x 軸と y 軸のプロット区間 [–5 5 –5 5] (既定値) | 4 つの数値のベクトル

funx,funy,funz — u と v のパラメトリック関数 シンボリック式 | シンボリック関数

[uvmin uvmax] — u と v のプロット区間 [–5 5] (既定値) | 2 つの数値のベクトル

[umin umax vmin vmax] — u と v のプロット区間 [–5 5 –5 5] (既定値) | 4 つの数値のベクトル

ax — axes オブジェクト axes オブジェクト

LineSpec — ライン スタイル、マーカー、色 string スカラー | 文字ベクトル

名前と値の引数

MeshDensity — 方向ごとの評価点の数 35 (既定値) | 数値

ShowContours — プロットの下に等高線図を表示 'off' (既定値) | on/off logical 値

EdgeColor — ラインの色 'interp' (既定値) | RGB 3 成分 | 16 進数のカラー コード | 'r' | 'g' | 'b' | ...

LineStyle — ライン スタイル "-" (既定値) | "--" | ":" | "-." | "none"

LineWidth — ライン幅 0.5 (既定値) | 正の値

Marker — マーカー記号 "none" (既定値) | "o" | "+" | "*" | "." | ...

MarkerEdgeColor — マーカーの輪郭の色 'auto' (既定値) | RGB 3 成分 | 16 進数のカラー コード | 'r' | 'g' | 'b' | ...

MarkerFaceColor — マーカーの塗りつぶし色 'none' (既定値) | 'auto' | RGB 3 成分 | 16 進数のカラー コード | 'r' | 'g' | 'b' | ...

MarkerSize — マーカー サイズ 6 (既定値) | 正の値

出力引数

obj — 1 つ以上のオブジェクト スカラー | ベクトル

ヒント

アルゴリズム

バージョン履歴

参考

関数

プロパティ

トピック

シンボリック式の 3 次元のメッシュプロット

シンボリック関数の 3 次元のメッシュプロット

メッシュプロットのプロット区間の指定

パラメーター化されたメッシュプロット

`f` — プロットする 3 次元式または関数
シンボリック式 | シンボリック関数

`[min max]` — x 軸と y 軸のプロット区間
[–5 5] (既定値) | 2 つの数値のベクトル

`[xmin xmax ymin ymax]` — x 軸と y 軸のプロット区間
[–5 5 –5 5] (既定値) | 4 つの数値のベクトル

`funx,funy,funz` — `u` と `v` のパラメトリック関数
シンボリック式 | シンボリック関数

`[uvmin uvmax]` — `u` と `v` のプロット区間
[–5 5] (既定値) | 2 つの数値のベクトル

`[umin umax vmin vmax]` — `u` と `v` のプロット区間
[–5 5 –5 5] (既定値) | 4 つの数値のベクトル

`ax` — axes オブジェクト
axes オブジェクト

`LineSpec` — ラインスタイル、マーカー、色
string スカラー | 文字ベクトル

`MeshDensity` — 方向ごとの評価点の数
35 (既定値) | 数値

`ShowContours` — プロットの下に等高線図を表示
`'off'` (既定値) | on/off logical 値

`EdgeColor` — ラインの色
`'interp'` (既定値) | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

`LineStyle` — ラインスタイル
`"-"` (既定値) | `"--"` | `":"` | `"-."` | `"none"`

`LineWidth` — ライン幅
`0.5` (既定値) | 正の値

`Marker` — マーカー記号
`"none"` (既定値) | `"o"` | `"+"` | `"*"` | `"."` | ...

`MarkerEdgeColor` — マーカーの輪郭の色
`'auto'` (既定値) | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

`MarkerFaceColor` — マーカーの塗りつぶし色
`'none'` (既定値) | `'auto'` | RGB 3 成分 | 16 進数のカラーコード | `'r'` | `'g'` | `'b'` | ...

`MarkerSize` — マーカーサイズ
`6` (既定値) | 正の値

`obj` — 1 つ以上のオブジェクト
スカラー | ベクトル