matplotlib.pyplot.errorbar #
- matplotlib.pyplot. errorbar ( x , y , yerr =なし, xerr =なし, fmt = '' , ecolor =なし, elinewidth =なし, capsize =なし, barsabove = False , lolims = False , uplims = False , xlolims = False , xuplims = False、errorevery = 1、 capthick =なし、 *、 data =なし、 ** kwargs ) [source] #
y 対 x を線および/またはエラーバー付きのマーカーとしてプロットします。
x、yはデータ位置を定義し、xerr、yerrはエラーバーのサイズを定義します。デフォルトでは、データ マーカー/ラインとエラーバーが描画されます。fmt='none' を使用して、データ マーカーなしでエラーバーを描画します。
- パラメータ:
- x、y浮動小数点数または配列のようなもの
データの位置。
- xerr、yerr float または配列のような、shape(N,) または shape(2, N)、オプション
エラーバーのサイズ:
スカラー: すべてのデータ ポイントの対称 +/- 値。
shape(N,): 各データ ポイントの対称 +/- 値。
shape(2, N): 各バーの - と + の値を分離します。最初の行には下位のエラーが含まれ、2 番目の行には上位のエラーが含まれます。
None : エラーバーはありません。
すべての値は >= 0 でなければなりません。
と の使用例については、エラー バーを指定するさまざまな方法を参照してください。
xerr
yerr
- fmt str、デフォルト: ''
データ ポイント/データ行の形式。詳細
plot
については、を参照してください。データ マーカーなしでエラーバーをプロットするには、'none' (大文字と小文字を区別しない) を使用します。
- ecolorカラー、デフォルト: なし
エラーバーの線の色。なしの場合は、マーカーを結ぶ線の色を使用します。
- elinewidth float、デフォルト: なし
エラーバー ラインの線幅。None の場合、現在のスタイルの線幅が使用されます。
- capsize float、デフォルト:
rcParams["errorbar.capsize"]
(デフォルト:0.0
) エラーバーの長さはポイント単位でキャップされます。
- capthick float、デフォルト: なし
キーワード引数markeredgewidth (別名mew ) のエイリアス。この設定は、エラー バー キャップの太さをポイント単位で制御するプロパティのより適切な名前です。下位互換性のために、mewまたはmarkeredgewidthが指定されている場合、それらはcapthickをオーバーライドします。これは、将来のリリースで変更される可能性があります。
- barsabove bool、デフォルト: False
True の場合、プロット シンボルの上にエラーバーをプロットします。デフォルトは以下。
- lolims、uplims、xlolims、xuplims bool、デフォルト: False
これらの引数は、値が上限/下限のみを示すことを示すために使用できます。その場合、これを示すためにキャレット記号が使用されます。lims -arguments は、スカラー、またはxerrおよびyerrと同じ長さの配列のようなものです。反転した軸で制限を使用するには、
set_xlim
またはのset_ylim
前に呼び出す必要がありますerrorbar()
。トリッキーなパラメーター名に注意してください 。eg lolimsを True に設定すると、y 値がTrue 値の下限になるため、上向きの矢印のみが描画されます。- errorevery int または (int, int)、デフォルト: 1
データのサブセットにエラー バーを描画します。errorevery =N は、ポイント (x[::N]、y[::N]) にエラー バーを描画します。 errorevery =(start, N) は点 (x[start::N], y[start::N]) にエラー バーを描画します。たとえば、errorevery=(6, 3) は、(x[6]、x[9]、x[12]、x[15]、...) のデータにエラー バーを追加します。2 つの系列が x 軸の値を共有する場合に、誤差範囲が重ならないようにするために使用されます。
- 戻り値:
ErrorbarContainer
コンテナには以下が含まれます:
plotline:
Line2D
x、y プロット マーカーおよび/または線のインスタンス。caplines:
Line2D
エラー バー キャップのインスタンスのタプル。barlinecols:
LineCollection
水平方向と垂直方向の誤差範囲のタプル。
- その他のパラメータ:
- データのインデックス可能なオブジェクト、オプション
指定された場合、次のパラメーターは string も受け入れます
s
。これは、次のように解釈されますdata[s]
(例外が発生しない限り)。x、y、xerr、yerr
- **kwargs
plot
他のすべてのキーワード引数は、マーカーを描画する呼び出しに渡されます。たとえば、次のコードは、太い緑の縁を持つ大きな赤い正方形を作成します。x, y, yerr = rand(3, 10) errorbar(x, y, yerr, marker='s', mfc='red', mec='green', ms=20, mew=4)
ここで、mfc、mec、ms、およびmewは、長いプロパティ名、markerfacecolor、markeredgecolor、markersize 、およびmarkeredgewidthのエイリアスです。
マーカー プロパティの有効な kwargs は次のとおりです。
ダッシュ
dash_capstyle
dash_joinstyle
ドロースタイル
フィルスタイル
線種
マーカー
マーカーエッジカラー
マーカーエッジ幅
マーカーフェイスカラー
マーカーフェイスカラー
マーカーサイズ
マークごと
solid_capstyle
solid_joinstyle
詳細については、対応する
Line2D
プロパティを参照してください。財産
説明
(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数
スカラーまたはなし
ブール
antialiased
またはああブール
ブール
パッチまたは (パス、変換) またはなし
color
またはc色
CapStyle
または {'butt', 'projecting', 'round'}JoinStyle
または {'miter', 'round', 'bevel'}float のシーケンス (ポイント単位のオン/オフ インク) または (None, None)
(2, N) 配列または 2 つの 1D 配列
drawstyle
またはds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, デフォルト: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
色またはなし
力
ブール
物体
linestyle
または ls{'-', '--', '-.', ':', '', (オフセット, オンオフシーケンス), ...}
linewidth
またはlw浮く
マーカー スタイル文字列、
Path
またはMarkerStyle
markeredgecolor
またはメック色
markeredgewidth
またはニャー浮く
markerfacecolor
またはmfc色
markerfacecoloralt
またはmfcalt色
markersize
またはミリ秒浮く
None または int または (int, int) または slice または list[int] または float または (float, float) または list[bool]
ブール
float または callable[[Artist, Event], tuple[bool, dict]]
わからない
ブール
(位取り: float、長さ: float、乱数: float)
ブールまたはなし
CapStyle
または {'butt', 'projecting', 'round'}JoinStyle
または {'miter', 'round', 'bevel'}わからない
力
ブール
一次元配列
一次元配列
浮く