SmithPlot Properties
Control appearance and behavior of Smith chart
Smith chart properties control the appearance and behavior of the Smith plot object. By changing property values, you can modify certain aspects of the Smith chart. To change the default properties use: .
s = smithplot(____,Name,Value)
To view all the properties of the Smith plot object use:
details(s)
Display
ClipData — Clip data to outer circle
1 (default) | 0
Clip data to outer circle, specified as 0 or
1.
Data Types: logical
ColorOrder — Colors to use for multiline plots
seven predefined colors (default) | three-column matrix of RGB triplets
Colors to use for multi-line plots, specified as three-column matrix of RGB triplets. Each row of the matrix defines one color in the color order.
Data Types: double
ColorOrderIndex — Next color to use in color order
1 (default) | positive integer
Next color to use in color order, specified as a positive integer. New plots added to the axes use colors based on the current value of the color order index.
Data Types: double
FontName — Font name
'Helvetica' (default) | character vector
Font name, specified as a character vector.
Note
To display and print text properly, you must choose a font that your system supports. The default font depends on your operating system and locale.
To use a fixed-width font that looks good in any locale, use
FixedWidth. The fixed-width font relies on the rootFixedWidthFontNameproperty.The
listfontsfunction generates list of available font names.
Data Types: char
FontSize — Font size
10 (default) | positive integer
Font size, specified as a positive integer.
Data Types: double
FontSizeMode — Changes the font size based on window size
'auto' (default) | 'manual'
Font size mode, specified as 'auto'. Changes the font
size based on window size.
Data Types: char
GridBackgroundColor — Background grid line color
'w' (default) | character vector of color names | 'none'
Background gird line color, specified as an RGB triplet, or as a character
vector of color names, or 'none'. Using
'none' turns off the grid completely.
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 from0toF. 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' |
|
Data Types: char | double
GridForegroundColor — Foreground grid line color
[0.4000 0.4000 0.4000] (default) | 'none' | character vector of color names
Foreground grid line color, specified as RGB triplet, or as a character
vector of color names, or 'none'.
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 from0toF. 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' |
|
Data Types: double | char
GridLineStyle — Grid line style
'-' (default) | '--' | ':' | '-.' | 'none'
Grid line style, specified as one of the following:
| Line Style | Description | Resulting Line |
|---|---|---|
| '-' | Solid line | ––––––– |
| '- -' | Dashed line | - - - - - - - - - |
| ':' | Dotted line | ….….... |
| '- .' | Dash-dotted line | - . - . - . |
| 'none' | No line | No line |
Data Types: char
GridLineWidth — Grid line width
'0.5000' (default) | positive scalar
Grid line width, specified as positive scalar.
Data Types: double
GridOverData — Draw grid over data plots
0 (default) | 1
Draw grid over data plots, specified as 0 or
1.
Data Types: logical
GridSubForegroundColor — Sub-foreground grid lines color
[0.8000 0.8000 0.8000] (default) | 'none' | character vector of color names
Sub foreground grid lines color, specified as an RGB triplet, character
vector of color names, or 'none'.
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 from0toF. 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' |
|
Data Types: char | double
GridSubLineStyle — Subgrid line style
'- .' (default) | '--' | ':' | '-' | 'none'
Subgrids line style, specified as one of the following:
| Line Style | Description | Resulting Line |
|---|---|---|
| '-' | Solid line | ––––––– |
| '- -' | Dashed line | - - - - - - - - - |
| ':' | Dotted line | ….….... |
| '- .' | Dash-dotted line | - . - . - . |
| 'none' | No line | No line |
Data Types: char
GridSubLineWidth — Subgrid line width
'0.5000' (default) | positive scalar
Subgrid line width, specified as positive scalar.
Data Types: double
GridType — Grid type
'Z' (default) | 'Y' | 'ZY' | 'YZ'
Grid type, specified as 'Z', 'Y',
'ZY', 'YZ'. Grid type specifies if
the plot is an admittance plot, impedance plot, or both.
Data Types: char
GridValue — Defines constant resistance circles and constant reactance arcs
[30.0 5.0 2.0 1.0 0.5 0.2; Inf 30.0 5.0 5.0 2.0
1.0] (default)
Two-row matrix. Row 1 specifies the values of the constant resistance circles and constant reactance arcs in the chart. Row 2 specifies the value at which the corresponding arcs and circles defined in Row 1 end.
Data Types: double
GridVisible — Show grid on Smith chart
'1' (default) | '0'
Show grid on Smith chart, specified as '1' or
'0'.
Data Types: logical
NextPlot — Directive on how to add next plot
'replace' (default) | 'new' | 'add'
Directive on how to add next plot, specified as a comma-separated pair
consisting of 'NextPlot' and one of the values in the
table:
| Property Value | Effect |
|---|---|
'new' | Creates a figure and uses it as the current figure. |
'add' | Adds new graphics objects without clearing or resetting the current figure. |
'replace' | Removes all axes objects and resets figure properties to their defaults before adding new graphics objects. |
Parent — Figure parent
root object
Figure parent, returned as a root object.
TitleBottom — Title to display below Smith chart
character vector
Title to display below the Smith chart, specified as a character vector.
Data Types: char
TitleBottomFontSizeMultiplier — Bottom title font scale factor
0.9000 (default) | numeric value greater than zero
Bottom title font scale factor, specified as a numeric value greater than zero.
Data Types: double
TitleBottomFontWeight — Bottom title font thickness
'normal' (default) | 'bold'
Bottom title font thickness, specified as 'bold' or
'normal.
Data Types: char
TitleBottomOffset — Offset between bottom title and arc ticks
0.1500 (default) | scalar
Offset between bottom title and angle ticks,specified as a scalar. The
value must be in the range
[-0.5,0.5].
Data Types: double
TitleBottomTextInterpreter — Interpretation of bottom title characters
'none' (default) | 'tex' | 'latex'
Interpretation of bottom title characters, specified one of the following:
'tex'— Interpret using a subset of TeX markup'latex'— Interpret using LaTeX markup'none'— Display literal characters
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.
This table lists the supported modifiers when the
TickLabelInterpreter property is set to
'tex', which is the default value. Modifiers
remain in effect until the end of the text, except for superscripts and
subscripts which only modify the next character or the text within the
curly braces {}.
| Modifier | Description | Example |
|---|---|---|
^{ } | Superscript | 'text^{superscript}' |
_{ } | Subscript | 'text_{subscript}' |
\bf | Bold font | '\bf text' |
\it | Italic font | '\it text' |
\sl | Oblique font (rarely available) | '\sl text' |
\rm | Normal font | '\rm text' |
\fontname{specifier} | Set specifier as the name of a
font family to change the font style. You can use
this markup with other modifiers. | '\fontname{Courier}
text' |
\fontsize{specifier} | Set specifier as a scalar
numeric value to change the font size. | '\fontsize{15} text' |
\color{specifier} | Set specifier as one of these
colors: red,
green,
yellow,
magenta,
blue, black,
white, gray,
darkGreen,
orange, or
lightBlue. | '\color{magenta} text' |
\color[rgb]{specifier} | Set specifier as a
three-element RGB triplet to change the font
color. | '\color[rgb]{0,0.5,0.5}
text' |
LaTeX Markup
To use LaTeX markup, set the TickLabelInterpreter
property to 'latex'. The displayed text uses the
default LaTeX font style. 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 reduces by about 10 characters per line.
Data Types: char
TitleTop — Title to display above the Smith chart
character vector
Title to display above the Smith chart, specified as a character vector.
Data Types: char
TitleTopFontSizeMultiplier — Top title font scale factor
1.1000 (default) | numeric value greater than zero
Top title font scale factor, specified as a numeric value greater than zero.
Data Types: double
TitleTopFontWeight — Top title font thickness
'bold' (default) | 'normal'
Top title font thickness, specified as 'bold' or
'normal.
Data Types: char
TitleTopOffset — Offset between top title and arc ticks
0.1500 (default) | scalar
Offset between top title and angle ticks, specified as a scalar. The value
must be in the range
[-0.5,0.5].
Data Types: double
TitleTopTextInterpreter — Interpretor of top title characters
'none' (default) | 'tex' | 'latex'
Interpretation of top title characters, specified one of the following:
'tex'— Interpret using a subset of TeX markup'latex'— Interpret using LaTeX markup'none'— Display literal characters
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.
This table lists the supported modifiers when the
TickLabelInterpreter property is set to
'tex', which is the default value. Modifiers
remain in effect until the end of the text, except for superscripts and
subscripts which only modify the next character or the text within the
curly braces {}.
| Modifier | Description | Example |
|---|---|---|
^{ } | Superscript | 'text^{superscript}' |
_{ } | Subscript | 'text_{subscript}' |
\bf | Bold font | '\bf text' |
\it | Italic font | '\it text' |
\sl | Oblique font (rarely available) | '\sl text' |
\rm | Normal font | '\rm text' |
\fontname{specifier} | Set specifier as the name of a
font family to change the font style. You can use
this markup with other modifiers. | '\fontname{Courier}
text' |
\fontsize{specifier} | Set specifier as a scalar
numeric value to change the font size. | '\fontsize{15} text' |
\color{specifier} | Set specifer as one of these
colors: red,
green,
yellow,
magenta,
blue, black,
white, gray,
darkGreen,
orange, or
lightBlue. | '\color{magenta} text' |
\color[rgb]{specifier} | Set specifier as a
three-element RGB triplet to change the font
color. | '\color[rgb]{0,0.5,0.5}
text' |
LaTeX Markup
To use LaTeX markup, set the TickLabelInterpreter
property to 'latex'. The displayed text uses the
default LaTeX font style. 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 multi-line text, the maximum size reduces by about 10 characters per line.
Data Types: char
Datasets
EdgeColor — Data line color
'k' (default) | RGB triplet vector
Data line color, specified as a character vector of color names or as an RGB triplet vector.
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 from0toF. 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' |
|
Data Types: double | char
LegendLabels — Data tables for legend annotation
character vector | cell array of character vectors
Data tables for legend annotation, specified as a character vector or as a cell array of character vectors.
Data Types: char
LegendVisible — Show legend label
1 (default) | 0
Show legend label, specified as 0 or
1.
Data Types: logical
LineStyle — Plot line style
'-' (default) | '--' | ':' | '-.' | 'none'
Plot line style, specified as one of the symbols in the table:
| Symbol | Line Style | Resulting Line |
|---|---|---|
'-' | Solid line |
|
'--' | Dashed line |
|
':' | Dotted line |
|
'-.' | Dash-dotted line |
|
'none' | No line | No line |
LineWidth — Plot line width
1 (default) | positive scalar
Plot line width, specified as a positive scalar.
Marker — Marker symbol
'none' (default) | character vector of symbols
Marker symbol, specified as 'none' or one of the
symbols in this table. By default, a line does not have markers. Add markers
at selected points along the line by specifying a marker.
| Value | Description |
|---|---|
'o' | Circle |
'+' | Plus sign |
'*' | Asterisk |
'.' | Point |
'x' | Cross |
'square' or 's' | Square |
'diamond' or 'd' | Diamond |
'^' | Upward-pointing triangle |
'v' | Downward-pointing triangle |
'>' | Right-pointing triangle |
'<' | Left-pointing triangle |
'pentagram' or 'p' | Five-pointed star (pentagram) |
'hexagram' or 'h' | Six-pointed star (hexagram) |
'none' | No markers |
MarkerSize — Marker size
6 (default) | positive value
Marker size, specified as a positive value in points.
Data Types: double
Arcs
ArcFontSizeMultiplier — Arc tick font scale factor
1 (default) | numeric value greater than zero
Arc tick font scale factor, specified as a numeric value greater than zero.
Data Types: double
ArcTickLabelColor — Arc tick labels
'k' (default) | RGB triplet vector
Arc tick labels, specified as a character vector of color names or as an RGB triplet vector.
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 from0toF. 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' |
|
Data Types: char | double
ArcTickLabelVisible — Show arc tick labels
1 (default) | 0
Show arc tick labels, specified as 0 or
1.
Data Types: logical
Circles
CircleFontSizeMultiplier — Circle tick font scale factor
0.9000 (default) | numeric value greater than zero
Circle tick font scale factor, specified as a numeric value greater than zero.
Data Types: double
CircleTickLabelColor — Circle tick label color
'k' (default) | RGB triplet vector
Circle tick labels color, specified as a character vector of color names or as an RGB triplet vector.
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 from0toF. 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' |
|
Data Types: double | char
CircleTickLabelVisible — Show circle tick labels
1 (default) | 0
Show arc tick labels, specified as 0 or
1.
Data Types: logical