comm.CCDF

互补累积分布函数(CCDF)测量

展开全部页面

comm.CCDF将在将来的版本中删除。使用功率计代替。有关更新代码的信息，请参见版本历史。

描述

的comm.CCDF系统对象™获取输入信号的CCDF测量值。CCDF测量信号的瞬时功率高于其平均功率的指定电平的概率。

要获得输入信号的CCDF测量值:

创建comm.CCDF对象并设置其属性。
使用参数调用对象，就像调用函数一样。

有关系统对象如何工作的详细信息，请参见什么是系统对象?

创建

语法

ccdf = com . ccdf

ccdf = com . ccdf(名称，值)

描述

ccdf= comm.CCDF创建CCDF测量系统对象。

例子

ccdf= comm.CCDF (名字，价值）集属性使用一个或多个名称-值参数。例如,comm.CCDF (' NumPoints ', 2000)创建一个具有2000个CCDF点的CCDF测量对象。

属性

全部展开

除非另有说明，属性为nontunable，这意味着在调用对象后不能更改它们的值。对象在调用时锁定，而释放功能解锁它们。

如果属性为可调，您可以随时更改其值。

有关更改属性值的详细信息，请参见使用系统对象的MATLAB系统设计。

`NumPoints`- - - - - -CCDF点数
`1000`(默认)|正整数

CCDF点的数目，指定为正整数。这个属性和MaximumPowerLimit属性控制对象用于估计CCDF曲线的直方图容器的大小。直方图箱的大小决定了曲线的分辨率。所有输入通道都有相同数量的CCDF点。

数据类型:双

`MaximumPowerLimit`- - - - - -最大期望输入信号功率限制
`50`(默认)|数字标量|数字行向量

最大预期输入信号功率限制，指定为这些选项之一。

数字标量-输入信号中的所有通道都具有相同的期望最大功率。
数字行向量我向量的第Th元素是向量的最大期望幂我输入信号中的第Th通道。

对于每个输入通道，该对象通过积分瞬时输入信号功率的直方图来获得CCDF结果。该对象设置直方图的bin，以便最后一个bin收集所有等于或大于此属性指定的幂的次数。如果输入信号超过其指定的最大功率限制，该对象发出警告。

这个属性和NumPoints属性控制对象用于估计CCDF曲线的直方图容器的大小。直方图箱的大小决定了曲线的分辨率。

要指定此属性的单位，请使用PowerUnits财产。

数据类型:双

`PowerUnits`- - - - - -功率计量单位
`dBm的`(默认)|`“瓦分贝”`|`“瓦”`

功率测量单位，指定为这些值之一。

dBm的或“瓦分贝”—对象返回以dB为单位的相对功率值。
“瓦”—对象返回线性比例的相对功率值。

此属性决定了电源的功率单位MaximumPowerLimit财产。

数据类型:字符|字符串

`AveragePowerOutputPort`- - - - - -选项，以启用平均功率测量输出
`0`或`假`(默认)|`1`或`真正的`

选项，以启用平均功率测量输出，指定为逻辑值0（假)或1（真正的)．当您将此属性设置为真正的，对象返回运行平均功率测量值。

数据类型:逻辑|双

`PeakPowerOutputPort`- - - - - -选项，以启用峰值功率测量输出
`0`或`假`(默认)|`1`或`真正的`

选项，以启用峰值功率测量输出，指定为逻辑值0（假)或1（真正的)．当您将此属性设置为真正的，对象返回运行峰值功率测量值。

数据类型:逻辑|双

`PAPROutputPort`- - - - - -选项，使PAPR测量输出
`0`或`假`(默认)|`1`或`真正的`

选项，以启用峰值平均功率(PAPR)测量输出，指定为逻辑值0（假)或1（真正的)．当您将此属性设置为真正的，对象返回运行的PAPR测量值。

数据类型:逻辑|双

使用

语法

[ccdfy,ccdfx] = ccdf(信号)

[ccdfy,ccdfx,avg] = ccdf(信号)

[ccdfy,ccdfx,peak] = ccdf(信号)

[ccdfy,ccdfx,papr] = ccdf(信号)

[ccdfy,ccdfx,avg,peak,papr] = ccdf(信号)

描述

(ccdfy，ccdfx] = ccdf(信号）返回y设在和x-输入中每个通道的CCDF曲线的轴点信号。

(ccdfy，ccdfx，avg] = ccdf(信号）还返回输入信号中每个通道的平均功率测量值。要使用此语法，请设置AveragePowerOutputPort财产真正的。

(ccdfy，ccdfx，峰] = ccdf(信号）还返回输入信号中每个通道的峰值功率测量值。要使用此语法，请设置PeakPowerOutputPort财产真正的。

(ccdfy，ccdfx，地表铺面] = ccdf(信号）返回输入信号中每个通道的PAPR测量值。要使用此语法，请设置PAPROutputPort财产真正的。

(ccdfy，ccdfx，avg，峰，地表铺面] = ccdf(信号）返回所有CCDF测量值。要使用此语法，请设置AveragePowerOutputPort，PeakPowerOutputPort,PAPROutputPort属性真正的。

输入参数

全部展开

`信号`- - - - - -输入信号
复数矩阵

输入信号，指定为米——- - - - - -N复数矩阵。米是时间样本的个数。N是输入通道的数量。

数据类型:双
复数支持:金宝app是的

输出参数

全部展开

`ccdfy`- - - - - -yCCDF曲线的-轴点
数字矩阵

y每个通道的CCDF曲线的-轴点，以数字矩阵的形式返回(NumPoints+ 1)——-N,在那里N输入的列数是多少信号。的我矩阵的第1列包含为通道测量的概率值我的第Th列信号。概率值是范围[0,100]中的百分比。

数据类型:双

`ccdfx`- - - - - -xCCDF曲线的-轴点
数字矩阵

x每个通道的CCDF曲线的-轴点，以数字矩阵的形式返回(NumPoints+ 1)——-N。N输入的通道数是多少信号。的我矩阵的第列包含通道的瞬时平均功率比我的第Th列信号。

数据类型:双

`avg`-平均功率测量
数值列向量

每个通道的平均功率测量，以数值列向量形式返回。的我元素对应于中信道的平均功率测量我输入的第Th列信号。对象以指定的单位返回此值PowerUnits财产。

数据类型:双

`峰`-峰值功率测量
数值列向量

每个通道的峰值功率测量，作为数字列向量返回。的我元素对应于中通道的峰值功率测量我输入的第Th列信号。对象以指定的单位返回此值PowerUnits财产。

数据类型:双

`地表铺面`- PAPR测量
数值列向量

每个通道的PAPR测量值，作为数值列向量返回。的我第th元素对应于通道的PAPR测量我输入的第Th列信号。对象以指定的单位返回此值PowerUnits财产。

数据类型:双

对象的功能

要使用对象函数，请将System对象指定为第一个输入参数。例如，释放system对象的系统资源obj，使用这种语法:

发行版(obj)

全部展开

特定于`comm.CCDF`

`getPercentileRelativePower`	(不推荐)使用CCDF的给定百分比的相对功率值
`getProbability`	(不推荐)使用CCDF计算相对功率值的概率
`情节`	(不推荐)CCDF曲线的二维折线图

所有系统对象通用

`一步`	运行系统对象算法
`释放`	释放资源并允许更改系统对象属性值和输入特征
`重置`	重置的内部状态系统对象

例子

全部折叠

获得16-QAM和QPSK信号的CCDF曲线

生成16-QAM和QPSK调制信号。

qamTxSig = qammod(randi([0 15]，20e3,1)，16，“UnitAveragePower”,真正的);qpskTxSig = pskmod(randi([0 3]，20e3,1)，4,pi/4);

通过AWGN通道传递信号。

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

创建一个CCDF测量对象，支持平均功率测量和峰值功率测量的输出。

ccdf = com . ccdf (.．.“AveragePowerOutputPort”,真的,.．.“PeakPowerOutputPort”,真正的);

获得两种波形的CCDF测量值。

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

绘制两个信号的CCDF曲线。

情节(ccdf)传说(“16-QAM”，“正交相移编码”）

扩展功能

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。

使用注意事项和限制:

看到系统对象在MATLAB代码生成(MATLAB编码器)。

版本历史

在R2012a中引入

全部展开

R2023a:待移除

的comm.CCDF系统对象运行时没有警告，但代码分析器会指示这一点comm.CCDF将在将来的版本中删除。若要计算互补累积分布函数测量值，请使用功率计改为系统对象。

另请参阅

对象

功率计|comm.ACPR|comm.EVM|comm.MER

comm.CCDF

描述

创建

语法

描述

属性

NumPoints- - - - - -CCDF点数1000(默认)|正整数

MaximumPowerLimit- - - - - -最大期望输入信号功率限制50(默认)|数字标量|数字行向量

PowerUnits- - - - - -功率计量单位dBm的(默认)|“瓦分贝”|“瓦”

AveragePowerOutputPort- - - - - -选项，以启用平均功率测量输出0或假(默认)|1或真正的

PeakPowerOutputPort- - - - - -选项，以启用峰值功率测量输出0或假(默认)|1或真正的

PAPROutputPort- - - - - -选项，使PAPR测量输出0或假(默认)|1或真正的

使用

语法

描述

输入参数

信号- - - - - -输入信号复数矩阵

输出参数

ccdfy- - - - - -yCCDF曲线的-轴点数字矩阵

ccdfx- - - - - -xCCDF曲线的-轴点数字矩阵

avg-平均功率测量数值列向量

峰-峰值功率测量数值列向量

地表铺面- PAPR测量数值列向量

对象的功能

特定于comm.CCDF

所有系统对象通用

例子

获得16-QAM和QPSK信号的CCDF曲线

扩展功能

C/ c++代码生成使用MATLAB®Coder™生成C和c++代码。

版本历史

R2023a:待移除

另请参阅

对象

`NumPoints`- - - - - -CCDF点数
`1000`(默认)|正整数

`MaximumPowerLimit`- - - - - -最大期望输入信号功率限制
`50`(默认)|数字标量|数字行向量

`PowerUnits`- - - - - -功率计量单位
`dBm的`(默认)|`“瓦分贝”`|`“瓦”`

`AveragePowerOutputPort`- - - - - -选项，以启用平均功率测量输出
`0`或`假`(默认)|`1`或`真正的`

`PeakPowerOutputPort`- - - - - -选项，以启用峰值功率测量输出
`0`或`假`(默认)|`1`或`真正的`

`PAPROutputPort`- - - - - -选项，使PAPR测量输出
`0`或`假`(默认)|`1`或`真正的`

`信号`- - - - - -输入信号
复数矩阵

`ccdfy`- - - - - -yCCDF曲线的-轴点
数字矩阵

`ccdfx`- - - - - -xCCDF曲线的-轴点
数字矩阵

`avg`-平均功率测量
数值列向量

`峰`-峰值功率测量
数值列向量

`地表铺面`- PAPR测量
数值列向量

特定于`comm.CCDF`

C/ c++代码生成
使用MATLAB®Coder™生成C和c++代码。