    @gnuplot(data:tab)
    @gnuplot(title:string, data:tab)
    @gnuplot(time:tab, data:tab)
    @gnuplot(title:string, time:tab, data:tab)
    @gnuplot(title1:string, time1:tab, data1:tab, title2: string, time2:tab,
    data2:tab, ...)

The function @gnuplot has a variable number of arguments and cannot be curryfied. It admits five forms. See also @plot and @rplot.

    @gnuplot(data:tab)

The function @gnuplot plots the elements in the `data` tab as a time series. If `data` is a tab of numeric values, a simple curve is plotted: an element `e` of index `i` gives a point of coordinate `(i, e)`. If `data` is a tab of tab (of `p` numeric values), `p` curves are plotted on the same window.

Each @gnuplot invocation lead to a new window. The invocation is done asynchrounously: when the function returns, the plot process is still running for its completion.

Function @gnuplot returns `true` if the plot succeeded, and `false` elsewhere.

To work, the gnuplot program must be installed on the system Cf. http://www.gnuplot.info and must be visible from the Antescofo object (on a Mac system, it can be installed through fink, macport or brew; on linux, it can be installed through the package management system). They are several ways to make this command visible and the search of a gnuplot executable is done in this order:

- set the global variable `$gnuplot_path` to the absolute path of the gnuplot executable (in the form of a string);

- alternatively, set the environment variable `GNUPLOT` of the shell used to launch the Antescofo standalone or the Max/PD host of the Antescofo object, to the absolute path of the gnuplot executable;

- alternatively make visible the gnuplot executable visible from the shell used by the user shell to launch the Antescofo standalone or the Max/PD host of the Antescofo object (e.g. through the `PATH` shell variable).

The command is launched on a shell with the option `-persistent` and the absolute path of the gnuplot command file.

The data are tabulated in a file `/tmp/tmp.antescofo.data.n` (where n is an integer) in a format suitable for gnuplot. The gnuplot commands used to plot the data are in the file `/tmp/tmp.antescofo.gnuplot.n`. These two files persists between two Antescofo session and can then be used to plot with other option.

The @gnuplot function is overloaded and accepts a variety of arguments described below. The @gnuplot function is used internally by the special forms @plot and @rplot.

    @gnuplot(title:string, data:tab)

same as the previous form, but the first argument is used as the label of the plotted curve. If `data` is a tab of tab, (e.g. the history of a tab valued variable), then the label of each curve takes the form `title_i`.

    @gnuplot(time:tab, data:tab)

plots the points `time[i], data[i])`. As for the previous form, `data` can be a tab of tab (of numeric values). The `time` tab corresponds to the `x` coordinates of the plot and must be a tab of numeric values.

    @gnuplot(title:string, time:tab, data:tab)

Same as the previous entry but the first argument is used as the label of the curve(s).

    @gnuplot(title1:string, time1:tab, data1:tab, title2: string, time2:tab,
    data2:tab, ...)

In this variant, several curves are plotted in the same window. One curve is specified by 2 or 3 consecutive arguments. Three arguments are used if the first considered argument is a string: in this case, this argument is the label of the curve. The following argument is used as the `x` coordinates and the next one as the `y` coordinates of the plotted point. The tab arguments must be tab of numeric values (they cannot be tab of tab).

#### Search

From here you can search these documents. Enter your search terms below.