show

Show site in Site Viewer

Since R2019b

Syntax

show(site)

show(site,Name,Value)

Description

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

show(site,Name,Value) displays site with additional options specified by one or more name-value arguments.

Examples

Default Receiver Site

Create and show the default receiver site.

rx = rxsite

rx = 
  rxsite with properties:

                   Name: 'Site 2'
               Latitude: 42.3021
              Longitude: -71.3764
                Antenna: 'isotropic'
           AntennaAngle: 0
          AntennaHeight: 1
             SystemLoss: 0
    ReceiverSensitivity: -100

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

txsite or rxsite object | array of txsite or rxsite objects

Transmitter or receiver site, specified as a txsite or rxsite object or an array of txsite or rxsite objects.

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.

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

Example: 'ClusterMarkers',true

Icon — Image file

character vector

Image file, specified as a character vector.

Data Types: char

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 site, specified as:

• 'bottom - Aligns the icon below the site antenna position.

• 'center' - Aligns the center of the icon to the site antenna position.

• 'top' - Aligns the icon above the site antenna position.

ClusterMarkers — Combine nearby markers into groups or clusters

true | false

Combine nearby markers into groups or clusters, specified as true or false.

Data Types: char

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