matplotlib.axes.Axes.scatter #

軸。scatter ( x , y , s =なし, c =なし,マーカー=なし, cmap =なし, norm =なし, vmin =なし, vmax =なし, alpha =なし, linewidths =なし, * , edgecolors =なし, plotnonfinite =偽,data = None , ** kwargs ) [source] #

さまざまなマーカーサイズや色を使用したy対xの散布図。

パラメータ:

x, y float または配列のような形状 (n, )

データの位置。

s float または array-like、形状 (n, )、オプション

ポイント単位のマーカーサイズ**2。デフォルトはです。rcParams['lines.markersize'] ** 2

c配列状または色または色のリスト、オプション

マーカーの色。可能な値:

cmapとnormを使用して色にマッピングされる n 個の数値のスカラーまたはシーケンス。
行が RGB または RGBA である 2D 配列。
長さ n の色のシーケンス。
単一の色の書式文字列。

cは、カラーマップされる値の配列と区別できないため、単一の数値 RGB または RGBA シーケンスであってはならないことに注意してください。すべての点に同じ RGB または RGBA 値を指定する場合は、1 行の 2D 配列を使用します。それ以外の場合、 x およびyと一致するサイズの場合、値の一致が優先されます。

すべてのポイントに単一の色を指定する場合は、colorキーワード引数を使用してください。

デフォルトはNoneです。その場合、マーカーの色はcolor、facecolorまたはfacecolorsの値によって決定されます。これらが指定されていない場合None、または ' マーカーの色は、Axes現在の「シェイプと塗りつぶし」のカラーサイクルの次の色によって決定されます。このサイクルのデフォルトはrcParams["axes.prop_cycle"](デフォルト: ) です。cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])

マーカーMarkerStyle、デフォルト: rcParams["scatter.marker"](デフォルト: 'o')

マーカースタイル。マーカーは、クラスのインスタンスまたは特定のマーカーの省略形のテキストのいずれかです。matplotlib.markersマーカースタイルの詳細については、を参照してください。

cmap str またはColormap、デフォルト: rcParams["image.cmap"](デフォルト: 'viridis')

スカラーデータを色にマップするために使用される Colormap インスタンスまたは登録済みのカラーマップ名。

cが RGB(A) の場合、このパラメーターは無視されます。

ノルムstr またはNormalize、オプション

cmapを使用して色にマッピングする前に、スカラーデータを [0, 1] の範囲にスケーリングするために使用される正規化方法。デフォルトでは、線形スケーリングが使用され、最小値が 0 に、最大値が 1 にマッピングされます。

指定する場合、これは次のいずれかになります。

のインスタンスNormalizeまたはそのサブクラスの 1 つ ( Colormap Normalizationを参照)。
スケール名。つまり、「linear」、「log」、「symlog」、「logit」などのいずれかです。使用可能なスケールのリストについては、を呼び出しますmatplotlib.scale.get_scale_names()。その場合、適切なNormalizeサブクラスが動的に生成され、インスタンス化されます。

cが RGB(A) の場合、このパラメーターは無視されます。

vmin、vmax float、オプション

スカラーデータを使用し、明示的なnormを使用しない場合、vminとvmaxはカラーマップがカバーするデータ範囲を定義します。デフォルトでは、カラーマップは提供されたデータの値の範囲全体をカバーします。ノルムインスタンスが指定されているときにvmin / vmaxを使用するとエラーになります (ただし、 vmin / vmaxと一緒にノルム名を使用することは許容されます)。str

cが RGB(A) の場合、このパラメーターは無視されます。

アルファフロート、デフォルト: なし

0 (透明) から 1 (不透明) までのアルファブレンディング値。

linewidths float または array-like、デフォルト: rcParams["lines.linewidth"](デフォルト: 1.5)

マーカーエッジの線幅。注: デフォルトのedgecolors は 'face' です。これも変更したい場合があります。

edgecolors {'face', 'none', None } または色または色のシーケンス、デフォルト: rcParams["scatter.edgecolors"](デフォルト: 'face')

マーカーのエッジの色。可能な値:

'face': エッジの色は常に面の色と同じになります。
'none': パッチ境界は描画されません。
色または色のシーケンス。

塗りつぶされていないマーカーの場合、edgecolorsは無視されます。代わりに、色は 'face' のように、つまりc、colors、または facecolorsから決定されます。

plotnonfinite bool、デフォルト: False

非有限c (つまりinf、-inf または) で点をプロットするかどうかnan。Trueポイントが不適切なカラーマップカラーで描画されている場合 (「」を参照Colormap.set_bad)。

戻り値:

PathCollection

その他のパラメータ:

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

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

x , y , s , linewidths , edgecolors , c , facecolor , facecolors , color

**kwargsCollectionプロパティ

こちらもご覧ください

plot: マーカーのサイズと色が同じ場合に散布図をプロットします。

ノート

このplot関数は、マーカーのサイズや色が変化しない散布図では高速になります。
x、y、s、およびcのいずれかまたはすべてをマスク配列にすることができます。この場合、すべてのマスクが結合され、マスクされていない点のみがプロットされます。
基本的に、散布は 1D 配列で機能します。x、y、s、およびc は ND 配列として入力できますが、スキャッター内では平坦化されます。例外はcで、そのサイズがxおよびyのサイズと一致する場合にのみ平坦化されます。