xline
Linea verticale con valore x costante
Sintassi
Descrizione
xline( crea una linea verticale in una o più coordinate x sugli assi attuali. Ad esempio, x)xline(2) crea una linea in x=2.
xline(___, specifica le proprietà costanti della linea utilizzando uno o più argomenti della coppia nome-valore. Per un elenco delle proprietà, vedere ConstantLine Properties. Specificare le coppie nome-valore dopo tutti gli altri argomenti di input.Name,Value)
xl = xline(___) restituisce un oggetto ConstantLine o un array di oggetti ConstantLine. Utilizzare xl per modificare o eseguire query sulle proprietà della linea dopo che è stata creata.
Esempi
Creare una linea verticale in x = 3.
xline(3);
Per creare una linea con un'etichetta, è necessario specificare anche lo stile della linea. Lo stile predefinito della linea è una linea continua, '-'.
x = linspace(0,6,100); y = exp(x); plot(x,y) xline(4.5,'-',{'Acceptable','Limit'});
Creare un vettore di numeri casuali distribuiti normalmente e visualizzarli in un istogramma. Quindi creare tre linee verticali con etichette in corrispondenza del valore medio, di una deviazione standard al di sotto del valore medio e di una deviazione standard al di sopra del valore medio.
data = 5 * randn(1,500) + 20; histogram(data,'FaceAlpha',0.1,'EdgeAlpha',0.1); m = mean(data); s = std(data); xline([m-s m m+s],'-',{'-1 Standard Dev.','Average','+1 Standard Dev.'})
Creare una linea rossa tratteggiata in x = 5.
xline(5,'--r');
Creare una linea verticale tratteggiata con un'etichetta e un nome visualizzato per una legenda.
y = [3187 2693 1771 1826 1958 3222 1645]; barh(y,'DisplayName','Daily Sales') xl = xline(2328,'-.','Average','DisplayName','Average Sales');
Regolare l'allineamento verticale e orizzontale dell'etichetta, quindi visualizzare la legenda.
xl.LabelVerticalAlignment = 'middle'; xl.LabelHorizontalAlignment = 'center'; legend('show');
Chiamare la funzione tiledlayout per creare il layout a piastrelle di un grafico 2x1. Chiamare la funzione nexttile per creare gli oggetti assi ax1 e ax2. Quindi tracciare su ciascuno degli assi. Aggiungere una linea verticale punteggiata e un'etichetta a ciascun grafico passando gli assi alla funzione xline.
tiledlayout(2,1) ax1 =nexttile; x = linspace(0,10,200); y1 = cos(x); plot(ax1,x,y1) ax2 = nexttile; y2 = sin(x); plot(ax2,x,y2) xline(ax1,pi/2,':','cos(\pi/2)=0'); xline(ax2,pi,':','sin(\pi)=0');
Argomenti di input
Coordinate x, specificate come scalare o vettore contenente valori numerici, categorici, di data e ora o di durata. Il tipo di dato di x deve corrispondere al tipo di dato dell'asse x.
Esempio xline(10) visualizza una linea in x=10.
Esempio xline([13 20 33]) visualizza le linee in x=13, x=20 e x=33.
Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | categorical | datetime | duration
Stile e colore della linea, specificati come vettore di caratteri o scalare di stringa contenente caratteri e simboli. I caratteri e i simboli possono apparire in qualsiasi ordine. È possibile specificare lo stile della linea, il colore della linea o entrambi. I simboli del marcatore come 'o' vengono ignorati.
Esempio '--g' è una linea verde tratteggiata.
| Stile delle linee | Descrizione | Linea risultante |
|---|---|---|
"-" | Linea continua |
|
"--" | Linea tratteggiata |
|
":" | Linea punteggiata |
|
"-." | Linea a tratti e punti |
|
| Nome del colore | Nome abbreviato | Aspetto |
|---|---|---|
'red' | 'r' |
|
'green' | 'g' |
|
'blue' | 'b' |
|
'cyan' | 'c' |
|
'magenta' | 'm' |
|
'yellow' | 'y' |
|
'black' | 'k' |
|
'white' | 'w' |
|
Assi di destinazione, specificati come oggetto Axes. Utilizzare questo argomento se si desidera che xline venga tracciato su assi diversi rispetto a quelli attuali.
Etichette della linea, specificate come vettore di caratteri, scalare di stringa, array di celle di vettori di caratteri o array di stringhe.
Creazione di un'etichetta per una riga
Specificare un vettore di caratteri o uno scalare di stringa per visualizzare una riga di testo. Per visualizzare più righe di testo, specificare un array di celle di vettori di caratteri o un array di stringhe.
| Presentazione | Come specificare labels | Esempio |
|---|---|---|
| Una riga di testo | Specificare un vettore di caratteri o uno scalare di stringa. |
xline(12,'-','Sample')
|
| Testo su più righe | Specificare un array di celle di vettori di caratteri o un array di stringhe. Ogni elemento dell'array è una riga di testo diversa. | xline(12,'-',{'Sample','x=12'})
|
Creazione di etichette per più righe
Specificare un vettore di caratteri o uno scalare di stringa per visualizzare la stessa etichetta accanto a tutte le righe. Specificare un array di celle di vettori di caratteri o un array di stringhe per visualizzare etichette diverse per ciascuna riga.
| Presentazione | Come specificare labels | Esempio |
|---|---|---|
| Un'etichetta di testo condivisa | Specificare un vettore di caratteri o uno scalare di stringa. |
xline([13 20 33],'-','Sample')
|
| Etichette diverse per ciascun riga | Specificare un array di celle di vettori di caratteri o un array di stringhe. Ogni elemento dell'array è un'etichetta per una riga diversa. Il numero di elementi nell'array labels deve corrispondere alla lunghezza di x. | label = {'Sample 1','Sample 2','Sample 3'};
xline([13 20 33],'-',label)
|
| Etichette diverse con alcune etichette con più righe | Creare un array di celle di vettori di caratteri o un array di stringhe. Utilizzare la funzione sprintf per inserire caratteri di nuova riga ('\n') nel testo. | label = {'Sample 1',sprintf('Sample 2\nx=20'),'Sample 3'};
xline([13 20 33],'-',label)
|
Argomenti nome-valore
Specificare coppie opzionali di argomenti come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell’argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono comparire dopo gli altri argomenti, mentre l'ordine delle coppie non è rilevante.
Per le release antecedenti alla R2021a, utilizzare le virgole per separare ciascun nome e valore e includere Name tra virgolette.
Esempio xline(5,'LabelVerticalAlignment','middle') specifica l'allineamento verticale dell'etichetta come 'middle'.
Nota
Le proprietà qui elencate sono solo un sottoinsieme. Per un elenco completo, vedere ConstantLine Properties.
Colore della linea, specificato come tripletta RGB, codice di colore esadecimale, nome del colore o nome abbreviato.
Per un colore personalizzato, specificare una tripletta RGB o un codice di colore esadecimale.
Una tripletta RGB è un vettore riga a tre elementi i cui elementi specificano le intensità dei componenti rosso, verde e blu del colore. Le intensità devono essere comprese nell'intervallo
[0,1], ad esempio,[0.4 0.6 0.7].Un codice di colore esadecimale è uno scalare di stringa o un vettore di caratteri che inizia con un simbolo cancelletto (
#) seguito da tre o sei cifre esadecimali che possono andare da0aF. I valori non differenziano tra maiuscole e minuscole. Pertanto, i codici di colore"#FF8800","#ff8800","#F80"e"#f80"sono equivalenti.
In alternativa, è possibile specificare alcuni colori comuni per nome. Questa tabella elenca le opzioni di colore denominate, le terzine RGB equivalenti e i codici di colore esadecimali.
| Nome del colore | Nome abbreviato | Tripletta RGB | Codice di colore esadecimale | Aspetto |
|---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" |
|
"green" | "g" | [0 1 0] | "#00FF00" |
|
"blue" | "b" | [0 0 1] | "#0000FF" |
|
"cyan" | "c" | [0 1 1] | "#00FFFF" |
|
"magenta" | "m" | [1 0 1] | "#FF00FF" |
|
"yellow" | "y" | [1 1 0] | "#FFFF00" |
|
"black" | "k" | [0 0 0] | "#000000" |
|
"white" | "w" | [1 1 1] | "#FFFFFF" |
|
"none" | Non applicabile | Non applicabile | Non applicabile | Nessun colore |
Questa tabella elenca le tavolozze dei colori predefinite per i grafici nei temi chiaro e scuro.
| Tavolozza | Colori della tavolozza |
|---|---|
Prima di R2025a: Per impostazione predefinita, la maggior parte dei grafici utilizza questi colori. |
|
|
|
È possibile ottenere le triplette RGB e i codici di colore esadecimali per queste tavolozze utilizzando le funzioni orderedcolors e rgb2hex. Ad esempio, ottenere le triplette RGB per la tavolozza "gem" e convertirle in codici di colore esadecimali.
RGB = orderedcolors("gem");
H = rgb2hex(RGB);Prima di R2023b: Ottenere le triplette RGB utilizzando RGB = get(groot,"FactoryAxesColorOrder").
Prima di R2024a: Ottenere i codici di colore esadecimali utilizzando H = compose("#%02X%02X%02X",round(RGB*255)).
Esempio 'g'
Esempio [0.6 0.2 0.5]
Esempio '#D2F9A7'
Trasparenza della linea, specificata come scalare compreso nell'intervallo [0,1]. Un valore di 1 è opaco, mentre 0 è completamente trasparente. I valori compresi tra 0 e 1 sono semitrasparenti.
Larghezza della linea, specificata come valore positivo in punti.
Allineamento orizzontale dell'etichetta rispetto alla linea, specificato come una delle opzioni riportate nella tabella.
| Opzione | Descrizione | Esempio |
|---|---|---|
'right' | Lato destro della linea. |
|
'left' | Lato sinistro della linea. |
|
'center' | Centro della linea. L'etichetta segmenta la linea. |
|
Allineamento verticale dell'etichetta rispetto alla linea, specificato come una delle opzioni riportate nella tabella.
| Opzione | Descrizione | Esempio |
|---|---|---|
'top' | Sopra la linea |
|
'middle' | Centro della linea |
|
'bottom' | Sotto la linea |
|
Orientamento dell'etichetta, specificato come 'aligned' o 'horizontal'. Gli esempi sono riportati nella tabella.
| Orientamento | Descrizione | Esempio |
|---|---|---|
'aligned' | L'etichetta presenta lo stesso orientamento della linea. |
|
'horizontal' | L'etichetta è orizzontale, indipendentemente dall'orientamento della linea. |
|
Algoritmi
In una vista tridimensionale degli assi, la linea costante appare nel piano x-y nel punto medio dei limiti dell'asse z. Se gli assi vengono ruotati, la linea costante ruota di conseguenza.
Cronologia versioni
Introdotto in R2018b
