• 符号说明
符号说明

本文档使用颜色来区分不同类型的信息。下文将对这些注释和颜色进行说明。

命令行#

如果你遇到类似下面的内容：

netconvert --visum=MyVisumNet.inp --output-file=MySUMONet.net.xml

你应该知道这是在命令行中的调用。行尾可能还会有 \\。这表示你需要在不按回车键的情况下继续输入（忽略 \\ 及其后的换行符）。下面的示例与上面的示例完全相同：

netconvert --visum=MyVisumNet.inp \
  --output-file=MySUMONet.net.xml

应用程序选项#

命令行选项名称通常以 这种样式 着色。它们的值以 ** <这种样式> ** 着色。

XML 示例#

XML 元素和属性显示为 这种样式。如果它们的值是变量，则显示为 <这种样式>。

XML 文件的完整示例如下所示：

<myType>
  <myElem myAttr1="0" myAttr2="0.0"/>
  <myElem myAttr1="1" myAttr2="-500.0"/>
</myType>

引用的数据类型#

  • <BOOL>: 布尔值，使用 "t" 或 "true" 以及 "f" 或 "false" 进行编码
  • <INT>: 整数值，可以为负数
  • <UINT>: 无符号整数值，必须 >=0
  • <FLOAT>: 浮点数
  • <TIME>: 时间，以秒为单位；允许小数，例如 "12.1"
  • <STRING>: 任意字符串，但仅使用 ASCII 字符
  • <STRING[ ]>: 逗号分隔的字符串列表

  • <ID>: 一个字符串，不得包含以下字符：'#'

    Caution

    不允许的字符列表不完整

  • <FILE> 或 <FILENAME>: 文件的（相对或绝对）路径；另请参阅 #引用的文件类型
  • <PATH>: （相对或绝对）路径（通常指向文件夹）
  • <COLOR>: 由 ',' 分隔的四个浮点数 (<FLOAT>,<FLOAT>,<FLOAT>,<FLOAT>)，分别描述红、绿、蓝和 alpha 分量，范围从 0.0 到 1.0（alpha 分量是可选的），或者列表中可以包含 0-255 范围内的整数。请注意，分隔符必须是逗号，且不允许有空格。该颜色也可以使用单个字符串定义，该字符串包含 HTML 颜色代码 或基本颜色之一（"red", "green", "blue", "yellow", "cyan", "magenta", "black", "white", "grey"）。"random" 值将分配一个随机颜色。
  • <2D-POSITION>: 由 ',' 分隔的两个浮点数 (<FLOAT>,<FLOAT>)，分别描述 x 和 y 偏移量。z 隐式为 0
  • <3D-POSITION>: 由 ',' 分隔的三个浮点数 (<FLOAT>,<FLOAT>,<FLOAT>)，分别描述 x、y 和 z 偏移量
  • <POSITION-VECTOR>: 由 ' ' 分隔的 2D 或 3D 位置列表。即 (<2D-POSITION> <2D-POSITION>,<3D-POSITION>)
  • <2D-BOUNDING_BOX>: 由 ',' 分隔的四个浮点数 (<FLOAT>,<FLOAT>,<FLOAT>,<FLOAT>)，分别描述 x-minimum、y-minimum、x-maximum 和 y-maximum
  • <PROJ_DEFINITION>: 一个包含 proj.4 所使用的投影定义的字符串；请注意，你必须将定义字符串用引号括起来

引用的文件类型#

其他符号#

方括号 '[' 和 ']' 表示其中包含的信息是可选的。尖括号 '<' 和 '>' 表示一个变量 - 在此处插入你自己的值。

<SUMO_HOME> 是你保存 SUMO 软件包的路径。