matplotlib.pyplot.fill_between #

matplotlib.pyplot. fill_ between ( x , y1 , y2 = 0 , where = None , interpolate = False , step = None , * , data = None , ** kwargs ) [source] #

2 つの水平曲線の間の領域を塗りつぶします。

曲線は点 ( x , y1 ) と ( x , y2 ) によって定義されます。これにより、塗りつぶされた領域を表す 1 つまたは複数の多角形が作成されます。

whereを使用して、一部の水平セクションを塗りつぶしから除外できます。

デフォルトでは、エッジは指定されたポイントを直接接続します。塗りつぶしがステップ 関数、つまり xの間の定数である必要がある場合は、 stepを使用します。

パラメータ:

x配列 (長さ N)

曲線を定義するノードの x 座標。

y1配列 (長さ N) またはスカラー

最初のカーブを定義するノードの y 座標。

y2配列 (長さ N) またはスカラー、デフォルト: 0

2 番目のカーブを定義するノードの y 座標。

bool (長さ N) の配列、オプション

一部の水平領域を塗りつぶしから除外する場所を定義します。塗りつぶされた領域は、座標によって定義されますx[where]。より正確には、x[i]とx[i+1]if の間を埋めます。この定義は、 where内の 2 つのFalse値の間の孤立したTrue値は、塗りつぶされないことを意味することに注意してください。True位置の両側は、隣接するFalse値のために埋められないままです。where[i] and where[i+1]

ブール値を補間、デフォルト: False

このオプションは、whereが使用され、2 つの曲線が互いに交差している場合にのみ関連します。

意味的に、whereはy1 > y2などによく使用されます。デフォルトでは、塗りつぶされた領域を定義する多角形のノードは、x配列内の位置にのみ配置されます。このような多角形は、交差点に近い上記のセマンティクスを記述できません。交点を含む x セクションは単純に切り取られます。

interpolateをTrueに設定すると、実際の交点が計算され、塗りつぶされた領域がこの点まで拡張されます。

ステップ{'pre', 'post', 'mid'}, オプション

塗りつぶしがステップ関数、つまりxの間の定数である必要がある場合は、 stepを定義します。値によって、ステップが発生する場所が決まります。

'pre': y 値は、すべてのx位置から常に左に続きます。つまり、間隔の値はです。(x[i-1], x[i]]y[i]
'post': y の値は、すべてのx位置から常に右側に続きます。つまり、間隔の値はです。[x[i], x[i+1])y[i]
'mid': ステップはx位置の中間で発生します。

戻り値:

PolyCollection: PolyCollectionプロットされたポリゴンを含む。

その他のパラメータ:

データのインデックス可能なオブジェクト、オプション

指定された場合、次のパラメーターは string も受け入れますs。これは、次のように解釈されますdata[s](例外が発生しない限り)。

x、y1、y2、ここで

**kwargs

他のすべてのキーワード引数はに渡されPolyCollectionます。Polygonプロパティを制御します。

財産	説明
`agg_filter`	(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
`alpha`	配列状またはスカラーまたはなし
`animated`	ブール
`antialiased`または aa またはアンチエイリアス	bool または bool のリスト
`array`	配列のようなものまたはなし
`capstyle`	`CapStyle`または {'butt', 'projecting', 'round'}
`clim`	(vmin: float、vmax: float)
`clip_box`	`Bbox`
`clip_on`	ブール
`clip_path`	パッチまたは (パス、変換) またはなし
`cmap`	`Colormap`または str または None
`color`	色または rgba タプルのリスト
`edgecolor`または ec または edgecolors	色または色のリストまたは「顔」
`facecolor`またはfacecolorsまたはfc	色または色のリスト
`figure`	`Figure`
`gid`	力
`hatch`	{'/'、'\'、'\|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
`in_layout`	ブール
`joinstyle`	`JoinStyle`または {'miter', 'round', 'bevel'}
`label`	物体
`linestyle`またはダッシュまたはラインスタイルまたはls	str またはタプルまたはそのリスト
`linewidth`または線幅または lw	float または float のリスト
`mouseover`	ブール
`norm`	`Normalize`または str または None
`offset_transform`またはtransOffset	わからない
`offsets`	(N, 2) または (2,) 配列のようなもの
`path_effects`	`AbstractPathEffect`
`paths`	配列ライクのリスト
`picker`	None または bool または float または callable
`pickradius`	わからない
`rasterized`	ブール
`sizes`	ndarray またはなし
`sketch_params`	(位取り: float、長さ: float、乱数: float)
`snap`	ブールまたはなし
`transform`	`Transform`
`url`	力
`urls`	str または None のリスト
`verts`	配列ライクのリスト
`verts_and_codes`	わからない
`visible`	ブール
`zorder`	浮く

こちらもご覧ください

fill_between: 2 セットの y 値の間を塗りつぶします。
fill_betweenx: 2 セットの x 値の間を塗りつぶします。