matplotlib.text

Classi per includere testo in una figura.

classe matplotlib.text. Text ( x = 0 , y = 0 , text = '' , * , color = None , verticalalignment = 'baseline' , horizontalalignment = 'left' , multialignment = None , fontproperties = None , rotation = None , linespacing = None , rotation_mode = Nessuno, usetex = None , wrap = False , transform_rotates_text = False , parse_math = None , ** kwargs )

Basi:Artist

Gestire la memorizzazione e il disegno del testo nella finestra o nelle coordinate dei dati.

Crea Textun'istanza in x , y con testo stringa .

Il testo è allineato rispetto al punto di ancoraggio ( x , y ) secondo horizontalalignment(default: 'left') e verticalalignment (default: 'bottom'). Vedere anche Allineamento del testo .

Sebbene Text accetti l'argomento della parola chiave 'label', per impostazione predefinita non viene aggiunto agli handle di una legenda.

Gli argomenti delle parole chiave valide sono:

Proprietà	Descrizione
agg_filter	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
alpha	scalare o Nessuno
animated	bool
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	sconosciuto
clip_on	sconosciuto
clip_path	sconosciuto
coloro c	colore
figure	Figure
fontfamilyo famiglia	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertieso font o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo dimensione	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretcho allungare	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyleo stile	{'normale', 'corsivo', 'obliquo'}
fontvarianto variante	{'normale', 'maiuscoletto'}
fontweighto peso	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignmento ah	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignmento mamma	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignmento Va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

contiene ( mouseevent )

Restituisce se l'evento del mouse si è verificato all'interno del riquadro di delimitazione allineato all'asse del testo.

draw ( renderer )

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

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

get_bbox_patch ( )

Restituisci la bbox Patch, o None se patches.FancyBboxPatch non è stata creata.

get_c ( )

Alias ​​per get_color.

get_color ( )

Restituisce il colore del testo.

get_family ( )

Alias ​​per get_fontfamily.

get_font ( )

Alias ​​per get_fontproperties.

get_font_properties ( )

Alias ​​per get_fontproperties.

get_fontfamily ( )

Restituisce l'elenco delle famiglie di caratteri utilizzate per la ricerca dei caratteri.

Guarda anche

font_manager.FontProperties.get_family

get_fontname ( )

Restituisce il nome del font come stringa.

Guarda anche

font_manager.FontProperties.get_name

get_fontproperties ( )

Restituisci il file font_manager.FontProperties.

get_fontsize ( )

Restituisce la dimensione del carattere come numero intero.

Guarda anche

font_manager.FontProperties.get_size_in_points

get_fontstyle ( )

Restituisce lo stile del carattere come stringa.

Guarda anche

font_manager.FontProperties.get_style

get_fontvariant ( )

Restituisce la variante del carattere come stringa.

Guarda anche

font_manager.FontProperties.get_variant

get_fontweight ( )

Restituisce lo spessore del carattere come una stringa o un numero.

Guarda anche

font_manager.FontProperties.get_weight

get_ha ( )

Alias ​​per get_horizontalalignment.

get_horizontalalignment ( )

Restituisce l'allineamento orizzontale come una stringa. Sarà uno tra 'sinistra', 'centro' o 'destra'.

get_math_fontfamily ( )

Restituisce il nome della famiglia di caratteri per il testo matematico reso da Matplotlib.

Il valore predefinito è rcParams["mathtext.fontset"](predefinito: 'dejavusans').

Guarda anche

set_math_fontfamily

get_name ( )

Alias ​​per get_fontname.

get_parse_math ( )

Restituisce se l'analisi del testo matematico è considerata per this Text.

get_position ( )

Restituisce la posizione (x, y) del testo.

get_prop_tup ( renderer = Nessuno )

[ Deprecato ] Restituisce una tupla hashable di proprietà.

Non concepito per essere leggibile dall'uomo, ma utile per i backend che desiderano memorizzare nella cache informazioni derivate sul testo (ad esempio, layout) e hanno bisogno di sapere se il testo è cambiato.

Appunti

Deprecato dalla versione 3.5.

get_rotazione ( )

Restituisce l'angolo del testo in gradi compreso tra 0 e 360.

get_rotation_mode ( )

Restituisce la modalità di rotazione del testo.

get_size ( )

Alias ​​per get_fontsize.

get_stretch ( )

Restituisce il font stretch come una stringa o un numero.

Guarda anche

font_manager.FontProperties.get_stretch

get_style ( )

Alias ​​per get_fontstyle.

get_text ( )

Restituisce la stringa di testo.

get_transform_rotates_text ( )

Restituisce se le rotazioni della trasformazione influiscono sulla direzione del testo.

get_unitless_position ( )

Restituisce la (x, y) posizione senza unità del testo.

get_usetex ( )

Restituisce se questo Textoggetto utilizza TeX per il rendering.

get_va ( )

Alias ​​per get_verticalalignment.

get_variant ( )

Alias ​​per get_fontvariant.

get_verticalalignment ( )

Restituisce l'allineamento verticale come una stringa. Sarà uno tra 'top', 'center', 'bottom', 'baseline' o 'center_baseline'.

get_weight ( )

Alias ​​per get_fontweight.

get_window_extent ( renderer = Nessuno , dpi = Nessuno )

Restituisce la Bboxdelimitazione del testo, in unità di visualizzazione.

Oltre ad essere utilizzato internamente, questo è utile per specificare le aree cliccabili in un file png su una pagina web.

Parametri :

renderer Renderer, facoltativo

È necessario un renderer per calcolare il riquadro di delimitazione. Se l'artista è già stato disegnato, il renderer viene memorizzato nella cache; quindi, è necessario passare questo argomento solo quando si chiama get_window_extent prima della prima estrazione. In pratica, di solito è più semplice attivare prima un pareggio, ad esempio chiamando draw_without_renderingo plt.show().

dpi float, facoltativo

Il valore dpi per il calcolo della bbox, per impostazione predefinita è self.figure.dpi( non il renderer dpi); dovrebbe essere impostato, ad esempio, per abbinare le regioni con una figura salvata con un valore dpi personalizzato.

get_wrap ( )

Restituisce se il testo può essere avvolto.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET> , gid=<DISINSERITO>, horizontalalignment=<UNSET>, in_layout=<UNSET> , label=<UNSET> , linespaing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math=<UNSET> , path_effects=<UNSET> , picker =<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , text=<UNSET> , transform=< DISINSERITO> ,transform_rotates_text=<UNSET> ,url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y=<UNSET> , zorder=<UNSET> )

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà	Descrizione
agg_filter	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
alpha	scalare o Nessuno
animated	bool
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	sconosciuto
clip_on	sconosciuto
clip_path	sconosciuto
color	colore
figure	Figure
fontfamily	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontproperties	font_manager.FontPropertieso stropathlib.Path
fontsize	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretch	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyle	{'normale', 'corsivo', 'obliquo'}
fontvariant	{'normale', 'maiuscoletto'}
fontweight	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignment	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignment	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignment	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

set_backgroundcolor ( colore )

Imposta il colore di sfondo del testo aggiornando la bbox.

Parametri :

colore colore

Guarda anche

set_bbox

Per modificare la posizione del riquadro di delimitazione

set_bbox ( rectprops )

Disegna un rettangolo di delimitazione attorno a sé.

Parametri :

rectprops dict con proprietà perpatches.FancyBboxPatch

Lo stile box predefinito è 'quadrato'. La scala di mutazione di patches.FancyBboxPatchè impostata su fontsize.

Esempi

t.set_bbox(dict(facecolor='red', alpha=0.5))

set_c ( colore )

Alias ​​per set_color.

set_clip_box ( clipbox )

Imposta la clip dell'artista Bbox.

Parametri :

clipboxBbox

set_clip_on ( b )

Imposta se l'artista utilizza il ritaglio.

Quando i falsi artisti saranno visibili al di fuori degli assi, il che può portare a risultati inaspettati.

Parametri :

b bool

set_clip_path ( percorso , trasformazione = Nessuno )

Imposta il percorso della clip dell'artista.

Parametri :

percorso Patcho Patho TransformedPatho Nessuno

Il percorso della clip. Se viene fornito un Path, deve essere fornito anche transform . Se None , viene rimosso un percorso clip precedentemente impostato.

trasformare Transform, facoltativo

Usato solo se path è a Path, nel qual caso il dato Path viene convertito in TransformedPathusing transform .

Appunti

Per efficienza, se path è un Rectanglemetodo this imposterà la casella di ritaglio sul rettangolo corrispondente e imposterà il tracciato di ritaglio su None.

Per motivi tecnici (supporto di set), una tupla ( path , transform ) è accettata anche come singolo parametro posizionale.

set_color ( colore )

Imposta il colore di primo piano del testo

Parametri :

colore colore

set_family ( nome carattere )

Alias ​​per set_fontfamily.

set_font ( fp )

Alias ​​per set_fontproperties.

set_font_properties ( fp )

Alias ​​per set_fontproperties.

set_fontfamily ( nome carattere )

Imposta la famiglia di caratteri. Può essere una singola stringa o un elenco di stringhe con priorità decrescente. Ogni stringa può essere un vero nome di font o un nome di classe di font generico. In quest'ultimo caso, i nomi dei caratteri specifici verranno cercati nei corrispondenti rcParams.

Se Textun'istanza è costruita con fontfamily=None, allora il carattere è impostato su rcParams["font.family"](default: ['sans-serif']), e lo stesso avviene quando viene chiamato su un'istanza set_fontfamily()esistente .Text

Parametri :

fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

Guarda anche

font_manager.FontProperties.set_family

set_fontname ( fontname )

Alias ​​per set_family.

Solo alias unidirezionale: il getter è diverso.

Parametri :

fontname {FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}

Guarda anche

font_manager.FontProperties.set_family

set_fontproperties ( fp )

Imposta le proprietà del carattere che controllano il testo.

Parametri :

fp font_manager.FontPropertieso stropathlib.Path

Se a str, viene interpretato come un pattern fontconfig analizzato da FontProperties. Se a pathlib.Path, viene interpretato come il percorso assoluto di un file di font.

set_fontsize ( dimensione carattere )

Imposta la dimensione del carattere.

Parametri :

fontsize float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}

Se float, la dimensione del carattere in punti. I valori della stringa denotano le dimensioni relative alla dimensione del carattere predefinita.

Guarda anche

font_manager.FontProperties.set_size

set_fontstretch ( stretch )

Impostare l'estensione del carattere (condensazione o espansione orizzontale).

Parametri :

stretch {un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra- espanso', 'ultra-espanso'}

Guarda anche

font_manager.FontProperties.set_stretch

set_fontstyle ( fontstyle )

Imposta lo stile del carattere.

Parametri :

fontstyle {'normale', 'italic', 'obliquo'}

Guarda anche

font_manager.FontProperties.set_style

set_fontvariant ( variante )

Imposta la variante del carattere.

Parametri :

variante {'normale', 'small-caps'}

Guarda anche

font_manager.FontProperties.set_variant

set_fontweight ( peso )

Imposta lo spessore del carattere.

Parametri :

peso {un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi' , 'grassetto', 'pesante', 'extra grassetto', 'nero'}

Guarda anche

font_manager.FontProperties.set_weight

set_ha ( align )

Alias ​​per set_horizontalalignment.

set_horizontalalignment ( align )

Impostare l'allineamento orizzontale rispetto al punto di ancoraggio.

Vedere anche Allineamento del testo .

Parametri :

allinea {'sinistra', 'centro', 'destra'}

set_linespacing ( spaziatura )

Imposta l'interlinea come un multiplo della dimensione del carattere.

L'interlinea predefinita è 1,2.

Parametri :

spaziatura float (multiplo della dimensione del carattere)

set_ma ( align )

Alias ​​per set_multialignment.

set_math_fontfamily ( fontfamily )

Imposta la famiglia di caratteri per il testo matematico reso da Matplotlib.

Ciò influisce solo sul renderer matematico di Matplotlib. Non ha effetto durante il rendering con TeX ( usetex=True).

Parametri :

famiglia di caratteri str

Il nome della famiglia di caratteri.

Le famiglie di font disponibili sono definite nel file matplotlibrc.template .

Guarda anche

get_math_fontfamily

set_multialignment ( align )

Imposta l'allineamento del testo per i testi multilinea.

Il layout del riquadro di delimitazione di tutte le linee è determinato dalle proprietà horizontalalignment e verticalalignment. Questa proprietà controlla l'allineamento delle righe di testo all'interno di quella casella.

Parametri :

allinea {'sinistra', 'destra', 'centro'}

set_name ( fontname )

Alias ​​per set_fontname.

set_parse_math ( parse_math )

Ignora l'opzione per disabilitare qualsiasi analisi del testo matematico per this Text.

Parametri :

parse_math bool

Se False, questo Textnon utilizzerà mai il testo matematico. Se True, il testo matematico verrà utilizzato se è presente un numero pari di simboli del dollaro senza caratteri di escape.

imposta_posizione ( xy )

Imposta la posizione ( x , y ) del testo.

Parametri :

xy (flottante, mobile)

imposta_rotazione ( s )

Imposta la rotazione del testo.

Parametri :

s float o {'vertical', 'horizontal'}

L'angolo di rotazione in gradi in direzione matematicamente positiva (antioraria). 'orizzontale' è uguale a 0, 'verticale' è uguale a 90.

set_rotation_mode ( m )

Imposta la modalità di rotazione del testo.

Parametri :

m {Nessuno, 'predefinito', 'ancora'}

Se Noneo "default", il testo verrà prima ruotato, quindi allineato in base ai rispettivi allineamenti orizzontali e verticali. Se "anchor", allora l'allineamento avviene prima della rotazione.

set_size ( fontsize )

Alias ​​per set_fontsize.

set_stretch ( stretch )

Alias ​​per set_fontstretch.

set_style ( fontstyle )

Alias ​​per set_fontstyle.

set_text ( s )

Imposta la stringa di testo s .

Può contenere newline ( \n) o matematica nella sintassi LaTeX.

Parametri :

s oggetto

Qualsiasi oggetto viene convertito nella sua strrappresentazione, tranne Noneche viene convertito in una stringa vuota.

set_transform_rotates_text ( t )

Se le rotazioni della trasformazione influiscono sulla direzione del testo.

Parametri :

t bool

set_usetex ( usetex )

Parametri :

usetex bool o Nessuno

Se eseguire il rendering utilizzando TeX, Nonesignifica utilizzare rcParams["text.usetex"](predefinito: False).

set_va ( align )

Alias ​​per set_verticalalignment.

set_variant ( variante )

Alias ​​per set_fontvariant.

set_verticalalignment ( align )

Impostare l'allineamento verticale rispetto al punto di ancoraggio.

Vedere anche Allineamento del testo .

Parametri :

align {'bottom', 'baseline', 'center', 'center_baseline', 'top'}

set_weight ( peso )

Alias ​​per set_fontweight.

set_wrap ( wrap )

Imposta se il testo può essere mandato a capo.

Parametri :

avvolgere bool

Appunti

Il wrapping non funziona insieme a (utilizzato anche internamente da IPython/Jupyter). L'impostazione "stretto" ridimensiona la tela per accogliere tutto il contenuto e avviene prima del wrapping.savefig(..., bbox_inches='tight')%matplotlib inline

set_x ( x )

Imposta la posizione x del testo.

Parametri :

x galleggiante

set_y ( y )

Imposta la posizione y del testo.

Parametri :

tu galleggi

aggiornamento ( kwargs )

Aggiorna le proprietà di questo artista da dict props .

Parametri :

oggetti di scena dict

update_bbox_position_size ( renderer )

Aggiorna la posizione e le dimensioni della bbox.

Questo metodo dovrebbe essere utilizzato quando la posizione e la dimensione della bbox devono essere aggiornate prima di disegnare effettivamente la bbox.

update_from ( altro )

Copia le proprietà da other a self .

ordine z = 3

classe matplotlib.text. Annotazione ( text , xy , xytext = None , xycoords = 'data' , textcoords = None , arrowprops = None , annotation_clip = None , ** kwargs )

Basi: Text,_AnnotationBase

An Annotationè a Textche può riferirsi a una posizione specifica xy . Facoltativamente, è possibile disegnare una freccia che punta dal testo a xy .

Attributi :

xy

La posizione annotata.

xycoords

Il sistema di coordinate per xy .

arrow_patch

A FancyArrowPatchper puntare da xytext a xy .

Annotare il punto xy con il testo text .

Nella forma più semplice, il testo è posizionato in xy .

Facoltativamente, il testo può essere visualizzato in un'altra posizione xytext . È quindi possibile aggiungere una freccia che punta dal testo al punto annotato xy definendo arrowprops .

Parametri :

testo str

Il testo dell'annotazione.

xy (flottante, mobile)

Il punto (x, y) da annotare. Il sistema di coordinate è determinato da xycoords .

xytext (float, float), predefinito: xy

La posizione (x, y) in cui posizionare il testo. Il sistema di coordinate è determinato da textcoords .

xycoords str o Artisto Transformo chiamabile o (float, float), default: 'data'

Il sistema di coordinate in cui è fornito xy . Sono supportati i seguenti tipi di valori:

• Una delle seguenti stringhe:

  Valore	Descrizione
  'punti figura'	Punti dalla parte inferiore sinistra della figura
  'figura pixel'	Pixel dalla parte inferiore sinistra della figura
  'frazione di cifre'	Frazione della figura in basso a sinistra
  'sottofigura punti'	Punti dalla parte inferiore sinistra della sottofigura
  'sottofigura pixel'	Pixel dalla parte inferiore sinistra della sottofigura
  'frazione sottofigura'	Frazione di sottofigura in basso a sinistra
  'punti di assi'	Punti dall'angolo inferiore sinistro degli assi
  'assi pixel'	Pixel dall'angolo inferiore sinistro degli assi
  'frazione di assi'	Frazione di assi da sinistra in basso
  'dati'	Utilizza il sistema di coordinate dell'oggetto da annotare (impostazione predefinita)
  'polare'	(theta, r) ​​se non coordinate 'dati' native

  Si noti che 'pixel di sottofigura' e 'pixel di figura' sono gli stessi per la figura principale, quindi gli utenti che desiderano un codice utilizzabile in una sottofigura possono utilizzare 'pixel di sottofigura'.

• An Artist: xy è interpretato come una frazione di Bbox. Ad esempio (0, 0) sarebbe l'angolo in basso a sinistra del riquadro di delimitazione e (0.5, 1) sarebbe la parte superiore centrale del riquadro di delimitazione.

• A Transformper trasformare xy in coordinate dello schermo.

• Una funzione con una delle seguenti firme:

  def transform(renderer) -> Bbox
  def transform(renderer) -> Transform
  

  dove renderer è una RendererBasesottoclasse.

  Il risultato della funzione viene interpretato come i casi Artiste Transformprecedenti.

• Una tupla (xcoords, ycoords) che specifica sistemi di coordinate separati per x e y . xcoords e ycoords devono essere ciascuno di uno dei tipi sopra descritti.

Vedere Annotazioni avanzate per ulteriori dettagli.

textcoords str o Artisto Transformo callable o (float, float), default: valore di xycoords

Il sistema di coordinate in cui è fornito xytext .

Tutti i valori xycoords sono validi così come le seguenti stringhe:

Valore	Descrizione
'punti di sfasamento'	Scostamento (in punti) dal valore xy
'pixel sfalsati'	Offset (in pixel) dal valore xy

arrowprops dict, facoltativo

Le proprietà usate per disegnare una FancyArrowPatchfreccia tra le posizioni xy e xytext . Il valore predefinito è Nessuno, ovvero non viene disegnata alcuna freccia.

Per ragioni storiche ci sono due modi diversi per specificare le frecce, "semplice" e "fantasia":

Freccia semplice:

Se arrowprops non contiene la chiave 'arrowstyle' le chiavi consentite sono:

Chiave	Descrizione
larghezza	La larghezza della freccia in punti
larghezza della testa	La larghezza della base della punta della freccia in punti
lunghezza della testa	La lunghezza della punta della freccia in punti
restringersi	Frazione della lunghezza totale da restringere da entrambe le estremità
?	Qualsiasi chiave permatplotlib.patches.FancyArrowPatch

La freccia è attaccata al bordo della casella di testo, la posizione esatta (angoli o centri) a seconda di dove punta.

Freccia fantasia:

Viene utilizzato se 'arrowstyle' è fornito in arrowprops .

Le chiavi valide sono i seguenti FancyArrowPatch parametri:

Chiave	Descrizione
arrowstyle	lo stile della freccia
connectionstyle	lo stile di connessione
repos	vedi sotto; il valore predefinito è (0,5, 0,5)
patchA	l'impostazione predefinita è il riquadro di delimitazione del testo
patchB	l'impostazione predefinita è Nessuno
rimpicciolireA	il valore predefinito è 2 punti
restringimento B	il valore predefinito è 2 punti
mutazione_scala	l'impostazione predefinita è la dimensione del testo (in punti)
mutazione_aspetto	il valore predefinito è 1.
?	qualsiasi chiave permatplotlib.patches.PathPatch

L'esatta posizione del punto iniziale della freccia è definita da relpos . È una tupla di coordinate relative della casella di testo, dove (0, 0) è l'angolo in basso a sinistra e (1, 1) è l'angolo in alto a destra. I valori <0 e >1 sono supportati e specificano i punti all'esterno della casella di testo. Per impostazione predefinita (0.5, 0.5) il punto iniziale è centrato nella casella di testo.

annotation_clip bool o Nessuno, impostazione predefinita: Nessuno

Se ritagliare (ovvero non disegnare) l'annotazione quando il punto di annotazione xy è al di fuori dell'area degli assi.

• Se True , l'annotazione verrà tagliata quando xy è fuori dagli assi.

• Se False , l'annotazione verrà sempre disegnata.

• Se None , l'annotazione verrà ritagliata quando xy è fuori dagli assi e xycoords è 'dati'.

**kwargs

Ulteriori kwarg vengono passati a Text.

Resi :

Annotation

Guarda anche

Annotazioni avanzate

annunci di proprietà

Il sistema di coordinate da utilizzare per Annotation.xyann.

contiene ( evento )

Restituisce se l'evento del mouse si è verificato all'interno del riquadro di delimitazione allineato all'asse del testo.

draw ( renderer )

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

Appunti

Questo metodo è sovrascritto nelle sottoclassi Artist.

get_annords ( )

Restituisce il sistema di coordinate da utilizzare per Annotation.xyann.

Vedi anche xycoords in Annotation.

get_tightbbox ( renderer = Nessuno )

Mi piace Artist.get_window_extent, ma include eventuali ritagli.

Parametri :

sottoclasse del rendererRendererBase

renderer che verrà utilizzato per disegnare le figure (es fig.canvas.get_renderer())

Resi :

Bbox

Il riquadro di delimitazione che lo racchiude (nelle coordinate in pixel della figura).

get_window_extent ( renderer = None )

Restituisce la Bboxdelimitazione del testo, in unità di visualizzazione.

Oltre ad essere utilizzato internamente, questo è utile per specificare le aree cliccabili in un file png su una pagina web.

Parametri :

renderer Renderer, facoltativo

È necessario un renderer per calcolare il riquadro di delimitazione. Se l'artista è già stato disegnato, il renderer viene memorizzato nella cache; quindi, è necessario passare questo argomento solo quando si chiama get_window_extent prima della prima estrazione. In pratica, di solito è più semplice attivare prima un pareggio, ad esempio chiamando draw_without_renderingo plt.show().

dpi float, facoltativo

Il valore dpi per il calcolo della bbox, per impostazione predefinita è self.figure.dpi( non il renderer dpi); dovrebbe essere impostato, ad esempio, per abbinare le regioni con una figura salvata con un valore dpi personalizzato.

set ( * , agg_filter=<UNSET> , alpha=<UNSET> , animation=<UNSET> , anncoords=<UNSET> , annotation_clip=<UNSET> , backgroundcolor=<UNSET> , bbox=<UNSET> , clip_box=<UNSET > , clip_on=<UNSET> , clip_path=<UNSET> , color=<UNSET> , fontfamily=<UNSET> , fontproperties=<UNSET> , fontsize=<UNSET> , fontstretch=<UNSET> , fontstyle=<UNSET> , fontvariant=<UNSET> , fontweight=<UNSET>, gid=<UNSET> , horizontalalignment=<UNSET> , in_layout=<UNSET> , label=<UNSET> , linespacing=<UNSET> , math_fontfamily=<UNSET> , mouseover=<UNSET> , multialignment=<UNSET> , parse_math =<UNSET> , path_effects=<UNSET> , picker=<UNSET> , position=<UNSET> , rasterized=<UNSET> , rotation=<UNSET> , rotation_mode=<UNSET> , sketch_params=<UNSET> , snap=< DISINSERITO> ,text=<DISINSERITO> ,transform=<UNSET> , transform_rotates_text=<UNSET> , url=<UNSET> , usetex=<UNSET> , verticalalignment=<UNSET> , visible=<UNSET> , wrap=<UNSET> , x=<UNSET> , y= <UNSET> , zorder=<UNSET> )

Imposta più proprietà contemporaneamente.

Le proprietà supportate sono

Proprietà	Descrizione
agg_filter	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
alpha	scalare o Nessuno
animated	bool
anncoords	sconosciuto
annotation_clip	bool o Nessuno
backgroundcolor	colore
bbox	dict con proprietà perpatches.FancyBboxPatch
clip_box	Bbox
clip_on	bool
clip_path	Patch o (Percorso, Trasforma) o Nessuno
coloro c	colore
figure	sconosciuto
fontfamilyo famiglia	{FONTNAME, 'serif', 'sans-serif', 'cursive', 'fantasy', 'monospace'}
fontpropertieso font o font_properties	font_manager.FontPropertieso stropathlib.Path
fontsizeo dimensione	float o {'xx-small', 'x-small', 'small', 'medium', 'large', 'x-large', 'xx-large'}
fontstretcho allungare	{un valore numerico nell'intervallo 0-1000, 'ultra-condensato', 'extra-condensato', 'condensato', 'semi-condensato', 'normale', 'semi-espanso', 'espanso', 'extra-espanso ', 'ultra-espanso'}
fontstyleo stile	{'normale', 'corsivo', 'obliquo'}
fontvarianto variante	{'normale', 'maiuscoletto'}
fontweighto peso	{un valore numerico nell'intervallo 0-1000, 'ultralight', 'light', 'normal', 'normal', 'book', 'medium', 'roman', 'semibold', 'demibold', 'demi', 'grassetto', 'pesante', 'extra grassetto', 'nero'}
gid	str
horizontalalignmento ah	{'sinistra', 'centro', 'destra'}
in_layout	bool
label	oggetto
linespacing	float (multiplo della dimensione del carattere)
math_fontfamily	str
mouseover	bool
multialignmento mamma	{'sinistra', 'destra', 'centro'}
parse_math	bool
path_effects	AbstractPathEffect
picker	Nessuno o bool o float o richiamabile
position	(galleggiare, galleggiare)
rasterized	bool
rotation	float o {'verticale', 'orizzontale'}
rotation_mode	{Nessuno, 'predefinito', 'ancora'}
sketch_params	(scala: float, lunghezza: float, casualità: float)
snap	bool o Nessuno
text	oggetto
transform	Transform
transform_rotates_text	bool
url	str
usetex	bool o Nessuno
verticalalignmento Va	{'bottom', 'baseline', 'center', 'center_baseline', 'top'}
visible	bool
wrap	bool
x	galleggiante
y	galleggiante
zorder	galleggiante

set_annords ( coords )

Imposta il sistema di coordinate da utilizzare per Annotation.xyann.

Vedi anche xycoords in Annotation.

set_figure ( fig )

Imposta l' Figureistanza a cui appartiene l'artista.

Parametri :

FiguraFigure

update_positions ( renderer )

Aggiorna le posizioni dei pixel del testo dell'annotazione e della patch della freccia.

proprietà xyan

La posizione del testo.

Vedi anche xytext in Annotation.

proprietà xycoord

classe matplotlib.text. OffsetFrom ( artista , ref_coord , unità = 'punti' )

Basi:object

Classe helper richiamabile per lavorare con Annotation.

Parametri :

artista Artisto BboxBaseoTransform

Oggetto da cui calcolare l'offset.

ref_coord (float, float)

Se artist è un Artisto BboxBase, questo valore è la posizione a dell'origine dell'offset in frazioni del riquadro di delimitazione dell'artista .

Se artist è una trasformazione, l'origine dell'offset è la trasformazione applicata a questo valore.

unità {'punti, 'pixel'}, predefinito: 'punti'

Le unità dello schermo da utilizzare (pixel o punti) per l'input offset.

get_unit ( )

Restituisce l'unità per l'input alla trasformazione usata da __call__.

set_unit ( unità )

Imposta l'unità per l'input sulla trasformazione usata da __call__.

Parametri :

unità {'punti', 'pixel'}