public class Plot extends PlotBox implements PlotInterface
When calling the public methods, in most cases the changes will not be visible until paintComponent() is called. To request that this be done, call repaint(). One exception is addPoint(), which makes the new point visible immediately if the plot is visible on the screen and addPoint() is called from the event dispatching thread.
This base class supports a simple file syntax that has largely been replaced by the XML-based PlotML syntax. To read a file or a URL in this older syntax, use the read() method. This older syntax contains 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 those supported by the base class, plus a few more. The commands are case insensitive, but are usually capitalized. The number of data sets to be plotted does not need to be specified. Data sets are added as needed. Each dataset can be optionally identified with color (see the base class) or with unique marks. The style of marks used to denote a data point is defined by one of the following commands:
Marks: none Marks: points Marks: bigdots Marks: dots Marks: various Marks: pixelsHere, "points" are small dots, while "dots" are larger. If "various" is specified, then unique marks are used for the first ten data sets, and then recycled. If "pixels" are specified, then each point is drawn as one pixel. Using no marks is useful when lines connect the points in a plot, which is done by default. However, if persistence is set, then you may want to choose "pixels" because the lines may overlap, resulting in annoying gaps in the drawn line. If the above directive appears before any DataSet directive, then it specifies the default for all data sets. If it appears after a DataSet directive, then it applies only to that data set.
To disable connecting lines, use:
Lines: offTo reenable them, use
Lines: onYou can control the line style on a per dataset basis by adding
LineStyle: solidOther supported line styles are "dotted", "dashed", "dotdashed" and "dotdotdashed". You can also specify "impulses", which are lines drawn from a plotted point down to the x axis. Plots with impulses are often called "stem plots." These are off by default, but can be turned on with the command:
Impulses: onor back off with the command
Impulses: offIf that command appears before any DataSet directive, then the command applies to all data sets. Otherwise, it applies only to the current data set. To create a bar graph, turn off lines and use any of the following commands:
Bars: on Bars: width Bars: width, offsetThe width is a real number specifying the width of the bars in the units of the x axis. The offset is a real number specifying how much the bar of the ith data set is offset from the previous one. This allows bars to "peek out" from behind the ones in front. Note that the frontmost data set will be the first one. To turn off bars, use
Bars: offTo specify data to be plotted, start a data set with the following command:
DataSet: stringHere, string is a label that will appear in the legend. It is not necessary to enclose the string in quotation marks. To start a new dataset without giving it a name, use:
DataSet:In this case, no item will appear in the legend. New datasets are plotted behind the previous ones. If the following directive occurs:
ReuseDataSets: onThen datasets with the same name will be merged. This makes it easier to combine multiple datafiles that contain the same datasets into one file. By default, this capability is turned off, so datasets with the same name are not merged. The data itself is given by a sequence of commands with one of the following forms:
x, y draw: x, y move: x, y x, y, yLowErrorBar, yHighErrorBar draw: x, y, yLowErrorBar, yHighErrorBar move: x, y, yLowErrorBar, yHighErrorBarThe "draw" command is optional, so the first two forms are equivalent. The "move" command causes a break in connected points, if lines are being drawn between points. The numbers x and y are arbitrary numbers as supported by the Double parser in Java. If there are four numbers, then the last two numbers are assumed to be the lower and upper values for error bars. The numbers can be separated by commas, spaces or tabs.
Some of the methods, such as those that add points a plot, are executed in the event thread, possibly some time after they are called. If they are called from a thread different from the event thread, then the order in which changes to the plot take effect may be surprising. We recommend that any code you write that changes the plot in visible ways be executed in the event thread. You can accomplish this using the following template:
Runnable doAction = new Runnable() { public void run() { ... make changes here (e.g. setMarksStyle()) ... } }; synchronized (plot) { plot.deferIfNecessary(doAction); }Note that deferIfNecessary() is not synchronized, but the caller of deferIfNecessary() should be synchronized on the Plot object.
This plotter has some limitations:
_gridInit()
method in the PlotBox class.
PlotBox.ButtonListener, PlotBox.CommandListener, PlotBox.DragListener, PlotBox.MoveListener, PlotBox.MoveMotionListener, PlotBox.ZoomListener, PlotBox.ZoomListener2
javax.swing.JPanel.AccessibleJPanel
javax.swing.JComponent.AccessibleJComponent
Modifier and Type | Field and Description |
---|---|
protected int |
_currentdataset
The current dataset.
|
protected int |
_marks
An indicator of the marks style.
|
protected java.util.ArrayList<java.util.ArrayList<PlotPoint>> |
_points
A vector of datasets.
|
_background, _bottomPadding, _colors, _documentBase, _foreground, _grid, _height, _leftPadding, _LOG10SCALE, _lrx, _lry, _originalXhigh, _originalXlow, _originalXRangeGiven, _originalYhigh, _originalYlow, _originalYRangeGiven, _padding, _plotImage, _preferredHeight, _preferredWidth, _rangesGivenByZooming, _rightPadding, _specifiedPlotRectangle, _topPadding, _ulx, _uly, _usecolor, _wrap, _wrapHigh, _wrapLow, _xBottom, _xhighgiven, _xlog, _xlowgiven, _xMax, _xMin, _xRangeGiven, _xscale, _xTop, _yBottom, _yhighgiven, _ylog, _ylowgiven, _yMax, _yMin, _yRangeGiven, _yscale, _yTop, PTPLOT_RELEASE
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Constructor and Description |
---|
Plot() |
Modifier and Type | Method and Description |
---|---|
protected void |
_checkDatasetIndex(int dataset)
Check the argument to ensure that it is a valid data set index.
|
protected void |
_drawBar(java.awt.Graphics graphics,
int dataset,
long xpos,
long ypos,
boolean clip)
Draw bar from the specified point to the y axis.
|
protected void |
_drawErrorBar(java.awt.Graphics graphics,
int dataset,
long xpos,
long yLowEBPos,
long yHighEBPos,
boolean clip)
Draw an error bar for the specified yLowEB and yHighEB values.
|
protected void |
_drawImpulse(java.awt.Graphics graphics,
long xpos,
long ypos,
boolean clip)
Draw a line from the specified point to the y axis.
|
protected void |
_drawLine(java.awt.Graphics graphics,
int dataset,
long startx,
long starty,
long endx,
long endy,
boolean clip)
Draw a line from the specified starting point to the specified
ending point.
|
protected void |
_drawLine(java.awt.Graphics graphics,
int dataset,
long startx,
long starty,
long endx,
long endy,
boolean clip,
float width)
Draw a line from the specified starting point to the specified
ending point.
|
protected void |
_drawPlot(java.awt.Graphics graphics,
boolean clearfirst,
java.awt.Rectangle drawRectangle)
Draw the axes and then plot all points.
|
protected void |
_drawPoint(java.awt.Graphics graphics,
int dataset,
long xpos,
long ypos,
boolean clip)
Put a mark corresponding to the specified dataset at the
specified x and y position.
|
protected java.lang.String |
_exportLatexPlotData()
Return Latex plot data.
|
protected boolean |
_parseLine(java.lang.String line)
Parse a line that gives plotting information.
|
protected void |
_resetScheduledTasks()
Reset a scheduled redraw tasks.
|
protected void |
_scheduledRedraw()
Perform a scheduled redraw.
|
protected void |
_setWidth(java.awt.Graphics graphics,
float width)
If the graphics argument is an instance of Graphics2D, then set
the current stroke to the specified width.
|
protected void |
_writeOldSyntax(java.io.PrintWriter output)
Deprecated.
|
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 |
addPoint(int dataset,
double x,
double y,
double[] derivatives,
boolean connected)
In the specified data set, add the specified x, y point to the
plot.
|
void |
addPointWithErrorBars(int dataset,
double x,
double y,
double[] derivatives,
double yLowEB,
double yHighEB,
boolean connected)
In the specified data set, add the specified x, y point to the
plot with error bars.
|
void |
clear(boolean format)
Clear the plot of all data points.
|
void |
clear(int dataset)
Clear the plot of data points in the specified dataset.
|
void |
erasePoint(int dataset,
int index)
Erase the point at the given index in the given dataset.
|
void |
fillPlot()
Rescale so that the data that is currently plotted just fits.
|
boolean |
getConnected()
Return whether the default is to connect
subsequent points with a line.
|
boolean |
getImpulses()
Return whether a line will be drawn from any
plotted point down to the x axis.
|
boolean |
getLineStyles()
Return false if setLineStyles() has not yet been called or if
setLineStyles(false) has been called, which signifies that
different line styles are not to be used.
|
java.lang.String |
getMarksStyle()
Get the marks style, which is one of
"none", "points", "dots", or "various".
|
int |
getMaxDataSets()
Deprecated.
|
int |
getNumDataSets()
Return the actual number of data sets.
|
boolean |
getReuseDatasets()
Return false if setReuseDatasets() has not yet been called
or if setReuseDatasets(false) has been called.
|
void |
markDisconnections(boolean value)
Mark the disconnections with a Dot in case value equals true, otherwise these
points are not marked.
|
void |
parseFile(java.lang.String filespec,
java.net.URL documentBase)
Deprecated.
|
void |
read(java.io.InputStream inputStream)
Read a file with the old syntax (non-XML).
|
void |
samplePlot()
Create a sample plot.
|
void |
setBars(boolean on)
Turn bars on or off (for bar charts).
|
void |
setBars(double width,
double offset)
Turn bars on and set the width and offset.
|
void |
setConnected(boolean on)
If the argument is true, then the default is to connect
subsequent points with a line.
|
void |
setConnected(boolean on,
int dataset)
If the first argument is true, then by default for the specified
dataset, points will be connected by a line.
|
void |
setImpulses(boolean on)
If the argument is true, then a line will be drawn from any
plotted point down to the x axis.
|
void |
setImpulses(boolean on,
int dataset)
If the first argument is true, then a line will be drawn from any
plotted point in the specified dataset down to the x axis.
|
void |
setLineStyle(java.lang.String styleString,
int dataset)
Set the style of the lines joining marks.
|
void |
setLineStyles(boolean lineStyles)
If the argument is true, draw the data sets with different line
styles.
|
void |
setMarksStyle(java.lang.String style)
Set the marks style to "none", "points", "dots", or "various".
|
void |
setMarksStyle(java.lang.String style,
int dataset)
Set the marks style to "none", "points", "dots", "various",
or "pixels" for the specified dataset.
|
void |
setNumSets(int numSets)
Deprecated.
|
void |
setPointsPersistence(int persistence)
Calling this method with a positive argument sets the
persistence of the plot to the given number of points.
|
void |
setReuseDatasets(boolean on)
If the argument is true, then datasets with the same name
are merged into a single dataset.
|
void |
setXPersistence(double persistence)
Calling this method with a positive argument sets the
persistence of the plot to the given width in units of the
horizontal axis.
|
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, an XML scheme.
|
_automaticRescale, _drawPlot, _help, _setButtonsVisibility, _setPadding, _timedRepaint, _zoom, _zoomBox, _zoomStart, addCaptionLine, addXTick, addYTick, clearCaptions, clearLegends, deferIfNecessary, destroy, export, exportImage, exportImage, exportImage, exportImage, exportImage, exportLatex, getCaptions, getColor, getColorByName, getColors, getDataurl, getDocumentBase, getGrid, getLegend, getLegendDataset, getPlotRectangle, getPreferredSize, getTitle, getXAutoRange, getXLabel, getXLog, getXRange, getXTicks, getYAutoRange, getYLabel, getYLog, getYRange, getYTicks, init, paintComponent, parseFile, print, read, removeLegend, renameLegend, resetAxes, setAutomaticRescale, setBackground, setBackground, setBounds, setButtons, setCaptions, setColor, setColors, setColors, setDataurl, setDocumentBase, setForeground, setForeground, setGrid, setLabelFont, setPlotRectangle, setPlotRectangle, setSize, setTimedRepaint, setTitle, setTitleFont, setWrap, setXLabel, setXLog, setXRange, setYLabel, setYLog, setYRange, write, write, write, writeOldSyntax, zoom, zoomEqual
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
addPoint
addCaptionLine, addXTick, addYTick, clearCaptions, clearLegends, deferIfNecessary, destroy, getCaptions, getColor, getColors, getDataurl, getDocumentBase, getGrid, getLegend, getLegendDataset, getPlotRectangle, getTitle, getXAutoRange, getXLabel, getXLog, getXRange, getXTicks, getYAutoRange, getYLabel, getYLog, getYRange, getYTicks, init, parseFile, read, removeLegend, renameLegend, repaint, resetAxes, setAutomaticRescale, setBackground, setButtons, setCaptions, setColor, setColors, setDataurl, setDocumentBase, setForeground, setGrid, setLabelFont, setPlotRectangle, setSize, setTimedRepaint, setTitle, setTitleFont, setWrap, setXLabel, setXLog, setXRange, setYLabel, setYLog, setYRange, write, write, write, writeOldSyntax, zoom
protected int _currentdataset
protected volatile int _marks
protected java.util.ArrayList<java.util.ArrayList<PlotPoint>> _points
public void addLegend(int dataset, java.lang.String legend)
addLegend
in interface PlotBoxInterface
addLegend
in interface PlotInterface
addLegend
in class PlotBox
dataset
- The dataset index.legend
- The label for the dataset.PlotBox.renameLegend(int, String)
public void addPoint(int dataset, double x, double y, double[] derivatives, boolean connected)
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the point will not be added immediately (unless you call this method from within the event dispatch thread). All the methods that do this deferring coordinate so that they are executed in the order that you called them.
addPoint
in interface PlotInterface
dataset
- The data set index.x
- The X position of the new point.y
- The Y position of the new point.derivatives
- The derivatives, if any.connected
- If true, a line is drawn to connect to the previous
point.public void addPointWithErrorBars(int dataset, double x, double y, double[] derivatives, double yLowEB, double yHighEB, boolean connected)
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the point will not be added immediately (unless you call this method from within the event dispatch thread). All the methods that do this deferring coordinate so that they are executed in the order that you called them.
addPointWithErrorBars
in interface PlotInterface
dataset
- The data set index.x
- The X position of the new point.y
- The Y position of the new point.derivatives
- The derivatives, if any.yLowEB
- The low point of the error bar.yHighEB
- The high point of the error bar.connected
- If true, a line is drawn to connect to the previous
point.public void clear(boolean format)
clear
in interface PlotBoxInterface
clear
in interface PlotInterface
clear
in class PlotBox
format
- If true, clear the format controls as well.
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the clear will not be executed immediately (unless you call this method from within the event dispatch thread). All the methods that do this deferring coordinate so that they are executed in the order that you called them.
public void clear(int dataset)
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the point will not be added immediately (unless you call this method from within the event dispatch thread). If you call this method, the addPoint() method, and the erasePoint() method in any order, they are assured of being processed in the order that you called them.
clear
in interface PlotInterface
dataset
- The dataset to clear.public void erasePoint(int dataset, int index)
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the point will not be erased immediately (unless you call this method from within the event dispatch thread). All the methods that do this deferring coordinate so that they are executed in the order that you called them.
erasePoint
in interface PlotInterface
dataset
- The data set index.index
- The index of the point to erase.public void fillPlot()
In order to work well with swing and be thread safe, this method actually defers execution to the event dispatch thread, where all user interface actions are performed. Thus, the fill will not occur immediately (unless you call this method from within the event dispatch thread). All the methods that do this deferring coordinate so that they are executed in the order that you called them.
fillPlot
in interface PlotBoxInterface
fillPlot
in interface PlotInterface
fillPlot
in class PlotBox
public boolean getConnected()
getConnected
in interface PlotInterface
setConnected(boolean)
public boolean getImpulses()
getImpulses
in interface PlotInterface
setImpulses(boolean)
,
setImpulses(boolean, int)
public boolean getLineStyles()
getLineStyles
in interface PlotInterface
setLineStyles(boolean)
public java.lang.String getMarksStyle()
getMarksStyle
in interface PlotInterface
setMarksStyle(java.lang.String)
@Deprecated public int getMaxDataSets()
getMaxDataSets
in interface PlotInterface
public int getNumDataSets()
getNumDataSets
in interface PlotInterface
public boolean getReuseDatasets()
getReuseDatasets
in interface PlotInterface
setReuseDatasets(boolean)
@Deprecated public void parseFile(java.lang.String filespec, java.net.URL documentBase)
parseFile
in interface PlotBoxInterface
parseFile
in interface PlotInterface
parseFile
in class PlotBox
filespec
- The file to be read.documentBase
- The base of the URLpublic void markDisconnections(boolean value)
markDisconnections
in interface PlotInterface
value
- True when disconnections should be marked.public void read(java.io.InputStream inputStream) throws java.io.IOException
read
in interface PlotBoxInterface
read
in interface PlotInterface
read
in class PlotBox
inputStream
- The input stream.java.io.IOException
- If the stream cannot be read.public void samplePlot()
samplePlot
in interface PlotBoxInterface
samplePlot
in interface PlotInterface
samplePlot
in class PlotBox
public void setBars(boolean on)
setBars
in interface PlotInterface
on
- If true, turn bars on.public void setBars(double width, double offset)
setBars
in interface PlotInterface
width
- The width of the bars.offset
- The offset per data set.public void setConnected(boolean on)
setConnected
in interface PlotInterface
on
- If true, draw lines between points.setConnected(boolean, int)
,
getConnected()
public void setConnected(boolean on, int dataset)
setConnected
in interface PlotInterface
on
- If true, draw lines between points.dataset
- The dataset to which this should apply.setConnected(boolean)
,
getConnected()
public void setImpulses(boolean on)
setImpulses
in interface PlotInterface
on
- If true, draw a stem plot.getImpulses()
public void setImpulses(boolean on, int dataset)
setImpulses
in interface PlotInterface
on
- If true, draw a stem plot.dataset
- The dataset to which this should apply.getImpulses()
public void setLineStyle(java.lang.String styleString, int dataset)
setLineStyle
in interface PlotInterface
styleString
- A string specifying the color for points.
The following styles are permitted: "solid", "dotted",
"dashed", "dotdashed", "dotdotdashed".dataset
- The data set index.public void setLineStyles(boolean lineStyles)
setLineStyles
in interface PlotInterface
lineStyles
- True if the data sets are to be drawn in different
line styles.getLineStyles()
public void setMarksStyle(java.lang.String style)
setMarksStyle
in interface PlotInterface
style
- A string specifying the style for points.getMarksStyle()
public void setMarksStyle(java.lang.String style, int dataset)
setMarksStyle
in interface PlotInterface
style
- A string specifying the style for points.dataset
- The dataset to which this should apply.getMarksStyle()
@Deprecated public void setNumSets(int numSets)
setNumSets
in interface PlotInterface
numSets
- The number of data sets.public void setPointsPersistence(int persistence)
Setting the persistence greater than zero forces the plot to be drawn in XOR mode, which allows points to be quickly and efficiently erased. However, there is a bug in Java (as of version 1.3), where XOR mode does not work correctly with double buffering. Thus, if you call this with an argument greater than zero, then we turn off double buffering for this panel and all of its parents. This actually happens on the next call to addPoint().
setPointsPersistence
in interface PlotInterface
persistence
- Number of points to persist for.public void setReuseDatasets(boolean on)
setReuseDatasets
in interface PlotInterface
on
- If true, then merge datasets.getReuseDatasets()
public void setXPersistence(double persistence)
Setting the X persistence greater than zero forces the plot to be drawn in XOR mode, which allows points to be quickly and efficiently erased. However, there is a bug in Java (as of version 1.3), where XOR mode does not work correctly with double buffering. Thus, if you call this with an argument greater than zero, then we turn off double buffering for this panel and all of its parents. This actually happens on the next call to addPoint().
setXPersistence
in interface PlotInterface
persistence
- Persistence in units of the horizontal axis.public void writeData(java.io.PrintWriter output)
writeData
in interface PlotBoxInterface
writeData
in interface PlotInterface
writeData
in class PlotBox
output
- A buffered print writer.public void writeFormat(java.io.PrintWriter output)
writeFormat
in interface PlotBoxInterface
writeFormat
in interface PlotInterface
writeFormat
in class PlotBox
output
- A buffered print writer.protected void _checkDatasetIndex(int dataset)
dataset
- The data set index.protected void _drawBar(java.awt.Graphics graphics, int dataset, long xpos, long ypos, boolean clip)
graphics
- The graphics context.dataset
- The index of the dataset.xpos
- The x position.ypos
- The y position.clip
- If true, then do not draw outside the range.protected void _drawErrorBar(java.awt.Graphics graphics, int dataset, long xpos, long yLowEBPos, long yHighEBPos, boolean clip)
graphics
- The graphics context.dataset
- The index of the dataset.xpos
- The x position.yLowEBPos
- The lower y position of the error bar.yHighEBPos
- The upper y position of the error bar.clip
- If true, then do not draw above the range.protected void _drawImpulse(java.awt.Graphics graphics, long xpos, long ypos, boolean clip)
graphics
- The graphics context.xpos
- The x position.ypos
- The y position.clip
- If true, then do not draw outside the range.protected void _drawLine(java.awt.Graphics graphics, int dataset, long startx, long starty, long endx, long endy, boolean clip)
graphics
- The graphics context.dataset
- The index of the dataset.startx
- The starting x position.starty
- The starting y position.endx
- The ending x position.endy
- The ending y position.clip
- If true, then do not draw outside the range.protected void _drawLine(java.awt.Graphics graphics, int dataset, long startx, long starty, long endx, long endy, boolean clip, float width)
graphics
- The graphics context.dataset
- The index of the dataset.startx
- The starting x position.starty
- The starting y position.endx
- The ending x position.endy
- The ending y position.clip
- If true, then do not draw outside the range.width
- The thickness of the line.protected void _drawPlot(java.awt.Graphics graphics, boolean clearfirst, java.awt.Rectangle drawRectangle)
Note that this is synchronized so that points are not added by other threads while the drawing is occurring. This method should be called only from the event dispatch thread, consistent with swing policy.
protected void _drawPoint(java.awt.Graphics graphics, int dataset, long xpos, long ypos, boolean clip)
_drawPoint
in class PlotBox
graphics
- The graphics context.dataset
- The index of the dataset.xpos
- The x position.ypos
- The y position.clip
- If true, then do not draw outside the range.protected java.lang.String _exportLatexPlotData()
_exportLatexPlotData
in class PlotBox
protected boolean _parseLine(java.lang.String line)
_parseLine
in class PlotBox
line
- A command line.protected void _resetScheduledTasks()
_resetScheduledTasks
in class PlotBox
protected void _scheduledRedraw()
_scheduledRedraw
in class PlotBox
protected void _setWidth(java.awt.Graphics graphics, float width)
graphics
- The graphics object.width
- The width.@Deprecated protected void _writeOldSyntax(java.io.PrintWriter output)
_writeOldSyntax
in class PlotBox
output
- A buffered print writer.