matplotlib.pyplot.scatter #
- matplotlib.pyplot. scatter ( x , y , s = Nessuno , c = Nessuno , marker = Nessuno , cmap = Nessuno , norm = Nessuno , vmin = Nessuno , vmax = Nessuno , alpha = Nessuno , linewidths = Nessuno , * , edgecolors = Nessuno , plotnonfinite = Falso, dati = Nessuno , ** kwargs ) [fonte] #
Un grafico a dispersione di y rispetto a x con dimensioni e/o colore del marker variabili.
- Parametri :
- x, y float o tipo array, forma (n, )
Le posizioni dei dati.
- s float o simile a un array, shape (n, ), facoltativo
La dimensione dell'indicatore in punti**2. L'impostazione predefinita è .
rcParams['lines.markersize'] ** 2- c simile a un array o elenco di colori o colore, facoltativo
I colori dell'indicatore. Possibili valori:
Uno scalare o una sequenza di n numeri da mappare ai colori usando cmap e norm .
Una matrice 2D in cui le righe sono RGB o RGBA.
Una sequenza di colori di lunghezza n.
Una stringa di formato a colore singolo.
Si noti che c non dovrebbe essere una singola sequenza numerica RGB o RGBA perché è indistinguibile da un array di valori da mappare a colori. Se desideri specificare lo stesso valore RGB o RGBA per tutti i punti, utilizza un array 2D con una sola riga. In caso contrario, la corrispondenza del valore avrà la precedenza nel caso di una dimensione corrispondente a x e y .
Se desideri specificare un singolo colore per tutti i punti, preferisci l' argomento della parola chiave color .
Il valore predefinito è
None. In tal caso il colore del pennarello è determinato dal valore di color , facecolor o facecolors . Nel caso in cui non siano specificati oNone, il colore dell'indicatore è determinato dal colore successivo delAxesciclo di colori "forma e riempimento" corrente. L'impostazione predefinita di questo ciclo èrcParams["axes.prop_cycle"](predefinito: ).cycler('color', ['#1f77b4', '#ff7f0e', '#2ca02c', '#d62728', '#9467bd', '#8c564b', '#e377c2', '#7f7f7f', '#bcbd22', '#17becf'])- marcatore
MarkerStyle, predefinito:rcParams["scatter.marker"](predefinito:'o') Lo stile del marcatore. marker può essere un'istanza della classe o la scorciatoia di testo per un particolare marker. Vedere
matplotlib.markersper ulteriori informazioni sugli stili dei marcatori.- cmap str o
Colormap, predefinito:rcParams["image.cmap"](predefinito:'viridis') L'istanza Colormap o il nome registrato della mappa colori utilizzato per mappare i dati scalari ai colori.
Questo parametro viene ignorato se c è RGB(A).
- norm str o
Normalize, facoltativo Il metodo di normalizzazione utilizzato per ridimensionare i dati scalari nell'intervallo [0, 1] prima della mappatura ai colori utilizzando cmap . Per impostazione predefinita, viene utilizzato un ridimensionamento lineare, mappando il valore più basso su 0 e il più alto su 1.
Se indicato, può essere uno dei seguenti:
Un'istanza di
Normalizeo una delle sue sottoclassi (vedere Normalizzazione della mappa dei colori ).Un nome di scala, ad esempio "linear", "log", "symlog", "logit", ecc. Per un elenco delle scale disponibili, chiamare
matplotlib.scale.get_scale_names().NormalizeIn tal caso, una sottoclasse adatta viene generata dinamicamente e istanziata.
Questo parametro viene ignorato se c è RGB(A).
- vmin, vmax float, facoltativo
Quando si utilizzano dati scalari e nessuna norma esplicita , vmin e vmax definiscono l'intervallo di dati coperto dalla mappa dei colori. Per impostazione predefinita, la mappa dei colori copre l'intero intervallo di valori dei dati forniti. È un errore utilizzare vmin / vmax quando viene fornita un'istanza di norma (ma l'utilizzo di un nome di norma insieme a vmin / vmax è accettabile).
strQuesto parametro viene ignorato se c è RGB(A).
- alfa float, predefinito: Nessuno
Il valore di fusione alfa, compreso tra 0 (trasparente) e 1 (opaco).
- linewidths float o simile ad un array, default:
rcParams["lines.linewidth"](default:1.5) La larghezza di riga dei bordi del marcatore. Nota: l' edgecolors predefinito è 'face'. Potresti voler cambiare anche questo.
- edgecolors {'face', 'none', None } o colore o sequenza di colori, default:
rcParams["scatter.edgecolors"](default:'face') Il colore del bordo dell'indicatore. Possibili valori:
'faccia': il colore del bordo sarà sempre lo stesso del colore della faccia.
'none': non verrà tracciato alcun limite di patch.
Un colore o una sequenza di colori.
Per i marcatori non riempiti, edgecolors viene ignorato. Invece, il colore è determinato come con 'face', cioè da c , colors o facecolors .
- plotnonfinite bool, default: False
Indica se tracciare punti con c non finito (cioè
inf,-infonan). SeTruei punti sono disegnati con il colore errato della mappa dei colori (vediColormap.set_bad).
- Resi :
- Altri parametri :
- oggetto indicizzabile dei dati , facoltativo
Se forniti, i seguenti parametri accettano anche una stringa
s, che viene interpretata comedata[s](a meno che ciò non sollevi un'eccezione):x , y , s , linewidths , edgecolors , c , facecolor , facecolors , colore
- ** proprietà kwargs
Collection
Guarda anche
plotPer tracciare grafici a dispersione quando i marcatori sono identici per dimensione e colore.
Appunti
La
plotfunzione sarà più veloce per i grafici a dispersione in cui i marcatori non variano in dimensioni o colore.Alcuni o tutti x , y , s e c possono essere array mascherati, nel qual caso tutte le maschere verranno combinate e verranno tracciati solo i punti non mascherati.
Fondamentalmente, lo scatter funziona con array 1D; x , y , s e c possono essere immessi come array ND, ma all'interno di scatter saranno appiattiti. L'eccezione è c , che verrà appiattita solo se la sua dimensione corrisponde alla dimensione di x e y .
