org.das2.graph

Class HugeScatterRenderer

java.lang.Object

org.das2.graph.Renderer

org.das2.graph.HugeScatterRenderer

All Implemented Interfaces:

Displayable, Editable, DataSetConsumer

public class HugeScatterRenderer
extends Renderer

HugeScatterRenderer This renderer can handle vector data sets with hundreds of thousands of points by histogramming the points and then creating a greyscale spectrogram of the histogram. The property "saturationHitCount" defines the number of pixel hits that will make the pixel black. This has been modified a lot over the years:

• connecting lines when the data is of timeseries,
• alternate modes are used when we zoom in closely,
• support for QDataSets and waveform scheme data,
• lone pixels are highlighted.

Created on April 14, 2005, 8:45 PM

Field Summary

Fields

Modifier and Type	Field and Description
protected int	envelope
protected static java.util.logging.Logger	logger
static java.lang.String	PROP_ENVELOPE

Fields inherited from class org.das2.graph.Renderer

bottomDecorator, colorBar, control, CONTROL_KEY_COLOR, CONTROL_KEY_COLOR_TABLE, CONTROL_KEY_DRAW_ERROR, CONTROL_KEY_FILL_COLOR, CONTROL_KEY_FILL_DIRECTION, CONTROL_KEY_FILL_TEXTURE, CONTROL_KEY_FONT_SIZE, CONTROL_KEY_LINE_STYLE, CONTROL_KEY_LINE_THICK, CONTROL_KEY_MODULO_X, CONTROL_KEY_MODULO_Y, CONTROL_KEY_REFERENCE, CONTROL_KEY_SPECIAL_COLORS, CONTROL_KEY_SYMBOL, CONTROL_KEY_SYMBOL_SIZE, drawLegendLabel, ds, firstValidIndex, id, lastException, lastValidIndex, legendLabel, MARKER_DATASET, MARKER_X_AXIS_RANGE, MARKER_Y_AXIS_RANGE, needWorkMarkers, PROP_ACTIVE, PROP_BOTTOMDECORATOR, PROP_COLORBAR, PROP_CONTROL, PROP_DRAWLEGENDLABEL, PROP_ID, PROP_LEGENDLABEL, PROP_RECORDFILE, PROP_TOPDECORATOR, propertyChangeSupport, renderException, topDecorator

Constructor Summary

Constructors

Constructor and Description
HugeScatterRenderer(DataSetDescriptor dsd)

Method Summary

Modifier and Type	Method and Description
boolean	acceptContext(int x, int y) Returns true if the render will accept the context for a point.
static QDataSet	doAutorange(QDataSet ds)
java.awt.Color	getColor()
int	getEnvelope()
javax.swing.Icon	getListIcon() An icon can be provided that will be shown in a list along with the textual description of the element.
int	getSaturationHitCount()
boolean	isPrint300dpi() Getter for property draw300dpi.
void	render(java.awt.Graphics2D g1, DasAxis xAxis, DasAxis yAxis) Render is called whenever the image needs to be refreshed or the content has changed.
java.awt.Shape	selectionArea() return a Shape object showing where the data lie and focus should be accepted.
void	setColor(java.awt.Color color)
void	setDataSet(QDataSet ds) Set the dataset to be plotted.
void	setEnvelope(int envelope) 0=none.
void	setPrint300dpi(boolean print300dpi) Setter for property draw300dpi.
void	setSaturationHitCount(int d)
void	updatePlotImage(DasAxis xAxis, DasAxis yAxis, ProgressMonitor monitor) updatePlotImage is called once the expensive operation of loading the data is completed.

Methods inherited from class org.das2.graph.Renderer

acceptsDataSet, addPropertyChangeListener, addPropertyChangeListener, addToStats, decodeDatum, decodeFillStyle, decodePlotSymbolConnectorControl, decodePlotSymbolControl, drawListIcon, encodeBooleanControl, encodeColorControl, encodeDatum, encodeFillStyle, encodePlotSymbolConnectorControl, encodePlotSymbolControl, formatControl, getAffineTransform, getBooleanControl, getBottomDecorator, getColorBar, getColorControl, getConsumedDataSet, getControl, getControl, getDataLoader, getDataSet, getDataSetDescriptor, getDataSetID, getDatumControl, getDoubleArrayControl, getDoubleControl, getId, getIntegerControl, getInternalDataSet, getLastException, getLegendLabel, getListLabel, getParent, getRenderCount, getStatsFile, getTopDecorator, getUpdateCount, getXmemento, getYmemento, hasControl, incrementRenderCount, incrementUpdateCount, installRenderer, invalidateParentCacheImage, isActive, isDrawLegendLabel, isDumpDataSet, isTableDataSet, parseControl, parseLayoutString, postException, postMessage, postMessage, refresh, refreshImage, removePropertyChangeListener, removePropertyChangeListener, renderException, resetCounters, setActive, setBottomDecorator, setColorBar, setControl, setDataSetDescriptor, setDataSetID, setDataSetLoader, setDrawLegendLabel, setDumpDataSet, setException, setId, setLastException, setLegendLabel, setParent, setStatsFile, setTopDecorator, setUpFont, setUpFont, uninstallRenderer, update, updateCacheImage, updateImmediately

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

protected static final java.util.logging.Logger logger

envelope

protected int envelope

PROP_ENVELOPE

public static final java.lang.String PROP_ENVELOPE

See Also:

Constant Field Values

Constructor Detail

HugeScatterRenderer

public HugeScatterRenderer(DataSetDescriptor dsd)

Method Detail

getListIcon

public javax.swing.Icon getListIcon()

Description copied from interface: Displayable

An icon can be provided that will be shown in a list along with the textual description of the element. This method should return null if there is no icon available, or a roughly 16x16 pixel icon.

Specified by:

getListIcon in interface Displayable

Overrides:

getListIcon in class Renderer

Returns:

the icon.

setDataSet

public void setDataSet(QDataSet ds)

Description copied from class: Renderer

Set the dataset to be plotted. Different renderers accept QDataSets with different schemes. For example SeriesRenderer takes: ds[t] rank 1 dataset with rank 1 DEPEND_0 or ds[t,n] rank 2 bundle dataset with X in ds[t,0] and Y in ds[t,n-1] and SpectrogramRenderer takes: ds[t,y] rank 2 table dataset ds[n,t,y] rank 3 dataset with the first dimension join See each renderer's documentation for the schemes it takes. Note the lastException property is cleared, even when the dataset is null.

Overrides:

setDataSet in class Renderer

doAutorange

public static QDataSet doAutorange(QDataSet ds)

render

public void render(java.awt.Graphics2D g1,
                   DasAxis xAxis,
                   DasAxis yAxis)

Description copied from class: Renderer

Render is called whenever the image needs to be refreshed or the content has changed. This operation should occur with an animation-interactive time scale, and an image should be cached when this is not possible. The graphics object will have its origin at the upper-left corner of the screen.

Specified by:

render in class Renderer

Parameters:

g1 - the graphics context in the canvas reference frame.

xAxis - the axis relating x data coordinates to horizontal pixel coordinates

yAxis - the axis relating y data coordinates to horizontal pixel coordinates

updatePlotImage

public void updatePlotImage(DasAxis xAxis,
                            DasAxis yAxis,
                            ProgressMonitor monitor)
                     throws DasException

Description copied from class: Renderer

updatePlotImage is called once the expensive operation of loading the data is completed. This operation should occur on an interactive time scale. This is an opportunity to create a cache image of the data with the current axis state, when the render operation cannot operate on an animation interactive time scale. Also, several Renders can be updating at once on separate threads, while the render methods must be called sequentially. Only Renderer should call this method! (This should be protected then, but this is not possible because of exiting use. TODO: introduce "revalidate" to replace this operation.)

Overrides:

updatePlotImage in class Renderer

Parameters:

xAxis - the axis relating x data coordinates to horizontal pixel coordinates

yAxis - the axis relating y data coordinates to horizontal pixel coordinates

monitor - a monitor for the operation. Note the updatePlotImage operation should be fast (<1000ms).

Throws:

DasException

setSaturationHitCount

public void setSaturationHitCount(int d)

getSaturationHitCount

public int getSaturationHitCount()

setColor

public void setColor(java.awt.Color color)

getColor

public java.awt.Color getColor()

getEnvelope

public int getEnvelope()

setEnvelope

public void setEnvelope(int envelope)

0=none. 1=faint envelope with points on top. 2=only envelope

Parameters:

envelope -

acceptContext

public boolean acceptContext(int x,
                             int y)

Description copied from class: Renderer

Returns true if the render will accept the context for a point. That is, the renderer affected that point, or nearby points. This is used currently to provide a way for the operator to click on a plot and directly edit the renderer which drew the pixel.

Overrides:

acceptContext in class Renderer

Parameters:

x - the x coordinate in the canvas coordinate system.

y - the y coordinate in the canvas coordinate system.

Returns:

true if the renderer will accept the context.

isPrint300dpi

public boolean isPrint300dpi()

Getter for property draw300dpi.

Returns:

Value of property draw300dpi.

setPrint300dpi

public void setPrint300dpi(boolean print300dpi)

Setter for property draw300dpi.

Parameters:

print300dpi - New value of property draw300dpi.

selectionArea

public java.awt.Shape selectionArea()

return a Shape object showing where the data lie and focus should be accepted.

Returns: