# pattern

Plot antenna radiation pattern on map

## Syntax

``pattern(tx)``
``pattern(rx,frequency)``
``pattern(___,Name,Value)``

## Description

example

````pattern(tx)` plots the 3-D antenna radiation pattern for the transmitter site, `txsite`. Signal gain value (dBi) in a particular direction determines the color of the pattern. NoteThis function only supports antenna sites with `CoordinateSystem` property set to `'geographic'`. ```

example

````pattern(rx,frequency)` plots the 3-D radiation pattern for the receiver site, `rxsite` for the specified `frequency`.```

example

````pattern(___,Name,Value)` plots the 3-D radiation pattern with additional options specified by name-value pair arguments.```

## Examples

collapse all

Define and visualize the radiation pattern of a single transmitter site.

```tx = txsite; pattern(tx)```

Design a receiver site using a dipole antenna at a height of 30 meters.

``` d = dipole; rx= rxsite('Name','Mathworks Lakeside','Latitude',42.30321,'Longitude',-71.3764,... 'Antenna',d,'AntennaHeight',30)```
```rx = rxsite with properties: Name: 'Mathworks Lakeside' Latitude: 42.3032 Longitude: -71.3764 Antenna: [1×1 dipole] AntennaAngle: 0 AntennaHeight: 30 SystemLoss: 0 ReceiverSensitivity: -100 ```
` show(rx)`

Visualize the pattern of the receiver site at 75 MHz.

`pattern(rx,75e6)`

Create directional antenna.

```yagiAntenna = design(yagiUda,4.5e9); yagiAntenna.Tilt = 90; yagiAntenna.TiltAxis = 'y';```

Create transmitter and receiver sites at a frequency of 4.5 GHz. Use the Yagi antenna as the transmitter antenna. Design a dipole at 4.5 GHz and use this as the receiver antenna.

```fq = 4.5e9; tx = txsite('Name','MathWorks','Latitude',42.3001,'Longitude', -71.3503, ... 'Antenna', yagiAntenna,'AntennaAngle', 90,'AntennaHeight', 30, ... 'TransmitterFrequency', fq,'TransmitterPower', 10); rx = rxsite('Antenna',design(dipole, fq)); ```

Position the receiver 200 meters from the transmitter.

``` [lat,lon] = location(tx,200,90); rx.Latitude = lat; rx.Longitude = lon;```

Display both transmitter and receiver patterns.

```pattern(tx,'Transparency',0.2); pattern(rx, fq);```

## Input Arguments

collapse all

Transmitter site, specified as a `txsite` object.

Receiver site, specified as a `rxsite` object.

Frequency to calculate radiation pattern, specified as a positive scalar.

### Name-Value Pair Arguments

Specify optional comma-separated pairs of `Name,Value` arguments. `Name` is the argument name and `Value` is the corresponding value. `Name` must appear inside quotes. You can specify several name and value pair arguments in any order as `Name1,Value1,...,NameN,ValueN`.

Example: `'Size',2`

Size of the pattern plot, specified as the comma-separated pair consisting of `'Size'` and a numerical scalar in meters. This parameter represents the distance between the antenna position and the point on the plot with the highest gain.

Data Types: `double`

Transparency of the pattern plot, specified as the comma-separated pair consisting of `'Transparency'` and a real number in the range of [0,1], where `0` is completely transparent and `1` is completely opaque.

Data Types: `double`

Colormap for coloring of the pattern plot, specified as the comma-separated pair consisting of `'Colormap'` and predefined colormap name or an M-by-3 array of RGB (red, blue, green) triplets that define M individual colors.

Data Types: `double`

Resolution of 3-D map, specified as the comma-separated pair consisting of `'Resolution'` and `'low'`, `'medium'`, or `'high'`. This property controls the visual quality and the time taken to plot the pattern where the value of `'low'` corresponds to the fastest and the least detailed pattern.

Data Types: `double`

Map for visualization of surface data, specified as the comma-separated pair consisting of `'Map'` and a `siteviewer` object.[1]

Data Types: `char` | `string`