plottable

Generate a graphics plot of the contents of a table given an associated table-handle variable.

Synopsis

plottable(table_handle[, pause][, “gnuplot_cmd1”, “gnuplot_cmd2”, … ])

Parameters inside the [brackets] are optional.

Description

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. MacOS 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.

• 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 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 systems). The following scorefile:

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

generates this kind of plot:

See Also

dumptable, maketable, makeconverter, makefilter, modtable, tablelen, samptable