plottable - plot the contents of a table

plottable - generate a graphics plot of the contents of a table given an associated table-handle variable

plottable(table_handle[, pause][, "gnuplot_cmd1", "gnuplot_cmd2", ... ])

Parameters inside the [brackets] are optional.

plottable is a useful utility that will create a graphics plot of a table associated with a particular table-handle. The plot appears in a separate window, and uses the public-domain gnuplot program. Macintosh OS X users will also need to have the public-domain aquaterm package installed for gnuplot to run correctly.

ARGUMENTS

table_handle: The table-handle identifier for the table to be plotted.

pause

The length of time (in seconds) to display the plot before proceeding with scorefile processing. The default is 10 seconds.

NOTE: Under MacOS X, using Aquaterm to display the output

has no effect. Also, you can only do one plot per run of RTcmix under OS X, because

dies if there's already another one running.

gnuplot_cmd1, ... gnuplot_cmdN

These optional string arguments are plotting commands that gnuplot may use to modify the generated graph. See the gnuplot documentation for more information about these commands. The default is "with lines".

If something goes wrong with the gnuplot syntax, there'll be some leftover files in the /tmp directory, with names like "rtcmix_plot_data_xAb5x8."

EXAMPLES

   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, 30)

The above score will produce the following plot in a separate window (it will appear for 30 seconds on non MacOS X systems):

This scorefile:

   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, 15, "with points")

will produce this plot:

and display it for 15 seconds (on non MacOS X systems). The following scorefile:

   table = maketable("wave", 1000, 1, 0.1, 0.3)
   plottable(table, "with impulses")

generates this kind of plot: