概述#
activitygen 读取一个人口定义，该人口需匹配给定的路网。它会计算该人口的出行需求。
- 目的： 为合成人口生成需求
- 系统： 可移植（已测试 Linux/Windows）；在命令行运行
-
输入（必需）：
A) 通过 netconvert 或 netgenerate 生成的路网，参见 构建路网
B) 人口定义，参见 基于活动的需求生成
- 输出： 车辆、车辆类型和路径的定义，可被 sumo 使用
- 编程语言： C++
使用说明#
使用 activitygen 的分步说明可在此处找到 这里
选项#
您可以使用 XML 模式定义文件来设置 activitygen 配置： activitygenConfiguration.xsd.
配置#
SUMO 套件的所有应用程序处理配置选项的方式相同。这些选项在 Basics/Using the Command Line Applications#Configuration Files 中讨论。
| 选项 | 描述 |
|---|---|
| -c <FILE> --configuration-file <FILE> |
启动时加载指定的配置文件 |
| -C <FILE> --save-configuration <FILE> |
将当前配置保存到 FILE |
| --save-configuration.relative <BOOL> | 保存配置时强制使用相对路径；默认值： false |
| --save-template <FILE> | 将配置模板（空）保存到 FILE |
| --save-schema <FILE> | 将配置模式保存到 FILE |
| --save-commented <BOOL> | 向保存的模板、配置或模式添加注释；默认值： false |
输入#
| 选项 | 描述 |
|---|---|
| -n <FILE> --net-file <FILE> |
使用 FILE 作为 SUMO 路网来创建行程 |
| -s <FILE> --stat-file <FILE> |
加载 SUMO 统计文件 FILE |
输出#
| 选项 | 描述 |
|---|---|
| --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> |
将生成的行程写入 FILE |
时间#
| 选项 | 描述 |
|---|---|
| -b <INT> --begin <INT> |
设置第一天模拟开始的时间（秒）；默认值： 0 |
| -e <INT> --end <INT> |
设置最后一天模拟结束的时间（秒）；默认值： 0 |
| --duration-d <INT> | 设置模拟的持续天数；默认值： 1 |
报告#
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 |
| --xml-validation.net <STRING> | 设置 SUMO 网络输入的模式验证方案（"never", "local", "auto" 或 "always"）；默认值： never |
| -W <BOOL> --no-warnings <BOOL> |
禁用警告输出；默认值： false |
| --aggregate-warnings <INT> | 当同一类型的警告超过 INT 次时进行聚合；默认值： -1 |
| -l <FILE> --log <FILE> |
将所有消息写入 FILE（隐含 verbose） |
| --message-log <FILE> | 将所有非错误消息写入 FILE（隐含 verbose） |
| --error-log <FILE> | 将所有警告和错误写入 FILE |
| --log.timestamps <BOOL> | 在所有消息前写入时间戳；默认值： false |
| --log.processid <BOOL> | 在所有消息前写入进程 ID；默认值： false |
| --language <STRING> | 消息中使用的语言；默认值： C |
| --debug <BOOL> | 关于每个步骤的详细消息；默认值： false |
随机数#
SUMO 套件的所有应用程序处理随机化选项的方式相同。这些选项在 Basics/Using the Command Line Applications#Random Number Options 中讨论。
| 选项 | 描述 |
|---|---|
| --random <BOOL> | 使用当前系统时间初始化随机数生成器；默认值： false |
| --seed <INT> | 使用给定值初始化随机数生成器；默认值： 23423 |