addaxis

Syntax

[ax, h] = addaxis(y)

[ax, h] = addaxis(x, y)

[ax, h] = addaxis(x, y, x, y, ...)

[ax, h] = addaxis(x, y, fmt)

[ax, h] = addaxis(..., property, value, ...)

[ax, h] = addaxis(hAxes, ...)

Inputs

x, y

Range of the x and y axes.

Type: double | integer

Dimension: scalar | vector | matrix

fmt

Formatting string for the curve. It can be any combination of the following strings:

1. line style: '-', '-.', ':', '--', '-:'.
2. line color: 'r', 'g', 'b', 'c', 'y', 'm', 'w', 'k'.
3. marker style: 's', 'o', 'd', 'x', 'v', '^', '+', '*', '.'.

Type: string

Dimension: scalar

property

Properties that control the appearance or behavior of the graphics object.

Type: string

Dimension: scalar

value

Value of the properties.

Type: double | integer | string

Dimension: scalar | vector

hAxes

Axis handle.

Type: double

Dimension: scalar

Outputs

ax

A vector that contains the handle of the Axes object and the handle of the new Y-Axis object.

Type: double

Dimension: vector

h

Handle(s) of the line graphics object.

Examples

Simple addaxis example:

clf;
[ax, h] = addaxis(0:0.1:5, cos(0:0.1:5));
      

Figure 1. Add axis in new plot.

addaxis in an existing plot:

clf;
x = 0:0.1:5;
plot(x, cos(x));
[ax, h] = addaxis(x, sin(x));
      

Figure 2. Add a vertical axis in an existing plot.

Multiple vertical axes can be added on the right side of the plot:

clf;
x = 0:0.1:5;
plot(x, cos(x));
[ax1, h1] = addaxis(x, sin(x));
[ax2, h2] = addaxis(x, sin(x+2), ':s');
legend;
      

Figure 3. Multiple vertical axes.

Change the appearance of vertical axis:

clf;
x = 0:0.1:5;
plot(x, cos(x));
[ax1, h1] = addaxis(x, sin(x));
[ax2, h2] = addaxis(x, sin(x+2), ':s');
set(ax2(2), {'fontsize', 'ynumericformat', 'ynumericprecision'}, {10, 'fixed', 2});
ylabel('Y axis');
ylabel(ax1(2), 'Y1 axis');
ylabel(ax2(2), 'Y2 axis');
legend;
      

Figure 4. Change the appearance of vertical axis.

The vertical axis that a line is assigned to can be changed:

clf;
x = 0:0.1:5;
h = plot(x, [cos(x); 2*cos(x)]);
[ax, h1] = addaxis(x, sin(x));
set(h(2),'yaxis', ax(2));
ylim([-1.5 1.5]);  
ylim(ax(2), [-2 2]);  
legend;
      

Figure 5. Change the y-axis of a curve.

Comments

addaxis is available only in 2D X-Y plots.

New vertical axes are positioned on the right side of the plot.

The new vertical axes objects are children of the Axes object. The 'secondaryyaxis' property of the Axes object refers to the first vertical axis on the right side of the plot.

The vertical axis color is the same as the color of the first curve plotted on it.

It is possible to delete a vertical axis and the curves plotted on it using the delete command.