ptolemy.plot
Class PlotApplication

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--java.awt.Window
                    |
                    +--java.awt.Frame
                          |
                          +--ptolemy.plot.PlotFrame
                                |
                                +--ptolemy.plot.PlotApplication
Direct Known Subclasses:
PlotMLApplication, PxgraphApplication

public class PlotApplication
extends PlotFrame

PlotApplication is a versatile two-dimensional data plotter application. It can read files compatible with the Ptolemy plot file format (currently only ASCII). For a description of the file format, see the Plot and PlotBox classes. Command-line options include:

-help
Print the usage, including all command-line options that exist for backward compatibility and then exit. The help menu choice will display the same information.
-test
Display the plot, then exit after 2 seconds.
-version
Print the program version and then exit. While ptplot is running, the version menu choice will display the same information.

For compatibility with historical applications, this application has a limited ability to read pxgraph files. The command line arguments must be used, and the options that are understood are exactly those of the pxgraph application, plus some more to allow for cross-platform reading. It is not possible to read pxgraph files using the "Open" menu command (because of the cross-platform problems). The additional command-line arguments are:

-bigendian
Data files are in big-endian, or network binary 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.
-littleendian
Data files are in little-endian, or x86 binary 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.

To compile and run this application, do the following:

javac -classpath ../.. PlotApplication.java
java -classpath ../.. ptolemy.plot.PlotApplication

This assumes a particular directory structure. If this is not what you have, then alter the above accordingly.

Version:
$Id: PlotApplication.java,v 1.23 1999/08/19 12:01:51 eal Exp $
Author:
Christopher Hylands and Edward A. Lee
See Also:
Plot, PlotBox, Serialized Form

Field Summary
protected static boolean _test
          If true, then auto exit after a few seconds.
 
Fields inherited from class ptolemy.plot.PlotFrame
_directory, _editMenu, _fileMenu, _filename, _menubar, _specialMenu, plot
 
Fields inherited from class java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Constructor Summary
PlotApplication()
          Construct a plot with no command-line arguments.
PlotApplication(PlotBox plot, java.lang.String[] args)
          Construct a plot with the specified command-line arguments and instance of plot.
PlotApplication(java.lang.String[] args)
          Construct a plot with the specified command-line arguments.
 
Method Summary
protected  void _about()
           
protected  void _close()
          Exit the application.
protected  void _help()
          Display more detailed information than given by _about().
protected  int _parseArgs(java.lang.String[] args)
          Parse the command-line arguments and make calls to the Plot class accordingly.
protected  java.lang.String _usage()
          Return a string summarizing the command-line arguments.
static void main(java.lang.String[] args)
          Create a new plot window and map it to the screen.
 
Methods inherited from class ptolemy.plot.PlotFrame
_editFormat, _export, _open, _print, _read, _save, _saveAs, samplePlot
 
Methods inherited from class java.awt.Frame
addNotify, finalize, getCursorType, getFrames, getIconImage, getMenuBar, getState, getTitle, isResizable, paramString, remove, removeNotify, setCursor, setIconImage, setMenuBar, setResizable, setState, setTitle
 
Methods inherited from class java.awt.Window
addWindowListener, applyResourceBundle, applyResourceBundle, dispose, getFocusOwner, getInputContext, getLocale, getOwnedWindows, getOwner, getToolkit, getWarningString, hide, isShowing, pack, postEvent, processEvent, processWindowEvent, removeWindowListener, setCursor, show, toBack, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, remove, removeAll, removeContainerListener, setFont, setLayout, update, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addPropertyChangeListener, addPropertyChangeListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getInputMethodRequests, getLocation, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isDisplayable, isDoubleBuffered, isEnabled, isFocusTraversable, isLightweight, isOpaque, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, removeComponentListener, removeFocusListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, setSize, setVisible, show, size, toString, transferFocus
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

_test

protected static boolean _test
If true, then auto exit after a few seconds.
Constructor Detail

PlotApplication

public PlotApplication()
                throws java.lang.Exception
Construct a plot with no command-line arguments. It initially displays a sample plot.
Throws:
java.lang.Exception - Not thrown.

PlotApplication

public PlotApplication(java.lang.String[] args)
                throws java.lang.Exception
Construct a plot with the specified command-line arguments.
Parameters:
args - The command-line arguments.
Throws:
java.lang.Exception - If command line arguments have problems.

PlotApplication

public PlotApplication(PlotBox plot,
                       java.lang.String[] args)
                throws java.lang.Exception
Construct a plot with the specified command-line arguments and instance of plot.
Parameters:
plot - The instance of Plot to use.
args - The command-line arguments.
Throws:
java.lang.Exception - If command line arguments have problems.
Method Detail

main

public static void main(java.lang.String[] args)
Create a new plot window and map it to the screen.

_about

protected void _about()
Overrides:
_about in class PlotFrame

_close

protected void _close()
Exit the application.
Overrides:
_close in class PlotFrame

_help

protected void _help()
Display more detailed information than given by _about().
Overrides:
_help in class PlotFrame

_parseArgs

protected int _parseArgs(java.lang.String[] args)
                  throws CmdLineArgException,
                         java.io.FileNotFoundException,
                         java.io.IOException
Parse the command-line arguments and make calls to the Plot class accordingly.
Returns:
The number of arguments read.
Throws:
CmdLineArgException - If a command line argument cannot be parsed.
java.io.FileNotFoundException - If an input file cannot be found.
java.io.IOException - If there is a problem reading an input.

_usage

protected java.lang.String _usage()
Return a string summarizing the command-line arguments.
Returns:
A usage string.