Main Content

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.

Examples

expand all

Transmit a pulse containing a linear FM waveform with a bandwidth of 5 MHz and a sample rate of 10 MHz.

fs = 1e7;
waveform = phased.LinearFMWaveform(SampleRate=fs, ...
    PulseWidth=1e-5,SweepBandwidth=5e6);
x = waveform();
transmitter = phased.Transmitter(PeakPower=5e3);
y = transmitter(x);