Programming examples




In the demo folder you will find these 35 example programs to help you learn how to take advantage of many of plt's features.

CLICK on the thumbnails below to see the full size image


plt5.m

This is a simple script which creates a plot containing 5 traces. Hopefully you have already been running this script while following through the earlier sections.
  • Note how the five y-vectors are combined to form a single plt argument.
  • Note the use of the 'Xlim' and 'Ylim' arguments to control the initial axis limits.
  • Note the use of  'LabelX' argument to assign a label for the x axis.
  • Note the use of the 'LabelY' argument to add a label for both the left and right-hand axes.
Note that plt will use a right-hand axis since two labels were included in the LabelY parameter. Usually the 'Right' parameter is included to specify which traces are to use the right axis, but in this example the parameter was omitted, so plt defaults to putting just the last trace on the right-hand axis.

afilt.m

This example program displays the frequency response of the most common traditional analog filters. GUI controls are provided to adjust the most important filter parameters (Filter order, Cutoff frequency, & Passband/Stopband ripple). A pole/zero plot is also provided for the prototype filters (i.e. low pass with a cutoff frequency of 1 radian/sec). Both plots (especially the pole/zero plot) are easier to interpret with only one filter type enabled. To do this, right click on the "Elliptic" traceID (for example) in the black traceID block near the left edge of the figure. That will disable all traces on both plots except for the traces associated with the elliptic filter type.

afilt creates these fourteen pseudo objects:

  1.  a plot
  2.  a cursor
  3.  a grid
  4.  an edit object (filter order)
  5.  a popup (filter type)
  6.  a popup (decades to display)
  7.  a popup (number of points to display)
  1.  a slider (passband ripple)
  2.  a slider (stopband ripple)
  3.  a slider (cutoff frequency)
  4.  a slider (frequency 2)
  5.  a secondary plot (pole/zero)
  6.  a cursor for the 2nd plot
  7.  a grid for the 2nd plot
The first three three pseudo objects in this list are created by the first call to plt and the next eight pseudo objects are created with eight additional calls to plt. And finally one more call to pltinit creates the last 3 pseudo objects. Click on the first thumbnail to the left to see these pseudo objects clearly. Although Matlab already has objects with similar names, these pseudo objects are different. They provide more utility and options. The pseudo objects 4 thru 7 listed above are grouped inside a parameter frame (a grey box implemented by using a Matlab axis object).
  • When you click on the first thumbnail to the left you will see the figure window that results when you run afilt.m - the full version of this program (that includes the pole/zero plot). This is the version that is run by demoplot.
  • When you click on the second thumbnail to the left you will see the figure window that results when you run afiltALT.m (provided in the demo folder but not run by demoplt). This is an alternate version of afilt which differs primarily in the number of traces used. While afilt uses 10 traces (5 for magnitude and 5 for phase) afiltALT uses just 5 traces (on a single axes) to display both magnitude and phase for all 5 filter types. The trick to make this work is to use each trace to display both the magnitude and the phase information. I eventually decided that the 10 trace method was simpler, but the alternate version is included since it illustrates a useful technique. Note that the tick marks are modified so that they read in degrees in the phase portion of the plot. Also the phase portion is highlighted with a gray patch to better separate it visually from the magnitude plot. afiltALT is shorter than afilt because it doesn't include the pole/zero plot and also (unlike afilt and afiltS) it takes advantage of some functions from from the signal processing toolbox.
  • The third thumbnail to the left is the figure window from afiltS.m (yet another alternate version of afilt also provided in the demo folder but not run by demoplt). Although it includes the most important features of afilt, this version is simple enough that it provides a good introduction to GUI programming and in fact is used as the 2nd example in the GUI building with plt section of the help file.

bounce.m

This function displays many of markers with random shapes and colors starting at the plot origin and then randomly walking around bouncing off the walls. Click on the Walk/Stop button to start and stop the motion.
  • plt creates 513 line objects. All but the last line object are for displaying the markers (each marker displayed is actually a line object containing just a single point). You can control how many of these markers are visible and in motion. The last line object is used to display the arrows representing the velocity of each marker.
  • The input argument determines how long the display will run. If no input argument is provided, the display will stop after 50 display updates. If you call bounce with a zero argument or any string argument, it will run forever (or until you press "Stop").
  • The popup control on the left controls the size of the velocity arrows. This popup was created using the "super button" mode which means you just click on the popup to advance to the next larger size. After "large" it will wrap around to "none" (which inhibits the display of the velocity arrows). If you want to actually open the pop menu to observe your choices, simply right-click on the popup. As with the other controls, you may modify the control even while it is walking.
  • While the display is walking, the number of updates per second is computed and displayed in the figure title bar. Even while the display is walking, you can change the number of markers that are visible and moving. (The slider below the plot). It initializes to 128 markers when the program starts.
  • The slider on the left controls the walking speed. This isn't the update rate (which actually proceeds as fast as possible), but it actually controls how far each marker moves between each display update.
  • Shows how to set line properties using cell arrays.
  • Shows how plt can avoid its 99 trace limit by disabling TraceIDs.
  • Demonstrates how to create moving displays by changing the trace x/y data values inside a while loop.

circles12.m

This demo creates 3 figures each showing a different solution to the following geometric problem ...
Draw 12 circles in a plane so that every circle is tangent to exactly 5 others.

Figure 1 (the top thumbnail) shows the solution that was given by the puzzle's author. While I was deriving a formula for the size and position of the circles for this solution I realized that there are three minor variations of this solution, one of which is shown in Figure 2 (the middle thumbnail). I invented yet another solution to this puzzle which is shown in Figure 3. Although all the solutions are somewhat surprising, I think the last one is the most mind blowing.

  • This program shows the advantages using complex numbers to hold the x and y positions of the plotted points.
  • Demonstrates using prin to create the Trace IDs.
  • Demonstrates how to make circles look true (i.e. a one-to-one aspect ratio) by using a zero in the 'Pos' argument (width or height). The 'Pos' argument is also used to position the third figure (solution 3) as far as possible towards the top of the screen. (This is done by setting the Ybottom value equal to inf.)
  • Demonstrates the use of the 'Ticks' option to select axis tick marks instead of the full grid lines.
  • An edit pseudo object has been added below the plot in Figure 1 (solution 1) which lets you rotate the image and control the rotation speed. circles12 will normally start with the plot showing solution 1 rotating slowly (rotation speed setting of 2). Note that the funcStart auxiliary function is used so that circles12 returns to the command prompt even while the plot is continuing to rotate.
  • If you call circles12 with an argument (of any type or value), then the plot will not start rotating until you press the "start rotation" button.
When you click on the thumbnails to the left for figure 1 or 2 you will see the full scale image saved as a bitmap screen capture. When you click on the thumbnail for figure 3 you will see the figure saved as a .svg (scalable vector graphics) file. The steps used to create this svg file are as follows:
  • Click on the "Menu" tag in the Menu box to make the menu bar visible
  • Click on "plt" in the menu bar and select "Hide/Show cursor controls"
  • Click on "plt" in the menu bar and select "Hide/Show TraceID box"
  • Remove the tick marks for esthetics (type set(gca,'xtick',[],'ytick',[]);)
  • Click on "File" in the menu bar and select "Save As" and then select "Scalable Vector Graphics file" in the "Save as type" popup menu at the bottom

curves.m

This function shows an example where many GUI controls need to fit into a relatively small space.
  • The ten controls above the graph (nine edit text objects and one popup text object) all are used to control how the parametric curves in the graph are displayed.
  • If we used the traditional Matlab/Windows GUI objects, we would have had to make the graph much smaller to make room for all these controls.
  • In addition, the plt('edit') pseudo objects provide a much easier way to modify the numeric values, nearly matching the convenience of a slider object. The plt('edit') and plt('pop') commands are described in the Pseudo objects section.

After starting curves.m, right-click on the curve name at the bottom of the figure to cycle through the 42 different cool looking curve displays. Left-click on the curve name as well to select from the complete list of curves. If you start it by typing "curves go" then after starting it will cycle once through all 42 curves (at a default rate of one second per curve). demoplt.m calls curves this way which explains why it starts cycling immediately. If you want the cycle to proceed at a different rate, you may select the desired rate with the delay popup just below the Cycle button. When the last curve is displayed the cycling stops and the time it took to cycle thru all the curves is displayed in the upper left corner of the figure. (This a useful as a speed performance measure if you set the delay to zero.)

  • The equations in (reddish) orange just below the graph and above the curve name, serve as more than just the x-axis label. This specific string is evaluated by Matlab to compute the points plotted on the graph.
  • The vector t, and the constants a, b, and c that appear in these equations are defined by the controls above the graph. Experiment by both right and left-clicking on these controls.
  • For the cases when more than one trace is plotted, the first control on the left (labeled "trace") indicates which trace is effected by the other nine controls above the graph.
  • Note that when you left-click on a control, it will increase or decrease depending on whether you click on the left or right side of the text string.
  • Separate values for a, b, and c are saved for each trace of a multi-trace plot. This explains the variety of curves that can appear for a single set of equations (shown below the graph). Left-clicking on the "Default" button will reset all these parameters to their initial settings for only the function currently selected. It will have no effect on the settings for the remaining 41 curves. However if you right-click on the "Default" button, then the settings for all 42 curves will be reset to the values they were initialized to when the curves program started.
  • Note the help text (in purple, center left) tells you just enough to get started using the program, even if you haven't read any of the documentation. This was added using the 'HelpText' parameter. Selecting a different curve (with the popup pseudo object) will erase the help text and right-clicking on the "Help" tag in the MenuBox will make it reappear.
  • For most of the curves there is also some text (in grey) in the plot area that describe some technical or historical information related to the curve, hopefully making this program more interesting and educational. The text is embedded in the same table that stores the curve name, equations, and parameters. At the beginning of the text string are some codes that specify the text position and font size.

dice3.m

This function displays a simulation of Sam Loyd's carnival dice game. - You bet 1 dollar to play (rolling 3 dice). If one six appears you get 2 dollars, if two sixes appear, you get 3 dollars, if three sixes appear, you get 4 dollars, and otherwise, you get nothing. (Is this a good bet to make?)
  • Three traces are created: accumulated winnings, earnings per bet, and expected earnings per bet.
  • The first two traces are displayed as they are computed, i.e. every time the dice are rolled, a new value is appended to the trace and the plot is updated so you can watch the function grow in real time.
  • A second axis is added near the top of the figure to show the dice. For each die, a line with dots as markers is added for each of the six faces, with only one of these lines being visible at a time. A square patch is also added for each die for the visual effect.
There are four ways you can start the program:
  • dice3     - sets up simulation. No bets occur until you click a button.
  • dice3(n)  - sets up simulation & makes n bets (then stops).
  • dice3(0)  - sets up simulation & makes bets continuously until you click stop.
  • dice3 run - same as above (when called with any string argument)

editz.m

This function demonstrates the usefulness of plt's data editing capability. Two plots are created, the lower one showing the poles and zeros of a z-plane transfer function and the upper one other showing the magnitude and phase of it's frequency response. The frequency response plot automatically updates even while you are dragging a root to a new location. At first the updating in real time (i.e. while you are dragging) may not seem so important, but when you use the program its becomes clear that this allows you to gain a feel for how the root locations effect the frequency response reacts.
  • For a complete description of this application, click on the "Help" tag in the menu box to the left of the pole/zero plot, or see editz (Tinkering in the z plane)
  • The real time motion mentioned above is accomplished by using the MotionEdit parameter (see line 94).
  • Normally plt's data editing is initiated when you right click on either the x or the y cursor readouts. However when data editing is being used extensively (as in the lower plot of this example) it is useful to put it in the "persistent editing mode" which is done on line 95. Also, in the following line (line 96) the application data variable 'EditCur' is used to change the default size of the cursors used for editing.
  • Demonstrates the use of the Xstring and Ystring parameters. In the frequency plot, the x-cursor edit boxes show the cursor location as a fraction of the sample rate. The Xstring parameter is used to show this as an angular measure (in degrees) just to the right of the x-cursor readout. Since the DualCur parameter is used, there are two y-cursor edit boxes. The first one (green) shows the magnitude response in dB and the second one (purple) shows the phase response in degrees. The Ystring parameter is used to show the magnitude response in linear form (in percent). Note that after the plot command, the Ystring is moved to the left of the plot because by default the Ystring appears in the same place as the dual cursor. The alternate location allows room for a multi-line Ystring which is generated compliments of prin's cell array output feature. The Xstring parameter is also used in the pole/zero plot to show the pole/zero locations in polar form.
  • The AxisLink parameter is used so that by default the mag/phase axes are controlled separately.
  • Shows how you can take advantage of both left and right click actions of a button. Left-clicking on the "delete p/z" button deletes the root under the cursor as you might expect. Right-clicking on this button undoes the previous delete. This is a multi-level undo, so you could delete all the roots and then restore them one by one.
  • Demonstrates the use of the 'Fig' parameter to put two plots in one figure with each plot possessing all the features available to any single plot created by plt.


gauss.m

This script plots the results of combining uniform random variables.
  • Shows the advantage passing plot data in cell arrays when the traces contain different number of data points.
  • Shows how the line zData can be used to save an alternative data set which in this example is the error terms instead of the actual correlations. A checkbox allows you to tell the plot to show the alternative data set. The label for the checkbox is rotated 90 degrees so that it can fit in the small space to the left of the plot.
  • Note the use of the 'FigName' and 'TraceID' arguments.
  • Note the appearance of the Greek letter in the x-axis label.
  • The 'Options' argument enables the x-axis cursor slider (which appears just below the peak/valley finder buttons), adds the Print tag to the menu box, and lastly removes the LinX/LogX and LinY/LogY selectors from the menu box.
  • Shows how to use the 'DIStrace' argument to disable some traces on startup.
  • Shows how to use the 'MotionZoom' argument to create a new plot showing only the zoom window. Admittedly this is more contrived than useful in this particular script, but at least this example will clarify the function of the MotionZoom parameter.
  • The zoom window plot also demonstrates an easy way to copy the trace data from one plot to another (in this case from the main plot to the zoom plot).
  • The first trace is displayed using markers only to distinguish the true Gaussian curve.
  • Demonstrates the use of the 'HelpText' parameter to initialize a GUI with user help information that is cleared when the user begins to use the application. In this case the 'MoveCB' parameter is used to cause the help text to be removed when you click on the plot. The help text is also removed if you click on the checkbox. If you want the help text to reappear, simply right-click on the help tag in the MenuBox.
  • The lower plot shows what the display looks like after the "plot errors only" checkbox has been checked. Note that only traces 3,5,7 and 9 have been enabled showing the difference between the true gaussian curve and the result of summing 3, 5, 7, and 9 uniform distributions. The cursor in this figure was placed on the peak of trace 9 (using the peak cursor button) showing that by the time 9 uniform distributions are summed, the error from the true Gaussian is well under 2%.

gpsLog.m

Reads the GPS data in the file gpsLog.csv in the same folder as this .m file. If this data file doesn't exist, the file will be created using simulated data. Two plots are then created, an altitude/speed plot and an xy position plot (the first two images on the left).

Many plt features are used in this example program, but perhaps the most interesting is the use of the MoveCB callback to keep the cursors of all for axes (in two figure windows) synchronized so that they all are pointing to the same GPS fix. The use of the ColorPick pseudo object to select the two colors for the KML file is also interesting.

KML file options:
  • Click the KML button to create a google earth kml file of the gps data. The other objects in the frame with the KML button define the track styling.
  • The most common way to depict a GPS track is with a continuous solid line. This results in the most compact KML file and a very easy to follow track. To achieve that style, select a width from 1 to 9 using the popup next to "Solid track width" label as well as the color you want for the track. Then set the "Dashed track width" to zero. The only disadvantage of this style is that other than during turns, you can't tell where the GPS fixes are located. (All you know is that the fixes are located somewhere on the depicted line.)
  • Instead of a solid track you can choose to use a dashed line for the track. To do this, select a dashed track width from 1 to 9 and a solid track width of zero. The KML file will be a bit larger, but the advantage of the dashed line is that you can tell exactly where the GPS fixes are. There is a GPS fix at both ends of each dash (i.e. there are twice as many fixes as dashes).
  • At the cost of an only slightly larger KML file you can have the best of both worlds by enabling both the solid and the dashed track. (The dashes will appear on top of the solid track.) This is the style (as shown to the right) that will be used if you don't change the defaults used when gpsLog is started - a thick yellow dashed line on top of a thin solid white line. (Remember you can click on this image to see a larger view.) It's easy to experiment with the various thicknesses and colors to get the result that pleases you most.

gui1.m

Usually plt is used to build gui applications which include plotting, however this example doesn't include plots so that it remains trivial, making it a good example to start with if you have no previous exposure to Matlab GUI programming. The only pseudo object used in gui1 is the pseudo slider which is a collection of 5 uicontrols designed to work together to control a single parameter. The remaining controls used in gui1 are standard Matlab uicontrols.

This GUI doesn't actually perform any useful function other than to demonstrate how to create various controls and move them around until the GUI appears as desired. The slider callback generates new random numbers for the listbox, textbox, and uitable. The remaining callbacks are just stubs that notify you that you clicked on the object.

You can most easily absorb the point of this example (as well as afilt.m) by reading this section of the help file: GUI building with plt.

gui1.m uses a uitable which aren't supported in Matlab 6, so if you are running a version of Matlab older than 7.0 then you should run an alternate version of this program called gui1v6.m which replaces the uitable with a radio button. If you start gui1 from demoplt, demoplt checks the Matlab version and runs gui1 or gui1v6 as appropriate.

julia.m

The intent of this example is to demonstrate the generality of the image pseudo object by including two of these objects in a single figure, and to demonstrate the use of the 'Fig' parameter as well as several other graphical programming techniques. It's easy to find dozens of Julia set graphing programs in nearly every language (including Matlab) so I wouldn't fault you if you were skeptical of the need for yet another application with this purpose. However my goal was to leverage the power of the plt plotting package to show how fun it is to explore Julia sets and to make this application more compelling than any similar application out there. I'll let you be the judge how well I have met this challenge.

Julia set images are traditionally generated with the repeated application of the equation z = z2 + c (z and c are complex). This application also allows exponents other than 2 (called the generalized Julia set). The color of the image is determined by the number of iterations it takes for the magnitude of z to grow larger than some fixed value (2.0 for this program). The Mandelbrot set uses the same equation and the same color assignment method, but differs in how the equation is initialized.

Some very basic instructions appear in the figure when the application starts but this help text disappears as soon as you click anywhere in the plot region. For a complete description of this application, see A Julia set explorer

movbar.m

This function plots a series of 40 random bars and displays a horizontal threshold line which you can move by sliding the mouse along the vertical green line. As you move the threshold line, a string below the plot reports the number of bars that exceed the threshold. (This demonstrates the use of the plt xstring parameter.) These two buttons are created:
  • Rand: Sets the bar heights to a new random data set.
  • Walk: Clicking this once starts a random walk process of the bar heights. Clicking a second time halts this process. The Walk button user data holds the walk/halt status (1/0 respectively) demonstrating a simple way to start and stop a moving plot.

Note that you can move the threshold or press the Rand button while it is walking. Also, if you click on one of the vertical purple bars, the horizontal threshold bar will then follow the upper end of that vertical bar.

If movbar is called with an input argument, the value of the argument is ignored, but movbar will start as if the walk button has been hit. The walking is initiated using the funcStart function so that control returns to the command prompt even though movbar continues to update the plot.


plt50.m



This script is an expansion of the simple plt5.m example to demonstrate additional features of plt.

Note that two plots appear in this figure. There are two methods that you can use with plt to create figures containing multiple plots. The first is to use the subplot parameter to create multiple plots with a single call to plt. (This is demonstrated by the subplt.m, subplt8.m, subplt16.m, subplt20.m, pub0.m, pub2.m, pltmap.m, and weight.m programming examples). The second method (which is used here as well as in the pub3.m example) is to use a separate call to plt for each plot. The first plot (upper) is created by a call to plt that is quite similar to the one used in the simple plt5.m example. plt creates the figure window as usual and then creates the upper plot inside the new figure. Both a left and right hand axis are used for this plot. We are free to put as many traces as we want on either the left or right hand side, although in this example we put all the traces of this plot on the left hand axis except for the last one (trace Tr40) which is put on the right hand axis (and is also drawn with a thicker trace). The two major differences between this (first) call to plt and the plt call used in plt5.m are:
  1. The number of traces has been expanded from 5 to 40. Without additional action, this would create a TraceID box (legend) containing 40 trace names in a single column. However this would not work well or look good to cram such a long list into the small space available. To solve that problem the the TIDcolumn parameter has been used to create a TraceID box with two columns. The 'TIDcolumn',20 included in the plt argument list actually specifies the number of items to put in the second column, which in this example means that both columns will contain 20 items.
  2. The 'xy' parameter is included to specify the location of the plot within the figure window. This wasn't needed before (in plt5.m) since the plot was automatically sized to fill the entire figure window. But now we want to create the plot in only a portion of the window to leave room for a second plot to be created. The object ID (-3) in the first row indicates that this position is to be used for both the left and right axis and also that all the cursor object positions should be positioned relative to these axes. (ID 0 also refers to both left & right axes but does not cause the other cursor objects to be repositioned as well). Although plt makes its best guess for the positions of the TraceID and Menu boxes often you will want to reposition them with the xy parameter to make best use of the available space. The 2nd row of the xy matrix repositions the TraceID box. The last row repositions the Yaxis label which otherwise would have been covered up by the TraceID box. Note that you don't need to figure out the numbers in the xy matrix since they will be reported to you as you adjust the positions of the screen objects with the mouse. (See the description of the xy parameter in the Axis properties section of the help file.)
Following the first call to plt which displays the first 40 traces, a second call to plt is used to display the remaining 10 traces in a plot below the first one. As before we use the 'xy' parameter to get the plot to fit in the remaining open space of the figure. As with the first plot, we also include both the left and right hand axis. We were again free to put as many of these traces as desired on either side, but we choose to put only trace 5 on the right hand axis with all the remaining traces on the left axis. The most important difference between the first and second plt calls is that in the second call we include the 'Fig',gcf in the parameter list. (gcf stands for "get current figure handle"). This tells plt not to open a new figure for the plot as usual, but rather to put the plot in the specified figure. The 'Fig' parameter must be either at the beginning or at the end of the plt parameter list. (All other plt parameters may be placed anywhere in the parameter list). You may notice that the xy parameter for this plot includes an imaginary component in the last element of the axis position. The reason for this is that since the sizes of the cursor objects are relative to the plot size. This sometimes makes the cursor objects too small when the plot is a small fraction of the figure size. To fix this problem, one can enter a minimum width or height in the imaginary component of the width and/or height values.

A few other features of the first (upper plot) are worth pointing out:
  • With so many traces, the ability to use the legend (i.e. the TraceID box) to selectively enable or disable individual traces becomes even more compelling. Although the traces and the legend are color coded, it's difficult to distinguish every trace based on color, so clicking on a legend item is often useful to uniquely identify a trace.
  • The 'Pos' parameter is used to increase the figure area about 30% from the default of 700x525 pixels to 830x550. This gives room to fit both plots into the figure area without overcrowding.
  • The 'HelpFileR'' parameter is used to specify which help file will appear when you right-click on the Help tag in the menu box. Normally the file specified will contain help for the currently running script. In this case prin.pdf is just used as an example and in fact has nothing to do with plt50.
  • The use of the 'closeReq' parameter is shown, although in this case the function specified merely displays a message. Look at the afilt.m and wfall.m demos to see examples of a somewhat more sophisticated close request functions.
  • In situations like this with so many traces on the plot it can be difficult to find the cursor. The line following the first call to plt solves this problem increasing the cursor size from 8 to 20 as well as by changing the cursor shape from a plus sign to an asterisk.

pltmap.m

The main purpose of this function is to demonstrate the use of the image pseudo object. The subplot parameter is used to partition the figure into two parts. The left part displays a conventional 2D plot which includes the following five traces.
  1. A circle (green trace) whose radius is controlled by its amplitude slider (the leftmost slider above the plot in the "Y amplitudes" section).
  2. A hyperbola (purple trace). Its amplitude slider controls the asymptote slope.
  3. A polygon (cyan trace). Its amplitude slider controls both the size of the figure and the number of sides (which range from 3 to 7).
  4. Two lines (red and blue traces). Their amplitude sliders control the lines' positions as well as determines the lines' orientation (vertical/horizontal).
The five Z amplitude sliders assign a z coordinate to each of the five traces, then these 500 points (100 points per trace) are interpolated using griddata to create the two input function displayed using an intensity map on the right side of the figure.

The many features of pltmap and the image pseudo object are intertwined so to help you explore these features, consider starting up pltmap and running through these tasks:
  • Adjust some of the "Y amplitudes" (5 sliders near the upper left corner) and observe how they affect their respective traces (1-5). Note that the intensity map changes as well since the z values are computed from the shapes of these five traces.
  • Disable and enable the various traces by clicking on the trace names in the TraceID box. Note that the intensity map shape is determined only from the enabled traces. A strange thing happens if you disable all the traces except for trace 4 or trace 5 (showing just a single horizontal or vertical line). What happens is that the intensity map no longer represents anything associated with the 2D plot. This is because the griddata function is used to interpolate the data from the 2D plot, but it fails because it doesn't have enough data when provided with just a single line of zero or infinite slope. So when this error is detected, pltmap creates an alternate intensity map showing a 2 dimensional sync function with a random center position. (For variety, this sync function also appears for a the first few seconds of a moving display [see the description of the "Run" button below], but note that this happens only the first time the Run button is pressed after pltmap is started. Subsequent presses of the Run button simply start the intensity map updating in the usual fashion.
  • Adjust the "Z amplitudes" for each of the 5 traces using the sliders. The z values of the traces are not plotted in the 2D plot (left) but note how these amplitudes affect the intensity map.
  • Click on the "color bar", the vertical color key strip near the upper left corner of the intensity map. Note that this cycles the color map through seven choices. Some of the color maps have a particular purpose, but mostly this is simply a visual preference.
  • Note that the intensity map appears somewhat pixelated. This is because it is composed of a relatively small number of pixels (200x200). Try zooming in on an interesting looking region of the intensity map using a zoom box. Hold the shift key down and drag the mouse to create the zoom box. Then click inside the zoom box to expand the display. Even though you still have only 200x200 pixels, the display will look smoother because all these pixels are focused on a smaller region of the more quickly changing z data. You can also zoom in by right-clicking on the "view all" button in the lower right corner. Then left-click on the view all button to expand the limits back to their original values to show the entire z data set.
  • Also try opening a zoom box in the 2D plot (left). You can do this as before (shift key and mouse drag) or try the "double click and drag" mouse technique which avoids having to use the keyboard. You may be surprised to see that the intensity map zooms to show the region inside the zoom box of the 2D plot even as you are dragging the edge of the zoom box. If you then click inside the zoom box the 2D plot will also expand to show just the region inside the zoom box ... but let's not do this just yet. First try moving the zoom box around. Do this by clicking the mouse near the mid-point of any edge, and drag the zoom box around while holding the mouse button down. Also note that if you drag one of the corners instead of a midpoint then the zoom box changes its size instead of its position. In both cases the intensity map continues to update so that it shows only the zoom box region. These mouse motions are further described in the paragraph titled "Adjusting the expansion box" in the Zooming and panning section.
  • Try sliding the resolution slider (just to the left of the color bar) all the way to the top of the slider. This will select a resolution of 800x800 (16 times as many pixels as before) so the display will look much smoother, but the drawback is that the update rate will be much slower. Try moving the slider all the way to the bottom (50x50 pixels). Now the intensity map will look very blocky, and the update rate will be very fast. Note that when you click inside the intensity map, the cursor will center itself on one of the blocks even if you click near the edge of one of the blocks. This makes it easier to interpret the Z value cursor readout (shown below the intensity map. Also note the x and y cursor readouts are updated as you would expect every time you click on the image. Reset the resolution slider to 200 before continuing.
  • Try adjusting the "edge" slider (right below the color bar). The default value of the slider is "1" which means that only the z data range between μ=σ and μ+σ is used for assigning colors of the z values, where μ represents the mean of the z data. This means that all the data bigger than 1 standard deviation above the mean is represented by the same color. If you move the slider to "2", then two standard deviations of the data are used so that you can see variations near the extremes that you couldn't see before. But the downside is that you will see less detail for smaller changes in the z values closer to the mean. You can also adjust the mid point for the range of focus using the mid slider (just to the left of the edge slider). For example if you are more interested in getting a view of the data greater than the mean you might set mid=.5 and edge=.8. This would mean that the range of data that produces different colors in the image would be from μ-.3σ to μ+1.3σ.
  • Although it doesn't really demonstrate any more features of the new image pseudo object, if you really want to be mesmerized by the display, press the "Run" button. What happens is that a random selection of the 10 sliders above the 2D plot are selected to start moving. (The remaining sliders that are held fixed are made invisible so you can easily see what is changing). As the sliders are moving up and down, both the 2D and 3D plots are continuously updated to reflect the new information in the sliders. As this is happening you will see the small (blue) frame counter below the Run/Stop button counting down from 100 to zero. When zero is reached, a new random selection is made from the set of 10 sliders and the frame counter begins down counting anew from 100. While all this is happening, you may change the speed slider to adjust the motion rates and you also may adjust pretty much everything else mentioned in the above bullet points. If you find that 100 frame count is too long or short for your taste, simply click on the yellow "100" and you will be presented with a popup menu allowing you to vary this frame count from as small as five to as large as 1000. Note that if you call pltmap with any argument, pltmap will start as if the run button has already been pressed. The funcStart function is used to initiate the run which allows pltmap to return control back to the command prompt even while continuing to update the moving intensity maps.

pltn.m

Similar to plt5 and plt50, except that this is a function instead of a script. This function takes an argument which specifies how many traces to plot. For instance pltn(1) will plot a single trace, and pltn(99) will plot 99 traces. If you specify more traces than this, the trace IDs are not displayed (since there will not be room for them). pltn with no arguments does the same thing as pltn(99). You can change the number of traces plotted even after pltn is already running by entering a new number in the "# of lines" edit box (under the TraceID box). Try entering "1000" into this edit box just to see that plt can actually handle such a large number of traces! Going much beyond 1000 traces is a good performance test, since on slower computers you will start to notice a significant lag on pan operations.
  • The TIDcolumn parameter is used to divide the trace IDs into up to three columns if necessary. (Showing 99 trace IDs in one column wouldn't be practical.)
  • TraceIDs are disabled when more than 99 traces are specified. (Otherwise plt would give an error message.)
  • Uses the 'Ystring' parameter to show a continuous readout of the cursor index
  • Uses the 'Xstring' parameter to show a continuous readout of the date and time corresponding to the cursor X position. Note the edit box form is selected by placing a question mark character at the beginning of the string.
  • A popup menu (pseudo object) is created below the x-axis label which allows you to adjust the line thickness. Notice that you can right-click on the popup to increment the line thickness (which sometimes is more convenient than opening the popup menu).
  • A callback is written for the Xstring edit box that moves the cursor to the index with a corresponding time as close as possible to the entered value. For example, try this:
    1. Click on the top trace (which makes it easy to see the cursor).
    2. Enter dates into the edit box - e.g. "30 dec 2006", or "3-jan-07 9:59", etc.
    3. Verify that the cursor moves to the corresponding point.

pltquiv.m

This function demonstrates the plotting of quivers, polynomial interpolation, and the use of several of the plt callback functions (moveCB, TIDcback, MotionEdit).
  • The Pquiv.m function appears three times in the plt argument list to plot three vector fields. The first two vector fields (named velocity1 & velocity2) both have their tail locations specified by f (also plotted on the green trace called humps/20) and the arrow lengths are specified by v1 and v2 respectively. The first of these Pquiv calls is somewhat similar to the Matlab command quiver(real(f),imag(f),real(v1),imag(v1)); The third Pquiv call generates the vector field shown in yellow which includes only six vectors.
  • Uses the xy parameter to make room for long Trace ID names.
  • Uses tex commands (e.g. \uparrow) inside Trace ID names.
  • Reassigns menu box items. In this example, the LinX tag is replaced by a Filter tag. Its buttondown function (which is executed when you click on 'Filter') searches for the 4th trace (using findobj) and swaps the contents of its user data and y-axis data.
  • The 'HelpText' parameter is used to identify features of the plot and to explain how to modify the Hermite interpolated function. This help text disappears as soon as you move one of the yellow arrows (as described in the yellow help text).
  • A grey box is added around the TraceIDs by using the ? prefix to modify the Box, Xcolor, & Ycolor properties of the TraceID axis.
  • Uses NaNs (not a number) to blank out portions of a trace. In this case, the NaNs were inserted into the x coordinate data, although using the y or z coordinates for this purpose works equally as well.
  • Uses the TraceID callback function (TIDcback) to perform an action when you click on a trace ID. For example, when you click on the forth trace ID (humps+rand) this will appear in the command window: "A trace named humps+rand and color [1 0 0] was toggled". Although this TraceID callback is not particularly useful, it was contrived to demonstrate all the @ substitutions.
  • A MotionEdit function is provided which serves these 3 purposes:
    1. The trace data is updated as you drag the edit cursor. Without the MotionEdit function the trace data is only updated when you release the mouse button after the edit cursor has been moved to the desired position. (Trying this on trace 1 will give you a good feel for what this means.)
    2. For the quiver traces, moving the arrow position would not normally move the "v" portion of the arrow head as you would hope. This MotionEdit function solves this problem by calling Pquiv as the arrow is being dragged.
    3. If you move one of the arrows associated with trace 5 (vectorField) then trace 6 is updated based on a polynomial interpolation which is designed to go thru the tails of all six of the trace 5 vectors. The derivatives of this polynomial are also constrained so that it matches the slopes of these vectors as well. Use the data editing feature to move the head or the tail of any of these vectors and watch how the interpolated data on trace 6 (blue) is updated in real time to follow the vector field.

pltsq.m

pltsq.m approximates a square wave by adding up the first five odd harmonics of a sine wave. The plot displays successive sums of these harmonics which approximates a square wave more closely as more harmonics are added together. The key point however (and the reason this demo was created) is that the amplitudes of these sine waves and sums are continually varied (periodically between plus and minus one) to produce a "real-time" moving display. plt is well suited to creating real-time displays, but there are a few concepts to learn and this demo is an excellent starting point.
  • Type pltsq or pltsq(0) to start pltsq in its stopped state. (i.e. the display is not updating)
  • Type pltsq(1) or pltsq('run') to start pltsq with the display dynamically updating.
  • Demonstrates how you can add GUI controls to the plt window - typically something you will need to do when creating plt based applications.
  • Five pseudo popup controls are added to the figure to the left of the plot including one "super-button" to start and stop the plotting.
  • The main display loop is only 6 lines long (lines 96-101) and runs as fast as possible (i.e. with no intentional pauses.) Once every second an additional 9 lines of code is run (lines 86-94) to check for new user input and to report on the display update rate. This additional code could be run every time the display is updated, but that would needlessly slow down the update rate.
  • A text object appears below the plot which displays "updates/second" - a good measure of computational & graphics performance. The color of this text object is toggled every time it is refreshed so that you can tell the speed is being recomputed even if the result is the same.
  • The 'xy' argument is used to make room for the pseudo popups as well as for the wider than usual TraceIDs.
  • The position coordinates for the checkbox and the five popups are grouped in a single array (lines 60-62) which makes it easy to update these coordinates with the plt move function. For details on how this is done, refer to the gui1 & afilt examples.
  • Normalized units are used here for the uicontrols. The "plt move" function also handles pixel units which is useful when you don't want the objects to change size when the figure window is resized.
  • The cursor callback parameter ('moveCB') and the plt('rename') call are used to provide simultaneous cursor readouts for all 5 traces in the TraceID box. This is an unusual use of the TraceID box, but it serves as an alternative to the "multiCursor" option (described here) when you prefer less clutter inside the plot axis. Updating the TraceID box for every display update would slow the display, so normally the cursor is not updated after every display update. However if you want the cursor to be updated on every display, check the box labeled "Live cursor".
  • The 'Options' argument is used to turn off grid lines and to remove the x and y-axis Log selectors from the menu box.
  • You can use the Erasemode popup to explore the effect of the erasemode property on drawing speed. (The erasemode property is no longer supported in Matlab version R2014b or later, so pltsq.m checks the Matlab version and disables the popup appropriately.) You can also effect the drawing speed by varying the number of points per plot from a low of 25 points to a high of 51200 points (32 cycles times 1600 points per cycle).

pltvbar.m

This script demonstrates the use of Pvbar.m and Pebar.m to plot vertical bars and error bars respectively. Some things to note about pltvbar are:
  • The first Pvbar in the argument list plots two functions on a single trace (green) with the 1st function (phase1) defining the position of the bottom of the vertical bars and the 2nd function (phase2) defining the position of the tops of the bars.
  • The second Pvbar in the list plots 3 functions (called serp, bell1, and bell2). The 3 columns of the first Pvbar argument define the x coordinates for those three functions. The next argument (0) indicates that the bottom of all the vertical bars is at y=0. The last Pvbar argument gives the y coordinate for each of the 3 functions (one function per column).
  • The next trace definition (the data argument pair after the 'linewidth') plots two traces corresponding to the two columns of poly23. The 1st column is a 2nd order polynomial and the 2nd column is 3rd order
  • The next trace definition uses Pebar function to create two error bar traces, the first trace defined by the first column of each of the 3 arguments and the second trace defined by the second column.
  • The 'Linewidth' argument appears in the middle of the plt call to change the width of only the traces defined earlier in the argument list.
  • The 'TraceID' argument is used to assign names for each trace that are appropriate for the data being displayed.
  • The 'xy' argument is used to widen the TraceID box to make room for the longer than usual trace ID names
  • The '+FontSize', '+FontWeight', '+FontAngle', '+Xtick', '+Ytick', arguments are used to modify the main axis properties of the same name (without the plus).
  • The Grid pseudo object is used to create a 8x3 table of character data. This table really doesn't have anything to do with the plot (and indeed is just filled with random gibberish), but it was included just to demonstrate an unusual way to use this pseudo object.

pltvar.m



To demonstrate the workspace plotter, this script creates several vectors in the workspace (including a structure containing two vector fields) and then starts the workspace plotter by calling plt with no arguments. Workspace plotting is described here

pub0.m

All the plt examples discussed so far (above) use plotting formats appropriate for data exploration which is the main design goal for plt. However plt can also use formats appropriate for creating plots for publication. This script demonstrates this by creating three different figures windows. Note that all three windows are created by calling pltpub() which calls plt with several parameters optimized for creating publishable plots. (pltpub.m is located in the main plt folder.) pub0 calls pltpub with the optional 'Cpick' parameter which disables all mouse driven panning and zooming and also allows you to change the colors of most of the plot objects simply by clicking on them. Experiment by clicking on the various axes, labels, and lines in the 3 windows created by this program. If it is not obvious how to pick new colors from the ColorPick figure window, read about it in the Pseudo objects section.
  • The first window (plot 1 - appearing near the top of the screen) is a bar chart that demonstrates how to embed the plot data inside the script as comments. It also demonstrates the use of the prin function to display a table of random numbers in a text box. The vertical position of the plot depends on the screen size.
  • The second window (plot 2 - lower left portion of the screen) demonstrates how to distribute 15 functions among 5 subplots by using the 'SubTrace' parameter and how to set the trace colors and line styles.
  • The third window (plot 3 - lower right) contains two traces with error bars, shows how to use the TraceID box as a legend. The special character ']' is used in the first TraceID to disable the shading of the trace name that is normally used to indicate the trace is on the right hand axis. Also the '+XtickLabel' parameter is used in the plt call to remove the tick labels on the x axis. Then an array of text objects are used to create specially formatted tick labels. The third window also demonstrates various ways of modifying the grid lines, and also shows the use of these prefixes:
        Prefix     Object to modify
            +        the left axis
            -        the right axis
            <        the left y-label
            >        the right y-label
            .        the x-label
            "        TraceID text

The three thumbnails to the left were created by shrinking screen captures of the three figure windows created by pub0.m. When you click on any of those thumbnails you will see a .svg image file that was created from the figure's file menu (Save As).

pub1.m



Shows the use of the pltpub command to produce publication quality output and demonstrates some unusual graphics techniques such as multicolored lines and rotating text.
The plot on the left side of the figure draws the solution to the following problem ...

Divide a circle into n congruent parts so that at least one part does not touch the center.
(Hint: as far as I know, the only solution uses n = 12)

The plot on the right side of the figure draws several parametric curves including two Archimedian spirals (in red and blue) and the text is placed along a third Archimedian curve with the font size growing smaller as the text curve spirals inward. The small green curve in the middle of the spirals is known as a hypotrochoid.

This thumbnail was created by shrinking a screen captures of the pub1.m figure window. When you click on this thumbnail you will see a .svg image file that was created from the figure's file menu (Save As).

pub2.m

In this example, a plt figure is created in its usual data exploration mode showing 6 traces of randomly generated data. Each trace contains over 50 thousand data points, although the display is zoomed to show only a small portion of the data. The 'xView' option is used to enable the xView slider which is particularly useful in situations like this where you are viewing only a small portion of a long data record. (The xView slider appears above the primary plot.) The idea is to use the xView slider or other cursor controls to pan and/or zoom the display to some area of interest and then press the "pub" button to generate a figure containing the selected data and optimized for publication.

What makes this more interesting is that when you pan to a new section of the data and again press the "pub" button, the publication figure is redrawn using subplots to show both selected portions. In a like manner, successive presses of the pub button further subdivide the plotting area with each new data range appearing above the previous ones. To reset the pub figure so that only a single axis is plotted simply right-click on the pub button.

The x axis of the data exploration window is plotted in units of days past a time reference (1-Jan-2013 in this example), but custom date ticks are used on the x axis of the publication plot. To reduce clutter, only the day and month are shown for all vertical grid lines except the last one (which includes day, month, & year).

The TraceID box is typically placed to the left of the plot, although for the publication figure in this demo the TraceID box is placed right on top of the plot (more like a legend). This means that sometimes the TraceID box will obscure some of the data, but note that you can easily use the mouse to drag the legend around to a spot that does not interfere with the plot.

This example may seem somewhat contrived - and indeed it was conceived mostly to demonstrate as many unusual plt parameters and programming techniques as possible.

pub3.m

In the previous three demos (pub0, pub1, pub2) we have seen how multiple plots can be created with a single call to plt (either in a single axis as in pub1, or in multiple axes by use of the subplot parameter). This demo also creates multiple plots in a single figure but it uses a separate call to plt for each plot. (This is allowed by using the 'Fig' parameter.) Some of the advantages of this method over using subplots are:
  • Each plot may include a traceID box as well as a right hand axis.
  • The position of the plots are completely general and don't demand fixed column widths as with subplots. (Note that the positions of the four plots in this example would have been difficult to create using subplots.)
  • The cursor for each plot has the full generality and all the options of single plot graphs, unlike the restricted set of cursoring features provided by subplots. This advantage is not relavent for this particular example since cursors have been disable by using the 'Nocursor' option. (Cursors were not needed since the goal of pub3 was to create an uncluttered publication quality result.)
On the other hand, as the number of plots required on the figure increases, the restrictions of the subplots become an advantage because they allow a more compact plot spacing. You may also find the subplot method somewhat simpler to use, but these examples will allow you to compare these trade-offs.

The traceID box is enabled for each plot in this example, primarily as a legend, but it can also be used to enable or disable any trace on the figure.

Note that the 2nd trace of each plot (with traceID "samp") actually consists of 12 superimposed traces. (This is done by separating each of the 12 traces with a NaN element so that a line is not drawn from the end of each trace to the beginning of the next.) This could have been done by using a separate trace for each of the twelve "samp" traces, each with their own traceID, but that would have made the legend unnecessarily large and cumbersome. The blue trace is the average of the 12 superimposed traces and the red trace (markers only) is the standard deviation of those same 12 traces.

The xy parameter contains the positions and sizes of each of the four plots. Note that a -3 is inserted in front of each of these positions. The -3 indicates that this position refers to both the left and right axes and also indicates that the traceID box (and the cursor controls if they were enabled) are to be positioned relative to the positions given for the left and right axes. This is described in the description of the xy parameter in the Axis properties section of the help file.

subplt.m

The 'SubPlot' argument is used to create 3 axes. plt puts a single trace on each axes except for the main (lower) axis which gets all the remaining traces. In this case, since there are 5 traces defined, the main axis has 3 traces. Note that the traces are assigned to the axes from the bottom up so that the last trace (serp) appears on the upper most axis.
  • The 'LabelY' argument defines the y-axis labels for all three axes, again from the bottom up. You can also define the y-axis label for the right hand main axis, by tacking it onto the end of the LabelY array (as done here).
  • The 'Right',2 argument is used to specify that the 2nd trace of the main axis should be put on the right hand axis. If this argument was omitted, plt would still have known that a right hand axis was desired (because of the extra y-label in the LabelY array) however it would have put trace 3 on the right hand axis. (By default, the last trace goes on the right axis).
  • The LineWidth and LineStyle arguments define line characteristics for all 5 traces.
  • The 'TraceMK' parameter enables the trace selection box to show the line characteristics and the 'xy' parameter widens the trace selection box to make room for this.
  • Note that all three plots have their own cursor supporting almost all the cursor features. The exceptions are delta cursors, the xview slider, and the multi-cursor mode. These modes will still be active but they apply only the the main (lower) axis.
  • Only a single x-axis edit box is needed since plt keeps the cursors of all three axes aligned. Also note that if you zoom or pan any of the 3 plots, the other two plots will adjust their x-axis limits to agree.
  • A brief description of this example is added to the screen using the 'HelpText' parameter. As you will see in the other demo programs, the help text is usually removed when you start using the program, but in this case the help text is left in place since it doesn't interfere with the plot area or controls. (However you can toggle the help text on or off by right-clicking on the Help tag in the menu box.)

subplt8.m



This script shows a slight expansion of the ideas found in subplt.m by increasing the number of axes from 3 to 8. The axes are arranged in two columns which allows the use of two different x axes (one for each column).
  • Note that the four axes on the left are synchronized with each other as well as the four on the right, although the left and right halves are independent of each other and have different x axis limits and units.
  • There are 11 traces defined in the plt argument list but only 8 axes are specified. The extra 3 traces go to the main plot (lower left). This means that the first 4 traces are on the main plot and the remaining 7 traces are assigned to the other 7 subplots.
  • Although the black background used in most of the example programs makes it easier to distinguish the trace colors, some people prefer a white background and this script shows how to do that by using the 'ColorDef' parameter to select Matlab's default color scheme. Matlab's default trace color order only includes six colors and this may not be long enough or ordered ideally for a particular graph. The ColorDef parameter may be used to set the trace colors as desired. If (as in this example) the ColorDef parameter is a color specification (3 columns of numbers between zero and one) this color spec is used instead of Matlab's current trace color order default. The first line of this script defines this color order using Matlab's traditional style. The 2nd line defines the exact same color sequence using an alternate style allowed by plt which you may also use if you find that more convenient than the traditional style. There's a special case (not used here) for the first entry in this color array. If it's [.99 .99 .99] (or 999999 in the alternate style) then the remaining colors are appended to the Matlab default color trace order. This may be convenient if for example you just want to add a few colors to the end of the list instead of merely replacing the whole color trace sequence.
  • One advantage of the white background is that it is easier to publish a screen capture since the colors will not need to be inverted. When you click on this thumbnail, you will see a .svg file that was created from the menu bar's File SaveAs menu. (Enable the menu bar by clicking on "Menu" in the menu box). If this svg file was for publishing, we probably would have wanted to reduce the clutter of the figure by temporarily removing all the cursors and their associated controls and readouts. You do this by right-clicking on the y-axis label of the main plot - the one on the lower left. (I didn't do that for the svg file here so you could see all the screen elements.) After creating the svg file you can re-enable the cursors by right-clicking on the y-axis label again.

subplt16.m



This short script again is a slight complication from the previous example (supblt8). Not only do we double the number of axes but we take advantage of all the features of the subplot argument by varying the number of plots in each column as well as adjusting the vertical and horizontal spacings.
  • Note that the whole number parts of the subplot argument specifies the plot widths and heights where as the fractional parts specifies the horizontal and vertical spacing between the plots.
  • So for example the "99.04" near the end of the subplot argument (for the rightmost plot) means that this plot should occupy 99% of the available height. The fractional part means that the space below the graph should be increased by 4 percent of the height of the available plotting area.
  • Also remember that the negative numbers in the subplot argument are used to break up the plots into columns. So for example, the "-25.96" value tells plt that the first column should contain four plots (because it follows four positive numbers). The whole number part (25) means that the first column should use up 25% of the available plotting width. The fractional part (.96) means that we want to reduce the default spacing to the left of this column by 4% of the plotting width. (The default spacing results in a comfortable easy-on-the-eyes layout, but sometimes we want a tighter layout so we can have bigger plots.) For a more complete description of the subplot argument, refer to the Axis properties section as well as the GUI building with plt section of the help file.
  • As in the previous example, the cursors for the various plots in each column are linked to each other, but are not linked in any way to the cursors of the other columns. So for example if you move the cursor in the "tribell" plot (top of column 2) all the cursors of the four plots below it will also move so that they all point to the same x position. Also if you pan or zoom the x-axis of the tribell plot, the x-axis of the four plots below it will also be zoomed or panned so that the x limits remain the same for the entire column. This is what we call the subplot "linked" mode. The unlinked (or "independent") mode is demonstrated in the next example program (subplt20).

subplt20.m



The default subplot "linked" mode (demonstrated by the previous 3 subplot examples) makes sense when the columns share a common x-axis. However in this example the plots do not share a common axis, so the "independent" subplot mode is more appropriate. We tell plt to use the independent mode by putting an "i" after the first number of the subplot argument (Note the "32i" in the subplot argument of this example).
  • The only thing now shared between the columns is space for displaying the cursor values. For example, the x and y edit boxes below the first column display the cursor values for the plot that you last clicked on in that column. The color of these edit boxes changes to match the color of the trace that you clicked on so you can tell at a glance which plot the cursor values refer to.
  • One advantage of the independent mode is that we can fit more plots into a given space. We could probably display these 20 plots using the linked mode as well, but the figure window would have to be very large since in the linked mode a separate y-axis cursor edit box is included for every axis.
  • As with the previous subplot examples, there are more traces than axes (21 traces and 20 axes). That means the first plot (lower left) gets 2 traces and a traceID box is added to allow you to select which one to display (or both).
  • In this example all 21 traces contain the same number of points (301). However this was just done for the convenience of the code generating the fake data to display. Each of the 21 traces could include a different number of points and the script would work equally as well.
  • As you experiment with these plots, be aware of the concept of the "current cursor" (or "current plot" if you prefer) which is important since there are 16 different cursors visible. The current cursor is the cursor belonging to the last plot that you clicked on. When you click on one of the five menu box tags (LinX, LinY, Mark, Zout, XY<->) the appropriate menu box operation will only be applied to the current cursor. Likewise for the up/down arrow buttons (peak/valley finder) as well as the "circle" button which toggles whether markers are positioned over the trace data values. The only exception is the Delta button (delta cursor). This always operates on the main plot (lower left) regardless of which cursor is current.

tasplt.m



This script file creates two plots each consisting of 9 traces. These plt tricks and features are demonstrated:
  • Note that these figures plot multiple valued functions (i.e. relations).
  • The first plot (efficiency and range chart) creates a trace for each column of gph and mpg (9 columns for 9 altitudes)
  • Demonstrates adding an additional axis to show alternate units on the right hand and/or top axis
  • Demonstrates adding text objects to annotate a graph
  • Demonstrates how the cursors in two plots can be linked. Moving one, moves the other. Also in this example switching the active trace in one plot does the same in the other as well.
  • Uses the 'Xstring' and 'Ystring' parameters to display alternate units.
  • Shows how to close both figures when either plot is closed by using the 'Link' parameter.
  • Shows how to use the 'pos' parameter to position two figures as far apart as possible given the available screen area.
  • The 'HelpText' parameter is used to annotate the true airspeed chart with the equations that are used to generate the plotted data.

trigplt.m



This example demonstrates:
  • showing the line characteristics in the TraceID using the TraceMK parameter
  • setting the cursor callback with the moveCB parameter
  • setting axis, TraceID box, and MenuBox positions using the xy parameter
  • setting trace characteristics with the Linewidth, Styles, and Markers parameters
  • setting an initial cursor position
  • enabling the multiCursor mode
  • modifying the colors and fonts of the Trace IDs.
  • The use of the slider pseudo object
  • The use of the plt 'HelpText' parameter to display temporary help information at the top of the plot window. This help text disappears when any parameter is changed but can be re-enabled by clicking on the help button or by right-clicking on the help tag in the MenuBox.
  • Shows how to use inf in the 'Pos' parameter to position the figure in the upper right corner of the screen. In this example an extra 48 pixels is allocated to the title bar so that the menu bar and one toolbar can be enabled without pushing the title bar off the top of the screen.
  • The clipboard button captures the figure as a bitmap into the clipboard
  • Using zeros(6) in the plt call to define 6 traces. The slider callback will overwrite these zeros with the actual data to be displayed. Note that nan(6) would also have worked equally as well for this purpose.
  • Using the ^ButtonD parameter to allow the user to change the axis title color using the ColorPick pseudo object. (Simply click on the axis title.)

weight.m

This script shows another example of putting more than one plot in a single figure. The SubPlot argument is used to create three axes. The lower axis contains four traces showing the magnitude in dB (decibels) of four different weighting functions used in sound level meters (as defined by IEC 651). The middle axis shows the same four traces except using linear units instead of dB as used for the lower axis. The top axis shows the inverse of the linear magnitude traces, which isn't particularly useful except that I wanted to demonstrate plotting three axes in a single figure.
  • Normally plt only puts one trace on each subplot except for the main (lower) axis. So in this case (with 12 traces) plt puts 10 traces on the lower axis and one on the other two. Since we really want 4, 4, and 4, the 'SubTrace' parameter is used partition the traces between the axes as desired.
  • When using the SubTrace parameter the native plt cursor objects will not behave consistently, so normally the cursors will be disabled. Alternatively the program can modify the cursor behavior to make it consistent with the particular SubTrace settings - and this is the approach used in this example. The 'moveCB' cursor callback runs the curCB function which keeps the cursors on all three axes synchronized so that the cursors in the upper two axes automatically move to the same trace and the same x position of the cursor in the main (lower) plot.
  •  The traceID callback ('TIDcback') insures that the traceID box controls the the visibility of the traces in all three axes.
  • Note the 'LineWidth' argument in the plt call. This illustrates how any line property may be included in the calling sequence.

wfall.m

This example has been largely superseded by the following example (wfalltst.m) which uses the general purpose pltwater 3D plotting routine. That's a far easier way to create a waterfall plot, although this example doesn't do that since it was written before pltwater was created. However this example is still included since it may still be a good starting point if you want to develop a special purpose waterfall display that can't be created using pltwater.
  • Demonstrates how to do hidden line removal which makes a waterfall plot much easier to interpret.
  • Type wfall or wfall(0) to start wfall in its stopped state. (i.e. the display is not updating)
  • Type wfall(1) or wfall('run') to start wfall with the display dynamically updating. The funcStart function is used to initiate the dynamic display updates which allows wfall to return to the command prompt while continuing to update the waterfall plot.
  • One trace color (green) is used for all 30 traces ('TraceC' parameter)
  • The 'TraceID' parameter is set to empty to disable the TraceID box.
  • The figure user data is used to pass the handle structure (S) to the callback.
  • Extensive use of the slider pseudo object to control the plotted data.
  • The 'Linesmoothing' option is selected (which surprisingly speeds up the display dramatically on many systems)
  • A pseudo popup in "super-button" mode is used to start and stop the display.
  • The number of display updates per second is calculated every second with the results shown in a large font below the plot.

wfalltst.m

This program demonstrates the use of pltwater, a general purpose 3D plotting utility which is described in the Auxiliary plt functions section.

A surface consisting of a sequence of sync functions is created in a 800 x 200 array (z) which is then passed to pltwater.

We could have called pltwater with just a single argument (z) containing the data, but in this example we have included many additional parameters to tailor the display, including:
  • nT
  • skip
  • x
  • y
all of which are described in the pltwater section of the help file as well as in the comments in pltwater.m. The remaining parameters included in the pltwater command in this example are not unique to pltwater, so they are passed directly to plt and are described in the main plt programming section of the help file. Those parameters include:
  • HelpText
  • TraceC
  • CursorC
  • Title
  • ^Fontsize
  • LabelY
  • xy

winplt.m

Struggling with Matlab's FFT window display tool (wintool), I found it cumbersome and limited. I wanted a way to quickly change window parameters and see the effect on the time and frequency shapes and the most common window measures (scalloping and processing loss, frequency resolution, and equivalent noise bandwidth). I couldn't modify wintool for my taste since most of the code was hidden (pcode). So I wrote winplt.m to create a more useble gui for displaying windows. winplt displays traces showing the time and frequency domain shapes of 31 different FFT windows and also is a tool for designing your own windows by adjusting the kernel coefficients with a slider. You can also use winplt's command line interface to return the window time shapes for use in your Matlab programs.

While working with this application, you may find the IEEE paper on Windows for Harmonic Analysis (by Harris) useful. This is the most cited reference on FFT windows and includes descriptions of most of the windows plotted by winplt. For your convenience, you can get this paper from my website (www.mennen.org) in the section called "Signal processing papers".

Most treatments of FFT windows are highly mathematical (such as the Harris paper). But if you want to understand some of the basic ideas without the many pages of mind numbing equations, take a look at the this portion of a signal processing talk I gave many years ago. The file is called windowsTalk.pdf and you can find it on my web site, right next to the Harris paper mentioned above.

winplt was designed primarily for its signal processing educational value but it is also a good demonstration of the use of plt's pseudo objects and these gui programming techniques:
  • Demonstrates how to provide application specific help from a menu box tag (HelpW  in this example) using the web browser to open an html document as well as by opening a specific topic inside a windows compiled help file (.chm format).
  • Demonstrates a novel use of the pseudo popup object - editing a vector from a gui. (See ID30 - adjust kernel)
  • Shows the power of the prin.m function [creation of the 4 line window parameter block].
  • Demonstrates how to add an application version string (lower right corner of the figure)
For a complete description of the winplt application, its motivation, its command line interface, and its graphical interface, click here.

xChart.m

Data was collected in the t array measuring the performance of 13 different computational and graphics tasks, on an AMD Ryzen9 Windows system with 4 different Matlab versions. All these tasks are from the plt\demo folder except cbench (code specified in help text). Because plt runs in all versions of Matlab since 2001, these demo programs offer a good way to compare graphics performance between Matlab versions. To achieve more consistent results, Windows was rebooted before each version of Matlab was tested.

The rows of the t array that represent time are inverted so that longer bars always represent better performance. Then each row of the "t" array is normalized so that the poorest performing version is given a value of one.

I wouldn't normally overlay so much text over the plot, but in this instance I wanted the data to be self explanatory. If you don't like the colors chosen for any of the text items, click on them and adjust the color with the ColorPick window. (This is possible because pltpub was called with the 'Cpick' argument.)

When you click on this thumbnail you will see a .svg file (scaleable vector graphics) that was created using File-SaveAs from the menu bar.