[ library(gnuplot) | Reference Manual | Alphabetic Index ]

# plot(++Data, +Options, +Format, +OutputFile)

Plots the given data to a file in the given format.

Data
  The data to be plotted, array or list.
Options
  Options list
Format
  Output file format (atom or string)
OutputFile
  Name fo file to store plot in (atom or string)

## Description

Plots the data to a file in the specified format.

The Data can either be a list or a nested list of a 1D or 2D array of y values or x-y points.

The output format is defined as being the 'terminal' setting for gnuplot.

Syntax note: wherever gnuplot expects a string as an option value, use a double-quoted ECLiPSe string - unquoted or single-quoted atoms will not work!.

### Fail Conditions

Options are malformed, or data is not in a valid format.

### Resatisfiable

false

## Examples

    % multiple t-r pairs, in polar coordinates with a grid and lines, into
    % a postscript file
    ?- A=[[1-3,5-2,9-2,8-2,5-7], [1-2,5-4,8-6,9-1,12-4]],
       plot(A,[set:[polar, grid=polar], with:lines], postscript, "polar.ps").

    % multiple t-r pairs, in polar coordinates with a grid and lines, into
    % a postscript file with color
    ?- A=[[1-3,5-2,9-2,8-2,5-7], [1-2,5-4,8-6,9-1,12-4]],
       plot(A,[set:[polar, grid=polar], with:lines], "postscript color", "polar.ps").

    % multiple t-r pairs, in polar coordinates with a grid and lines, into
    % a PNG file
    ?- A=[[1-3,5-2,9-2,8-2,5-7], [1-2,5-4,8-6,9-1,12-4]],
       plot(A,[set:[polar, grid=polar], with:lines], png, "polar.png").

    % multiple t-r pairs, in polar coordinates with a grid and lines, into
    % a XFIG file
    ?- A=[[1-3,5-2,9-2,8-2,5-7], [1-2,5-4,8-6,9-1,12-4]],
       plot(A,[set:[polar, grid=polar], with:lines], fig, "polar.fig").

## See Also

plot / 1, plot / 2, plot / 3