matplotlib.pyplot.scatter #
- matplotlib.pyplot. scatter ( x , y , s =なし, c =なし,マーカー=なし, cmap =なし, norm =なし, vmin =なし, vmax =なし, alpha =なし, linewidths =なし, * , edgecolors =なし, plotnonfinite =間違い、データ=なし、** kwargs ) [ソース] #
さまざまなマーカー サイズや色を使用した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と 一緒にノルム名を使用することは許容されます)。
strcが 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)。
- 戻り値:
- その他のパラメータ:
- データのインデックス可能なオブジェクト、オプション
指定された場合、次のパラメーターは string も受け入れます
s。これは、次のように解釈されますdata[s](例外が発生しない限り)。x , y , s , linewidths , edgecolors , c , facecolor , facecolors , color
- **kwargs
Collectionプロパティ
こちらもご覧ください
plotマーカーのサイズと色が同じ場合に散布図をプロットします。
ノート
この
plot関数は、マーカーのサイズや色が変化しない散布図では高速になります。x、y、s、およびcのいずれかまたはすべてをマスク配列にすることができます。この場合、すべてのマスクが結合され、マスクされていない点のみがプロットされます。
基本的に、散布は 1D 配列で機能します。x、y、s、およびc は ND 配列として入力できますが、スキャッター内では平坦化されます。例外はcで、そのサイズがxおよびyのサイズと一致する場合にのみ平坦化されます。
