GraphUtil

java.lang.Object
- org.das2.graph.GraphUtil

```
public class GraphUtil
extends java.lang.Object
```
Utilities for drawing graphics and establishing standard behavior. This provides functions to get a 16x16 icon for a color, getting a Path from a series of data points, and a "visualize" method for simply looking at some data.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static interface`	`GraphUtil.Copyable<T>` Classes that implement this interface provide their instances with the ability to copy themselves in a manner similar to Cloneable objects, but without the drawbacks of Cloneable.
`static class`	`GraphUtil.DebuggingGeneralPath`

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`CONNECT_MODE_HISTOGRAM` draw the lines in histogram mode, horizontal to the half-way point, then vertical, then horizontal the rest of the way.
`static java.lang.String`	`CONNECT_MODE_SCATTER` don't draw connecting lines.
`static java.lang.String`	`CONNECT_MODE_SERIES` the normal connecting mode from point-to-point in a series.

Constructor Summary

Constructors
Constructor and Description

GraphUtil()

Constructors
Constructor and Description
`GraphUtil()`

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static java.awt.image.BufferedImage`	`blurImage(java.awt.image.BufferedImage im, int size)` blur the image with a Guassian blur.
`static java.awt.geom.AffineTransform`	`calculateAT(DasAxis xaxis0, DasAxis yaxis0, DasAxis xaxis1, DasAxis yaxis1)` calculates the AffineTransform between two sets of x and y axes, if possible.
`static java.awt.geom.AffineTransform`	`calculateAT(DatumRange xaxis0, DatumRange yaxis0, DasAxis xaxis1, DasAxis yaxis1)`
`static javax.swing.Icon`	`colorIcon(java.awt.Color iconColor, int w, int h)` return an icon block with the color and size.
`static DasAxis`	`copyAxis(DasAxis a)` return a copy of the plot.
`static DasColorBar`	`copyColorBar(DasColorBar a)` return a copy of the plot.
`static DasPlot`	`copyPlot(DasPlot p)` return a copy of the plot.
`static java.lang.String`	`describe(java.awt.geom.GeneralPath path, boolean enumeratePoints)` describe the path for debugging.
`static java.lang.String`	`getATScaleTranslateString(java.awt.geom.AffineTransform at)` return a string representation of the affine transforms used in DasPlot for debugging.
`static Converter`	`getFontConverter(DasCanvasComponent dcc, java.lang.String fallbackFont)` converts forward from relative font spec to point size, used by the annotation and axis nodes.
`static java.awt.image.ConvolveOp`	`getGaussianBlurFilter(int radius, boolean horizontal)` return a Gaussian filter for blurring images.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet ds, boolean histogram, boolean clip)` get the path for the points, checking for breaks in the data from fill values.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet xds, QDataSet yds, boolean histogram, boolean clip)` get the path for the points, checking for breaks in the data from fill values.
`static java.awt.geom.GeneralPath`	`getPath(DasAxis xAxis, DasAxis yAxis, QDataSet xds, QDataSet yds, java.lang.String mode, boolean clip)` get the path for the points, checking for breaks in the data from fill values.
`static java.awt.Color`	`getRicePaperColor()` return translucent white color for indicating the application is busy.
`static double[]`	`getSlopeIntercept(double x0, double y0, double x1, double y1)` calculates the slope and intercept of a line going through two points.
`static DasPlot`	`guessPlot(QDataSet ds)` get a plot and renderer for the dataset.
`static Renderer`	`guessRenderer(QDataSet ds)` legacy guess that is used who-knows-where.
`static DasAxis`	`guessXAxis(QDataSet ds)`
`static DasAxis`	`guessYAxis(QDataSet dsz)`
`static DasAxis`	`guessZAxis(QDataSet dsz)`
`static DatumRange`	`invTransformRange(DasAxis axis, double x1, double x2)`
`static java.awt.geom.Point2D`	`lineIntersection(java.awt.geom.Line2D line1, java.awt.geom.Line2D line2, boolean noBoundsCheck)` returns the point where the two line segments intersect, or null.
`static java.awt.geom.Point2D`	`lineRectangleIntersection(java.awt.geom.Point2D p0, java.awt.geom.Point2D p1, java.awt.geom.Rectangle2D r0)`
`static DasPlot`	`newDasPlot(DasCanvas canvas, DatumRange x, DatumRange y)` create a plot for the canvas, along with the row and column for layout.
`static double`	`pointsAlongCurve(java.awt.geom.PathIterator it, double[] pathlen, java.awt.geom.Point2D.Double[] result, double[] orientation, boolean stopAtMoveTo)` return the points along a curve.
`static int`	`reducePath(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result)` Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points.
`static int`	`reducePath(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result, int res)` Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points.
`static int`	`reducePath20140622(java.awt.geom.PathIterator it, java.awt.geom.GeneralPath result, int resn, int resd)` New ReducePath reduces a path by keeping track of vertically collinear points, and reducing them to an entry point, an exit point, min and max.
`static java.awt.Rectangle`	`shrinkRectangle(java.awt.Rectangle bounds, int percent)` return rectangle with same center that is percent/100 of the original width and height.
`static double[]`	`transformRange(DasAxis axis, DatumRange range)` returns pixel range of the datum range, guarenteeing that the first element will be less than or equal to the second.
`static DasPlot`	`visualize(QDataSet ds)` get a plot and add it to a JFrame.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CONNECT_MODE_HISTOGRAM
```
public static final java.lang.String CONNECT_MODE_HISTOGRAM
```
    draw the lines in histogram mode, horizontal to the half-way point, then vertical, then horizontal the rest of the way.
    
    See Also:
    
    Constant Field Values
  - CONNECT_MODE_SCATTER
```
public static final java.lang.String CONNECT_MODE_SCATTER
```
    don't draw connecting lines.
    
    See Also:
    
    Constant Field Values
  - CONNECT_MODE_SERIES
```
public static final java.lang.String CONNECT_MODE_SERIES
```
    the normal connecting mode from point-to-point in a series.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - GraphUtil
```
public GraphUtil()
```
- Method Detail
  - newDasPlot
```
public static DasPlot newDasPlot(DasCanvas canvas,
                                 DatumRange x,
                                 DatumRange y)
```
    create a plot for the canvas, along with the row and column for layout.
    
    Parameters:
    
    canvas - the canvas parent for the plot.
    
    x - the x range
    
    y - the y range
    
    Returns:
    
    the plot.
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet ds,
                                                boolean histogram,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    ds - the y values. SemanticOps.xtagsDataSet is used to extract the x values.
    
    histogram - if true, use histogram (stair-step) mode
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet xds,
                                                QDataSet yds,
                                                boolean histogram,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    xds - the x values.
    
    yds - the y values.
    
    histogram - if true, use histogram (stair-step) mode
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
  - getPath
```
public static java.awt.geom.GeneralPath getPath(DasAxis xAxis,
                                                DasAxis yAxis,
                                                QDataSet xds,
                                                QDataSet yds,
                                                java.lang.String mode,
                                                boolean clip)
```
    get the path for the points, checking for breaks in the data from fill values.
    
    Parameters:
    
    xAxis - the x axis.
    
    yAxis - the y axis.
    
    xds - the x values.
    
    yds - the y values.
    
    mode - one of CONNECT_MODE_SERIES, CONNECT_MODE_SCATTER, or CONNECT_MODE_HISTOGRAM
    
    clip - limit path to what's visible for each axis.
    
    Returns:
    
    the GeneralPath.
    
    See Also:
    
    CONNECT_MODE_SERIES, CONNECT_MODE_SCATTER, CONNECT_MODE_HISTOGRAM
  - calculateAT
```
public static java.awt.geom.AffineTransform calculateAT(DasAxis xaxis0,
                                                        DasAxis yaxis0,
                                                        DasAxis xaxis1,
                                                        DasAxis yaxis1)
```
    calculates the AffineTransform between two sets of x and y axes, if possible.
    
    Parameters:
    
    xaxis0 - the original reference frame x axis
    
    yaxis0 - the original reference frame y axis
    
    xaxis1 - the new reference frame x axis
    
    yaxis1 - the new reference frame y axis
    
    Returns:
    
    an AffineTransform that transforms data positioned with xaxis0 and yaxis0 on xaxis1 and yaxis1, or null if no such transform exists.
  - calculateAT
```
public static java.awt.geom.AffineTransform calculateAT(DatumRange xaxis0,
                                                        DatumRange yaxis0,
                                                        DasAxis xaxis1,
                                                        DasAxis yaxis1)
```
  - guessYAxis
```
public static DasAxis guessYAxis(QDataSet dsz)
```
  - guessXAxis
```
public static DasAxis guessXAxis(QDataSet ds)
```
  - guessZAxis
```
public static DasAxis guessZAxis(QDataSet dsz)
```
  - guessRenderer
```
public static Renderer guessRenderer(QDataSet ds)
```
    legacy guess that is used who-knows-where. Autoplot has much better code for guessing, refer to it.
    
    Parameters:
    
    ds -
    
    Returns:
  - guessPlot
```
public static DasPlot guessPlot(QDataSet ds)
```
    get a plot and renderer for the dataset.
    
    Parameters:
    
    ds - the dataset
    
    Returns:
    
    a plot with a renderer for the dataset.
  - copyAxis
```
public static DasAxis copyAxis(DasAxis a)
```
    return a copy of the plot. It does not have the row and column set to its own row and column.
    
    Parameters:
    
    a -
    
    Returns:
  - copyColorBar
```
public static DasColorBar copyColorBar(DasColorBar a)
```
    return a copy of the plot. It does not have the row and column set to its own row and column.
    
    Parameters:
    
    a -
    
    Returns:
  - copyPlot
```
public static DasPlot copyPlot(DasPlot p)
```
    return a copy of the plot. This will include the Renderers and the data they contain. The plot is not attached to a canvas or row and column.
```
 
   cnvsNew= new DasCanvas(500,500);
   row= new DasRow(cnvsNew,0.2,0.8);
   column= new DasColumn(cnvsNew,0.2,0.8);
   p= GraphUtil.copyPlot(dp); 
   cnvsNew.add(p,row,column); 
 
 
```
    Parameters:
    
    p -
    
    Returns:
  - visualize
```
public static DasPlot visualize(QDataSet ds)
```
    get a plot and add it to a JFrame.
    
    Parameters:
    
    ds -
    
    Returns:
  - reducePath20140622
```
public static int reducePath20140622(java.awt.geom.PathIterator it,
                                     java.awt.geom.GeneralPath result,
                                     int resn,
                                     int resd)
```
    New ReducePath reduces a path by keeping track of vertically collinear points, and reducing them to an entry point, an exit point, min and max. This can be all four in one point. We also limit the resolution and combine points that are basically the same value, using resn and resd (numerator and denominator). For example (1/5) would mean that points within x of 1/5 of one another are considered vertically collinear.
    
    Parameters:
    
    it - input path.
    
    result - output path.
    
    resn - the resolution numerator (e.g. 1)
    
    resd - the resolution denominator (e.g. 5)
    
    Returns:
    
    the reduced path.
  - reducePath
```
public static int reducePath(java.awt.geom.PathIterator it,
                             java.awt.geom.GeneralPath result)
```
    Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points. We bin average the points within a cell, because discretization would mess up the label orientation in contour plotting. a new GeneralPath which will be rendered identically to the input path, but contains a minimal number of points.
    
    Parameters:
    
    it - A path iterator with minute details that will be lost when rendering.
    
    result - A GeneralPath to put the result into.
    
    Returns:
    
    the number of "points" (LINE_TOs) in the result.
  - reducePath
```
public static int reducePath(java.awt.geom.PathIterator it,
                             java.awt.geom.GeneralPath result,
                             int res)
```
    Returns the input GeneralPath filled with new points which will be rendered identically to the input path, but contains a minimal number of points. We bin average the points within a cell, because discretization would mess up the label orientation in contour plotting. a new GeneralPath which will be rendered identically to the input path, but contains a minimal number of points.
    
    Parameters:
    
    it - A path iterator with minute details that will be lost when rendering.
    
    result - A GeneralPath to put the result into.
    
    res - limit the resolution in pixels
    
    Returns:
    
    the number of "points" (LINE_TOs) in the result.
  - pointsAlongCurve
```
public static double pointsAlongCurve(java.awt.geom.PathIterator it,
                                      double[] pathlen,
                                      java.awt.geom.Point2D.Double[] result,
                                      double[] orientation,
                                      boolean stopAtMoveTo)
```
    return the points along a curve. Used by ContourRenderer. The returned result is the remaining path length. Elements of pathlen that are beyond the total path length are not computed, and the result points will be null.
    
    Parameters:
    
    pathlen - monotonically increasing path lengths at which the position is to be located. May be null if only the total path length is desired.
    
    result - the resultant points will be put into this array. This array should have the same number of elements as pathlen
    
    orientation - the local orientation, in radians, of the point at will be put into this array. This array should have the same number of elements as pathlen
    
    it - PathIterator first point is used to start the length.
    
    stopAtMoveTo - treat SEG_MOVETO as the end of the path. The pathIterator will be left at this point.
    
    Returns:
    
    the remaining length. Note null may be used for pathlen, result, and orientation and this will simply return the total path length.
  - getATScaleTranslateString
```
public static java.lang.String getATScaleTranslateString(java.awt.geom.AffineTransform at)
```
    return a string representation of the affine transforms used in DasPlot for debugging.
    
    Parameters:
    
    at - the affine transform
    
    Returns:
    
    a string representation of the affine transforms used in DasPlot for debugging.
  - getSlopeIntercept
```
public static double[] getSlopeIntercept(double x0,
                                         double y0,
                                         double x1,
                                         double y1)
```
    calculates the slope and intercept of a line going through two points.
    
    Parameters:
    
    x0 - the first point x
    
    y0 - the first point y
    
    x1 - the second point x
    
    y1 - the second point y
    
    Returns:
    
    a double array with two elements [ slope, intercept ].
  - getRicePaperColor
```
public static java.awt.Color getRicePaperColor()
```
    return translucent white color for indicating the application is busy.
    
    Returns:
    
    translucent white color
  - getGaussianBlurFilter
```
public static java.awt.image.ConvolveOp getGaussianBlurFilter(int radius,
                                                              boolean horizontal)
```
    return a Gaussian filter for blurring images.
    
    Parameters:
    
    radius - the radius filter in pixels.
    
    horizontal - true if horizontal blur.
    
    Returns:
    
    the ConvolveOp
  - blurImage
```
public static java.awt.image.BufferedImage blurImage(java.awt.image.BufferedImage im,
                                                     int size)
```
    blur the image with a Guassian blur.
    
    Parameters:
    
    im -
    
    size - the size of the blur, roughly in pixels.
    
    Returns:
    
    image
  - describe
```
public static java.lang.String describe(java.awt.geom.GeneralPath path,
                                        boolean enumeratePoints)
```
    describe the path for debugging.
    
    Parameters:
    
    path - the Path to describe
    
    enumeratePoints - if true, print all the points as well.
    
    Returns:
    
    String description.
  - lineIntersection
```
public static java.awt.geom.Point2D lineIntersection(java.awt.geom.Line2D line1,
                                                     java.awt.geom.Line2D line2,
                                                     boolean noBoundsCheck)
```
    returns the point where the two line segments intersect, or null.
    
    Parameters:
    
    line1 -
    
    line2 -
    
    noBoundsCheck - if true, then do not check the segment bounds.
    
    Returns:
  - lineRectangleIntersection
```
public static java.awt.geom.Point2D lineRectangleIntersection(java.awt.geom.Point2D p0,
                                                              java.awt.geom.Point2D p1,
                                                              java.awt.geom.Rectangle2D r0)
```
  - transformRange
```
public static double[] transformRange(DasAxis axis,
                                      DatumRange range)
```
    returns pixel range of the datum range, guarenteeing that the first element will be less than or equal to the second.
    
    Parameters:
    
    axis -
    
    range -
    
    Returns:
  - invTransformRange
```
public static DatumRange invTransformRange(DasAxis axis,
                                           double x1,
                                           double x2)
```
  - colorIcon
```
public static javax.swing.Icon colorIcon(java.awt.Color iconColor,
                                         int w,
                                         int h)
```
    return an icon block with the color and size.
    
    Parameters:
    
    iconColor - the color
    
    w - the width in pixels
    
    h - the height in pixels
    
    Returns:
    
    an icon.
  - shrinkRectangle
```
public static java.awt.Rectangle shrinkRectangle(java.awt.Rectangle bounds,
                                                 int percent)
```
    return rectangle with same center that is percent/100 of the original width and height.
    
    Parameters:
    
    bounds - the original rectangle.
    
    percent - the percent to increase (110% is 10% bigger)
    
    Returns:
    
    return rectangle with same center that is percent/100 of the original width and height.
  - getFontConverter
```
public static Converter getFontConverter(DasCanvasComponent dcc,
                                         java.lang.String fallbackFont)
```
    converts forward from relative font spec to point size, used by the annotation and axis nodes.
    
    Parameters:
    
    dcc - the canvas component.
    
    fallbackFont - the font to use when a font is not available, like "sans-8"
    
    Returns:
    
    the converter that converts between strings like "1em" and the font.

Class GraphUtil

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CONNECT_MODE_HISTOGRAM

CONNECT_MODE_SCATTER

CONNECT_MODE_SERIES

Constructor Detail

GraphUtil

Method Detail

newDasPlot

getPath

getPath

getPath

calculateAT

calculateAT

guessYAxis

guessXAxis

guessZAxis

guessRenderer

guessPlot

copyAxis

copyColorBar

copyPlot

visualize

reducePath20140622

reducePath

reducePath

pointsAlongCurve

getATScaleTranslateString

getSlopeIntercept

getRicePaperColor

getGaussianBlurFilter

blurImage

describe

lineIntersection

lineRectangleIntersection

transformRange

invTransformRange

colorIcon

shrinkRectangle

getFontConverter