DependencyChart Properties
Grammatical dependency chart
DependencyChart
properties control the appearance and behavior
of a DependencyChart
object. By changing property values, you can modify
certain aspects of the dependency chart.
To create a DependencyChart
object, use sentenceChart
.
Color and Styling
Orientation
— Display orientation of sentence
"horizontal"
(default) | "vertical"
Display orientation of the sentence, specified as one of these values:
"horizontal"
— display the tokens horizontally with the tree reading from top to bottom."vertical"
— display the tokens vertically with the tree reading from left to right.
LineWidth
— Dependency line width
0.5
(default) | positive scalar
Dependency line width, specified as a positive scalar in points, where 1 point = 1/72 of an inch.
The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.
Note
If you do not specify LeaderLineWidth
, then the function
automatically sets LeaderLineWidth
to the value of
LineWidth
. To change the dependency line width only, set
LeaderLineWidth
to 0.5
.
LineColor
— Dependency line color
[0 0 0]
(default) | RGB triplet | string scalar or character vector
Dependency line color, specified as an RGB triplet or a string scalar or character vector containing a color name.
RGB triplets and hexadecimal color codes are useful for specifying custom colors.
An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]
; for example,[0.4 0.6 0.7]
.A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (
#
) followed by three or six hexadecimal digits, which can range from0
toF
. The values are not case sensitive. Thus, the color codes'#FF8800'
,'#ff8800'
,'#F80'
, and'#f80'
are equivalent.
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.
Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan"
| "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB® uses in many types of plots.
RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
LineStyle
— Dependency line style
"-"
(default) | "--"
| ":"
| "-."
| "none"
Dependency line style, specified as one of the options listed in this table.
Line Style | Description | Resulting Line |
---|---|---|
"-" | Solid line |
|
"--" | Dashed line |
|
":" | Dotted line |
|
"-." | Dash-dotted line |
|
"none" | No line | No line |
LeaderLineWidth
— Leader line width
LineWidth
(default) | positive scalar
Leader line width, specified as a positive scalar in points, where 1 point = 1/72 of an inch.
The line width cannot be thinner than the width of a pixel. If you set the line width to a value that is less than the width of a pixel on your system, the line displays as one pixel wide.
LeaderLineColor
— Leader line color
[0 0 0]
(default) | RGB triplet | string scalar or character vector
Leader line color, specified as an RGB triplet or a string scalar or character vector containing a color name.
RGB triplets and hexadecimal color codes are useful for specifying custom colors.
An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range
[0,1]
; for example,[0.4 0.6 0.7]
.A hexadecimal color code is a character vector or a string scalar that starts with a hash symbol (
#
) followed by three or six hexadecimal digits, which can range from0
toF
. The values are not case sensitive. Thus, the color codes'#FF8800'
,'#ff8800'
,'#F80'
, and'#f80'
are equivalent.
Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.
Color Name | Short Name | RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan"
| "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.
RGB Triplet | Hexadecimal Color Code | Appearance |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[0.8500 0.3250 0.0980] | "#D95319" | |
[0.9290 0.6940 0.1250] | "#EDB120" | |
[0.4940 0.1840 0.5560] | "#7E2F8E" | |
[0.4660 0.6740 0.1880] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
LeaderLineStyle
— Leader line style
":"
(default) | "-"
| "--"
| "-."
| "none"
Leader line style, specified as one of the options listed in this table.
Line Style | Description | Resulting Line |
---|---|---|
"-" | Solid line |
|
"--" | Dashed line |
|
":" | Dotted line |
|
"-." | Dash-dotted line |
|
"none" | No line | No line |
FontName
— Token and label font name
"Helvetica"
(default) | string scalar | character vector
Token and label font name, specified as a supported font name . For labels to display and print properly, you must choose a font that your system supports. The default font depends on the specific operating system and locale. For example, Windows® and Linux® systems in English localization use the Helvetica font by default.
Data Types: char
| string
FontSize
— Token font size
10
(default) | positive scalar
Token font size in point units, specified as a positive scalar. One point equals 1/72
inch.
Note
If you do not specify the LabelFontSize
option, then the function automatically sets the LabelFontSize
option to 0.8*LineWidth
. To change the token font size only, set the LabelFontSize
option to 8
.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
LabelFontSize
— Label font size
0.8*FontSize
(default) | positive scalar
Label font size in point units, specified as a positive scalar. One point equals 1/72
inch.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
FontAngle
— Token character slant
'normal'
(default) | 'italic'
Token character slant, specified as 'normal'
or
'italic'
.
Not all fonts have both font styles. Therefore, the italic font might look the same as the normal font.
FontUnits
— Token font size units
'points'
(default) | 'inches'
| 'centimeters'
| 'normalized'
| 'pixels'
Token font size units, specified as one of the values in this table.
Units | Description |
---|---|
'points' | Points. One point equals 1/72 inch. |
'inches' | Inches. |
'centimeters' | Centimeters. |
'normalized'
| Interpret font size as a fraction of the axes plot box height. If you
resize the axes, the font size modifies accordingly. For example, if the
FontSize is 0.1 in normalized units,
then the text is 1/10 of the plot box height. |
'pixels' | Pixels. Distances in pixels are independent of your system resolution on Windows and Macintosh systems:
On Linux systems, the size of a pixel is determined by your system resolution. |
If you set both the font size and the font units in one function call, you must set
the FontUnits
property first so that the axes correctly interprets
the specified font size.
FontWeight
— Token character thickness
'normal'
(default) | 'bold'
Token character thickness, specified as 'normal'
or
'bold'
.
MATLAB uses the FontWeight
property to select a font from
those available on your system. Not all fonts have a bold weight. Therefore, specifying
a bold font weight can still result in the normal font weight.
LabelFontAngle
— Label character slant
'italic'
(default) | 'normal'
Label character slant, specified as 'italic'
or
'normal'
.
Not all fonts have both font styles. Therefore, the italic font might look the same as the normal font.
LabelFontWeight
— Label character thickness
'normal'
(default) | 'bold'
Label character thickness, specified as 'normal'
or
'bold'
.
MATLAB uses the FontWeight
property to select a font from
those available on your system. Not all fonts have a bold weight. Therefore, specifying
a bold font weight can still result in the normal font weight.
Data
Token
— Sentence tokens
string vector | cell array of character vectors
Sentence tokens, specified as a string vector or a cell array of character vectors.
Data Types: string
| cell
Head
— Token dependency heads
vector of nonnegative integers
Token dependency heads, specified as a vector of nonnegative integers, where
Head(i)
is the index of the head token of
Token(i)
and Head(i)
is 0
for
the root token.
The dependency structure of Head
must encode a tree.
Data Types: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
Dependency
— Token dependency types
categorical vector | string vector | cell array of character vectors
Token dependency types, specified as a categorical vector, string vector, or a cell array of character vectors.
Data Types: string
| cell
| categorical
Position
HandleVisibility
— Visibility of object handle
'on'
(default) | 'off'
| 'callback'
Visibility of the object handle in the Children
property of the parent, specified as one of these values:
'on'
— Object handle is always visible.'off'
— Object handle is invisible at all times. This option is useful for preventing unintended changes to the UI by another function. Set theHandleVisibility
to'off'
to temporarily hide the handle during the execution of that function.'callback'
— Object handle is visible from within callbacks or functions invoked by callbacks, but not from within functions invoked from the command line. This option blocks access to the object at the command-line, but allows callback functions to access it.
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. This includes get
, findobj
, gca
, gcf
, gco
, newplot
, cla
, clf
, and close
.
Hidden object handles are still valid. Set the root ShowHiddenHandles
property to 'on'
to list all object handles regardless of their HandleVisibility
property setting.
InnerPosition
— Inner size and location
[0 0 1 1]
(default) | four-element vector
Inner size and location, specified as a four-element vector of the form
[left bottom width height]
. This property is equivalent to the
Position
property.
Note
Setting this property has no effect when the parent container is a
TiledChartLayout
object.
Layout
— Layout options
empty LayoutOptions
array (default) | TiledChartLayoutOptions
object | GridLayoutOptions
object
Layout options, specified as a TiledChartLayoutOptions
or a
GridLayoutOptions
object. This property is useful when the
dependency chart object is either in a tiled chart layout or a grid layout.
To position the axes 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 dependency chart sc
in the third tile of the
grid..
sc.Layout.Tile = 3;
To make the dependency chart span multiple tiles, specify the
TileSpan
property as a two-element vector. For example, this
dependency chart spans 2
rows and 3
columns of
tiles.
sc.Layout.TileSpan = [2 3];
To place the dependency 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 dependency chart
in the tile to the right of the
grid.
sc.Layout.Tile = 'east';
To place the dependency 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 dependency 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.
OuterPosition
— Size and location, including labels and margin
[0 0 1 1]
(default) | four-element vector
Size and location, including the labels and a margin, specified as a four-element
vector of the form [left bottom width height]
. By default,
MATLAB measures the values in units normalized to the container. To change the
units, set the Units
property. The default value of [0 0 1
1]
includes the whole interior of the container.
The
left
andbottom
elements define the distance from the lower left corner of the container (typically a figure, panel, or tab) to the lower left corner of the outer position boundary.The
width
andheight
elements are the outer position boundary dimensions.
This figure shows the areas defined by the OuterPosition
values
(blue) and the Position
values (red). By default, both
InnerPosition
and OuterPosition
are the
same.
For more information, see Control Axes Layout.
Position
— Size and location, excluding margin for labels
[0.1300 0.1100 0.7750 0.8150]
(default) | four-element vector
Size and location, excluding a margin for the labels, specified as a four-element
vector of the form [left bottom width height]
. By default,
MATLAB measures the values in units normalized to the container. To change the
units, set the Units
property.
The
left
andbottom
elements define the distance from the lower left corner of the container (typically a figure, panel, or tab) to the lower left corner of the position boundary.The
width
andheight
elements are the position boundary dimensions. For axes in a 3-D view, thePosition
property is the smallest rectangle that encloses the axes.
This figure shows the areas defined by the OuterPosition
values
(blue) and the Position
values (red). By default, both
InnerPosition
and OuterPosition
are the
same.
For more information, see Control Axes Layout.
Note
Setting this property has no effect when the parent container is a
TiledChartLayout
Units
— Position units
'normalized'
(default) | 'inches'
| 'centimeters'
| 'points'
| 'pixels'
| 'characters'
Position units, specified as one of these values.
Units | Description |
---|---|
'normalized' (default) | Normalized with respect to the container, which is typically the figure
or a panel. The lower left corner of the container maps to
(0,0) and the upper right corner maps to
(1,1) . |
'inches' | Inches. |
'centimeters' | Centimeters. |
'characters' | Based on the default uicontrol font of the graphics root object:
|
'points' | Typography points. One point equals 1/72 inch. |
'pixels' | Pixels. Starting in R2015b, distances in pixels are independent of your system resolution on Windows and Macintosh systems.
|
When specifying the units as name-value arguments during object creation, you must
set the Units
property before specifying the properties that you
want to use these units, such as Position
.
Visible
— State of visibility
'on'
(default) | 'off'
State of visibility, specified as one of these values:
'on'
— Display the object.'off'
— Hide the object without deleting it. You still can access the properties of an invisible object.
Parent/Child
Parent
— Parent
Axes
object | PolarAxes
object | Group
object | Transform
object
Parent, specified as an Axes
, PolarAxes
, Group
, or Transform
object.
Version History
Introduced in R2022b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)