yline
R2026bLinea orizzontale con valore y costante
Sintassi
Descrizione
yline( crea una linea orizzontale in una o più coordinate y sugli assi attuali. Ad esempio, y)yline(2) crea una linea in y=2.
yline(___, specifica le proprietà costanti della linea utilizzando uno o più argomenti nome-valore. Per un elenco delle proprietà, vedere ConstantLine Properties. Specificare gli argomenti nome-valore dopo tutti gli altri argomenti di input.Name=Value)
yl = yline(___) restituisce un oggetto ConstantLine o un array di oggetti ConstantLine. Utilizzare yl per modificare o eseguire query sulle proprietà della linea dopo che è stata creata.
Esempi
Creare una linea orizzontale a y = 2,5.
yline(2.5);
Per creare una linea con un'etichetta, è necessario specificare anche lo stile della linea. Lo stile predefinito della linea è una linea continua, "-".
fplot(@(x) log(x)); xlim([0 15]); ylim([0 4]); yline(3,"-",'Threshold');
Definire un insieme di vettori x e y e tracciarli. Quindi riempire l'asse y con ulteriore spazio, sia sopra che sotto i valori massimi e minimi tracciati.
x = 0:0.1:60;
y = 4.*cos(x)./(x+2);
plot(x,y)
ylim padded
Trovare i valori massimo e minimo di y. Creare delle linee orizzontali in corrispondenza di quelle posizioni contrassegnate dalle etichette 'Max' e 'Min'.
ymax = max(y); ymin = min(y); yline([ymax ymin],"--",{'Max','Min'})
Creare una linea blu tratteggiata a y = 4.
yline(4,"-.b");
Creare una linea orizzontale tratteggiata con un'etichetta e uno spessore di linea specificato.
x = -2:0.25:2; [X,Y] = meshgrid(x); Z = X.*exp(-X.^2-Y.^2); contour(X,Y,Z,30) yl = yline(0,"--",'y = 0',LineWidth=3);
Modificare l'allineamento orizzontale dell'etichetta e il colore della linea.
yl.LabelHorizontalAlignment = 'center';
yl.Color = [.80 0 .40];
Chiamare la funzione tiledlayout per creare il layout a piastrelle di un grafico 1x2. Chiamare la funzione nexttile per creare gli oggetti assi ax1 e ax2. Quindi tracciare su ciascuno degli assi. Aggiungere una linea orizzontale al primo grafico passando ax1 alla funzione yline.
tiledlayout(1,2) ax1 = nexttile; x = -pi/2:pi/60:pi/2; y1 = tan(sin(x)) + cos(sin(x)); plot(ax1,x,y1) ax2 = nexttile; x = -pi/2:pi/60:pi/2; y2 = tan(cos(x)) + exp(x); plot(ax2,x,y2) yline(ax1,1.0);
Argomenti di input
Coordinate y, specificate come scalare o vettore contenente valori numerici, categorici, di data e ora o di durata. Il tipo di dato di y deve corrispondere al tipo di dato dell'asse y.
Esempio yline(10) visualizza una linea in y=10.
Esempio yline([13 20 33]) visualizza le linee in y=13, y=20 e y=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 yline venga tracciato su assi diversi rispetto a quelli attuali.
Etichette della linea, specificate come vettore di caratteri, array di celle di vettori di caratteri, array di stringhe o array numerico. Per creare un'etichetta per più righe, utilizzare un array di stringhe o un array di celle di vettori di caratteri.
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. |
yline(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. | yline(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. |
yline([13 20 33],"-",'Sample')
|
| Etichette diverse per ciascuna 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'};
yline([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'};
yline([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.
Esempio yline(3,":",'Median Price',LabelHorizontalAlignment='center') specifica l'allineamento orizzontale dell'etichetta come 'center'.
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 R2024a: Ottenere i codici di colore esadecimali utilizzando H = compose("#%02X%02X%02X",round(RGB*255)).
Prima di R2023b: Ottenere le triplette RGB utilizzando RGB = get(groot,"FactoryAxesColorOrder").
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 |
|
Allineamento verticale dell'etichetta rispetto alla linea, specificato come una delle opzioni riportate nella tabella.
| Opzione | Descrizione | Esempio |
|---|---|---|
'top' | Parte superiore della linea. |
|
'middle' | Parte centrale della linea. L'etichetta segmenta la linea. |
|
'bottom' | Parte inferiore della 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 specificata. |
|
'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
