Create Cartesian axes
axes creates the default Cartesian axes
in the current figure and makes it the current axes. Typically, you
do not need to create axes before plotting since graphics functions
automatically create axes when plotting if they do not exist.
ax = axes(___)
Axes object created. Use
query and modify properties of the
Axes object after
it is created. For a list of properties, see Axes Properties.
axes( sets the
property of the parent figure to be
cax. If the
HandleVisibilty property of the parent figure is set to
cax also becomes the current axes. This
command also makes
cax the first object listed in the
Children property of the parent object. The parent
object is typically a figure or a tiled chart layout.
Position Multiple Axes in Figure
Axes objects in a figure and add a plot to each one.
Specify the position of the first
Axes object so that it has a lower left corner at the point (0.1 0.1) with a width and height of 0.7. Specify the position of the second
Axes object so that it has a lower left corner at the point (0.65 0.65) with a width and height of 0.28. By default, the values are normalized to the figure. Return the
Axes objects as
figure ax1 = axes('Position',[0.1 0.1 0.7 0.7]); ax2 = axes('Position',[0.65 0.65 0.28 0.28]);
Add a plot to each
Axes object. Specify the axes by passing it as the first input argument to the graphics function. Most graphics functions reset some axes properties, such as the tick values and labels. However, they do not reset the axes position.
Make Axes the Current Axes
Create two overlayed
Axes objects. Then, specify the current axes and add a plot.
First create two
Axes objects and specify the positions. Display the box outline around each axes. Return the
Axes objects as
figure ax1 = axes('Position',[0.1 0.1 .6 .6],'Box','on'); ax2 = axes('Position',[.35 .35 .6 .6],'Box','on');
ax1 the current axes. This action brings the axes to the front of the display and makes it the target for subsequent graphics functions. Add a line plot to the axes.
axes(ax1) x = linspace(0,10); y = sin(x); plot(x,y)
Create Axes in Tabs
Create a figure with two tabs. Add axes to each tab by specifying the parent container for each one. Plot a line in the first tab and a surface in the second tab.
figure tab1 = uitab('Title','Tab1'); ax1 = axes(tab1); plot(ax1,1:10) tab2 = uitab('Title','Tab2'); ax2 = axes(tab2); surf(ax2,peaks)
parent — Parent container
Figure object |
Panel object |
Tab object |
TiledChartLayout object |
Parent container, specified as a
cax — Axes to make current
Axes object |
PolarAxes object |
GeographicAxes object | standalone visualization
Axes to make current, specified as an
Axes object, a
PolarAxes object, a
GeographicAxes object, or a standalone visualization such as
If you want to make an object the current axes without changing the state of the figure, set
CurrentAxes property of the figure containing that
fig = gcf; fig.CurrentAxes = cax;
axes('Position',[.3 .3 .5 .5]) sets
Specify optional comma-separated pairs of
the argument name and
Value is the corresponding
Name must appear inside single quotes (
'). You can specify several name and value pair arguments
Some graphics functions change axes property values when plotting, such as the axis limits or tick values. Set axes properties after plotting.
The properties listed here are only a subset. For a full list, see Axes Properties.
The current axes is the default target object for many graphics commands,
xlim. The following types of objects can become the current
axes. Typically, it is the last one of these objects that is created, clicked on, or
A standalone visualization, which is a chart designed for a special purpose that works independently from other charts. For example, a
heatmapis a standalone visualization for observing the interaction between two variables in tabular data.
gca command returns the current
axes, and the
CurrentAxes property of a figure stores its
current axes. Thus, if you change the current figure, the current axes also
Introduced before R2006a