yregion
説明
yregion(
は、y 座標の範囲に 1 つ以上の塗りつぶし領域を作成します。塗りつぶし領域を 1 つ作成するには、y1,y2
)y1
と y2
をスカラーとして指定します。塗りつぶし領域を複数作成するには、y1
と y2
を同じ長さのベクトルとして指定します。
yregion(
は複数の領域を行列として指定します。n 個の領域を作成するには、各領域の下限および上限を含む 2 行 n 列または n 行 2 列の行列として Y
)Y
を指定します。 (R2023b 以降)
yregion(
は、塗りつぶし領域のターゲット座標軸を指定します。前述の任意の構文で、最初の引数として ax
,___)ax
を指定します。
yregion(___,
は、1 つ以上の名前と値の引数を使用して領域のプロパティを指定します。複数の領域を作成した場合、プロパティの値はすべての領域に適用されます。たとえば、Name=Value
)yregion(5,10,FaceColor="yellow")
を使用して領域の色を黄色に設定できます。プロパティの一覧については、ConstantRegion Properties を参照してください。
yr = yregion(___)
は、1 つ以上の ConstantRegion
オブジェクトを返します。yr
を使用して、塗りつぶし領域の作成後にそのプロパティを設定します。プロパティの一覧については、ConstantRegion Properties を参照してください。
例
1 つの塗りつぶし領域の作成
ライン プロットおよび y=0
から y=106
までの範囲の塗りつぶし領域を作成します。
x = 0:0.1:50; y = 2*x .* (sin(x) + cos(2*x)); plot(x,y) yregion(0,106)
色と境界線のカスタマイズ
プロパティを設定することで領域の特性を変更できます。yregion
の呼び出し時に名前と値の引数を指定してプロパティを設定するか、後でドット表記を使用してプロパティを設定できます。
たとえば、塗りつぶし領域のあるプロットを作成し、名前と値の引数 FaceColor
と EdgeColor
を指定して塗りつぶしと境界線の色をカスタマイズします。また、出力引数を指定して ConstantRegion
オブジェクトを格納します。
x = 0:0.1:50;
y = 2*x .* (sin(x) + cos(2*x));
plot(x,y)
yr = yregion(0,106,FaceColor="b",EdgeColor=[0.4 0 0.7]);
ConstantRegion
オブジェクト yr
のプロパティを設定して外観をさらに変更します。FaceAlpha
プロパティと EdgeAlpha
プロパティを 0
から 1
までの数値 (1
は完全に不透明) に設定して、塗りつぶしの色と境界線の色の不透明度を変更します。さらに、LineWidth
プロパティを設定して境界線の太さを設定します。
yr.FaceAlpha = 0.1; yr.EdgeAlpha = 0.5; yr.LineWidth = 3;
下の境界線を -25
に動かします。
yr.Value = [-25 106];
複数の塗りつぶし領域と凡例の作成
始点と終点の座標を同じサイズのベクトルとして指定して、複数の塗りつぶし領域を作成できます。また、それらの領域のエントリを凡例に表示できます。
たとえば、2 つの塗りつぶし領域をもつ横棒グラフを作成します。後で変更できるように、出力引数を指定して両方の ConstantRegion
オブジェクトを格納します。
x = [1 2 3 4 13 11 2.5];
barh(x,DisplayName="Results")
yr = yregion([0.5 4.5],[2.5 6.5]);
FaceColor
プロパティを設定して、各領域の色を指定します。DisplayName
プロパティを設定して、凡例に表示する各領域のエントリ名を指定します。プロパティを設定するためにそれぞれの ConstantRegion
オブジェクトにアクセスするには、出力引数 yr
にインデックスを付けます。プロパティを設定した後、凡例を表示します。
yr(1).FaceColor = "r"; yr(1).DisplayName = "Low"; yr(2).FaceColor = "#88FE45"; yr(2).DisplayName = "High"; legend
duration
値の範囲の塗りつぶし領域の作成
5 つのバーが特定の分数に配置された横棒グラフを作成します。その後、2 番目のバーから 4 番目のバーまでの範囲に塗りつぶし領域を表示します。3 つのバーを領域内に含めるには、2 番目のバーの位置から 30 秒を差し引き、4 番目のバーの位置に 30 秒を加えて境界を計算します。
dur = minutes(1:5)'; y = [1 5 11 4 3]; barh(dur,y) yregion(dur(2)-seconds(30), dur(4)+seconds(30))
categorical
値の範囲の塗りつぶし領域の作成
categorical
データの横棒グラフを作成し、2 番目と 3 番目のバーにまたがる塗りつぶし領域を作成します。関数 reordercats
で棒グラフのカテゴリの順序を指定します。
cats = categorical(["Pumpkin" "Apple" "Pecan" "Cherry"]); cats = reordercats(cats,["Pumpkin" "Apple" "Pecan" "Cherry"]); barlengths = [15 21 33 12]; barh(cats,barlengths) yregion(cats(2),cats(3)) title("Favorite Pies")
非有界の塗りつぶし領域の作成
R2023b 以降
プロットを作成し、3 つの塗りつぶし領域を追加します。最初の行に下限が含まれ、2 番目の行に上限が含まれている 2 行 3 列の行列を指定します。最初の領域の下限は -Inf
で、最後の領域の上限は Inf
です。したがって、最初の領域と最後の領域は非有界です。
x = 0:0.1:50; y = 2*x .* (sin(x) + cos(2*x)); plot(x,y) Y = [-Inf -50 50; -100 0 Inf]; yregion(Y)
入力引数
y1,y2
— 始点と終点の y 座標
スカラーのペア | ベクトルのペア
塗りつぶし領域の始点と終点の y 座標。スカラーのペアまたはベクトルのペアとして指定します。塗りつぶし領域を 1 つ作成するには、y1
と y2
をスカラーとして指定します。塗りつぶし領域を複数作成するには、等しい長さのベクトルを指定します。領域の最小値および最大値は y1
または y2
で定義できます。そのため、yregion(1,5)
と yregion(5,1)
では同じ結果が得られます。
非有界の領域を作成するには、座標の 1 つを Inf
または -Inf
として指定します。 (R2023b 以降)
座標が NaN
値の場合、その座標に対して領域は表示されません。
例: yregion(5,10)
は、y=5
から y=10
までの範囲に塗りつぶし領域を作成します。
例: yregion([1 20],[10 30])
は、y=1
から y=10
までの範囲と y=20
から y=30
までの範囲に 1 つずつ、2 つの塗りつぶし領域を作成します。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
Y
— 複数の領域における始点の座標と終点の座標
2 行 n 列の行列 | n 行 2 列の行列
R2023b 以降
複数の領域における始点の座標と終点の座標。2 行 n 列または n 行 2 列の行列として指定します。ここで、n は領域の数です。
非有界の領域を作成するには、座標の 1 つを Inf
または -Inf
として指定します。
座標が NaN
値の場合、その座標に対して領域は表示されません。
例: yregion([1 3; 2 4])
は y=1
から y=2
までの塗りつぶし領域と、y=3
から y=4
までの塗りつぶし領域を作成します。
データ型: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| categorical
| datetime
| duration
ax
— ターゲット座標軸
Axes
オブジェクト
塗りつぶし領域のターゲット座標軸。Axes
オブジェクトとして指定します。この引数は、現在の座標軸ではなく、特定の Axes
オブジェクトに yregion
でプロットする場合に使用します。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。ここで Name
は引数名で、Value
は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。
例: yregion(5,10,FaceColor="yellow")
は、黄色の塗りつぶし領域を作成します。
メモ
ここでは、プロパティの一部だけを紹介しています。完全な一覧については、ConstantRegion Properties を参照してください。
FaceColor
— 塗りつぶし色
[0.4902 0.4902 0.4902]
(既定値) | RGB 3 成分 | 16 進数カラー コード | "r"
| "g"
| "b"
| ...
塗りつぶしの色。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" |
EdgeColor
— 境界線の色
"none"
(既定値) | RGB 3 成分 | 16 進数カラー コード | "r"
| "g"
| "b"
| ...
境界線の色。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" |
FaceAlpha
— 塗りつぶし色の透明度
0.3
(既定値) | 範囲 [0,1]
のスカラー
塗りつぶし色の透明度。[0,1]
の範囲のスカラーとして指定します。値 1
は不透明で、値 0
は完全に透明です。0
と 1
の間の値は一部透明です。
EdgeAlpha
— 境界線の透明度
1
(既定値) | 範囲 [0,1]
のスカラー
境界線の透明度。範囲 [0,1]
のスカラーとして指定します。値 1
は不透明で、値 0
は完全に透明です。0
と 1
の間の値は一部透明です。
LineStyle
— 境界線のスタイル
"-"
(既定値) | "--"
| ":"
| "-."
| "none"
境界線のスタイル。次の表にリストされたオプションのいずれかとして指定します。
ライン スタイル | 説明 | 結果として得られる線 |
---|---|---|
"-" | 実線 |
|
"--" | 破線 |
|
":" | 点線 |
|
"-." | 一点鎖線 |
|
"none" | ラインなし | ラインなし |
バージョン履歴
R2023a で導入R2023b: 非有界の領域の作成
Inf
または -Inf
を関数 yregion
に渡して非有界の塗りつぶし領域を作成します。
R2023b: 行列としての複数の領域の指定
座標の 2 つのベクトルを指定する代わりに、1 つの行列入力引数を指定して複数の領域を作成します。n 個の領域の場合、行列は 2 行 n 列または n 行 2 列で、すべての領域の下限と上限を含んでいる必要があります。
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)