public class

LogarithmicAxis

extends NumberAxis

java.lang.Object
↳	org.jfree.chart.axis.Axis
	↳	org.jfree.chart.axis.ValueAxis
		↳	org.jfree.chart.axis.NumberAxis
			↳	org.jfree.chart.axis.LogarithmicAxis

Class Overview

A numerical axis that uses a logarithmic scale.

Summary

Constants
double	SMALL_LOG_VALUE	Smallest arbitrarily-close-to-zero value allowed.

[Expand]

Inherited Constants

From class org.jfree.chart.axis.NumberAxis

From class org.jfree.chart.axis.ValueAxis

From class org.jfree.chart.axis.Axis

Fields
public static final double	LOG10_VALUE	Useful constant for log(10).
protected boolean	allowNegativesFlag	Flag set true to allow negative values in data.
protected boolean	autoRangeNextLogFlag	True to make 'autoAdjustRange()' select "10^n" values.
protected boolean	expTickLabelsFlag	Flag set true for "1e#"-style tick labels.
protected boolean	log10TickLabelsFlag	Flag set true for "10^n"-style tick labels.
protected final NumberFormat	numberFormatterObj	Number formatter for generating numeric strings.
protected boolean	smallLogFlag	Helper flag for log axis processing.
protected boolean	strictValuesFlag	Flag set true make axis throw exception if any values are <= 0 and 'allowNegativesFlag' is false.

[Expand]

Inherited Fields

From class org.jfree.chart.axis.NumberAxis

From class org.jfree.chart.axis.ValueAxis

From class org.jfree.chart.axis.Axis

Public Constructors
	LogarithmicAxis(String label) Creates a new axis.

Public Methods
double	adjustedLog10(double val) Returns an adjusted log10 value for graphing purposes.
double	adjustedPow10(double val) Returns an adjusted power of 10 value for graphing purposes.
void	autoAdjustRange() Rescales the axis to ensure that all data is visible.
boolean	getAllowNegativesFlag() Returns the 'allowNegativesFlag' flag; true to allow negative values in data, false to be able to plot positive values arbitrarily close to zero.
boolean	getAutoRangeNextLogFlag() Returns the 'autoRangeNextLogFlag' flag.
boolean	getExpTickLabelsFlag() Returns the 'expTickLabelsFlag' flag.
boolean	getLog10TickLabelsFlag() Returns the 'log10TickLabelsFlag' flag.
boolean	getStrictValuesFlag() Returns the 'strictValuesFlag' flag; if true and 'allowNegativesFlag' is false then this axis will throw a runtime exception if any of its values are less than or equal to zero; if false then the axis will adjust for values less than or equal to zero as needed.
double	java2DToValue(double java2DValue, Rectangle2D plotArea, RectangleEdge edge) Converts a coordinate in Java2D space to the corresponding data value, assuming that the axis runs along one edge of the specified plotArea.
void	setAllowNegativesFlag(boolean flgVal) Sets the 'allowNegativesFlag' flag; true to allow negative values in data, false to be able to plot positive values arbitrarily close to zero.
void	setAutoRangeNextLogFlag(boolean flag) Sets the 'autoRangeNextLogFlag' flag.
void	setExpTickLabelsFlag(boolean flgVal) Sets the 'expTickLabelsFlag' flag.
void	setLog10TickLabelsFlag(boolean flag) Sets the 'log10TickLabelsFlag' flag.
void	setRange(Range range) Overridden version that calls original and then sets up flag for log axis processing.
void	setStrictValuesFlag(boolean flgVal) Sets the 'strictValuesFlag' flag; if true and 'allowNegativesFlag' is false then this axis will throw a runtime exception if any of its values are less than or equal to zero; if false then the axis will adjust for values less than or equal to zero as needed.
double	switchedPow10(double val) Returns a power of 10, depending on if values between 0 and 1 are being plotted.
double	valueToJava2D(double value, Rectangle2D plotArea, RectangleEdge edge) Converts a data value to a coordinate in Java2D space, assuming that the axis runs along one edge of the specified plotArea.
void	zoomRange(double lowerPercent, double upperPercent) Zooms in on the current range.

Protected Methods
double	computeLogCeil(double upper) Returns the smallest (closest to negative infinity) double value that is not less than the argument, is equal to a mathematical integer and satisfying the condition that log base 10 of the value is an integer (i.e., the value returned will be a power of 10: 1, 10, 100, 1000, etc.).
double	computeLogFloor(double lower) Returns the largest (closest to positive infinity) double value that is not greater than the argument, is equal to a mathematical integer and satisfying the condition that log base 10 of the value is an integer (i.e., the value returned will be a power of 10: 1, 10, 100, 1000, etc.).
String	makeTickLabel(double val) Converts the given value to a tick label string.
String	makeTickLabel(double val, boolean forceFmtFlag) Converts the given value to a tick label string.
List	refreshTicksHorizontal(Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge) Calculates the positions of the tick labels for the axis, storing the results in the tick label list (ready for drawing).
List	refreshTicksVertical(Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge) Calculates the positions of the tick labels for the axis, storing the results in the tick label list (ready for drawing).
void	setupNumberFmtObj() Sets up the number formatter object according to the 'expTickLabelsFlag' flag.
void	setupSmallLogFlag() Sets up flag for log axis processing.
double	switchedLog10(double val) Returns the log10 value, depending on if values between 0 and 1 are being plotted.

[Expand]

Inherited Methods

From class org.jfree.chart.axis.NumberAxis

From class org.jfree.chart.axis.ValueAxis

abstract void	autoAdjustRange() Automatically sets the axis range to fit the range of values in the dataset.
float[]	calculateAnchorPoint(ValueTick tick, double cursor, Rectangle2D dataArea, RectangleEdge edge) Calculates the anchor point for a tick label.
void	centerRange(double value) Centers the axis range about the specified value and sends an `AxisChangeEvent` to all registered listeners.
Object	clone() Returns a clone of the object.
void	drawAxisLine(Graphics2D g2, double cursor, Rectangle2D dataArea, RectangleEdge edge) Draws an axis line at the current cursor position and edge.
AxisState	drawTickMarksAndLabels(Graphics2D g2, double cursor, Rectangle2D plotArea, Rectangle2D dataArea, RectangleEdge edge) Draws the axis line, tick marks and tick mark labels.
boolean	equals(Object obj) Tests the axis for equality with an arbitrary object.
double	findMaximumTickLabelHeight(List ticks, Graphics2D g2, Rectangle2D drawArea, boolean vertical) A utility method for determining the height of the tallest tick label.
double	findMaximumTickLabelWidth(List ticks, Graphics2D g2, Rectangle2D drawArea, boolean vertical) A utility method for determining the width of the widest tick label.
double	getAutoRangeMinimumSize() Returns the minimum size allowed for the axis range when it is automatically calculated.
int	getAutoTickIndex() Returns the auto tick index.
Range	getDefaultAutoRange() Returns the default auto range.
Shape	getDownArrow() Returns a shape that can be displayed as an arrow pointing downwards at the end of an axis line.
double	getFixedAutoRange() Returns the fixed auto range.
Shape	getLeftArrow() Returns a shape that can be displayed as an arrow pointing left at the end of an axis line.
double	getLowerBound() Returns the lower bound of the axis range.
double	getLowerMargin() Returns the lower margin for the axis, expressed as a percentage of the axis range.
int	getMinorTickCount() Returns the number of minor tick marks to display.
Range	getRange() Returns the range for the axis.
Shape	getRightArrow() Returns a shape that can be displayed as an arrow pointing right at the end of an axis line.
TickUnitSource	getStandardTickUnits() Returns the source for obtaining standard tick units for the axis.
Shape	getUpArrow() Returns a shape that can be displayed as an arrow pointing upwards at the end of an axis line.
double	getUpperBound() Returns the upper bound for the axis range.
double	getUpperMargin() Returns the upper margin for the axis, expressed as a percentage of the axis range.
boolean	isAutoRange() Returns the flag that controls whether or not the axis range is automatically adjusted to fit the data values.
boolean	isAutoTickUnitSelection() Returns a flag indicating whether or not the tick unit is automatically selected from a range of standard tick units.
boolean	isInverted() Returns a flag that controls the direction of values on the axis.
boolean	isNegativeArrowVisible() Returns a flag that controls whether or not the axis line has an arrow drawn that points in the negative direction for the axis.
boolean	isPositiveArrowVisible() Returns a flag that controls whether or not the axis line has an arrow drawn that points in the positive direction for the axis.
boolean	isVerticalTickLabels() Returns `true` if the tick labels should be rotated (to vertical), and `false` otherwise.
abstract double	java2DToValue(double java2DValue, Rectangle2D area, RectangleEdge edge) Converts a coordinate in Java2D space to the corresponding data value, assuming that the axis runs along one edge of the specified dataArea.
double	lengthToJava2D(double length, Rectangle2D area, RectangleEdge edge) Converts a length in data coordinates into the corresponding length in Java2D coordinates.
void	pan(double percent) Slides the axis range by the specified percentage.
AxisSpace	reserveSpace(Graphics2D g2, Plot plot, Rectangle2D plotArea, RectangleEdge edge, AxisSpace space) Returns the space required to draw the axis.
void	resizeRange(double percent) Increases or decreases the axis range by the specified percentage about the central value and sends an `AxisChangeEvent` to all registered listeners.
void	resizeRange(double percent, double anchorValue) Increases or decreases the axis range by the specified percentage about the specified anchor value and sends an `AxisChangeEvent` to all registered listeners.
void	resizeRange2(double percent, double anchorValue) Increases or decreases the axis range by the specified percentage about the specified anchor value and sends an `AxisChangeEvent` to all registered listeners.
void	setAutoRange(boolean auto, boolean notify) Sets the auto range attribute.
void	setAutoRange(boolean auto) Sets a flag that determines whether or not the axis range is automatically adjusted to fit the data, and notifies registered listeners that the axis has been modified.
void	setAutoRangeMinimumSize(double size) Sets the auto range minimum size and sends an `AxisChangeEvent` to all registered listeners.
void	setAutoRangeMinimumSize(double size, boolean notify) Sets the minimum size allowed for the axis range when it is automatically calculated.
void	setAutoTickIndex(int index) Sets the auto tick index.
void	setAutoTickUnitSelection(boolean flag, boolean notify) Sets a flag indicating whether or not the tick unit is automatically selected from a range of standard tick units.
void	setAutoTickUnitSelection(boolean flag) Sets a flag indicating whether or not the tick unit is automatically selected from a range of standard tick units.
void	setDefaultAutoRange(Range range) Sets the default auto range and sends an `AxisChangeEvent` to all registered listeners.
void	setDownArrow(Shape arrow) Sets the shape that can be displayed as an arrow pointing downwards at the end of an axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setFixedAutoRange(double length) Sets the fixed auto range for the axis.
void	setInverted(boolean flag) Sets a flag that controls the direction of values on the axis, and notifies registered listeners that the axis has changed.
void	setLeftArrow(Shape arrow) Sets the shape that can be displayed as an arrow pointing left at the end of an axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setLowerBound(double min) Sets the lower bound for the axis range.
void	setLowerMargin(double margin) Sets the lower margin for the axis (as a percentage of the axis range) and sends an `AxisChangeEvent` to all registered listeners.
void	setMinorTickCount(int count) Sets the number of minor tick marks to display, and sends an `AxisChangeEvent` to all registered listeners.
void	setNegativeArrowVisible(boolean visible) Sets a flag that controls whether or not the axis lines has an arrow drawn that points in the negative direction for the axis, and sends an `AxisChangeEvent` to all registered listeners.
void	setPositiveArrowVisible(boolean visible) Sets a flag that controls whether or not the axis lines has an arrow drawn that points in the positive direction for the axis, and sends an `AxisChangeEvent` to all registered listeners.
void	setRange(Range range, boolean turnOffAutoRange, boolean notify) Sets the range for the axis, if requested, sends an `AxisChangeEvent` to all registered listeners.
void	setRange(double lower, double upper) Sets the axis range and sends an `AxisChangeEvent` to all registered listeners.
void	setRange(Range range) Sets the range attribute and sends an `AxisChangeEvent` to all registered listeners.
void	setRangeAboutValue(double value, double length) Sets the axis range, where the new range is 'size' in length, and centered on 'value'.
void	setRangeWithMargins(Range range) Sets the range for the axis (after first adding the current margins to the specified range) and sends an `AxisChangeEvent` to all registered listeners.
void	setRangeWithMargins(double lower, double upper) Sets the axis range (after first adding the current margins to the range) and sends an `AxisChangeEvent` to all registered listeners.
void	setRangeWithMargins(Range range, boolean turnOffAutoRange, boolean notify) Sets the range for the axis after first adding the current margins to the range and, if requested, sends an `AxisChangeEvent` to all registered listeners.
void	setRightArrow(Shape arrow) Sets the shape that can be displayed as an arrow pointing rightwards at the end of an axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setStandardTickUnits(TickUnitSource source) Sets the source for obtaining standard tick units for the axis and sends an `AxisChangeEvent` to all registered listeners.
void	setUpArrow(Shape arrow) Sets the shape that can be displayed as an arrow pointing upwards at the end of an axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setUpperBound(double max) Sets the upper bound for the axis range, and sends an `AxisChangeEvent` to all registered listeners.
void	setUpperMargin(double margin) Sets the upper margin for the axis (as a percentage of the axis range) and sends an `AxisChangeEvent` to all registered listeners.
void	setVerticalTickLabels(boolean flag) Sets the flag that controls whether the tick labels are displayed vertically (that is, rotated 90 degrees from horizontal).
abstract double	valueToJava2D(double value, Rectangle2D area, RectangleEdge edge) Converts a data value to a coordinate in Java2D space, assuming that the axis runs along one edge of the specified dataArea.
void	zoomRange(double lowerPercent, double upperPercent) Zooms in on the current range.

From class org.jfree.chart.axis.Axis

void	addChangeListener(AxisChangeListener listener) Registers an object for notification of changes to the axis.
Object	clone() Returns a clone of the axis.
abstract void	configure() Configures the axis to work with the current plot.
void	createAndAddEntity(double cursor, AxisState state, Rectangle2D dataArea, RectangleEdge edge, PlotRenderingInfo plotState) Created an entity for the axis.
abstract AxisState	draw(Graphics2D g2, double cursor, Rectangle2D plotArea, Rectangle2D dataArea, RectangleEdge edge, PlotRenderingInfo plotState) Draws the axis on a Java 2D graphics device (such as the screen or a printer).
void	drawAxisLine(Graphics2D g2, double cursor, Rectangle2D dataArea, RectangleEdge edge) Draws an axis line at the current cursor position and edge.
AxisState	drawLabel(String label, Graphics2D g2, Rectangle2D plotArea, Rectangle2D dataArea, RectangleEdge edge, AxisState state) Draws the axis label.
boolean	equals(Object obj) Tests this axis for equality with another object.
void	fireChangeEvent() Sends an `AxisChangeEvent` to all registered listeners.
Paint	getAxisLinePaint() Returns the paint used to draw the axis line.
Stroke	getAxisLineStroke() Returns the stroke used to draw the axis line.
double	getFixedDimension() Returns the fixed dimension for the axis.
String	getLabel() Returns the label for the axis.
double	getLabelAngle() Returns the angle of the axis label.
Rectangle2D	getLabelEnclosure(Graphics2D g2, RectangleEdge edge) Returns a rectangle that encloses the axis label.
Font	getLabelFont() Returns the font for the axis label.
RectangleInsets	getLabelInsets() Returns the insets for the label (that is, the amount of blank space that should be left around the label).
Paint	getLabelPaint() Returns the color/shade used to draw the axis label.
float	getMinorTickMarkInsideLength() Returns the inside length of the minor tick marks.
float	getMinorTickMarkOutsideLength() Returns the outside length of the minor tick marks.
Plot	getPlot() Returns the plot that the axis is assigned to.
Font	getTickLabelFont() Returns the font used for the tick labels (if showing).
RectangleInsets	getTickLabelInsets() Returns the insets for the tick labels.
Paint	getTickLabelPaint() Returns the color/shade used for the tick labels.
float	getTickMarkInsideLength() Returns the inside length of the tick marks.
float	getTickMarkOutsideLength() Returns the outside length of the tick marks.
Paint	getTickMarkPaint() Returns the paint used to draw tick marks (if they are showing).
Stroke	getTickMarkStroke() Returns the stroke used to draw tick marks.
boolean	hasListener(EventListener listener) Returns `true` if the specified object is registered with the dataset as a listener.
boolean	isAxisLineVisible() A flag that controls whether or not the axis line is drawn.
boolean	isMinorTickMarksVisible() Returns the flag that indicates whether or not the minor tick marks are showing.
boolean	isTickLabelsVisible() Returns a flag indicating whether or not the tick labels are visible.
boolean	isTickMarksVisible() Returns the flag that indicates whether or not the tick marks are showing.
boolean	isVisible() Returns `true` if the axis is visible, and `false` otherwise.
void	notifyListeners(AxisChangeEvent event) Notifies all registered listeners that the axis has changed.
abstract List	refreshTicks(Graphics2D g2, AxisState state, Rectangle2D dataArea, RectangleEdge edge) Calculates the positions of the ticks for the axis, storing the results in the tick list (ready for drawing).
void	removeChangeListener(AxisChangeListener listener) Deregisters an object for notification of changes to the axis.
abstract AxisSpace	reserveSpace(Graphics2D g2, Plot plot, Rectangle2D plotArea, RectangleEdge edge, AxisSpace space) Estimates the space (height or width) required to draw the axis.
void	setAxisLinePaint(Paint paint) Sets the paint used to draw the axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setAxisLineStroke(Stroke stroke) Sets the stroke used to draw the axis line and sends an `AxisChangeEvent` to all registered listeners.
void	setAxisLineVisible(boolean visible) Sets a flag that controls whether or not the axis line is visible and sends an `AxisChangeEvent` to all registered listeners.
void	setFixedDimension(double dimension) Sets the fixed dimension for the axis.
void	setLabel(String label) Sets the label for the axis and sends an `AxisChangeEvent` to all registered listeners.
void	setLabelAngle(double angle) Sets the angle for the label and sends an `AxisChangeEvent` to all registered listeners.
void	setLabelFont(Font font) Sets the font for the axis label and sends an `AxisChangeEvent` to all registered listeners.
void	setLabelInsets(RectangleInsets insets) Sets the insets for the axis label, and sends an `AxisChangeEvent` to all registered listeners.
void	setLabelInsets(RectangleInsets insets, boolean notify) Sets the insets for the axis label, and sends an `AxisChangeEvent` to all registered listeners.
void	setLabelPaint(Paint paint) Sets the paint used to draw the axis label and sends an `AxisChangeEvent` to all registered listeners.
void	setMinorTickMarkInsideLength(float length) Sets the inside length of the minor tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setMinorTickMarkOutsideLength(float length) Sets the outside length of the minor tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setMinorTickMarksVisible(boolean flag) Sets the flag that indicates whether or not the minor tick marks are showing and sends an `AxisChangeEvent` to all registered listeners.
void	setPlot(Plot plot) Sets a reference to the plot that the axis is assigned to.
void	setTickLabelFont(Font font) Sets the font for the tick labels and sends an `AxisChangeEvent` to all registered listeners.
void	setTickLabelInsets(RectangleInsets insets) Sets the insets for the tick labels and sends an `AxisChangeEvent` to all registered listeners.
void	setTickLabelPaint(Paint paint) Sets the paint used to draw tick labels (if they are showing) and sends an `AxisChangeEvent` to all registered listeners.
void	setTickLabelsVisible(boolean flag) Sets the flag that determines whether or not the tick labels are visible and sends an `AxisChangeEvent` to all registered listeners.
void	setTickMarkInsideLength(float length) Sets the inside length of the tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setTickMarkOutsideLength(float length) Sets the outside length of the tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setTickMarkPaint(Paint paint) Sets the paint used to draw tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setTickMarkStroke(Stroke stroke) Sets the stroke used to draw tick marks and sends an `AxisChangeEvent` to all registered listeners.
void	setTickMarksVisible(boolean flag) Sets the flag that indicates whether or not the tick marks are showing and sends an `AxisChangeEvent` to all registered listeners.
void	setVisible(boolean flag) Sets a flag that controls whether or not the axis is visible and sends an `AxisChangeEvent` to all registered listeners.

From class java.lang.Object

Constants

public static final double SMALL_LOG_VALUE

Smallest arbitrarily-close-to-zero value allowed.

Constant Value: 1.0E-100

Fields

public static final double LOG10_VALUE

Useful constant for log(10).

protected boolean allowNegativesFlag

Flag set true to allow negative values in data.

protected boolean autoRangeNextLogFlag

True to make 'autoAdjustRange()' select "10^n" values.

protected boolean expTickLabelsFlag

Flag set true for "1e#"-style tick labels.

protected boolean log10TickLabelsFlag

Flag set true for "10^n"-style tick labels.

protected final NumberFormat numberFormatterObj

Number formatter for generating numeric strings.

protected boolean smallLogFlag

Helper flag for log axis processing.

protected boolean strictValuesFlag

Flag set true make axis throw exception if any values are <= 0 and 'allowNegativesFlag' is false.

Public Constructors

public LogarithmicAxis (String label)

Creates a new axis.

Parameters

label	the axis label.

Public Methods

public double adjustedLog10 (double val)

Returns an adjusted log10 value for graphing purposes. The first adjustment is that negative values are changed to positive during the calculations, and then the answer is negated at the end. The second is that, for values less than 10, an increasingly large (0 to 1) scaling factor is added such that at 0 the value is adjusted to 1, resulting in a returned result of 0.

Parameters

val	value for which log10 should be calculated.

Returns

An adjusted log₁₀(val).

public double adjustedPow10 (double val)

Returns an adjusted power of 10 value for graphing purposes. The first adjustment is that negative values are changed to positive during the calculations, and then the answer is negated at the end. The second is that, for values less than 1, a progressive logarithmic offset is subtracted such that at 0 the returned result is also 0.

Parameters

val	value for which power of 10 should be calculated.

Returns

An adjusted 10^val.

public void autoAdjustRange ()

Rescales the axis to ensure that all data is visible.

public boolean getAllowNegativesFlag ()

Returns the 'allowNegativesFlag' flag; true to allow negative values in data, false to be able to plot positive values arbitrarily close to zero.

Returns

The flag.

public boolean getAutoRangeNextLogFlag ()

Returns the 'autoRangeNextLogFlag' flag.

Returns

true if the 'autoAdjustRange()' method will select the next "10^n" values, false if not.

public boolean getExpTickLabelsFlag ()

Returns the 'expTickLabelsFlag' flag.

Returns

true for "1e#"-style tick labels, false for log10 or regular numeric tick labels.

public boolean getLog10TickLabelsFlag ()

Returns the 'log10TickLabelsFlag' flag.

Returns

true for "10^n"-style tick labels, false for "1e#"-style or regular numeric tick labels.

public boolean getStrictValuesFlag ()

Returns the 'strictValuesFlag' flag; if true and 'allowNegativesFlag' is false then this axis will throw a runtime exception if any of its values are less than or equal to zero; if false then the axis will adjust for values less than or equal to zero as needed.

Returns

true if strict enforcement is enabled.

public double java2DToValue (double java2DValue, Rectangle2D plotArea, RectangleEdge edge)

Converts a coordinate in Java2D space to the corresponding data value, assuming that the axis runs along one edge of the specified plotArea.

Parameters

java2DValue	the coordinate in Java2D space.
plotArea	the area in which the data is plotted.
edge	the axis location.

Returns

The data value.

public void setAllowNegativesFlag (boolean flgVal)

Sets the 'allowNegativesFlag' flag; true to allow negative values in data, false to be able to plot positive values arbitrarily close to zero.

Parameters

flgVal	the new value of the flag.

public void setAutoRangeNextLogFlag (boolean flag)

Sets the 'autoRangeNextLogFlag' flag. This determines whether or not the 'autoAdjustRange()' method will select the next "10^n" values when determining the upper and lower bounds. The default value is false.

Parameters

flag	`true` to make the 'autoAdjustRange()' method select the next "10^n" values, `false` to not.

public void setExpTickLabelsFlag (boolean flgVal)

Sets the 'expTickLabelsFlag' flag. If the 'log10TickLabelsFlag' is false then this will set whether or not "1e#"-style tick labels are used. The default is to use regular numeric tick labels.

Parameters

flgVal	true for "1e#"-style tick labels, false for log10 or regular numeric tick labels.

public void setLog10TickLabelsFlag (boolean flag)

Sets the 'log10TickLabelsFlag' flag. The default value is false.

Parameters

flag	true for "10^n"-style tick labels, false for "1e#"-style or regular numeric tick labels.

public void setRange (Range range)

Overridden version that calls original and then sets up flag for log axis processing.

Parameters

range	the new range.

public void setStrictValuesFlag (boolean flgVal)

Sets the 'strictValuesFlag' flag; if true and 'allowNegativesFlag' is false then this axis will throw a runtime exception if any of its values are less than or equal to zero; if false then the axis will adjust for values less than or equal to zero as needed.

Parameters

flgVal	true for strict enforcement.

public double switchedPow10 (double val)

Returns a power of 10, depending on if values between 0 and 1 are being plotted. If negative values are not allowed and the lower bound is between 0 and 10 then a normal power is returned; otherwise the returned value is adjusted if the given value is less than 1.

Parameters

val	the value.

Returns

10^val.

public double valueToJava2D (double value, Rectangle2D plotArea, RectangleEdge edge)

Converts a data value to a coordinate in Java2D space, assuming that the axis runs along one edge of the specified plotArea. Note that it is possible for the coordinate to fall outside the plotArea.

Parameters

value	the data value.
plotArea	the area for plotting the data.
edge	the axis location.

Returns

The Java2D coordinate.

public void zoomRange (double lowerPercent, double upperPercent)

Zooms in on the current range.

Parameters

lowerPercent	the new lower bound.
upperPercent	the new upper bound.

Protected Methods

protected double computeLogCeil (double upper)

Returns the smallest (closest to negative infinity) double value that is not less than the argument, is equal to a mathematical integer and satisfying the condition that log base 10 of the value is an integer (i.e., the value returned will be a power of 10: 1, 10, 100, 1000, etc.).

Parameters

upper	a double value above which a ceiling will be calcualted.

Returns

10^N with N .. { 1 ... }

protected double computeLogFloor (double lower)

Returns the largest (closest to positive infinity) double value that is not greater than the argument, is equal to a mathematical integer and satisfying the condition that log base 10 of the value is an integer (i.e., the value returned will be a power of 10: 1, 10, 100, 1000, etc.).

Parameters

lower	a double value below which a floor will be calcualted.

Returns

10^N with N .. { 1 ... }

protected String makeTickLabel (double val)

Converts the given value to a tick label string.

Parameters

val	the value to convert.

Returns

The tick label string.

protected String makeTickLabel (double val, boolean forceFmtFlag)

Converts the given value to a tick label string.

Parameters

val	the value to convert.
forceFmtFlag	true to force the number-formatter object to be used.

Returns

The tick label string.

protected List refreshTicksHorizontal (Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge)

Calculates the positions of the tick labels for the axis, storing the results in the tick label list (ready for drawing).

Parameters

g2	the graphics device.
dataArea	the area in which the plot should be drawn.
edge	the location of the axis.

Returns

A list of ticks.

protected List refreshTicksVertical (Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge)

Calculates the positions of the tick labels for the axis, storing the results in the tick label list (ready for drawing).

Parameters

g2	the graphics device.
dataArea	the area in which the plot should be drawn.
edge	the location of the axis.

Returns

A list of ticks.

protected void setupNumberFmtObj ()

Sets up the number formatter object according to the 'expTickLabelsFlag' flag.

protected void setupSmallLogFlag ()

Sets up flag for log axis processing. Set true if negative values not allowed and the lower bound is between 0 and 10.

protected double switchedLog10 (double val)

Returns the log10 value, depending on if values between 0 and 1 are being plotted. If negative values are not allowed and the lower bound is between 0 and 10 then a normal log is returned; otherwise the returned value is adjusted if the given value is less than 10.

Parameters

val	the value.

Returns

log₁₀(val).

Interfaces

Classes

LogarithmicAxis

Class Overview

Summary

Constants

public static final double SMALL_LOG_VALUE

Fields

public static final double LOG10_VALUE

protected boolean allowNegativesFlag

protected boolean autoRangeNextLogFlag

protected boolean expTickLabelsFlag

protected boolean log10TickLabelsFlag

protected final NumberFormat numberFormatterObj

protected boolean smallLogFlag

protected boolean strictValuesFlag

Public Constructors

public LogarithmicAxis (String label)

Parameters

Public Methods

public double adjustedLog10 (double val)

Parameters

Returns

See Also

public double adjustedPow10 (double val)

Parameters

Returns

See Also

public void autoAdjustRange ()

public boolean getAllowNegativesFlag ()

Returns

public boolean getAutoRangeNextLogFlag ()

Returns

public boolean getExpTickLabelsFlag ()

Returns

public boolean getLog10TickLabelsFlag ()

Returns

public boolean getStrictValuesFlag ()

Returns

public double java2DToValue (double java2DValue, Rectangle2D plotArea, RectangleEdge edge)

Parameters

Returns

public void setAllowNegativesFlag (boolean flgVal)

Parameters

public void setAutoRangeNextLogFlag (boolean flag)

Parameters

public void setExpTickLabelsFlag (boolean flgVal)

Parameters

public void setLog10TickLabelsFlag (boolean flag)

Parameters

public void setRange (Range range)

Parameters

public void setStrictValuesFlag (boolean flgVal)

Parameters

public double switchedPow10 (double val)

Parameters

Returns

See Also

public double valueToJava2D (double value, Rectangle2D plotArea, RectangleEdge edge)

Parameters

Returns

public void zoomRange (double lowerPercent, double upperPercent)

Parameters

Protected Methods

protected double computeLogCeil (double upper)

Parameters

Returns

protected double computeLogFloor (double lower)

Parameters

Returns

protected String makeTickLabel (double val)

Parameters

Returns

protected String makeTickLabel (double val, boolean forceFmtFlag)

Parameters

Returns

protected List refreshTicksHorizontal (Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge)

Parameters

Returns

protected List refreshTicksVertical (Graphics2D g2, Rectangle2D dataArea, RectangleEdge edge)