Main Content

rxsite

Create RF receiver site

expand all in page

Description

Use the rxsite object to create a radio frequency receiver site.

A receiver consists of an RF circuit and an antenna, where the antenna intercepts radio waves and converts them to a current that is decoded by the RF circuit (e.g. demodulated) into a signal. Key characteristics of a receiver include its sensitivity and its antenna radiation pattern.

Creation

Syntax

rx = rxsite
rx = rxsite(coordsys)
rx = rxsite(___,Name=Value)

Description

rx = rxsite creates a radio frequency receiver site in geographic coordinates.

example

rx = rxsite(coordsys) sets the CoordinateSystem property. By default, receiver sites use a geographic coordinate system. Create a receiver site that uses a Cartesian coordinate system by specifying coordsys as "cartesian".

rx = rxsite(___,Name=Value) sets properties using one or more name-value arguments.

example

Properties

expand all

Site name, specified as a character vector, a string scalar, or a row or column vector of N elements, where N is the number of sites. Create multiple sites by specifying a row or column vector.

Example: rx.Name = "Fenway Park";

Example: rx.Name = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"];

Data Types: char | string

Coordinate system used to the reference the location of the site, specified as 'geographic' or 'cartesian'.

  • 'geographic' — Geographic coordinate system. Specify the locations of the receiver sites using the Latitude, Longitude, and AntennaHeight properties.

  • 'cartesian' — Cartesian coordinate system. Specify the locations of the receiver sites using the AntennaPosition property.

Example: rx.CoordinateSystem = "cartesian"

Latitude coordinates of the site, in degrees, specified as a numeric scalar in the range [–90, 90], or as a row or column vector of N elements in the range [–90, 90]. Create multiple sites by specifying a row or column vector.

The coordinates are referenced using the World Geodetic System of 1984 (WGS 84) reference ellipsoid.

Example: rx.Latitude = 45.098

Example: rx.Latitude = [42.3467 42.3598 42.3763];

Dependencies

To enable this property, the value of CoordinateSystem must be 'geographic'.

Longitude coordinates of the site, in degrees, specified as a numeric scalar in the range [–180, 180], or as a row or column vector of N elements in the range [–180, 180]. Create multiple sites by specifying a row or column vector.

The coordinates are referenced using the WGS 84 reference ellipsoid.

Example: rx.Longitude = -71.0972

Example: rx.Longitude = [-71.0972 -71.0545 -71.0611];

Dependencies

To enable this property, the value of CoordinateSystem must be 'geographic'.

Antenna element or array, specified as one of these options:

  • 'isotropic', which models an antenna that radiates uniformly in all directions.

  • An antenna element from the Antenna Catalog or an array element from the Array Catalog. To specify an antenna element, design the antenna element at the required receive frequency by using the design function. Then, add the antenna element to the receiver site. This option requires Antenna Toolbox™.

  • An arrayConfig (Communications Toolbox) object. This option requires Communications Toolbox™.

  • An antenna object in Antennas, Microphones, and Sonar Transducers (Phased Array System Toolbox) or an array object in Array Geometries and Analysis (Phased Array System Toolbox). This option requires Phased Array System Toolbox™.

Example: rx.Antenna = monopole

Antenna x-axis angle, in degrees, defined with reference to a local Cartesian coordinate system, specified as a numeric scalar representing an azimuth angle or as a 2-by-1 vector or a 2-by-N matrix representing both azimuth and elevation angles.

For sites with geographic coordinates, the azimuth angle is measured counterclockwise from the east along the antenna x-axis. For sites with Cartesian coordinates, the azimuth angle is measured from the global x-axis around the global z-axis. Specify the azimuth angle in the range [–180, 180].

The elevation angle is measured from the antenna x-axis along the horizontal (or xy) plane. Specify the elevation angle in the range [–90, 90].

Example: rx.AntennaAngle = 25;

Example: rx.AntennaAngle = [25 -80];

Antenna height above the ground or building surface, in meters, specified as a nonnegative numeric scalar. This value must be less than or equal to 6,371,000 m.

If the site location coincides with the building location, the antenna 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: rx.AntennaHeight = 15;

Dependencies

To enable this property, the value of CoordinateSystem must be 'geographic'.

Data Types:

Position of the antenna center, in meters, specified as a 3-by-1 vector representing x-, y-, and z-axis Cartesian coordinates.

Example: rx.AntennaPosition = [0;2;4];

Dependencies

To enable this property, the value of CoordinateSystem must be 'cartesian'.

Data Types:

System loss in dB, specified as a nonnegative scalar.

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

Example: rx.SystemLoss = 10;

Data Types:

Minimum received power to detect the signal, in dBm, specified as a numeric scalar or a row vector.

Example: rx.ReceiverSensitivity = -80;

Data Types: double

Object Functions

showShow site in Site Viewer
hideHide site from Site Viewer
distanceDistance between sites
angleAngle between sites
elevationElevation of site
locationCoordinates at distance and angle from site
sigstrengthReceived signal strength
losDisplay or compute line-of-sight (LOS) visibility status
linkDisplay or compute communication link status
patternDisplay antenna radiation pattern in Site Viewer

Examples

collapse all

Open Live Script

Create a transmitter 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)

Receiver site displayed over satellite imagery

Open Live Script

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

name = ["Fenway Park","Faneuil Hall","Bunker Hill Monument"];
lat = [42.3467 42.3598 42.3763];
lon = [-71.0972 -71.0545 -71.0611];

Specify the sensitivity of the receivers in dBm.

sens = -90;

Create an array of receiver sites in geographic coordinates that uses dipole antennas. 

rxs = rxsite(Name=name,Latitude=lat,Longitude=lon, ...
      Antenna=dipole,ReceiverSensitivity=sens);

Display the receiver sites. 

show(rxs)

Receiver sites displayed over satellite imagery

Version History

Introduced in R2017b

See Also

Objects