scatter【散布図】
メモ
基本
〔 例 〕- 座標・マーカー(スタイル等)を指定
- マーカーのサイズと色が同じ場合、plot【折れ線グラフ】の方が高速
マーカーの指定方法
〔 例 〕- マーカー定義 参照
s (マーカーサイズ)
c (マーカー色) ・facecolor・facecolors・fc (塗りつぶし色)
marker (マーカースタイル)
cmap (カラーマップ) ・Collection.cmap (カラーマップ)
alpha (アルファ値)
linewidths (マーカー外枠の幅) ・Collection.linewidth・linewidths・lw (外枠の幅)
edgecolors (マーカー外枠の色) ・Collection.edgecolor (マーカー外枠の色)
linestyle・linestyles・ls・dashes (線種) - 中抜き・白抜き:マーカー定義 のマーカーの中抜き・白抜き 参照
凡例の指定方法
〔 例 〕- 手動作成
- scatter【散布図】呼び出し毎に label【凡例ラベル】を指定
- legend【凡例 設定】
- 自動作成 (色 または サイズで分類)
- scatter【散布図】の戻り値 (PathCollection) の legend_elements【凡例項目作成】3.1 で凡例項目を自動作成
- legend【凡例 設定】(上記戻り値を指定)
複数凡例:add_artist【アーティスト追加】
データの指定方法
〔 例 〕- 通常指定
- 引数にデータを指定
- ラベル名指定
- 引数にラベル名を指定
- data (ラベル名指定データ)にラベル名とデータを指定
関連設定
〔 例 〕- タイトル・凡例・目盛り等:設定・グラフパーツ 参照
関連
- マーカー定義
- 色定義
- plot【折れ線グラフ】
- Axes3D.scatter(3D)【3D散布図】
外部リンク
構文
matplotlib.pyplot.scatter(
x (データx座標)※data,
y (データy座標)※data,
s (マーカーサイズ)※data =None,
c (マーカー色)※data =None,
marker (マーカースタイル)=None,
cmap (カラーマップ)=None,
norm (正規化)=None,
vmin (正規化の最小値)=None,
vmax (正規化の最大値)=None,
alpha (アルファ値)=None,
*, 3.4
linewidths (マーカー外枠の幅)※data =None,
verts (マーカー頂点)3.23.4=None,
edgecolors (マーカー外枠の色)※data =None,
*, 3.4
plotnonfinite (bool:有限値以外の描画有無)3.1 =False,
data (ラベル名指定データ)=None,
**kwargs (その他プロパティ)(※data))
matplotlib.axes.Axes.scatter(同上)
戻り値PathCollection
x (float | 配列形式 | shape(n,))※dataデータのx座標
y (float | 配列形式 | shape(n,))※dataデータのy座標
s (float | 配列形式 | shape(n,))※dataマーカーサイズ (ポイント単位2)
省略:rcParams['lines.markersize']2
c (配列形式 | list(color【色定義】)| color【色定義】)※dataマーカー色
省略:color【各種色】・facecolor・facecolors【塗りつぶし色】を使用 (省略:rcParams["axes.prop_cycle"])
下記指定
・カラーマップ番号のスカラー・シーケンス
・2次元配列 (行:RGB または RGBA)
・color【色定義】のシーケンス
・color【色定義】の文字列
marker (str | MarkerStyle)マーカースタイル (詳細:マーカー定義 の マーカースタイル )
省略:rcParams["scatter.marker"] (デフォルト:'o')
cmap (str | Colormap)カラーマップ (c【マーカー色】がfloat配列の場合のみ有効)
省略:rcParams["image.cmap"] (デフォルト:'viridis')
norm (Normalize)正規化 (c【マーカー色】がfloat配列の場合のみ有効)
省略:colors.Normalize
vmin (float | None)正規化の最小値
vmax (float | None)正規化の最大値
alpha (float | None)アルファ値 (0:透明 ~ 1:不透明)
linewidths (float | 配列形式) キーワード引数3.4※dataマーカー外枠の幅 (Collection.linewidths 参照)
省略:rcParams["lines.linewidth"] (デフォルト:1.5)
verts3.23.4マーカー頂点 (marker 省略時)
edgecolors (str | color【色定義】 | color【色定義】のシーケンス) キーワード引数3.4※dataマーカー外枠の色 (Collection.edgecolors 参照)
省略:rcParams["scatter.edgecolors"] (デフォルト:'face')
下記指定
・'face':facecolor【塗りつぶし色】使用
・'none':なし
・color【色定義】
・color【色定義】のシーケンス
plotnonfinite (bool) キーワード引数3.1有限値以外の描画有無
data (キーワード引数)ラベル名指定データ (※data:ラベル名指定可・詳細は、データの指定方法 参照・下記が対象)
・x (データのx座標)
・y (データのy座標)
・s (マーカーサイズ)
・c (マーカー色)
・linewidths (マーカー外枠の幅)
・edgecolors (マーカー外枠の色)
・facecolor・facecolors (塗りつぶし色)
・color (各種色)
kwargs (可変長キーワード引数)Collection【コレクション】のプロパティ
Collection【コレクション】のプロパティ
親:matplotlib.artist.Artist ・ matplotlib.cm.ScalarMappable | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
プロパティ | 型 | デフォルト | ●設定 | ●取得 | 備考 | ||||||||||||||||||||||
agg_filter | callable | ● | ● | agg フィルター | |||||||||||||||||||||||
alpha | ● | ● | アルファ値 (0:透明 ~ 1:不透明) | ||||||||||||||||||||||||
animated | bool | ● | ● | アニメーション使用の有無 | |||||||||||||||||||||||
antialiased antialiaseds aa 3.1 | bool list( bool ) | rcParams["patch.antialiased"]:True | ■● | ○ | アンチエイリアス処理の有無 | ||||||||||||||||||||||
capstyle | CapStyle 3.4 str | rcParams["patch.capstyle"] | ■● | ● | 線端スタイル
| ||||||||||||||||||||||
clim | ● | ● | |||||||||||||||||||||||||
clip_box | clipbox | ● | ● | ||||||||||||||||||||||||
clip_on | ● | ● | |||||||||||||||||||||||||
clip_path | ● | ● | |||||||||||||||||||||||||
cmap | Colormap | rcParams["image.cmap"]:'viridis' | ■● | ● | カラーマップ | ||||||||||||||||||||||
color | ● | ○ | 各種色 (edgecolor【外枠の色】・facecolor【塗りつぶし色】) | ||||||||||||||||||||||||
contains 3.3 | callable | ● | ● | ピッカーイベント (参照:picker【ピッカーイベント】) | |||||||||||||||||||||||
edgecolor edgecolors ec 3.1 | color【色定義】 list( color【色定義】) 'face':塗りつぶし色 | rcParams["patch.edgecolor"]:'black' | ■● | ● | 外枠・塗りつぶしパターンの色 | ||||||||||||||||||||||
facecolor facecolors fc 3.1 | color【色定義】 list( color【色定義】) 'none' | rcParams["patch.facecolor"]:'C0' | ■● | ● | 塗りつぶし色 | ||||||||||||||||||||||
figure | Figure | ● | ● | 所属フィギュア | |||||||||||||||||||||||
fill | bool | ○ | ● | 塗りつぶしの有無 | |||||||||||||||||||||||
gid | str | ● | ● | グループId (識別子として利用可) | |||||||||||||||||||||||
hatch | str | ■● | ● | 塗りつぶしパターン (繰り返しで高密度 / 組合せ可)
| |||||||||||||||||||||||
in_layout | bool | ● | ● | レイアウト計算に含めるか否か | |||||||||||||||||||||||
joinstyle | JoinStyle 3.4 str | rcParams["patch.joinstyle"] | ■● | ● | 結合スタイル
| ||||||||||||||||||||||
label | object | ● | ● | 凡例ラベル (アンダースコアで始まるラベルは対象外) | |||||||||||||||||||||||
linestyle linestyles ls 3.1 dashes | str (offset, on-off-seq) 上記の list | 'solid' | ■● | ● | 線種
| ||||||||||||||||||||||
linewidth linewidths lw 3.1 | float list( float ) | rcParams["patch.linewidth"]:1.0 | ■● | ● | 外枠の幅 | ||||||||||||||||||||||
norm | Normalize | None | ■● | ○ | 正規化 | ||||||||||||||||||||||
offset_position 3.3 | str | 'screen' | ■● | ● | オフセット座標系
| ||||||||||||||||||||||
offset_transform | ○ | ● | |||||||||||||||||||||||||
offsets | (float, float) 上記の list | (0, 0) | ■● | ● | |||||||||||||||||||||||
path_effects | AbstractPathEffect | ○ | ● | ||||||||||||||||||||||||
paths | ● | ● | |||||||||||||||||||||||||
picker | None bool float callable | None | ● | ● | None:ピッカーイベントなし bool:ピッカーイベント有無 float:ピッカー有効半径 callable:ピッカーイベント hit(bool), props(dict) = picker(artist, mouseevent) | ||||||||||||||||||||||
pickradius | float | 5.0 | ■● | ● | ピッカー有効半径 (≦ 0:パス内 / 0<:2倍の範囲) | ||||||||||||||||||||||
rasterized | bool | ● | ● | ラスタライズ(ビットマップ) 描画の強制有無 | |||||||||||||||||||||||
sketch_params | ● | ● | |||||||||||||||||||||||||
snap | bool None | ● | ● | スナップ (ピクセル位置補正) の有無 (Agg・MacOSX バックエンドのみサポート) | |||||||||||||||||||||||
transform | Transform | ● | ● | ||||||||||||||||||||||||
transOffset | Transform | IdentityTransform | ■ | ○ | |||||||||||||||||||||||
urls | list( str ) | None | ■● | ● | ハイパーリンクURL (SVG のみ対応) | ||||||||||||||||||||||
visible | bool | ● | ● | 表示有無 | |||||||||||||||||||||||
zorder | float | ● | ● | Zオーダー (大きい方が手前) |
設定・グラフパーツ
pyplot. | axes.Axes. | その他 | |
---|---|---|---|
タイトル | suptitle【タイトル設定 (全体)】 title【タイトル設定】 | set_title【タイトル設定】 get_title【タイトル取得】 Axes3D.set_title【タイトル設定】 | figure.Figure.suptitle【タイトル設定 (全体)】 figure.SubFigure.suptitle |
凡例 | legend【凡例 設定】3.5 / 3.7 / 3.8 quiverkey【ベクトルの凡例 追加】 | figure.Figure.legend【凡例 設定 (全体)】3.7 / 3.8 PathCollection.legend_elements【凡例項目作成】 | |
get_legend【凡例 取得】 get_legend_handles_labels【凡例 取得 (ハンドル・ラベル)】 | |||
軸ラベル | xlabel【x軸ラベル 設定】3.3 ylabel【y軸ラベル 設定】3.3 | set_xlabel【x軸ラベル 設定】3.3 set_ylabel【y軸ラベル 設定】3.3 Axes3D.set_zlabel【z軸ラベル 設定】 get_xlabel【x軸ラベル 取得】 get_ylabel【y軸ラベル 取得】 Axes3D.get_zlabel【z軸ラベル 取得】 | figure.Figure.supxlabel【x軸ラベル(全体) 設定】3.43.6 figure.Figure.supylabel【y軸ラベル(全体) 設定】3.43.6 figure.SubFigure.supxlabel figure.SubFigure.supylabel projections.polar.PolarAxes.set_rlabel_position【半径ラベルのシータ位置設定】 |
clabel【等高線ラベル 設定】 | |||
グリッド線 | grid【グリッド線 設定】3.5 | grid【グリッド線 設定】3.5 get_xgridlines【x軸グリッド線 取得】 get_ygridlines【y軸グリッド線 取得】 (Axes3D.grid【3Dグリッド線 取得・設定】) Axes3D.get_zgridlines【z軸グリッド線 取得】 | axis.Axis.grid【軸グリッド線 設定】3.5 axis.Axis.get_gridlines【軸グリッド線 取得】 |
triplot【三角形分割】 | |||
rgrids【放射状グリッド線 取得・設定】 thetagrid【放射状シータグリッド線 取得・設定】 | projections.polar.PolarAxes.set_rgrids【放射状グリッド線 設定】 projections.polar.PolarAxes.set_thetagrid【放射状シータグリッド線 設定】 | ||
表示範囲 | xlim【x軸表示範囲 取得・設定】 ylim【y軸表示範囲 取得・設定】 axis【表示範囲等 取得・設定】3.1~3.4 / 3.7 | set_xlim【x軸表示範囲 設定】3.1 / 3.6 set_ylim【y軸表示範囲 設定】3.1 / 3.6 get_xlim【x軸表示範囲 取得】 get_ylim【y軸表示範囲 取得】 axis【表示範囲等 取得・設定】3.1~3.4 / 3.7 | projections.polar.PolarAxes.set_rlim【極座標範囲 設定】 |
Axes3D.set_xlim【3D x軸表示範囲 設定】 Axes3D.set_xlim3d【3D x軸表示範囲 設定】 Axes3D.set_ylim【3D y軸表示範囲 設定】 Axes3D.set_ylim3d【3D y軸表示範囲 設定】 Axes3D.set_zlim【3D z軸表示範囲 設定】 Axes3D.set_zlim3d【3D z軸表示範囲 設定】 Axes3D.get_xlim3d【3D x軸表示範囲 取得】 Axes3D.get_ylim3d【3D y軸表示範囲 取得】 Axes3D.get_zlim3d【3D z軸表示範囲 取得】 | |||
データ上限・下限 | set_xbound【x軸データ上限・下限 設定】 set_ybound【y軸データ上限・下限 設定】 get_xbound【x軸データ上限・下限 取得】 get_ybound【y軸データ上限・下限 取得】 | projections.polar.PolarAxes.set_rmax【極座標上限 設定】 projections.polar.PolarAxes.set_rmin【極座標下限 設定】 | |
目盛り | xticks【x軸目盛り (ラベル) 取得・設定】3.6 yticks【y軸目盛り (ラベル) 取得・設定】3.6 locator_params【目盛り制御】 minorticks_on minorticks_off ticklabel_format【目盛りフォーマット設定 (指数形式)】 tick_params【目盛り・グリッド線 外観変更】 | set_xticks【x軸目盛り 設定】3.2 / 3.5 set_yticks【y軸目盛り 設定】3.2 / 3.5 Axes3D.set_zticks【z軸目盛り 設定】 set_xticklabels【x軸目盛りラベル 設定】3.3 / 3.5 set_yticklabels【y軸目盛りラベル 設定】3.3 / 3.5 Axes3D.set_zticklabels【z軸目盛りラベル 設定】 get_xticks【x軸目盛り 取得】3.2 get_yticks【y軸目盛り 取得】3.2 Axes3D.get_zticks【z軸目盛り 取得】 get_xticklabels【x軸目盛りラベル 取得】3.3 / 3.6 get_yticklabels【y軸目盛りラベル 取得】3.3 / 3.6 Axes3D.get_zticklabels【z軸目盛りラベル 取得】 get_xmajorticklabels【x軸目盛りラベル 取得 (主)】3.3 / 3.6 get_ymajorticklabels【y軸目盛りラベル 取得 (主)】3.3 / 3.6 get_xminorticklabels【x軸目盛りラベル 取得 (補助)】3.3 / 3.6 get_yminorticklabels【y軸目盛りラベル 取得 (補助)】3.3 / 3.6 get_xticklines get_yticklines xaxis_date yaxis_date minorticks_on minorticks_off ticklabel_format【目盛りフォーマット設定 (指数形式)】 tick_params【目盛り・グリッド線 外観変更】 locator_params【目盛り制御】 fmt_xdata fmt_ydata | ticker【目盛りモジュール】 axis.Axis.set_ticks【目盛り 設定】 axis.Axis.set_ticklabels【目盛りラベル 設定】 axis.Axis.set_tick_params【目盛り・グリッド線 外観変更】 axis.XAxis.set_ticks_position【x軸目盛り位置 設定】 axis.YAxis.set_ticks_position【y軸目盛り位置 設定】 Axes3D.locator_params【目盛り制御】 axis.Axis.set_major_formatter【フォーマッタ設定 (主)】 axis.Axis.set_minor_formatter【フォーマッタ設定 (補助)】 axis.Axis.set_major_locator【ロケータ設定 (主)】 axis.Axis.set_minor_locator【ロケータ設定 (補助)】 axis.Axis.get_ticklabels【目盛りラベル取得】 axis.Axis.get_majorticklabels【目盛りラベル取得 (主)】 axis.Axis.get_minorticklabels【目盛りラベル取得 (補助)】 axis.Axis.get_major_formatter【フォーマッタ取得 (主)】 axis.Axis.get_minor_formatter【フォーマッタ取得 (補助)】 axis.Axis.get_ticklocs axis.Axis.get_major_locator【ロケータ取得 (主)】 axis.Axis.get_minor_locator【ロケータ取得 (補助)】 figure.Figure.autofmt_xdate【x軸日付目盛りラベル回転】 axis.Axis.get_tick_params【目盛り・グリッド線 外観取得】3.7 |
直線 範囲 | axhline【水平線 (単一)】3.9 axvline【垂直線 (単一)】 hlines【水平線 (複数)】3.3 vlines【垂直線 (複数)】3.3 axhspan【水平範囲】3.9 axvspan【垂直範囲】3.9 axline【直線】3.3 |