matplotlib.lines.Line2D #
- classe matplotlib.lines. Line2D ( xdata , ydata , * , linewidth = Nessuno , linestyle = Nessuno , color = Nessuno , gapcolor = Nessuno , marker = Nessuno , markersize = Nessuno , markeredgewidth = Nessuno , markeredgecolor = Nessuno , markerfacecolor = Nessuno , markerfacecoloralt ='none' , fillstyle = None , antialiased = None , dash_capstyle = None , solid_capstyle = None , dash_joinstyle = None , solid_joinstyle = None , pickradius = 5 , drawstyle = None , markevery = None , ** kwargs ) [fonte] #
Basi:
Artist
Una linea: la linea può avere sia uno stile di linea continuo che collega tutti i vertici, sia un contrassegno su ogni vertice. Inoltre, il disegno della linea continua è influenzato dallo stile di disegno, ad esempio, si possono creare linee "a gradini" in vari stili.
Crea
Line2D
un'istanza con dati x e y in sequenze di xdata , ydata .Ulteriori argomenti di parole chiave sono
Line2D
proprietà:Proprietà
Descrizione
una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
scalare o Nessuno
bool
antialiased
o aabool
bool
Patch o (Percorso, Trasforma) o Nessuno
color
o ccolore
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sequenza di float (on/off inchiostro in punti) o (Nessuno, Nessuno)
(2, N) o due array 1D
drawstyle
o ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'sinistra', 'destra', 'basso', 'alto', 'nessuno'}
colore o Nessuno
str
bool
oggetto
linestyle
o ls{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth
o lwgalleggiante
stringa di stile marcatore,
Path
oMarkerStyle
markeredgecolor
o mecccolore
markeredgewidth
o miagolaregalleggiante
markerfacecolor
o mfccolore
markerfacecoloralt
o mfcaltcolore
markersize
o msgalleggiante
Nessuno o int o (int, int) o slice o lista[int] o float o (float, float) o lista[bool]
bool
float o callable[[Artista, Evento], tuple[bool, dict]]
sconosciuto
bool
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sconosciuto
str
bool
matrice 1D
matrice 1D
galleggiante
Vedere
set_linestyle()
per una descrizione degli stili di linea,set_marker()
per una descrizione dei marcatori eset_drawstyle()
per una descrizione degli stili di disegno.- contiene ( mouseevent ) [fonte] #
Verifica se sulla linea si è verificato un evento mouse .
Si considera che un evento si sia verificato "sulla" linea se è a meno di
self.pickradius
(predefinito: 5 punti) da essa. Utilizzareget_pickradius
oset_pickradius
per ottenere o impostare il raggio di selezione.- Parametri :
- mouseevent
matplotlib.backend_bases.MouseEvent
- mouseevent
- Resi :
- contiene bool
Se i valori sono all'interno del raggio.
- dettagli dict
Un dizionario , dove pointlist è un elenco di punti della linea che si trovano all'interno del pickradius intorno alla posizione dell'evento.
{'ind': pointlist}
TODO: ordina gli indici restituiti per distanza
- draw ( renderer ) [fonte] #
Disegna l'artista (e i suoi figli) usando il renderer dato.
Questo non ha effetto se l'artista non è visibile (
Artist.get_visible
restituisce False).- Parametri :
- sottoclasse del renderer .
RendererBase
- sottoclasse del renderer .
Appunti
Questo metodo è sovrascritto nelle sottoclassi Artist.
- drawStyleKeys = ['default', 'steps-mid', 'steps-pre', 'steps-post', 'steps'] #
- drawStyles = {'default': '_draw_lines', 'steps': '_draw_steps_pre', 'steps-mid': '_draw_steps_mid', 'steps-post': '_draw_steps_post', 'steps-pre': '_draw_steps_pre'} #
- fillStyles = ('full', 'left', 'right', 'bottom', 'top', 'none') #
- filled_markers = ('o', 'v', '^', '<', '>', '8', 's', 'p', '*', 'h', 'H', 'D' , 'd', 'P', 'X') #
- get_aa ( ) [fonte] #
Alias per
get_antialiased
.
- get_dash_capstyle ( ) [fonte] #
Restituisci le
CapStyle
linee tratteggiate.Vedi anche
set_dash_capstyle
.
- get_dash_joinstyle ( ) [fonte] #
Restituisci le
JoinStyle
linee tratteggiate.Vedi anche
set_dash_joinstyle
.
- get_data ( orig = True ) [fonte] #
Restituisce i dati della linea come coppia.
(xdata, ydata)
Se orig è True , restituisce i dati originali.
- get_drawstyle ( ) [fonte] #
Restituisci lo stile di disegno.
Vedi anche
set_drawstyle
.
- get_ds ( ) [fonte] #
Alias per
get_drawstyle
.
- get_fillstyle ( ) [fonte] #
Restituisce lo stile di riempimento del marcatore.
Vedi anche
set_fillstyle
.
- get_gapcolor ( ) [fonte] #
Restituisce la linea gapcolor.
Vedi anche
set_gapcolor
.
- get_linestyle ( ) [fonte] #
Restituisci lo stile di linea.
Vedi anche
set_linestyle
.
- get_linewidth ( ) [fonte] #
Restituisce la larghezza della linea in punti.
Vedi anche
set_linewidth
.
- get_ls ( ) [fonte] #
Alias per
get_linestyle
.
- get_lw ( ) [fonte] #
Alias per
get_linewidth
.
- get_marker ( ) [fonte] #
Restituisci il marcatore di linea.
Vedi anche
set_marker
.
- get_markeredgecolor ( ) [fonte] #
Restituisce il colore del bordo del marcatore.
Vedi anche
set_markeredgecolor
.
- get_markeredgewidth ( ) [fonte] #
Restituisce la larghezza del bordo del marcatore in punti.
Vedi anche
set_markeredgewidth
.
- get_markerfacecolor ( ) [fonte] #
Restituisce il colore della faccia dell'indicatore.
Vedi anche
set_markerfacecolor
.
- get_markerfacecoloralt ( ) [fonte] #
Restituisce il colore della faccia dell'indicatore alternativo.
Vedi anche
set_markerfacecoloralt
.
- get_markersize ( ) [fonte] #
Restituisce la dimensione dell'indicatore in punti.
Vedi anche
set_markersize
.
- get_markevery ( ) [fonte] #
Restituisce l'impostazione markevery per il sottocampionamento dei marker.
Vedi anche
set_markevery
.
- get_mec ( ) [fonte] #
Alias per
get_markeredgecolor
.
- get_mew ( ) [fonte] #
Alias per
get_markeredgewidth
.
- get_mfc ( ) [fonte] #
Alias per
get_markerfacecolor
.
- get_mfcalt ( ) [fonte] #
Alias per
get_markerfacecoloralt
.
- get_ms ( ) [fonte] #
Alias per
get_markersize
.
- get_pickradius ( ) [fonte] #
Restituisce il raggio di prelievo utilizzato per i test di contenimento.
Vedi
contains
per maggiori dettagli.
- get_solid_capstyle ( ) [fonte] #
Restituisce il
CapStyle
per le linee continue.Vedi anche
set_solid_capstyle
.
- get_solid_joinstyle ( ) [fonte] #
Restituisce il
JoinStyle
per le linee continue.Vedi anche
set_solid_joinstyle
.
- get_window_extent ( renderer = None ) [fonte] #
Ottieni il riquadro di delimitazione dell'artista nello spazio espositivo.
La larghezza e l'altezza del riquadro di delimitazione non sono negative.
Le sottoclassi dovrebbero sovrascrivere per l'inclusione nel calcolo "stretto" del riquadro di delimitazione. L'impostazione predefinita è restituire un riquadro di delimitazione vuoto a 0, 0.
Fai attenzione quando usi questa funzione, i risultati non si aggiorneranno se l'estensione della finestra dell'artista cambia. L'estensione può cambiare a causa di eventuali modifiche nello stack di trasformazione, come la modifica dei limiti degli assi, la dimensione della figura o la tela utilizzata (come avviene quando si salva una figura). Questo può portare a comportamenti imprevisti in cui le figure interattive appariranno bene sullo schermo, ma verranno salvate in modo errato.
- get_xdata ( orig = True ) [fonte] #
Restituisci i dati x.
Se orig è True , restituisce i dati originali, altrimenti i dati elaborati.
- get_ydata ( orig = True ) [fonte] #
Restituisci i dati y.
Se orig è True , restituisce i dati originali, altrimenti i dati elaborati.
- è_trattino ( ) [fonte] #
Restituisce se la linea ha uno stile di linea tratteggiato.
Si presume che uno stile di linea personalizzato sia tratteggiato, non lo ispezioniamo
onoffseq
direttamente.Vedi anche
set_linestyle
.
- lineStyles = {'': '_draw_nothing', ' ': '_draw_nothing', '-': '_draw_solid', '--': '_draw_dashed', '-.': '_draw_dash_dot', ':': '_draw_dotted' , 'Nessuno': '_draw_nothing'} #
- markers = {'.': 'point', ',': 'pixel', 'o': 'circle', 'v': 'triangle_down', '^': 'triangle_up', '<': 'triangle_left' , '>': 'triangle_right', '1': 'tri_down', '2': 'tri_up', '3': 'tri_left', '4': 'tri_right', '8': 'octagon' , ' s': 'quadrato', 'p': 'pentagono', '*': 'stella','h': 'hexagon1', 'H': 'hexagon2', '+': 'plus', 'x': 'x', 'D': 'diamond', 'd': 'thin_diamond', '|': 'vline', '_': 'hline', 'P': 'plus_filled', 'X': 'x_filled', 0: 'tickleft', 1: 'tickright ', 2: 'tickup', 3: 'tickdown', 4: 'caretleft', 5: 'caretright', 6: 'caretup', 7: 'caretdown', 8: 'caretleftbase', 9: 'caretrightbase', 10: 'caretupbase', 11: 'caretdownbase', 'Nessuno': 'niente', 'nessuno': 'niente', ' ': 'niente', '': 'niente'} #
- raggio selezione proprietà #
Restituisce il raggio di prelievo utilizzato per i test di contenimento.
Vedi
contains
per maggiori dettagli.
- set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation=<UNSET> , antialiased=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET > , dash_capstyle=<UNSET> , dash_joinstyle=<UNSET> , dash =<UNSET> , data=<UNSET> , drawstyle=<UNSET> , fillstyle=<UNSET> , gapcolor=<UNSET> , gid=<UNSET> , in_layout=<UNSET> ,etichetta=<UNSET> ,linestyle=<UNSET> , linewidth=<UNSET> , marker=<UNSET> , markeredgecolor=<UNSET> , markeredgewidth=<UNSET> , markerfacecolor=<UNSET> , markerfacecoloralt=<UNSET> , markersize=<UNSET> , markevery= <UNSET> , mouseover=<UNSET> , path_effects=<UNSET> , picker=<UNSET> , pickradius=<UNSET> , rasterized=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , solid_capstyle=<UNSET > ,solid_joinstyle=<UNSET> ,transform=<UNSET> , url=<UNSET> , visible=<UNSET> , xdata=<UNSET> , ydata=<UNSET> , zorder=<UNSET> ) [source] #
Imposta più proprietà contemporaneamente.
Le proprietà supportate sono
Proprietà
Descrizione
una funzione di filtro, che accetta un array float (m, n, 3) e un valore dpi e restituisce un array (m, n, 3) e due offset dall'angolo in basso a sinistra dell'immagine
scalare o Nessuno
bool
bool
bool
Patch o (Percorso, Trasforma) o Nessuno
colore
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sequenza di float (on/off inchiostro in punti) o (Nessuno, Nessuno)
(2, N) o due array 1D
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
{'completo', 'sinistra', 'destra', 'basso', 'alto', 'nessuno'}
colore o Nessuno
str
bool
oggetto
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
galleggiante
stringa di stile marcatore,
Path
oMarkerStyle
colore
galleggiante
colore
colore
galleggiante
Nessuno o int o (int, int) o slice o lista[int] o float o (float, float) o lista[bool]
bool
float o callable[[Artista, Evento], tuple[bool, dict]]
sconosciuto
bool
(scala: float, lunghezza: float, casualità: float)
bool o Nessuno
CapStyle
o {'culo', 'sporgente', 'rotondo'}JoinStyle
o {'mitre', 'round', 'bevel'}sconosciuto
str
bool
matrice 1D
matrice 1D
galleggiante
- set_aa ( b ) [fonte] #
Alias per
set_antialiased
.
- set_antialiased ( b ) [fonte] #
Imposta se utilizzare il rendering con antialias.
- Parametri :
- b bool
- set_dash_capstyle ( s ) [fonte] #
Come disegnare i cappucci terminali se la linea è
is_dashed
.Il capstyle predefinito è
rcParams["lines.dash_capstyle"]
(predefinito: ).<CapStyle.butt: 'butt'>
- Parametri :
- s
CapStyle
o {'culo', 'sporgente', 'rotondo'}
- s
- set_dash_joinstyle ( s ) [fonte] #
Come unire segmenti della linea se
is_dashed
.Lo stile di join predefinito è
rcParams["lines.dash_joinstyle"]
(predefinito: ).<JoinStyle.round: 'round'>
- Parametri :
- s
JoinStyle
o {'mitre', 'round', 'bevel'}
- s
- imposta_trattini ( seq ) [fonte] #
Imposta la sequenza dei trattini.
La sequenza di trattini è una sequenza di float di lunghezza pari che descrive la lunghezza di trattini e spazi in punti.
Ad esempio, (5, 2, 1, 2) descrive una sequenza di trattini di 5 punti e 1 punto separati da spazi di 2 punti.
Vedi anche
set_gapcolor
, che permette di riempire quegli spazi con un colore.- Parametri :
- seq sequenza di float (on/off inchiostro in punti) o (Nessuno, Nessuno)
Se seq è vuoto o , lo stile di linea verrà impostato su solido.
(None, None)
- set_data ( * args ) [fonte] #
Imposta i dati x e y.
- Parametri :
- *args (2, N) matrice o due matrici 1D
- set_drawstyle ( drawstyle ) [fonte] #
Imposta lo stile di disegno della trama.
Il drawstyle determina come i punti sono collegati.
- Parametri :
- drawstyle {'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, default: 'default'
Per 'default', i punti sono collegati con linee rette.
Le varianti a gradini collegano i punti con linee a gradino, cioè linee orizzontali con gradini verticali. Differiscono nella posizione del passaggio:
'steps-pre': il passo è all'inizio del segmento di linea, cioè la linea sarà al valore y del punto a destra.
'steps-mid': il passo è a metà strada tra i punti.
'steps-post: Il passo è alla fine del segmento di linea, cioè la linea sarà al valore y del punto a sinistra.
'steps' è uguale a 'steps-pre' e viene mantenuto per compatibilità con le versioni precedenti.
Per esempi vedere Step Demo .
- set_ds ( drawstyle ) [fonte] #
Alias per
set_drawstyle
.
- set_fillstyle ( fs ) [fonte] #
Imposta lo stile di riempimento del marcatore.
- Parametri :
- fs {'full', 'left', 'right', 'bottom', 'top', 'none'}
Possibili valori:
'full': Riempi l'intero marker con markerfacecolor .
'left', 'right', 'bottom', 'top': riempi la metà del marker sul lato indicato con markerfacecolor . L'altra metà del pennarello è riempita con markerfacecoloralt .
'none': Nessun riempimento.
Per esempi vedere Stili di riempimento indicatore .
- set_gapcolor ( gapcolor ) [fonte] #
Imposta un colore per riempire gli spazi vuoti nello stile della linea tratteggiata.
Nota
Le linee a strisce vengono create disegnando due linee tratteggiate interfogliate. Possono esserci sovrapposizioni tra questi due, che possono causare artefatti quando si utilizza la trasparenza.
Questa funzionalità è sperimentale e potrebbe cambiare.
- Parametri :
- colore gapcolor o Nessuno
Il colore con cui colmare i vuoti. Se Nessuno, le lacune non sono colmate.
- set_linestyle ( ls ) [fonte] #
Imposta lo stile di linea della linea.
- Parametri :
- ls {'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
Possibili valori:
Una stringa:
stile di linea
descrizione
'-'
o'solid'
linea continua
'--'
o'dashed'
linea tratteggiata
'-.'
o'dashdot'
linea tratteggiata
':'
o'dotted'
linea tratteggiata
'none'
,'None'
, , o' '
''
disegnare niente
In alternativa può essere fornita una tupla trattino della seguente forma:
(offset, onoffseq)
dove
onoffseq
è una tupla di lunghezza pari di inchiostro acceso e spento in punti. Vedi ancheset_dashes()
.
Per esempi vedere Stili di linea .
- set_linewidth ( w ) [fonte] #
Imposta la larghezza della linea in punti.
- Parametri :
- w galleggiare
Larghezza della linea, in punti.
- set_ls ( ls ) [fonte] #
Alias per
set_linestyle
.
- set_lw ( w ) [fonte] #
Alias per
set_linewidth
.
- set_marker ( marcatore ) [fonte] #
Imposta il marcatore di linea.
- Parametri :
- marcatore marcatore stile stringa,
Path
oMarkerStyle
Vedere
markers
per la descrizione completa dei possibili argomenti.
- marcatore marcatore stile stringa,
- set_markeredgecolor ( ec ) [fonte] #
Imposta il colore del bordo del marcatore.
- Parametri :
- colore ce
- set_markeredgewidth ( ew ) [fonte] #
Imposta la larghezza del bordo del marcatore in punti.
- Parametri :
- eh galleggiante
Larghezza del bordo del marker, in punti.
- set_markerfacecolor ( fc ) [fonte] #
Imposta il colore della faccia del marcatore.
- Parametri :
- colore fc
- set_markerfacecoloralt ( fc ) [fonte] #
Imposta il colore della faccia dell'indicatore alternativo.
- Parametri :
- colore fc
- set_markersize ( sz ) [fonte] #
Imposta la dimensione del marcatore in punti.
- Parametri :
- galleggiante sz
Dimensione dell'indicatore, in punti.
- set_markogni ( ogni ) [fonte] #
Impostare la proprietà markevery per sottocampionare il grafico quando si utilizzano i marcatori.
ad esempio, se
every=5
, verrà tracciato ogni 5 marcatori.- Parametri :
- ogni None o int o (int, int) o slice o lista[int] o float o (float, float) o lista[bool]
Quali marcatori tracciare.
every=None
: ogni punto verrà tracciato.every=N
: ogni N-esimo marcatore verrà tracciato a partire dal marcatore 0.every=(start, N)
: verrà tracciato ogni N-esimo marcatore, a partire dall'indice start .every=slice(start, end, N)
: verrà tracciato ogni N-esimo marcatore, a partire da index start , fino a ma non includendo index end .every=[i, j, m, ...]
: verranno tracciati solo i marcatori agli indici indicati.every=[True, False, True, ...]
: verranno tracciate solo le posizioni True. L'elenco deve avere la stessa lunghezza dei punti dati.every=0.1
, (vale a dire un galleggiante): i marcatori saranno distanziati a distanze visive approssimativamente uguali lungo la linea; la distanza lungo la linea tra i marcatori è determinata moltiplicando la distanza delle coordinate di visualizzazione della diagonale del riquadro di delimitazione degli assi per il valore di ogni .every=(0.5, 0.1)
(ovvero una tupla di float di lunghezza 2): simile aevery=0.1
ma il primo indicatore sarà sfalsato lungo la linea di 0,5 moltiplicato per la distanza diagonale delle coordinate di visualizzazione lungo la linea.
Per esempi vedi Markevery Demo .
Appunti
L'impostazione di markevery disegnerà comunque solo marcatori nei punti dati effettivi. Sebbene la forma dell'argomento float miri a una spaziatura visiva uniforme, deve forzare dalla spaziatura ideale al punto dati disponibile più vicino. A seconda del numero e della distribuzione dei punti dati, il risultato potrebbe comunque non apparire uniformemente distanziato.
Quando si utilizza un offset iniziale per specificare il primo marker, l'offset sarà dal primo punto dati che potrebbe essere diverso dal primo punto dati visibile se il grafico viene ingrandito.
Se si esegue lo zoom avanti su un grafico quando si utilizzano argomenti float, i punti dati effettivi che hanno i marcatori cambieranno perché la distanza tra i marcatori è sempre determinata dalle coordinate di visualizzazione assi-riquadro di delimitazione-diagonale indipendentemente dai limiti dei dati degli assi effettivi.
- set_mec ( ec ) [fonte] #
Alias per
set_markeredgecolor
.
- set_mew ( ew ) [fonte] #
Alias per
set_markeredgewidth
.
- set_mfc ( fc ) [fonte] #
Alias per
set_markerfacecolor
.
- set_mfcalt ( fc ) [fonte] #
Alias per
set_markerfacecoloralt
.
- set_ms ( sz ) [fonte] #
Alias per
set_markersize
.
- set_picker ( p ) [fonte] #
Imposta i dettagli del selettore eventi per la linea.
- Parametri :
- p float o callable[[Artist, Event], tuple[bool, dict]]
Se è un float, viene utilizzato come raggio di selezione in punti.
- set_pickradius ( pickradius ) [fonte] #
Impostare il raggio di prelievo utilizzato per i test di contenimento.
Vedi
contains
per maggiori dettagli.- Parametri :
- pickradius galleggiante
Seleziona il raggio, in punti.
- set_solid_capstyle ( s ) [fonte] #
Come disegnare i cappucci terminali se la linea è continua (non
is_dashed
)Il capstyle predefinito è
rcParams["lines.solid_capstyle"]
(predefinito: ).<CapStyle.projecting: 'projecting'>
- Parametri :
- s
CapStyle
o {'culo', 'sporgente', 'rotondo'}
- s
- set_solid_joinstyle ( s ) [fonte] #
Come unire i segmenti se la linea è continua (non
is_dashed
).Lo stile di join predefinito è
rcParams["lines.solid_joinstyle"]
(predefinito: ).<JoinStyle.round: 'round'>
- Parametri :
- s
JoinStyle
o {'mitre', 'round', 'bevel'}
- s
- ordine z = 2 #
Esempi che utilizzano matplotlib.lines.Line2D
#
Personalizzazione degli stili delle linee tratteggiate
Etichette delle figure: suptitle, supxlabel, supylabel
Scala etichetta angolo invariante
Composizione di leggende personalizzate
Riferimento allo stile della freccia di annotazione
Riferimento per artisti Matplotlib
Dimostrazione dell'asse del parassita
Prezzi delle azioni su 32 anni
Il problema del doppio pendolo
Diagramma SkewT-logP: utilizzo di trasformazioni e proiezioni personalizzate
Formattatore tick personalizzato per serie temporali
Soglia di un'immagine con RangeSlider
Agganciare i cursori a valori discreti
Rendering più veloce utilizzando il blitting
Esercitazione sulle trasformazioni