org.das2.graph

Class DataGeneralPathBuilder

java.lang.Object

org.das2.graph.DataGeneralPathBuilder

public final class DataGeneralPathBuilder
extends java.lang.Object

introduce class to handle the task of creating GeneralPaths from a series of data points. We notice that creating the GeneralPath is plenty fast, and it's rendering it that is slow, so this will allow for future optimizations.

See Also:

script:sftp://jbf@nudnik.physics.uiowa.edu/home/jbf/project/juno/users/masafumi/20171114/dataMasherDemo.jy

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROP_HISTOGRAM_MODE

Constructor Summary

Constructors

Constructor and Description
DataGeneralPathBuilder(DasAxis xaxis, DasAxis yaxis)

Method Summary

Modifier and Type	Method and Description
void	addBreak() manually assert that the line script be interrupted at this point.
void	addDataPoint(boolean valid, Datum x, Datum y) add a data point to the curve.
void	addDataPoint(boolean valid, double x, double y) add a point to the curve, where x and y are the magnitude in data coordinates.
void	finishThought()
double	getCadenceDouble() return the x cadence used as a double.
java.awt.geom.GeneralPath	getGeneralPath() get the generalPath for drawing.
java.awt.geom.PathIterator	getPathIterator() get the path iterator.
java.awt.geom.Point2D	getPenPosition() this is added so that the fill-to-zero code can add the returns.
Units	getXUnits() return the units of the xaxis.
Units	getYUnits() return the units of the yaxis.
void	insertLineTo(double x, double y) allow client to insert a point.
boolean	isCadenceRatiometric() return true if the spacing in x has been identified as ratiometric (linearly spaced on a log axis).
boolean	isHistogramMode()
void	setCadence(Datum sw) set the limit where two points are considered adjacent, or null if no check should be done.
void	setHistogramFillFlag() kludge to tell the builder to subtract a half cadence from the next point
void	setHistogramMode(boolean histogramMode)
void	setModuloY(Datum mody) set the value for which two values of Y are equivalent.
void	setName(java.lang.String name) set the name of this DataGeneralPathBuilder when logging.

Methods inherited from class java.lang.Object

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

Field Detail

PROP_HISTOGRAM_MODE

public static final java.lang.String PROP_HISTOGRAM_MODE

See Also:

Constant Field Values

Constructor Detail

DataGeneralPathBuilder

public DataGeneralPathBuilder(DasAxis xaxis,
                              DasAxis yaxis)

Method Detail

setCadence

public void setCadence(Datum sw)

set the limit where two points are considered adjacent, or null if no check should be done.

Parameters:

sw -

setModuloY

public void setModuloY(Datum mody)

set the value for which two values of Y are equivalent.

Parameters:

mody -

getCadenceDouble

public double getCadenceDouble()

return the x cadence used as a double. This is should interpreted with the xaxis units and with isCadenceRatiometric.

Returns:

the cadence as a double, or 1e38 if there is no cadence.

isHistogramMode

public boolean isHistogramMode()

setHistogramMode

public void setHistogramMode(boolean histogramMode)

getXUnits

public Units getXUnits()

return the units of the xaxis.

Returns:

the units of the xaxis.

getYUnits

public Units getYUnits()

return the units of the yaxis.

Returns:

the units of the yaxis.

isCadenceRatiometric

public boolean isCadenceRatiometric()

return true if the spacing in x has been identified as ratiometric (linearly spaced on a log axis). Note this is for the data, which is not necessarily the x axis setting.

Returns:

true if the data has been marked as ratiometric.

addDataPoint

public void addDataPoint(boolean valid,
                         Datum x,
                         Datum y)

add a data point to the curve.

Parameters:

valid - if invalid, then break the line at this point.

x - the x value

y - the y value

setHistogramFillFlag

public void setHistogramFillFlag()

kludge to tell the builder to subtract a half cadence from the next point

setName

public void setName(java.lang.String name)

set the name of this DataGeneralPathBuilder when logging.

Parameters:

name - "" or the name of the general path object in log messages.

addBreak

public void addBreak()

manually assert that the line script be interrupted at this point.

addDataPoint

public void addDataPoint(boolean valid,
                         double x,
                         double y)

add a point to the curve, where x and y are the magnitude in data coordinates.

Parameters:

valid - if invalid, then break the line at this point.

x - the x value in xaxis units.

y - the y value in yaxis units.

getGeneralPath

public java.awt.geom.GeneralPath getGeneralPath()

get the generalPath for drawing. This may affect the path, when histogramMode is true.

Returns:

the generalPath for drawing.

getPenPosition

public java.awt.geom.Point2D getPenPosition()

this is added so that the fill-to-zero code can add the returns.

Returns:

finishThought

public void finishThought()

insertLineTo

public void insertLineTo(double x,
                         double y)

allow client to insert a point. This is used when trying to implement the fill-to-zero.

Parameters:

x - pixel position

y - pixel position

getPathIterator

public java.awt.geom.PathIterator getPathIterator()

get the path iterator.

Returns:

the path iterator.