# patternMultiply

Radiation pattern of array using pattern multiplication

## Syntax

``patternMultiply(array,frequency)``
``patternMultiply(array,frequency,azimuth)``
``patternMultiply(array,frequency,azimuth, elevation)``
``patternMultiply(___,Name=Value)``
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency)``````
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth)``````
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth,elevation)``````
``````[fieldval,azimuth,elevation] = patternMultiply(___,Name=Value)``````

## Description

example

````patternMultiply(array,frequency)` plots the 3-D radiation pattern of the array over a specified frequency. `patternMultiply` calculates the full array pattern without taking the effect of mutual coupling between the different array elements.```
````patternMultiply(array,frequency,azimuth)` plots the radiation pattern of the array for the given azimuth angles. Elevation angles retain default values.```
````patternMultiply(array,frequency,azimuth, elevation)` plots the radiation pattern of the array for the given azimuth and elevation angles.```

example

````patternMultiply(___,Name=Value)` uses additional options specified by one or more Name-Value Arguments after all the other input arguments.```
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency)``` returns the field value such as the directivity of the lossless array in dBi or gain of the lossy array in dBi at the specified frequency. The size of the field value matrix is (number of elevation values) x (number of azimuth values).```
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth)``` returns the field value at the specified azimuth angles. Elevation angles retain default values.```
``````[fieldval,azimuth,elevation] = patternMultiply(array,frequency,azimuth,elevation)``` returns the field value at the specified azimuth angles, and elevation angles.```
``````[fieldval,azimuth,elevation] = patternMultiply(___,Name=Value)``` returns the field value using additional options specified by one or more name-value arguments specified after all the other input arguments.```

## Examples

collapse all

Plot the radiation pattern of a default rectangular array at 70 MHz. Pattern multiplication does not take into consideration the effect of mutual coupling in array elements.

```h = rectangularArray; patternMultiply(h,70e6);```

Plot the radiation pattern of a 10-element linear array at 70 MHz. Visualize the pattern using the rectangular coordinate system.

```l = linearArray(NumElements=10); patternMultiply(l,70e6,CoordinateSystem="rectangular");```

Plot the radiation pattern of a rectangular array with PatternOptions using a transparency of 0.6 and a magnitude scale of [-5 5].

```h = rectangularArray; p = PatternPlotOptions; p.Transparency = 0.6; p.MagnitudeScale = [-5 5]; patternMultiply(h,70e6,PatternOptions=p);```

## Input Arguments

collapse all

Antenna array, specified as an array object.

Example: `rectangularArray`

Frequency to calculate array pattern, specified as a scalar in Hz.

Example: `70e6`

Data Types: `double`

Range of azimuth angles to plot the pattern of the array, specified as a vector in degrees.

Example: `–90:5:90`

Data Types: `double`

Range of elevation angles to plot the pattern of the array, specified as a vector in degrees.

Example: `0:1:360`

Data Types: `double`

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

Example: `CoordinateSystem="rectangular"`

Before R2021a, use commas to separate each name and value, and enclose `Name` in quotes.

Example: `'CoordinateSystem','rectangular'`

Coordinate system of radiation pattern plot, specified as a string amongst: `polar`, `rectangular`, or `uv`.

Example: `"rectangular"`

Data Types: `string`

Quantity to use for pattern plot, specified as a string from amongst these:

• `directivity` – Radiation intensity of antenna in dBi in a given direction

• `efield` – Electric field of antenna in volt/meter

• `power` – Antenna power in (Volt/meter)2

• `powerdb` – Antenna power in dB

Note

Example: `"efield"`

Data Types: `string`

Flag to normalize the field pattern, specified as either `true` or `false`. For directivity patterns, this property is not applicable.

Example: `false`

Data Types: `logical`

Type of field polarization, specified as a string from amongst these:

• `combined` – Mix of horizontal and vertical polarization

• `H` – Horizontal polarization

• `V` – Vertical polarization

• `RHCP` – Right-hand circular polarization

• `LHCP` – Left-hand circular polarization

By default, you can visualize a combined polarization.

Example: `"RHCP"`

Data Types: `string`

Parameter to change pattern plot properties, specified as a `PatternPlotOptions` object. The properties of `PatternPlotOptions` object that you can vary are:

• `Transparency`

• `SizeRatio`

• `AntennaOffset`

• `MagnitudeScale`

Example: `PatternPlotOptions(Transparency=0.1)`

## Output Arguments

collapse all

Array directivity or gain, returned as a matrix in `dBi`. The matrix size is the product of the number of elevation values and azimuth values.

Azimuth angle used to calculate field values, returned as a vector in degrees.

Elevation angles used to calculate field values, returned as a vector in degrees.

## Version History

Introduced in R2017a