Value Axis
An axis that displays numbers or dates (internally represented as numeric values).
Usage:
- In a Category Plot, the default range axis is a Value Axis.
- In an XY Plot, both the domain and range axes are of Value Axis type by default.
the Axis Range
The axis range defines the highest and lowest values that will be displayed on axis. On a chart, it is typically the case that data values outside the axis range are clipped, and therefore not visible on the chart.
Automatic Bounds Calculation
By default, the axis is configured to automatically calculate ranges so that all of the data in your dataset is visible. It does this by determining the highest and lowest values in your dataset, adding a small margin (to prevent the data being plotted right up to the edge of a chart), and setting the axis range. To control whether or not the axis range is automatically adjusted to fit the available data, use Auto Range parameter.
Properties
See Axis for the list of generic axis properties.
Value axis has the following additional properties:
Property | Name | Type | Description |
Type | type | Integer | Axis type: Number Axis, Date Axis, Period Axis, Logarithmic Axis, or Symbol Axis. |
Inverted | inverted | Boolean | Flag that controls whether or not the axis scale is inverted. |
Vertical Tick Labels | verticalTickLabels | Boolean | Flag that controls whether or not the tick labels are rotated by 90 degrees. It is usually set to fit more labels in. |
Lower Margin | lowerMargin | Float | Lower margin for the axis, as a percentage of the total axis length. The default value is 0.05 (five percent). Note that the margin is only applied when the axis bounds are automatically calculated. If you set the axis bounds manually then the margins are ignored. |
Upper Margin | upperMargin | Float | Upper margin for the axis, as a percentage of the total axis length. The default value is 0.05 (five percent). Note that the margin is only applied when the axis bounds are automatically calculated. If you set the axis bounds manually then the margins are ignored. |
Positive Arrow Visible | positiveArrowVisible | Boolean | Flag that controls whether or not an arrow is drawn at the positive end of the scale. |
Negative Arrow Visible | negativeArrowVisible | Boolean | Flag that controls whether or not an arrow is drawn at the negative end of the scale. |
Up Arrow | upArrow | Data Table | Shape used to draw an arrow at the end of an axis pointing upwards. |
Down Arrow | downArrow | Data Table | Shape used to draw an arrow at the end of an axis pointing downwards. |
Left Arrow | leftArrow | Data Table | Shape used to draw an arrow at the end of an axis pointing leftwards. |
Right Arrow | rightArrow | Data Table | Shape used to draw an arrow at the end of an axis pointing rightwards. |
Auto Tick Unit Selection | autoTickUnitSelection | Boolean | Flag controlling whether or not the tick units are selected automatically. |
Auto Range | autoRange | Boolean | Flag that controls whether or not the axis range is automatically adjusted to fit the available data values. |
Fixed Auto Range | fixedAutoRange | Float | If specified (non-zero), the auto-range is calculated by subtracting this value from the maximum domain value in the dataset. |
Auto Range Minimum Size | autoRangeMinimumSize | Float | The smallest axis range allowed when it is automatically calculated. |
Period Axis Label Info
The axis supports one or more "bands" of labels, where each band is defined by the following properties:
Property | Name | Type | Description |
Period | periodClass | String | Time period type: Year, Month, Day, Hour, Minute, Second, or Millisecond. |
Padding | padding | Data Table | Padding that controls the minimum space between labels. See Rectangle Insets. |
Date Format | dateFormat | String | A date/time formatting pattern for the labels on the band. |
Label Font | labelFont | Data Table | Font used to display labels for each time period. |
Label Paint | labelPaint | Data Table | Paint that is used as the foreground color when displaying labels for each time period. |
Draw Dividers | drawDividers | Boolean | Flag that determines whether or not dividers are drawn between time periods. |
Divider Stroke | dividerStroke | Data Table | Stroke used to draw dividers between time periods. |
Divider Paint | dividerPaint | Data Table | Paint used to draw dividers between time periods. |
Was this page helpful?