;; @module plot.lsp
;; @description Routines for creating data plots.
;; @version 1.1 initial release
;; @version 1.2 allow different length data vectors
;; @version 2.0 added plotXY for plotting data points -> (x, y)
;; @version 2.1 added plot:reset for resetting optional labels and settings
;; @version 2.2 option plot:data-min, plot:data-max did not work
;; @author Lutz Mueller, September 2011, April 2012
;;
;; In its initial release the plot.lsp module can draw
;; simple line plots from one to five data sets. In its simplest
;; form only the plot command is necessary. A group of
;; parameters can be set to further customize the plot. Plots can
;; be save to a graphics file.
;;
;; Load the module using:
;;

(load "plot.lsp")

;; This module runs the newLISP Java based Guiserver. The file
;; guiserver.jar is installed by one of the newLISP binary
;; installers in a standard location. Executing (test-plot)
;; will generate a test plots which can be seen here:
;; @link http://newlisp.org/code/example-line-plot.png line-plot
;; and
;; @link http://newlisp.org/code/example-xy-plot.png XY-plot .
;;
;; Several variables can be set optionally to change the size,
;; and positioning of the plot area in the image.
;; Other variables can be set to control the partioning of the grid,
;; labeling of the horizontal axis and legend.
;; The following list shows all parameters with their default
;; values:
;;

;;
;; Only the the first group of variables is mandatory and preset to
;; the values shown above. Options in the second group will be either
;; suppressed or set automatically.
;; @syntax (plot [ . . . ])
;; @param One to five lists of data points.
;;
;; The function draws one or more horizontal data lines from up
;; to five data sets in . Colors are chosen in the sequence
;; red, green, blue, yellow and purple.
;;