SmithPlot Properties

Control appearance and behavior of Smith chart

Smith chart properties control the appearance and behavior of the smithplot object. By changing property values, you can modify certain aspects of the Smith chart.

To change the default properties use name-value arguments. For example, s = smithplot(____,Name=Value) and to view all the properties of the Smith plot object use, details(s) function, where s is the Smith chart variable.

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.

For more information, see ColorOrder in the Axes Properties.

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.

For more information, see ColorOrderIndex in the Axes Properties.

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 root FixedWidthFontName property.

• The listfonts function 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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

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) | 'replacechildren' | '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
'replace'	Removes all axes objects and resets figure properties to their defaults before adding new graphics objects.
'replacechildren'	Removes all prior plot but preserves all axes settings.
'add'	Adds new graphics objects without clearing or resetting the current figure.

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

View — View section of Smith plot

'full' (default) | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right'

View the full Smith plot or a section of the plot by selecting one of the values in this table.

Value	View
'full'	Full Smith plot
'top'	Top half of the Smith plot
'bottom'	Bottom half of the Smith plot
'left'	Left half of the Smith plot
'right'	Right half of the Smith plot
'top-left'	Top left of the Smith plot
'top-right'	Top right of the Smith plot
'bottom-left'	Bottom left of the Smith plot
'bottom-right'	Bottom right of the Smith plot

Example: s.View = 'top-left'

Data Types: char | string

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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

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 | vector

Plot line width, specified as a positive scalar or vector.

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.

Marker	Description	Resulting Marker
"o"	Circle
"+"	Plus sign
"*"	Asterisk
"."	Point
"x"	Cross
"_"	Horizontal line
"|"	Vertical line
"square"	Square
"diamond"	Diamond
"^"	Upward-pointing triangle
"v"	Downward-pointing triangle
">"	Right-pointing triangle
"<"	Left-pointing triangle
"pentagram"	Pentagram
"hexagram"	Hexagram
"none"	No markers	Not applicable

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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

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 from 0 to F. 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"

This table lists the default color palettes for plots in the light and dark themes.

Palette	Palette Colors
"gem" — Light theme default Before R2025a: Most plots use these colors by default.
"glow" — Dark theme default

You can get the RGB triplets and hexadecimal color codes for these palettes using the orderedcolors and rgb2hex functions. For example, get the RGB triplets for the "gem" palette and convert them to hexadecimal color codes.

RGB = orderedcolors("gem");
H = rgb2hex(RGB);

Before R2023b: Get the RGB triplets using RGB = get(groot,"FactoryAxesColorOrder").

Before R2024a: Get the hexadecimal color codes using H = compose("#%02X%02X%02X",round(RGB*255)).

Data Types: double | char

CircleTickLabelVisible — Show circle tick labels

1 (default) | 0

Show arc tick labels, specified as 0 or 1.

Data Types: logical