外部接口

本节包含从程序外部与 Riverbed 交互所需的信息,包括

有关 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: “”

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com