System object: comm.MER
Package: comm
Measure modulation error ratio
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.
MERDB= step(MER,REFSYM,RXSYM)
returns the
measured MER, MERDB
, of the received signal RXSYM
,
based on reference signal REFSYM
. MER values are
measured in dB.
REFSYM
. REFSYM
and RXSYM
inputs
are complex column vectors of equal dimensions and data type. The
data type can be double, single, signed integer, or signed fixed point
with power-of-two slope and zero bias. All outputs of the object are
of data type double
. To set the interval over which
the MER is measured, use the MeasurementIntervalSource
and MeasurementInterval
properties.
MERDB = step(MER,RXSYM)
returns the measured
MER of received signal RXSYM
based on a reference
signal specified in the ReceivedConstellation
property.
[___,MINMER] = step(___)
returns
the minimum MER, MINMER
, given either of the two
previous syntaxes.
To return minimum MER, set the MinimumMEROutputPort
property
to true
. To set the interval over which MINMER
is
measured, use the MeasurementIntervalSource
and MeasurementInterval
properties.
[___,XMER] = step(___)
returns
the X-percentile MER, XMER
.
To return the X-percentile MER, set the XPercentileMEROutputPort
property
to true
. XMER
is the MER above
which X% of the measurements fall, where X is
set by the XPercentileValue
property. XMER
is
measured using all the input frames since the last reset.
[___,NUMSYM] = step(___)
returns
the number of symbols, NUMSYM
, used to calculate
the X-percentile MER.
To return NUMSYM
, set the SymbolCountOutputPort
to true
. NUMSYM
is
measured using all the input frames since the last reset.
Note
MER
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.