step
System object: phased.ArrayGain
Package: phased
Calculate array gain of sensor array
Syntax
G = step(H,FREQ,ANG)
G = step(H,FREQ,ANG,WEIGHTS)
G = step(H,FREQ,ANG,STEERANGLE)
G = step(H,FREQ,ANG,WEIGHTS,STEERANGLE)
G = step(H,FREQ,ANG,WS)
Description
Note
Starting in R2016b, instead of using the step
method
to perform the operation defined by the System object™, you can
call the object with arguments, as if it were a function. For example, y
= step(obj,x)
and y = obj(x)
perform
equivalent operations.
returns
the array gain G
= step(H
,FREQ
,ANG
)G
of
the array for the operating frequencies specified in FREQ
and
directions specified in ANG
.
applies
weights G
= step(H
,FREQ
,ANG
,WEIGHTS
)WEIGHTS
on the sensor array. This syntax
is available when you set the WeightsInputPort
property
to true
.
uses G
= step(H
,FREQ
,ANG
,STEERANGLE
)STEERANGLE
as
the subarray steering angle. This syntax is available when you configure H
so
that H.Sensor
is an array that contains subarrays,
and H.Sensor.SubarraySteering
is either 'Phase'
or 'Time'
.
combines
all input arguments. This syntax is available when you configure G
= step(H
,FREQ
,ANG
,WEIGHTS
,STEERANGLE
)H
so
that H.WeightsInputPort
is true
, H.Sensor
is
an array that contains subarrays, and H.Sensor.SubarraySteering
is
either 'Phase'
or 'Time'
.
uses G
= step(H
,FREQ
,ANG
,WS
)WS
as weights applied to each element within each subarray. To
use this syntax, set the SensorArray
property to an array that
supports subarrays and set the SubarraySteering
property of the
array to 'Custom'
.
Note
The object performs an initialization the first time the object is executed. This
initialization locks nontunable properties
and input specifications, such as dimensions, complexity, and data type of the input data.
If you change a nontunable property or an input specification, the System object issues an error. To change nontunable properties or inputs, you must first
call the release
method to unlock the object.
Input Arguments

Array gain object.  

Operating frequencies of array in hertz.  

Directions in degrees. If If  

Weights on the sensor array. If If  

Subarray steering angle in degrees. If If  

Subarray element weights Subarray element weights, specified as complexvalued N_{SE}byN matrix or 1byN cell array where N is the number of subarrays. These weights are applied to the individual elements within a subarray. Subarray element weights
Dependencies To enable this argument, set the 
Output Arguments

Gain of sensor array, in decibels. 