Main Content

line

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

説明

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

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

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

line(___,Name,Value) は、1 つ以上の名前と値の引数のペアを使用して、ラインの外観を変更します。たとえば、'LineWidth',3 はラインの幅を 3 ポイントに設定します。名前と値のペアは他のすべての入力引数の後で指定します。たとえば line('XData',x,'YData',y) のように名前と値のペアを使用してデータを指定する場合は、ベクトル データを指定しなければなりません。

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

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

すべて折りたたむ

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

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

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

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

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

Figure contains an axes object. The axes object contains 2 objects of type line.

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)

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

xy をベクトルとして作成します。次に、データを名前と値のペアの引数として指定して、関数 line の低水準なバージョンを呼び出します。関数をこのように呼び出すと、結果として得られるラインは黒になります。

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

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

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

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

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

最初に、点 (3,15) から (2,12) までのラインを描画し、Line オブジェクトを返します。次に、ラインを緑色の破線に変更します。プロパティの設定にはドット表記を使用します。

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

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

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

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

入力引数

すべて折りたたむ

1 番目の座標。ベクトルまたは行列として指定します。行列の入力は、直交座標軸でのみサポートされています。

1 番目の座標の解釈は、座標軸のタイプによって異なります。直交座標軸の場合、1 番目の座標はデータ単位での x 軸上の位置です。

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

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

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

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

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

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

極座標軸の場合、1 番目の座標はラジアン単位での極角度 θ です。地理座標軸の場合、1 番目の座標は度単位の緯度です。これらのタイプの座標軸にプロットするには、xy は同じサイズでなければなりません。

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

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

2 番目の座標。ベクトルまたは行列として指定します。行列の入力は、直交座標軸でのみサポートされています。

2 番目の座標の解釈は、座標軸のタイプによって異なります。直交座標軸の場合、2 番目の座標はデータ単位での y 軸上の位置です。

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

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

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

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

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

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

極座標軸の場合、2 番目の座標はデータ単位での半径です。地理座標軸の場合、2 番目の座標は度単位の経度です。これらのタイプの座標軸にプロットするには、xy は同じサイズでなければなりません。

例: y = sin(x)

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

3 番目の座標。ベクトルまたは行列として指定します。行列の入力は、直交座標軸でのみサポートされています。

3 番目の座標の解釈は、座標軸のタイプによって異なります。直交座標軸の場合、3 番目の座標はデータ単位での z 軸上の位置です。

  • xy、および z がすべて同じ長さのベクトルである場合、line は単一の 3 次元ラインをプロットします。

  • xy、および z がすべて同じサイズの行列である場合、line は行列の列を使用して複数の 3 次元ラインをプロットします。

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

極座標軸と地理座標軸の場合、3 番目の座標は座標軸上の 2 次元ラインの重ね合わせに影響します。これらのタイプの座標軸で 3 番目の座標を使用するには、xy および z が同じサイズでなければなりません。

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

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

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

名前と値の引数

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

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

例: 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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

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

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

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

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

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

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

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

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

"none"ラインなしラインなし

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

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

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

マーカー説明結果のマーカー
"o"

Sample of circle marker

"+"プラス記号

Sample of plus sign marker

"*"アスタリスク

Sample of asterisk marker

"."

Sample of point marker

"x"十字

Sample of cross marker

"_"水平線

Sample of horizontal line marker

"|"垂直線

Sample of vertical line marker

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond marker

"^"上向き三角形

Sample of upward-pointing triangle marker

"v"下向き三角形

Sample of downward-pointing triangle marker

">"右向き三角形

Sample of right-pointing triangle marker

"<"左向き三角形

Sample of left-pointing triangle marker

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

"none"マーカーなし該当なし

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

出力引数

すべて折りたたむ

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

ヒント

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

拡張機能

バージョン履歴

R2006a より前に導入

すべて展開する