peakRadiation

Calculate and mark maximum radiation points of antenna or array on radiation pattern

Since R2024b

Syntax

peakRadiation(object,frequency)

peakRadiation(___,azimuth,elevation)

rad = peakRadiation(___)

[rad,az,el] = peakRadiation(___)

[___] = peakRadiation(___,Name=Value)

Description

peakRadiation(object,frequency) marks the maximum radiation points on the 3-D radiation pattern of the antenna or array specified in object at the frequency specified in frequency.

Note

• This function plots maximum directivity for lossless antennas and maximum gain for lossy antennas.

• This function uses the pattern function internally to plot the radiation pattern.

peakRadiation(___,azimuth,elevation) marks the maximum radiation points in a specific region of the 3-D radiation pattern. Define the region by specifying the azimuth angles in azimuth and elevation angles in elevation.

rad = peakRadiation(___) calculates and returns the maximum radiation value.

[rad,az,el] = peakRadiation(___) also calculates and returns the azimuth and elevation angles corresponding to the maximum radiation value.

[___] = peakRadiation(___,Name=Value) specifies additional options using one or more name-value arguments. For example, peakRadiation(linearArray(Element=cassegrain),12e9,ElementNumber=2) marks the maximum radiation points on the 3-D radiation pattern of the second Cassegrain antenna element of the linear array at 12 GHz.

Examples

Calculate and Plot Maximum Directivity of Helix Antenna

Create a helix antenna with a –45$°$ tilt.

ant = helix;
ant.Tilt = -45;

Calculate the maximum directivity (in dBi) and its azimuth and elevation angles (in degrees).

[g,az,el] = peakRadiation(ant,2e9)

g = 
8.6993

az = 
90

el = 
45

Mark the maximum directivity point on the directivity pattern plot.

figure
peakRadiation(ant,2e9)

Calculate Maximum Radiation Point in Specific Region of Radiation Pattern

Create a crossed dipole antenna. Find its maximum radiation at 6 GHz in a region defined by –90 to 90 degrees azimuth and –45 to 45 degrees elevation.

d = dipoleCrossed;
peakRadiation(dipoleCrossed,6e9,-90:1:90,-45:1:45)

Calculate Maximum Radiation of Monopole Array

This example shows how to plot maximum radiation of an array and calculate maximum radiation of a particular array element when other elements are terminated.

Create a linear array of 4 monopole antennas.

l = linearArray(Element=monopole,NumElements=4);
figure
show(l)
title("Linear Array of Monopoles")

Find and mark the maximum radiation point for this array at 72 MHz.

peakRadiation(l,72e6)

Calculate maximum radiation for the second antenna element in the array. Terminate other elements with a 75 ohm impedance.

[rad,az,el] = peakRadiation(l,72e6,ElementNumber=2,Termination=75)

rad = 
3.0326

az = 
-145

el = 
35

Input Arguments

object — Antenna or array

antenna object | array object | custom 2-D mesh or geometry object | custom 2-D and 3-D antenna object | pcbStack object | installedAntenna object | planeWaveExcitation object

Antenna or array to calculate and plot the radiation peak, specified as one of these options:

• Antenna object from the antenna catalog.

• Array object from the array catalog.

• pcbStack object.

• installedAntenna object.

• planeWaveExcitation object.

Example: yagiUda

frequency — Frequency to calculate or plot radiation peak

positive scalar

Frequency to calculate or plot the radiation peak, specified as a positive scalar in hertz.

Example: 70e6

Data Types: double

azimuth — Azimuth angles to define a specific region

–180:5:180 (default) | scalar | vector

Azimuth angles to define a specific region from the 3-D radiation pattern, specified as a scalar for a single angle or a vector for a range of angles.

Example: 45

Example: –40:1:40

Data Types: double

elevation — Elevation angles to define a specific region

–90:5:90 (default) | scalar | vector

Elevation angles to define a specific region from the 3-D radiation pattern, specified as a scalar for a single angle or a vector for a range of angles.

Example: 45

Example: –40:1:40

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: ElementNumber=1

ElementNumber — Index of antenna element in array

1 (default) | positive integer scalar

Index of the antenna element in an array, specified as a positive integer scalar. This argument is applicable only when you specify the object argument as an array. The antenna element you specify here must be connected to the voltage source. Use this argument to select an antenna element from the array and use its embedded pattern for calculating maximum radiation.

Example: 2

Data Types: double

Termination — Impedance value for array element termination

50 (default) | positive scalar

Impedance value for array element termination, specified as a positive scalar. This argument is applicable only when you specify the object argument as an array. The impedance value terminates other antenna elements of the array while calculating the embedded pattern of the antenna connected to the voltage source.

Example: 75

Data Types: double

Output Arguments

rad — Maximum radiation value

scalar | vector

Maximum radiation value, returned as a scalar or vector in dBi.

Data Types: double

az — Azimuth coordinate of maximum radiation point

scalar | vector

Azimuth coordinate of maximum radiation point, returned as a scalar or vector in degrees.

Data Types: double

el — Elevation coordinate of maximum radiation point

scalar | vector

Elevation coordinate of maximum radiation point, returned as a scalar or vector in degrees.

Data Types: double

Version History

Introduced in R2024b