Main Content

show

Show site in Site Viewer

Description

example

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

collapse all

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)

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)

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

collapse all

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

Image file, specified as a character vector.

Data Types: char

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

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.

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

Data Types: char

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

Data Types: char | string

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

See Also


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