为 HLA 配置 Logger

本节说明如何为 HLA 演习配置 Logger。有关在 GUI 中配置连接设置的详细信息,请参阅编辑连接。

大多数 HLA 连接设置可以通过单独的命令行选项,或在文本界面中使用 SetConnectionParameters 命令来设置。

SetConnectionParameters 针对 HLA 1.3 和 HLA 1516 的语法为:

SetConnectionParameters federateName federationName fedFile ignoreAdvisories fomVersion fomRevision fomMapper fomMapperData useEmptyFomMapper

例如:

SetConnectionParameters Logger VR-Link VR-Link.fed False 1.0 1 myFomMapper "myInitParameter1 myInitParameter2 …" False

当你使用 SetConnectionParameters 命令时,你必须指定所有参数,无论你是否想将它们从默认值更改。例如,如果你只想更改 Logger 联邦成员的名称,即使它是列表中的第一个参数,你仍然必须输入一条完整的命令,如下所示:

SetConnectionParameters myLogger VR-Link VR-Link.fed "" 1.0 1 "" "" ""

有关命令和命令语法的详细信息,请参阅第 33 章“使用用于 3DNV 的 Multi-Federate Logger 命令”(第 467 页)。

指定 Logger 联邦成员的名称

默认情况下,Logger 联邦成员的名称为 Logger。

要指定联邦成员名称,使用 -N 命令行选项或 SetConnectionParameters 命令(表 10)。

表 10:指定 Logger 联邦成员

界面 命令
GUI Connection 对话框:Federate Name 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -N myLogger
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml federateName 变量位于默认配置文件中。

指定联邦执行名称

默认情况下,Logger 使用联邦执行名称 VR-Link。

**注意:**默认情况下,Logger 假定联邦配置文件(FED、FDD)文件与联邦执行同名,并加上相应的扩展名。有关详细信息,请参阅指定 FED 文件。

要指定联邦执行名称,使用 -x 命令行选项或 SetConnectionParameters 命令(表 11)。

表 11:指定联邦执行

界面 命令
GUI Connection 对话框:Exercise Name 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -x VR-Link
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml execName 变量位于默认配置文件中。

指定 FED 文件

默认情况下,Logger 使用名为 VR-Link.fed 的 FED 文件。Logger 也接受带有 .fdd 和 .xml 扩展名的联邦描述文件。Riverbed 产品为它们所支持的每个 RPR FOM 版本都附带一个 FED(和 XML)文件。

要指定 FED 文件,使用 -F 命令行选项或 SetConnectionParameters 命令(表 12)。

表 12:指定 FED 文件

界面 命令
GUI Connection 对话框:FED File Name 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -F VR-Link20017-1.fed
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml fedFileName 变量位于默认配置文件中。

指定 RPR FOM 版本

Logger 内置支持 RPR FOM。默认版本为 1.0。你可以指定不同的 RPR FOM 版本(0.5、0.7、0.8、2.0006、2.0014 或 2.0017)。如果你指定了非默认的 RPR FOM 版本,你还必须指定正确的 FED 文件。

要指定 RPR FOM 版本,使用 --rprFomVersion 命令行选项或 SetConnectionParameters 命令(表 13)。

表 13:指定 RPR FOM 版本

界面 命令
GUI Connection 对话框:Use RPR FOM 选项和 RPR FOM Version 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = --rprFomVersion 2.0017 -F VR-Link20017-1.fed
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml rprFomVersion 变量位于默认配置文件中。

指定 RPR FOM 修订版

如果你使用 RPR FOM 版本 2 草案 17,你可以指定 RPR FOM 修订版(1、2 或 3)。这些修订编号仅适用于 RPR FOM 2.0017。不同修订版可以使用相同的 FED 文件;只有数据格式会改变。默认值:1。

要指定 RPR FOM 修订版,使用 --rprFomRevision 命令行选项或 SetConnectionParameters 命令(表 14)。

表 14:指定 RPR FOM 修订版

界面 命令
GUI Connection 对话框:Use RPR FOM 选项和 RPR FOM Revision 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = --rprFomVersion 2.0017 --rprFomRevision 1 -F VR-Link20017-1.fed
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml rprFomRevision 变量位于默认配置文件中。

忽略咨询消息

要让 Logger 忽略咨询消息,使用 SetIgnoreAdvisories 命令(表 15)。

表 15:指定对咨询消息的响应

界面 命令
GUI Connection 对话框:选择 Ignore Advisories。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = --ignoreAdvisories 1
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令,或使用 SetIgnoreAdvisories true。
lgrConfig.xml ignoreAdvisories 变量位于默认配置文件中。
你也可以将 SetIgnoreAdvisories 添加到配置文件。

指定 FOM Mapper

Logger 通过 VR-Link FOM Mapper 支持不同的 FOM。Logger 根据以下标准选择 FOM Mapper:

  • 如果指定了 FOM mapper 库,则使用它。
  • 如果指定了 Use Empty FOM Mapper,则使用空的 FOM Mapper。
  • 如果前两个选项都未指定,则使用默认的 RPR FOM FOM Mapper。

**注意:**你可以通过 rprFomVersion 参数指定的不同 RPR FOM 版本,实际上是指定随 Logger 提供的若干默认 FOM Mapper 之一。

要指定 FOM Mapper,使用 -f 命令行选项或 SetConnectionParameters 命令(表 16)。

表 16:指定 FOM Mapper

界面 命令
GUI Connection 对话框:选择 Use Custom FOM 并指定 FOM Mapper Library,以及可选的 Initialization String。
如果你使用的 FOM 不是 RPR FOM 的派生版本,且没有合适的 FOM Mapper 库可用,则选择 Use Empty FOM Mapper。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -f myFomMapper.dll
op_3dlog_launcher_<hla_version>.exe
或
set OP_3DNV_LOGGER_EXTRA_ARGS = --useEmptyFomMapper 1
op_3dlog_launcher_<hla_version>.exe
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml fomMapperLib 和 useEmptyFomMapper 变量位于默认配置文件中。

指定与 FOM Mapper 相匹配的 FED 文件

注意:-f 选项只是告诉应用程序使用哪个 FOM Mapper。它并不能确保你为该 FOM Mapper 使用了正确的 FED 文件。请确保你使用的 FED 文件与所选的 FOM Mapper 一致。

默认情况下,Logger 使用名为 VR-Link.fed 的 FED 文件,但你可以使用 -F 选项指定一个备用 FED 文件。

以下示例指示应用程序使用一个替代的 FOM Mapper 和 FED 文件:

set OP_3DNV_LOGGER_EXTRA_ARGS = -f myFomMapper -F myFedFile.fed
op_3dlog_launcher_<hla_version>.exe

指定 FOM Mapper 初始化数据

某些 FOM Mapper 需要初始化数据。

要指定 FOM Mapper 初始化数据,使用 --fomMapperInitData 命令行选项或 SetConnectionParameters 命令(表 17)。

表 17:指定 FOM Mapper 初始化数据

界面 命令
GUI Connection 对话框:将 Use FOM Mapper 设置为 True,指定 FOM Mapper File,并设置 FOM Mapper Init Data 属性。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -f myFomMapper.dll --fomMapperInitData ABC
op_3dlog_launcher_<hla_version>.exe
其中 ABC 作为初始化参数传递给共享库中的 FOM Mapper 创建函数。
文本界面 使用 SetConnectionParameters 命令。
lgrConfig.xml fomMapperInitData 变量位于默认配置文件中。

配置时间管理

Logger 支持时间约束记录和时间调节回放。要在 Logger 中配置时间管理,必须在你的 RTI 中启用它。如果 RTI 中未启用时间管理,则 Preferences 对话框中不可用这些配置选项。

过程 140:在 GUI 中配置时间管理

  1. 选择 Options > Preferences。Preferences 对话框将打开(图 124)。

    图 124:HLA 的 Preferences 对话框

    HLA 的 Preferences 对话框

  2. 要将 Logger 配置为时间约束型联邦成员,在 HLA Configuration 分组框中,将 Time Constrained 值设置为 Recording。

  3. 要将 Logger 配置为时间调节型联邦成员,在 HLA Configuration 分组框中,将 Time Regulating 值设置为 Playback。

  4. 可选:设置 Lookahead 值。

  5. 单击 OK。

要从命令界面指定时间管理,使用 SetTimeManagement 命令(表 18)。

表 18:指定时间管理

界面 命令
GUI 见本节中的过程。
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -r "SetTimeManagement true false false true 0.5"
op_3dlog_launcher_<hla_version>.exe
文本界面 SetTimeManagement true false false true 0.5
lgrConfig.xml 将 SetTimeManagement 添加到配置文件。

指定 Logger 订阅列表

默认情况下,Logger 订阅你 FED 文件中的所有类,但 RTIPrivate 以及任何 MOM 对象或交互除外。不过,你可以通过在命令中列出这些类和交互,或创建订阅控制列表,来指定 Logger 订阅的类和交互集合。

创建订阅控制列表

在 Logger GUI 中,你可以指定要订阅的类列表,并可以将该列表保存到文件。

过程 141:在 GUI 中创建订阅控制列表

  1. 选择 Options > Preferences。Preferences 对话框将打开(图 124)。

  2. 在 HLA Configuration 分组框中,单击 Edit。Change HLA Class Subscription 对话框将打开(图 125)。该对话框有一个列出对象类的选项卡和一个列出交互类的选项卡。名称旁带有勾选标记的类会被过滤掉。

    图 125:Change HLA Class Subscription 对话框

    Change HLA Class Subscription 对话框

  3. 通过为要过滤掉的类勾选 Filtered 列中的复选框来编辑订阅列表。

  4. 单击 OK。订阅列表将在你下次进入记录模式时生效。

要在命令界面指定订阅列表,使用 SetSubscriptionLists 命令(表 19)。

表 19:指定订阅列表

界面 命令
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -r "SetSubscriptionLists \"ObjectRoot.BaseEntity.PhysicalEntity.Platform.Aircraft ObjectRoot.BaseEntity.PhysicalEntity.Radio InteractionRoot.WeaponFire\""
op_3dlog_launcher_<hla_version>.exe
文本界面 SetSubscriptionLists "ObjectRoot.BaseEntity.PhysicalEntity.Platform.Aircraft ObjectRoot.BaseEntity.PhysicalEntity.Radio InteractionRoot.WeaponFire"
lgrConfig.xml 将 SetSubscriptionLists 添加到配置文件。有关向配置文件添加字符串列表的详细信息,请参阅“将字符串列表添加到 lgrConfig.xml”(第 401 页)。
注意—— SetSubscriptionLists 命令必须位于 Connect 命令之后。

保存订阅列表

过程 142:在 GUI 中保存订阅列表

  1. 按照“指定 Logger 订阅列表”中的说明编辑订阅列表。
  2. 在 Change HLA Class Subscription 对话框中,单击 Save。Save As 对话框将打开。
  3. 输入订阅列表的名称并单击 Save。默认情况下,订阅列表以 .subx 扩展名保存在相应的 bin 目录中。

要在命令界面保存订阅列表,使用 SaveSubscriptionListFile 命令(表 20)。

表 20:保存订阅列表

界面 命令
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -r "SaveSubscriptionListFile mySubList.subx"
op_3dlog_launcher_<hla_version>.exe
文本界面 SaveSubscriptionListFile mySubList.subx

加载订阅列表

过程 143:在 GUI 中加载订阅列表

  1. 在 Change HLA Class Subscription 对话框中,单击 Load。Open 对话框将打开。
  2. 选择你要加载的订阅列表文件。
  3. 单击 Open。
  4. 单击 OK 以应用订阅列表。

要在命令界面加载订阅列表,使用 LoadSubscriptionListFile 命令(表 21)。

表 21:加载订阅列表

界面 命令
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -r "LoadSubscriptionListFile \"../config/mySubList.subx\""
op_3dlog_launcher_<hla_version>.exe
文本界面 LoadSubscriptionListFile ../config/mySubList.subx
lgrConfig.xml 将 LoadSubscriptionListFile 添加到配置文件。

被动订阅对象与交互

Logger 可以被动订阅对象和交互。在被动模式下,Logger 记录其他联邦成员所订阅的更新。它不订阅任何特定的对象或交互。如果你想使用被动订阅,必须在连接到演习之前指定它。

要让 Logger 被动订阅,使用 SetPassiveSubscription 命令(表 22)。

表 22:指定被动订阅

界面 命令
命令行 set OP_3DNV_LOGGER_EXTRA_ARGS = -r "SetPassiveSubscription true"
op_3dlog_launcher_<hla_version>.exe
文本界面 SetPassiveSubscription true
lgrConfig.xml 将 SetPassiveSubscription 添加到配置文件。

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · 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