Info Catalog octave: Plot Annotations octave: High-Level Plotting octave: Multiple Plot Windows

octave: Multiple Plots on One Page

 
 15.2.4 Multiple Plots on One Page
 ---------------------------------
 
 Octave can display more than one plot in a single figure.  The simplest
 way to do this is to use the ‘subplot’ function to divide the plot area
 into a series of subplot windows that are indexed by an integer.  For
 example,
 
      subplot (2, 1, 1)
      fplot (@sin, [-10, 10]);
      subplot (2, 1, 2)
      fplot (@cos, [-10, 10]);
 
 creates a figure with two separate axes, one displaying a sine wave and
 the other a cosine wave.  The first call to subplot divides the figure
 into two plotting areas (two rows and one column) and makes the first
 plot area active.  The grid of plot areas created by ‘subplot’ is
 numbered in row-major order (left to right, top to bottom).  After
 plotting a sine wave, the next call to subplot activates the second
 subplot area, but does not re-partition the figure.
 
  -- : subplot (ROWS, COLS, INDEX)
  -- : subplot (RCN)
  -- : subplot (HAX)
  -- : subplot (..., "align")
  -- : subplot (..., "replace")
  -- : subplot (..., "position", POS)
  -- : subplot (..., PROP, VAL, ...)
  -- : HAX = subplot (...)
      Set up a plot grid with ROWS by COLS subwindows and set the current
      axes for plotting (‘gca’) to the location given by INDEX.
 
      If only one numeric argument is supplied, then it must be a three
      digit value specifying the number of rows in digit 1, the number of
      columns in digit 2, and the plot index in digit 3.
 
      The plot index runs row-wise; First, all columns in a row are
      numbered and then the next row is filled.
 
      For example, a plot with 2x3 grid will have plot indices running as
      follows:
 
           +-----+-----+-----+
           |  1  |  2  |  3  |
           +-----+-----+-----+
           |  4  |  5  |  6  |
           +-----+-----+-----+
 
      INDEX may also be a vector.  In this case, the new axes will
      enclose the grid locations specified.  The first demo illustrates
      this:
 
           demo ("subplot", 1)
 
      The index of the subplot to make active may also be specified by
      its axes handle, HAX, returned from a previous ‘subplot’ command.
 
      If the option "align" is given then the plot boxes of the
      subwindows will align, but this may leave no room for axes tick
      marks or labels.
 
      If the option "replace" is given then the subplot axes will be
      reset, rather than just switching the current axes for plotting to
      the requested subplot.
 
      The "position" property can be used to exactly position the subplot
      axes within the current figure.  The option POS is a 4-element
      vector [x, y, width, height] that determines the location and size
      of the axes.  The values in POS are normalized in the range [0,1].
 
      Any property/value pairs are passed directly to the underlying axes
      object.
 
      If the output HAX is requested, subplot returns the axes handle for
      the subplot.  This is useful for modifying the properties of a
      subplot using ‘set’.
 
DONTPRINTYET       See also: axes XREFaxes, plot XREFplot, *notegca:
DONTPRINTYET       See also: axes XREFaxes, plot XREFplot, gca

      XREFgca, set XREFset.
 

Info Catalog octave: Plot Annotations octave: High-Level Plotting octave: Multiple Plot Windows