PolarPattern Properties

Control appearance and behavior of polar plot

Polar pattern properties control the appearance and behavior of the polar pattern object. By changing property values, you can modify certain aspects of the polar plot. To change the default properties use:

p = polarpattern(____,Name,Value)

To view all the properties of the polar pattern object use:

details(p)

You can also interact with the polar plot to change the properties. For more information, see Interact with Polar Plot.

Antenna Metrics

'AntennaMetrics' — Show antenna metric

0 (default) | 1

Show antenna metrics, specified as a comma-separated pair consisting of 'AntennaMetrics' and 0 or 1. Antenna metric displays main, back, and side lobes of antenna/array pattern passed as input.

Data Types: logical

'Peaks' — Maximum number of peaks to compute for each data set

positive integer | vector of integers

Maximum number of peaks to compute for each data set, specified as a comma-separated pair consisting of 'Peaks' and a positive scalar or vector of integers.

Data Types: double

Angle Properties

'AngleAtTop' — Angle at top of polar plot

90 (default) | scalar in degrees

Angle at the top of the polar plot, specified as a comma-separated pair consisting of 'AngleAtTop' and a scalar in degrees.

Data Types: double

'AngleLim' — Visible polar angle span

[0 360] (default) | 1-by-2 vector of real values

Visible polar angle span, specified as a comma-separated pair consisting of 'AngleLim' and a 1-by-2 vector of real values.

Data Types: double

'AngleLimVisible' — Show interactive angle limit cursors

0 (default) | 1

Show interactive angle limit cursors, specified as a comma-separated pair consisting of 'AngleLimVisible' and 0 or 1.

Data Types: logical

'AngleDirection' — Direction of increasing angle

'ccw' (default) | 'cw'

Direction of increasing angle, specified as a comma-separated pair consisting of 'AngleDirection' and 'ccw' (counterclockwise) or 'cw' (clockwise).

Data Types: char

'AngleResolution' — Number of degrees between radial lines

15 (default) | scalar in degrees

Number of degrees between radial lines depicting angles in the polar plot, specified as a comma-separated pair consisting of 'AngleResolution' and a scalar in degrees.

Data Types: double

'AngleTickLabelRotation' — Rotate angle tick labels

0 (default) | 1

Rotate angle tick labels, specified as a comma-separated pair consisting of 'AngleTickLabelRotation' and 0 or 1.

Data Types: logical

'AngleTickLabelVisible' — Show angle tick labels

1 (default) | 0

Show angle tick labels, specified as a comma-separated pair consisting of 'AngleTickLabelVisible' and 0 or 1.

Data Types: logical

'AngleTickLabelFormat' — Format for angle tick labels

360 (default) | 180

Format for angle tick labels, specified as a comma-separated pair consisting of 'AngleTickLabelFormat' and 360 degrees or 180 degrees.

Data Types: double

'AngleFontSizeMultiplier' — Scale factor of angle tick font

1 (default) | numeric value greater than zero

Scale factor of angle tick font, specified as a comma-separated pair consisting of 'AngleFontSizeMultiplier' and a numeric value greater than zero.

Data Types: double

'Span' — Show angle span measurement

0 (default) | 1

Show angle span measurement, specified as a comma-separated pair consisting of 'Span' and 0 or 1.

Data Types: logical

'ZeroAngleLine' — Highlight radial line at zero degrees

0 (default) | 1

Highlight radial line at zero degrees, specified as a comma-separated pair consisting of 'ZeroAngleLine' and 0 or 1.

Data Types: logical

'DisconnectAngleGaps' — Show gaps in line plots with nonuniform angle spacing

1 (default) | 0

Show gaps in line plots with nonuniform angle spacing, specified as a comma-separated pair consisting of 'DisconnectAngleGaps' and 0 or 1.

Data Types: logical

Magnitude Properties

'MagnitudeAxisAngle' — Angle of magnitude tick label radial line

75 (default) | real scalar in degrees

Angle of magnitude tick label radial line, specified as a comma-separated pair consisting of 'MagnitudeAxisAngle' and real scalar in degrees.

Data Types: double

'MagnitudeTick' — Magnitude ticks

[0 0.2 0.4 0.6 0.8] (default) | 1-by-N vector

Magnitude ticks, specified as a comma-separated pair consisting of 'MagnitudeTick' and a 1-by-N vector, where N is the number of magnitude ticks.

Data Types: double

'MagnitudeTickLabelVisible' — Show magnitude tick labels

1 (default) | 0

Show magnitude tick labels, specified as a comma-separated pair consisting of 'MagnitudeTickLabelVisible' and 0 or 1.

Data Types: logical

'MagnitudeLim' — Minimum and maximum magnitude limits

[0 1] (default) | two-element vector of real values

Minimum and maximum magnitude limits, specified as a comma-separated pair consisting of 'MagnitudeLim' and a two-element vector of real values.

Data Types: double

'MagnitudeLimMode' — Determine magnitude dynamic range

'auto' (default) | 'manual'

Determine magnitude dynamic range, specified as a comma-separated pair consisting of 'MagnitudeLimMode' and 'auto' or 'manual'.

Data Types: char

'MagnitudeAxisAngleMode' — Determine angle for magnitude tick labels

'auto' (default) | 'manual'

Determine angle for magnitude tick labels, specified as a comma-separated pair consisting of 'MagnitudeAxisAngleMode' and 'auto' or 'manual'.

Data Types: char

'MagnitudeTickMode' — Determine magnitude tick locations

'auto' (default) | 'manual'

Determine magnitude tick locations, specified as a comma-separated pair consisting of 'MagnitudeTickMode' and 'auto' or 'manual'.

Data Types: char

'MagnitudeUnits' — Magnitude units

'dB' | 'dBLoss'

Magnitude units, specified as a comma-separated pair consisting of 'MagnitudeUnits' and 'db' or 'dBLoss'.

Data Types: char

'MagnitudeFontSizeMultiplier' — Scale factor of magnitude tick font

0.9000 (default) | numeric value greater than zero

Scale factor of magnitude tick font, specified as a comma-separated pair consisting of 'MagnitudeFontSizeMultiplier' and a numeric value greater than zero.

Data Types: double

Miscellaneous Properties

'View' — View section of Smith plot

'full' (default) | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | string scalar | character vector

View section of Smith plot, specified as a string scalar or character vector. Smith plot can be viewed by setting View property to one of property values in this table.

View Property Effect

Property Value	Effect
'full'	Full Smith plot is viewed.
'top'	Top-half of the Smith plot is viewed.
'bottom'	Bottom-half of the Smith plot is viewed.
'left'	Left-half of the Smith plot is viewed.
'right'	Right-half of the Smith plot is viewed.
'top-left'	Top-left of the Smith plot is viewed.
'top-right'	Top-right of the Smith plot is viewed.
'bottom-left'	Bottom-left of the Smith plot is viewed.
'bottom-right'	Bottom-right of the Smith plot is viewed.

Data Types: char | string

'NormalizeData' — Normalize each data trace to maximum value

0 (default) | 1

Normalize each data trace to maximum value, specified as a comma-separated pair consisting of 'NormalizeData' and 0 or 1.

Data Types: logical

'ConnectEndpoints' — Connect first and last angles

0 (default) | 1

Connect first and last angles, specified as a comma-separated pair consisting of 'ConnectEndpoints' and 0 or 1.

Data Types: logical

'Style' — Style of polar plot display

'line' (default) | 'filled'

Style of polar plot display, specified as a comma-separated pair consisting of 'Style' and 'line' or 'filled'.

Data Types: char

'TemporaryCursor' — Create temporary cursor

0 (default) | 1

Create a temporary cursor, specified as a comma-separated pair consisting of 'TemporaryCursor' and 0 or 1.

Data Types: logical

'ToolTips' — Show tool tips

1 (default) | 0

Show tool tips when you hover over a polar plot element, specified as a comma-separated pair consisting of 'ToolTips' and 0 or 1.

Data Types: logical

'ClipData' — Clip data to outer circle

0 (default) | 1

Clip data to outer circle, specified as a comma-separated pair consisting of 'ClipData' and 0 or 1.

Data Types: logical

'CleanData' — Cleans data

0 (default) | 1

Cleans data removing any Inf or NaN from the data. The property is specified as a comma-separated pair consisting of 'CleanData' and 0 or 1.

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.

Legend and Title Properties

'LegendLabels' — Data tables for legend annotation

character vector | cell array of character vectors

Data tables for legend annotation, specified as a comma-separated pair consisting of 'LegendLabels' and a character vector or cell array of character vectors. Ⓐ denotes the active line for interactive operation.

Data Types: char

'LegendVisible' — Show legend label

0 (default) | 1

Show legend label, specified as a comma-separated pair consisting of 'LegendVisible' and 0 or 1.

Data Types: logical

'TitleTop' — Title to display above the polar plot

character vector

Title to display above the polar plot, specified as a comma-separated pair consisting of 'TitleTop' and a character vector.

Data Types: char

'TitleBottom' — Title to display below the polar plot

character vector

Title to display below the polar plot, specified as a comma-separated pair consisting of 'TitleBottom' and a character vector.

Data Types: char

'TitleTopOffset' — Offset between top title and angle ticks

0.1500 (default) | scalar

Offset between top title and angle ticks, specified as a comma-separated pair consisting of 'TitleTopOffset' and a scalar. The value must be in the range [-0.5,0.5].

Data Types: double

'TitleBottomOffset' — Offset between bottom title and angle ticks

0.1500 (default) | scalar

Offset between bottom title and angle ticks, specified as a comma-separated pair consisting of 'TitleBottomOffset' and a scalar. The value must be in the range [-0.5,0.5].

Data Types: double

'TitleTopFontSizeMultiplier' — Scale factor of top title font

1.1000 (default) | numeric value greater than zero

Scale factor of top title font, specified as a comma-separated pair consisting of 'TitleTopFontSizeMultiplier' and a numeric value greater than zero.

Data Types: double

'TitleBottomFontSizeMultiplier' — Scale factor of bottom title font

0.9000 (default) | numeric value greater than zero

Scale factor of bottom title font, specified as a comma-separated pair consisting of 'TitleBottomFontSizeMultiplier' and a numeric value greater than zero.

Data Types: double

'TitleTopFontWeight' — Thickness of top title font

'bold' (default) | 'normal'

Thickness of top title font, specified as a comma-separated pair consisting of 'TitleTopFontWeight' and 'bold' or 'normal.

Data Types: char

'TitleBottomFontWeight' — Thickness of bottom title font

'normal' (default) | 'bold'

Thickness of bottom title font, specified as a comma-separated pair consisting of 'TitleBottomFontWeight' and 'bold' or 'normal.

Data Types: char

'TitleTopTextInterpreter' — Interpretation of top title characters

'none' (default) | 'tex' | 'latex'

Interpretation of top title characters, specified as a comma-separated pair consisting of 'TitleTopTextInterpreter' and:

• '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 text within 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 modifier 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. 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 reduces by about 10 characters per line.

Data Types: char

'TitleBottomTextInterpreter' — Interpretation of bottom title characters

'none' (default) | 'tex' | 'latex'

Interpretation of bottom title characters, specified as a comma-separated pair consisting of 'TitleBottomTextInterpreter' and:

• '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 modifier 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. 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 reduces by about 10 characters per line.

Data Types: char

Grid Properties

'GridOverData' — Draw grid over data plots

0 (default) | 1

Draw grid over data plots, specified as a comma-separated pair consisting of 'GridOverData' and 0 or 1.

Data Types: logical

'DrawGridToOrigin' — Draw radial lines within innermost circle

0 (default) | 1

Draw radial lines within innermost circle of the polar plot, specified as a comma-separated pair consisting of 'DrawGridToOrigin' and 0 or 1.

Data Types: logical

'GridAutoRefinement' — Increase angle resolution

0 (default) | 1

Increase angle resolution in the polar plot, specified as a comma-separated pair consisting of 'GridAutoRefinement' and 0 or 1. This property increases angle resolution by doubling the number of radial lines outside each magnitude.

Data Types: logical

'GridWidth' — Width of grid lines

0.5000 (default) | positive scalar

Width of grid lines, specified as a comma-separated pair consisting of 'GridWidth' and a positive scalar.

Data Types: double

'GridVisible' — Show grid lines

1 (default) | 0

Show grid lines, including magnitude circles and angle radii, specified as a comma-separated pair consisting of 'GridVisible' and 0 or 1.

Data Types: logical

'GridForegroundColor' — Color of foreground grid lines

[0.8000 0.8000 0.8000] (default) | 'none' | character vector of color names

Color of foreground grid lines, specified as a comma-separated pair consisting of 'GridForegroundColor' and 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"

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

'GridBackGroundColor' — Color of background grid lines

'w' (default) | character vector of color names | 'none'

Color of background grid lines, specified as a comma-separated pair consisting of 'GridBackGroundColor' and 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"

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

Marker, Color, Line, and Font Properties

'Marker' — Marker symbol

'none' (default) | character vector of symbols

Marker symbol, specified as a comma-separated pair consisting of 'Marker' and either '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 comma-separated pair consisting of 'MarkerSize' and a positive value in point units.

Data Types: double

'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 a comma-separated pair consisting of 'ColorOrder' and a 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 comma-separated pair consisting of 'ColorOrderIndex' and a positive integer. New plots added to the axes use colors based on the current value of the color order index.

Data Types: double

'EdgeColor' — Color of data lines

'k' (default) | RGB triplet vector

Color of data lines, specified as a comma-separated pair consisting of 'EdgeColor' and a character vector of color names or 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"

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

'LineStyle' — Line style of the plot

'-' (default) | '--' | ':' | '-.' | 'none'

Line style of the plot, specified as a comma-separated pair consisting of 'LineStyle' and 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' — Line width of plot

1 (default) | positive scalar | positive vector

Line width of the plot, specified as a comma-separated pair consisting of 'LineWidth' and a positive scalar or vector.

'FontSize' — Font size of text in plot

10 (default) | positive scalar

Font size of text in the plot, specified as a comma-separated pair consisting of 'FontSize' and a positive scalar.

'FontSizeAutoMode' — Set font size

'auto' (default) | 'manual'

Set font size, specified as a comma-separated pair consisting of 'FontSizeAutoMode' and 'auto' or 'manual'.

Data Types: char