探针
Wireless 功能新增了一种新的探针类型。Coupled Node Statistic Probe 与 Node Statistic Probe 类似,但将所采集的数据限定为仅与两个模块之间的交互相关,而这两个模块可以位于不同的节点中。因此,它适用于捕获移动节点之间的统计量。
Coupled Node Statistic Probe 对象
Coupled Node Statistic Probe 对象通常用于指定针对某一特定无线电发射机的发送,选择性地采集无线电接收机统计量。你必须为耦合探针指定 subnet、node 和 module 属性,以唯一确定网络中启用统计量采集的模块。由于耦合探针目前仅适用于无线电接收机,submodule 属性对应一个无线电接收机信道,并且必须被赋值(无线电接收机除了其信道的统计量之外没有其它统计量)。此外,coupled subnet、coupled node 和 coupled module 属性用于指定与所探测模块的交互令人关注的特定模块。
与普通的统计量探针一样,耦合节点统计量探针可用于采集向量数据、标量数据,或两者兼有。有关标量和向量统计量的更多信息,参见 Modeling Concepts 手册“Data Analysis”第 422 页。耦合节点统计量探针的图形表示如下所示。
图 65:Coupled Node Statistic Probe 表示

Coupled Node Statistic Probe 对象属性
耦合节点统计量探针对象的内置属性按下表所示的字母顺序列出。
表 31:Coupled Node Statistic Probe 对象内置属性
| Name | Data Type |
|---|---|
| capture mode | string |
| coupled module | string |
| coupled node | string |
| coupled subnet | string |
| draw style | enumerated |
| group | string |
| module | string |
| name | string |
| node | string |
| ordinate label | string |
| scalar data | toggle |
| scalar start | double |
| scalar stop | double |
| scalar type | enumerated |
| src objid | integer |
| statistic | string |
| submodule | string |
| subnet | string |
| vector data | toggle |
| vector start | double |
| vector stop | double |
capture mode
该属性指定在将采集到的值写入仿真输出之前如何处理这些值。在 normal 模式下,所有值都不加处理地写入。其它模式会修改或丢弃取值,以减小输出数据的体量,或呈现统计量的另一种视角。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | normal | |
| Units | ||
| Constraints | normal, sample, bucket, glitch removal |
coupled module
coupled subnet、coupled node 和 coupled module 属性用于指定与所探测模块的交互令人关注的特定模块。目前,由于耦合探针仅适用于无线电接收机信道对象,coupled module 必须是一个无线电发射机模块。针对某些无线电接收机信道统计量的耦合探针,仅相对于所选发射机模块的发送有效。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid module name |
coupled node
coupled subnet、coupled node 和 coupled module 属性用于指定与所探测模块的交互令人关注的特定模块。目前,由于耦合探针仅适用于无线电接收机信道对象,coupled module 必须是一个无线电发射机模块。针对某些无线电接收机信道统计量的耦合探针,仅相对于所选发射机模块的发送有效。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid node name |
coupled subnet
coupled subnet、coupled node 和 coupled module 属性用于指定与所探测模块的交互令人关注的特定模块。目前,由于耦合探针仅适用于无线电接收机信道对象,coupled module 必须是一个无线电发射机模块。针对某些无线电接收机信道统计量的耦合探针,仅相对于所选发射机模块的发送有效。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid subnet name |
draw style
该属性指定统计量第一次在分析面板中显示时的显示方式。你也可以在请求采集该统计量时指定 draw style,即在 Statistic 弹出菜单中指定样式。
在将统计量显示到图中之后,则在 Graph 弹出菜单中指定样式。
| Editing | Simulation | |
|---|---|---|
| Data Type | enumerated | enumerated |
| Access | read / write | read |
| Default Value | linear | |
| Units | ||
| Constraints | sample-hold, bar, discrete, linear, square-wave, bar chart |
group
统计量按协议(例如 IP 或 Ethernet)或应用类型(例如 client FTP 或 Server Email)组织成组。这个只读属性显示组的名称。
统计量浏览器首先按类型(global、module、node、link、animation)显示统计量,然后按组显示。浏览器所显示的统计量和组取决于你是在工作区中右键单击(以显示全局统计量)还是在某个特定对象上右键单击。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read | read |
| Default Value | none | |
| Units | ||
| Constraints |
module
该属性指定作为所采集统计量源的模块的名称。module 与 subnet 和 node 属性一起用于在网络模型内唯一指定该模块。此外,submodule 属性可用于指定模块内的一个子模块作为统计量的源。由于耦合探针目前仅适用于无线电接收机,submodule 属性对应一个无线电接收机信道,并且必须被赋值(无线电接收机除了其信道的统计量之外没有其它统计量)。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid module name |
name
该属性是一个用于为耦合节点统计量探针创建名称的文本字符串。它仅用于组织目的,对探针的运行没有任何影响。它允许用户对探针进行标记,以便于识别其功能。name 的默认取值为 pbn,其中 n 是一个从 1 开始、每次创建任何新探针时递增 1 的整数。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | pbn, n >= 1 | |
| Units | ||
| Constraints |
node
该属性指定作为所采集统计量源的模块的父节点的名称。node 与 subnet 和 module 属性一起用于唯一指定该模块。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid node name |
ordinate label
该属性如果不为空,则指定用于探针所采集统计量的名称。它同时适用于标量和向量统计量。它通常用于覆盖并简化自动分配给统计量的默认名称。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints |
scalar data
该属性是一个布尔值,用于启用或阻止受影响统计量的标量数据采集。如果该属性设置为“enabled”,则 scalar type、scalar start 和 scalar stop 属性定义所记录的标量数据的性质。探测的标量数据在仿真结束时基于统计量在整个仿真过程中的属性进行记录。有关标量统计量的更多信息,参见 Modeling Concepts 手册第 11 章“Data Analysis”第 422 页和第 10 章“Simulation Design”第 375 页。
| Editing | Simulation | |
|---|---|---|
| Data Type | boolean | boolean |
| Access | read / write | read |
| Default Value | disabled | |
| Units | ||
| Constraints |
scalar start
如果 scalar data 属性的取值为“enabled”,则 scalar start 和 scalar stop 一起指定计算标量统计量所用的仿真时间窗口。只有所探测统计量在指定时间区间内发生的更新才会被用于计算所得的标量值。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | 0.0 | |
| Units | seconds | |
| Constraints | scalar start < scalar stop |
scalar stop
如果 scalar data 属性的取值为“enabled”,则 scalar start 和 scalar stop 一起指定计算标量统计量所用的仿真时间窗口。只有所探测统计量在指定时间区间内发生的更新才会被用于计算所得的标量值。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | infinite | |
| Units | seconds | |
| Constraints | scalar start < scalar stop |
scalar type
该属性可以表示以下指标之一:“last value”、“sample mean”、“time average”、“variance”、“min value”或“max value”。如果 scalar data 属性的取值为“enabled”,则 scalar type 用于计算应用于所关注统计量的这些指标之一。关于每个指标的完整描述,参见 Modeling Concepts 手册第 10 章“Simulation Design”第 375 页。
| Editing | Simulation | |
|---|---|---|
| Data Type | enumerated | integer |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints |
src objid
该属性通过对象 ID 唯一标识所探测的仿真对象。src objid 的取值由系统指派,并由探针的其它属性决定:subnet、node、module 和 submodule。
该属性仅存在于仿真期间,可用于验证探针是否正确配置。
| Editing | Simulation | |
|---|---|---|
| Data Type | N/A | integer |
| Access | N/A | read |
| Default Value | ||
| Units | ||
| Constraints |
statistic
该属性表示要采集的统计量的名称。大多数模块和子模块类型支持一组描述其行为或性能的预定义统计量。此外,处理器和队列支持一组其取值由用户定义的过程模型驱动的统计量。目前,由于耦合探针仅适用于无线电接收机信道对象,此属性仅支持某些无线电接收机统计量(如“Wireless Statistic Probes”第 35 页所列)。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints |
submodule
该属性可用于指定作为所采集统计量源的子模块的名称。submodule 属性与 subnet、node 和 module 属性一起用于唯一指定该子模块。由于耦合探针目前仅适用于无线电接收机,submodule 属性对应一个无线电接收机信道,并且必须被赋值(无线电接收机除了其信道的统计量之外没有其它统计量)。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | integer |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid submodule name |
subnet
该属性指定包含作为耦合统计量源的模块的子网的名称。subnet 与 node 和 module 属性一起用于唯一指定该模块。子网名称是分层的,由所有父子网的各个名称以句点分隔拼接而成,并以其自身名称结尾。
| Editing | Simulation | |
|---|---|---|
| Data Type | string | string |
| Access | read / write | read |
| Default Value | ||
| Units | ||
| Constraints | valid subnet name |
vector data
该属性是一个开关,用于启用或阻止受影响统计量的向量数据采集。如果其为“enabled”,则 vector start 和 vector stop 属性定义记录所关注统计量更新的时间区间。一般而言,vector data 或 scalar data 属性中至少有一个为“enabled”。
| Editing | Simulation | |
|---|---|---|
| Data Type | toggle | toggle |
| Access | read / write | read |
| Default Value | enabled | |
| Units | ||
| Constraints |
vector start
如果 vector data 属性的取值为“enabled”,则 vector start 和 vector stop 属性一起指定将所探测统计量的更新记录到所得输出向量中的仿真时间窗口。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | 0.0 | |
| Units | seconds | |
| Constraints | vector start < vector stop |
vector stop
如果 vector data 属性的取值为“enabled”,则 vector start 和 vector stop 属性一起指定将所探测统计量的更新记录到所得输出向量中的仿真时间窗口。
| Editing | Simulation | |
|---|---|---|
| Data Type | double | double |
| Access | read / write | read |
| Default Value | infinite | |
| Units | seconds | |
| Constraints | vector start < vector stop |