包概述

Ima(Internal Model Access,内部模型访问)包是一组内核过程,提供对仿真实体的动态访问:仿真属性、对象属性、对象命令以及进程状态变量。

仿真属性是与整个仿真相关联、而非与某个特定对象相关联的数据元素。这些属性在进程模型中声明,并通过内核过程 op_ima_sim_attr_get()、op_ima_sim_attr_get_color()、op_ima_sim_attr_get_dbl()、op_ima_sim_attr_get_int32() 和 op_ima_sim_attr_get_str() 动态查询。

注意: op_ima_sim_attr_get() 支持多种数据类型;不过,特定类型的版本效率更高,并使编译器能够捕获潜在的参数错误。

仿真属性的值可以通过仿真程序环境的任意机制赋值:命令行标志、shell 变量、环境文件或偏好文件(最后一种机制很少用于为动态属性赋值)。若被查询的属性没有指定赋值,将在标准输出设备上打印提示信息以获取值。若内核过程 op_ima_sim_attr_exists() 返回 OPC_TRUE,说明仿真程序环境中已存在该值,无需通过提示信息获取。

对象属性是属于特定仿真对象的数据元素。这些属性或是内置于对象定义中,由用户在 Riverbed Modeler 编辑器中定义,通过 EMA 程序定义,或是从下层域对象提升而来。被提升的对象属性的值可以使用仿真程序环境的任意机制赋值,包括标准输出设备提示。

仿真执行期间,对象属性可以通过内核过程 op_ima_obj_attr_get() 或其特定类型版本 op_ima_obj_attr_get_color()、op_ima_obj_attr_get_dbl()、op_ima_obj_attr_get_int32()、op_ima_obj_attr_get_objid()、op_ima_obj_attr_get_str() 和 op_ima_obj_attr_get_toggle() 查询。

可以通过内核过程 op_ima_obj_attr_set() 或其特定类型版本 op_ima_obj_attr_set_color()、op_ima_obj_attr_set_dbl()、op_ima_obj_attr_set_int32()、op_ima_obj_attr_set_objid()、op_ima_obj_attr_set_str() 和 op_ima_obj_attr_set_toggle() 为对象属性赋值。

可以通过调用内核过程 op_ima_obj_attr_exists() 判断特定对象上是否存在某属性。通过这些内核过程,进程既可以访问远程对象的属性,也可以访问属于自身模块的属性。内核过程 op_ima_obj_hname_get() 提供了一种快速获取对象完整分层名称的方法。

查询对象属性是一种非侵入性活动(即它不会影响被查询的对象或属性)。然而,为对象属性赋新值可能会影响对象的内部运行,具体取决于被修改的属性。在某些情况下,属性赋值只有当对象下次查询该属性值时才生效(即通过 op_ima_obj_attr_set… 内核过程进行的属性赋值不一定会触发动作)。

除对象属性外,对象还可以以附加值或数据结构的形式包含状态信息。内核过程 op_ima_obj_state_set() 和 op_ima_obj_state_get() 允许设置和检索此类状态信息。

在某些方面,Ima 包的对象属性内核过程与 Ema 包中的过程类似(见 External Interfaces 手册)。Ima 过程接受与 Ema 相同的对象属性名称,以及通过 void* 接口传递的相同类型的值。不过,Ima 内核过程一次只提供一个对象属性的访问(不支持 Ema 的 ACV 三元组特性)。此外,仿真对象标识方案与 Ema 使用的方案不同。

对象通常只由于中断而采取行动(更准确地说,仿真内核通常只在某个对象收到某种类型中断时,才执行与该对象关联的代码)。然而,模块可以执行若干通过远程调用完成、不涉及标准远程中断设施的动作。由于所支持的动作是对象特定的,且支持这种调用的模块不包括处理器或队列,因此没有为该活动定义用户可见的中断类型。内核过程 op_ima_obj_command() 提供远程动作调用设施,通过命令字符串指定要执行的动作。

除对象属性外,进程有时也需要远程访问另一个进程的内部状态变量(用于查询或赋值)。通过远程访问状态变量可获得另一种形式的进程间通信,该服务由内核过程 op_ima_obj_svar_get() 提供。

内核过程 op_ima_obj_attr_get() 为获取整数、double 和字符串属性值提供了便捷接口。然而,该接口在获取节点对象位置时效率不高,因为涉及六个不同的属性。此外,子网内节点的相对位置属性需要转换为地心坐标系。为此提供了一种替代接口,即单个内核过程 op_ima_obj_pos_get(),它一次查询全部六个位置相关属性,并自动为子网节点执行坐标转换。

使用无线建模时,移动站点(节点和子网)的位置会随时间变化。内核过程 op_ima_obj_pos_get_time() 执行与 op_ima_obj_pos_get() 相同的功能,但针对指定时间(当前或未来)。对于沿轨迹或向量移动的移动站点,这些内核过程获得的位置是精确的。对于其他站点,获得的位置只是该站点最后设置的位置。内核过程 op_ima_obj_pos_query_proc_set() 指定一个自定义过程,用于定义不沿轨迹或向量移动的站点的精确位置。若进程模型需要知道站点何时改变位置,内核过程 op_ima_obj_pos_notification_register() 可以设置站点在其位置变化时产生中断。

可以使用 op_ima_obj_pos_set_geocentric() 和 op_ima_obj_pos_set_geodetic() 在地心或大地坐标系中设置移动站点的位置。