环境文件

环境文件机制可以把多个偏好设置赋值打包在一起,作为一个整体传递给程序。环境文件是 ASCII 文本文件,具有简单的赋值语法。通常,环境文件的每一行对应一个偏好设置的赋值。环境文件的赋值语法见下表。

表 13:环境文件赋值语法

类型 语法 示例
integer <attr_name>: <int_value> size: 345
double <attr_name>: <double_value> mean_anomaly: 214.6
string <attr_name>: <string_value> orb_name: statkeep
site_name: "QTH"
boolean <attr_name>: <boolean_value> verbose: OFF
verbose: TRUE

在环境文件中,偏好设置名、冒号分隔符和偏好设置值之间可以有任意数量的空白字符。实际上,赋值可以跨多行书写。文件中也可以出现注释,采用 shell 脚本的标准,用井号开始注释("#" 可以出现在行的任意位置,无论该行是否有赋值)。

下图展示了一个带注释的环境文件片段。

图 9:环境文件示例

orb_name:       low_earth
elem_type:      osc

sm_axis:        6700.0
eccen:          0.02
inclin:         30

start_date:     1989.01.01
start_time:     0.0.0.0
stop_date:      1989.01.01
stop_time:      12.0.0.0

time_step:      60.0

moon_effects:   on
sun_effects:    on
srp_effects:    off     # this is off for speed
drag_effects:   on

使用环境文件为列表型偏好设置赋值一系列值时,需要使用分隔符分隔各个取值;分隔符是逗号(",")。下面给出了通过环境文件赋值字符串列表偏好设置的示例。在该示例中,ef 偏好设置将被赋值为三个字符串("base_orb_defs"、"low_earth_defs" 和 "options")。

ef: base_orb_defs, low_earth_defs, options

在环境文件中,包含嵌入空格的偏好设置名必须用引号括起来:

"HLA Federate Name" : OPNET

环境文件可以使用文本编辑器创建。文件名必须附加 .ef 文件类型后缀,才能被识别为环境文件:

polar.ef
equatorial.ef

为了可被访问,环境文件必须放置在 mod_dirs 偏好设置所引用的某个模型目录中。将环境文件传递给程序只能通过 -ef 标志实现;其后的参数中不应包含环境文件的类型后缀。

op_vuorb -ef polar

注意: 产品专用环境文件(modeler.ef)位于 <reldir>/sys/configs/global_prefs 目录。通常,你不需要修改这个环境文件。