Retain current plot when adding new plots (2024)

Table of Contents
Syntax Description Examples Add Line Plot to Existing Axes Specify Hold State for Specific Axes Set the Hold State for Multiple Axes Input Arguments state — Axes hold state "on" | "off" | true or 1 | false or 0 | OnOffSwitchState value ax — Target axes axes | array of axes Tips Algorithms Version History R2024a: Change axes hold state by specifying logical or OnOffSwitchState value R2014b: hold all command will be removed See Also Functions Properties Classes Topics MATLAB Command Americas Europe Asia Pacific References

Retain current plot when adding new plots

collapse all in page

Syntax

hold on

hold off

hold

hold(state)

hold(ax,___)

Description

example

hold on sets the axes hold state to on, which retains plots in the current axes so that new plots added to the axes do not delete existing plots. When the hold state is on, new plots use the next colors and line styles based on the ColorOrder and LineStyleOrder properties of the axes. MATLAB® adjusts axes limits, tick marks, and tick labels to display the full range of data. If an axes object does not exist, then the hold command creates one.

example

hold off sets the axes hold state to off so that new plots added to the axes clear existing plots and reset all axes properties. When the hold state is off, the next plot added to the axes uses the first color and line style based on the ColorOrder and LineStyleOrder properties of the axes. This option is the default behavior.

hold toggles the hold state between on and off.

hold(state) sets the axes hold state by specifying a state value. You can specify state as "on", "off", a logical value, or an OnOffSwitchState value.

example

hold(ax,___) sets the hold state for the axes specified by ax instead of the current axes. Specify ax before all other arguments.

Examples

collapse all

Add Line Plot to Existing Axes

Open Live Script

Create a line plot. Use hold on to add a second line plot without deleting the existing line plot. The new plot uses the next color and line style based on the ColorOrder and LineStyleOrder properties of the axes. Then reset the hold state to off.

x = linspace(-pi,pi);y1 = sin(x);plot(x,y1)hold ony2 = cos(x);plot(x,y2)hold off

Retain current plot when adding new plots (1)

When the hold state is off, new plots delete existing plots. New plots start from the beginning of the color order and line style order.

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

Retain current plot when adding new plots (2)

See Also
Scatter chart appearance and behaviorHow to edit my scatter plot legend?Create axes in tiled chart layoutScatter3, insert dashed line downwards, and sideways

Specify Hold State for Specific Axes

Open Live Script

Starting in R2019b, you can display a tiling of plots using the tiledlayout and nexttile functions. Call the tiledlayout function to create a 2-by-1 tiled chart layout. Call the nexttile function to create the axes objects ax1 and ax2. Plot a sine wave plot in each axes.

x = linspace(0,10);y1 = sin(x);y2 = cos(x);tiledlayout(2,1)% Top plotax1 = nexttile;plot(ax1,x,y1)% Bottom plotax2 = nexttile;plot(ax2,x,y2)

Retain current plot when adding new plots (3)

Add a second sine wave to the top axes.

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

Retain current plot when adding new plots (4)

Set the Hold State for Multiple Axes

Create a 1-by-2 tiled chart layout. Call the nexttile function to create two axes objects and plot into the axes. 

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

Retain current plot when adding new plots (5)

Set the hold state for both of the axes to 'on'. Then display additional data in each plot.

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

Retain current plot when adding new plots (6)

Input Arguments

collapse all

state — Axes hold state
"on" | "off" | true or 1 | false or 0 | OnOffSwitchState value

Axes hold state, specified one of these values:

  • "on" or "off" — A value of "on" sets the hold state to on, and "off" sets the state to off. You can also specify the character vectors 'on' or 'off'.

  • Numeric or logical 1 (true) or 0 (false) — A value of 1 or true sets the hold state to on, and 0 or false sets the state to off. (since R2024a)

  • A matlab.lang.OnOffSwitchState value — A value of matlab.lang.OnOffSwitchState.on sets the hold state to on, and matlab.lang.OnOffSwitchState.off sets the state to off. (since R2024a)

ax — Target axes
axes | array of axes

Target axes, specified as one of the following:

  • Any type of axes object: an Axes, PolarAxes, or GeographicAxes object.

  • An array of axes objects that belong to the same class. To determine the class, use the class function.

If you do not specify the axes, then hold sets the hold state for the current axes.

Tips

  • Use the ishold function to testthe hold state.

Algorithms

The hold function sets these properties:

  • NextPlot axes property - Sets this property of the associated Axes, PolarAxes, or GeographicAxes object to either 'add' or 'replace'.

  • NextPlot figure property - Sets this property of the Figure object to 'add'.

Version History

Introduced before R2006a

expand all

The hold all command will be removed in a future release. Use hold on instead.

See Also

Functions

  • ishold | figure | tiledlayout | nexttile | axes | cla | newplot

Properties

  • Axes Properties | PolarAxes Properties

Classes

  • matlab.lang.OnOffSwitchState

Topics

  • Combine Multiple Plots

MATLAB Command

You clicked a link that corresponds to this MATLAB command: 

 
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
 
 
 
 
 
 
 
 Retain current plot when adding new plots (7) 
 
 
 
 
Select a Web Site
 
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
 
 
 
You can also select a web site from the following list:
 
 
 
Americas
 
     
  • América Latina (Español)
    •  
  • Canada (English)
    •  
  • United States (English)
    •  
 
 
 
Europe
 
 
 
     
  • Belgium (English)
    •  
  • Denmark (English)
    •  
  • Deutschland (Deutsch)
    •  
  • España (Español)
    •  
  • Finland (English)
    •  
  • France (Français)
    •  
  • Ireland (English)
    •  
  • Italia (Italiano)
    •  
  • Luxembourg (English)
    •  
 
 
 
     
  • Netherlands (English)
    •  
  • Norway (English)
    •  
  • Österreich (Deutsch)
    •  
  • Portugal (English)
    •  
  • Sweden (English)
    •  
  • Switzerland 
       
    • Deutsch
      •  
    • English
      •  
    • Français
      •  
     
    •  
  • United Kingdom (English)
    •  
 
 
 
 
 
Asia Pacific
  
 
 
Contact your local office
 
 
 
 
 

                                                        Retain current plot when adding new plots (2024)
                        

                            
                        

                    

                                                            
References

    
                                                
Top Articles

                            

                                                                    



    
    

        Strong Medicine - Episodenguide und News zur Serie
    


                                                                    



    
    

        Strong Medicine - Zwei Ärztinnen wie Feuer und Eis - alles zur Serie  - TV SPIELFILM
    


                                                                                                    



    
    

        Covering voiture à Paris et Île-de-France (75) - Total wrapping
    


                



    
    

        PDF verkleinen - snel, online, gratis
    


                



    
    

        Does UPS Pick up On Saturday? Understanding Weekend Shipping 101
    


                



    
    

        La Fitness Bring A Guest
    


                



    
    

        'Completely Abandoned': Greyson Chance Is Finally Ready to Talk About Ellen
    


                



    
    

        Greyson Chance Is Finally Writing Music for Himself
    


                



    
    

        Craigslist Mt Pleasant Sc
    


                



    
    

        HPE ProLiant DL380 Generation9 (Gen9) - Hewlett Packard … · 5. Power supply Power connection 6. Power supply Power LED 7. HPE Flexible Slot Power Supply bay 1 (800w shown) 8. Power - [PDF Document]
    


                                                                

                                                                
Latest Posts

                        

                                                            



    
    

        Edenmodelsva
    


                                                            



    
    

        Sources: Feven Kay out at Fox5
    


                                                    

                    
                    

        

    
    
    



                    

    
Article information

    
Author:  Trent Wehner 

    
Last Updated:   

    
Views: 5868

    
Rating: 4.6 / 5 (56 voted)

    
Reviews: 87% of readers found this page helpful





    
Author information

    
Name: Trent Wehner

    
Birthday: 1993-03-14

    
Address: 872 Kevin Squares, New Codyville, AK 01785-0416

    
Phone: +18698800304764

    
Job: Senior Farming Developer

    
Hobby: Paintball, Calligraphy, Hunting, Flying disc, Lapidary, Rafting, Inline skating

    
Introduction: My name is Trent Wehner, I am a talented, brainy, zealous, light, funny, gleaming, attractive person who loves writing and wants to share my knowledge and understanding with you.