# Documentation

### This is machine translation

Translated by
Mouseover text to see original. Click the button below to return to the English verison of the page.

To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

## Control Ratio of Axis Lengths and Data Unit Lengths

You can control the relative lengths of the x-axis, y-axis, and z-axis (plot box aspect ratio). You also can control the relative lengths of one data unit along each axis (data aspect ratio).

### Plot Box Aspect Ratio

The plot box aspect ratio is the relative lengths of the x-axis, y-axis, and z-axis. By default, the plot box aspect ratio is based on the size of the figure. You can change the aspect ratio using the `pbaspect` function. Set the ratio as a three-element vector of positive values that represent the relative axis lengths.

For example, plot an elongated circle. Then set the plot box aspect ratio so that the x-axis is twice the length of the y-axis and z-axis (not shown).

```t = linspace(0,2*pi); plot(sin(t),2*cos(t)) grid on pbaspect([2 1 1])```

Show the axes in a 3-D view to see the z-axis.

`view(3)`

For square axes, use `[1 1 1]`. This value is similar to using the `axis square` command.

```t = linspace(0,2*pi); plot(sin(t),2*cos(t)) grid on pbaspect([1 1 1])```

### Data Aspect Ratio

The data aspect ratio is the relative length of the data units along the x-axis, y-axis, and z-axis. You can change the aspect ratio using the `daspect` function. Set the ratio as a three-element vector of positive values that represent the relative lengths of data units along each axis.

For example, set the ratio so that the length from 0 to 1 along the x-axis is equal to the length from 0 to 0.5 along the y-axis and 0 to 2 along the z-axis (not shown).

```t = linspace(0,2*pi); plot(sin(t),2*cos(t)) grid on daspect([1 0.5 2])```

Show the axes in a 3-D view to see the z-axis.

`view(3)`

For equal data units in all directions, use `[1 1 1]`. This value is similar to using the `axis equal` command. One data unit in the x direction is the same length as one data unit in the y and z directions.

```t = linspace(0,2*pi); plot(sin(t),2*cos(t)) grid on daspect([1 1 1])```

### Revert Back to Default Ratios

Change the data aspect ratio. Then revert back to the default plot box and data aspect ratios using the `axis normal` command.

```t = linspace(0,2*pi); plot(sin(t),2*cos(t)) grid on daspect([1 1 1]) axis normal```