PLOT(1G)

NAME
plot2fig - a unix plot file to fig code translator.

SYNOPSIS
plot2fig [-option value] ...

DESCRIPTION
plot2fig reads plotting instructions (see plot (5)) from the specified input files and/or the standard input and produces a fig code on it's standard output. This output file can be edited with the fig (Facility for Interactive Generation of figures) graphics editor. The output can subsequently be converted to pictex, postscript, latex, epic, eepic, and tpic languages using the transfig (1) translator. Any unrecognized options on the command line are assumed to be input files. The standard input is read by default only if no other files specified on the command line are successfully opened. A single dash (-) on the command line indicates the standard input is to be read. Each option is set and each file read in the order they are specified on the command line.

This is free software, and you are welcome to redistribute it. Type `plot2fig -warranty' for warranty details and copying conditions.

The byte ordering of two byte integers in unix plot files is machine dependent. Although plot2fig applies a heuristic test to determine the byte ordering and adjusts automaticly, it can be fooled. You can use the -h and -l options to specify the byte ordering explicitly if plot2fig fails to guess correctly.

For compatibility with pic2fig, plot2fig ignores leading white space in labels. Labels containing all white space are ignored.

OPTIONS

-fn NAME

-fontname NAME
    Default: the default font of the transfig output device. This option sets the font for all subsequent text to NAME. Recognized font names are typewriter, modern, italic, bold, and times. In addition, courier is an alias for typewriter and roman is an alias for times. Note that the fonts are device dependent.

-fs SIZE

-fontsize SIZE
    Default: 12. This option sets the size of subsequent text to SIZE (in printer's points).

-h

-high-byte-first
    This option specifies that the byte ordering of two byte integers in the input unix plot file is high byte first.

-l

-low-byte-first
    This option specifies that the byte ordering of two byte integers in the input unix plot file is low byte first.

-warranty

-copying
    This option prints out the copying conditions and warranty information.

-signed

-unsigned
    Default: signed. This option specifies whether two byte integers in the input unix plot file are unsigned or signed.

-   This option specifies explicitly that the standard input should be read for plotting instructions.

SEE ALSO
graph(1G), lpr(1), plot(3X), plot(5), plot3d(1)

EXAMPLES

To create a simple plot file one can use:
    % echo 0 0 1 1 2 0 | spline | graph | plot2fig > test.fig

To edit the plot:
    % fig test.fig

To convert the fig file into dvi code:
    % transfig -L latex test.fig
    % make test.tex
    % cat >t.tex
    \documentstyle{article}
    \begin{document}
    \input{test}
    \end{document}
    % latex t.tex

To edit a plot of data arranged in ordered pairs of x and y coordinates in an ascii file, one can use:
    % graph <asciiDataFile | plot2fig >file.fig
    % fig file.fig

BUGS
This utility is still under development. Comments are criticism are welcome. Richard-Murphey@Rice.edu