contour

Display contour map of RF propagation data in Site Viewer

Syntax

contour(pd)

contour(___,Name,Value)

Description

contour(pd)creates a filled contour plot in the current Site Viewer. Contours are colored according to data values of corresponding locations.

example

contour(___,Name,Value)creates a filled contour map with additional options specified by name-value pair arguments.

Examples

collapse all

Capacity Map Using SINR Data

Open Live Script

Define names and locations of sites around Boston.

names = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"]; lats = [42.3467,42.3598,42.3763]; lons = [-71.0972,-71.0545,-71.0611];

Create an array of transmitter sites.

txs = txsite("Name",names,..."Latitude",lats,..."Longitude",lons,..."TransmitterFrequency",2.5e9); show(txs)

Create a signal-to-interference-plus-noise-ratio (SINR) map, where signal source for each location is selected as the transmitter site with the strongest signal.

sv1 = siteviewer("Name","SINR map"); sinr(txs,"MaxRange",5000)

Return SINR propagation data.

pd = sinr(txs,"MaxRange",5000); [sinrDb,lats,lons] = getDataVariable(pd,"SINR");

Compute capacity using the Shannon-Hartley theorem.

bw = 1e6;% Bandwidth is 1 MHzsinrRatio = 10.^(sinrDb./10);% Convert from dB to power ratiocapacity = bw*log2(1+sinrRatio)/1e6;% Unit: Mbps

Create new propagation data for the capacity map and display the contour plot.

pdCapacity = propagationData(lats,lons,"Capacity",capacity); sv2 = siteviewer("Name","Capacity map"); legendTitle ="Capacity"+ newline +"(Mbps)"; contour(pdCapacity,"LegendTitle",legendTitle);

Input Arguments

collapse all

`pd`—Propagation data
`propagationData`object(default)

Propagation data, specified as apropagationDataobject.

Name-Value Arguments

Specify optional comma-separated pairs ofName,Valuearguments.Nameis the argument name andValueis the corresponding value.Name必须出现在引号。您可以指定数name and value pair arguments in any order asName1,Value1,...,NameN,ValueN.

Example:'Type','power'

`DataVariableName`—Data variable to contour map
`DataVariableName`(default) |character vector|string scalar

Data variable to contour map, specified as the comma-separated pair consisting of'DataVariableName'and a character vector or a string scalar corresponding to a variable name in the data table used to create the propagation data container objectpd.

Data Types:char|string

`Type`—Type of value to plot
`'custom'`(default) |`'power'`|`'efield'`|`'sinr'`|`'pathloss'`

Type of value to plot, specified as the comma-separated pair consisting of'Type'and one of the values in the'Type'column:

Type	ColorLimits	LegendTitle
`'custom'`	`[min(Data) max(Data)]`	`''`
`'power'`	`[-120 -5]`	`'Power (dBm)'`
`'efield'`	`[20 135]`	`'E-field (dBuV/m)'`
`'sinr'`	`[-5 20]`	`'SINR (dB)'`
`'pathloss'`	`[45 160]`	`'Path loss (dB)'`

The default value forLevelsis a linearly spaced vector bounded byColorLimits.

Data Types:char|string

`Levels`—Data value levels to plot
numeric vector

Data value levels to plot, specified as the comma-separated pair consisting of'Levels'and numeric vector. Each level is displayed as a different colored, filled contour on the map. The colors are selected usingColorsif specified, or elseColormapandColorLimits. Data points with values below the minimum level are not included in the plot.

The default value forLevelsis a linearly spaced vector bounded byColorLimits.

Data Types:double

`Colors`—Colors of data points
M-by-3 array of RGB|array of strings|cell array of character vectors

Colors of the filled contours, specified as the comma-separated pair consisting of'Colors'and an M-by-3 array of RGB (red, blue, green) or an array of strings, or a cell array of character vectors. Colors are assigned element-wise to values inLevelsfor coloring the corresponding points. Colors cannot be used withColormapandColorLimits.

Data Types:double|char|string

`Colormap`—Color map for coloring points
`'jet(256)'`(default) |predefined colormap name|M-by-3 array of RGB triplets

Colormap for the coloring points, specified as the comma-separated pair consisting of'Colormap'and a predefined colormap name or anM-by-3 array of RGB (red, blue, green) triplets that defineMindividual colors.Colormapcannot be used withColors.

Data Types:double|char|string

`ColorLimits`—Color limits for color map
two-element vector

Color limits for the colormap, specified as the comma-separated pair consisting of'ColorLimits'and a two-element vector of the form [min max]. The color limits indicate the data level values that map to the first and last colors in the colormap.ColorLimitscannot be used withColors.

Data Types:double

`Transparency`—Transparency of contour map
`0.4`(default) |numeric scalar in the range of [0,1]

Transparency of the contour plot, specified as a numeric scalar in the range [0,1], where0is completely transparent and1is completely opaque.

Data Types:double

`ShowLegend`—Show color legend on map
`true`(default) |`false`

Show color legend on map, specified as the comma-separated pair consisting of'ShowLegend'andtrueorfalse.

Data Types:logical

`LegendTitle`—Title of color legend
character vector|string scalar

Title of color legend, specified as the comma-separated pair consisting of'LegendTitle'and a character vector or a string scalar.

Data Types:string|char

`Map`—Map for surface data
`siteviewer`object

Map for surface data, specified as the comma-separated pair consisting of'Map'and asiteviewerobject.^[1]The default value is the current Site Viewer or a new Site Viewer, if none is open.

Data Types:char|string

contour

Syntax

Description

Examples

Capacity Map Using SINR Data

Input Arguments

`pd`—Propagation data
`propagationData`object(default)

Name-Value Arguments

`DataVariableName`—Data variable to contour map
`DataVariableName`(default) |character vector|string scalar

`Type`—Type of value to plot
`'custom'`(default) |`'power'`|`'efield'`|`'sinr'`|`'pathloss'`

`Levels`—Data value levels to plot
numeric vector

`Colors`—Colors of data points
M-by-3 array of RGB|array of strings|cell array of character vectors

`Colormap`—Color map for coloring points
`'jet(256)'`(default) |predefined colormap name|M-by-3 array of RGB triplets

`ColorLimits`—Color limits for color map
two-element vector

`Transparency`—Transparency of contour map
`0.4`(default) |numeric scalar in the range of [0,1]

`ShowLegend`—Show color legend on map
`true`(default) |`false`

`LegendTitle`—Title of color legend
character vector|string scalar

`Map`—Map for surface data
`siteviewer`object

See Also

Antenna Toolbox Documentation

金宝app

Hybrid Beamforming for Massive MIMO Phased Array Systems

contour

Syntax

Description

Examples

Capacity Map Using SINR Data

Input Arguments

pd—Propagation datapropagationDataobject(default)

Name-Value Arguments

DataVariableName—Data variable to contour mapDataVariableName(default) |character vector|string scalar

Type—Type of value to plot'custom'(default) |'power'|'efield'|'sinr'|'pathloss'

Levels—Data value levels to plotnumeric vector

Colors—Colors of data pointsM-by-3 array of RGB|array of strings|cell array of character vectors

Colormap—Color map for coloring points'jet(256)'(default) |predefined colormap name|M-by-3 array of RGB triplets

ColorLimits—Color limits for color maptwo-element vector

Transparency—Transparency of contour map0.4(default) |numeric scalar in the range of [0,1]

ShowLegend—Show color legend on maptrue(default) |false

LegendTitle—Title of color legendcharacter vector|string scalar

Map—Map for surface datasiteviewerobject

See Also

Antenna Toolbox Documentation

金宝app

Hybrid Beamforming for Massive MIMO Phased Array Systems

`pd`—Propagation data
`propagationData`object(default)

`DataVariableName`—Data variable to contour map
`DataVariableName`(default) |character vector|string scalar

`Type`—Type of value to plot
`'custom'`(default) |`'power'`|`'efield'`|`'sinr'`|`'pathloss'`

`Levels`—Data value levels to plot
numeric vector

`Colors`—Colors of data points
M-by-3 array of RGB|array of strings|cell array of character vectors

`Colormap`—Color map for coloring points
`'jet(256)'`(default) |predefined colormap name|M-by-3 array of RGB triplets

`ColorLimits`—Color limits for color map
two-element vector

`Transparency`—Transparency of contour map
`0.4`(default) |numeric scalar in the range of [0,1]

`ShowLegend`—Show color legend on map
`true`(default) |`false`

`LegendTitle`—Title of color legend
character vector|string scalar

`Map`—Map for surface data
`siteviewer`object