最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

fplot

式または関数をプロット

説明

fplot(f) は、x の既定の区間 [-5 5] に、関数 y = f(x) で定義された曲線をプロットします。

fplot(f,xinterval) は、指定された区間にプロットします。区間を [xmin xmax] の形式の 2 要素ベクトルとして指定します。

fplot(funx,funy) は、t の既定の区間 [-5 5]x = funx(t) および y = funy(t) で定義された曲線をプロットします。

fplot(funx,funy,tinterval) は、指定された区間にプロットします。区間を [tmin tmax] の形式の 2 要素ベクトルとして指定します。

fplot(___,LineSpec) は、ライン スタイル、マーカー記号およびラインの色を指定します。たとえば、'-r' は赤のラインをプロットします。このオプションは、前述の構文における任意の入力引数が組み合わされてから使用します。

fplot(___,Name,Value) は、1 つ以上の名前と値のペアの引数を使用して、ラインのプロパティを指定します。たとえば、'LineWidth',2 は、2 ポイントのライン幅を指定します。

fplot(ax,___) は、現在の座標軸 (gca) ではなく ax で指定される座標軸にプロットします。座標軸を最初の入力引数として指定します。

fp = fplot(___) は、入力に応じて FunctionLine オブジェクトまたは ParameterizedFunctionLine オブジェクトを返します。特定ラインのプロパティのクエリや変更を行うには、fp を使用します。プロパティの一覧については、FunctionLine のプロパティ または ParameterizedFunctionLine のプロパティ を参照してください。

[x,y] = fplot(___) は、プロットを作成せずに関数の横座標と縦座標を返します。この構文は将来のリリースで削除される予定です。代わりに、line オブジェクト fpXData プロパティおよび YData プロパティを使用してください。

メモ

fplot の許容誤差または評価点の数を指定する入力引数はサポートされなくなりました。評価点の数を指定するには、MeshDensity プロパティを使用します。

すべて折りたたむ

既定の x 区間 [-5 5]sin(x) をプロットします。

fplot(@(x) sin(x))

パラメトリック曲線 x=cos(3t) および y=sin(2t) をプロットします。

xt = @(t) cos(3*t);
yt = @(t) sin(2*t);
fplot(xt,yt)

次の区分的な関数をプロットします。

ex-3<x<0cos(x)0<x<3.

hold on を使用して、複数のラインをプロットします。fplot の 2 番目の入力引数を使用して、プロット区間を指定します。'b' を使用して、プロットするラインの色を青に指定します。同じ座標軸に複数のラインをプロットする場合、すべてのデータが組み込まれるように軸の範囲が調整されます。

fplot(@(x) exp(x),[-3 0],'b')
hold on
fplot(@(x) cos(x),[0 3],'b')
hold off
grid on

位相の異なる 3 つの正弦波をプロットします。1 番目には、2 ポイントのライン幅を使用します。2 番目には、円形マーカーを伴う赤の破線スタイルを指定します。3 番目には、アスタリスクのマーカーを伴うシアンの一点鎖線スタイルを指定します。

fplot(@(x) sin(x+pi/5),'Linewidth',2);
hold on
fplot(@(x) sin(x-pi/5),'--or');
fplot(@(x) sin(x),'-.*c')
hold off

sin(x) をプロットし、関数 line オブジェクトを変数に割り当てます。

fp = fplot(@(x) sin(x))

fp = 
  FunctionLine with properties:

     Function: @(x)sin(x)
        Color: [0 0.4470 0.7410]
    LineStyle: '-'
    LineWidth: 0.5000

  Show all properties

ドット表記を使用してプロパティを設定することにより、ラインを赤の点線に変更します。x 印のマーカーを追加し、マーカーの色を青に設定します。

fp.LineStyle = ':';
fp.Color = 'r';
fp.Marker = 'x';
fp.MarkerEdgeColor = 'b';

hold on を使用して 2 本のラインをプロットします。

fplot(@(x) sin(x))
hold on 
fplot(@(x) cos(x))
hold off

関数ハンドルを使用して、-2π から 2π まで sin(x) をプロットします。グリッド ラインを表示します。次に、タイトルを追加し、x 軸と y 軸にラベルを付けます。

fplot(@sin,[-2*pi 2*pi])
grid on
title('sin(x) from -2\pi to 2\pi')
xlabel('x');
ylabel('y');

gca を使用して現在の axes オブジェクトにアクセスします。π/2 の間隔で x 軸に目盛りを表示します。axes オブジェクトの XTick プロパティと XTickLabel プロパティを設定して、x 軸の目盛り値の書式を設定します。類似のプロパティが y 軸にも存在します。

ax = gca;
ax.XTick = -2*pi:pi/2:2*pi;
ax.XTickLabel = {'-2\pi','-3\pi/2','-\pi','-\pi/2','0','\pi/2','\pi','3\pi/2','2\pi'};

入力引数

すべて折りたたむ

プロット対象の関数。名前付き関数または無名関数の関数ハンドルとして指定します。

y = f(x) の形式の関数を指定します。関数は、ベクトルの入力引数を受け入れ、同じサイズのベクトルの出力引数を返さなければなりません。最高のパフォーマンスを得るには、行列演算子ではなく、配列演算子を使用します。たとえば、* (mtimes) ではなく .* (times) を使用します。

メモ

文字ベクトル入力のサポートは将来のリリースで削除される予定です。代わりに関数ハンドルを使用してください。

例: f = @(x) sin(x);

x の区間。[xmin xmax] の形式の 2 要素ベクトルとして指定します。

x 座標のパラメトリック関数。名前付き関数または無名関数の関数ハンドルとして指定します。

x = funx(t) の形式の関数を指定します。関数は、ベクトルの入力引数を受け入れ、同じサイズのベクトルの出力引数を返さなければなりません。最高のパフォーマンスを得るには、行列演算子ではなく、配列演算子を使用します。たとえば、* (mtimes) ではなく .* (times) を使用します。

例: funx = @(t) sin(2*t);

y 座標のパラメトリック関数。名前付き関数または無名関数の関数ハンドルとして指定します。

y = funy(t) の形式の関数を指定します。関数は、ベクトルの入力引数を受け入れ、同じサイズのベクトルの出力引数を返さなければなりません。最高のパフォーマンスを得るには、行列演算子ではなく、配列演算子を使用します。たとえば、* (mtimes) ではなく .* (times) を使用します。

例: funy = @(t) cos(3*t);

t の区間。[tmin tmax] の形式の 2 要素ベクトルとして指定します。

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

ラインの仕様。ライン スタイル、マーカーおよび色を含む文字ベクトルまたは string として指定します。要素は任意の順序で指定でき、1 つ以上のオプションを省略できます。接続ラインなしでマーカーのみを表示するには、マーカーを指定してライン スタイルを省略します。

例: 'r--o' は、赤色、破線および円形マーカーを指定します

ライン スタイル指定子説明
-実線 (既定の設定)
--破線
:点線
-.一点鎖線
マーカー指定子説明
o
+プラス記号
*アスタリスク
.
x十字
s正方形
d菱形
^上向き三角形
v下向き三角形
>右向き三角形
<左向き三角形
p星形五角形
h星形六角形
カラー指定子説明

y

m

マゼンタ

c

シアン

r

g

b

w

k

名前と値のペアの引数

オプションの Name,Value の引数ペアをコンマ区切りで指定します。Name は引数名で、Value は対応する値です。Name は引用符で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペアの引数を任意の順序で指定できます。

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

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、FunctionLine のプロパティ または ParameterizedFunctionLine のプロパティ を参照してください。

評価点の数。数値として指定します。既定値は 23 です。fplot では適応評価を使用するため、評価点の実際の数はそれより多くなります。

ラインの色。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'

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'

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

ライン スタイル説明結果として得られる線
'-'実線

'--'破線

':'点線

'-.'一点鎖線

'none'ラインなしラインなし

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

マーカー記号。次の表のいずれかの値として指定します。既定では、ラインにマーカーはありません。マーカー記号を指定することで、ライン上の選択した点にマーカーを追加します。

説明
'o'
'+'プラス記号
'*'アスタリスク
'.'
'x'十字
'square' または 's'正方形
'diamond' または 'd'菱形
'^'上向き三角形
'v'下向き三角形
'>'右向き三角形
'<'左向き三角形
'pentagram' または 'p'星形五角形
'hexagram' または 'h'星形六角形
'none'マーカーなし

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

カスタム色を使用する場合は、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'該当なし該当なし該当なし色なし

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'

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

カスタム色を使用する場合は、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'該当なし該当なし該当なし色なし

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'

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

出力引数

すべて折りたたむ

1 つ以上の FunctionLine オブジェクトまたは ParameterizedFunctionLine オブジェクト。スカラーまたはベクトルとして返されます。

  • fplot(f) の構文、あるいはこの構文の変形を使用した場合、fplotFunctionLine オブジェクトを返します。

  • fplot(funx,funy) の構文、あるいはこの構文の変形を使用した場合、fplotParameterizedFunctionLine オブジェクトを返します。

これらのオブジェクトは、特定のライン プロパティのクエリと変更に使用できます。プロパティの一覧については、FunctionLine のプロパティ および ParameterizedFunctionLine のプロパティ を参照してください。

ヒント

  • 最高のパフォーマンスを実現し、警告メッセージを回避するには、要素単位の演算子を使用します。たとえば、x*y ではなく x.*y を使用してください。詳細については、配列と行列の演算を参照してください。

  • チャートにズーム インすると、fplot はデータを再プロットします。これにより、表示されていなかった詳細が明らかになることがあります。

拡張機能

R2006a より前に導入