环境文件
环境文件机制可以把多个偏好设置赋值打包在一起,作为一个整体传递给程序。环境文件是 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: statkeepsite_name: "QTH" |
| boolean | <attr_name>: <boolean_value> |
verbose: OFFverbose: 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 目录。通常,你不需要修改这个环境文件。