axis

Impostare i limiti degli assi e rapporti di aspetto

Sintassi

axis(limits)

axis style

axis mode

axis ydirection

axis visibility

lim = axis

lim = axis(ax)

Descrizione

Impostazione dei limiti e del rapporto di aspetto

axis(limits) specifica i limiti degli assi correnti. Specificare i limiti come vettore a quattro, sei o otto elementi.

axis style utilizza uno stile predefinito per impostare i limiti e la scalatura. Ad esempio, specificare lo stile come equal per utilizzare unità di dati di pari lunghezza su ciascun asse.

axis mode definisce se MATLAB^® sceglie o meno i limiti in modo automatico. Specificare la modalità come manual, auto o come una delle opzioni semiautomatiche, ad esempio 'auto x'.

axis ydirection, dove ydirection è ij, pone l'origine nell'angolo superiore sinistro degli assi. I valori di y aumentano dall'alto verso il basso. L'impostazione predefinita per ydirection è xy, che pone l'origine nell'angolo inferiore sinistro. I valori di y aumentano dal basso vero l'alto.

axis visibility, dove visibility è off, disattiva la visualizzazione dello sfondo degli assi. I grafici negli assi continuano ad essere visualizzati. L'impostazione predefinita per visibility è on, che visualizza lo sfondo degli assi.

Acquisizione dei limiti

lim = axis restituisce i limiti degli assi x e y per gli assi correnti. Per gli assi tridimensionali, restituisce inoltre i limiti dell'asse z. Per gli assi polari, restituisce i limiti dell'asse theta e dell'asse r.

lim = axis(ax) restituisce i limiti specificati da ax anziché quelli degli assi attuali.

Esempi

Impostazione dei limiti degli assi

Tracciare la funzione seno.

x = linspace(0,2*pi);
y = sin(x);
plot(x,y,'-o')

Modificare i limiti degli assi in modo che l'asse x vada da $$0$$ a $$2\pi$$ e l'asse y vada da -1,5 to 1,5.

axis([0 2*pi -1.5 1.5])

Aggiunta di riempimento intorno al grafico a scalini

Creare un grafico a scalini e utilizzare il comando axis padded per aggiungere un margine di riempimento tra il grafico e il riquadro del grafico.

x = 0:12;
y = sin(x);
stairs(x,y)
axis padded

Utilizzo dei limiti semiautomatici degli assi

Creare un grafico. Impostare i limiti per l'asse x e impostare il limite minimo per l'asse y. Utilizzare un valore calcolato automaticamente per il limite massimo dell'asse y.

x = linspace(-10,10,200);
y = sin(4*x)./exp(.1*x);
plot(x,y)
axis([-10 10 0 inf])

Impostazione dei limiti degli assi per più assi

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 degli assi, per entrambi gli assi, sugli stessi valori.

tiledlayout(2,1)
x1 = linspace(0,10,100);
y1 = sin(x1);
ax1 = nexttile;
plot(ax1,x1,y1)

x2 = linspace(0,5,100);
y2 = sin(x2);
ax2 = nexttile;
plot(ax2,x2,y2)

axis([ax1 ax2],[0 10 -1 1])

Visualizzazione del grafico senza sfondo degli assi

Tracciare una superficie senza visualizzare le linee degli assi e lo sfondo.

surf(peaks)
axis off

Utilizzo di limiti degli assi stretti e valori di ritorno

Tracciare una superficie. Impostare i limiti degli assi in modo che siano uguali all'intervallo di dati, affinché il grafico si estenda fino ai bordi degli assi.

surf(peaks)
axis tight

Restituire i valori dei limiti correnti degli assi.

l = axis

l = 1×6

    1.0000   49.0000    1.0000   49.0000   -6.5466    8.0752

Cambio di direzione del sistema di coordinate

Creare un grafico a scacchiera e cambiare la direzione del sistema di coordinate.

Per prima cosa, creare il grafico utilizzando la mappa dei colori summer. Per impostazione predefinita, i valori di x aumentano da sinistra verso destra, mentre i valori di y aumentano dal basso verso l'alto.

C = eye(10);
pcolor(C)
colormap summer

Invertire il sistema di coordinate in modo che i valori di y aumentino dall'alto verso il basso.

axis ij

Mantenimento dei limiti correnti degli assi quando si aggiungono nuovi grafici

Tracciare un'onda sinusoidale.

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

Aggiungere un'altra onda sinusoidale agli assi utilizzando hold on. Mantenere i limiti attuali degli assi impostando la modalità limiti su manuale.

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

Se si desidera che siano gli assi a scegliere i limiti appropriati, impostare nuovamente la modalità limiti su automatico.

axis auto

Argomenti di input

limits — Limiti degli assi

vettore a quattro elementi | vettore a sei elementi | vettore a otto elementi

Limiti degli assi, specificati come vettore a quattro, sei o otto elementi.

Per gli assi cartesiani, specificare i limiti in uno dei seguenti modi:

• [xmin xmax ymin ymax]: imposta i limiti dell'asse x in un intervallo compreso tra xmin e xmax. Impostare i limiti dell'asse y in un intervallo compreso tra ymin e ymax.

• [xmin xmax ymin ymax zmin zmax]: imposta inoltre i limiti dell'asse z in un intervallo compreso tra zmin e zmax.

• [xmin xmax ymin ymax zmin zmax cmin cmax]: imposta inoltre i limiti di colore. cmin è il valore dei dati che corrisponde al primo colore della mappa dei colori. cmax è il valore dei dati che corrisponde all’ultimo colore della mappa dei colori.

Le proprietà XLim, YLim, ZLim e CLim dell'oggetto Axes memorizzano i valori limite.

Per gli assi polari, specificare i limiti nel seguente modo:

• [thetamin thetamax rmin rmax]: imposta i limiti dell'asse theta in un intervallo compreso tra thetamin e thetamax. Impostare i limiti dell'asse r in un intervallo compreso tra rmin e rmax.

Le proprietà ThetaLim e RLim dell'oggetto PolarAxes memorizzano i valori limite.

Per usufruire di limiti parzialmente automatici, utilizzare inf o -inf per i limiti che si desidera vengano scelti automaticamente dagli assi. Ad esempio, axis([-inf 10 0 inf]) consente agli assi di scegliere il limite minimo dell'asse x e il limite massimo dell'asse y appropriati. Utilizza i valori specificati per il limite massimo dell'asse x e per il limite minimo dell'asse y.

Nota

Se l'asse x, l'asse y o l'asse z visualizza valori categoriali, di data e ora o di durata, utilizzare invece le funzioni xlim, ylim e zlim per impostare i limiti.

Esempio axis([0 1 0 1])

Esempio axis([0 1 0 1 0 1])

Esempio axis([0 inf 0 inf])

mode — Selezione manuale, automatica o semiautomatica dei limiti dell'asse

manual | auto | 'auto x' | 'auto y' | 'auto z' | 'auto xy' | 'auto xz' | 'auto yz'

Selezione manuale, automatica o semiautomatica dei limiti dell’asse, specificata come uno dei valori della tabella sottostante. Tutti i valori delle modalità automatiche utilizzano tickaligned style per calcolare i limiti di un asse particolare, o di un insieme di assi, come specificato.

Valore	Descrizione	Proprietà degli assi che vengono modificate
manual	Congelare tutti i limiti degli assi ai loro valori correnti.	Imposta XLimMode, YLimMode e ZLimMode su 'manual'. Se si lavora con gli assi polari, questa opzione imposta ThetaLimMode e RLimMode su 'manual'.
auto	Selezionare automaticamente tutti i limiti degli assi.	Imposta XLimMode, YLimMode e ZLimMode su 'auto'. Se si lavora con gli assi polari, questa opzione imposta ThetaLimMode e RLimMode su 'auto'.
'auto x'	Selezionare automaticamente i limiti dell'asse x.	Imposta XLimMode su 'auto'.
'auto y'	Selezionare automaticamente i limiti dell'asse y.	Imposta YLimMode su 'auto'.
'auto z'	Selezionare automaticamente i limiti dell'asse z.	Imposta ZLimMode su 'auto'.
'auto xy'	Selezionare automaticamente i limiti dell'asse x e dell'asse y.	Imposta XLimMode e YLimMode su 'auto'.
'auto xz'	Selezionare automaticamente i limiti dell'asse x e dell'asse z.	Imposta XLimMode e ZLimMode su 'auto'.
'auto yz'	Selezionare automaticamente i limiti dell'asse y e dell'asse z.	Imposta YLimMode e ZLimMode su 'auto'.

Nota

Queste opzioni non possono essere utilizzate con gli assi polari.

style — Limiti degli assi e scalatura

tight | padded | fill | equal | image | square | vis3d | normal

Limiti degli assi e scalatura, specificata come uno dei seguenti valori.

Valore	Descrizione	Proprietà degli assi che vengono modificate
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.	XLimMode, YLimMode e ZLimMode vengono impostati su 'auto'. XLimitMethod, YLimitMethod e ZLimitMethod vengono impostati su 'tickaligned'. XLim, YLim e ZLim si aggiornano automaticamente per incorporare i nuovi dati aggiunti agli assi. Per evitare che i limiti cambino quando si utilizza hold on, usare axis tickaligned manual.
tight	Adattare la casella degli assi strettamente ai dati, impostando i limiti dell'asse equivalenti all'intervallo dei dati.	XLimMode, YLimMode e ZLimMode vengono impostati su 'auto'. Se si lavora con gli assi polari, ThetaLimMode e RLimMode vengono modificati. XLimitMethod, YLimitMethod e ZLimitMethod vengono impostati su 'tight'. XLim, YLim e ZLim si aggiornano automaticamente per incorporare i nuovi dati aggiunti agli assi. Per evitare che i limiti cambino quando si utilizza hold on, usare axis tight manual.
padded	Adattare la casella degli assi ai dati con un sottile margine di riempimento su tutti i lati. La larghezza del margine è pari a circa il 7% dell'intervallo di dati.	XLimMode, YLimMode e ZLimMode vengono impostati su 'auto'. XLimitMethod, YLimitMethod e ZLimitMethod vengono impostati su 'padded'. XLim, YLim e ZLim si aggiornano automaticamente per incorporare i nuovi dati aggiunti agli assi. Per evitare che i limiti cambino quando si utilizza hold on, usare axis padded manual.
equal	Utilizzare la stessa lunghezza per le unità di dati lungo ciascun asse. equal non è supportato dai grafici creati con yyaxis.	Imposta DataAspectRatio su [1 1 1], nonché DataAspectRatioMode e PlotBoxAspectRatioMode su 'manual'. Per le viste bidimensionali, imposta inoltre XLimMode e YLimMode in modo appropriato, affinché l'asse riempia lo spazio assegnatogli all'interno della figura padre o di un altro contenitore. Per le viste tridimensionali, XLimMode, YLimMode e ZLimMode vengono impostati su 'auto', mentre XLimitMethod, YLimitMethod e ZLimitMethod vengono impostati su 'tight'. Questo stile disabilita il comportamento predefinito "stretch-to-fill".
image	Utilizzare la stessa lunghezza per le unità di dati lungo ciascun asse e adattare la casella degli assi strettamente ai dati. image non è supportato dai grafici creati con yyaxis.	Imposta DataAspectRatio su [1 1 1], DataAspectRatioMode su 'manual' e PlotBoxAspectRatioMode su 'auto'. Imposta inoltre XLimMode, YLimMode e ZLimMode su 'auto', nonché XLimitMethod, YLimitMethod e ZLimitMethod su 'tight'. Questo stile disabilita il comportamento predefinito "stretch-to-fill".
square	Utilizzare linee dell'asse di lunghezza uguale. Regolare gli incrementi tra le unità di dati di conseguenza.	Imposta PlotBoxAspectRatio su [1 1 1] e la proprietà della modalità associata su manuale. Questo stile disabilita il comportamento predefinito "stretch-to-fill".
fill	Abilitare il comportamento "stretch-to-fill" (predefinito). Le lunghezze di ciascuna linea dell'asse riempiono il rettangolo di posizione definito nella proprietà Position degli assi.	Imposta DataAspectRatioMode e PlotBoxAspectRatioMode su 'auto'.
vis3d	Congelare le proprietà del rapporto di aspetto. vis3d non è supportato dai grafici creati con yyaxis.	Imposta DataAspectRatioMode, PlotBoxAspectRatioMode e CameraViewAngleMode su 'manual'.
normal	Ripristinare il comportamento predefinito.	Imposta DataAspectRatioMode e PlotBoxAspectRatioMode su 'auto'.

Per maggiori informazioni sul rapporto di aspetto del riquadro del grafico e sul rapporto di aspetto dei dati, vedere le proprietà PlotBoxAspectRatio e DataAspectRatio.

Nota

Non è possibile utilizzare queste opzioni con gli assi polari, ad eccezione dei comandi axis tight e axis normal.

ydirection — direzione dell'asse y

xy (predefinito) | ij

Direzione dell'asse y, specificata come uno dei seguenti valori:

• xy: direzione predefinita. Per gli assi in vista bidimensionale, l'asse y è verticale, con valori crescenti dal basso verso l'alto.

• ij: direzione inversa. Per gli assi in vista bidimensionale, l'asse y è verticale, con valori crescenti dall'alto verso il basso.

Nota

Queste opzioni non possono essere utilizzate con gli assi polari.

visibility — Linee degli assi e visibilità dello sfondo

"on" | "off" | true o 1 | false o 0 | valore OnOffSwitchState

Visibilità delle linee degli assi e dello sfondo, specificata come uno qualsiasi di questi valori:

• "on" o "off": un valore "on" visualizza le linee degli assi e lo sfondo, mentre "off" li nasconde. È inoltre possibile specificare i vettori di caratteri 'on' o 'off'.

• 1 (true) o 0 (false) numerico o logico: un valore 1 o true visualizza le linee degli assi e lo sfondo, mentre 0 o false li nasconde. (da R2024a)

• Un valore matlab.lang.OnOffSwitchState: un valore matlab.lang.OnOffSwitchState.on visualizza le linee degli assi e lo sfondo, mentre matlab.lang.OnOffSwitchState.off li nasconde. (da R2024a)

Nota

Utilizzare le parentesi per specificare 1, 0, true, false o un valore OnOffSwitchState. Ad esempio, axis(0) e axis(false) nascondono gli assi.

Le parentesi sono opzionali per i valori "on" e "off". Ad esempio, axis off nasconde gli assi.

Specificando la visibilità, si imposta la proprietà Visible dell'oggetto Axes o dell'oggetto PolarAxes sul valore specificato.

ax — Assi di destinazione

uno o più assi

Assi di destinazione, specificati come uno o più assi. È possibile specificare gli oggetti Axes o gli oggetti PolarAxes. Se non si specificano gli assi, axis imposta i limiti per gli assi correnti (gca).

Quando si specificano gli assi, utilizzare le virgolette singole per racchiudere altri argomenti di input rappresentati da vettori di caratteri.

Esempio axis(ax,'tight')

Esempio axis(ax,limits)

Esempio axis(ax,'manual')

Argomenti di output

lim — Valori limite correnti

vettore a quattro elementi | vettore a sei elementi

Valori limite correnti, restituiti come un vettore a quattro elementi o un vettore a sei elementi.

• Per gli assi cartesiani in vista bidimensionale, la forma di lim è [xmin xmax ymin ymax]. Per gli assi in vista tridimensionale, la forma di lim è [xmin xmax ymin ymax zmin zmax]. Le proprietà XLim, YLim e ZLim dell'oggetto Axes memorizzano i valori limite.

• Per gli assi polari, la forma di lim è [thetamin thetamax rmin rmax]. Le proprietà ThetaLim e RLim dell'oggetto PolarAxes memorizzano i valori limite.

Suggerimenti

• È possibile associare più argomenti di input, ad esempio axis image ij. Le opzioni sono valutate da sinistra verso destra. Le opzioni successive possono sovrascrivere le proprietà impostate da quelle precedenti.

• Se gli assi non sono presenti, la funzione axis li crea.

• Utilizzare hold on per evitare che le funzioni di plottaggio superino i limiti degli assi preimpostati.

Cronologia versioni

Introduzione prima di R2006a

R2024b: Esecuzione di query non supportata in modalità di selezione dei limiti, visibilità e direzione dell'asse y

Questa sintassi, che restituisce la modalità di selezione del limite dell'asse (m), la visibilità (v) e la direzione dell'asse y (d), non è più supportata e restituisce un errore.

[m,v,d] = axis('state')

È possibile ottenere le stesse informazioni eseguendo una query su queste proprietà Axes.

• Modalità di selezione del limite dell'asse: proprietà XLimMode, YLimMode e ZLimMode

• Visibilità: proprietà Visible

• Direzione degli assi x e y: proprietà XDir e YDir

Questa modifica è stata annunciata nella release R2015a.

R2024a: Visualizzazione o occultamento degli assi specificando il valore logico o il valore OnOffSwitchState

Visualizzare o nascondere gli assi specificando l'argomento di input visibility come valore logico o come valore matlab.lang.OnOffSwitchState. I valori 1 e true sono equivalenti a "on", mentre 0 e false sono equivalenti a "off".

I valori "on" e "off" sono ancora supportati.

Vedi anche

Funzioni

• xlim | ylim | zlim | tiledlayout | nexttile | title | grid

Proprietà

• Axes Properties | PolarAxes Properties

Argomenti

• Definizione dei limiti dell'asse
• Controllo del rapporto tra le lunghezze degli assi e le lunghezze delle unità di dati