概述#
od2trips 导入 O/D 矩阵（起讫点矩阵）并将其拆分为单个车辆行程。
- 目的： 将 O/D 矩阵转换为单个车辆行程
- 系统： 可移植（已在 Linux/Windows 上测试）；在命令行运行
- 输入（强制）：
- A) O/D 矩阵
- B) 一组交通分区（districts）
- 输出： 车辆行程定义列表
- 编程语言： C++
使用说明#
od2trips 将通过起点和终点区域定义的交通量映射到网络的边上。详情请参见 Demand/Importing_O/D_Matrices。
选项#
您可以使用 XML 模式定义文件来设置 od2trips 配置： od2tripsConfiguration.xsd。
配置#
SUMO 套件的所有应用程序都以相同的方式处理配置选项。这些选项在 Basics/Using the Command Line Applications#Configuration Files 中讨论。
| 选项 | 描述 |
|---|---|
| -c <FILE> --configuration-file <FILE> |
启动时加载指定的配置文件 |
| -C <FILE> --save-configuration <FILE> |
将当前配置保存到文件 |
| --save-configuration.relative <BOOL> | 保存配置时强制使用相对路径；默认值： false |
| --save-template <FILE> | 将配置模板（空）保存到文件 |
| --save-schema <FILE> | 将配置模式保存到文件 |
| --save-commented <BOOL> | 向保存的模板、配置或模式添加注释；默认值： false |
输入#
| 选项 | 描述 |
|---|---|
| -n <FILE> --taz-files <FILE> |
从文件加载 TAZ（交通分区；也可从网络加载） |
| -d <FILE> --od-matrix-files <FILE> |
从文件加载 O/D 文件 |
| --od-amitran-files <FILE> | 从文件加载 Amitran 格式的 O/D 矩阵 |
| -z <FILE> --tazrelation-files <FILE> |
从文件加载 tazRelation 格式的 O/D 矩阵 |
| --tazrelation-attribute <STRING> | 定义用于加载计数的数据属性（默认 'count'）；默认值： count |
输出#
| 选项 | 描述 |
|---|---|
| --write-license <BOOL> | 将许可证信息包含到每个输出文件中；默认值： false |
| --write-metadata <BOOL> | 写入可解析的元数据（配置等）而不是注释；默认值： false |
| --output-prefix <STRING> | 应用于所有输出文件的前缀。特殊字符串 'TIME' 将被当前时间替换。 |
| --precision <INT> | 定义浮点数输出的小数点后位数；默认值： 2 |
| --precision.geo <INT> | 定义经度、纬度输出的小数点后位数；默认值： 6 |
| --output.compression <STRING> | 定义标准压缩算法（目前仅用于 parquet 输出） |
| --output.format <STRING> | 定义无法从文件名推导时的标准输出格式（'xml', 'csv', 'parquet'）；默认值： xml |
| --output.column-header <STRING> | 如何从属性名推导列头（'none', 'tag', 'auto', 'plain'）；默认值： tag |
| --output.column-separator <STRING> | CSV 输出中的分隔符；默认值： ; |
| -H <BOOL> --human-readable-time <BOOL> |
将时间值写为 小时:分钟:秒 或 天:小时:分钟:秒，而不是秒数；默认值： false |
| -o <FILE> --output-file <FILE> |
将行程定义写入文件 |
| --flow-output <FILE> | 将流量定义写入文件 |
| --flow-output.probability <BOOL> | 写入概率流量而不是均匀间隔的流量；默认值： false |
| --pedestrians <BOOL> | 写入行人而不是车辆；默认值： false |
| --persontrips <BOOL> | 写入 persontrips 而不是车辆；默认值： false |
| --persontrips.modes <STRING[ ]> | 向 personTrips 添加 modes 属性 |
| --ignore-vehicle-type <BOOL> | 不保存 vtype 信息；默认值： false |
| --junctions <BOOL> | 写入路口之间的行程；默认值： false |
时间#
| 选项 | 描述 |
|---|---|
| -b <TIME> --begin <TIME> |
定义开始时间；之前的行程将被丢弃；默认值： 0 |
| -e <TIME> --end <TIME> |
定义结束时间；之后的行程将被丢弃；默认为 SUMO 可表示的最大时间；默认值： -1 |
处理#
| 选项 | 描述 |
|---|---|
| -s <FLOAT> --scale <FLOAT> |
按浮点数缩放加载的流量；默认值： 1 |
| --spread.uniform <BOOL> | 在每个时间段内均匀分布行程；默认值： false |
| --different-source-sink <BOOL> | 始终选择不相同的源边和汇边；默认值： false |
| --vtype <STRING> | 定义要使用的车辆类型的名称 |
| --prefix <STRING> | 定义车辆名称的前缀 |
| --timeline <STRING[ ]> | 使用 STR[] 作为时间线定义 |
| --timeline.day-in-hours <BOOL> | 使用 STR 作为 24 小时时间线定义；默认值： false |
| --no-step-log <BOOL> | 禁用当前时间步的控制台输出；默认值： false |
默认值#
| 选项 | 描述 |
|---|---|
| --departlane <STRING> | 分配默认出发车道；默认值： free |
| --departpos <STRING> | 分配默认出发位置 |
| --departspeed <STRING> | 分配默认出发速度；默认值： max |
| --arrivallane <STRING> | 分配默认到达车道 |
| --arrivalpos <STRING> | 分配默认到达位置 |
| --arrivalspeed <STRING> | 分配默认到达速度 |
报告#
SUMO 套件的所有应用程序都以相同的方式处理大多数报告选项。这些选项在 Basics/Using the Command Line Applications#Reporting Options 中讨论。
| 选项 | 描述 |
|---|---|
| -v <BOOL> --verbose <BOOL> |
切换到详细输出；默认值： false |
| --print-options <BOOL> | 在处理前打印选项值；默认值： false |
| -? <BOOL> --help <BOOL> |
打印此屏幕或选定主题；默认值： false |
| -V <BOOL> --version <BOOL> |
打印当前版本；默认值： false |
| -X <STRING> --xml-validation <STRING> |
设置 XML 输入的模式验证方案（"never", "local", "auto" 或 "always"）；默认值： local |
| -W <BOOL> --no-warnings <BOOL> |
禁用警告输出；默认值： false |
| --aggregate-warnings <INT> | 当同一类型的警告超过 INT 次时进行聚合；默认值： -1 |
| -l <FILE> --log <FILE> |
将所有消息写入文件（隐含 verbose） |
| --message-log <FILE> | 将所有非错误消息写入文件（隐含 verbose） |
| --error-log <FILE> | 将所有警告和错误写入文件 |
| --log.timestamps <BOOL> | 在所有消息前写入时间戳；默认值： false |
| --log.processid <BOOL> | 在所有消息前写入进程 ID；默认值： false |
| --language <STRING> | 消息中使用的语言；默认值： C |
| --ignore-errors <BOOL> | 在输入损坏时继续；默认值： false |
随机数#
SUMO 套件的所有应用程序都以相同的方式处理随机化选项。这些选项在 Basics/Using the Command Line Applications#Random Number Options 中讨论。
| 选项 | 描述 |
|---|---|
| --random <BOOL> | 使用当前系统时间初始化随机数生成器；默认值： false |
| --seed <INT> | 使用给定值初始化随机数生成器；默认值： 23423 |
注意事项#
- 选项 --vtype 仅在使用 "--od-matrix-files" 时有效。对于 "Amitran" 格式，该值由 "actorConfig" 的 "id" 属性给出。
- 使用 netedit 可以观察基于边或基于 TAZ 的关系的需求量分布 network/TAZ related data。