All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class ptplot.Pxgraph

java.lang.Object
   |
   +----java.awt.Component
           |
           +----java.awt.Container
                   |
                   +----java.awt.Window
                           |
                           +----java.awt.Frame
                                   |
                                   +----ptplot.Pxgraph

public class Pxgraph

extends Frame

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. 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 commmand line options. A list of these options is given below.

=WxH+X+Y

Specifies the initial size and location of the pxgraph window.

-<digit> <name>

These options specify the data set name for the corresponding data set. The digit should be in the range 0 to 63. This name will be used in the legend.

-bar

Specifies that vertical bars should be drawn from the data points to a base point which can be specified with -brb. Usually, the -nl flag is used with this option. The point itself is located at the center of the bar.

-bb

Draw a bounding box around the data region. This is very useful if you prefer to see tick marks rather than grid lines (see -tk). Unsupported in the Java version.

-bd <color>

This specifies the border color of the pxgraph window. Unsupported in the Java version.

-bg <color>

Background color of the pxgraph window. In the Java version, this argument takes hexadecimal color values (fffff), not color names.

-binary

Data files are in binary format. The -binary argument is the primary difference between xgraph and pxgraph. The Ptolemy Project software makes extensive use of -binary.
The plot commands are encoded as single characters, and the numeric data is a 4 byte float.
The commands are encoded as follows:

d <4byte float> <4byte float>

Draw a X,Y point

e

End of dataset

n <dataset name>\n

New dataset name, ends in \n

m <4byte float> <4byte float>

Move to a X,Y point.

To view a binary plot file under unix, we can use the 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  \0

-brb <base>

This specifies the base for a bar graph. By default, the base is zero. Unsupported in the Java version.

-brw <width>

This specifies the width of bars in a bar graph. The amount is specified in the user units. By default, a bar one pixel wide is drawn.

-bw <size>

Border width (in pixels) of the pxgraph window. Unsupported in the Java version.

-db

Causes xgraph to run in synchronous mode and prints out the values of all known defaults.

-fg <color>

Foreground color. This color is used to draw all text and the normal grid lines in the window. In the Java version, this argument takes hexadecimal color values (fffff), not color names.

-gw

Width, in pixels, of normal grid lines. Unsupported in the Java version.

-gs

Line style pattern of normal grid lines.

-impulses

Draw a line from any plotted point down to the x axis. (This argument is not present in the X11 pxgraph, but it is similar to -nl -bar).

-lf <fontname>

Label font. All axis labels and grid labels are drawn using this font. Note that the Java version does not use X11 style font specification. In the Java version, fonts may be specified as

fontname, where fontname is one of helvetica, TimesRoman, Courier, Dialog, DialogInput, ZapfDingbats.

fontname-style, where style is one of PLAIN, ITALIC, BOLD, i.e. helvetica-ITALIC

fontname-size, or

fontname-style-size, where size is an integer font size in points.

The default is helvetica-PLAIN-12.

-lnx

Specifies a logarithmic X axis. Grid labels represent powers of ten. Unsupported in the Java version.

-lny

Specifies a logarithmic Y axis. Grid labels represent powers of ten. Unsupported in the Java version.

-lw width

Specifies the width of the data lines in pixels. The default is zero. Unsupported in the Java version.

-lx <xl,xh>

This option limits the range of the X axis to the specified interval. This (along with -ly) can be used to zoom in on a particularly interesting portion of a larger graph.

-ly <yl,yh>

This option limits the range of the Y axis to the specified interval.

-m

Mark each data point with a distinctive marker. There are eight distinctive markers used by xgraph. These markers are assigned uniquely to each different line style on black and white machines and varies with each color on color machines.

-M

Similar to -m but markers are assigned uniquely to each eight consecutive data sets (this corresponds to each different line style on color machines).

-nl

Turn off drawing lines. When used with -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.

-p

Marks each data point with a small marker (pixel sized). This is usually used with the -nl option for scatter plots.

-P

Similar to -p but marks each pixel with a large dot.

-rv

Reverse video. On black and white displays, this will invert the foreground and background colors. The behaviour on color displays is undefined.

-t <string>

Title of the plot. This string is centered at the top of the graph.

-tf <fontname>

Title font. This is the name of the font to use for the graph title. See the -lf description above for how to specify fonts. The default is helvetica-BOLD-14

-tk

This option causes 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>

This is the unit name for the X axis. Its default is "X".

-y <unitname>

This is the unit name for the Y axis. Its default is "Y".

-zg <color>

This is the color used to draw the zero grid line. Unsupported in the Java version.

-zw <width>

This is the width of the zero grid line in pixels. Unsupported in the Java version.

Compatibility Issues

This version does not support X resources.

Installation Instructions

The instructions below are for using the Java pxgraph script instead of the X11 pxgraph binary within Ptolemy.

1. Obtain and install a Java Development Kit (JDK) for your platform from www.javasoft.com. Pxgraph works best under JDK1.1.4. Under JDK1.0.2, the Print and About buttons will not work.
2. Obtain the Ptplot tar file from http://ptolemy.eecs.berkeley.edu/java/ptplot.
3. cd to $PTOLEMY/tycho/java and ungzip and untar the tar file:

   cd $PTOLEMY/tycho/java
   gzcat /tmp/ptplot1.0.tar.gz | tar -xf
   

4. The 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.
   If the JAVAHOME environment variable is set, then it is read and $JAVAHOME/lib/classes.zip is used in the classpath. For example, if your JDK was at /opt/jdk1.1.4, then you would add the following to your .cshrc:

   setenv JAVAHOME /opt/jdk1.1.4
   

   
   If JAVAHOME is not set, then the script searches the path and looks for the java binary. If the java binary is found, then the script looks for the appropriate classes.zip to use.
   If none of the above works, you can edit the pxgraph script and change the JAVADEFAULT setting at the top of the file to point to your JDK.
   To find the Ptplot .class files, the script reads the TYCHO and PTOLEMY variables and looks in PTOLEMY/tycho/java/ptplot. 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/ptplot/Pxgraph.class
5. Move the old pxgraph binary to a safe place and create a link to the Java Ptplot pxgraph script.

   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.

Version:

@(#)Pxgraph.java 1.59 10/16/97

Author:

Christopher Hylands (cxh@eecs.berkeley.edu)

See Also:

Plot

---

Pxgraph(String[])

Process the arguments and plot the data.

action(Event, Object)

Handle an Action. Deprecated.

handleEvent(Event)

Handle an event. Deprecated.

keyDown(Event, int)

Handle key down and key up events.

main(String[])

Parse the command line arguments, do any preprocessing, then plot.

Pxgraph

 public Pxgraph(String args[])

Process the arguments and plot the data.

action

 public boolean action(Event e,
                       Object arg)

Note: action() is deprecated. As of JDK1.1 in java.awt.component, but we need to compile under 1.0.2 for netscape3.x compatibility.

Handle an Action.

Overrides:

action in class Component

handleEvent

 public boolean handleEvent(Event e)

Note: handleEvent() is deprecated. As of JDK1.1 in java.awt.component but we need to compile under 1.0.2 for netscape3.x compatibility.

Handle an event.

Overrides:

handleEvent in class Component

keyDown

 public boolean keyDown(Event e,
                        int key)

Handle key down and key up events.

Overrides:

keyDown in class Component

main

 public static void main(String args[])

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.

---

All Packages  Class Hierarchy  This Package  Previous  Next  Index