Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

txsite

Create radio frequency transmitter site

Description

Use txsite object to create a radio frequency transmitter site.

Creation

Syntax

tx = txsite
tx = txsite(Name,Value)

Description

example

tx = txsite creates a radio frequency transmitter site.

example

tx = txsite(Name,Value) sets properties using one or more name-value pairs. For example, tx = txsite('Name','TX Site') creates a transmitter site with name TX Site. Enclose each property name in quotes.

Properties

expand all

Site name, specified as a character vector or string, or row or column vector of N elements.

Example: 'Name','Site 2'

Example: TX.Name = 'Fenway Park'

Example: If you want to assign multiple values then - names = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"]; TX = txsite('Name',names)

Data Types: char | string

Site latitude coordinates, specified as a numeric scalar in the range of -90 to 90, or as a row or column vector of N elements. Coordinates are defined using Earth ellipsoid model WGS-84. Latitude is the north/south angle.

Example: 'Latitude',45.098

Example: TX.Latitude = 45.098

Example: If you want to assign multiple values then - latitude = [42.3467,42.3598,42.3763]; TX = txsite('Latitude',latitude)

Site longitude coordinates, specified as a numeric scalar or as a row or column vector of N elements. Coordinates are defined using Earth ellipsoid model WGS-84. Longitude is the east/west angle.

Example: 'Longitude',-68.890

Example: TX.Longitude = -71.0972

Example: If you want to assign multiple values then - longitude = [-71.0972,-71.0545,-71.0611]; TX = txsite('Longitude',longitude)

Antenna element or array specified as an object. By default, the antenna is a dipole designed for 1.9 GHz.

Example: 'Antenna',monopole

Example: TX.Antenna = monopole

Antenna x-axis angle, specified as a numeric scalar or a 2-by-1 vector or a 2-by-N matrix in degrees.

The azimuth angle measured counterclockwise from the east to the antenna's x-axis.

The elevation angle measures from the horizontal plane to antenna's x-axis from -90 to 90 degrees.

Example: 'AntennaAngle',25

Example: TX.AntennaAngle = [25,-80]

Antenna height from the ground elevation at the site to the center of the antenna element, specified as a nonnegative numeric scalar in meters.

Example: 'AntennaHeight',25

Example: TX.AntennaHeight = 15

System loss, specified as a non-negative numeric scalar in dB.

System loss includes transmission line loss and any other miscellaneous system losses.

Example: 'SystemLoss',10

Example: txsite.SystemLoss = 10

Data Types:

Transmitter operating frequency, specified as a numeric scalar in Hz. The range is from 1e3 to 200e9.

Example: 'TransmitterFrequency',30e9

Example: txsite.TransmitterFrequency = 30e9

Data Types: double

Signal power at transmitter output, specified as a positive numeric scalar in watts. The transmitter out is connected to the antenna.

Example: 'TransmitterPower',30

Example: txsite.TransmitterPower = 30

Data Types: double

Object Functions

showShow site location on map
hideHide site location on map
distanceDistance between sites
angleAngle between sites
coverageDisplay coverage map

Examples

expand all

Create and view a transmitter site at a latitude of 42.3001 and a longitude of -71.3504.

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

  txsite with properties:

                    Name: 'MathWorks Apple Hill'
                Latitude: 42.3001
               Longitude: -71.3504
                 Antenna: [1×1 dipole]
            AntennaAngle: 0
           AntennaHeight: 10
              SystemLoss: 0
    TransmitterFrequency: 1.9000e+09
        TransmitterPower: 10

Specify the names, latitudes, and longitudes of three transmitter locations.

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

Define the frequency of the transmitters.

fq = 2.5e9;

Create and view the transmitter array.

txs = txsite('Name', names,...
'Latitude',lats,...
'Longitude',lons, ...
'TransmitterFrequency',fq);
show(txs)

See Also

Introduced in R2017b

Was this topic helpful?