. This
renderer requires a
).
This renderer does not include any code to calculate the crosshair point.
| Method from org.jfree.chart.renderer.xy.XYBoxAndWhiskerRenderer Detail: |
public Object clone() throws CloneNotSupportedException {
return super.clone();
}
Returns a clone of the renderer. |
protected void drawEllipse(Point2D point,
double oRadius,
Graphics2D g2) {
Ellipse2D.Double dot = new Ellipse2D.Double(point.getX() + oRadius / 2,
point.getY(), oRadius, oRadius);
g2.draw(dot);
}
Draws an ellipse to represent an outlier. |
protected void drawHighFarOut(double aRadius,
Graphics2D g2,
double xx,
double m) {
double side = aRadius * 2;
g2.draw(new Line2D.Double(xx - side, m + side, xx + side, m + side));
g2.draw(new Line2D.Double(xx - side, m + side, xx, m));
g2.draw(new Line2D.Double(xx + side, m + side, xx, m));
}
Draws a triangle to indicate the presence of far out values. |
public void drawHorizontalItem(Graphics2D g2,
Rectangle2D dataArea,
PlotRenderingInfo info,
XYPlot plot,
ValueAxis domainAxis,
ValueAxis rangeAxis,
XYDataset dataset,
int series,
int item,
CrosshairState crosshairState,
int pass) {
// setup for collecting optional entity info...
EntityCollection entities = null;
if (info != null) {
entities = info.getOwner().getEntityCollection();
}
BoxAndWhiskerXYDataset boxAndWhiskerData
= (BoxAndWhiskerXYDataset) dataset;
Number x = boxAndWhiskerData.getX(series, item);
Number yMax = boxAndWhiskerData.getMaxRegularValue(series, item);
Number yMin = boxAndWhiskerData.getMinRegularValue(series, item);
Number yMedian = boxAndWhiskerData.getMedianValue(series, item);
Number yAverage = boxAndWhiskerData.getMeanValue(series, item);
Number yQ1Median = boxAndWhiskerData.getQ1Value(series, item);
Number yQ3Median = boxAndWhiskerData.getQ3Value(series, item);
double xx = domainAxis.valueToJava2D(x.doubleValue(), dataArea,
plot.getDomainAxisEdge());
RectangleEdge location = plot.getRangeAxisEdge();
double yyMax = rangeAxis.valueToJava2D(yMax.doubleValue(), dataArea,
location);
double yyMin = rangeAxis.valueToJava2D(yMin.doubleValue(), dataArea,
location);
double yyMedian = rangeAxis.valueToJava2D(yMedian.doubleValue(),
dataArea, location);
double yyAverage = 0.0;
if (yAverage != null) {
yyAverage = rangeAxis.valueToJava2D(yAverage.doubleValue(),
dataArea, location);
}
double yyQ1Median = rangeAxis.valueToJava2D(yQ1Median.doubleValue(),
dataArea, location);
double yyQ3Median = rangeAxis.valueToJava2D(yQ3Median.doubleValue(),
dataArea, location);
double exactBoxWidth = getBoxWidth();
double width = exactBoxWidth;
double dataAreaX = dataArea.getHeight();
double maxBoxPercent = 0.1;
double maxBoxWidth = dataAreaX * maxBoxPercent;
if (exactBoxWidth < = 0.0) {
int itemCount = boxAndWhiskerData.getItemCount(series);
exactBoxWidth = dataAreaX / itemCount * 4.5 / 7;
if (exactBoxWidth < 3) {
width = 3;
}
else if (exactBoxWidth > maxBoxWidth) {
width = maxBoxWidth;
}
else {
width = exactBoxWidth;
}
}
g2.setPaint(getItemPaint(series, item));
Stroke s = getItemStroke(series, item);
g2.setStroke(s);
// draw the upper shadow
g2.draw(new Line2D.Double(yyMax, xx, yyQ3Median, xx));
g2.draw(new Line2D.Double(yyMax, xx - width / 2, yyMax,
xx + width / 2));
// draw the lower shadow
g2.draw(new Line2D.Double(yyMin, xx, yyQ1Median, xx));
g2.draw(new Line2D.Double(yyMin, xx - width / 2, yyMin,
xx + width / 2));
// draw the body
Shape box = null;
if (yyQ1Median < yyQ3Median) {
box = new Rectangle2D.Double(yyQ1Median, xx - width / 2,
yyQ3Median - yyQ1Median, width);
}
else {
box = new Rectangle2D.Double(yyQ3Median, xx - width / 2,
yyQ1Median - yyQ3Median, width);
}
if (this.fillBox) {
g2.setPaint(lookupBoxPaint(series, item));
g2.fill(box);
}
g2.setStroke(getItemOutlineStroke(series, item));
g2.setPaint(getItemOutlinePaint(series, item));
g2.draw(box);
// draw median
g2.setPaint(getArtifactPaint());
g2.draw(new Line2D.Double(yyMedian,
xx - width / 2, yyMedian, xx + width / 2));
// draw average - SPECIAL AIMS REQUIREMENT
if (yAverage != null) {
double aRadius = width / 4;
// here we check that the average marker will in fact be visible
// before drawing it...
if ((yyAverage > (dataArea.getMinX() - aRadius))
&& (yyAverage < (dataArea.getMaxX() + aRadius))) {
Ellipse2D.Double avgEllipse = new Ellipse2D.Double(
yyAverage - aRadius, xx - aRadius, aRadius * 2,
aRadius * 2);
g2.fill(avgEllipse);
g2.draw(avgEllipse);
}
}
// FIXME: draw outliers
// add an entity for the item...
if (entities != null && box.intersects(dataArea)) {
addEntity(entities, box, dataset, series, item, yyAverage, xx);
}
}
Draws the visual representation of a single data item. |
public void drawItem(Graphics2D g2,
XYItemRendererState state,
Rectangle2D dataArea,
PlotRenderingInfo info,
XYPlot plot,
ValueAxis domainAxis,
ValueAxis rangeAxis,
XYDataset dataset,
int series,
int item,
CrosshairState crosshairState,
int pass) {
PlotOrientation orientation = plot.getOrientation();
if (orientation == PlotOrientation.HORIZONTAL) {
drawHorizontalItem(g2, dataArea, info, plot, domainAxis, rangeAxis,
dataset, series, item, crosshairState, pass);
}
else if (orientation == PlotOrientation.VERTICAL) {
drawVerticalItem(g2, dataArea, info, plot, domainAxis, rangeAxis,
dataset, series, item, crosshairState, pass);
}
}
Draws the visual representation of a single data item. |
protected void drawLowFarOut(double aRadius,
Graphics2D g2,
double xx,
double m) {
double side = aRadius * 2;
g2.draw(new Line2D.Double(xx - side, m - side, xx + side, m - side));
g2.draw(new Line2D.Double(xx - side, m - side, xx, m));
g2.draw(new Line2D.Double(xx + side, m - side, xx, m));
}
Draws a triangle to indicate the presence of far out values. |
protected void drawMultipleEllipse(Point2D point,
double boxWidth,
double oRadius,
Graphics2D g2) {
Ellipse2D.Double dot1 = new Ellipse2D.Double(point.getX()
- (boxWidth / 2) + oRadius, point.getY(), oRadius, oRadius);
Ellipse2D.Double dot2 = new Ellipse2D.Double(point.getX()
+ (boxWidth / 2), point.getY(), oRadius, oRadius);
g2.draw(dot1);
g2.draw(dot2);
}
Draws two ellipses to represent overlapping outliers. |
public void drawVerticalItem(Graphics2D g2,
Rectangle2D dataArea,
PlotRenderingInfo info,
XYPlot plot,
ValueAxis domainAxis,
ValueAxis rangeAxis,
XYDataset dataset,
int series,
int item,
CrosshairState crosshairState,
int pass) {
// setup for collecting optional entity info...
EntityCollection entities = null;
if (info != null) {
entities = info.getOwner().getEntityCollection();
}
BoxAndWhiskerXYDataset boxAndWhiskerData
= (BoxAndWhiskerXYDataset) dataset;
Number x = boxAndWhiskerData.getX(series, item);
Number yMax = boxAndWhiskerData.getMaxRegularValue(series, item);
Number yMin = boxAndWhiskerData.getMinRegularValue(series, item);
Number yMedian = boxAndWhiskerData.getMedianValue(series, item);
Number yAverage = boxAndWhiskerData.getMeanValue(series, item);
Number yQ1Median = boxAndWhiskerData.getQ1Value(series, item);
Number yQ3Median = boxAndWhiskerData.getQ3Value(series, item);
List yOutliers = boxAndWhiskerData.getOutliers(series, item);
double xx = domainAxis.valueToJava2D(x.doubleValue(), dataArea,
plot.getDomainAxisEdge());
RectangleEdge location = plot.getRangeAxisEdge();
double yyMax = rangeAxis.valueToJava2D(yMax.doubleValue(), dataArea,
location);
double yyMin = rangeAxis.valueToJava2D(yMin.doubleValue(), dataArea,
location);
double yyMedian = rangeAxis.valueToJava2D(yMedian.doubleValue(),
dataArea, location);
double yyAverage = 0.0;
if (yAverage != null) {
yyAverage = rangeAxis.valueToJava2D(yAverage.doubleValue(),
dataArea, location);
}
double yyQ1Median = rangeAxis.valueToJava2D(yQ1Median.doubleValue(),
dataArea, location);
double yyQ3Median = rangeAxis.valueToJava2D(yQ3Median.doubleValue(),
dataArea, location);
double yyOutlier;
double exactBoxWidth = getBoxWidth();
double width = exactBoxWidth;
double dataAreaX = dataArea.getMaxX() - dataArea.getMinX();
double maxBoxPercent = 0.1;
double maxBoxWidth = dataAreaX * maxBoxPercent;
if (exactBoxWidth < = 0.0) {
int itemCount = boxAndWhiskerData.getItemCount(series);
exactBoxWidth = dataAreaX / itemCount * 4.5 / 7;
if (exactBoxWidth < 3) {
width = 3;
}
else if (exactBoxWidth > maxBoxWidth) {
width = maxBoxWidth;
}
else {
width = exactBoxWidth;
}
}
g2.setPaint(getItemPaint(series, item));
Stroke s = getItemStroke(series, item);
g2.setStroke(s);
// draw the upper shadow
g2.draw(new Line2D.Double(xx, yyMax, xx, yyQ3Median));
g2.draw(new Line2D.Double(xx - width / 2, yyMax, xx + width / 2,
yyMax));
// draw the lower shadow
g2.draw(new Line2D.Double(xx, yyMin, xx, yyQ1Median));
g2.draw(new Line2D.Double(xx - width / 2, yyMin, xx + width / 2,
yyMin));
// draw the body
Shape box = null;
if (yyQ1Median > yyQ3Median) {
box = new Rectangle2D.Double(xx - width / 2, yyQ3Median, width,
yyQ1Median - yyQ3Median);
}
else {
box = new Rectangle2D.Double(xx - width / 2, yyQ1Median, width,
yyQ3Median - yyQ1Median);
}
if (this.fillBox) {
g2.setPaint(lookupBoxPaint(series, item));
g2.fill(box);
}
g2.setStroke(getItemOutlineStroke(series, item));
g2.setPaint(getItemOutlinePaint(series, item));
g2.draw(box);
// draw median
g2.setPaint(getArtifactPaint());
g2.draw(new Line2D.Double(xx - width / 2, yyMedian, xx + width / 2,
yyMedian));
double aRadius = 0; // average radius
double oRadius = width / 3; // outlier radius
// draw average - SPECIAL AIMS REQUIREMENT
if (yAverage != null) {
aRadius = width / 4;
// here we check that the average marker will in fact be visible
// before drawing it...
if ((yyAverage > (dataArea.getMinY() - aRadius))
&& (yyAverage < (dataArea.getMaxY() + aRadius))) {
Ellipse2D.Double avgEllipse = new Ellipse2D.Double(xx - aRadius,
yyAverage - aRadius, aRadius * 2, aRadius * 2);
g2.fill(avgEllipse);
g2.draw(avgEllipse);
}
}
List outliers = new ArrayList();
OutlierListCollection outlierListCollection
= new OutlierListCollection();
/* From outlier array sort out which are outliers and put these into
* an arraylist. If there are any farouts, set the flag on the
* OutlierListCollection
*/
for (int i = 0; i < yOutliers.size(); i++) {
double outlier = ((Number) yOutliers.get(i)).doubleValue();
if (outlier > boxAndWhiskerData.getMaxOutlier(series,
item).doubleValue()) {
outlierListCollection.setHighFarOut(true);
}
else if (outlier < boxAndWhiskerData.getMinOutlier(series,
item).doubleValue()) {
outlierListCollection.setLowFarOut(true);
}
else if (outlier > boxAndWhiskerData.getMaxRegularValue(series,
item).doubleValue()) {
yyOutlier = rangeAxis.valueToJava2D(outlier, dataArea,
location);
outliers.add(new Outlier(xx, yyOutlier, oRadius));
}
else if (outlier < boxAndWhiskerData.getMinRegularValue(series,
item).doubleValue()) {
yyOutlier = rangeAxis.valueToJava2D(outlier, dataArea,
location);
outliers.add(new Outlier(xx, yyOutlier, oRadius));
}
Collections.sort(outliers);
}
// Process outliers. Each outlier is either added to the appropriate
// outlier list or a new outlier list is made
for (Iterator iterator = outliers.iterator(); iterator.hasNext();) {
Outlier outlier = (Outlier) iterator.next();
outlierListCollection.add(outlier);
}
// draw yOutliers
double maxAxisValue = rangeAxis.valueToJava2D(rangeAxis.getUpperBound(),
dataArea, location) + aRadius;
double minAxisValue = rangeAxis.valueToJava2D(rangeAxis.getLowerBound(),
dataArea, location) - aRadius;
// draw outliers
for (Iterator iterator = outlierListCollection.iterator();
iterator.hasNext();) {
OutlierList list = (OutlierList) iterator.next();
Outlier outlier = list.getAveragedOutlier();
Point2D point = outlier.getPoint();
if (list.isMultiple()) {
drawMultipleEllipse(point, width, oRadius, g2);
}
else {
drawEllipse(point, oRadius, g2);
}
}
// draw farout
if (outlierListCollection.isHighFarOut()) {
drawHighFarOut(aRadius, g2, xx, maxAxisValue);
}
if (outlierListCollection.isLowFarOut()) {
drawLowFarOut(aRadius, g2, xx, minAxisValue);
}
// add an entity for the item...
if (entities != null && box.intersects(dataArea)) {
addEntity(entities, box, dataset, series, item, xx, yyAverage);
}
}
Draws the visual representation of a single data item. |
public boolean equals(Object obj) {
if (obj == this) {
return true;
}
if (!(obj instanceof XYBoxAndWhiskerRenderer)) {
return false;
}
if (!super.equals(obj)) {
return false;
}
XYBoxAndWhiskerRenderer that = (XYBoxAndWhiskerRenderer) obj;
if (this.boxWidth != that.getBoxWidth()) {
return false;
}
if (!PaintUtilities.equal(this.boxPaint, that.boxPaint)) {
return false;
}
if (!PaintUtilities.equal(this.artifactPaint, that.artifactPaint)) {
return false;
}
if (this.fillBox != that.fillBox) {
return false;
}
return true;
}
Tests this renderer for equality with another object. |
public Paint getArtifactPaint() {
return this.artifactPaint;
}
Returns the paint used to paint the various artifacts such as outliers,
farout symbol, median line and the averages ellipse. |
public Paint getBoxPaint() {
return this.boxPaint;
}
Returns the paint used to fill boxes. |
public double getBoxWidth() {
return this.boxWidth;
}
Returns the width of each box. |
public boolean getFillBox() {
return this.fillBox;
}
Returns the flag that controls whether or not the box is filled. |
protected Paint lookupBoxPaint(int series,
int item) {
Paint p = getBoxPaint();
if (p != null) {
return p;
}
else {
// TODO: could change this to itemFillPaint(). For backwards
// compatibility, it might require a useFillPaint flag.
return getItemPaint(series, item);
}
}
Returns the box paint or, if this is null, the item
paint. |
public void setArtifactPaint(Paint paint) {
if (paint == null) {
throw new IllegalArgumentException("Null 'paint' argument.");
}
this.artifactPaint = paint;
fireChangeEvent();
}
Sets the paint used to paint the various artifacts such as outliers,
farout symbol, median line and the averages ellipse, and sends a
RendererChangeEvent to all registered listeners. |
public void setBoxPaint(Paint paint) {
this.boxPaint = paint;
fireChangeEvent();
}
|
public void setBoxWidth(double width) {
if (width != this.boxWidth) {
this.boxWidth = width;
fireChangeEvent();
}
}
Sets the box width and sends a RendererChangeEvent to all
registered listeners.
If you set the width to a negative value, the renderer will calculate
the box width automatically based on the space available on the chart. |
public void setFillBox(boolean flag) {
this.fillBox = flag;
fireChangeEvent();
}
Sets the flag that controls whether or not the box is filled and sends a
RendererChangeEvent to all registered listeners. |