line
プリミティブ ラインの作成
説明
line は、点 (0,0) から (1,1) へのラインを、既定のプロパティ設定で描画します。
line(___, は、1 つ以上の名前と値の引数のペアを使用して、ラインの外観を変更します。たとえば、Name,Value)'LineWidth',3 はラインの幅を 3 ポイントに設定します。名前と値のペアは他のすべての入力引数の後で指定します。たとえば line('XData',x,'YData',y) のように名前と値のペアを使用してデータを指定する場合は、ベクトル データを指定しなければなりません。
line( は、現在の座標軸 (ax,___)gca) ではなく、ax で指定された直交座標軸、極座標軸または地理座標軸にラインを作成します。最初の入力引数として ax を指定します。
pl = line(___)Line オブジェクトを返します。作成した後で特定の Line オブジェクトのプロパティを変更するには pl を使用します。一覧については、Line のプロパティ を参照してください。
例
x と y をベクトルとして作成します。次に、x に対して y をプロットします。
x = linspace(0,10); y = sin(x); line(x,y)
x と y を行列として指定し、2 本のラインをプロットします。line を使用して、x の列に対して y の列を個別のラインとしてプロットします。
x = linspace(0,10)'; y = [sin(x) cos(x)]; line(x,y)
x、y、z の各値を指定して、3 次元座標にラインをプロットします。view(3) を使用して、座標軸を 3 次元表示に変更します。
t = linspace(0,10*pi,200); x = sin(t); y = cos(t); z = t; line(x,y,z) view(3)
x と y をベクトルとして作成します。次に、データを名前と値のペアの引数として指定して、関数 line の低水準なバージョンを呼び出します。関数をこのように呼び出すと、結果として得られるラインは黒になります。
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 オブジェクトを返します。次に、ラインを緑色の破線に変更します。プロパティの設定にはドット表記を使用します。
x = [3 2]; y = [15 12]; pl = line(x,y);
pl.Color = 'green'; pl.LineStyle = '--';
入力引数
名前と値の引数
オプションの引数のペアを 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" |
|
"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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
R2025a より前: ほとんどのプロットで、これらの色が既定で使用されます。 |
|
|
|
orderedcolors 関数と rgb2hex 関数を使用すると、これらのパレットの RGB 3 成分および 16 進数カラー コードを取得できます。たとえば、"gem" パレットの RGB 3 成分を取得し、16 進数カラー コードに変換します。
RGB = orderedcolors("gem");
H = rgb2hex(RGB);R2023b より前: RGB = get(groot,"FactoryAxesColorOrder") を使用して、RGB 3 成分を取得します。
R2024a より前: H = compose("#%02X%02X%02X",round(RGB*255)) を使用して、16 進数カラー コードを取得します。
例: line(x,y,'Color','blue')
例: line(x,y,'Color',[0.5 0.5 1])
例: line(x,y,'Color','#D9A2E9')
ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。
| ライン スタイル | 説明 | 結果として得られる線 |
|---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
マーカー記号。次の表に挙げる値のいずれかとして指定します。既定では、オブジェクトはマーカーを表示しません。マーカー記号を指定すると、各データ点または各頂点にマーカーが追加されます。
| マーカー | 説明 | 結果のマーカー |
|---|---|---|
"o" | 円 |
|
"+" | プラス記号 |
|
"*" | アスタリスク |
|
"." | 点 |
|
"x" | 十字 |
|
"_" | 水平線 |
|
"|" | 垂直線 |
|
"square" | 正方形 |
|
"diamond" | 菱形 |
|
"^" | 上向き三角形 |
|
"v" | 下向き三角形 |
|
">" | 右向き三角形 |
|
"<" | 左向き三角形 |
|
"pentagram" | 星形五角形 |
|
"hexagram" | 星形六角形 |
|
"none" | マーカーなし | 該当なし |
出力引数
ヒント
関数
plotとは異なり、関数lineはプロットの前にnewplotを呼び出しません。また、Figure や座標軸のNextPlotプロパティの値は考慮されません。現在の座標軸にラインが追加されるだけで、他のグラフィックス オブジェクトの削除や座標軸のプロパティのリセットは行われません。ただし、軸の範囲など一部の座標軸のプロパティは、ラインが収まるように更新される場合があります。
拡張機能
バージョン履歴
R2006a より前に導入SeriesIndex プロパティが、line 関数で作成されたラインで使用できるようになり、ラインは他のほとんどのプロットと同じ色 (およびオプションのライン スタイル) を順に使用します。
既定の色の変更は、x、y、およびオプションの z 引数を指定して作成したラインにのみ適用されます。名前と値の引数のみを使用する構文でラインを作成した場合、プロットは以前のリリースと同じように表示されます。
たとえば、x と y の入力引数で 2 つのラインを作成します。R2023b では、最初のラインは青で、2 番目のラインは赤みがかったオレンジ色になります。R2023b 以前では、どちらのラインも青でした。
line1 = line([0 1],[0 1]); line2 = line([0 1],[1 2]);
以前のリリースの動作を維持するには、ラインの SeriesIndex プロパティを 1 に設定します。プロパティは、関数 line を呼び出すときに名前と値の引数を使用して設定するか、後でドット表記を使用して Line オブジェクトに対して設定できます。
% Use a name-value argument line1 = line([0 1],[0 1],SeriesIndex=1); % Use dot notation line2 = line([0 1],[1 2]); line2.SeriesIndex = 1;
