ドキュメンテーション

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

line

プリミティブ ラインの作成

説明

line(x,y) はベクトル x および y のデータを使用して現在の座標軸にラインをプロットします。xy のうち一方または両方が行列の場合 line は複数のラインを描画します。関数 plot とは異なり、line は現在の座標軸にラインを追加する際に他のグラフィックス オブジェクトの削除や座標軸プロパティのリセットは行いません。

line(x,y,z) は 3 次元座標にラインをプロットします。

line は、点 (0,0) から (1,1) へのラインを、既定のプロパティ設定で描画します。

line('XData',x,'YData',y) は、line(x,y) の低水準版です。この動作は line(x,y) と同じですが、ラインに既定の色が設定されるという点が異なります。また、x または y を行列データに設定することもできません。

line('XData',x,'YData',y,'ZData',z) は、line(x,y,z) の低水準版です。この動作は line(x,y,z) と同じですが、ラインに既定の色が設定されるという点が異なります。また、xy または z を行列データに設定することもできません。

line(___,Name,Value) は、1 つ以上の名前と値の引数のペアを使用して、ラインの外観を変更します。たとえば、'LineWidth',3 はラインの幅を 3 ポイントに設定します。名前と値のペアは他のすべての入力引数の後で指定します。

line(ax,___) は、現在の座標軸 (gca) ではなく、ax で指定された座標軸にラインを作成します。最初の入力引数として ax を指定します。

pl = line(___) は、作成されたすべてのプリミティブ Line オブジェクトを返します。作成した後で特定の Line オブジェクトのプロパティを変更するには pl を使用します。一覧については、Line のプロパティ を参照してください。

すべて折りたたむ

xy をベクトルとして作成します。次に、x に対して y をプロットします。

x = linspace(0,10);
y = sin(x);
line(x,y)

xy を行列として指定し、2 本のラインをプロットします。line を使用して、x の列に対して y の列を個別のラインとしてプロットします。

x = linspace(0,10)';
y = [sin(x) cos(x)];
line(x,y)

xyz の各値を指定して、3 次元座標にラインをプロットします。view(3) を使用して、座標軸を 3 次元表示に変更します。

t = linspace(0,10*pi,200);
x = sin(t);
y = cos(t);
z = t;
line(x,y,z)
view(3)

xy をベクトルとして作成します。次に、関数 line の低水準なバージョンを使用して x に対して y をプロットします。

x = linspace(0,10);
y = sin(x);
line('XData',x,'YData',y)

点 (1,2) および (9,12) の間に赤色の破線を描画します。Color プロパティと LineStyle プロパティを名前と値のペアとして設定します。

x = [1 9];
y = [2 12];
line(x,y,'Color','red','LineStyle','--')

最初に、点 (3,15) から (2,12) までのラインを描画し、Line オブジェクトを返します。次に、ラインを緑色の破線に変更します。

メモ: R2014b から、プロパティの設定にドット表記を使用できるようになりました。それより前のリリースを使用している場合は、代わりに関数setを使用してください。

x = [3 2];
y = [15 12];
pl = line(x,y);

pl.Color = 'green';
pl.LineStyle = '--';

入力引数

すべて折りたたむ

x 値。ベクトルまたは行列として指定します。

例: x = linspace(0,10,25)

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

y 値。ベクトルまたは行列として指定します。

  • xy がいずれもベクトルで長さも同じである場合、line は 1 本のラインをプロットします。

  • xy が同じサイズの行列である場合、line は複数のラインをプロットします。この関数は x の列に対して y の列をプロットします。

  • xy のうち一方がベクトルでもう一方が行列である場合、line は複数のラインをプロットします。ベクトルの長さは、行列の次元のいずれかと等しくなければなりません。

    • ベクトルの長さと行列の行数が等しい場合、line はベクトルに対して行列の各列をプロットします。

    • ベクトルの長さと行列の列数が等しい場合、line はベクトルに対して行列の各行をプロットします。

    • 行列が正方行列の場合、line はベクトルに対して各列をプロットします。

例: y = sin(x)

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

z 値。ベクトルまたは行列として指定します。

  • xyz がすべて同じ長さのベクトルである場合、line は 1 本のラインをプロットします。

  • xyz がすべて同じサイズの行列である場合、line は行列の列を使用して複数のラインをプロットします。

  • xyz のうち 1 つまたは 2 つがベクトルで、残りが同じサイズの行列である場合、line は複数のラインをプロットします。ベクトルの長さは、行列の次元のいずれかと等しくなければなりません。

例: z = sin(x) + cos(y)

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

ターゲット座標軸。Axes オブジェクト、PolarAxes オブジェクト、または GeographicAxes オブジェクトとして指定します。座標軸を指定しない場合、関数 line は現在の座標軸でプロットします。

名前と値のペアの引数

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

例: line(x,y,'Color','red','LineWidth',3) は幅が 3 ポイントの赤色のラインを作成します。

ここでは、プロパティの一部だけを紹介しています。完全な一覧については、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'該当なし該当なし該当なし色なし

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'

例: line(x,y,'Color','blue')

例: line(x,y,'Color',[0.5 0.5 1])

例: line(x,y,'Color','#D9A2E9')

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

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

'--'破線

':'点線

'-.'一点鎖線

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

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

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

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

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

出力引数

すべて折りたたむ

プリミティブ line オブジェクト。ラインの作成後に、ラインのプロパティをクエリまたは変更するには、pl を使用します。一覧については、Line のプロパティ を参照してください。

ヒント

  • 関数 plot とは異なり、関数 line はプロットの前に newplot を呼び出しません。また、Figure や座標軸の NextPlot プロパティの値は考慮されません。現在の座標軸にラインが追加されるだけで、他のグラフィックス オブジェクトの削除や座標軸のプロパティのリセットは行われません。ただし、軸の範囲など一部の座標軸のプロパティは、ラインが収まるように更新される場合があります。

拡張機能

R2006a より前に導入