CategoricalRuler Properties

Color of the axis line and labels, specified as an RGB triplet, a hexadecimal color code, a color name, or a short name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB^® uses in many types of plots.

Width of axis line and tick marks, specified as a positive value in point units. One point equals 1/72 inch.

Example: ax.XAxis.LineWidth = 2;

Axis label, which is a text object. To display text or change existing text, set the String property for the text object. Use other properties to change the text appearance, such as the font style or color.

ax = gca;
ax.XAxis.Label.String = 'X Axis';
ax.XAxis.Label.FontSize = 12;

For a full list of options, see Text Properties.

Alternatively, add or modify the axis labels using the xlabel, ylabel, and zlabel functions.

Axis label horizontal alignment, specified as one of the values from the table.

Axis visibility, specified as 'on' or 'off', or as numeric or logical 1 (true) or 0 (false). A value of 'on' is equivalent to true, and 'off' is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Example: ax.XAxis.Visible = 'off';

Scale of values along axis, specified as 'linear'.

Direction of increasing values, specified as one of these values:

Example: ax.XAxis.Direction = 'reverse';

Categories plotted along the axis, specified as a cell array of character vectors, a categorical array, or a string array. Querying this property returns a cell array of character vectors. Set this property to exclude certain categories from appearing in the chart.

Example: ax.XAxis.Categories = categorical({'small','medium','large'}) specifies a categorical array.

Example: ax.XAxis.Categories = {'small','medium','large'} specifies a cell array.

Example: ax.XAxis.Categories = string({'small','medium','large'}) specifies a string array.

Example

Create a histogram with categories along the x-axis and query the Categories property. Then set the Categories property so that only a subset of categories appear along the axis.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Categories

ans = 

  1×5 categorical array

     b      g      m      r      y 

ax.XAxis.Categories = categorical({'b','m','y'});

Data Types: cell | categorical | string

First and last categories displayed along the axis, specified as a two-element vector indicating two category names. The categories must be two of the categories in the Categories property, and must appear in the same relative order that they appear in the Categories property.

Example: ax.XAxis.Categories = categorical({'small','medium'}) specifies a two-element categorical array.

Example: ax.XAxis.Categories = {'small','medium'} specifies a two-element cell array.

Example: ax.XAxis.Categories = string({'small','medium'}) specifies a two-element string array.

If you assign a value to this property, then MATLAB changes the associated LimitsMode property to 'manual'.

Alternatively, set the limits using the xlim, ylim, and zlim functions.

Example

Set the Limits property to only show the categories between 'b' and 'm' along the axis.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.Limits = categorical({'b','m'});

Data Types: categorical | string | cell

Selection mode for the Limits property, specified as one of these values:

Tick mark locations along the axis, specified as a cell array of character vectors, a categorical array, or a string array indicating category names. The categories must be a subset of the categories in the Categories property and must appear in the same relative order that they appear in the Categories property. To remove all tick marks and labels along the axis, set this property to an empty array [].

Example: ax.XAxis.Categories = categorical({'small','medium','large'}) specifies a categorical array.

Example: ax.XAxis.Categories = {'small','medium','large'} specifies a cell array.

Example: ax.XAxis.Categories = string({'small','medium','large'}) specifies a string array.

If you assign a value to this property, then MATLAB sets the TickValuesMode property to 'manual'.

Alternatively, use the xticks, yticks, and zticks functions.

Example

Label a subset of categories along the axis by setting the TickValues property to a subset of categories.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g' 'm'});
h = histogram(A);
ax = gca;
ax.XAxis.TickValues = categorical({'b','m','y'});

Data Types: categorical | string | cell

Selection mode for the TickValues property, specified as one of these values:

Tick mark labels, specified as a cell array of character vectors, string array, or categorical array. Use this property to relabel the tick marks without changing the category names. If you do not specify a label for every value, then the labels repeat. The labels support TeX and LaTeX markup. See the TickLabelInterpreter property for more information.

If you set this property, then MATLAB sets the TickLabelsMode property to 'manual'.

Alternatively, specify the tick labels using the xticklabels, yticklabels, and zticklabels functions.

Example

Relabel the categories along the x-axis.

A =  categorical({'r' 'b' 'g' 'g' 'r' 'b' 'b' 'r' 'g' 'y' 'g'});
h = histogram(A);
ax = gca;
ax.XAxis.TickLabels = {'Blue','Green','Red','Yellow'}

Data Types: char | string | categorical

Selection mode for the TickLabels property, specified as one of these values:

Tick label color, specified as an RGB triplet, a hexadecimal color code, a color name, or a short name.

For a custom color, specify an RGB triplet or a hexadecimal color code.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

Tick label interpreter, specified as one of these values:

TeX Markup

By default, MATLAB supports a subset of TeX markup. Use TeX markup to add superscripts and subscripts, modify the text type and color, and include special characters in the text.

Modifiers remain in effect until the end of the text. Superscripts and subscripts are an exception because they modify only the next character or the characters within the curly braces. When you set the interpreter to 'tex', the supported modifiers are as follows.

This table lists the supported special characters for the 'tex' interpreter.

LaTeX Markup

To use LaTeX markup, set the TickLabelInterpreter property to 'latex'. Use dollar symbols around the labels, for example, use '$\int_1^{20} x^2 dx$' for inline mode or '$$\int_1^{20} x^2 dx$$' for display mode.

The displayed text uses the default LaTeX font style. The FontName, FontWeight, and FontAngle properties do not have an effect. To change the font style, use LaTeX markup within the text. The maximum size of the text that you can use with the LaTeX interpreter is 1200 characters. For multiline text, the maximum size of the text reduces by about 10 characters per line.

For examples that use TeX and LaTeX, see Greek Letters and Special Characters in Chart Text. For more information about the LaTeX system, see The LaTeX Project website at https://www.latex-project.org/.

Rotation of tick labels, specified as a scalar value in degrees. Positive values give counterclockwise rotation. Negative values give clockwise rotation.

Alternatively, you can rotate the tick labels using the xtickangle, ytickangle, and ztickangle functions.

Example: ax.XAxis.TickLabelRotation = 45;

Example: ax.YAxis.TickLabelRotation = -45;

Selection mode for the TickLabelRotation property, specified as one of these values:

Tick mark direction, specified as one of these values:

If you assign a value to this property, then MATLAB sets the TickDirectionMode property to 'manual'.

Selection mode for the TickDirection property, specified as one of these values:

Tick mark length, specified as a two-element vector of the form [2Dlength 3Dlength]. The first element is the tick mark length in 2-D views. The second element is the tick mark length in 3-D views. Specify the values in units normalized relative to the longest axes dimension.

Example: ax.YAxis.TickLength = [0.02 0.035];

Minor tick mark display, specified as 'on' or 'off', or as numeric or logical 1 (true) or 0 (false). A value of 'on' is equivalent to true, and 'off' is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Example: ax.XAxis.MinorTick = 'on';

Minor tick mark locations, specified as a cell array of character vectors, a categorical array, or a string array indicating category names. The categories must be a subset of the categories in the Categories property and must appear in the same relative order that they appear in the Categories property.

If you assign values to this property, then MATLAB sets the MinorTickValuesMode property to 'manual'.

Data Types: categorical | string | cell

Selection mode for the MinorTickValues property, specified as one of these values:

Font name, specified as a system supported font name or 'FixedWidth'. The default font depends on the specific system and locale. To use a fixed-width font that renders well, specify 'FixedWidth'. The actual fixed-width font used depends on the FixedWidthFontName property of the root object.

Example: ax.XAxis.FontName = 'Cambria';

Font size, specified as a scalar numeric value. The default font size depends on the specific operating system and locale.

Example: ax.XAxis.FontSize = 12;

Thickness of the text characters, specified as one of these values:

MATLAB uses the FontWeight property to select a font from those available on your system. Not all fonts have a bold font weight. Therefore, specifying a bold font weight still can result in the normal font weight.

Example: ax.XAxis.FontWeight = 'bold';

Character slant, specified as 'normal' or 'italic'. Not all fonts have both font styles. Therefore, the italic font can look the same as the normal font.

Example: ax.XAxis.FontAngle = 'italic';

Text smoothing, specified as 'on' or 'off', or as numeric or logical 1 (true) or 0 (false). A value of 'on' is equivalent to true, and 'off' is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Example: ax.XAxis.FontSmoothing = 'off';

Axis limits changed callback, specified as one of these values:

This callback executes after the axis limits have changed, either programmatically or using an interaction such as panning within the axes. It can also execute if MATLAB changes the axis limits to encompass the range of your data when you call a plotting function.

This callback function can access specific information about the axis limits. MATLAB passes this information in a LimitsChanged object as the second argument to your callback function. If you are developing an app in App Designer, the argument is called event. You can query the object properties using dot notation. For example, event.NewLimits returns the new axis limits. The LimitsChanged object is not available to callback functions specified as character vectors.

The following table lists the properties of the LimitsChanged object.

For more information about writing callbacks in apps, see Callbacks in App Designer.

Ruler parent, specified as an Axes object.

The ruler has no children. You cannot set this property.