Navigation

Operators and Keywords

Function List:

C++ API

: hold
: hold on
: hold off
: hold (hax, …)

Toggle or set the "hold" state of the plotting engine which determines whether new graphic objects are added to the plot or replace the existing objects.

hold on

Retain plot data and settings so that subsequent plot commands are displayed on a single graph. Line color and line style are advanced for each new plot added.

hold all (deprecated)

Equivalent to hold on.

hold off

Restore default graphics settings which clear the graph and reset axis properties before each new plot command. (default).

hold

Toggle the current hold state.

When given the additional argument hax, the hold state is modified for this axis rather than the current axes returned by gca.

To query the current hold state use the ishold function.

See also: ishold, cla, clf, newplot.

Demonstration 1

The following code

 clf;
 t = linspace (0, 2*pi, 100);
 plot (t, sin (t));
 hold on;
 plot (t, cos (t));
 title ({"hold on", "2 plots shown on same graph"});
 hold off;

Produces the following figure

Figure 1

Demonstration 2

The following code

 clf;
 A = rand (100);
 [X, Y] = find (A > 0.95);
 imshow (A);
 hold on;
 plot (X, Y, "o");
 hold off;
 title ("hold with image and plot");

Produces the following figure

Figure 1

Demonstration 3

The following code

 clf;
 colormap ("default");
 hold on;
 imagesc (1 ./ hilb (4));
 plot (1:4, "-s");
 title ("hold with image and plot");
 hold off;

Produces the following figure

Figure 1

Demonstration 4

The following code

 clf;
 colormap ("default");
 hold on;
 imagesc (1 ./ hilb (2));
 imagesc (1 ./ hilb (4));
 title ({"hold with two images", "only second image is visible"});
 hold off;

Produces the following figure

Figure 1

Demonstration 5

The following code

 clf;
 colormap ("default");
 hold on;
 plot (1:4, "-s");
 imagesc (1 ./ hilb (4));
 title ({"hold with plot and image", "only image is visible"});
 hold off;

Produces the following figure

Figure 1

Demonstration 6

The following code

 clf;
 colormap ("default");
 t = linspace (-3, 3, 50);
 [x, y] = meshgrid (t, t);
 z = peaks (x, y);
 contourf (x, y, z, 10);
 hold on;
 plot (x(:), y(:), "^");
 patch ([-1.0 1.0 1.0 -1.0 -1.0], [-1.0 -1.0 1.0 1.0 -1.0], "red");
 xlim ([-2.0 2.0]);
 ylim ([-2.0 2.0]);
 colorbar ("SouthOutside");
 title ("hold with line, surface, and patch objects");

Produces the following figure

Figure 1

Package: octave