Time Visualization 子包
此子包包含与网络模型时间可视化能力相关的 API。因此,这些函数是在 Project Editor 的上下文中调用的,而不是在离散事件仿真期间调用。关于网络时间如何建模的说明,见“Network Time: Calendar, Relative, and Network Start Times“(第 329 页)。关于时间可视化 GUI 的说明,见“Show Time Controller“(第 178 页)。
每个网络模型都可以定义一个起始时间,把仿真时间对应到日历时间中的某个时刻。网络起始时间(同时指定日期和时间)的类型为 PrgT_Date,以相对于操作系统纪元时间(epoch time)的秒偏移量表示起始时间(与 C 语言 time_t 的行为类似)。你可以用 Ets_Nt_Time_Base_Get() 确定网络的起始时间,用 Ets_Nt_Time_Base_Set() 设置起始时间。
当用户选择基于时间可视化网络时,他们可以做的事情之一是根据不同的值设置起始时间、结束时间和步长间隔。Riverbed Modeler 从为支持特定数据集而编写的插件获取这些值。例如,Flow Analysis 模块可能提供一个或多个提供此信息的插件。此外,你还可以开发自定义插件并使其可用。你可以用 Ets_Nt_Time_Settings_Plugin_Set() 指定要使用的默认插件。
插件是一组函数,GUI 用它们查找一组数据的起始时间、结束时间和时间间隔。插件由两个文件组成:注册所有必需回调函数的时间设置文件,以及实现这些回调的库。两个文件都必须位于 “mod_dirs“ 首选项列出的目录中。
时间设置文件是扩展名为 .tsf 的文本文件,包含一个或多个插件描述,形式如下例所示:
start_plugin_definition
plug-in tag: flan
source name: Flow Analysis
library: flan_plugins
include proc: flan_time_slider_settings_include_proc
range query proc: flan_time_slider_settings_range_query_proc
step query proc: flan_time_slider_settings_step_query_proc
end_plugin_definition
各定义元素的含义如下:
- plug-in tag——用于查找特定插件的唯一标识
- source name——向用户说明时间值由哪个功能生成的友好名称
- library——包含插件所有函数的库名
- include proc——用作 include 回调的函数名。其原型见
EtsT_Nt_Time_Settings_Include_Callback。 - range query proc——用作 range query 回调的函数名。其原型见
EtsT_Nt_Time_Slider_Range_Query_Callback。 - step query proc——用作 step query 回调的函数名。其原型见
EtsT_Nt_Time_Slider_Step_Query_Callback。
当用户更改网络模型所可视化的时间时,网络的状态或外观可能需要各种变化。你可以用 Ets_Nt_Time_Change_Callback_Register() 定义一个或多个回调来管理这些变化,用 Ets_Nt_Time_Change_Callback_Deregister() 移除不再需要的回调。你可以用 Ets_Nt_Time_Offset_Current_Get() 确定当前可视化的时间,或用 Ets_Nt_Time_Offset_Current_Set() 设置可视化的时间。
用户更改所可视化的时间时可能发生变化的事情之一,是移动节点和子网的位置。你可以用 Ets_Nt_Site_Geocentric_Position_Get()、Ets_Nt_Site_Geodetic_Position_Get() 和 Ets_Nt_Site_Local_Position_Get() 获取某个站点在指定时间的位置。要获取移动对象的当前位置,使用 Ets_Nt_Trajectory_Position_Get()。