step
System object: phased.Transmitter
Namespace: phased
Transmit pulses
Syntax
Y = step(H,X)
[Y,STATUS] = step(H,X)
[Y,PHNOISE] = 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.
Y = step(H,X)
returns the transmitted signal Y
,
based on the input waveform X
. Y
is
the amplified X
where the amplification is based
on the characteristics of the transmitter, such as the peak power
and the gain.
The size of the first dimension of the input matrix can vary to simulate a changing signal length. A size change can occur, for example, in the case of a pulse waveform with variable pulse repetition frequency.
[Y,STATUS] = step(H,X)
returns additional
output STATUS
as the on/off status of the transmitter
when the InUseOutputPort
property is true
. STATUS
is
a logical vector where true
indicates the transmitter
is on for the corresponding sample time, and false
indicates
the transmitter is off.
[Y,PHNOISE] = step(H,X)
returns the additional
output PHNOISE
as the random phase noise added
to each transmitted sample when the CoherentOnTransmit
property
is false
and the PhaseNoiseOutputPort
property
is true
. PHNOISE
is a vector
which has the same dimension as Y. Each element in PHNOISE
contains
the random phase between 0 and 2*pi, added to the corresponding sample
in Y
by the transmitter.
You can combine optional output arguments when their enabling properties are set. Optional outputs must be listed in the same order as the order of the enabling properties. For example:
[Y,STATUS,PHNOISE] = step(H,X)
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.