Main Content

peakRadiation

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

Since R2024b

    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.

    example

    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.

    example

    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.

    example

    [___] = 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.

    example

    Examples

    collapse all

    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)

    Figure contains 2 axes objects and other objects of type uicontrol. Axes object 1 contains 4 objects of type patch, surface. Hidden axes object 2 contains 19 objects of type surface, line, text, patch, scatter, quiver.

    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)

    Figure contains 2 axes objects and other objects of type uicontrol. Axes object 1 contains 6 objects of type patch, surface. Hidden axes object 2 contains 20 objects of type surface, line, text, patch, scatter, quiver.

    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")

    Figure contains an axes object. The axes object with title Linear Array of Monopoles, xlabel x (m), ylabel y (m) contains 14 objects of type patch, surface. These objects represent PEC, feed.

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

    peakRadiation(l,72e6)

    Figure contains 2 axes objects and other objects of type uicontrol. Axes object 1 contains 14 objects of type patch, surface. Hidden axes object 2 contains 23 objects of type surface, line, text, patch, scatter, quiver.

    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

    collapse all

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

    Example: yagiUda

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

    Example: 70e6

    Data Types: double

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

    collapse all

    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

    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

    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

    collapse all

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

    Data Types: double

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

    Data Types: double

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

    Data Types: double

    Version History

    Introduced in R2024b