txsite

Create radio frequency transmitter site

Description

Use txsite object to create a radio frequency transmitter site.

Creation

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 or 'isotropic'. By default, the antenna is 'isotropic', which defines an antenna that radiates uniformly in all directions.

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 x-axis.

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

Example: 'AntennaAngle',25

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

Antenna height from the ground or building surface, specified as a non-negative numeric scalar in meters. Maximum value for this property is 6,371,000 m.

If the site coincides with the building, the height is measured from the top of the building to the center of the antenna. Otherwise,the height is measured from ground elevation to the center of the antenna.

Example: 'AntennaHeight',25

Example: TX.AntennaHeight = 15

Data Types:

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
elevationElevation of site
locationLocation coordinates at a given distance and angle from site
losPlot or compute the line-of-sight (LOS) visibility between sites on a map
coverageDisplay coverage map
sinrDisplay signal-to-interference-plus-noise ratio (SINR) map
patternPlot antenna radiation pattern on map

Examples

collapse 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)
tx = 
  txsite with properties:

                    Name: 'MathWorks Apple Hill'
                Latitude: 42.3001
               Longitude: -71.3504
                 Antenna: 'isotropic'
            AntennaAngle: 0
           AntennaHeight: 10
              SystemLoss: 0
    TransmitterFrequency: 1.9000e+09
        TransmitterPower: 10

show(tx)

View the coverage of the antenna.

pattern(tx)

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

tx = txsite('Name','MathWorks Apple Hill','Antenna',dipole,'Latitude',42.3001,...
    'Longitude',-71.3504)
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

show(tx);

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 using a dipole antenna.

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

See Also

|

Introduced in R2017b