xlim

Impostare o eseguire query sui limiti dell'asse x

Sintassi

xlim(limits)

xlim(limitmethod)

xlim(limitmode)

xl = xlim

limmethod = xlim("method")

limmode = xlim("mode")

___ = xlim(target,___)

Descrizione

Definizione dei limiti

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

xlim(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à XLimitMethod degli assi sul valore specificato. Il metodo del limite non è supportato per le visualizzazioni standalone.

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

xlim(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à XLimitMethod degli assi. Se si traccia più volte sugli assi, i limiti vengono aggiornati per includere tutti i dati.

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

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

Limiti di esecuzione della query

xl = xlim restituisce i limiti attuali come vettore a due elementi.

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

limmode = xlim("mode") restituisce la modalità attuale dei limiti dell'asse x, 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

___ = xlim(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, xlim(target,"auto").

Esempi

Impostazione dei limite dell'asse x

Tracciare una linea e impostare i limiti dell'asse x in modo che vadano da 0 e 5.

x = linspace(0,10);
y = sin(x);
plot(x,y)
xlim([0 5])

Utilizzo dei limiti semiautomatici dell'asse x

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

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

Impostazione dei limiti dell'asse x con date

Crea un grafico a stelo con le date lungo l'asse x. Impostare i limiti dell'asse x in modo che vadano dal 1° giugno 2014 al 5 giugno 2014.

t = datetime(2014,06,1) + caldays(0:10);
y = rand(11,1);
stem(t,y,'filled')

tstart = datetime(2014,06,1);
tend = datetime(2014,06,5);
xlim([tstart tend])

Definizione dei limiti stretti dell'asse x

Se si desidera che l'asse x si regoli automaticamente in modo da corrispondere all'intervallo delle coordinate x, utilizzare il metodo del limite 'tight'.

Creare un grafico a linee.

plot([1 2 3 4 5 6.3],[0 0.3 0.1 0.6 0.4 1])

Modificare il metodo del limite in 'tight'.

xlim tight

Aggiungere un altro grafico agli assi. I limiti dell'asse x si regolano per comprendere l'intervallo dei nuovi dati.

hold on
plot([1 2 3 4 5 8.3],[0.1 0.2 0.3 0.4 0.5 0.83])
hold off

Impostazione dei limite dell'asse x per assi specifici

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 x per il grafico inferiore specificando ax2 come primo argomento di input di xlim.

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

ax2 = nexttile;
plot(ax2,x,y)
xlim(ax2,[0 1])

Preservazione dei limiti attuali dell'asse x

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

Innanzitutto, tracciare una linea.

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

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

xlim manual
hold on
plot(2*x,2*y)
hold off

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

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

xlim auto

Restituzione dei limiti dell'asse x

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

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

xl = xlim

xl = 1×2

    -3     4

Argomenti di input

limits — Limiti minimi e massimi

vettore a due elementi

Limiti minimi e massimi, specificati come vettore a due elementi di forma [xmin xmax], dove xmax è maggiore di xmin. È 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 x.

È 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 xlim([0 1])

Esempio xlim([-inf 1])

Esempio xlim([0 inf])

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

limitmethod — Metodo di selezione del limite

"tickaligned" (predefinito) | "padded" | "tight"

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.

Valore	Descrizione	Esempio
"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.
"tight"	Adattare la casella degli assi strettamente ai dati impostando i limiti dell'asse sull'intervallo dei dati.
"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.

Nota

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

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

limitmode — Modalità del limite

"auto" | "manual"

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à XLimitMethod 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à XLimMode degli assi sul valore specificato. Tuttavia, la proprietà XLimMode cambia in "manual" ogni volta che i limiti dell'asse x vengono impostati esplicitamente, chiamando xlim(limits) o impostando il valore della proprietà XLim sugli assi.

target — Assi o grafico di destinazione

oggetto assi | visualizzazione standalone | array di assi o visualizzazione standalone

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

• Un oggetto assi.

• Una visualizzazione standalone che presenta una proprietà XLimits, come un grafico heatmap o stackedplot.

• 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, xlim imposta i limiti sull'oggetto grafico restituito dal comando gca.

Argomenti di output

xl — Limiti attuali

vettore a due elementi

Limiti attuali, restituiti come vettore a due elementi di forma [xmin xmax].

Eseguire una query sui limiti restituisce il valore della proprietà XLim o XLimits per l'oggetto Axes o grafico corrispondente.

limmethod — Metodo attuale dei limiti

'tickaligned' | 'tight' | 'padded'

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 x restituisce il valore della proprietà XLimitMethod per l'oggetto Axes corrispondente.

limmode — Modalità attuale dei limiti

'auto' | 'manual'

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 x restituisce il valore della proprietà XLimMode per l'oggetto Axes corrispondente.

Algoritmi

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

• XLim: proprietà che memorizza i limiti dell'asse x.

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

• XLimitMethod: proprietà che controlla come vengono calcolati i limiti dell'asse x quando la proprietà XLimMode è impostata su "auto".

Cronologia versioni

Introduzione prima di R2006a

R2022a: Esecuzione di query sul metodo del limite dell'asse

Eseguire query per il metodo del limite attuale dell'asse utilizzando l'argomento di input "method".

R2021a: Impostazione del metodo di limite dell'asse

Impostare il metodo che MATLAB utilizza per la selezione automatica del limite specificando l'argomento limitmethod. Questo argomento può avere un valore di 'tickaligned', 'tight' o 'padded'.

Vedi anche

Funzioni

• ylim | zlim | grid | xlabel | xticks | xticklabels | xtickformat

Proprietà

• Axes Properties

Argomenti

• Definizione dei limiti dell'asse