pxgraph X Windows system program.
The pxgraph script is a Bourne shell script that
attempts to call Java with the proper environment. The
pxgraph script has the following usage:
pxgraph [ options ] [ =WxH+X+Y ] [file . . .]
Below we describe the pxgraph arguments. The
text is based on the xgraph Unix man page written
by David Harrison (University of California).
To see the command line options, you can type
pxgraph -help.
The pxgraph program draws a graph on a display given data
read from either data files or from standard input if no
files are specified. It can display up to 64 independent
data sets using different colors and/or line styles for each
set. It annotates the graph with a title, axis labels,
grid lines or tick marks, grid labels, and a legend. There
are options to control the appearance of most components of
the graph.
The input format is similar to graph(1G) but differs
slightly. The data consists of a number of data sets. Data
sets are separated by a blank line. A new data set is also
assumed at the start of each input file. A data set consists
of an ordered list of points of the form directive
X Y.
The directive is either draw or move and can
be omitted (Note that with binary data files, you must have a directive,
the above statement only applies to ascii format data files). If the
directive is draw, a line will be drawn
between the previous point and the current point (if a line
graph is chosen). Specifying a move directive tells
xgraph not to draw a line between the points. If the directive
is omitted, draw is assumed for all points in a data
set except the first point where move is assumed. The
move directive is used most often to allow discontinuous
data in a data set.
After pxgraph has read the data, it will create a new window
to graphically display the data.
Once the window has been opened, all of the data sets will
be displayed graphically (subject to the options explained
below) with a legend in the upper right corner of the
screen. To zoom in on a portion of the graph, depress a
mouse button in the window and sweep out a region. pxgraph
will then the window will be redrawn with just that portion of
the graph. pxgraph also presents four control buttons in
the lower left corner of each window: Exit,
Print, HTML and About.
The Exit button will exit the process. You can also
type Control-D, Control-C or q
to exit.
The Print button brings up a print dialog window.
The About button brings up a message about
pxgraph.
The HTML button prints an HTML file to stdout that
can be used to display the file with applet Plot classes
(Experimental).
pxgraph accepts a large number of command line options.
A list of these options is given below.
=WxH+X+Y
-<digit> <name>
-bar
-brb.
Usually, the -nl flag is used with this option.
The point itself is located at the center of the bar.
-bb
-tk).
Ignored in the Java version because the plotting area is a different
color than the border where the axes are labeled.
-bd <color>
pxgraph window.
Unsupported in the Java version.
-bg <color>
fffff), not color names. Note that the background
of the data plotting region is always white because the dataset colors
were designed for a white background.
-bigendian
-binary command line argument documentation
below for details about the format.
If you are on a little-endian machine, such as a machine
with an Intel x86 chip, and you would like to read a binary
format file, created on a big-endian machine, such as a Sun SPARC,
use the -bigendian flag.
-binary
-binary
argument is the primary difference between xgraph
and pxgraph. The
Ptolemy Project software
makes extensive use of -binary.
d, then
we assume that the file contains 4 byte floats in big-endian ordering
with no plot commands.
d, then
we assume that the plot commands are encoded as single characters,
and the numeric data is a 4 byte float encoded in the
native endian format of the machine that the java interpreter is
running on.
d <4byte float> <4byte float>
e
n <dataset name>\n
\n
m <4byte float> <4byte float>
od command. Note that the first character is a d
followed by eight bytes of data consisting of two floats of four bytes.
cxh@carson 324% od -c data/integrator1.plt 0000000 d \0 \0 \0 \0 \0 \0 \0 \0 d ? 200 \0 \0 ? 200 0000020 \0 \0 d @ \0 \0 \0 @ , 314 315 d @ @ \0 \0For further information about endian-ism, see the
-bigendian and -littleendian command
line argument documentation.
-brb <base>
-brw <width>
-bw <size>
pxgraph window.
Unsupported in the Java version.
-db
-fg <color>
fffff), not color names.
-gw -gs -impulses pxgraph,
but it is similar to -nl -bar).
-lf <fontname>
helvetica-PLAIN-12.
-littleendian
-binary command line argument documentation
above for details about the format.
If you are on a big-endian machine, such as a Sun Sparc,
and you would like to read a binary
format file created on a little-endian machine, such as Intel x86
machine, then use the -littleendian flag.
-lnx -lnx is present, then
x values must be greater than zero.
-lny -lny is present, then
y values must be greater than zero.
-lw width -lx <xl,xh> -ly) can be used
to zoom in on a particularly interesting portion of a
larger graph.
-ly <yl,yh> -m -M
-m but markers are assigned uniquely to each
eight consecutive data sets (this corresponds to each
different line style on color machines).
-nl
-m,
-M, -p, or -P this can be used
to produce scatter plots. When used with -bar, it can be used to
produce standard bar graphs.
-o output filename
/tmp/t.ps. See also the
-print option.
-p
-P
-p but marks each pixel with a large dot.
-print
Ok button. See also the -o option.
-rv
-t <string>
-tf <fontname>
-lf description above
for how to specify fonts.
The default is helvetica-BOLD-14
-tk
pxgraph to draw tick marks rather
than full grid lines. The -bb option is also useful
when viewing graphs with tick marks only.
-x <unitname>
-y <unitname>
-zg <color>
-zw <width>
xgraph program allowed many formatting
directives inside the file. This version only supports
draw and move.
xgraph program allowed blank lines
to separate datasets. This version does not. Instead, use the
move X Y directive.
pxgraph takes longer to start up
than the X11 version. This is an inherent problem with standalone
Java applications. One guess is that most of the startup time comes
from paging in the shared libraries.
pxgraph
script instead of the X11 pxgraph binary within Ptolemy.
www.javasoft.com.
Pxgraph works best under JDK1.1.6.
http://ptolemy.eecs.berkeley.edu/java/ptplot.
cd to $PTOLEMY/tycho/java and ungzip and
untar the tar file:
cd $PTOLEMY/tycho/java gzcat /tmp/ptolemy.plot2.0.tar.gz | tar -xf
pxgraphshell script reads
a few environment variables and attempts to run. For the script to
run, it needs to find the location of the Java JDK installation and
the location of the Ptplot .class files.
To find the Ptplot .class files, the script reads the
TYCHO and PTOLEMY variables and looks in
PTOLEMY/tycho/java/ptolemy.plot. If you do not have Ptolemy
or Tycho installed, you can edit the pxgraph script
and change TYDEFAULT so that the Pxgraph.class
file will be found at $TYDEFAULT/java/ptolemy.plot/Pxgraph.class
pxgraph binary to a safe place and
create a link to the Java Ptplot pxgraph scriptolemy.
cd $PTOLEMY/bin.$PTARCH mv pxgraph pxgraph.x11 ln -s ../tycho/java/plot/pxgraph .
For further information about this tool, see the
Java Plot Website.
* @author Christopher Hylands http://ptolemy.eecs.berkeley.edu/~cxh
* @version $Id: Pxgraph.java,v 1.108a 1998/12/11 03:52:20 cxh Exp $
* @see Plot
*/
public class Pxgraph extends Frame {
/** Process the arguments and plot the data.
*/
public Pxgraph(String args[]) {
//setLayout(new FlowLayout(FlowLayout.LEFT));
//setLayout(new BorderLayout());
_plotPanel = new Plot();
_makeButtons();
_debug = 0;
// Regrettably, in JDK 1.1, you have to explicitly handle window
// closing events.
addWindowListener(new WindowAdapter() {
public void windowClosing(WindowEvent e) {
// Strangely, calling _exit() here sends javac into
// an infinite loop (in jdk 1.1.4).
// _exit();
System.exit(0);
}
});
// Inner class to handle keystrokes
_plotPanel.addKeyListener (new KeyAdapter() {
public void keyPressed(KeyEvent event) {
char c = (char) event.getKeyChar();
System.out.println("Pxgraph: got '" + c +"'");
switch (c) {
case '\003': // Control-C
case '\004': // Control-D
case 'q':
System.exit(0);
break;
case 'x':
// Used for debugging, brings up pxgraph.x11.
_pxgraphX11();
break;
}
}
});
pack();
add("Center",_plotPanel);
try {
_parseArgs(args);
} catch (CmdLineArgException e) {
System.err.println("Failed to parse command line arguments: " + e);
} catch (FileNotFoundException e) {
System.err.println("File not found in command line: " + e);
} catch (IOException e) {
System.err.println("Error while reading input file: " + e);
}
show();
_plotPanel.setButtons(true);
if (_printDialog) {
// -print option
_print();
}
}
/** Parse the command line arguments, do any preprocessing, then plot.
* If you have the pxgraph shell script, then
* type pxgraph -help for the complete set of arguments.
*/
public static void main(String args[]) {
Pxgraph pxgraph = new Pxgraph(args);
// If the -test arg was set, then exit after 2 seconds.
if (_test) {
if (_debug > 4) System.out.println("Sleeping for 2 seconds");
try {
Thread.currentThread().sleep(2000);
}
catch (InterruptedException e) {
}
System.exit(0);
}
}
/** Write the current data and plot configuration to the
* specified stream.
*/
public void write(OutputStream out) {
_plotPanel.write(out);
}
///////////////////////////////////////////////////////////////////
//// private methods ////
/* Bring up a dialog box with version information.
*/
private void _about() {
Message message = new Message(
" Pxgraph\n" +
" A Java Plotting Tool\n\n" +
"By: Edward A. Lee, http://ptolemy.eecs.berkeley.edu/~eal and\n " +
"Christopher Hylands, http://ptolemy.eecs.berkeley.edu/~cxh\n" +
"Version 2.0, Build: $Id: Pxgraph.java,v 1.108a 1998/12/11 03:52:20 cxh Exp $\n\n"+
"For help, type 'pxgraph -help', or see \n" +
"the Pxgraph class documentation.\n" +
"For more information, see\n" +
"http://ptolemy.eecs.berkeley.edu/java/ptplot\n");
message.setTitle("About Pxgraph");
message.pack();
message.show();
}
/* help - print out help
*/
private void _help() {
// FIXME: we should bring up a dialog box or something.
// We use a table here to keep things neat.
// If we have:
// {"-bd", "