このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

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

例

追加の例:fsurf のページを参照

メモ

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

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

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

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

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

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

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

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

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

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

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

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

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

$$0<s<2\pi$$ と $$0<t<\pi$$ で行います。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)

追加の例:fsurf のページを参照

メモ

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

入力引数

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 進数のカラー コードの一覧です。

色の名前	省略名	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 進数のカラー コードの一覧です。

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

たとえば、次のコードは f(x,y) = sin(y) のメッシュを 2 つの方法でプロットします。1 つ目の方法では、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));

バージョン履歴

R2016a で導入

参考

関数

• fcontour | fimplicit | fimplicit3 | fplot | fplot3 | fsurf

プロパティ

• FunctionSurface のプロパティ | ParameterizedFunctionSurface のプロパティ

トピック

• プロットの作成

×

例を開く

この例の変更されたバージョンがあります。編集された方の例を開きますか?

いいえ、変更されたバージョンを上書きします。 はい