WordCloudChart Properties

Text displayed above word cloud chart in figure, specified as a character array, cell array of character vectors, scalar string, cell array of strings, a numeric value, or a categorical array. If you specify this property as a categorical array, then MATLAB^® uses the values in the array, not the full set of categories. You can also use the title function to set this value.

Example: "Word Cloud"

Data Types: string | char | cell

Font used for title text in the word cloud chart, specified as a string or character vector. To display and print properly, the font name must be a font that your system supports. The default font depends on the specific operating system and locale.

Example: 'Cambria'

Data Types: char | string

Word color, specified as an RGB triplet, a character vector containing a color name, or an N-by-3 matrix where N is the length of WordData. If Color is a matrix, then each row corresponds to an RGB triplet for the corresponding word in WordData.

RGB triplets and hexadecimal color codes are useful for specifying custom colors.

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.

Example: 'blue'

Example: [0 0 1]

Word highlight color, specified as an RGB triplet, or a character vector containing a color name. The software highlights the largest words with this color.

RGB triplets and hexadecimal color codes are useful for specifying custom colors.

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.

Example: 'blue'

Example: [0 0 1]

Font used for text in the word cloud chart, specified as a string or character vector. To display and print properly, the font name must be a font that your system supports. The default font depends on the specific operating system and locale.

Example: 'Cambria'

Data Types: char | string

Maximum number of words to display, specified as a non-negative integer. The software displays the MaxDisplayWords largest words.

Axes box outline, 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: 'on'

Shape of word cloud chart, specified as 'oval' or 'rectangle'.

Example: 'rectangle'

Word placement layout, specified as a nonnegative integer. If you repeatedly call wordcloud with the same inputs, then the word placement layouts will be the same each time. To get different word placement layouts, use different values of LayoutNum.

Power to apply to SizeData, specified as a positive scalar. The software displays words with sizes given by SizeData .^ SizePower.

Example: 2

Word data, specified as a string vector, or a cell array of character vectors.

Example: ["one" "two" "three"]

Data Types: string | cell

Size data, specified as a numeric vector.

Example: [0.1 0.2 0.3]

Word variable in the source table, specified as a character vector.

Data Types: char

Size variable in the source table, specified as a character vector.

Data Types: char

Source table containing word and size data.

Data Types: table

Size and position of word cloud chart within its parent, specified as a 1-by-4 numeric vector of the form [left,bottom,width,height]. This includes labels and margins. The default value of [0 0 1 1] includes the whole interior of the container.

Inner size and position of the word cloud within the parent container (typically a figure, panel, or tab) returned as a 1-by-4 numeric vector of the form [left bottom width height].

Inner size and position of the word cloud within the parent container (typically a figure, panel, or tab) specified as a four-element vector of the form [left bottom width height]. This property is equivalent to the InnerPosition property.

Position property to hold constant when adding, removing, or changing decorations, specified as one of the following values:

Units used by OuterPosition property, specified as 'normalized', 'points', 'pixels', 'characters', 'inches', or 'centimeters'.

Layout options, specified as a TiledChartLayoutOptions or GridLayoutOptions object. This property is useful when the chart is either in a tiled chart layout or a grid layout.

To position the chart within the grid of a tiled chart layout, set the Tile and TileSpan properties on the TiledChartLayoutOptions object. For example, consider a 3-by-3 tiled chart layout. The layout has a grid of tiles in the center, and four tiles along the outer edges. In practice, the grid is invisible and the outer tiles do not take up space until you populate them with axes or charts.

This code places the chart c in the third tile of the grid.

c.Layout.Tile = 3;

To make the chart span multiple tiles, specify the TileSpan property as a two-element vector. For example, this chart spans 2 rows and 3 columns of tiles.

c.Layout.TileSpan = [2 3];

To place the chart in one of the surrounding tiles, specify the Tile property as "north", "south", "east", or "west". For example, setting the value to "east" places the chart in the tile to the right of the grid.

c.Layout.Tile = "east";

To place the chart into a layout within an app, specify this property as a GridLayoutOptions object. For more information about working with grid layouts in apps, see uigridlayout.

If the chart is not a child of either a tiled chart layout or a grid layout (for example, if it is a child of a figure or panel) then this property is empty and has no effect.

State of 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.

Parent container, specified as a Figure, Panel, Tab, TiledChartLayout, or GridLayout object.

Visibility of the object handle in the Children property of the parent, specified as one of these values:

If the object is not listed in the Children property of the parent, then functions that obtain object handles by searching the object hierarchy or querying handle properties cannot return it. Examples of such functions include the get, findobj, gca, gcf, gco, newplot, cla, clf, and close functions.

Hidden object handles are still valid. Set the root ShowHiddenHandles property to "on" to list all object handles regardless of their HandleVisibility property setting.