matplotlib.axes.Axes.plot #

軸。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)

ポイントまたはライン ノードの座標は、xyで指定されます。

オプションのパラメーター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']xyでデータを指定する代わりに、 dataパラメータでオブジェクトを指定して、 xy のラベルを指定するだけです。

>>> plot('xlabel', 'ylabel', data=obj)

すべてのインデックス可能なオブジェクトがサポートされています。これは、たとえば a dict、 a pandas.DataFrameまたは構造化された numpy 配列である可能性があります。

複数のデータ セットのプロット

複数のデータ セットをプロットするには、さまざまな方法があります。

  • 最も簡単な方法は、plot複数回呼び出すことです。例:

    >>> plot(x1, y1, 'bo')
    >>> plot(x2, y2, 'go')
    
  • xおよび/またはyが 2D 配列の場合、列ごとに個別のデータ セットが描画されます。xyの両方が 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ます。

**kwargsLine2Dプロパティ、オプション

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利用可能なプロパティのリストは次のとおりです。

財産

説明

agg_filter

(m, n, 3) float 配列と dpi 値を取り、(m, n, 3) 配列と画像の左下隅からの 2 つのオフセットを返すフィルター関数

alpha

スカラーまたはなし

animated

ブール

antialiasedまたはああ

ブール

clip_box

Bbox

clip_on

ブール

clip_path

パッチまたは (パス、変換) またはなし

colorまたはc

dash_capstyle

CapStyleまたは {'butt', 'projecting', 'round'}

dash_joinstyle

JoinStyleまたは {'miter', 'round', 'bevel'}

dashes

float のシーケンス (ポイント単位のオン/オフ インク) または (None, None)

data

(2, N) 配列または 2 つの 1D 配列

drawstyleまたはds

{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, デフォルト: 'default'

figure

Figure

fillstyle

{'full', 'left', 'right', 'bottom', 'top', 'none'}

gapcolor

色またはなし

gid

in_layout

ブール

label

物体

linestyleまたは ls

{'-', '--', '-.', ':', '', (オフセット, オンオフシーケンス), ...}

linewidthまたはlw

浮く

marker

マーカー スタイル文字列、PathまたはMarkerStyle

markeredgecolorまたはメック

markeredgewidthまたはニャー

浮く

markerfacecolorまたはmfc

markerfacecoloraltまたはmfcalt

markersizeまたはミリ秒

浮く

markevery

None または int または (int, int) または slice または list[int] または float または (float, float) または list[bool]

mouseover

ブール

path_effects

AbstractPathEffect

picker

float または callable[[Artist, Event], tuple[bool, dict]]

pickradius

わからない

rasterized

ブール

sketch_params

(位取り: float、長さ: float、乱数: float)

snap

ブールまたはなし

solid_capstyle

CapStyleまたは {'butt', 'projecting', 'round'}

solid_joinstyle

JoinStyleまたは {'miter', 'round', 'bevel'}

transform

わからない

url

visible

ブール

xdata

一次元配列

ydata

一次元配列

zorder

浮く

こちらもご覧ください

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'

#を使用した例matplotlib.axes.Axes.plot

カテゴリ変数のプロット

カテゴリ変数のプロット

カテゴリ変数のプロット
CSDデモ

CSDデモ

CSDデモ
エラーバンド付き曲線

エラーバンド付き曲線

エラーバンド付き曲線
EventCollection デモ

EventCollection デモ

EventCollection デモ
とアルファの間を埋める

とアルファの間を埋める

とアルファの間を埋める
行間を埋める

行間を埋める

行間を埋める
Betweenx デモを埋める

Betweenx デモを埋める

Betweenx デモを埋める
破線スタイルのカスタマイズ

破線スタイルのカスタマイズ

破線スタイルのカスタマイズ
パス効果がチェックされたライン

パス効果がチェックされたライン

パス効果がチェックされたライン
マーカー参照

マーカー参照

マーカー参照
マーケットベリーデモ

マーケットベリーデモ

マーケットベリーデモ
多変量データへのマーカー プロパティのマッピング

多変量データへのマーカー プロパティのマッピング

多変量データへのマーカー プロパティのマッピング
Psd デモ

Psd デモ

Psd デモ
単純なプロット

単純なプロット

単純なプロット
span_where の使用

span_where の使用

span_where の使用
線、日付、およびテキストでタイムラインを作成する

線、日付、およびテキストでタイムラインを作成する

線、日付、およびテキストでタイムラインを作成する
水平線と垂直線

水平線と垂直線

水平線と垂直線
輪郭コーナーマスク

輪郭コーナーマスク

輪郭コーナーマスク
不規則な間隔のデータの等高線図

不規則な間隔のデータの等高線図

不規則な間隔のデータの等高線図
pcolormesh グリッドとシェーディング

pcolormesh グリッドとシェーディング

pcolormesh グリッドとシェーディング
スペクトログラムのデモ

スペクトログラムのデモ

スペクトログラムのデモ
透かし画像

透かし画像

透かし画像
ラベルの整列

ラベルの整列

ラベルの整列
軸ボックスのアスペクト

軸ボックスのアスペクト

軸ボックスのアスペクト
軸のデモ

軸のデモ

軸のデモ
margin と sticky_edges を使用してビュー制限を制御する

margin と sticky_edges を使用してビュー制限を制御する

margin と sticky_edges を使用してビュー制限を制御する
軸の小道具

軸の小道具

軸の小道具
axhspan デモ

axhspan デモ

axhspan デモ
壊れた軸

壊れた軸

壊れた軸
制約付きレイアウトでの軸のサイズ変更

制約付きレイアウトでの軸のサイズ変更

制約付きレイアウトでの軸のサイズ変更
タイトなレイアウトでの軸のサイズ変更

タイトなレイアウトでの軸のサイズ変更

タイトなレイアウトでの軸のサイズ変更
図のラベル: suptitle、supxlabel、supylabel

図のラベル: suptitle、supxlabel、supylabel

図のラベル: suptitle、supxlabel、supylabel
軸を反転

軸を反転

軸を反転
二次軸

二次軸

二次軸
軸の制限とビューを共有する

軸の制限とビューを共有する

軸の制限とビューを共有する
図のサブ図

図のサブ図

図のサブ図
複数のサブプロット

複数のサブプロット

複数のサブプロット
``plt.subplots`` を使用して複数のサブプロットを作成する

plt.subplots を使用して複数のサブプロットを作成する

``plt.subplots`` を使用して複数のサブプロットを作成する
異なるスケールのプロット

異なるスケールのプロット

異なるスケールのプロット
箱ひげ図

箱ひげ図

箱ひげ図
ヒストグラムを使用して累積分布をプロットする

ヒストグラムを使用して累積分布をプロットする

ヒストグラムを使用して累積分布をプロットする
ヒストグラム (hist) 関数のいくつかの機能

ヒストグラム (hist) 関数のいくつかの機能

ヒストグラム (hist) 関数のいくつかの機能
極座標プロット

極座標プロット

極座標プロット
極伝説

極伝説

極伝説
Matplotlib でアクセント付きテキストを使用する

Matplotlib でアクセント付きテキストを使用する

Matplotlib でアクセント付きテキストを使用する
スケール不変角度ラベル

スケール不変角度ラベル

スケール不変角度ラベル
プロットに注釈を付ける

プロットに注釈を付ける

プロットに注釈を付ける
カスタム凡例の作成

カスタム凡例の作成

カスタム凡例の作成
日付の目盛りラベル

日付の目盛りラベル

日付の目盛りラベル
AnnotationBbox デモ

AnnotationBbox デモ

AnnotationBbox デモ
工学表記を使用した目盛りのラベル付け

工学表記を使用した目盛りのラベル付け

工学表記を使用した目盛りのラベル付け
注釈矢印スタイルのリファレンス

注釈矢印スタイルのリファレンス

注釈矢印スタイルのリファレンス
事前定義されたラベルを使用した凡例

事前定義されたラベルを使用した凡例

事前定義されたラベルを使用した凡例
レジェンドデモ

レジェンドデモ

レジェンドデモ
数学テキスト

数学テキスト

数学テキスト
数学フォントファミリー

数学フォントファミリー

数学フォントファミリー
マルチライン

マルチライン

マルチライン
TeX を使用した数式のレンダリング

TeX を使用した数式のレンダリング

TeX を使用した数式のレンダリング
行を基準にしたテキストの回転

行を基準にしたテキストの回転

行を基準にしたテキストの回転
タイトルの配置

タイトルの配置

タイトルの配置
テキスト透かし

テキスト透かし

テキスト透かし
変換に注釈を付ける

変換に注釈を付ける

変換に注釈を付ける
プロットに注釈を付ける

プロットに注釈を付ける

プロットに注釈を付ける
注釈極

注釈極

注釈極
プログラムによるサブプロット調整の制御

プログラムによるサブプロット調整の制御

プログラムによるサブプロット調整の制御
ドルティック

ドルティック

ドルティック
単純な軸ラベル

単純な軸ラベル

単純な軸ラベル
テキスト コマンド

テキスト コマンド

テキスト コマンド
カラーデモ

カラーデモ

カラーデモ
Y 値による色分け

Y 値による色分け

Y 値による色分け
PathPatch オブジェクト

PathPatch オブジェクト

PathPatch オブジェクト
ベジエ曲線

ベジエ曲線

ベジエ曲線
暗い背景のスタイル シート

暗い背景のスタイル シート

暗い背景のスタイル シート
FiveThirtyEight スタイルシート

FiveThirtyEight スタイルシート

FiveThirtyEight スタイルシート
ggplot スタイルシート

ggplot スタイルシート

ggplot スタイルシート
物理サイズが固定された軸

物理サイズが固定された軸

物理サイズが固定された軸
パラサイトシンプル

パラサイトシンプル

パラサイトシンプル
単純な軸線 4

単純な軸線 4

単純な軸線 4
軸線のスタイル

軸線のスタイル

軸線のスタイル
パラサイト・アックスのデモ

パラサイト・アックスのデモ

パラサイト・アックスのデモ
寄生軸のデモ

寄生軸のデモ

寄生軸のデモ
axisartist を使用したカスタム スパイン

axisartist を使用したカスタム スパイン

axisartist を使用したカスタム スパイン
単純な軸線

単純な軸線

単純な軸線
図の解剖学

図の解剖学

図の解剖学
曲線下面積としての積分

曲線下面積としての積分

曲線下面積としての積分
32年間の株価

32年間の株価

32年間の株価
XKCD

XKCD

XKCD
減衰

減衰

減衰
ベイズのアップデート

ベイズのアップデート

ベイズのアップデート
二重振り子の問題

二重振り子の問題

二重振り子の問題
アニメートされた 3D ランダム ウォーク

アニメートされた 3D ランダム ウォーク

アニメートされた 3D ランダム ウォーク
アニメーション ライン プロット

アニメーション ライン プロット

アニメーション ライン プロット
MATPLOTLIB **アンチェーン**

MATPLOTLIB アンチェーン

MATPLOTLIB **アンチェーン**
マウスの移動とクリックのイベント

マウスの移動とクリックのイベント

マウスの移動とクリックのイベント
十字カーソル

十字カーソル

十字カーソル
データブラウザ

データブラウザ

データブラウザ
キープレスイベント

キープレスイベント

キープレスイベント
レジェンドピッキング

レジェンドピッキング

レジェンドピッキング
ルッキンググラス

ルッキンググラス

ルッキンググラス
パス エディター

パス エディター

パス エディター
イベントデモを選択

イベントデモを選択

イベントデモを選択
ピックイベント Demo2

ピックイベント Demo2

ピックイベント Demo2
データのリサンプリング

データのリサンプリング

データのリサンプリング
タイマー

タイマー

タイマー
ボックスと交差する線の色の変更

ボックスと交差する線の色の変更

ボックスと交差する線の色の変更
カスタム プロジェクション

カスタム プロジェクション

カスタム プロジェクション
パスエフェクトのデモ

パスエフェクトのデモ

パスエフェクトのデモ
Pythonic Matplotlib

Pythonic Matplotlib

Pythonic Matplotlib
SVG フィルター ライン

SVG フィルター ライン

SVG フィルター ライン
TickedStroke パス効果

TickedStroke パス効果

TickedStroke パス効果
ゾーダーデモ

ゾーダーデモ

ゾーダーデモ
2D データを 3D プロットにプロット

2D データを 3D プロットにプロット

2D データを 3D プロットにプロット
3D ボックス サーフェス プロット

3D ボックス サーフェス プロット

3D ボックス サーフェス プロット
パラメトリック カーブ

パラメトリック カーブ

パラメトリック カーブ
ローレンツアトラクタ

ローレンツアトラクタ

ローレンツアトラクタ
同じ *Figure* 内の 2D と 3D *Axes*

同じ Figure 内の 2D 軸と 3D 軸

同じ *Figure* 内の 2D と 3D *Axes*
アシンデモ

アシンデモ

アシンデモ
ログログアスペクト

ログログアスペクト

ログログアスペクト
スケール

スケール

スケール
Symlog デモ

Symlog デモ

Symlog デモ
アンスコムのカルテット

アンスコムのカルテット

アンスコムのカルテット
レーダー チャート (別名スパイダー チャートまたはスター チャート)

レーダー チャート (別名スパイダー チャートまたはスター チャート)

レーダー チャート (別名スパイダー チャートまたはスター チャート)
矢印付きの中央スパイン

矢印付きの中央スパイン

矢印付きの中央スパイン
スパイン付きの複数の Yaxis

スパイン付きの複数の Yaxis

スパイン付きの複数の Yaxis
脊椎の配置

脊椎の配置

脊椎の配置
トゲ

トゲ

トゲ
カスタム スパイン バウンド

カスタム スパイン バウンド

カスタム スパイン バウンド
目盛り間のラベルの中央揃え

目盛り間のラベルの中央揃え

目盛り間のラベルの中央揃え
ConciseDateFormatter を使用した日付ティックの書式設定

ConciseDateFormatter を使用した日付ティックの書式設定

ConciseDateFormatter を使用した日付ティックの書式設定
日付デモ変換

日付デモ変換

日付デモ変換
時系列のカスタム ティック フォーマッタ

時系列のカスタム ティック フォーマッタ

時系列のカスタム ティック フォーマッタ
日付の精度とエポック

日付の精度とエポック

日付の精度とエポック
大目盛りと小目盛り

大目盛りと小目盛り

大目盛りと小目盛り
デフォルトの目盛りフォーマッタ

デフォルトの目盛りフォーマッタ

デフォルトの目盛りフォーマッタ
右側にデフォルトの y 軸の目盛りラベルを設定する

右側にデフォルトの y 軸の目盛りラベルを設定する

右側にデフォルトの y 軸の目盛りラベルを設定する
値のリストからの目盛りラベルの設定

値のリストからの目盛りラベルの設定

値のリストからの目盛りラベルの設定
X 軸の目盛りラベルを上に移動

X 軸の目盛りラベルを上に移動

X 軸の目盛りラベルを上に移動
エバンステスト

エバンステスト

エバンステスト
CanvasAgg のデモ

CanvasAgg のデモ

CanvasAgg のデモ
説明に注釈を付ける

説明に注釈を付ける

説明に注釈を付ける
シンプル01をつなぐ

シンプル01をつなぐ

シンプル01をつなぐ
注釈の接続スタイル

注釈の接続スタイル

注釈の接続スタイル
ネストされた GridSpec

ネストされた GridSpec

ネストされた GridSpec
PGF フォント

PGF フォント

PGF フォント
PGFテックスシステム

PGFテックスシステム

PGFテックスシステム
シンプルな注釈01

シンプルな注釈01

シンプルな注釈01
シンプル凡例01

シンプル凡例01

シンプル凡例01
シンプル凡例02

シンプル凡例02

シンプル凡例02
注釈付きカーソル

注釈付きカーソル

注釈付きカーソル
ボタン

ボタン

ボタン
チェックボタン

チェックボタン

チェックボタン
カーソル

カーソル

カーソル
マルチカーソル

マルチカーソル

マルチカーソル
ラジオボタン

ラジオボタン

ラジオボタン
長方形と楕円のセレクター

長方形と楕円のセレクター

長方形と楕円のセレクター
スライダー

スライダー

スライダー
スライダを離散値にスナップする

スライダを離散値にスナップする

スライダを離散値にスナップする
スパンセレクター

スパンセレクター

スパンセレクター
テキストボックス

テキストボックス

テキストボックス
クイックスタートガイド

クイックスタートガイド

クイックスタートガイド
アーティストのチュートリアル

アーティストのチュートリアル

アーティストのチュートリアル
レジェンドガイド

レジェンドガイド

レジェンドガイド
サイクラーでスタイリング

サイクラーでスタイリング

サイクラーでスタイリング
制約付きレイアウト ガイド

制約付きレイアウト ガイド

制約付きレイアウト ガイド
タイトレイアウトガイド

タイトレイアウトガイド

タイトレイアウトガイド
Figure 内に複数の Axes を配置する

Figure 内に複数の Axes を配置する

Figure 内に複数の Axes を配置する
自動スケーリング

自動スケーリング

自動スケーリング
ブリッティングを使用したレンダリングの高速化

ブリッティングを使用したレンダリングの高速化

ブリッティングを使用したレンダリングの高速化
パスのチュートリアル

パスのチュートリアル

パスのチュートリアル
変換のチュートリアル

変換のチュートリアル

変換のチュートリアル
色の指定

色の指定

色の指定
Matplotlib プロットのテキスト

Matplotlib プロットのテキスト

Matplotlib プロットのテキスト
プロット(x, y)

プロット(x, y)

プロット(x, y)
fill_ between(x, y1, y2)

fill_ between(x, y1, y2)

fill_ between(x, y1, y2)
トライコンター(x, y, z)

トライコンター(x, y, z)

トライコンター(x, y, z)
tricontourf(x, y, z)

tricontourf(x, y, z)

tricontourf(x, y, z)
tripcolor(x, y, z)

tripcolor(x, y, z)

tripcolor(x, y, z)