Method ao/gnuplot


  GNUPLOT a gnuplot interface for AOs.
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
  DESCRIPTION: IPLOT provides an intelligent plotting tool for LTPDA.
 
  CALL:               filenames = gnuplot(a,pl)
 
  INPUTS:      pl   - a parameter list
               a    - input analysis objects
 
  OUTPUTS:     filenames - if gnuplot is configured to output files, then
                           the filenames are returned here.
 
  
  NOTE: this method requires gnuplot to be installed on the system. The
  path to the gnuplot binary can be set in the input plist with the key
  'GNUPLOT'.
  
  gnuplot: http://www.gnuplot.info/
  
  AO Plot Info
  ------------
  
  If an input AO has a filled plotinfo plist, then the options contained in
  therein will overide any other options. The recognised keys are:
  
    'linestyle', 'linewidth', 'color', 'marker', 'legend_on'
  
  The possible values are all those accepted by plot.
  
  
  EXAMPLES:
 
  1) Plot two time-series AOs on the same plot and output to a PDF file
 
       gnuplot(a1, a2, plist('terminal', 'pdf enhanced', ...
              'output', outfile, ...
              'preamble', {'set title "my nice plot"', 'set key outside top right'}, ...
              'markerscale', 3))
 
  2) Plot two time-series AOs in subplots. If the AOs have markers set in
     the plotinfo, they will be scaled in size x3 from default.
 
     gnuplot(a1, a2, plist('arrangement', 'subplots', 'terminal', 'pdf enhanced', ...
             'output', outfile, ...
             'preamble', {'set title "my nice plot"', 'set key outside top right'}, ...
             'markerscale', 3))
 
  3) Plot two time-series AOs, each to its own output pdf file.
 
    gnuplot(a1, a2, plist('arrangement', 'single', 'terminal', 'pdf enhanced', ...
           'output', outfile, 'outdir', '.', ...
           'preamble', {'set title "my nice plot"', 'set key outside top right'}, ...
           'markerscale', 3))
 
 
  Parameters Description
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
Method Details
Access public
Defining Class ao
Sealed 0
Static 0

Parameter Description

Default

no description
Key Default Value Options Description
GNUPLOT '/opt/local/bin/gnuplot' none The path to the gnuplot binary.
OUTPUTDIR '' none The output directory to be used in the case of writing output files.
OUTPUT '' none The output filename for the given terminal type.

An empty output will result in the output being sent to the terminal.
TERMINAL 'pdf' none Choose one of the gnuplot supported terminal types.
TERMINAL OPTIONS 'color enhanced fsize 14 size 24cm,16cm' none Additional terminal options.
PREAMBLE {} [0x0] none A cell-array of gnuplot commands which are inserted before the plotting but after the basic commands.
ERRORBARS 0
  • 0
  • 1
If the AO has errors, plot them as errorbars.
ARRANGEMENT 'stacked'
  • 'stacked'
  • 'single'
  • 'subplots'
Chose how to plot multiple AOs:

  • on one plot (stacked)
  • on separate plots (single)
  • on subplots (subplots)

In the case of 'single', if you use an
output file, then each file will be appended with a number, e.g., foo_1.pdf, foo_2.pdf.
MARKERSCALE 1 none Scale the size of the markers by an integer amount.
back to top back to top

Some information of the method ao/gnuplot are listed below:
Class name ao
Method name gnuplot
Category Output
Package name ltpda
VCS Version 3542afe99dea25c636b7ac3b82a9f6f8be9d447d
Min input args 1
Max input args -1
Min output args 1
Max output args -1




©LTP Team