SSJ
V. 2.6.

umontreal.iro.lecuyer.charts
Class Axis

java.lang.Object
  extended by umontreal.iro.lecuyer.charts.Axis

public class Axis
extends Object

Represents an axis of a chart encapsulated by an instance of XYChart. Axis uses the JFreeChart class NumberAxis to store some axis properties. This class represents the x-axis or the y-axis of a XYChart and, consequently, is drawn when calling the toLatex method. It provides tools to customize the axis in modifying labels and description.


Field Summary
static boolean ORIENTATION_HORIZONTAL
           
static boolean ORIENTATION_VERTICAL
           
 
Constructor Summary
Axis(NumberAxis inAxis, boolean orientation)
          Create a new Axis instance from an existing NumberAxis instance with vertical (y-axis) or horizontal (x-axis) orientation.
 
Method Summary
 void disableCustomLabels()
          Deprecated. 
 void enableCustomLabels()
          Deprecated. 
 String getLabel()
          Returns the axis description.
 double getTwinAxisPosition()
          Returns the drawing position parameter (default equals 0).
 void setLabel(String label)
          Sets the axis description.
 void setLabels(double tick)
          Sets a periodic label display.
 void setLabels(double[] position)
          Sets the position of each label on this axis.
 void setLabels(double[] position, String[] label)
          Assigns custom labels to user-defined positions on the axis.
 void setLabelsAuto()
          Calculates and sets an automatic tick unit.
 void setTwinAxisPosition(double position)
          Defines where the opposite axis must be drawn on the current axis, where it should appear, and on which label.
 String toLatex(double scale)
          Formats and returns a string containing a LATEX-compatible source code which represents this axis and its parameters.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ORIENTATION_VERTICAL

public static final boolean ORIENTATION_VERTICAL
See Also:
Constant Field Values

ORIENTATION_HORIZONTAL

public static final boolean ORIENTATION_HORIZONTAL
See Also:
Constant Field Values
Constructor Detail

Axis

public Axis(NumberAxis inAxis,
            boolean orientation)
Create a new Axis instance from an existing NumberAxis instance with vertical (y-axis) or horizontal (x-axis) orientation.

Parameters:
inAxis - NumberAxis instance associated to the new variable.
orientation - axis direction, horizontal or vertical
Method Detail

getLabel

public String getLabel()
Returns the axis description.

Returns:
the axis description.

setLabel

public void setLabel(String label)
Sets the axis description. This description will be displayed on the chart, near the axis.

Parameters:
label - axis label.

setLabels

public void setLabels(double tick)
Sets a periodic label display. Labels will be shown every tick unit. This tick unit replaces the default unit.

Parameters:
tick - tick unit.

setLabelsAuto

public void setLabelsAuto()
Calculates and sets an automatic tick unit.


enableCustomLabels

@Deprecated
public void enableCustomLabels()
Deprecated. 

Not used anymore.


disableCustomLabels

@Deprecated
public void disableCustomLabels()
Deprecated. 

Not used anymore.


setLabels

public void setLabels(double[] position)
Sets the position of each label on this axis. This method requires an array containing an increasing sequence of numbers representing the positions at which labels will appear on the axis. It is designed to export the axis to a LaTeX source code; it has no effect on the chart appearance displayed with XYChart.view().

Parameters:
position - new label positions.

setLabels

public void setLabels(double[] position,
                      String[] label)
Assigns custom labels to user-defined positions on the axis. This method requires an array of positions as well as an array of labels. The label label[i] will be used at position position[i]. It is designed to export the axis to a LaTeX source code, and to use LATEX/TikZ commands to write prettier characters; it has no effect on the chart appearance displayed with XYChart.view().

Parameters:
position - label series position on the axis.
label - label series name on the axis.

getTwinAxisPosition

public double getTwinAxisPosition()
Returns the drawing position parameter (default equals 0).

Returns:
drawing position parameter.

setTwinAxisPosition

public void setTwinAxisPosition(double position)
Defines where the opposite axis must be drawn on the current axis, where it should appear, and on which label.

Parameters:
position - new drawing position.

toLatex

public String toLatex(double scale)
Formats and returns a string containing a LATEX-compatible source code which represents this axis and its parameters.

Parameters:
scale - current axis wished scale.
Returns:
LaTeX source code in a String.

SSJ
V. 2.6.

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