Contenuto principale

ylim

R2026b

Impostare o eseguire query sui limiti dell'asse y

Descrizione

Definizione dei limiti

ylim(limits) imposta i limiti dell'asse y per gli assi o il grafico attuale. Specificare limits come vettore a due elementi in forma [ymin ymax], dove ymax è maggiore di ymin.

esempio

ylim(limitmethod) specifica il metodo del limite utilizzato da MATLAB® per la selezione automatica del limite. Specificare il metodo del limite come "tickaligned", "tight" o "padded". MATLAB imposta la proprietà YLimitMethod degli assi sul valore specificato. Il metodo del limite non è supportato per le visualizzazioni standalone.

È possibile specificare l'argomento limitmethod senza parentesi. Ad esempio, ylim tight abilita i limiti stretti dell'asse y.

esempio

ylim(limitmode) specifica la selezione automatica o manuale del limite. limitmode può assumere uno dei due valori seguenti:

  • "auto": abilita la selezione automatica del limite. MATLAB seleziona i limiti in base all'intervallo dei dati e al valore della proprietà YLimitMethod degli assi. Se si traccia più volte sugli assi, i limiti vengono aggiornati per includere tutti i dati.

  • "manual": congela i limiti dell'asse y al loro valore attuale.

È possibile specificare l'argomento limitmode senza parentesi. Ad esempio, ylim auto abilita la selezione automatica del limite.

esempio

Interrogazione dei limiti

yl = ylim restituisce i limiti attuali come vettore a due elementi.

esempio

limmethod = ylim("method") restituisce il metodo dei limiti attuali dell'asse y, che può essere 'tickaligned', 'tight' o 'padded'.

limmode = ylim("mode") restituisce la modalità attuale dei limiti dell'asse y, che è 'auto' o 'manual'. Per impostazione predefinita, la modalità è automatica, a meno che non si specifichino dei limiti o la si imposti su manuale.

Definizione degli assi di destinazione o del grafico

___ = ylim(target,___) utilizza gli assi o la visualizzazione standalone specificata da target anziché gli assi correnti. Specificare target come primo argomento di input per una qualsiasi delle sintassi precedenti. È possibile includere un argomento di output se la sintassi originale supporta un argomento di output. Utilizzare le virgolette intorno agli input della modalità, ad esempio, ylim(target,"auto").

esempio

Esempi

comprimi tutto

Tracciare una linea e impostare i limiti dell'asse y in modo che vadano da -2 a 2.

x = linspace(0,10);
y = sin(x);
plot(x,y)
ylim([-2 2])

Figure contains an axes object. The axes object contains an object of type line.

Creare un grafico di superficie e mostrare solo i valori y maggiori di 0. Specificare il limite minimo dell'asse y come 0 e lasciare che MATLAB scelga il limite massimo.

[X,Y,Z] = peaks;
surf(X,Y,Z)
ylim([0 inf])

Figure contains an axes object. The axes object contains an object of type surface.

Creare un grafico a barre orizzontali con le date sull'asse y. Impostare i limiti dell'asse y in modo che vadano dal 1° giugno 2014 al 10 giugno 2014.

t = datetime(2014,06,1) + caldays(0:20);
y = rand(21,1);
barh(t,y)

tstart = datetime(2014,06,1);
tend = datetime(2014,06,10);
ylim([tstart tend])

Figure contains an axes object. The axes object contains an object of type bar.

Creare un grafico a linee.

x = 1:5; 
y = [-2.7 2 -1 4.2 0];
plot(x,y)

Figure contains an axes object. The axes object contains an object of type line.

Modificare il metodo del limite in 'tight'.

ylim tight

Figure contains an axes object. The axes object contains an object of type line.

A partire dalla release R2019b, è possibile visualizzare la disposizione a piastrelle dei grafici utilizzando le funzioni tiledlayout e nexttile. 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. Tracciare i dati su ciascun asse. Quindi impostare i limiti dell'asse y per il grafico inferiore specificando ax2 come primo argomento di input di ylim.

tiledlayout(2,1)
x = linspace(0,10,1000);
y = sin(10*x).*exp(.5*x);
ax1 = nexttile;
plot(ax1,x,y)

ax2 = nexttile;
plot(ax2,x,y)
ylim(ax2,[-10 10])

Figure contains 2 axes objects. Axes object 1 contains an object of type line. Axes object 2 contains an object of type line.

Utilizzare la modalità manuale per preservare i limiti attuali dell'asse y quando si aggiungono ulteriori grafici agli assi.

Innanzitutto, tracciare una linea.

x = linspace(0,10);
y = sin(x);
plot(x,y)

Figure contains an axes object. The axes object contains an object of type line.

Impostare la modalità dei limiti dell'asse y su manuale in modo che i limiti non cambino. Utilizzare hold on per aggiungere un secondo grafico agli assi.

ylim manual
hold on
y2 = 2*sin(x);
plot(x,y2)
hold off

Figure contains an axes object. The axes object contains 2 objects of type line.

I limiti dell'asse y non si aggiornano per incorporare il nuovo grafico.

Passare nuovamente ai limiti aggiornati automaticamente reimpostando la modalità su automatico.

ylim auto

Figure contains an axes object. The axes object contains 2 objects of type line.

Creare un grafico a dispersione di dati casuali. Restituire i valori dei limiti dell'asse y.

x = randn(50,1);
y = randn(50,1);
scatter(x,y)

Figure contains an axes object. The axes object contains an object of type scatter.

yl =  ylim
yl = 1×2

    -2     3

Argomenti di input

comprimi tutto

Limiti minimi e massimi, specificati come vettore a due elementi di forma [ymin ymax], dove ymax è maggiore di ymin. È possibile specificare i limiti come valori numerici, categorici, di data e ora o di durata. Tuttavia, il tipo di valore specificato deve corrispondere al tipo di valore lungo l'asse y.

È possibile specificare entrambi i limiti oppure specificarne uno solo e lasciare che MATLAB calcoli l'altro automaticamente. Per calcolare automaticamente un limite minimo o massimo, utilizzare rispettivamente -inf o inf. MATLAB utilizza il metodo del limite 'tight' per calcolare il limite corrispondente.

Esempio ylim([0 1])

Esempio ylim([-inf 1])

Esempio ylim([0 inf])

Tipi di dati: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | categorical | datetime | duration

Metodo di selezione del limite, specificato come valore dalla tabella.

Gli esempi nella tabella mostrano l'aspetto indicativo di ciascun metodo. I risultati potrebbero variare a seconda dei dati, delle dimensioni degli assi e del tipo di grafico creato.

ValoreDescrizioneEsempio
"tickaligned"

Allineare, in linea generale, i bordi della casella degli assi con i segni di spunta maggiormente vicini ai dati, senza escludere alcun dato. L'aspetto può variare a seconda del tipo di dati tracciati e del tipo di grafico creato.

Line plot with "tickaligned" limit method.

"tight"

Adattare la casella degli assi strettamente ai dati impostando i limiti dell'asse sull'intervallo dei dati.

Line plot with "tight" limit method.

"padded"

Adattare la casella degli assi ai dati con un sottile margine di riempimento su ciascun lato. La larghezza del margine è pari a circa il 7% dell'intervallo di dati.

Line plot with "padded" limit method.

Nota

  • Il metodo del limite non ha alcun effetto quando la proprietà YLimMode degli assi è impostata su "manual".

  • La specifica del metodo del limite non è supportata per visualizzazioni standalone, come heatmap.

Modalità del limite, specificata come uno dei seguenti valori:

  • "auto": abilita la selezione automatica del limite, basata sull'intervallo totale dei dati e sul valore della proprietà YLimitMethod degli assi. Se si traccia più volte sugli assi, i limiti vengono aggiornati per includere tutti i dati. È possibile utilizzare questa opzione se si modificano i limiti e si desidera ripristinarli ai valori predefiniti.

  • "manual": congela i limiti ai valori attuali. Utilizzare questa opzione se si desidera mantenere i limiti attuali quando si aggiungono nuovi dati agli assi utilizzando il comando hold on.

Quando si specifica questo argomento, MATLAB imposta la proprietà YLimMode degli assi sul valore specificato. Tuttavia, la proprietà YLimMode cambia in "manual" ogni volta che i limiti dell'asse y vengono impostati esplicitamente, chiamando ylim(limits) o impostando il valore della proprietà YLim sugli assi.

Asse o grafico di destinazione, specificato come in uno dei seguenti modi:

  • Un oggetto Axes.

  • Una visualizzazione standalone con proprietà YLimits, come un grafico heatmap.

  • Un array di assi o di visualizzazioni standalone che appartengono alla stessa classe. Per determinare la classe, utilizzare la funzione class.

Se non si specifica questo argomento, ylim imposta i limiti sull'oggetto grafico restituito dal comando gca.

Argomenti di output

comprimi tutto

Limiti attuali, restituiti come vettore a due elementi di forma [ymin ymax].

L'interrogazione dei limiti restituisce il valore della proprietà YLim o YLimits per l'oggetto Axes o grafico corrispondente.

Metodo attuale dei limiti, restituito come uno dei seguenti valori:

  • 'tickaligned': in generale, allinea i bordi della casella degli assi con le tacche più vicine ai dati, senza escluderne alcuno. L'aspetto può variare a seconda del tipo di dati tracciati e del tipo di grafico creato.

  • 'tight': adatta la casella degli assi strettamente ai dati impostando i limiti dell'asse sull'intervallo dei dati.

  • 'padded': adatta la casella degli assi intorno ai dati con un sottile margine di riempimento su ciascun lato. La larghezza del margine è pari a circa il 7% dell'intervallo di dati.

Eseguire una query sul metodo dei limiti dell'asse y restituisce il valore della proprietà YLimitMethod per l'oggetto Axes corrispondente.

Modalità attuale dei limiti, restituita come uno dei seguenti valori:

  • 'auto': determina i limiti automaticamente.

  • 'manual': utilizza limiti specificati manualmente che non vengono aggiornati per riflettere le modifiche nei dati.

Eseguire una query sulla modalità dei limiti dell'asse y restituisce il valore della proprietà YLimMode per l'oggetto Axes corrispondente.

Algoritmi

La funzione ylim imposta ed esegue query su diverse proprietà degli assi relative ai limiti dell'asse y.

  • YLim: proprietà che memorizza i limiti dell'asse y.

  • YLimMode: proprietà che memorizza la modalità dei limiti dell'asse y. Quando si impostano i limiti dell'asse y, questa proprietà cambia in "manual".

  • YLimitMethod: proprietà che controlla come vengono calcolati i limiti dell'asse y quando la proprietà YLimMode è impostata su "auto".

Cronologia versioni

Introduzione prima di R2006a

espandi tutto