SSJ
V. 2.6.

umontreal.iro.lecuyer.charts
Class XYChart

java.lang.Object
  extended by umontreal.iro.lecuyer.charts.XYChart
Direct Known Subclasses:
EmpiricalChart, HistogramChart, ScatterChart, XYLineChart

public abstract class XYChart
extends Object

This class provides tools to create charts from data in a simple way. Its main feature is to produce TikZ/PGF (see WWW link http://sourceforge.net/projects/pgf/) compatible source code which can be included in LATEX documents, but it can also produce charts in other formats. One can easily create a new chart, and customize its appearance using methods of this class, with the encapsulated SSJXYSeriesCollection object representing the data, and the two Axis objects representing the axes. All these classes depend on the JFreeChart API (see WWW link http://www.jfree.org/jfreechart/) which provides tools to build charts with Java, to draw them, and export them to files. However, only basic features are used here.

Moreover, XYChart provides methods to plot data using a MATLAB friendly syntax. None of these methods provides new features; they just propose a different syntax to create charts. Therefore some features are unavailable when using these methods only.


Constructor Summary
XYChart()
           
 
Method Summary
 void disableGrid()
          Disables the background grid.
 void drawVerticalLine(double x, String name, double yfrac, boolean right)
          Draws a vertical line on the chart at x-coordinate x.
 void enableGrid(double xstep, double ystep)
          Puts a grid on the background.
 double getChartMargin()
          Returns the chart margin, which is the fraction by which the chart is enlarged on its borders.
 JFreeChart getJFreeChart()
          Returns the JFreeChart object associated with this chart.
 String getTitle()
          Gets the current chart title.
 Axis getXAxis()
          Returns the chart's domain axis (x-axis) object.
 Axis getYAxis()
          Returns the chart's range axis (y-axis) object.
 void setAutoRange()
          The x and the y ranges of the chart are set automatically.
 void setAutoRange(boolean right, boolean top)
          The x and the y ranges of the chart are set automatically.
 void setAutoRange00(boolean xZero, boolean yZero)
          The x and the y ranges of the chart are set automatically.
 void setChartMargin(double margin)
          Sets the chart margin to margin.
 void setLatexDocFlag(boolean flag)
          Flag to remove the \documentclass (and other) commands in the created LATEX files.
 void setManualRange(double[] range)
          Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax].
 void setManualRange(double[] range, boolean right, boolean top)
          Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax].
 void setManualRange00(double[] range, boolean xZero, boolean yZero)
          Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax].
 void setprobFlag(boolean flag)
          Must be set true when plotting probabilities, false otherwise.
abstract  void setTicksSynchro(int s)
          Synchronizes x-axis ticks to the s-th series x-values.
 void setTitle(String title)
          Sets a title to this chart.
abstract  String toLatex(double width, double height)
          Exports the chart to a LATEX source code using PGF/TikZ.
 void toLatexFile(String fileName, double width, double height)
          Transforms the chart to LATEX form and writes it in file fileName.
abstract  JFrame view(int width, int height)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XYChart

public XYChart()
Method Detail

getJFreeChart

public JFreeChart getJFreeChart()
Returns the JFreeChart object associated with this chart.

Returns:
the associated JFreeChart object.

getXAxis

public Axis getXAxis()
Returns the chart's domain axis (x-axis) object.

Returns:
chart's domain axis (x-axis) object.

getYAxis

public Axis getYAxis()
Returns the chart's range axis (y-axis) object.

Returns:
chart's range axis (y-axis) object.

view

public abstract JFrame view(int width,
                            int height)

getTitle

public String getTitle()
Gets the current chart title.

Returns:
Chart title.

setTitle

public void setTitle(String title)
Sets a title to this chart. This title will appear on the chart displayed by method view.

Parameters:
title - chart title.

setprobFlag

public void setprobFlag(boolean flag)
Must be set true when plotting probabilities, false otherwise.

Parameters:
flag - true for plotting probabilities

setAutoRange

public void setAutoRange()
The x and the y ranges of the chart are set automatically.


setAutoRange

public void setAutoRange(boolean right,
                         boolean top)
The x and the y ranges of the chart are set automatically. If right is true, the vertical axis will be on the left of the points, otherwise on the right. If top is true, the horizontal axis will be under the points, otherwise above the points.

Parameters:
right - true if the x-values on the right of axis.
top - true if the y-values on the top of axis.

setAutoRange00

public void setAutoRange00(boolean xZero,
                           boolean yZero)
The x and the y ranges of the chart are set automatically. If xZero is true, the vertical axis will pass through the point (0, y). If yZero is true, the horizontal axis will pass through the point (x, 0).

Parameters:
xZero - true if vertical axis passes through point 0
yZero - true if horizontal axis passes through point 0

setManualRange

public void setManualRange(double[] range)
Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax].

Parameters:
range - new axis ranges.

setManualRange

public void setManualRange(double[] range,
                           boolean right,
                           boolean top)
Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax]. If right is true, the vertical axis will be on the left of the points, otherwise on the right. If top is true, the horizontal axis will be under the points, otherwise above the points.

Parameters:
range - new axis ranges.
right - true if the x-values on the right.
top - true if the y-values on the top.

setManualRange00

public void setManualRange00(double[] range,
                             boolean xZero,
                             boolean yZero)
Sets the x and y ranges of the chart using the format: range = [xmin, xmax, ymin, ymax]. If xZero is true, the vertical axis will pass through the point (0, y). If yZero is true, the horizontal axis will pass through the point (x, 0).

Parameters:
xZero - true if vertical axis passes through point 0
yZero - true if horizontal axis passes through point 0

getChartMargin

public double getChartMargin()
Returns the chart margin, which is the fraction by which the chart is enlarged on its borders. The default value is 0.02.


setChartMargin

public void setChartMargin(double margin)
Sets the chart margin to margin. It is the fraction by which the chart is enlarged on its borders. Restriction: margin >=  0.

Parameters:
margin - margin percentage amount.

setTicksSynchro

public abstract void setTicksSynchro(int s)
Synchronizes x-axis ticks to the s-th series x-values.

Parameters:
s - series.

drawVerticalLine

public void drawVerticalLine(double x,
                             String name,
                             double yfrac,
                             boolean right)
Draws a vertical line on the chart at x-coordinate x. name is written near the line at y position yfrac (a fraction of the y-size of the chart, 0 is the bottom, 1 is the top); if right is true, name is written on the right of the line, else on the left.

Parameters:
x - x-coordinate of the line
name - description of the line
yfrac - y-position of name
right - x-position of name

enableGrid

public void enableGrid(double xstep,
                       double ystep)
Puts a grid on the background. It is important to note that the grid is always shifted in such a way that it contains the axes. Thus, the grid does not always have an intersection at the corner points; this occurs only if the corner points are multiples of the steps: xstep and ystep sets the step in each direction.

Parameters:
xstep - sets the step in the x-direction.
ystep - sets the step in the y-direction.

disableGrid

public void disableGrid()
Disables the background grid.


toLatex

public abstract String toLatex(double width,
                               double height)
Exports the chart to a LATEX source code using PGF/TikZ. This method constructs and returns a string that can be written to a LATEX document to render the plot. width and height represents the width and the height of the produced chart. These dimensions do not take into account the axes and labels extra space. The width and the height of the chart are measured in centimeters.

Parameters:
width - Chart's width in centimeters.
height - Chart's height in centimeters.
Returns:
LaTeX source code.

toLatexFile

public void toLatexFile(String fileName,
                        double width,
                        double height)
Transforms the chart to LATEX form and writes it in file fileName. The chart's width and height (in centimeters) are width and height.


setLatexDocFlag

public void setLatexDocFlag(boolean flag)
Flag to remove the \documentclass (and other) commands in the created LATEX files. If flag is true, then when charts are translated into LATEX form, it will be as a self-contained file that can be directly compiled with LATEX. However, in this form, the file cannot be included in another LATEX file without causing compilation errors because of the multiple instructions \documentclass and \begin{document}. By setting flag to false, these instructions will be removed from the LATEX chart files, which can then be included in a master LATEX file. By default, the flag is true.


SSJ
V. 2.6.

To submit a bug or ask questions, send an e-mail to Pierre L'Ecuyer.