Main Content

plot

Display RF propagation data in Site Viewer

所有的页面崩溃

Syntax

plot(pd)
plot(___,Name,Value)

Description

plot(pd)displays propagation data in the current Site Viewer. Each data point is displayed as a circular marker that is colored according to the corresponding value.

example

plot(___,Name,Value)displays the propagation data with additional options specified by name-value pair arguments.

Examples

全部折叠

Open Live Script

Launch Site Viewer with basemaps and building files for Manhattan. For more information about the osm file, see[1].

viewer = siteviewer("Basemap","streets_dark",..."Buildings","manhattan.osm");

Show a transmitter site on a building.

tx = txsite("Latitude",40.7107,..."Longitude",-74.0114,..."AntennaHeight",80); show(tx)

Create receiver sites along nearby streets.

latitude = [linspace(40.7088, 40.71416, 50),...linspace(40.71416, 40.715505, 25),...linspace(40.715505, 40.7133, 25),...linspace(40.7133, 40.7143, 25)]'; longitude = [linspace(-74.0108, -74.00627, 50),...linspace(-74.00627 ,-74.0092, 25),...linspace(-74.0092, -74.0110, 25),...linspace(-74.0110, -74.0132, 25)]'; rxs = rxsite("Latitude", latitude,"Longitude", longitude);

Compute signal strength at each receiver location.

signalStrength = sigstrength(rxs, tx)';

创建一个propagationDataobject to hold computed signal strength data.

tbl = table(latitude, longitude, signalStrength); pd = propagationData(tbl);

Plot the signal strength data on a map as colored points.

legendTitle ="Signal"+ newline +"Strength"+ newline +"(dB)";情节(pd,"LegendTitle", legendTitle,"Colormap", parula);

Appendix

[1] The osm file is downloaded fromhttps://www.openstreetmap.org, which provides access to crowd-sourced map data all over the world. The data is licensed under the Open Data Commons Open Database License (ODbL),https://opendatacommons.org/licenses/odbl/.

Input Arguments

全部折叠

Propagation data, specified as apropagationDataobject.

Name-Value Arguments

Specify optional comma-separated pairs ofName,Valuearguments.Nameis the argument name andValueis the corresponding value.Namemust appear inside quotes. You can specify several name and value pair arguments in any order asName1,Value1,...,NameN,ValueN.

Example:'Type','power'

Data variable to plot, 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. The default value is dynamic and corresponds to theDataVariableNameproperty of thepropagationDataobject.

Data Types:char|string

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

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

Data value levels to plot, specified as the comma-separated pair consisting of'Levels'and a numeric vector. The propagation data is binned according toLevels. The data in each bin is color coded according to the corresponding level. The colors are selected using颜色if 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

颜色of the data points, specified as the comma-separated pair consisting of'Colors'and anM-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 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 with颜色.

Data Types:double|char|string

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 with颜色.

Data Types:double

Size of data markers plotted on the map, specified as the comma-separated pair consisting of'MarkerSize'and a positive numeric scalar in pixels.

Data Types:double

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

Data Types:logical

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

See Also

|

Introduced in R2020a

[1]Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.

Antenna Toolbox Documentation

万博1manbetx

Hybrid Beamforming for Massive MIMO Phased Array Systems

Hybrid Beamforming for Massive MIMO Phased Array Systems

Download the white paper