pattern

Plot 3D scattering pattern of RIS

Since R2025a

Syntax

pattern(ris,freq,azel_in)

pattern(ris,freq,azel_in,az)

pattern(ris,freq,azel_in,az,el)

[pat,az_ang,el_ang] = pattern(___,Name=Value)

pattern(___,Name=Value)

Description

pattern(ris,freq,azel_in) plots the 3D scattering pattern of the RIS, ris, for incident directions specified in azel_in. freq specifies the operating frequency.

pattern(ris,freq,azel_in,az) also plots the 3D scattering pattern within the azimuth angles az.

pattern(ris,freq,azel_in,az,el) also plots the 3D scattering pattern at elevation angles specified by el. The object functions plots the RIS scattering pattern based on the value of freq, az, and el. At least one of freq, az, and el must be a scalar.

• If freq is a scalar, and both az and el are vectors, the 3D pattern at the specified frequency in freq is plotted in the region of azimuth and elevation angles specified by az and el.

• If freq and az are vectors and el is a scalar, the patterns at specified frequencies in freq are plotted along azimuth angles specified in az with fixed elevation angle specified in el.

• If freq and el are vectors and az is a scalar, the patterns at specified frequencies in freq are plotted along the elevation angles specified in el with fixed azimuth angle specified in az.

[pat,az_ang,el_ang] = pattern(___,Name=Value) also plots the scattering pattern pat at azimuth angles az_ang and elevation angles el_ang.

pattern(___,Name=Value) plots the array pattern with additional options specified by one or more Name=Value pair arguments.

Examples

RIS Scattering Pattern

Plot the scattering pattern of an RIS when the incident direction is$100°$ azimuth and $40°$ degrees elevation.

ris = phased.RectangularRIS;
pattern(ris,2e8,[100;40], ...
    -90:90,-90:90, ...
    CoordinateSystem="polar")

Input Arguments

ris — Rectangular Reconfigurable Intelligent Surface

phased.RectangularRIS System object

Reconfigurable intelligent surface, specified as a phased.RectangularRIS System object™

freq — Operating frequency (Hz)

positive scalar

Operating frequency, specified as a positive scalar. Units are in Hz.

Example: 300e6

Data Types: single | double

azel_in — Incident direction

scalar | length-2 real-valued column vector

Incident direction, specified as a scalar or length-2 real-valued column vector. If azel_in is a scalar, it represents the azimuth angle, and the corresponding elevation angle is assumed to be zero. When azel_in is a vector, it specifies the direction in space in the form [azimuth;elevation]. The azimuth angle should be between [-180 180] degrees and the elevation angle should be between [-90 90] degrees. Units are in degrees.

Data Types: single | double

az — Azimuth angles

real-valued vector

Azimuth angles, specified as a real-valued vector. The object function plots the 3D scattering pattern within the specified azimuth angles. Units are in degrees.

Example: [90 100]

Data Types: single | double

el — Elevation angles

real-valued vector

Elevation angles, specified as a vector. The object function plots the RIS scattering pattern based on the values of freq, az, and el.

Example: [10 70]

Data Types: single | 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: Type="efield"

CoordinateSystem — Pattern coordinate system

"polar" (default) | "rectangular"

Specify the coordinate system of the pattern using "polar" or "rectangular". If CoordinateSystem is "polar" or"rectangular", az and el specify the azimuth and elevation angles, respectively. az must be between –180° and 180° and el must be between –90° and 90°. Display units are in degrees.

Example: "rectangular"

Data Types: char | string

Type — Pattern type

"powerdb" (default) | "efield" | "power"

Type of the pattern, specified as "powerdb", "efield", or "power". If Type is "efield", the pattern is the field scattering pattern of the surface. If Type is "power", the pattern is the scattering pattern of the surface computed from the square of the field pattern. If Type is '"powerdb", the scattering pattern is the power pattern measured in dB. Units are dB,magnitude, or magnitude-squared.

Example: "efield"

Data Types: char | string

Normalize — Pattern normalization

true (default) | false

Enable normalization of the response pattern, specified as true or false. Set this property to true to normalize the response pattern or false to leave the response pattern unnormalized.

Example: true

Data Types: logical

ShowColorbar — Display colorbar

true (default) | false

Enable display of colorbar, specified as true or false.

Example: false

Data Types: logical

Parent — Axes handle

positive integer

Handle to the axes along which the pattern is displayed, specified as a positive integer.

Data Types: double

PlotStyle — Plotting style

"overlay" (default) | "waterfall"

Plotting style, specified as "overlay" or "waterfall". Use this property to display plots with multiple frequencies.

Data Types: char | string

PropagationSpeed — Signal propagation speed

physconst('Lightspeed') (default) | positive scalar

Signal propagation speed, specified as a positive scalar. Units are in meters/second.

Example: PropagationSpeed=3e8

Data Types: double | single

Weights — Element weights

complex-valued length-N column vector | complex-valued N-by-M matrix

Weights applied to array elements, specified as a complex-valued length-N column vector or complex-valued N-by-M matrix. N is the number of elements in the surface and M is the number of frequencies contained in freq when freq is a vector. If Weights is a column vector, identical weights are applied to each frequency. If Weights is a matrix, each column of Weights values are applied to the corresponding frequency in freq. If Weights is a matrix and freq is a scalar, each column of Weights values are applied to the same frequency in freq.

Data Types: double | single
Complex Number Support: Yes

Output Arguments

pat — RIS pattern

real-valued P-by-Q matrix

RIS pattern, returned as a real-valued P-by-Q matrix. The elements represent the RIS pattern at corresponding sampling points specified by az_ang and el_ang.

az_ang — RIS pattern azimuth angles (degrees)

real-valued length-Q row vector

RIS pattern azimuth angles, retuned as a real-valued length-Q row vector. az_ang represents the azimuth angles at which the RIS pattern is displayed. Units are in degrees.

el_ang — RIS pattern elevation angles (degrees)

real-valued length-P row vector

RIS pattern elevation angles, retuned as a real-valued length-P row vector. el_ang represents the elevation angles at which the RIS pattern is displayed. Units are in degrees.

Version History

Introduced in R2025a