Main Content

step

System object: comm.ACPR
Package: comm

Adjacent Channel Power Ratio measurements

Syntax

A = step(H,X)
[A,MAINPOW] = step(H,X)
[A,ADJPOW] = step(H,X)

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.

A = step(H,X) returns a vector of the adjacent channel power ratio, A, measured in the input data, X. The measurements are at the frequency bands that you specify with the MainChannelFrequency, MainMeasurementBandwidth, AdjacentChannelOffset, and AdjacentMeasurementBandwidth properties. Input X must be a double precision column vector. The length of the output vector, A, equals the number of adjacent channels that you specify in the AdjacentChannelOffset property.

[A,MAINPOW] = step(H,X) returns the measured main channel power, MAINPOW, when you set the MainChannelPowerOutputPort property to true. The step method outputs the main channel power measured within the main channel frequency band of interest that you specify with the MainChannelFrequency and MainMeasurementBandwidth properties.

[A,ADJPOW] = step(H,X) returns a vector of the measured adjacent channel powers, ADJPOW, when you set the AdjacentChannelPowerOutputPort property to true. The adjacent channel powers are measured at the adjacent frequency bands of interest that you specify with the AdjacentChannelOffset and AdjacentMeasurementBandwidth properties. The length of the output vector, ADJPOW, equals the length of the vector that you specify in the AdjacentChannelOffset property. You can combine optional output arguments when you set their enabling properties. Optional outputs must be listed in the same order as the order of the enabling properties. For example,

Note

obj specifies the System object on which to run this step method.

The object performs an initialization the first time the step method 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.