matplotlib.pyplot.plot #
- matplotlib.pyplot. plot ( * args , scalex = True , scaley = True , data = None , ** kwargs ) [source] #
y 対 x を線やマーカーとしてプロットします。
呼び出し署名:
plot([x], y, [fmt], *, data=None, **kwargs) plot([x], y, [fmt], [x2], y2, [fmt2], ..., **kwargs)
ポイントまたはライン ノードの座標は、x、yで指定されます。
オプションのパラメーターfmtは、色、マーカー、線種などの基本的な書式設定を定義する便利な方法です。これは、以下の「注」セクションで説明されているショートカット文字列表記です。
>>> plot(x, y) # plot x and y using default line style and color >>> plot(x, y, 'bo') # plot x and y using blue circle markers >>> plot(y) # plot y using x as index array 0..N-1 >>> plot(y, 'r+') # ditto, but with red plusses
Line2Dプロパティをキーワード引数として使用して、外観をより詳細に制御できます。ライン プロパティとfmtを混在させることができます。次の 2 つの呼び出しでは、同じ結果が得られます。>>> plot(x, y, 'go--', linewidth=2, markersize=12) >>> plot(x, y, color='green', marker='o', linestyle='dashed', ... linewidth=2, markersize=12)
fmtと競合する場合は、キーワード引数が優先されます。
ラベル付きデータのプロット
ラベル付きデータ (つまり、 index でアクセスできるデータ) を持つオブジェクトをプロットする便利な方法があります
obj['y']。xとyでデータを指定する代わりに、 dataパラメータでオブジェクトを指定して、 xとy のラベルを指定するだけです。>>> plot('xlabel', 'ylabel', data=obj)
すべてのインデックス可能なオブジェクトがサポートされています。これは、たとえば a
dict、 apandas.DataFrameまたは構造化された numpy 配列である可能性があります。複数のデータ セットのプロット
複数のデータ セットをプロットするには、さまざまな方法があります。
最も簡単な方法は、
plot複数回呼び出すことです。例：>>> plot(x1, y1, 'bo') >>> plot(x2, y2, 'go')
xおよび/またはyが 2D 配列の場合、列ごとに個別のデータ セットが描画されます。xとyの両方が 2D の場合、それらは同じ形状でなければなりません。それらの 1 つだけが形状 (N, m) の 2D である場合、もう 1 つは長さ N である必要があり、すべてのデータセット m に使用されます。
例：
>>> x = [1, 2, 3] >>> y = np.array([[1, 2], [3, 4], [5, 6]]) >>> plot(x, y)
次と同等です。
>>> for col in range(y.shape[1]): ... plot(x, y[:, col])
3 番目の方法は、 [x]、y、[fmt] グループの複数のセットを指定することです。
>>> plot(x1, y1, 'g^', x2, y2, 'g-')
この場合、追加のキーワード引数はすべてのデータセットに適用されます。また、この構文はdata パラメータと組み合わせることはできません。
デフォルトでは、各行には「スタイル サイクル」によって指定された異なるスタイルが割り当てられます。fmtおよび line プロパティ パラメータは、これらのデフォルトからの明示的な逸脱が必要な場合にのみ必要です。
rcParams["axes.prop_cycle"]または、 (デフォルト: )を使用してスタイル サイクルを変更することもできます 。cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])- パラメータ:
- x, y配列状またはスカラー
データ ポイントの水平/垂直座標。 x値はオプションで、デフォルトは です
range(len(y))。通常、これらのパラメーターは 1D 配列です。
また、スカラーまたは 2 次元にすることもできます (その場合、列は個別のデータ セットを表します)。
これらの引数は、キーワードとして渡すことはできません。
- fmt文字列、オプション
書式文字列。例: 赤い丸の場合は 'ro'。 フォーマット文字列の完全な説明については、注のセクションを参照してください。
書式文字列は、基本的な線のプロパティをすばやく設定するための省略形です。これらはすべて、キーワード引数によって制御することもできます。
この引数はキーワードとして渡すことはできません。
- データのインデックス可能なオブジェクト、オプション
ラベル付きデータを持つオブジェクト。指定されている場合は、 xおよびyにプロットするラベル名を指定します。
ノート
技術的には、2 番目のラベルが有効なfmtである呼び出しには若干のあいまいさがあります。または である可能性があります。このような場合、前者の解釈が選択されますが、警告が発行されます。空のフォーマット文字列を追加することで、警告を抑制することができます 。
plot('n', 'o', data=obj)plt(x, y)plt(y, fmt)plot('n', 'o', '', data=obj)
- 戻り値:
- のリスト
Line2D プロットされたデータを表す線のリスト。
- のリスト
- その他のパラメータ:
- scalex、scaley bool、デフォルト: True
これらのパラメーターは、ビュー制限がデータ制限に適合するかどうかを決定します。値は に渡され
autoscale_viewます。- **kwargs
Line2Dプロパティ、オプション kwargsは、線ラベル (自動凡例用)、線幅、アンチエイリアシング、マーカー面の色などのプロパティを指定するために使用されます。例：
>>> plot([1, 2, 3], [1, 2, 3], 'go-', label='line 1', linewidth=2) >>> plot([1, 2, 3], [1, 4, 9], 'rs', label='line 2')
1 回の plot 呼び出しで複数の行を指定すると、kwargs はそれらすべての行に適用されます。ラベル オブジェクトが反復可能な場合、各要素は各データ セットのラベルとして使用されます。
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またはMarkerStylemarkeredgecolorまたはメック色
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'}わからない
力
ブール
一次元配列
一次元配列
浮く
こちらもご覧ください
scatterさまざまなサイズや色のマーカーを使用した XY 散布図 (バブル チャートとも呼ばれます)。
ノート
フォーマット文字列
フォーマット文字列は、色、マーカー、および線の部分で構成されます。
fmt = '[marker][line][color]'
それぞれオプションです。指定しない場合は、スタイル サイクルの値が使用されます。例外:
lineが指定されていて、 が指定されていないmarker場合、データはマーカーのない行になります。などの他の組み合わせ
[color][marker][line]もサポートされていますが、それらの解析はあいまいになる可能性があることに注意してください。マーカー
キャラクター
説明
'.'ポイントマーカー
','ピクセル マーカー
'o'サークルマーカー
'v'三角形の下向きマーカー
'^'三角形上マーカー
'<'三角形_左マーカー
'>'三角形_右マーカー
'1'tri_down マーカー
'2'tri_up マーカー
'3'tri_left マーカー
'4'tri_right マーカー
'8'オクタゴンマーカー
's'四角いマーカー
'p'五角形マーカー
'P'プラス (塗りつぶし) マーカー
'*'スターマーカー
'h'六角形1マーカー
'H'六角形 2 マーカー
'+'プラスマーカー
'x'×マーカー
'X'×（塗りつぶし）マーカー
'D'ダイヤモンドマーカー
'd'thin_diamond マーカー
'|'垂直線マーカー
'_'水平線マーカー
線種
キャラクター
説明
'-'実線スタイル
'--'破線のスタイル
'-.'一点鎖線のスタイル
':'点線スタイル
フォーマット文字列の例:
'b' # blue markers with default shape 'or' # red circles '-g' # green solid line '--' # dashed line with default color '^k:' # black triangle_up markers connected by a dotted line
色
サポートされている色の略語は、1 文字のコードです
キャラクター
色
'b'青い
'g'緑
'r'赤
'c'シアン
'm'赤紫色
'y'黄色
'k'黒
'w'白い
そして、
'CN'デフォルトのプロパティ サイクルにインデックスを付ける色。色がフォーマット文字列の唯一の部分である場合は、
matplotlib.colorsフルネーム ('green') や 16 進文字列 ( ) など、任意の仕様を追加で使用できます'#008000'。
