外部接口
本节包含从程序外部与 Riverbed 交互所需的信息,包括
- Terrain Modeling Module 偏好设置
- Terrain Modeling Module 状态消息
- Terrain Modeling Module 文件类型
- ETS Operations
- EMA Support
有关 TMM 所支持 API 的说明,参见 Discrete Event Simulation API Reference Manual 第 23 章 “TMM Package”(第 1 页)。
Terrain Modeling Module 偏好设置
Terrain Modeling Module 在以下程序中新增或修改了偏好设置。
Modeler Preferences
Terrain Modeling Module 为 Modeler 添加了以下偏好设置。这些偏好设置同样可供 op_runsim 程序使用。
Enable Terrain Modeling Cache
指定仿真是否应使用 TMM 缓存系统。TMM 缓存保存路径损耗计算的结果,因此两个特定点之间的路径损耗只需计算一次。更多细节参见 “复用路径损耗计算”(第 23 页)。
如果点的位置频繁变化,缓存可能变得非常大并消耗可用内存。如果这成为问题,请将此属性设为 FALSE。
- Tag:
tmm_use_cache - Data Type: boolean
- Default Value: TRUE
Enable Terrain Modeling Module for Simulations
为 TRUE 时,指定仿真应使用 TMM 传播模型和地形数据。
- Tag:
tmm_simulate - Data Type: boolean
- Default Value: FALSE
Generate Detailed Status
指定 TMM 路径损耗计算是否应提供详细消息。如果将此属性设为 TRUE,详细消息将出现在仿真日志中。
- Tag:
tmm_verbose - Data Type: boolean
- Default Value: FALSE
Load Terrain Data Only As Needed
为 TRUE 时,指定仿真仅在需要时加载地形源。为 FALSE 时,指定在选择或检查地形规格时即加载地形源。
- Tag:
tmm_load_as_needed - Data Type: boolean
- Default Value: TRUE
Location of Terrain Data
指定地形数据文件所在的目录。该值由 Specify Terrain Data Directory 操作自动设置。(此偏好设置已被 Terrain Specification File 偏好设置取代。)
- Tag:
tmm_data_directory - Data Type: string
- Default Value: none
Pathloss Cache Size
指定路径损耗缓存可使用的最大内存量(以 MB 计)。两个点之间路径损耗的每个缓存条目约占 70 字节内存。
- Tag:
tmm_pathloss_cache_size - Data Type: integer
- Default Value: 2
- Units: megabytes
Profile Sample Count Setting
控制 View Terrain Profile 对话框中使用的采样点数。为正值时,定义对话框中使用的采样值数量。为负值时,其绝对值表示采样点之间的近似距离(以米计)。
- Tag:
tmm_profile_max_sample_count - Data Type: integer
- Default Value: 100
Propagation Specification File
指定包含当前工程传播信息的 .propag.xml 文件名。
- Tag:
tmm_propagation_specification - Data Type: string
- Default Value: “”
Terrain File Cache Size
指定为每个多文件地形源(如 DTED 和 DEM)保留在内存中的文件数。保留更多文件可使地形操作快得多,但会消耗大量内存。(如果设置了 Terrain Specification File 偏好设置,则不使用此偏好设置。)
- Tag:
tmm_terrain_cache_size - Data Type: integer
- Default Value: 10
Terrain Data Type
指定要读取的数据文件类型。该值由 Specify Terrain Data Directory 操作自动设置。(此偏好设置已被 Terrain Specification File 偏好设置取代。)
- Tag:
tmm_data_type - Data Type: enum
- Default Value: USGS DEM
- Constraints: DTED, USGS DEM, OpenFlight, MetaFlight
Notes:
- OpenFlight and MetaFlight require a 3DNV license
- OpenFlight and MetaFlight supported only on 32-bit Windows
Terrain Propagation Zone Ratio
指定一条路径必须穿过某区域的最小百分比,只有满足该百分比时,该区域的传播模型才会被考虑用于路径损耗计算。(详情参见 “创建传播规格”(第 13 页)。)默认值 0 表示只要区域包含至少一个点就会被考虑。
- Tag:
tmm_propagation_zone_ratio - Data Type: integer
- Default Value: 0
Terrain Propagation Zone Resolution
指定用于评估区域的沿路径点数。使用更多点可获得更准确的区域选择,但会增加路径损耗计算所需的时间。(关于区域选择的详情,参见 “创建传播规格”(第 13 页)。)
- Tag:
tmm_propagation_zone_resolution - Data Type: integer
- Default Value: 100
Terrain Specification File
指定包含当前工程地形信息的 .terrain.xml 文件名。
- Tag:
tmm_terrain_specification - Data Type: string
- Default Value: “”
Terrain Handler Preferences
以下偏好设置定义在所提供的地形处理器中。
tmm_data_suffix_prefer
指定当多个文件覆盖相同区域时数据文件的首选后缀。此偏好设置适用于 DTED 地形。
- Data Type: string
- Default Value: dt0
tmm_dted_elev_integer_format
指定 DTED 文件中负数的存储方式。此偏好设置适用于 DTED 地形。
- Data Type: enum
- Default Value: sign_magnitude
- Constraints: sign_magnitude, ones_complement, twos_complement
tmm_openflight_resolution
指定 OpenFlight 地形数据库中相邻高程值之间的距离(在赤道处测量)。此偏好设置适用于 Openflight 地形。
- Data Type: integer
- Default Value: 10
- Units: meters
op_mkso Preferences
TMM 按如下方式修改 op_mkso 的 “type” 偏好设置。
type
Terrain Modeling Module 将 “tmm” 和 “terrain” 添加到该偏好设置的支持值中。
- Data Type: string
- Default Value: ets
- Units: none
- Constraints: ets, repos, tmm, da, nvism, antn, terrain
op_runsim Preferences
Terrain Modeling Module 为 op_runsim 程序添加了以下偏好设置。
tmm_prop_model
指定要使用的传播模型名称。(此偏好设置已被 Propagation Specification File 偏好设置取代。)
- Data Type: string
- Default Value: “”
tmm_prop_param
指定要使用的传播模型参数集名称。(此偏好设置已被 Propagation Specification File 偏好设置取代。)
- Data Type: string
- Default Value: “”