Main Content

hold

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

contraer todo en la página

Sintaxis

hold on
hold off
hold
hold(state)
hold(ax,___)

Descripción

ejemplo

hold on establece el estado de permanencia de los ejes en activado, lo que 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. Cuando el estado de permanencia está activado, 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 un objeto de ejes no existe, el comando hold lo crea.

ejemplo

hold off establece el estado de permanencia de los ejes 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. Cuando el estado de permanencia está desactivado, 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 activa y desactiva el estado de permanencia.

hold(state) establece el estado de permanencia de los ejes especificando un valor state. Puede especificar state como "on", "off", un valor lógico o un valor OnOffSwitchState.

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.

Ejemplos

contraer todo

Abrir script en vivo

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

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)

Abrir script en vivo

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)

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

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

Abrir script en vivo

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')

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')

Argumentos de entrada

contraer todo

Estado de permanencia de los ejes, especificado como uno de estos valores:

  • "on" u "off": un valor de "on" establece el estado de permanencia en activado y "off" establece el estado de permanencia en desactivado. También puede especificar los vectores de caracteres 'on' u 'off'.

  • 1 (true) o 0 (false) numérico o lógico: un valor de 1 o true establece el estado de permanencia en activado y 0 o false establece el estado en desactivado. (desde R2024a)

  • Un valor de matlab.lang.OnOffSwitchState: un valor matlab.lang.OnOffSwitchState.on establece el estado de permanencia en activado y matlab.lang.OnOffSwitchState.off establece el estado de permanencia en desactivado. (desde R2024a)

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

expandir todo

Consulte también

Funciones

Propiedades

Clases

Temas