MATLAB Function Reference (Volume 2: Graphics)

axesPurpose2axesCreate axes graphics objectSyntaxDescriptionaxesaxes('PropertyName',PropertyValue,...)axes(h)h = axes(...)axes is the low-level function for creating axes graphics objects.axes creates an axes graphics object in the current figure using defaultproperty values.axes('PropertyName',PropertyValue,...) creates an axes object having thespecified property values. MATLAB uses default values for any properties thatyou do not explicitly define as arguments.axes(h) makes existing axes h the current axes. It also makes h the first axeslisted in the figure’s Children property and sets the figure’s CurrentAxesproperty to h. The current axes is the target for functions that draw image, line,patch, surface, and text graphics objects.h = axes(...) returns the handle of the created axes object.RemarksMATLAB automatically creates an axes, if one does not already exist, when youissue a command that draws image, light, line, patch, surface, or text graphicsobjects.The axes function accepts property name/property value pairs, structurearrays, and cell arrays as input arguments (see the set and get commands forexamples of how to specify these data types). These properties, which controlvarious aspects of the axes object, are described in the “Axes Properties”section.Use the set function to modify the properties of an existing axes or the getfunction to query the current values of axes properties. Use the gca commandto obtain the handle of the current axes.The axis (not axes) function provides simplified access to commonly usedproperties that control the scaling and appearance of axes.2-4