Main Content

hold

Conservar la gráfica actual al añadir nuevas gráficas

Descripción

ejemplo

hold on conserva las gráficas de los ejes actuales para que las nuevas gráficas añadidas a los ejes no eliminen las gráficas existentes. Las nuevas gráficas utilizan los siguientes colores y estilos de líneas basados en las propiedades ColorOrder y LineStyleOrder de los ejes. MATLAB® ajusta los límites de los ejes, las marcas de graduación y las etiquetas de marcas para mostrar el rango de datos completo. Si los ejes no existen, el comando hold los crea.

ejemplo

hold off establece el estado de permanencia en desactivado para que las nuevas gráficas añadidas a los ejes borren las gráficas existentes y restablezcan todas las propiedades de los ejes. La siguiente gráfica añadida a los ejes utiliza el primer color y estilo de línea basados en las propiedades ColorOrder y LineStyleOrder de los ejes. Esta opción es el comportamiento predeterminado.

hold all es lo mismo que hold on. Esta sintaxis se eliminará en una versión futura. En su lugar, utilice hold on.

hold activa y desactiva el estado de permanencia.

ejemplo

hold(ax,___) establece el estado de permanencia para los ejes especificados por ax en lugar de para los ejes actuales. Especifique ax antes de cualquier otro argumento en cualquiera de las sintaxis anteriores. Use comillas simples alrededor de entradas 'on' y 'off', como hold(ax,'on').

Ejemplos

contraer todo

Cree una gráfica de líneas. Utilice hold on para añadir una segunda gráfica de líneas sin eliminar la gráfica de líneas existente. La nueva gráfica utiliza el siguiente color y estilo de línea basados en las propiedades ColorOrder y LineStyleOrder de los ejes. Después restablezca el estado de permanencia en desactivado.

x = linspace(-pi,pi);
y1 = sin(x);
plot(x,y1)

hold on
y2 = cos(x);
plot(x,y2)
hold off

Figure contains an axes object. The axes object contains 2 objects of type line.

Cuando el estado de permanencia está desactivado, las nuevas gráficas eliminan las gráficas existentes. Las nuevas gráficas comienzan desde el principio del orden de colores y del orden de estilos de línea.

y3 = sin(2*x);
plot(x,y3)

Figure contains an axes object. The axes object contains an object of type line.

A partir de la versión R2019b, puede mostrar un mosaico de gráficas utilizando las funciones tiledlayout y nexttile. Llame a la función tiledlayout para crear un diseño de gráfica en mosaico de 2 por 1. Llame a la función nexttile para crear los objetos de ejes ax1 y ax2. Represente una gráfica de onda sinusoidal en cada eje.

x = linspace(0,10);
y1 = sin(x);
y2 = cos(x);
tiledlayout(2,1)

% Top plot
ax1 = nexttile;
plot(ax1,x,y1)

% Bottom plot
ax2 = nexttile;
plot(ax2,x,y2)

Figure contains 2 axes objects. Axes object 1 contains an object of type line. Axes object 2 contains an object of type line.

Añada una segunda onda sinusoidal a los ejes superiores.

hold(ax1,'on')
y3 = sin(2*x);
plot(ax1,x,y3)
hold(ax1,'off')

Figure contains 2 axes objects. Axes object 1 contains 2 objects of type line. Axes object 2 contains an object of type line.

Cree un diseño de gráfica en mosaico de 1 por 2. Llame a la función nexttile para crear dos objetos de ejes y represente en los ejes.

t = tiledlayout(1,2);
ax1 = nexttile;
ax2 = nexttile;
plot(ax1,[0 1 0 1])
scatter(ax2,rand(1,10),rand(1,10),'filled')

Figure contains 2 axes objects. Axes object 1 contains an object of type line. Axes object 2 contains an object of type scatter.

Establezca el estado hold en 'on' para los dos ejes. Luego muestre datos adicionales en cada gráfica.

hold([ax1 ax2],'on')
plot(ax1,[.5 .2 .5 .2])
scatter(ax2,rand(1,10),rand(1,10),'filled')

Figure contains 2 axes objects. Axes object 1 contains 2 objects of type line. Axes object 2 contains 2 objects of type scatter.

Argumentos de entrada

contraer todo

Ejes objetivo, especificados como una de las siguientes opciones:

  • Cualquier tipo de objeto de ejes: un objeto Axes, PolarAxes o GeographicAxes.

  • Un arreglo de objetos de ejes que pertenecen a la misma clase. Para determinar la clase, use la función class.

Si no especifica los ejes, hold establece el estado de permanencia para los ejes actuales.

Sugerencias

  • Utilice la función ishold para probar el estado de permanencia.

Algoritmos

La función hold establece estas propiedades:

  • Propiedad NextPlot de los ejes: establece esta propiedad del objeto asociado Axes, PolarAxes o GeographicAxes en 'add' o 'replace'.

  • Propiedad NextPlot de figura: establece esta propiedad del objeto Figure en 'add'.

Historial de versiones

Introducido antes de R2006a