utils.ptplot5_2.ptolemy.plot
Class PlotBox

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JPanel
                          |
                          +--utils.ptplot5_2.ptolemy.plot.PlotBox
All Implemented Interfaces:
javax.accessibility.Accessible, java.awt.image.ImageObserver, java.awt.MenuContainer, java.awt.print.Printable, java.io.Serializable
Direct Known Subclasses:
Histogram, Plot, Render

public class PlotBox
extends javax.swing.JPanel
implements java.awt.print.Printable

This class provides a labeled box within which to place a data plot. A title, X and Y axis labels, tick marks, and a legend are all supported. Zooming in and out is supported. To zoom in, drag the mouse downwards to draw a box. To zoom out, drag the mouse upward.

The box can be configured either through a file with commands or through direct invocation of the public methods of the class.

When calling the methods, in most cases the changes will not be visible until paintComponent() has been called. To request that this be done, call repaint().

A small set of key bindings are provided for convenience. They are:

These commands are provided in a menu by the PlotFrame class. Note that exporting to the clipboard is not allowed in applets (it used to be), so this will result in an error message.

At this time, the two export commands produce encapsulated postscript tuned for black-and-white printers. In the future, more formats may supported. Exporting to the clipboard and to standard output, in theory, is allowed for applets, unlike writing to a file. Thus, these key bindings provide a simple mechanism to obtain a high-resolution image of the plot from an applet, suitable for incorporation in a document. However, in some browsers, exporting to standard out triggers a security violation. You can use Sun's appletviewer instead.

To read commands from a file or URL, the preferred technique is to use one of the classes in the plotml package. That package supports both PlotML, an XML extension for plots, and a historical file format specific to ptplot. The historical file format is understood by the read() method in this class. The syntax of the historical format, documented below, is rudimentary, and will probably not be extended as ptplot evolves. Nonetheless, we document it here since it is directly supported by this class.

The historical format for the file allows any number commands, one per line. Unrecognized commands and commands with syntax errors are ignored. Comments are denoted by a line starting with a pound sign "#". The recognized commands include:

 TitleText: string
 XLabel: string
 YLabel: string
 
These commands provide a title and labels for the X (horizontal) and Y (vertical) axes. A string is simply a sequence of characters, possibly including spaces. There is no need here to surround them with quotation marks, and in fact, if you do, the quotation marks will be included in the labels.

The ranges of the X and Y axes can be optionally given by commands like:

 XRange: min, max
 YRange: min, max
 
The arguments min and max are numbers, possibly including a sign and a decimal point. If they are not specified, then the ranges are computed automatically from the data and padded slightly so that datapoints are not plotted on the axes.

The tick marks for the axes are usually computed automatically from the ranges. Every attempt is made to choose reasonable positions for the tick marks regardless of the data ranges (powers of ten multiplied by 1, 2, or 5 are used). However, they can also be specified explicitly using commands like:

 XTicks: label position, label position, ...
 YTicks: label position, label position, ...
 
A label is a string that must be surrounded by quotation marks if it contains any spaces. A position is a number giving the location of the tick mark along the axis. For example, a horizontal axis for a frequency domain plot might have tick marks as follows:
 XTicks: -PI -3.14159, -PI/2 -1.570795, 0 0, PI/2 1.570795, PI 3.14159
 
Tick marks could also denote years, months, days of the week, etc.

The X and Y axes can use a logarithmic scale with the following commands:

 XLog: on
 YLog: on
 
The grid labels represent powers of 10. Note that if a logarithmic scale is used, then the values must be positive. Non-positive values will be silently dropped. Note further that when using logarithmic axes that the log of input data is taken as the data is added to the plot. This means that
XLog: on
or
YLog: on
should appear before any data. Also, the value of the XTicks or YTicks directives should be in log units. So,
XTicks: 1K 3
will display the string
1K
at the 1000 mark.

By default, tick marks are connected by a light grey background grid. This grid can be turned off with the following command:

 Grid: off
 
It can be turned back on with
 Grid: on
 
Also, by default, the first ten data sets are shown each in a unique color. The use of color can be turned off with the command:
 Color: off
 
It can be turned back on with
 Color: on
 
Finally, the rather specialized command
 Wrap: on
 
enables wrapping of the X (horizontal) axis, which means that if a point is added with X out of range, its X value will be modified modulo the range so that it lies in range. This command only has an effect if the X range has been set explicitly. It is designed specifically to support oscilloscope-like behavior, where the X value of points is increasing, but the display wraps it around to left. A point that lands on the right edge of the X range is repeated on the left edge to give a better sense of continuity. The feature works best when points do land precisely on the edge, and are plotted from left to right, increasing in X.

All of the above commands can also be invoked directly by calling the the corresponding public methods from some Java procedure.

This class uses features of JDK 1.2, and hence if used in an applet, it can only be viewed by a browser that supports JDK 1.2, or a plugin.

Since:
Ptolemy II 0.2
Version:
$Id: PlotBox.html,v 1.1.1.1 2003/07/10 12:20:41 dsagnol Exp $
Author:
Edward A. Lee, Christopher Hylands, Contributors: Jun Wu (jwu@inin.com.au), William Wu, Robert Kroeger
See Also:
Serialized Form

Nested Class Summary
 class PlotBox.DragListener
           
 class PlotBox.ZoomListener
           
 
Nested classes inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Field Summary
 java.net.URL _documentBase
           
static java.lang.String PTPLOT_RELEASE
           
 
Fields inherited from class javax.swing.JComponent
TOOL_TIP_TEXT_KEY, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface java.awt.print.Printable
NO_SUCH_PAGE, PAGE_EXISTS
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
PlotBox()
          Construct a plot box with a default configuration.
 
Method Summary
 void addLegend(int dataset, java.lang.String legend)
          Add a legend (displayed at the upper right) for the specified data set with the specified string.
 void addXTick(java.lang.String label, double position)
          Specify a tick mark for the X axis.
 void addYTick(java.lang.String label, double position)
          Specify a tick mark for the Y axis.
 void clear(boolean axes)
          If the argument is true, clear the axes.
 void clearLegends()
          Clear all legends.
 void deferIfNecessary(java.lang.Runnable action)
          If this method is called in the event thread, then simply execute the specified action.
 void export(java.io.OutputStream out)
          Export a description of the plot.
 java.awt.image.BufferedImage exportImage()
          Create a BufferedImage and draw this plot to it.
 java.awt.image.BufferedImage exportImage(java.awt.image.BufferedImage bufferedImage)
          Draw this plot onto the provided image.
 java.awt.image.BufferedImage exportImage(java.awt.image.BufferedImage bufferedImage, java.awt.Rectangle rectangle, java.awt.RenderingHints hints, boolean transparent)
          Draw this plot onto the specified image at the position of the specified rectangle with the size of the specified rectangle.
 java.awt.image.BufferedImage exportImage(java.awt.Rectangle rectangle)
          Create a BufferedImage the size of the given rectangle and draw this plot to it at the position specified by the rectangle.
 void fillPlot()
          Rescale so that the data that is currently plotted just fits.
 boolean getColor()
          Return whether the plot uses color.
static java.awt.Color getColorByName(java.lang.String name)
          Convert a color name into a Color.
 java.lang.String getDataurl()
          Deprecated.  
 java.net.URL getDocumentBase()
          Deprecated.  
 boolean getGrid()
          Return whether the grid is drawn.
 java.lang.String getLegend(int dataset)
          Get the legend for a dataset, or null if there is none.
 java.awt.Dimension getMaximumSize()
          If the size of the plot has been set by setSize(), then return that size.
 java.awt.Dimension getMinimumSize()
          Get the minimum size of this component.
 java.awt.Dimension getPreferredSize()
          Get the preferred size of this component.
 java.lang.String getTitle()
          Get the title of the graph, or an empty string if there is none.
 java.lang.String getXLabel()
          Get the label for the X (horizontal) axis, or null if none has been set.
 boolean getXLog()
          Return whether the X axis is drawn with a logarithmic scale.
 double[] getXRange()
          Get the X range.
 java.util.Vector[] getXTicks()
          Get the X ticks that have been specified, or null if none.
 java.lang.String getYLabel()
          Get the label for the Y (vertical) axis, or null if none has been set.
 boolean getYLog()
          Return whether the Y axis is drawn with a logarithmic scale.
 double[] getYRange()
          Get the Y range.
 java.util.Vector[] getYTicks()
          Get the Y ticks that have been specified, or null if none.
 void init()
          Deprecated.  
 void paintComponent(java.awt.Graphics graphics)
          Paint the component contents, which in this base class is only the axes.
 void parseFile(java.lang.String filespec)
          Deprecated.  
 void parseFile(java.lang.String filespec, java.net.URL documentBase)
          Deprecated. This method is deprecated. Use read() instead.
 int print(java.awt.Graphics graphics, java.awt.print.PageFormat format, int index)
          Print the plot to a printer, represented by the specified graphics object.
 void read(java.io.InputStream in)
          Read commands and/or plot data from an input stream in the old (non-XML) file syntax.
 void read(java.lang.String command)
          Read a single line command provided as a string.
 void removeLegend(int dataset)
          Remove the legend (displayed at the upper right) for the specified data set.
 void resetAxes()
          Reset the X and Y axes to the ranges that were first specified using setXRange() and setYRange().
 void samplePlot()
          Do nothing in this base class.
 void setBackground(java.awt.Color background)
          Set the background color.
 void setBounds(int x, int y, int width, int height)
          Move and resize this component.
 void setButtons(boolean visible)
          If the argument is true, make a fill button visible at the upper right.
 void setColor(boolean useColor)
          If the argument is false, draw the plot without using color (in black and white).
 void setDataurl(java.lang.String filespec)
          Deprecated.  
 void setDocumentBase(java.net.URL documentBase)
          Deprecated.  
 void setForeground(java.awt.Color foreground)
          Set the foreground color.
 void setGrid(boolean grid)
          Control whether the grid is drawn.
 void setLabelFont(java.lang.String name)
          Set the label font, which is used for axis labels and legend labels.
 void setSize(int width, int height)
          Set the size of the plot.
 void setTitle(java.lang.String title)
          Set the title of the graph.
 void setTitleFont(java.lang.String name)
          Set the title font.
 void setWrap(boolean wrap)
          Specify whether the X axis is wrapped.
 void setXLabel(java.lang.String label)
          Set the label for the X (horizontal) axis.
 void setXLog(boolean xlog)
          Specify whether the X axis is drawn with a logarithmic scale.
 void setXRange(double min, double max)
          Set the X (horizontal) range of the plot.
 void setYLabel(java.lang.String label)
          Set the label for the Y (vertical) axis.
 void setYLog(boolean ylog)
          Specify whether the Y axis is drawn with a logarithmic scale.
 void setYRange(double min, double max)
          Set the Y (vertical) range of the plot.
 void write(java.io.OutputStream out)
          Write the current data and plot configuration to the specified stream in PlotML syntax.
 void write(java.io.OutputStream out, java.lang.String dtd)
          Write the current data and plot configuration to the specified stream in PlotML syntax.
 void write(java.io.Writer out, java.lang.String dtd)
          Write the current data and plot configuration to the specified stream in PlotML syntax.
 void writeData(java.io.PrintWriter output)
          Write plot data information to the specified output stream in PlotML.
 void writeFormat(java.io.PrintWriter output)
          Write plot format information to the specified output stream in PlotML.
 void writeOldSyntax(java.io.OutputStream out)
          Deprecated.  
 void zoom(double lowx, double lowy, double highx, double highy)
          Zoom in or out to the specified rectangle.
 
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, setUI, updateUI
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintImmediately, paintImmediately, print, printAll, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setLayout, transferFocusBackward, transferFocusDownCycle, validate
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, createImage, createImage, createVolatileImage, createVolatileImage, dispatchEvent, enable, enableInputMethods, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

PTPLOT_RELEASE

public static final java.lang.String PTPLOT_RELEASE
See Also:
Constant Field Values

_documentBase

public java.net.URL _documentBase
Constructor Detail

PlotBox

public PlotBox()
Construct a plot box with a default configuration.

Method Detail

addLegend

public void addLegend(int dataset,
                      java.lang.String legend)
Add a legend (displayed at the upper right) for the specified data set with the specified string. Short strings generally fit better than long strings. If the string is empty, or the argument is null, then no legend is added.

Parameters:
dataset - The dataset index.
legend - The label for the dataset.

addXTick

public void addXTick(java.lang.String label,
                     double position)
Specify a tick mark for the X axis. The label given is placed on the axis at the position given by position. If this is called once or more, automatic generation of tick marks is disabled. The tick mark will appear only if it is within the X range.

Parameters:
label - The label for the tick mark.
position - The position on the X axis.

addYTick

public void addYTick(java.lang.String label,
                     double position)
Specify a tick mark for the Y axis. The label given is placed on the axis at the position given by position. If this is called once or more, automatic generation of tick marks is disabled. The tick mark will appear only if it is within the Y range.

Parameters:
label - The label for the tick mark.
position - The position on the Y axis.

clear

public void clear(boolean axes)
If the argument is true, clear the axes. I.e., set all parameters controlling the axes to their initial conditions. For the change to take effect, call repaint(). If the argument is false, do nothing.

Parameters:
axes - If true, clear the axes parameters.

clearLegends

public void clearLegends()
Clear all legends. This will show up on the next redraw.


deferIfNecessary

public void deferIfNecessary(java.lang.Runnable action)
If this method is called in the event thread, then simply execute the specified action. Otherwise, if there are already deferred actions, then add the specified one to the list. Otherwise, create a list of deferred actions, if necessary, and request that the list be processed in the event dispatch thread. Note that it does not work nearly as well to simply schedule the action yourself on the event thread because if there are a large number of actions, then the event thread will not be able to keep up. By grouping these actions, we avoid this problem. This method is not synchronized, so the caller should be.

Parameters:
action - The Runnable object to execute.

export

public void export(java.io.OutputStream out)
Export a description of the plot. Currently, only EPS is supported. But in the future, this may cause a dialog box to open to allow the user to select a format. If the argument is null, then the description goes to the clipboard. Otherwise, it goes to the specified file. To send it to standard output, use System.out as an argument.


exportImage

public java.awt.image.BufferedImage exportImage()
Create a BufferedImage and draw this plot to it. The size of the returned image matches the current size of the plot. This method can be used, for example, by a servlet to produce an image, rather than requiring an applet to instantiate a PlotBox.

Returns:
An image filled by the plot.

exportImage

public java.awt.image.BufferedImage exportImage(java.awt.Rectangle rectangle)
Create a BufferedImage the size of the given rectangle and draw this plot to it at the position specified by the rectangle. The plot is rendered using anti-aliasing.

Parameters:
rectangle - The size of the plot. This method can be used, for example, by a servlet to produce an image, rather than requiring an applet to instantiate a PlotBox.
Returns:
An image containing the plot.

exportImage

public java.awt.image.BufferedImage exportImage(java.awt.image.BufferedImage bufferedImage,
                                                java.awt.Rectangle rectangle,
                                                java.awt.RenderingHints hints,
                                                boolean transparent)
Draw this plot onto the specified image at the position of the specified rectangle with the size of the specified rectangle. The plot is rendered using anti-aliasing. This can be used to paint a number of different plots onto a single buffered image. This method can be used, for example, by a servlet to produce an image, rather than requiring an applet to instantiate a PlotBox.

Parameters:
bufferedImage - Image onto which the plot is drawn.
rectangle - The size and position of the plot in the image.
hints - Rendering hints for this plot.
transparent - Indicator that the background of the plot should not be painted.
Returns:
The modified bufferedImage.

exportImage

public java.awt.image.BufferedImage exportImage(java.awt.image.BufferedImage bufferedImage)
Draw this plot onto the provided image. This method does not paint the background, so the plot is transparent. The plot fills the image, and is rendered using anti-aliasing. This method can be used to overlay multiple plots on the same image, although you must use care to ensure that the axes and other labels are identical. Hence, it is usually better to simply combine data sets into a single plot.

Parameters:
bufferedImage - The image onto which to render the plot.
Returns:
The modified bufferedImage.

fillPlot

public void fillPlot()
Rescale so that the data that is currently plotted just fits. This is done based on the protected variables _xBottom, _xTop, _yBottom, and _yTop. It is up to derived classes to ensure that variables are valid. This method calls repaint(), which eventually causes the display to be updated.


getColor

public boolean getColor()
Return whether the plot uses color.

Returns:
True if the plot uses color.

getColorByName

public static java.awt.Color getColorByName(java.lang.String name)
Convert a color name into a Color. Currently, only a very limited set of color names is supported: black, white, red, green, and blue.

Parameters:
name - A color name, or null if not found.
Returns:
An instance of Color.

getDataurl

public java.lang.String getDataurl()
Deprecated.  

Get the file specification that was given by setDataurl. This method is deprecated. Use read() instead.


getDocumentBase

public java.net.URL getDocumentBase()
Deprecated.  

Get the document base that was set by setDocumentBase. This method is deprecated. Use read() instead.


getGrid

public boolean getGrid()
Return whether the grid is drawn.

Returns:
True if a grid is drawn.

getLegend

public java.lang.String getLegend(int dataset)
Get the legend for a dataset, or null if there is none. The legend would have been set by addLegend().

Parameters:
dataset - The dataset index.
Returns:
The legend label, or null if there is none.

getMaximumSize

public java.awt.Dimension getMaximumSize()
If the size of the plot has been set by setSize(), then return that size. Otherwise, return what the superclass returns (which is undocumented, but apparently imposes no maximum size). Currently (JDK 1.3), only BoxLayout pays any attention to this.

Overrides:
getMaximumSize in class javax.swing.JComponent
Returns:
The maximum desired size.

getMinimumSize

public java.awt.Dimension getMinimumSize()
Get the minimum size of this component. This is simply the dimensions specified by setSize(), if this has been called. Otherwise, return whatever the base class returns, which is undocumented.

Overrides:
getMinimumSize in class javax.swing.JComponent
Returns:
The minimum size.

getPreferredSize

public java.awt.Dimension getPreferredSize()
Get the preferred size of this component. This is simply the dimensions specified by setSize(), if this has been called, or the default width and height otherwise (500 by 300).

Overrides:
getPreferredSize in class javax.swing.JComponent
Returns:
The preferred size.

getTitle

public java.lang.String getTitle()
Get the title of the graph, or an empty string if there is none.

Returns:
The title.

getXLabel

public java.lang.String getXLabel()
Get the label for the X (horizontal) axis, or null if none has been set.

Returns:
The X label.

getXLog

public boolean getXLog()
Return whether the X axis is drawn with a logarithmic scale.

Returns:
True if the X axis is logarithmic.

getXRange

public double[] getXRange()
Get the X range. The returned value is an array where the first element is the minimum and the second element is the maximum. return The current X range.


getXTicks

public java.util.Vector[] getXTicks()
Get the X ticks that have been specified, or null if none. The return value is an array with two vectors, the first of which specifies the X tick locations (as instances of Double), and the second of which specifies the corresponding labels.

Returns:
The X ticks.

getYLabel

public java.lang.String getYLabel()
Get the label for the Y (vertical) axis, or null if none has been set.

Returns:
The Y label.

getYLog

public boolean getYLog()
Return whether the Y axis is drawn with a logarithmic scale.

Returns:
True if the Y axis is logarithmic.

getYRange

public double[] getYRange()
Get the Y range. The returned value is an array where the first element is the minimum and the second element is the maximum. return The current Y range.


getYTicks

public java.util.Vector[] getYTicks()
Get the Y ticks that have been specified, or null if none. The return value is an array with two vectors, the first of which specifies the Y tick locations (as instances of Double), and the second of which specifies the corresponding labels.

Returns:
The Y ticks.

init

public void init()
Deprecated.  

Initialize the component, creating the fill button and parsing an input file, if one has been specified. This is deprecated. Call setButtons() and read() instead.


paintComponent

public void paintComponent(java.awt.Graphics graphics)
Paint the component contents, which in this base class is only the axes.

Overrides:
paintComponent in class javax.swing.JComponent
Parameters:
graphics - The graphics context.

parseFile

public void parseFile(java.lang.String filespec)
Deprecated.  

Syntactic sugar for parseFile(filespec, documentBase). This method is deprecated. Use read() to read the old file format, or use one of the classes in the plotml package to read the XML-based file format.


parseFile

public void parseFile(java.lang.String filespec,
                      java.net.URL documentBase)
Deprecated. This method is deprecated. Use read() instead.

Open up the input file, which could be stdin, a URL, or a file.


print

public int print(java.awt.Graphics graphics,
                 java.awt.print.PageFormat format,
                 int index)
          throws java.awt.print.PrinterException
Print the plot to a printer, represented by the specified graphics object.

Specified by:
print in interface java.awt.print.Printable
Parameters:
graphics - The context into which the page is drawn.
format - The size and orientation of the page being drawn.
index - The zero based index of the page to be drawn.
Returns:
PAGE_EXISTS if the page is rendered successfully, or NO_SUCH_PAGE if pageIndex specifies a non-existent page.
Throws:
java.awt.print.PrinterException - If the print job is terminated.

read

public void read(java.io.InputStream in)
          throws java.io.IOException
Read commands and/or plot data from an input stream in the old (non-XML) file syntax. To update the display, call repaint(), or make the plot visible with setVisible(true).

To read from standard input, use:

     read(System.in);
  
To read from a url, use:
     read(url.openStream());
  
To read a URL from within an applet, use:
     URL url = new URL(getDocumentBase(), urlSpec);
     read(url.openStream());
  
Within an application, if you have an absolute URL, use:
     URL url = new URL(urlSpec);
     read(url.openStream());
  
To read from a file, use:
     read(new FileInputStream(filename));
  

Parameters:
in - The input stream.
Throws:
java.io.IOException - If the stream cannot be read.

read

public void read(java.lang.String command)
Read a single line command provided as a string. The commands can be any of those in the ASCII file format.

Parameters:
command - A command.

removeLegend

public void removeLegend(int dataset)
Remove the legend (displayed at the upper right) for the specified data set. If the dataset is not found, nothing will occur. The PlotBox must be repainted in order for this to take effect.

Parameters:
dataset - The dataset index.

resetAxes

public void resetAxes()
Reset the X and Y axes to the ranges that were first specified using setXRange() and setYRange(). If these methods have not been called, then reset to the default ranges. This method calls repaint(), which eventually causes the display to be updated.


samplePlot

public void samplePlot()
Do nothing in this base class. Derived classes might want to override this class to give an example of their use.


setBackground

public void setBackground(java.awt.Color background)
Set the background color.

Overrides:
setBackground in class javax.swing.JComponent
Parameters:
background - The background color.

setBounds

public void setBounds(int x,
                      int y,
                      int width,
                      int height)
Move and resize this component. The new location of the top-left corner is specified by x and y, and the new size is specified by width and height. This overrides the base class method to make a record of the new size.

Overrides:
setBounds in class java.awt.Component
Parameters:
x - The new x-coordinate of this component.
y - The new y-coordinate of this component.
width - The new width of this component.
height - The new height of this component.

setButtons

public void setButtons(boolean visible)
If the argument is true, make a fill button visible at the upper right. This button auto-scales the plot. NOTE: The button may infringe on the title space, if the title is long. In an application, it is preferable to provide a menu with the fill command. This way, when printing the plot, the printed plot will not have a spurious button. Thus, this method should be used only by applets, which normally do not have menus. This method should only be called from within the event dispatch thread, since it interacts with swing.


setColor

public void setColor(boolean useColor)
If the argument is false, draw the plot without using color (in black and white). Otherwise, draw it in color (the default).

Parameters:
useColor - False to draw in back and white.

setDataurl

public void setDataurl(java.lang.String filespec)
Deprecated.  

Set the file to read when init() is called. This method is deprecated. Use read() instead.


setDocumentBase

public void setDocumentBase(java.net.URL documentBase)
Deprecated.  

Set the document base to used when init() is called to read a URL. This method is deprecated. Use read() instead.


setForeground

public void setForeground(java.awt.Color foreground)
Set the foreground color.

Overrides:
setForeground in class javax.swing.JComponent
Parameters:
foreground - The foreground color.

setGrid

public void setGrid(boolean grid)
Control whether the grid is drawn.

Parameters:
grid - If true, a grid is drawn.

setLabelFont

public void setLabelFont(java.lang.String name)
Set the label font, which is used for axis labels and legend labels. The font names understood are those understood by java.awt.Font.decode().

Parameters:
name - A font name.

setSize

public void setSize(int width,
                    int height)
Set the size of the plot. This overrides the base class to make it work. In particular, it records the specified size so that getMinimumSize() and getPreferredSize() return the specified value. However, it only works if the plot is placed in its own JPanel. This is because the JPanel asks the contained component for its preferred size before determining the size of the panel. If the plot is placed directly in the content pane of a JApplet, then, mysteriously, this method has no effect.

Overrides:
setSize in class java.awt.Component
Parameters:
width - The width, in pixels.
height - The height, in pixels.

setTitle

public void setTitle(java.lang.String title)
Set the title of the graph.

Parameters:
title - The title.

setTitleFont

public void setTitleFont(java.lang.String name)
Set the title font. The font names understood are those understood by java.awt.Font.decode().

Parameters:
name - A font name.

setWrap

public void setWrap(boolean wrap)
Specify whether the X axis is wrapped. If it is, then X values that are out of range are remapped to be in range using modulo arithmetic. The X range is determined by the most recent call to setXRange() (or the most recent zoom). If the X range has not been set, then use the default X range, or if data has been plotted, then the current fill range.

Parameters:
wrap - If true, wrapping of the X axis is enabled.

setXLabel

public void setXLabel(java.lang.String label)
Set the label for the X (horizontal) axis.

Parameters:
label - The label.

setXLog

public void setXLog(boolean xlog)
Specify whether the X axis is drawn with a logarithmic scale. If you would like to have the X axis drawn with a logarithmic axis, then setXLog(true) should be called before adding any data points.

Parameters:
xlog - If true, logarithmic axis is used.

setXRange

public void setXRange(double min,
                      double max)
Set the X (horizontal) range of the plot. If this is not done explicitly, then the range is computed automatically from data available when the plot is drawn. If min and max are identical, then the range is arbitrarily spread by 1.

Parameters:
min - The left extent of the range.
max - The right extent of the range.

setYLabel

public void setYLabel(java.lang.String label)
Set the label for the Y (vertical) axis.

Parameters:
label - The label.

setYLog

public void setYLog(boolean ylog)
Specify whether the Y axis is drawn with a logarithmic scale. If you would like to have the Y axis drawn with a logarithmic axis, then setYLog(true) should be called before adding any data points.

Parameters:
ylog - If true, logarithmic axis is used.

setYRange

public void setYRange(double min,
                      double max)
Set the Y (vertical) range of the plot. If this is not done explicitly, then the range is computed automatically from data available when the plot is drawn. If min and max are identical, then the range is arbitrarily spread by 0.1.

Parameters:
min - The bottom extent of the range.
max - The top extent of the range.

write

public void write(java.io.OutputStream out)
Write the current data and plot configuration to the specified stream in PlotML syntax. PlotML is an XML extension for plot data. The written information is standalone, in that it includes the DTD (document type definition). This makes is somewhat verbose. To get smaller files, use the two argument version of write(). The output is buffered, and is flushed and closed before exiting. Derived classes should override writeFormat and writeData rather than this method.

Parameters:
out - An output stream.

write

public void write(java.io.OutputStream out,
                  java.lang.String dtd)
Write the current data and plot configuration to the specified stream in PlotML syntax. PlotML is an XML scheme for plot data. The URL (relative or absolute) for the DTD is given as the second argument. If that argument is null, then the PlotML PUBLIC DTD is referenced, resulting in a file that can be read by a PlotML parser without any external file references, as long as that parser has local access to the DTD. The output is buffered, and is flushed and closed before exiting. Derived classes should override writeFormat and writeData rather than this method.

Parameters:
out - An output stream.
dtd - The reference (URL) for the DTD, or null to use the PUBLIC DTD.

write

public void write(java.io.Writer out,
                  java.lang.String dtd)
Write the current data and plot configuration to the specified stream in PlotML syntax. PlotML is an XML scheme for plot data. The URL (relative or absolute) for the DTD is given as the second argument. If that argument is null, then the PlotML PUBLIC DTD is referenced, resulting in a file that can be read by a PlotML parser without any external file references, as long as that parser has local access to the DTD. The output is buffered, and is flushed and closed before exiting.

Parameters:
out - An output writer.
dtd - The reference (URL) for the DTD, or null to use the PUBLIC DTD.

writeData

public void writeData(java.io.PrintWriter output)
Write plot data information to the specified output stream in PlotML. In this base class, there is no data to write, so this method returns without doing anything.

Parameters:
output - A buffered print writer.

writeFormat

public void writeFormat(java.io.PrintWriter output)
Write plot format information to the specified output stream in PlotML. Derived classes should override this method to first call the parent class method, then add whatever additional format information they wish to add to the stream.

Parameters:
output - A buffered print writer.

writeOldSyntax

public void writeOldSyntax(java.io.OutputStream out)
Deprecated.  

Write the current data and plot configuration to the specified stream in the old PtPlot syntax. The output is buffered, and is flushed and closed before exiting. Derived classes should override _writeOldSyntax() rather than this method.

Parameters:
out - An output stream.

zoom

public void zoom(double lowx,
                 double lowy,
                 double highx,
                 double highy)
Zoom in or out to the specified rectangle. This method calls repaint().

Parameters:
lowx - The low end of the new X range.
lowy - The low end of the new Y range.
highx - The high end of the new X range.
highy - The high end of the new Y range.