System object: comm.ACPR
Package: comm
Adjacent Channel Power Ratio measurements
A = step(H,X)
[A,MAINPOW] = step(H,X)
[A,ADJPOW] = step(H,X)
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.