CL-GRACE
========
An interface between Common Lisp and the Grace 2D plotting program.

REQUIREMENTS
============
Currently only tested with SBCL and Clozure CL.

Requires Grace to be installed on your system. The Grace homepage is at
  http://plasma-gate.weizmann.ac.il/Grace/

INSTALLATION
============
The CL-GRACE system is ASDF installable. It has one dependency: UIOP,
for the WITH-TEMPORARY-FILE form.

USAGE
=====
CL-GRACE works by launching the xmgrace executable as a separate process from
within your lisp session, then sending it commands on the process's standard
input stream.

If the xmgrace executable is not in your path, or otherwise not in the search
path used by your lisp when it starts a process, then set the special variable
  grace:*grace-program*
to the full path of the xmgrace file.

The following is a quick-start guide to the low-level functional API.
To create a new plot (start an xmgrace session) do something like
  (setf p (grace:new-plot))
or to open a previously saved plot (a Grace .agr project file) do
  (setf p (grace:open-plot <pathname-designator>))
then to send commands do
  (grace:send-command p <cmd-string>)
to save the plot do
  (grace:save-plot p <pathname-designator>)
and to close the plot (quit the xmgrace session) do
  (grace:close-plot p)

For a description of commands that Grace understands see the Grace User's Guide.
For some examples of CL-GRACE usage see the examples.lisp file.

The high-level functional API is work-in-progress. It will be documented when
stable.

LICENCE
=======
An MIT-style licence, which essentially means you can use the code in any way
you like as long as you retain the copyright notices. 

KNOWN BUGS
==========
Support for lisps other than SBCL and CCL is missing, patches welcome ...

--
PDO
2 November 2019