edu.mines.jtk.mosaic
Class PlotPanel

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by javax.swing.JPanel
                  extended by edu.mines.jtk.mosaic.IPanel
                      extended by edu.mines.jtk.mosaic.PlotPanel
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible
Direct Known Subclasses:
PlotPanelPixels3

public class PlotPanel
extends IPanel

A plot panel is a panel that contains a mosaic of 2-D graphical views. A plot panel may also contain a color bar and/or title. The plot panel's mosaic may contain any number or rows and columns of tiles. Each tile may contain any number of tiled graphical views.

The primary purpose of this class is ease-of-use. A plot panel handles much of the work of constructing a mosaic of tiled graphical views.

One consequence of ease-of-use is that some of the methods provided by this class are redundant. For example, some methods have (irow,icol) parameters that specify the row and column indices of a tile. These parameters are useful for mosaics with more than one tile. However, the most common case is a mosaic with only one tile; and, for this case, a corresponding method without (irow,icol) parameters is provided as well. The latter method simply calls the former with (irow,icol) = (0,0).

An important property of a plot panel is the orientation of its axes. Tiles have axes x1 and x2. By default, the x1 axis increases toward the right and the x2 axis increases toward the top of each tile in a mosaic. In this default X1RIGHT_X2UP orientation, the coordinates (x1,x2) correspond to conventional (x,y) coordinates. An alternative orientation is X1DOWN_X2RIGHT, which is useful when the x1 axis corresponds to, say, a depth coordinate z.

Version:
2005.12.25
Author:
Dave Hale, Colorado School of Mines
See Also:
Serialized Form

Nested Class Summary
static class PlotPanel.AxesPlacement
          Placement of labeled axes in mosaic.
static class PlotPanel.Orientation
          Orientation of axes x1 and x2.
 
Nested classes/interfaces inherited from class javax.swing.JPanel
javax.swing.JPanel.AccessibleJPanel
 
Nested classes/interfaces inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class javax.swing.JComponent
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, 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.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
PlotPanel()
          Constructs a new plot panel with a mosaic of one tile.
PlotPanel(int nrow, int ncol)
          Constructs a new plot panel with a mosaic of nrow by ncol tiles.
PlotPanel(int nrow, int ncol, PlotPanel.Orientation orientation)
           
PlotPanel(int nrow, int ncol, PlotPanel.Orientation orientation, PlotPanel.AxesPlacement axesPlacement)
          Constructs a new plot panel with a mosaic of nrow by ncol tiles.
PlotPanel(PlotPanel.Orientation orientation)
          Constructs a new plot panel with a mosaic of one tile.
 
Method Summary
 ColorBar addColorBar()
          Adds the color bar with no label.
 ColorBar addColorBar(java.lang.String label)
          Adds the color bar with specified label.
 GridView addGrid()
          Adds a grid view.
 GridView addGrid(int irow, int icol)
          Adds a grid view.
 GridView addGrid(int irow, int icol, java.lang.String parameters)
          Adds a grid view with specified parameters string.
 GridView addGrid(java.lang.String parameters)
          Adds a grid view with specified parameters string.
 PixelsView addPixels(float[][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(float[][][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(int irow, int icol, float[][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(int irow, int icol, float[][][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(int irow, int icol, Sampling s1, Sampling s2, float[][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(int irow, int icol, Sampling s1, Sampling s2, float[][][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(Sampling s1, Sampling s2, float[][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PixelsView addPixels(Sampling s1, Sampling s2, float[][][] f)
          Adds a pixels view of the specified sampled function f(x1,x2).
 PointsView addPoints(float[] x2)
          Adds a points view of (x1,x2) with specified x2 coordinates.
 PointsView addPoints(float[][] x1, float[][] x2)
          Adds a view of arrays of (x1,x2) coordinates for multiple plot segments.
 PointsView addPoints(float[] x1, float[] x2)
          Adds a points view of the arrays x1 and x2 of point (x1,x2) coordinates.
 PointsView addPoints(float[] x1, float[] x2, float[] x3)
          Adds a points view of arrays x1, x2 and x3 of point (x1,x2,x3) coordinates.
 PointsView addPoints(int irow, int icol, float[] x2)
          Adds a points view of (x1,x2) with specified x2 coordinates.
 PointsView addPoints(int irow, int icol, float[][] x1, float[][] x2)
          Adds a view of arrays of (x1,x2) coordinates for multiple plot segments.
 PointsView addPoints(int irow, int icol, float[] x1, float[] x2)
          Adds a points view of the arrays x1 and x2 of point (x1,x2) coordinates.
 PointsView addPoints(int irow, int icol, float[] x1, float[] x2, float[] x3)
          Adds a points view of arrays x1, x2 and x3 of point (x1,x2,x3) coordinates.
 PointsView addPoints(int irow, int icol, Sampling s1, float[] x2)
          Adds a view of points (x1,x2) for a sampled function x2(x1).
 PointsView addPoints(Sampling s1, float[] x2)
          Adds a view of points (x1,x2) for a sampled function x2(x1).
 SequenceView addSequence(float[] f)
          Adds a sequence view with specified values f(x).
 SequenceView addSequence(int irow, int icol, float[] f)
          Adds a sequence view with specified values f(x).
 SequenceView addSequence(int irow, int icol, Sampling sx, float[] f)
          Adds a sequence view with specified sampling and values f(x).
 SequenceView addSequence(Sampling sx, float[] f)
          Adds a sequence view with specified sampling and values f(x).
 boolean addTiledView(int irow, int icol, TiledView tv)
          Adds the specified tiled view to this plot panel.
 boolean addTiledView(TiledView tv)
          Adds the specified tiled view to this plot panel.
 void addTitle(java.lang.String title)
          Adds the plot title.
 Mosaic getMosaic()
          Gets the mosaic.
 Tile getTile(int irow, int icol)
          Gets the tile with specified row and column indices.
 boolean remove(TiledView tv)
          Removes the specified tiled view from this plot panel.
 void removeColorBar()
          Removes the color bar.
 void removeTitle()
          Removes the plot title.
 void setBackground(java.awt.Color color)
          Sets the background color in all components of this panel.
 void setColorBarFormat(java.lang.String format)
          Sets the format for major tic annotation of the color bar.
 void setColorBarWidthMinimum(int widthMinimum)
          Sets a minimum width (in pixels) for a color bar.
 void setFont(java.awt.Font font)
          Sets the font in all components of this panel.
 void setForeground(java.awt.Color color)
          Sets the foreground color in all components of this panel.
 void setHFormat(int icol, java.lang.String format)
          Sets the format for the horizontal axis in the specified column.
 void setHFormat(java.lang.String format)
          Sets the format for the horizontal axis.
 void setHInterval(double interval)
          Sets the tic interval for the horizontal axis.
 void setHInterval(int icol, double interval)
          Sets the tic interval for the horizontal axis in the specified column.
 void setHLabel(int icol, java.lang.String label)
          Sets the label for the horizontal axis in the specified column.
 void setHLabel(java.lang.String label)
          Sets the label for the horizontal axis.
 void setHLimits(double hmin, double hmax)
          Sets limits for the horizontal axis.
 void setHLimits(int icol, double hmin, double hmax)
          Sets limits for the horizontal axis in the specified column.
 void setHLimitsDefault()
          Sets default limits for the horizontal axis.
 void setHLimitsDefault(int icol)
          Sets default limits for the horizontal axis in the specified column.
 void setLimits(double hmin, double vmin, double hmax, double vmax)
          Sets limits for the both horizontal and vertical axes.
 void setLimitsDefault()
          Sets default limits for horizontal and vertical axes.
 void setTitle(java.lang.String title)
          Sets the plot title.
 void setVFormat(int irow, java.lang.String format)
          Sets the format for the vertical axis in the specified row.
 void setVFormat(java.lang.String format)
          Sets the format for the vertical axis.
 void setVInterval(double interval)
          Sets the tic interval for the vertical axis.
 void setVInterval(int irow, double interval)
          Sets the tic interval for the vertical axis in the specified column.
 void setVLabel(int irow, java.lang.String label)
          Sets the label for the vertical axis in the specified row.
 void setVLabel(java.lang.String label)
          Sets the label for the vertical axis.
 void setVLimits(double vmin, double vmax)
          Sets limits for the vertical axis.
 void setVLimits(int irow, double vmin, double vmax)
          Sets limits for the vertical axis in the specified row.
 void setVLimitsDefault()
          Sets default limits for the vertical axis.
 void setVLimitsDefault(int irow)
          Sets default limits for the vertical axis in the specified column.
 
Methods inherited from class edu.mines.jtk.mosaic.IPanel
computeScale, createGraphics, getLineWidth, paintToImage, paintToImage, paintToPng, paintToRect, scaleLineWidth
 
Methods inherited from class javax.swing.JPanel
getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, 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, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
Methods inherited from class java.awt.Container
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, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
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, hide, 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, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

PlotPanel

public PlotPanel()
Constructs a new plot panel with a mosaic of one tile. Uses the default orientation X1RIGHT_X2UP.


PlotPanel

public PlotPanel(int nrow,
                 int ncol)
Constructs a new plot panel with a mosaic of nrow by ncol tiles. Uses the default orientation X1RIGHT_X2UP.

Parameters:
nrow - the number of rows.
ncol - the number of columns.

PlotPanel

public PlotPanel(PlotPanel.Orientation orientation)
Constructs a new plot panel with a mosaic of one tile.

Parameters:
orientation - the plot orientation.

PlotPanel

public PlotPanel(int nrow,
                 int ncol,
                 PlotPanel.Orientation orientation)

PlotPanel

public PlotPanel(int nrow,
                 int ncol,
                 PlotPanel.Orientation orientation,
                 PlotPanel.AxesPlacement axesPlacement)
Constructs a new plot panel with a mosaic of nrow by ncol tiles.

Parameters:
nrow - the number of rows.
ncol - the number of columns.
orientation - the plot orientation.
axesPlacement - the placement of axes.
Method Detail

getMosaic

public Mosaic getMosaic()
Gets the mosaic. The mosaic contains one or more tiles.

Returns:
the mosaic.

getTile

public Tile getTile(int irow,
                    int icol)
Gets the tile with specified row and column indices.

Parameters:
irow - the row index.
icol - the column index.
Returns:
the tile.

addColorBar

public ColorBar addColorBar()
Adds the color bar with no label. The color bar paints the color map of the most recently added pixels view. To avoid confusion, a color bar should perhaps not be added when this plot panel contains multiple pixels views with different color maps..

Returns:
the color bar.

addColorBar

public ColorBar addColorBar(java.lang.String label)
Adds the color bar with specified label.

Parameters:
label - the label; null, if none.
Returns:
the color bar.

setColorBarWidthMinimum

public void setColorBarWidthMinimum(int widthMinimum)
Sets a minimum width (in pixels) for a color bar. This method is useful when attempting to construct multiple plot panels with the same layout. In this scenario, set this minimum equal to the width of the widest color bar. Then all color bars will have the same width. Those widths might otherwise vary as tic and axes labels vary for the different panels.

Parameters:
widthMinimum - the minimum width.

setColorBarFormat

public void setColorBarFormat(java.lang.String format)
Sets the format for major tic annotation of the color bar. The default format is "%1.4G", which yields a minimum of 1 digit, with up to 4 digits of precision. Any trailing zeros and decimal point are removed from tic annotation.

Parameters:
format - the format.

removeColorBar

public void removeColorBar()
Removes the color bar.


addTitle

public void addTitle(java.lang.String title)
Adds the plot title. Equivalent to setTitle(String). The title font is 1.5 times larger than the font of this panel.

Parameters:
title - the title; null, if none.

setTitle

public void setTitle(java.lang.String title)
Sets the plot title. Equivalent to addTitle(String).

Parameters:
title - the title; null, for no title.

removeTitle

public void removeTitle()
Removes the plot title. Equivalent to calling the method setTitle(String) with a null title.


setLimits

public void setLimits(double hmin,
                      double vmin,
                      double hmax,
                      double vmax)
Sets limits for the both horizontal and vertical axes. By default, limits are computed automatically by tiled graphical views. This method can be used to override those default limits.

Parameters:
hmin - the minimum value.
vmin - the minimum value.
hmax - the maximum value.
vmax - the maximum value.

setHLimits

public void setHLimits(double hmin,
                       double hmax)
Sets limits for the horizontal axis. By default, limits are computed automatically by tiled graphical views. This method can be used to override those default limits.

Parameters:
hmin - the minimum value.
hmax - the maximum value.

setVLimits

public void setVLimits(double vmin,
                       double vmax)
Sets limits for the vertical axis. By default, limits are computed automatically by tiled graphical views. This method can be used to override those default limits.

Parameters:
vmin - the minimum value.
vmax - the maximum value.

setHLimits

public void setHLimits(int icol,
                       double hmin,
                       double hmax)
Sets limits for the horizontal axis in the specified column. By default, limits are computed automatically by tiled graphical views. This method can be used to override those default limits.

Parameters:
icol - the column index.
hmin - the minimum value.
hmax - the maximum value.

setVLimits

public void setVLimits(int irow,
                       double vmin,
                       double vmax)
Sets limits for the vertical axis in the specified row. By default, limits are computed automatically by tiled graphical views. This method can be used to override those default limits.

Parameters:
irow - the row index.
vmin - the minimum value.
vmax - the maximum value.

setLimitsDefault

public void setLimitsDefault()
Sets default limits for horizontal and vertical axes. This method may be used to restore default limits after they have been set explicitly.


setHLimitsDefault

public void setHLimitsDefault()
Sets default limits for the horizontal axis. This method may be used to restore default limits after they have been set explicitly.


setVLimitsDefault

public void setVLimitsDefault()
Sets default limits for the vertical axis. This method may be used to restore default limits after they have been set explicitly.


setHLimitsDefault

public void setHLimitsDefault(int icol)
Sets default limits for the horizontal axis in the specified column. This method may be used to restore default limits after they have been set explicitly.

Parameters:
icol - the column index.

setVLimitsDefault

public void setVLimitsDefault(int irow)
Sets default limits for the vertical axis in the specified column. This method may be used to restore default limits after they have been set explicitly.

Parameters:
irow - the row index.

setHLabel

public void setHLabel(java.lang.String label)
Sets the label for the horizontal axis.

Parameters:
label - the label.

setVLabel

public void setVLabel(java.lang.String label)
Sets the label for the vertical axis.

Parameters:
label - the label.

setHLabel

public void setHLabel(int icol,
                      java.lang.String label)
Sets the label for the horizontal axis in the specified column.

Parameters:
icol - the column index.
label - the label.

setVLabel

public void setVLabel(int irow,
                      java.lang.String label)
Sets the label for the vertical axis in the specified row.

Parameters:
irow - the row index.
label - the label.

setHFormat

public void setHFormat(java.lang.String format)
Sets the format for the horizontal axis.

Parameters:
format - the format.

setVFormat

public void setVFormat(java.lang.String format)
Sets the format for the vertical axis.

Parameters:
format - the format.

setHFormat

public void setHFormat(int icol,
                       java.lang.String format)
Sets the format for the horizontal axis in the specified column.

Parameters:
icol - the column index.
format - the format.

setVFormat

public void setVFormat(int irow,
                       java.lang.String format)
Sets the format for the vertical axis in the specified row.

Parameters:
irow - the row index.
format - the format.

setHInterval

public void setHInterval(double interval)
Sets the tic interval for the horizontal axis.

Parameters:
interval - the major labeled tic interval.

setVInterval

public void setVInterval(double interval)
Sets the tic interval for the vertical axis.

Parameters:
interval - the major labeled tic interval.

setHInterval

public void setHInterval(int icol,
                         double interval)
Sets the tic interval for the horizontal axis in the specified column.

Parameters:
icol - the column index.
interval - the major labeled tic interval.

setVInterval

public void setVInterval(int irow,
                         double interval)
Sets the tic interval for the vertical axis in the specified column.

Parameters:
irow - the row index.
interval - the major labeled tic interval.

addGrid

public GridView addGrid()
Adds a grid view.

Returns:
the grid view.

addGrid

public GridView addGrid(java.lang.String parameters)
Adds a grid view with specified parameters string. For the format of the parameters string, see GridView.setParameters(String).

Parameters:
parameters - the parameters string.
Returns:
the grid view.

addGrid

public GridView addGrid(int irow,
                        int icol)
Adds a grid view.

Parameters:
irow - the tile row index.
icol - the tile column index.
Returns:
the grid view.

addGrid

public GridView addGrid(int irow,
                        int icol,
                        java.lang.String parameters)
Adds a grid view with specified parameters string. For the format of the parameters string, see GridView.setParameters(String).

Parameters:
irow - the tile row index.
icol - the tile column index.
parameters - the parameters string.
Returns:
the grid view.

addPixels

public PixelsView addPixels(float[][] f)
Adds a pixels view of the specified sampled function f(x1,x2). Assumes zero first sample values and unit sampling intervals.

Parameters:
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0].length and n2 = f.length.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(Sampling s1,
                            Sampling s2,
                            float[][] f)
Adds a pixels view of the specified sampled function f(x1,x2).

Parameters:
s1 - the sampling of the variable x1; must be uniform.
s2 - the sampling of the variable x2; must be uniform.
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0].length and n2 = f.length.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(int irow,
                            int icol,
                            float[][] f)
Adds a pixels view of the specified sampled function f(x1,x2). Assumes zero first sample values and unit sampling intervals.

Parameters:
irow - the tile row index.
icol - the tile column index.
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0].length and n2 = f.length.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(int irow,
                            int icol,
                            Sampling s1,
                            Sampling s2,
                            float[][] f)
Adds a pixels view of the specified sampled function f(x1,x2).

Parameters:
irow - the tile row index.
icol - the tile column index.
s1 - the sampling of the variable x1; must be uniform.
s2 - the sampling of the variable x2; must be uniform.
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0].length and n2 = f.length.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(float[][][] f)
Adds a pixels view of the specified sampled function f(x1,x2). Assumes zero first sample values and unit sampling intervals.

Parameters:
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0][0].length, n2 = f[0].length, and nc is the number of components.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(Sampling s1,
                            Sampling s2,
                            float[][][] f)
Adds a pixels view of the specified sampled function f(x1,x2).

Parameters:
s1 - the sampling of the variable x1; must be uniform.
s2 - the sampling of the variable x2; must be uniform.
f - array[n2][n1] of sampled function values f(x1,x2), where n1 = f[0][0].length, n2 = f[0].length, and nc is the number of components.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(int irow,
                            int icol,
                            float[][][] f)
Adds a pixels view of the specified sampled function f(x1,x2). Assumes zero first sample values and unit sampling intervals.

Parameters:
irow - the tile row index.
icol - the tile column index.
f - array[n2][n1] of sampled function values f(x1,x2), n1 = f[0][0].length, n2 = f[0].length, and nc is the number of components.
Returns:
the pixels view.

addPixels

public PixelsView addPixels(int irow,
                            int icol,
                            Sampling s1,
                            Sampling s2,
                            float[][][] f)
Adds a pixels view of the specified sampled function f(x1,x2).

Parameters:
irow - the tile row index.
icol - the tile column index.
s1 - the sampling of the variable x1; must be uniform.
s2 - the sampling of the variable x2; must be uniform.
f - array[n2][n1] of sampled function values f(x1,x2), n1 = f[0][0].length, n2 = f[0].length, and nc is the number of components.
Returns:
the pixels view.

addPoints

public PointsView addPoints(float[] x1,
                            float[] x2)
Adds a points view of the arrays x1 and x2 of point (x1,x2) coordinates.

Parameters:
x1 - array of x1 coordinates.
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(float[] x1,
                            float[] x2,
                            float[] x3)
Adds a points view of arrays x1, x2 and x3 of point (x1,x2,x3) coordinates.

Parameters:
x1 - array of x1 coordinates.
x2 - array of x2 coordinates.
x3 - array of x3 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(float[] x2)
Adds a points view of (x1,x2) with specified x2 coordinates. The corresponding coordinates x1 are assumed to be 0, 1, 2, ....

Parameters:
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(Sampling s1,
                            float[] x2)
Adds a view of points (x1,x2) for a sampled function x2(x1).

Parameters:
s1 - the sampling of x1 coordinates.
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(float[][] x1,
                            float[][] x2)
Adds a view of arrays of (x1,x2) coordinates for multiple plot segments. The lengths of the specified arrays x1 and x2 must be equal.

Parameters:
x1 - array of arrays of x1 coordinates.
x2 - array of arrays of x2 coordinates.

addPoints

public PointsView addPoints(int irow,
                            int icol,
                            float[] x1,
                            float[] x2)
Adds a points view of the arrays x1 and x2 of point (x1,x2) coordinates.

Parameters:
irow - the tile row index.
icol - the tile column index.
x1 - array of x1 coordinates.
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(int irow,
                            int icol,
                            float[] x1,
                            float[] x2,
                            float[] x3)
Adds a points view of arrays x1, x2 and x3 of point (x1,x2,x3) coordinates.

Parameters:
irow - the tile row index.
icol - the tile column index.
x1 - array of x1 coordinates.
x2 - array of x2 coordinates.
x3 - array of x3 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(int irow,
                            int icol,
                            float[] x2)
Adds a points view of (x1,x2) with specified x2 coordinates. The corresponding coordinates x1 are assumed to be 0, 1, 2, ....

Parameters:
irow - the tile row index.
icol - the tile column index.
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(int irow,
                            int icol,
                            Sampling s1,
                            float[] x2)
Adds a view of points (x1,x2) for a sampled function x2(x1).

Parameters:
irow - the tile row index.
icol - the tile column index.
s1 - the sampling of x1 coordinates.
x2 - array of x2 coordinates.
Returns:
the points view.

addPoints

public PointsView addPoints(int irow,
                            int icol,
                            float[][] x1,
                            float[][] x2)
Adds a view of arrays of (x1,x2) coordinates for multiple plot segments. The lengths of the specified arrays x1 and x2 must be equal.

Parameters:
irow - the tile row index.
icol - the tile column index.
x1 - array of arrays of x1 coordinates.
x2 - array of arrays of x2 coordinates.

addSequence

public SequenceView addSequence(float[] f)
Adds a sequence view with specified values f(x). Uses default sampling of x = 0, 1, 2, ....

Parameters:
f - array of sampled function values f(x).
Returns:
the sequence view.

addSequence

public SequenceView addSequence(Sampling sx,
                                float[] f)
Adds a sequence view with specified sampling and values f(x).

Parameters:
sx - the sampling of the variable x.
f - array of sampled function values f(x).
Returns:
the sequence view.

addSequence

public SequenceView addSequence(int irow,
                                int icol,
                                float[] f)
Adds a sequence view with specified values f(x). Uses default sampling of x = 0, 1, 2, ....

Parameters:
irow - the tile row index.
icol - the tile column index.
f - array of sampled function values f(x).
Returns:
the sequence view.

addSequence

public SequenceView addSequence(int irow,
                                int icol,
                                Sampling sx,
                                float[] f)
Adds a sequence view with specified sampling and values f(x).

Parameters:
irow - the tile row index.
icol - the tile column index.
sx - the sampling of the variable x.
f - array of sampled function values f(x).
Returns:
the sequence view.

addTiledView

public boolean addTiledView(TiledView tv)
Adds the specified tiled view to this plot panel. If the tiled view is already in this panel, it is first removed, before adding it again.

Parameters:
tv - the tiled view.
Returns:
true, if this panel did not already contain the specified tiled view; false, otherwise.

addTiledView

public boolean addTiledView(int irow,
                            int icol,
                            TiledView tv)
Adds the specified tiled view to this plot panel. If the tiled view is already in the specified tile, it is first removed, before adding it again.

Parameters:
irow - the tile row index.
icol - the tile column index.
tv - the tiled view.
Returns:
true, if the tile did not already contain the specified tiled view; false, otherwise.

remove

public boolean remove(TiledView tv)
Removes the specified tiled view from this plot panel.

Parameters:
tv - the tiled view.
Returns:
true, if this panel contained the specified tiled view; false, otherwise.

setFont

public void setFont(java.awt.Font font)
Sets the font in all components of this panel. Sets the title font to be 1.5 times larger than the specified font.

Overrides:
setFont in class javax.swing.JComponent
Parameters:
font - the font.

setForeground

public void setForeground(java.awt.Color color)
Sets the foreground color in all components of this panel.

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

setBackground

public void setBackground(java.awt.Color color)
Sets the background color in all components of this panel.

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