Main Content

plot

(To be removed) 2-D line plots of CCDF curves

comm.CCDF will be removed in a future release. Use powermeter instead. For information on updating your code, see Version History.

Description

example

lines = plot(ccdf) creates 2-D line plots corresponding to the complementary cumulative distribution function (CCDF) curves of a signal of interest specified by ccdf. The number of curves is equal to the number of channels in the signal. The function returns a column vector of chart line objects corresponding to the plots.

Before calling the plot function, you must obtain the CCDF curves of the signal of interest by calling the ccdf System object™ on the signal.

lines = plot(ccdf,Name,Value) specifies options using one or more name-value arguments. For a complete list of name-value arguments, see Line Properties. For example, plot(ccdf,'LineWidth',2) creates the plots such that the line width of each curve is 2 points.

Examples

collapse all

Generate 16-QAM and QPSK modulated signals.

qamTxSig = qammod(randi([0 15],20e3,1),16,'UnitAveragePower',true);
qpskTxSig = pskmod(randi([0 3],20e3,1),4,pi/4);

Pass the signals through an AWGN channel.

qamRxSig = awgn(qamTxSig,15);
qpskRxSig = awgn(qpskTxSig,15);

Create a CCDF measurement object enabling outputs for the average power measurements and peak power measurements.

ccdf = comm.CCDF( ...
    'AveragePowerOutputPort',true, ...
    'PeakPowerOutputPort',true);

Obtain the CCDF measurements of the two waveforms.

[ccdfy,ccdfx,avg,peak] = ccdf([qamRxSig qpskRxSig]);

Plot the CCDF curves for both signals.

plot(ccdf)
legend('16-QAM','QPSK')

Input Arguments

collapse all

CCDF measurements, specified as a comm.CCDF System object. The object must contain CCDF curves. To obtain the CCDF curves, call the object on the input signal of interest.

Output Arguments

collapse all

Plotted CCDF curves, returned as a column vector of Line objects. The length of this vector is equal to the number of CCDF curves specified by the input ccdf. These Line objects uniquely identify the plotted 2-D CCDF curves. Use these objects to query and modify the properties of the curves in the plots. For a complete list of object properties, see Line Properties.

Version History

Introduced in R2012a

expand all

R2024a: To be removed

The comm.CCDF System object will be removed in a future release. Use powermeter instead.

See Also

Objects