semilogx
片対数プロット (x 軸が対数スケールをもつ)
構文
説明
ベクトルと行列のデータ
semilogx( は、Y)Y を暗黙的な x 座標のセットに対してプロットします。
Yがベクトルの場合、x 座標は 1 からlength(Y)までの範囲となります。Yが行列の場合、プロットにはYの各列に対して 1 本のラインが含まれます。x 座標の範囲は、1 からYの行数までです。
Y に複素数が含まれている場合、semilogx は Y の実数部に対して Y の虚数部をプロットします。ただし、X と Y の両方を指定すると、MATLAB® は虚数部を無視します。
テーブル データ
追加オプション
semilogx(___, は、1 つ以上の Name,Value)Name,Value のペアの引数を使用して、Line のプロパティを指定します。このプロパティはプロットされるすべてのラインに適用されます。前述の任意の構文で、すべての引数の後に Name,Value ペアを指定します。プロパティの一覧については、Line のプロパティ を参照してください。
p = semilogx(___) は、Line オブジェクトまたは Line オブジェクトの配列を返します。プロットのプロパティを作成後に変更するには、p を使用します。プロパティの一覧については、Line のプロパティ を参照してください。
例
x を 0.1 から 100 の対数的に等間隔な値のベクトルとして定義し、y を x のコピーとして定義します。x と y の線形-対数プロットを作成し、関数 grid を呼び出してグリッド ラインを表示します。
x = logspace(-1,2);
y = x;
semilogx(x,y)
grid on
1 つの対数的に等間隔な x 座標軸のベクトルと 2 つの y 座標軸のベクトルを作成します。コンマ区切りの x-y ペアを semilogx に渡して、2 本のラインをプロットします。
x = logspace(-1,2);
y1 = x;
y2 = -x;
semilogx(x,y1,x,y2)
grid on
f を 10 Hz から 100,000 Hz の周波数を含むベクトルとして定義します。gain をデシベル単位の電力ゲイン値のベクトルとして定義します。次に、周波数に対してゲイン値をプロットします。
f = logspace(1,5,100);
v = linspace(-50,50,100);
gain = (1-exp(5*(2.5*v.^2)./7500))/14;
semilogx(f,gain)
grid on
関数 yticks を呼び出して、y 軸の目盛り値を y 軸に沿って 0 または正の整数の増分で再配置します。次に、関数 xlabel および関数 ylabel を呼び出して x 軸および y 軸のラベルを作成します。
yticks([-5 -4 -3 -2 -1 0]) xlabel ('Frequency (Hz)') ylabel('Power Gain (dB)')
x 座標軸と y 座標軸のセットを作成し、線形-対数プロットに表示します。ラインのスタイルを 'o' として指定して、ラインを接続せずに円のマーカーを表示します。マーカーの塗りつぶし色を RGB 3 成分 [0 0.447 0.741] として指定します。これは濃い青色に対応します。
x = logspace(-1,2,15); y = 12 + x; semilogx(x,y,'o','MarkerFaceColor',[0 0.447 0.741]) grid on
1 つの対数的に等間隔な x 座標軸のベクトルと 2 つの y 座標軸のベクトルを作成します。次に、コンマ区切りの x-y ペアを semilogx に渡して、2 本のラインをプロットします。関数 legend を呼び出して凡例を表示します。
x = logspace(1,4,100); v = linspace(-50,50,100); y1 = 100*exp(-1*((v+5).^2)./200); y2 = 100*exp(-1*(v.^2)./200); semilogx(x,y1,x,y2,'--') legend('Measured','Estimated') grid on
1 つの座標軸ベクトルを指定すると、semilogx はそれらの座標軸を 1:length(y) の値に対してプロットします。たとえば、y を 0 から 40 までの 5 つの値のベクトルとして定義します。y の線形-対数プロットを作成します。
y = [0 10 20 30 40];
semilogx(y)
grid on
y を行列として指定する場合、y の列は値 1:size(y,1) に対してプロットされます。たとえば y を 5 行 3 列の行列として定義し、関数 semilogx に渡すとします。結果のプロットには 3 本のラインが含まれ、そのそれぞれが 1 から 5 の範囲の x 座標軸をもちます。
y = [ 0 10 20
10 20 30
20 30 40
30 40 50
40 50 60];
semilogx(y)
grid on
R2022a 以降
table のデータをプロットするには、table を関数 semilogx に渡してプロット対象の変数を指定すると便利です。
2 変数を含む table を作成します。次に、table の最初の 3 行を表示します。
Input = logspace(-1,2)'; Output = 2*Input; tbl = table(Input,Output); head(tbl,3)
Input Output
_______ _______
0.1 0.2
0.11514 0.23028
0.13257 0.26514
変数 Input を "x" 軸にプロットし、変数 Output を "y" 軸にプロットします。Line オブジェクトを p として返し、座標軸のグリッドをオンにします。軸ラベルが変数名と一致することに注目してください。
p = semilogx(tbl,"Input","Output"); grid on
ラインの要素を変更するには、Line オブジェクトの LineStyle プロパティ、Color プロパティ、Marker プロパティを設定します。たとえば、ラインを、点マーカーを使った赤い点線に変更します。
p.LineStyle = ":"; p.Color = "red"; p.Marker = ".";
R2022a 以降
3 変数を含む table を作成します。次に、table の最初の 3 行を表示します。
Input = logspace(-1,2)'; Output1 = 2*Input; Output2 = -Input; tbl = table(Input,Output1,Output2); head(tbl,3)
Input Output1 Output2
_______ _______ ________
0.1 0.2 -0.1
0.11514 0.23028 -0.11514
0.13257 0.26514 -0.13257
変数 Input を "x" 軸にプロットし、変数 Output1 および Output2 を "y" 軸にプロットします。凡例を追加します。凡例ラベルは変数名と一致することに注意してください。
semilogx(tbl,"Input",["Output1" "Output2"]) grid on legend
タイル表示チャート レイアウトを 'flow' タイル配置に作成して、座標軸がそのレイアウトの使用可能なスペースを塗りつぶすようにします。次に、関数 nexttile を呼び出して axes オブジェクトを作成し、それを ax1 として返します。その後、関数 semilogx に ax1 を渡して線形-対数プロットを表示します。
tiledlayout('flow')
ax1 = nexttile;
x = logspace(-1,2);
y1 = 1./x;
semilogx(ax1,x,y1)
このプロセスを繰り返して 2 番目の線形-対数プロットを作成します。
ax2 = nexttile; y2 = x; semilogx(ax2,x,y2)
2 つのラインを含む線形-対数プロットを作成し、変数 slg 内のライン オブジェクトを返します。
x = logspace(-1,2); y1 = x; y2 = -x; slg = semilogx(x,y1,x,y2);
1 つ目のラインの幅を 3 に変更し、2 つ目のラインの色を紫に変更します。
slg(1).LineWidth = 3; slg(2).Color = [0.4 0 1];
データの不連続な位置に NaN 値を挿入します。関数 semilogx は、それらの位置のギャップを表示します。
x 座標ベクトルと y 座標ベクトルのペアを作成します。40 番目の y 座標を NaN 値に置き換えます。次に、x と y の線形-対数プロットを作成します。
x = logspace(-1,2); y = x; y(40) = NaN; semilogx(x,y)
入力引数
対数スケールの座標。スカラー、ベクトルまたは行列として指定します。X のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。
| プロットのタイプ | 座標の指定方法 |
|---|---|
| 1 つの点 |
semilogx(1,2,'o') |
| 1 つの点集合 |
semilogx([1 2 3],[4; 5; 6]) |
| 複数の点集合 (ベクトルを使用) | 連続するベクトル semilogx([1 2 3],[4 5 6],[1 2 3],[7 8 9]) |
| 複数の点集合 (行列を使用) | すべてのセットが同じ x 座標または y 座標を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。以下に例を示します。 semilogx([1 2 3],[4 5 6; 7 8 9]) semilogx は行列の各列について 1 つのラインをプロットします。 または、 semilogx([1 2 3; 4 5 6],[7 8 9; 10 11 12]) |
semilogx は、場合によっては座標を除外することがあります。
対数スケールの座標に正の値と負の値が含まれている場合、正の値のみが表示されます。
対数スケールの座標がすべて負の場合、すべての値が対数スケールで、適切な符号付きで表示されます。
ゼロの対数スケール値は表示されません。
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
線形スケールの座標。スカラー、ベクトルまたは行列として指定します。Y のサイズと形状は、データの形状と作成するプロットのタイプによって異なります。次の表では、最も一般的な状況について説明します。
| プロットのタイプ | 座標の指定方法 |
|---|---|
| 1 つの点 |
semilogx(1,2,'o') |
| 1 つの点集合 |
semilogx([1 2 3],[4; 5; 6]) |
| 複数の点集合 (ベクトルを使用) | 連続するベクトル semilogx([1 2 3],[4 5 6],[1 2 3],[7 8 9]) |
| 複数の点集合 (行列を使用) | すべてのセットが同じ x 座標または y 座標を共有している場合は、共有している座標をベクトルとして、その他の座標を行列として指定します。ベクトルの長さは行列の次元の 1 つと一致していなければなりません。以下に例を示します。 semilogx([1 2 3],[4 5 6; 7 8 9]) semilogx は行列の各列について 1 つのラインをプロットします。または、 semilogx([1 2 3; 4 5 6],[7 8 9; 10 11 12]) |
データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration
ライン スタイル、マーカー、および色。記号を含む 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] |
|
プロットするデータが含まれるソース table。table または timetable として指定します。
x 座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。
| インデックス方式 | 例 |
|---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
指定する table 変数には、任意の数値を含めることができます。ただし、semilogx は、X を負またはゼロの値を含むベクトルとして指定する場合と同様に、負とゼロの値をプロットから除外する可能性があります。
xvar と yvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。
例: semilogx(tbl,["x1","x2"],"y") は、x 座標用に x1 および x2 という名前の table 変数を指定します。
例: semilogx(tbl,2,"y") は、x 座標用に 2 番目の変数を指定します。
例: semilogx(tbl,vartype("numeric"),"y") は、x 座標用にすべての数値変数を指定します。
y 座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。
| インデックス方式 | 例 |
|---|---|
変数名:
|
|
変数インデックス:
|
|
変数の型:
|
|
指定する table 変数には、数値、categorical 値、datetime 値、または duration 値を含めることができます。xvar と yvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。
例: semilogx(tbl,"x",["y1","y2"]) は、y 座標用に y1 および y2 という名前の table 変数を指定します。
例: semilogx(tbl,"x",2) は、y 座標用に 2 番目の変数を指定します。
例: semilogx(tbl,"x",vartype("numeric")) は、y 座標用にすべての数値変数を指定します。
ターゲット座標軸。Axes オブジェクトとして指定します。座標軸を指定せず、現在の座標軸が直交座標軸の場合、semilogx は現在の座標軸を使用します。
名前と値の引数
オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。
R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。
例: semilogx([1 2],[3 4],'Color','red') はプロットに赤のラインを指定します。
メモ
ここには一部のプロパティのみを示します。完全な一覧については、Line のプロパティ を参照してください。
色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。指定した色がラインの色に設定されます。MarkerEdgeColor プロパティが 'auto' に設定されている場合は、マーカー エッジの色も設定されます。
カスタム色を使用する場合は、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 進数カラー コードを取得します。
マーカーの輪郭の色。"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" | 該当なし | 該当なし | 該当なし | 色なし |
次の表に、ライト テーマとダーク テーマでのプロットの既定のカラー パレットを示します。
| パレット | パレットの色 |
|---|---|
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 進数カラー コードを取得します。
マーカーの塗りつぶし色。"auto"、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。"auto" オプションは親座標軸の Color プロパティと同じ色を使用します。"auto" を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は Figure の色です。
カスタム色を使用する場合は、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 進数カラー コードを取得します。
ヒント
関数
semilogxは座標軸のColorOrderプロパティとLineStyleOrderプロパティに基づく色とライン スタイルを使用します。semilogxは最初のライン スタイルで色を順番に使用します。次に、以降のライン スタイルのそれぞれについて再び色を順番に使用します。座標軸の
ColorOrderプロパティやLineStyleOrderプロパティを設定することによって、プロット後に色やライン スタイルを変更できます。また、関数colororderを呼び出して、Figure 内のすべての座標軸の色の順序を変更することもできます。
アルゴリズム
関数 semilogx は、座標軸の XScale プロパティを 'log' に設定して、x 座標を対数スケールでプロットします。ただし、座標軸 hold の状態が semilogx を呼び出す前に 'on' である場合、プロパティは変更されず、x 座標が線形スケール上に表示される場合があります。
拡張機能
バージョン履歴
R2006a より前に導入関数 semilogx に 1 つの table と 1 つ以上の変数名を渡した場合に、table 変数名に含めた特殊文字 (アンダースコアなど) が軸ラベルと凡例ラベルに表示されるようになりました。以前は、特殊文字は TeX または LaTeX の文字として解釈されていました。
たとえば、Sample_Number という名前の変数を含む table を関数 semilogx に渡すと、軸ラベルと凡例ラベルにアンダースコアが表示されます。R2022a 以前のリリースでは、アンダースコアは下付き文字として解釈されます。
| リリース | table 変数 "Sample_Number" のラベル |
|---|---|
R2022b |
|
R2022a |
|
軸ラベルと凡例ラベルを TeX または LaTeX の書式設定で表示するには、ラベルを手動で指定します。たとえば、プロット後に、目的のラベル文字列を指定して関数 xlabel または関数 legend を呼び出します。
xlabel("Sample_Number") legend(["Sample_Number" "Another_Legend_Label"])
