Publication date: 07/08/2024

Axis Box Messages

Axis Box<<Axis Settings(<named arguments>)

Opens the Axis Specification window or specifies axis settings, such as tick marks and axis labels.

If no arguments are included, the axis specification window appears.

Otherwise, specify named arguments for each axis.

Specify the Y axis as Axis Box(1).

Specify the X axis as Axis Box(2).

Optional Named Arguments

All Axes

Scale("Linear"|"Log"|"Power"|"Geodesic"|"Geodesic US"|"Custom Scale"|"Normal Probability|Weibull Probability|Frechet Probability|Logistic Probability|Exponential Probability|Gamma Probability|Beta Probability|Mixture of 2 Normals Probabilities|Mixture of 3 Normals Probabilities)

Specifies the scale of the axis. If the type is Custom Scale, this message expects two additional named arguments: Scale to Internal(expr) and Scale to External(expr).

Min(n)

Changes the minimum value on the axis.

Max(n)

Changes the maximum value on the axis.

Reverse Order(Boolean)

Reverses the axes by reversing the minimum and maximum values.

Inc(n)

Shows the numbers at the specified increments.

Set Font(font)

Specifies the quoted font that is applied to the numbers. The JMP Font preferences determine the default font.

Set Font Size(points)

Specifies the size of the font that is applied to the numbers. The JMP Font preferences determine the default font.

Set Font Style("Strikeout"|"Underline")

Specifies the quoted style that is applied to the numbers.

Automatic Font Size(Boolean)

JMP attempts to decrease the font size (down to a certain minimum) if all of the labels cannot fit at the default size. If 0, the font size is not decreased.

Automatic Tick Marks(Boolean)

Turns on tick marks only if one or more labels are hidden (due to insufficient space).

Label Orientation( "Automatic"|"Horizontal"|"Vertical"|"Perpendicular"|"Parallel"|"Angled")

Rotates the axis label. The default value is "Automatic", which is based on the width of the labels.

Lower Frame(Boolean)

Shows a frame below the labels. The default value is off.

Value Labels

Displays the label that you specify instead of the data value.

Inside Ticks(Boolean)

Shows tick marks inside or outside of the axis.

Add Ref Line({Label Row Nesting(n), begin range, <end range>, <"Solid"|"Dotted"|"Dashed"|"DashDot"|"DashDotDot">, <color>, <label>, <width(n)>, <opacity(%)>})

Defines the reference line range, line pattern, color, label, width, and opacity. A solid, black, 1-pixel line is the default setting. Label Row Nesting(n) specifies the number of nested rows on the axis. The color and label arguments are quoted.

Categorical Axes

Wrap Lines(n)

Wraps long labels across multiple lines (n).

Numeric Axes

Format(arguments)

Specifies the format of the numeric axis data. See the Format list in a numeric column’s column properties for arguments. If you specify the a datetime format, also include the Interval argument: "Numeric", "Year", "Quarter", "Month", "Week", "Day", "Hour", "Minute", or "Second".

Minor Ticks(number)

Specifies the number of minor tick marks between major tick marks.

Tick Offset(number)

Specifies the starting point of the tick marks.

Major Ticks(Boolean)

Shows or hides a major tick mark between each number.

Minor Ticks(Boolean)

Shows or hides a minor tick mark between each number.

Show Major Grid(Boolean)

Shows or hides a grid line at each major tick mark.

Show Minor Grid(Boolean)

Shows or hides a grid line at each minor tick mark.

Major Grid Line Color(color)

Sets the color for the major grid (if enabled) using the quoted color.

Minor Grid Line Color(color)

Specifies the color of the grid line at each minor tick mark.

Example

The following example creates a bivariate plot and defines basic settings for the X and Y axes.

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );
biv = dt << Bivariate( X( :height ), Y( :weight ), FitLine );
rbiv = biv << Report;
xaxis = rbiv[Axis Box( 2 )];
yaxis = rbiv[Axis Box( 1 )];
xaxis << Axis Settings( Show Major Grid( 1 ) );
yaxis << Axis Settings( Decimal( 10, 3 ) );

Axis Box<<Add Axis Label(quoted string)

Adds an axis label with the specified quoted string.

Axis Box<<Add Ref Line(number, linestyle, <color>, <label>, <width>)

Adds a reference line at number in the specified linestyle ("Solid"|"Dashed"|"Double"), color (using the quoted color), quoted label, and width (in pixels).

Axis Box<<Decimal(width, decimal places)

Changes the numeric format for axis values.

Axis Box<<Format(name)

Changes to the numeric format given by the quoted name.

Axis Box<<Get Inc(n)

Gets the increment value of the axis.

Axis Box<<Inc(n)

Sets the increment between ticks.

Axis Box<<Interval(format)

Specifies the units used for Inc() with date/time formats: "Numeric", "Year", "Quarter", "Month", "Week", "Day", "Hour", "Minute", or "Second".

Axis Box<<Label Orientation(format)

Rotates the axis label to one of the following formats: "Automatic" (the default setting based on the width of the label), "Horizonal", "Vertical", "Perpendicular", "Parallel", and "Angled".

Axis Box<<Major Grid Line Color(color)

Sets the color for the major grid (if enabled) using the quoted color.

Axis Box<<Max(maximum)

Changes the maximum value on the axis.

Axis Box<<Minor Grid Line Color(color)

Sets the color for the minor grid (if enabled) using the quoted color.

Axis Box<<Min(minimum)

Changes the minimum value on the axis.

Axis Box<<Minor Ticks(number)

Specifies the number of minor tick marks between major tick marks.

Axis Box<<Remove Axis Label

Removes any label added with Add Axis Label.

Axis Box<<Reverse Scale(Boolean)

Reverses the normal scale direction so that the highest value is on the left or bottom (that is, closest to the origin).

Axis Box<<Revert Axis

Restores the axis’ original settings (from time of creation).

Axis Box<<Scale(type)

Changes the scale of the axis to type ("Linear"|"Log"|"Exp Prob"|"Weibull Prob"| "Logistic Prob"|"Frechet Prob"|"Normal"|"Cube Root"|"Johnson Su Scale"| "Geodesic"|"Geodesic US"|"Custom Scale"|"Power"|"Gamma Prob"|"Beta Prob"|"Mixture of 2 Normals Prob"|"Mixture of 3 Normals Prob").

If the type is Custom Scale, this message expects two additional named arguments: Scale to Internal(expr) and Scale to External(expr).

Axis Box<<Tick Font(name, <size>, <style|style style...>, <angle>)

Sets the font name (quoted), size, and quoted properties for tick marks. To specify more than one style, include a space between each style and place them in quotes.

Axis Box<<Show Labels(Boolean)

Shows or hides labels for the axis values.

Axis Box<<Show Major Grid(Boolean)

Adds or removes grid lines at the major tick values.

Axis Box<<Show Major Ticks(Boolean)

Shows or hides major tick marks.

Axis Box<<Show Minor Grid(Boolean)

Adds or removes grid lines at the minor tick values.

Axis Box<<Show Minor Ticks(Boolean)

Shows or hides minor tick marks.

Axis Box<<Tick Label List(<i>, {text1,text2, ...},<{n1, n2, ...}>)

Sets the values and positions of the axis tick labels.

Note: Major tick increments are automatically set to 1.0 if the tick labels are not specified.

Required Arguments

{text1,text2, ...}

Specifies the quoted string titles for your labels.

Optional Arguments

i

Specifies the label row index. Leaving it out clears any existing label rows and creates one new one as specified. Including it allows you to override any particular label row; using an index higher than the current number of label rows adds a new label row on to the end.

{n1, n2, ...}

Specifies the values corresponding to each label. If the value list is omitted, the labels will be on integer increments starting with 1.

Want more information? Have questions? Get answers in the JMP User Community (community.jmp.com).