show

Show site in Site Viewer

Syntax

show(site)

show(site,Name=Value)

Description

show(site) displays the location of the specified transmitter or receiver site in the current Site Viewer using a marker.

show(site,Name=Value) specifies options using one or more name-value arguments.

Examples

Create Receiver Site in Geographic Coordinates

Create a receiver site. By default, receiver sites use geographic coordinates. Specify the latitude as 42.3001 degrees and the longitude as -71.3504 degrees.

rx = rxsite(Name="MathWorks Apple Hill", ...
    Latitude=42.3001,Longitude=-71.3504);

Display the receiver site.

show(rx)

Show and Hide Transmitter Site

Create and show a transmitter site.

tx = txsite('Name','MathWorks Apple Hill',...
       'Latitude',42.3001, ...
       'Longitude',-71.3504);
show(tx)

Hide the transmitter site.

hide(tx)

Show and Hide Sites with Cartesian Coordinates

Import and view an STL file. The file models a small conference room with one table and four chairs.

viewer = siteviewer('SceneModel','conferenceroom.stl');

Create a transmitter site near the upper corner of the room and a receiver site above the table. Specify the position using Cartesian coordinates in meters. Then, visualize the sites.

tx = txsite('cartesian', ...
    'AntennaPosition',[-1.46; -1.42; 2.1]);
rx = rxsite('cartesian', ...
    'AntennaPosition',[0.3; 0.3; 0.85]);

show(tx)
show(rx)

Pan by left-clicking, zoom by right-clicking or by using the scroll wheel, and rotate the visualization by clicking the middle button and dragging or by pressing Ctrl and left-clicking and dragging.

Hide the sites.

hide(tx)
hide(rx)

Input Arguments

site — Transmitter or receiver site

array of txsite objects | array of rxsite objects

Transmitter or receiver site, specified as an array of txsite objects or an array of rxsite objects. You can also specify a scalar txsite or rxsite object.

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: show(site,ClusterMarkers=true) combines nearby markers into groups.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: show(site,"ClusterMarkers",true) combines nearby markers into groups.

Icon — Name of image file

string scalar | character vector

Name of the image file, specified as a string scalar or character vector.

Data Types: char | string

IconSize — Width and height of icon

36-by-36 (default) | 1-by-2 vector of positive numeric values

Width and height of the icon, specified as a 1-by-2 vector of positive numeric values in pixels.

IconAlignment — Vertical position of icon relative to site

"top" (default) | "center" | "bottom"

Vertical position of icon relative to the site, specified as on of this options:

• "bottom" — Align the icon below the antenna position of the site.

• "center" — Align the center of the icon with the antenna position of the site.

• "top" — Align the icon above the antenna position of the site.

ClusterMarkers — Option to combine nearby markers into groups or clusters

true or 1 | false or 0

Option to combine nearby markers into groups or clusters, specified as numeric or logical 1 (true) or 0 (false).

Data Types: logical

Map — Map for visualization of surface data

siteviewer object

Map for visualization of surface data, specified as a siteviewer object.¹

Data Types: char | string

ShowAntennaHeight — Option to show line from site to surface

true or 1 (default) | false or 0

Option to show a white line from the site down to the nearest surface, specified as numeric or logical 1 (true) or 0 (false).

Data Types: logical

Version History

Introduced in R2019b