sumo¶
概要¶
sumoはシミュレーションそのものであり、微視的、 空間連続的、時間離散的な交通流シミュレーションです。
- 目的: 定義されたシナリオのシミュレート
- システム: ポータブル（Linux/Windowsでテスト済み）；コマンドラインで実行
- 入力（必須）:
A) netconvert または netgenerateで生成された道路ネットワーク、詳細はネットワーク構築
B) [duarouter] (duarouter.md)、jtrrouter、dfrouter、または activitygenで生成された経路セット。 車両、車両タイプ、および経路の定義も参照)
- 入力 (任意) ： 信号機、速度標識、出力検出器などの追加定義
- 出力： SUMOは多様な出力生成が可能で、可視化にはsumo-guiを使用
- プログラミング言語： C++
使用方法の説明¶
概要にはSimulation/Basic_Definitionを参照。 モデルの詳細と機能ドキュメントはSimulation topicsで確認可能。
オプション¶
SUMO設定にはXMLスキーマ定義ファイルを使用可能: sumoConfiguration.xsd
設定¶
| オプション | 説明 |
|---|---|
| -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 から道路ネットワーク記述を読み込み |
| -r <FILE> --route-files { {DT_FILE}} |
FILE(s) から経路記述を読み込む |
| -a <FILE> --additional-files <FILE> |
FILE(s) から追加の記述を読み込む |
| -w <FILE> - -weight-files <FILE> |
オンライン再経路計算用のエッジ/車線重みをファイルから読み込み |
| -x <STRING> --weight-attribute <STRING> |
エッジ重みを指定するXML属性の名前; デフォルト: traveltime |
| --load-state <FILE> | FILEからネットワーク状態を読み込み |
| --load-state.offset <TIME> | 保存状態から読み込む全時刻を指定オフセットだけシフト; デフォルト: 0 |
| --load-state.remove-vehicles {{ DT_STR_LIST }} | 指定されたIDの車両をロードした状態から削除 |
| --junction-taz <BOOL> | すべてのジャンクションに対してtoJunctionおよびfromJunction属性を使用するTAZを初期化; デフォルト: false |
出力¶
| オプション | 説明 |
|---|---|
| --write-license <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 |
| --netstate-dump <FILE> | 完全なネットワーク状態を FILE に保存 |
| --netstate-dump.empty-edges <BOOL> | ダンプ時に空のエッジも完全に書き出す; デフォルト: false |
| --netstate-dump.precision <INT> | 位置と速度を指定された精度で書き出す (デフォルト 2); デフォルト: 2 |
| --emission-output <FILE> | 各車両の排出値を保存 |
| --emission-output.precision <INT> | 指定した精度で排出値を出力（デフォルト2）； デフォルト: 2 |
| --emission-output.geo <BOOL> | 排出出力の位置情報を地理座標（経度/緯度）で保存する； デフォルト: false |
| --emission-output.step-scaled <BOOL> | 排出値を秒単位ではなくステップ長にスケーリングして書き込む； デフォルト: false |
| - -emission-output.attributes {{ DT_STR_LIST }} | 排出出力に含めるべき属性のリスト |
| - -battery-output <FILE> | 各車両のバッテリー値を保存 |
| --battery-output.precision <INT> | 指定した精度でバッテリー値を出力（デフォルト2）； デフォルト: 2 |
| --elechybrid-output { {DT_FILE}} | 各車両のelecHybrid値を保存 |
| --elechybrid-output.precision <INT> | 指定された精度でelecHybrid値を書き込む（デフォルト2）； デフォルト: 2 |
| --エレクハイブリッド出力.集計 <BOOL> | エレクハイブリッド値を集計ファイルに書き込む; デフォルト: false |
| --充電ステーション出力 <FILE> | 充電ステーションのデータを書き込む |
| - -chargingstations-output.aggregated <BOOL> | 単一時間ステップではなく集約された充電イベントデータを書き出す; デフォルト: false |
| --chargingstations-output.aggregated.write-unfinished <BOOL> | シミュレーション終了時に到着していない車両の集約充電イベントデータを書き出す; デフォルト: false |
| --overheadwiresegments-output <FILE> | 架線区間のデータを書き出す |
| --substations-output <FILE> | 変電所のデータを書き出す |
| --substations-output.precision <INT> | 指定された精度で変電所の値を書き出す (デフォルト 2) ; デフォルト: 2 |
| --fcd-output <FILE> | フローティングカーデータを保存 |
| --fcd-output.geo <BOOL> | 地理座標（経度/緯度）を使用してフローティングカーデータを保存; デフォルト: ** false** |
| --fcd-output.signals <BOOL> | 車両信号状態（ブレーキライト等）をFCD出力に追加； デフォルト: false |
| --fcd-output.distance <BOOL> | 走行距離（キロメートル単位）をFCD出力に追加（直線参照）； デフォルト: false |
| --fcd-output.acceleration <BOOL> | FCD出力に加速データを追加; デフォルト: false |
| --fcd-output.max-leader-distance <FLOAT> | FCD出力に先行車両情報を追加（指定距離内）； デフォルト: -1 |
| --fcd-output.params {{ DT_STR_LIST }} | FCD出力に汎用パラメータ値を追加 |
| --fcd-output.filter-edges.input-file <FILE> | FCD出力を指定入力ファイルのエッジ選択に制限 |
| --fcd-output.attributes {{ DT_STR_LIST }} | FCD出力に含める属性を列挙 |
| --fcd-output.filter-shapes {{ DT_STR_LIST }} | FCD出力のフィルタリングに使用する形状名を列挙 |
| --device.ssm.filter-edges.input-file <FILE> | SSMデバイスの出力を指定された入力ファイルからのエッジ選択に制限 |
| --full-output <FILE> | 各タイムステップの大量の情報を保存（非常に冗長） |
| --queue-output <FILE> | 交差点における車両キューを保存（実験的） |
| ** --queue-output.period** <TIME> | 指定した周期で車両の列を保存; デフォルト: -1 |
| --vtk-output <FILE> | 速度値を含む完全な車両位置をVTK形式で保存 (使用法: /path/out は /path/out_$TIMESTEP$.vtp ファイルを生成) |
| ** --amitran-output** <FILE> | 車両軌跡をAmitran形式で保存 |
| --summary-output <FILE> | 車両出発情報の集計結果をFILEに保存 |
| --summary-output.period <TIME> | 指定期間のサマリー出力を保存; デフォルト: -1 |
| --person-summary-output <FILE> | 乗客数の集計情報をFILEに保存 |
| --tripinfo-output <FILE> | 単一車両の運行情報をFILEに保存 |
| --tripinfo-output.write-unfinished <BOOL> | シミュレーション終了時に到着していない車両の運行情報出力を書き込む; デフォルト: false |
| --tripinfo-output.write-undeparted <BOOL> | 出発遅延によりシミュレーション終了時に未出発の車両のトリップ情報を出力 |
| --personinfo-output <FILE> | 乗客情報とコンテナ情報を別ファイルFILEに保存 |
| - -vehroute-output <FILE> | 単一車両の経路情報をFILEに保存 |
| --vehroute-output.exit-times <BOOL> | 全エッジの退出時刻を出力; デフォルト: false |
| --vehroute-output.last-route <BOOL> | 最終経路のみを出力; デフォルト: false |
| --vehroute-output.sorted <BOOL> | 出発時刻で出力をソートする; デフォルト: false |
| --vehroute-output.dua <BOOL> | 出力をデュアルルーター代替案形式で書き出す; デフォルト: false |
| --vehroute-output.cost <BOOL> | 全ルートのコストを出力する; デフォルト: false |
| --vehroute-output.intended-depart <BOOL> | 実際の出発時刻ではなく予定出発時刻で出力する; デフォルト: false |
| --vehroute-output.route-length <BOOL> | 出力に総ルート長を含める; デフォルト: false |
| --vehroute-output.write-unfinished <BOOL> | シミュレーション終了時に到着していない車両の出力も記述する; デフォルト: false |
| --vehroute-output.skip-ptlines { {DT_BOOL}} | 公共交通車両のvehroute出力をスキップする; デフォルト: false |
| --vehroute-output.incomplete <BOOL> | 無効なルートとルートスタブをvehroute出力に含める; デフォルト: false |
| --vehroute-output.stop-edges <BOOL> | 停留所間のエッジ情報を含める; デフォルト: false |
| --vehroute-output.speedfactor <BOOL> | 車両速度係数(speedFactor)を出力する（departSpeedが出力されている場合、デフォルトは"true"）; デフォルト: *false * |
| --vehroute-output.internal <BOOL> | 出力に内部エッジを含める; デフォルト: false |
| --personroute-output <FILE> | 人物ルートとコンテナルートを別々のFILEに保存 |
| --link-output <FILE> | リンク状態をFILEに保存 |
| * --railsignal-block-output* <FILE> | レール信号ブロックをFILEに保存 |
| --railsignal-vehicle-output <FILE> | レール信号ブロックにおける車両の進入・退出時刻をFILEに記録 |
| --bt-output <FILE> | Bluetooth可視性をFILEに保存（device.btreceiverおよびdevice.btsenderと連携） |
| --lanechange-output <FILE> | 全車両の車線変更とその動機をFILEに記録 |
| --lanechange-output.started <BOOL> | 車線変更操作の開始を記録; デフォルト: false |
| --lanechange-output.ended <BOOL> | 車線変更操作の終了を記録； デフォルト: false |
| --lanechange-output.xy <BOOL> | 車線変更操作の座標を記録； デフォルト: false |
| --stop-output <FILE> | 全車両の乗客・コンテナの乗降・積み込み/積み下ろしをFILEに記録 |
| --stop-output.write-unfinished <FILE> | シミュレーション終了時点で未完了の乗降情報を出力 |
| --collision-output <FILE> | 衝突情報をFILEに書き込む |
| --edgedata-output <FILE> | 全エッジの集計交通統計をFILEに書き込む |
| --lanedata-output <FILE> | 全レーンの集計交通統計をFILEに書き込む |
| --statistic-output <FILE> | 全体統計をFILEに書き出し |
| --deadlock-output <FILE> | デッドロックレポートをFILEに書き出し |
| --save-state.times {{ DT_STR_LIST }} | ネットワーク状態の書き込み時刻としてTIME[]を使用 |
| ** --save-state.period** <TIME> | TIME 間隔で状態を繰り返し保存; デフォルト: -1 |
| --save-state.period.keep <INT> | 最後の INT 個の定期状態ファイルのみ保持; デフォルト: 0 |
| --save-state.prefix <FILE> | ネットワーク状態ファイルの接頭辞; デフォルト: state |
| --save-state.suffix <STRING> | ネットワーク状態ファイルの接尾辞 (.xml.gz または .xml); デフォルト: .xml.gz |
| --save-state.files <FILE> | ネットワーク状態用ファイル |
| --save-state.rng <BOOL> | 乱数生成器の状態を保存; デフォルト: false |
| --save-state.transportables <BOOL> | 人物とコンテナの状態を保存 (実験的); デフォルト: false |
| --save-state.constraints <BOOL> | 鉄道信号制約を保存; デフォルト: false |
| --save-state.precision <INT> | 指定した精度で内部状態値を書き込む (デフォルト 2); デフォルト: 2 |
| --pedestrian.jupedsim.wkt <FILE> | JuPedSimネットワークをWKT形式で出力するファイル名 |
| --pedestrian.jupedsim.wkt.geo <BOOL> | JuPedSimネットワークを地理座標（経度/緯度）でWKTとして出力するか； デフォルト: false |
| --pedestrian.jupedsim.py <FILE> | JuPedSim設定をPythonスクリプトとして出力するファイル名 |
時間¶
| オプション | 説明 |
|---|---|
| -b <TIME> --begin <TIME> |
開始時刻を秒単位で定義します。シミュレーションはこの時刻に開始します。デフォルト: 0 |
| -e <TIME> --end <TIME> |
終了時刻を秒単位で定義します。シミュレーションはこの時刻で終了します。デフォルト: -1 |
| --step-length <TIME> | ステップ間隔を秒単位で定義します。デフォルト: 1 |
処理¶
| オプション | 説明 |
|---|---|
| --step-method.ballistic <BOOL> | 車両の位置更新に弾道法を使用するか（デフォルトは半陰的オイラー法）。; デフォルト: false |
| --extrapolate-departpos <BOOL> | シミュレーションステップ間で出発する車両の出発位置を補外するかどうか； デフォルト: false |
| --threads <INT> | 並列シミュレーションのスレッド数を定義； デフォルト: 1 |
| --lateral-resolution <FLOAT> | 車線内での横方向位置決め処理における解像度（単位：m）を設定（-1の場合、全車両が車線中央を走行）。デフォルト: -1 |
| -s <TIME> --route-steps <TIME> |
指定秒数先のルートをロードします； デフォルト: 200 |
| --no-internal-links <BOOL> | (ジャンクション) 内部リンクを無効化します； デフォルト: false |
| --ignore-junction-blocker <TIME> | 交差点で停止した車両が秒数以上滞留した場合に無視する (-1は常に無視しない); デフォルト: -1 |
| --ignore-route-errors <BOOL> | ルートの接続性をチェックしない; デフォルト: false |
| ** --ignore-accidents** <BOOL> | 事故の発生有無をチェックしない; デフォルト: false |
| --collision.action <STRING> | 衝突時の処理方法: [none,warn,teleport,remove]; デフォルト: teleport |
| --intermodal-collision.action <STRING> | 車両と歩行者の衝突時の処理方法: [none,warn,teleport,remove]; デフォルト: warn |
| --collision.stoptime <TIME> | 衝突処理実行前に車両をTIME秒間停止させる（"none"を除く）； デフォルト: 0 |
| --intermodal-collision.stoptime <TIME> | 車両が intermodal-collision.action を実行する前に TIME 秒間停止する（"none" アクションを除く）； デフォルト: 0 |
| --collision.check-junctions <BOOL> | 交差点での衝突チェックを有効化します; デフォルト: false |
| --collision.check-junctions.mingap <FLOAT> | 交差点衝突チェックの感度を増加または減少させます; デフォルト: 0 |
| --collision.mingap-factor <FLOAT> | 衝突検出を回避するために維持すべきminGapの割合を設定します。負の値が指定された場合、carFollowModelパラメータが使用されます； デフォルト: -1 |
| --keep-after-arrival <TIME> | 車両到着後、指定された時間（TraCIアクセス用）メモリに保持する； デフォルト: 0 |
| --max-num-vehicles <INT> | 指定された最大台数を超えないよう車両挿入を遅延させます； デフォルト: -1 |
| --max-num-persons <INT> | 指定された最大人数を超えないよう人物挿入を遅延させます； デフォルト: -1 |
| --max-num-teleports <INT> | 指定された最大テレポート数を超えた場合にシミュレーションを中止; デフォルト: -1 |
| --scale <FLOAT> | 指定された倍率で需要をスケーリング（車両の破棄または複製により）； デフォルト: 1 |
| --scale-suffix <STRING> | クローン車両のID生成時に追加するサフィックス; デフォルト: . |
| --time-to-teleport <TIME> | 車両がテレポートされるまでの待機時間を指定（デフォルト300秒）。非正の値はテレポートを無効化; デフォルト: 300 |
| --time-to-teleport.highways <TIME> | 高速道路（速度 > 69km/h）上の車両が非連続車線にいる場合、テレポートされるまでの待機時間； デフォルト: * 0* |
| --time-to-teleport.highways.min-speed <FLOAT> | 高速道路（デフォルト：速度 > 69km/h）上で、非連続車線にいる車両がテレポートされるまでの待機時間； デフォルト: * 19.1667* |
| --time-to-teleport.disconnected <TIME> | ルートが切断された車両がテレポートされるまでの待機時間。負の値はテレポートを無効化します； デフォルト: -1 |
| --time-to-teleport.remove <BOOL> | 待機時間が長すぎた車両をテレポートではなく削除するかどうか； デフォルト: false |
| --time-to-teleport.remove-constraint <BOOL> | 線路信号制約に基づくデッドロックを制約の削除で解消するかどうか； デフォルト: ** false** |
| --time-to-teleport.ride <TIME> | ピックアップ待機中の乗客/コンテナがテレポートされるまでの待機時間。負の値はテレポートを無効化します； デフォルト: -1 |
| - -time-to-teleport.bidi <TIME> | 双方向エッジ上の車両がテレポートされる待機時間; デフォルト: -1 |
| --time-to-teleport.railsignal-deadlock <TIME> | レール信号ベースのデッドロック状態にある車両がテレポートされる待機時間; デフォルト: -1 |
| --waiting-time-memory <TIME> | 累積待機時間を考慮する時間間隔の長さ（デフォルトは100秒）； デフォルト: 100 |
| --startup-wait-threshold <TIME> | startupDelayを適用する前の最小連続待機時間； デフォルト: 2 |
| --max-depart-delay <TIME> | 車両が出発待機中にスキップされるまでの待機時間。デフォルトは-1（スキップされない）； デフォルト: -1 |
| --sloppy-insert <BOOL> | エッジへの挿入が一度失敗した場合、同じステップで再試行しないか； デフォルト: false |
| --eager-insert <BOOL> | 各車両を個別にエッジへの挿入対象としてチェックするか； デフォルト: false |
| --emergency-insert <BOOL> | 緊急ブレーキが必要な状況での車両挿入を許可するかどうか； デフォルト: false |
| --insertion-checks <STRING> | 車両属性 insertionChecks のデフォルト値を上書き; デフォルト: all |
| --random-depart-offset <TIME> | 各車両の出発値に [0, TIME] から一様分布でランダムなオフセットを付与; デフォルト: 0 |
| --lanechange.duration <TIME> | 車線変更操作の所要時間（デフォルト0）； デフォルト: 0 |
| --lanechange.overtake-right <BOOL> | 高速道路での右側追い越しを許可するか； デフォルト: false |
| --tls.all-off { {DT_BOOL}} | 全ての信号機をオフにします。; デフォルト: false |
| --tls.actuated.show-detectors <BOOL> | 作動検知器のデフォルト可視性を設定します; デフォルト: false |
| --tls.actuated.jam-threshold <FLOAT> | すべての作動検知器のデフォルト渋滞閾値パラメータを設定します； デフォルト: -1 |
| --tls.actuated.detector-length <FLOAT> | すべての作動検知器のデフォルト検知器長パラメータを設定します； デフォルト: 0 |
| --tls.delay_based.detector-range <FLOAT> | 遅延車両検出のデフォルト範囲を設定します; デフォルト: 100 |
| --tls.yellow.min-decel <FLOAT> | 黄信号時の制動における最小減速値; デフォルト: 3 |
| --railsignal-moving-block <BOOL> | 鉄道信号をデフォルトで移動ブロックモードで動作させる; デフォルト: false |
| --railsignal.max-block-length <FLOAT> | FLOATを超える長さのブロックを構築せず、代わりに警告を発する; デフォルト: 20000 |
| --railsignal.default-classes {{ DT_STR_LIST }} | ネットワークに該当するレール信号が存在しない場合でも、ブロックベースの挿入チェックを使用する車両クラスを列挙; デフォルト: rail,rail_fast,rail_electric,rail_urban |
| --time-to-impatience <TIME> | 車両が待機中に不耐性が0から1に増加するまでの時間を指定します。デフォルトは300。非正の値は不耐性増加を無効化します； デフォルト: 180 |
| --default.departspeed <STRING> | 出発時のデフォルト速度を選択； デフォルト: 0 |
| --default.departlane <STRING> | 出発レーンのデフォルトを選択; デフォルト: first |
| --default.action-step-length <FLOAT> | 車間追従モデルおよび車線変更モデルにおけるアクションポイント間のデフォルト間隔の長さ (秒単位)。指定しない場合、シミュレーションステップ長がデフォルトで使用されます。車両またはVType固有の設定はデフォルトを上書きします。シミュレーションステップ長の倍数である必要があります。; デフォルト: 0 |
| --default.carfollowmodel <STRING> | デフォルトの車間追従モデルを選択 (Krauss, IDM, ...); デフォルト: Krauss |
| --default.speeddev <FLOAT> | デフォルト速度偏差を選択。負の値はvClass固有のデフォルト値を意味する（デフォルト乗用車クラスでは0.1）。; デフォルト: -1 |
| --default. emergencydecel <STRING> | 減速値をデフォルト値として設定するモードを選択（"decel"、"default"、FLOAT）。減速値と同じ値、vClass固有のデフォルト値、または指定されたFLOAT（m/s^2単位）のいずれかを設定； デフォルト: デフォルト |
| --overhead-wire.solver <BOOL> | 架線回路の解法にキルヒホッフの法則を使用する； デフォルト: true |
| --overhead-wire.recuperation <BOOL> | elecHybridデバイス搭載車両からの架線への回生を有効化する； デフォルト: true |
| --overhead-wire.substation-current-limits <BOOL> | 架空線電気回路の解法時に変電所の電流制限を有効化します。; デフォルト: true |
| --emergencydecel.warning-threshold <FLOAT> | 警告を発動させるために使用しなければならない緊急減速能力の割合を設定します。; デフォルト: 1 |
| --parking.maneuver <BOOL> | 駐車シミュレーションに操作時間と関連する車線遮断を含めるかどうか; デフォルト: false |
| ** --use-stop-ended** <BOOL> | 停止開始時刻が指定された場合、停止終了時刻で停止時間を上書きする； デフォルト: false |
| --use-stop-started <BOOL> | 停止開始時刻が指定された場合、停止到着時刻を上書きする； デフォルト: false |
| --pedestrian.model <BOOL> | 歩行者モデルを選択 ["nonInteracting", "striping", "jupedsim", "remote"]; デフォルト: striping |
| --pedestrian.timegap-crossing <FLOAT> | 横断開始前の車両間隔の最小許容値（秒単位）； デフォルト: 2 |
| --pedestrian.striping.stripe-width <FLOAT> | 歩道を区画化する平行ストライプの幅（メートル）。モデル "striping" での使用； デフォルト: 0.64 |
| --pedestrian.striping.dawdling <FLOAT> | モデル "striping" 用のランダム減速係数 [0,1]； デフォルト: 0.2 |
| ** --pedestrian.striping.mingap-to-vehicle** <FLOAT> | 歩行者と他の車両間の最小間隔／安全バッファ（メートル単位）。モデル "striping" で使用。 デフォルト: 0.25 |
| --pedestrian.striping.jamtime <TIME> | モデル "striping" 使用時、歩行者が渋滞をすり抜け始めるまでの時間（秒単位）（非正の値はすり抜けを無効化）； デフォルト: 300 |
| --pedestrian.striping.jamtime.crossing <TIME> | モデル "striping" 使用時、横断歩道上で渋滞が発生してから歩行者が渋滞をすり抜け始めるまでの時間（秒）（負の値はすり抜けを無効化）； デフォルト: 10 |
| --pedestrian.striping.jamtime.narrow <TIME> | モデル "striping" 使用時、狭い車線上で渋滞が発生してから歩行者が渋滞をすり抜け始めるまでの時間（秒単位）； デフォルト: 1 |
| --pedestrian.striping.jamfactor <FLOAT> | 渋滞状態における歩行者の速度を低下させる係数； デフォルト: 0.25 |
| --pedestrian.striping.reserve-oncoming <FLOAT> | 対向歩行者用に確保するストライプの割合; デフォルト: 0 |
| --pedestrian.striping.reserve-oncoming.junctions <FLOAT> | 交差点および歩行者エリアで対向歩行者に確保するストライプの割合; デフォルト: 0.34 |
| --pedestrian.striping.reserve-oncoming.max <FLOAT> | 対向歩行者用に確保する最大幅（m単位）； デフォルト: 1.28 |
| --pedestrian.striping.legacy-departposlat <BOOL> | 歩行経路の出発位置緯度をレガシースタイルで解釈する； デフォルト: false |
| --pedestrian.striping.walkingarea-detail { {DT_INT}} | 歩行エリア内の車線を滑らかにするための中間点（INT）を生成する数; デフォルト: 4 |
| --pedestrian.jupedsim.step-length <TIME> | JuPedSim シミュレーションの更新間隔（秒単位）; デフォルト: 0.01 |
| - -pedestrian.jupedsim.exit-tolerance <FLOAT> | JuPedSim到達点を許容する距離（メートル単位）； デフォルト: 1 |
| --pedestrian.jupedsim.model <STRING> | JuPedSimで使用するサブモデル ("CollisionFreeSpeed", "CollisionFreeSpeedV2", "GeneralizedCentrifugalForce", "SocialForce"); デフォルト: CollisionFreeSpeed |
| --pedestrian.jupedsim.strength-neighbor-repulsion <FLOAT> | JuPedSimモデルの隣接者反発強度； デフォルト: 8 |
| --pedestrian.jupedsim.range-neighbor-repulsion <FLOAT> | JuPedSimモデルの近接反発範囲（メートル単位）； デフォルト: 0.1 |
| --pedestrian.jupedsim.strength-geometry-repulsion <FLOAT> | JuPedSimモデルの幾何学的反発強度; デフォルト: 5 |
| --pedestrian.jupedsim.range-geometry-repulsion <FLOAT> | JuPedSimモデルの幾何学的反発範囲（メートル単位）; デフォルト: 0.02 |
| --ride.stop-tolerance <FLOAT> | 個々の停留所での乗降時、歩行者と車両の位置を一致させる際に適用する許容誤差; デフォルト: 10 |
| --mapmatch.distance <FLOAT> | 入力座標（fromXYなど）を道路ネットワークにマッピングする際の最大距離； デフォルト: 100 |
| --mapmatch.junctions <BOOL> | 位置をエッジではなくジャンクションに一致させる； デフォルト: false |
| --mapmatch.taz <BOOL> | 位置をエッジではなくTAZに一致させる； デフォルト: false |
| --weights.turnaround-penalty <FLOAT> | 折り返し内部レーンの経路コスト計算時に指定時間ペナルティを適用; デフォルト: 5 |
| --persontrip.walk-opposite-factor <FLOAT> | 歩行速度に対する車両交通方向の補正係数としてFLOATを使用; デフォルト: 1 |
経路設定 (Routing)¶
| オプション | 説明 |
|---|---|
| --routing-algorithm <STRING> | ルーティングアルゴリズム ["dijkstra", "astar", "CH", "CHWrapper"] から選択; デフォルト: dijkstra |
| - -weights.random-factor <FLOAT> | 経路設定のエッジ重みを、[1,FLOAT)から一様分布で抽出されたランダム係数で動的に乱す; デフォルト: 1 |
| ** --weights.minor-penalty** <FLOAT> | マイナーリンク内部レーンの最小経路コスト計算時に指定された時間ペナルティを適用; デフォルト: 1.5 |
| --weights.tls-penalty <FLOAT> | 信号機のある内部車線の最小経路コスト計算時に、信号の緑分割時間に基づくスケーリングされた移動時間ペナルティを適用; デフォルト: 0 |
| ** --weights.priority-factor** <FLOAT> | 移動時間に加え、係数で重み付けされたエッジ優先度を考慮する; デフォルト: 0 |
| --weights.separate-turns <FLOAT> | 方向転換による移動時間の差異を区別し、交差点手前で推定損失時間の割合を内部エッジへシフト； デフォルト: 0 |
| --astar.all-distances <FILE> | 指定ファイル（marouter --all-pairs-output で生成）から astar 用ルックアップテーブルを初期化 |
| --astar.landmark-distances <FILE> | 指定ファイルから astar ALT バリアントのルックアップテーブルを初期化 |
| --persontrip.walkfactor <FLOAT> | インターモーダル経路計画時に歩行者最高速度の係数として FLOAT を使用; デフォルト: 0.75 |
| --persontrip.transfer.car-walk {{ DT_STR_LIST }} | 自動車から歩行へのモード変更が許可される場所（可能な値: "parkingAreas"、"ptStops"、"allJunctions" およびそれらの組み合わせ）；デフォルト: parkingAreas |
| --persontrip.transfer.taxi-walk {{ DT_STR_LIST }} | タクシーが乗客を降ろせる場所 ("allJunctions", "ptStops") |
| --persontrip.transfer.walk-taxi {{ DT_STR_LIST }} | タクシーが乗客を乗せられる場所 ("allJunctions", "ptStops") |
| --persontrip.default.group <STRING> | 設定時、同一出発地・目的地間の移動はデフォルトでタクシーを共有 |
| --persontrip.taxi.waiting-time <TIME> | タクシー乗車待ちの推定時間; デフォルト: 300 |
| --persontrip.ride-public-line <BOOL> | 目的地で停車する代替路線ではなく、指定された公共交通路線のみを使用する; デフォルト: false |
| --railway.max-train-length <FLOAT> | 鉄道ルーター初期化時の最大列車長としてFLOATを使用; デフォルト: 1000 |
| --replay-rerouting <BOOL> | vehroute-outputからの正確な経路変更シーケンスを再生; デフォルト: false |
| --device.rerouting.probability <FLOAT> | 車両が「rerouting」デバイスを持つ確率; デフォルト: -1 |
| --device.rerouting.explicit {{ DT_STR_LIST }} | 名前付き車両に「rerouting」デバイスを割り当てる |
| --device.rerouting.deterministic <BOOL> | 「rerouting」デバイスを1000分の割合で確定的に設定する； デフォルト: false |
| --device.rerouting.period <TIME> | 車両が再ルーティングされる間隔； デフォルト: 0 |
| ** --device.rerouting.pre-period** <TIME> | 出発前の再経路計算期間; デフォルト: 60 |
| --device.rerouting.adaptation-weight <FLOAT> | 指数移動平均における過去エッジ重みの加重係数; デフォルト: 0 |
| - -device.rerouting.adaptation-steps <INT> | 過去のエッジ重みの移動平均重み付けにおけるステップ数; デフォルト: 180 |
| - -device.rerouting.adaptation-interval <TIME> | エッジ重み更新間隔; デフォルト: 1 |
| --device.rerouting.with-taz <BOOL> | ゾーン（地区）をルーティングの開始点・終点として使用; デフォルト: false |
| --device.rerouting.mode <STRING> | ルーティングフラグを設定（8は一時的な遮断を無視）； デフォルト: 0 |
| --device.rerouting.init-with-loaded-weights <BOOL> | エッジ重みの初期化に --weight-files オプションで指定された重みファイルを使用する; デフォルト: false |
| --device.rerouting.threads <INT> | 再ルーティングに使用する並列実行スレッド数; デフォルト: 0 |
| --device.rerouting.synchronize <BOOL> | 全車両で同時に経路再計算を実行する； デフォルト: false |
| --device.rerouting.railsignal <BOOL> | 線路信号による経路再計算を許可する； デフォルト: false |
| --device.rerouting.bike-speeds <BOOL> | 自転車用に別個の平均速度を計算する; デフォルト: false |
| --device.rerouting.output <FILE> | 適応重みを FILE に保存 |
| --person-device.rerouting.probability <FLOAT> | 人が "rerouting" デバイスを持つ確率; デフォルト: -1 |
| --person-device.rerouting.explicit {{ DT_STR_LIST }} | 名前付き人物に「rerouting」デバイスを割り当てる |
| --person-device.rerouting.deterministic <BOOL> | 「rerouting」デバイスを1000分の確率で確定的に設定する; デフォルト: false |
| --person-device.rerouting.period <TIME> | 人物の経路変更間隔; デフォルト: 0 |
| --person-device.rerouting.mode <STRING> | 経路設定フラグ (8 は一時的な遮断を無視); デフォルト: 0 |
| --person-device.rerouting.scope <STRING> | 人の計画のどの部分を置き換えるか（ステージ、シーケンス、またはトリップ）； デフォルト: stage |
レポート¶
| オプション | 説明 |
|---|---|
| -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 |
| --xml-validation.routes <STRING> | SUMOルート入力のスキーマ検証方式を設定（「never」、「local」、「auto」または「always」）； デフォルト: local |
| -W <BOOL> --no-warnings <BOOL> |
警告の出力無効化； デフォルト: false |
| --aggregate-warnings <INT> | 同じタイプの警告が INT 以上発生した場合に集約する; デフォルト: -1 |
| -l <FILE> --log <FILE> |
全てのメッセージを FILE に書き出す (詳細出力を含む) |
| --message-log <FILE> | エラー以外の全メッセージを FILE に書き込む (詳細モードを暗黙的に有効化) |
| --error-log <FILE> | すべての警告とエラーを FILE に書き込む |
| --log.timestamps <BOOL> | すべてのメッセージの前にタイムスタンプを付加; デフォルト: false |
| --log.processid <BOOL> | 全てのメッセージの前にプロセスIDを出力; デフォルト: false |
| --language <STRING> | メッセージで使用する言語; デフォルト: C |
| --duration-log.disable <BOOL> | 個々のシミュレーションステップのパフォーマンスレポートを無効化; デフォルト: false |
| -t <BOOL> --duration-log.statistics <BOOL> |
車両移動の統計情報を有効化; デフォルト: false |
| --no-step-log <BOOL> | 現在のシミュレーションステップのコンソール出力を無効化; デフォルト: false |
| --step-log.period <INT> | ステップログ出力間のシミュレーションステップ数; デフォルト: 100 |
排出量¶
| オプション | 説明 |
|---|---|
| --emissions.volumetric-fuel <BOOL> | 燃料消費量をmgではなく（レガシー）単位lで返す; デフォルト: false |
| --phemlight-path <FILE> | PHEMlight定義の読み込み元を指定します; デフォルト: ./PHEMlight/ |
| --phemlight-year <INT> | PHEMlight5で指定した基準年による車両群の経年変化モデリングを有効化します; デフォルト: 0 |
| --phemlight-temperature <FLOAT> | PHEMlight5でNOx排出量を補正するための周囲温度を設定; デフォルト: 1.79769e+308 |
| --device.emissions.probability <FLOAT> | 車両が「emissions」デバイスを持つ確率; デフォルト: -1 |
| --device.emissions.explicit {{ DT_STR_LIST }} | 名前付き車両に「emissions」デバイスを割り当てる |
| --device.emissions.deterministic <BOOL> | 「emissions」デバイスを1000分の割合で決定論的に設定する; デフォルト: false |
| - -device.emissions.begin <STRING> | 排出データ記録の開始時刻; デフォルト: -1 |
| --device.emissions.period <STRING> | 排出出力の記録期間; デフォルト: 0 |
通信¶
| オプション | 説明 |
|---|---|
| --device.btreceiver.probability <FLOAT> | 車両が「btreceiver」デバイスを持つ確率; デフォルト: -1 |
| --device.btreceiver.explicit {{ DT_STR_LIST }} | 名前付き車両に「btreceiver」デバイスを割り当てる |
| --device.btreceiver.deterministic <BOOL> | 「btreceiver」デバイスを1000分の割合で確定的に設定する; デフォルト: false |
| --device.btreceiver.range <FLOAT> | BT受信機の範囲; デフォルト: 300 |
| --device.btreceiver.all-recognitions <BOOL> | すべての認識ポイントを書き込むかどうか; デフォルト: false |
| --device.btreceiver.offtime <FLOAT> | 検出確率計算に使用するオフタイム（秒単位）； デフォルト: 0.64 |
| --device.btsender.probability <FLOAT> | 車両が「btsender」デバイスを持つ確率； デフォルト: -1 |
| --device.btsender.explicit {{ DT_STR_LIST }} | 名前付き車両に「btsender」デバイスを割り当てる |
| --device.btsender.deterministic <BOOL> | "btsender"デバイスを1000分の割合で確定的に設定する； デフォルト: * false* |
| --person-device.btsender.probability <FLOAT> | 人物が「btsender」デバイスを所持する確率; デフォルト: -1 |
| --person-device.btsender.explicit {{ DT_STR_LIST }} | 名前付き人物に「btsender」デバイスを割り当てる |
| --person-device.btsender.deterministic <BOOL> | 「btsender」デバイスは1000分の確率で確定的に設定される; デフォルト: false |
| --person-device.btreceiver.probability <FLOAT> | 対象人物が "btreceiver" デバイスを所有する確率; デフォルト: -1 |
| --person-device.btreceiver.explicit {{ DT_STR_LIST }} | 指定された人物に "btreceiver" デバイスを割り当てる |
| --person-device.btreceiver.deterministic <BOOL> | "btreceiver" デバイスを 1000 分の確率で確定的に設定するかどうか; デフォルト: false |
バッテリー¶
| オプション | 説明 |
|---|---|
| --device.stationfinder.probability <FLOAT> | 車両が「stationfinder」デバイスを持つ確率; デフォルト: -1 |
| --device.stationfinder.explicit {{ DT_STR_LIST }} | 名前付き車両に「stationfinder」デバイスを割り当てる |
| --device.stationfinder.deterministic <BOOL> | "stationfinder" デバイスを 1000 分の割合で確定的に設定する; デフォルト: false |
| --device.stationfinder.rescueTime <TIME> | バッテリー切れ時に路上で救助車両を待機する時間; デフォルト: 1800 |
| --device.stationfinder.rescueAction <STRING> | バッテリー不足で停止せざるを得ない車両への対応方法: [none, remove, tow]; デフォルト: remove |
| --device.stationfinder.reserveFactor <FLOAT> | 予期せぬ交通状況に備え、この係数でバッテリー必要量を調整; デフォルト: 1.1 |
| --device.stationfinder.emptyThreshold <FLOAT> | レスキューモードに移行するバッテリー残量（%）； デフォルト: 0.05 |
| --device.stationfinder.radius <TIME> | 移動時間秒単位の検索半径； デフォルト: * 180* |
| --device.stationfinder.maxEuclideanDistance <FLOAT> | ユークリッド距離の検索上限（メートル単位）（負の値で制限を無効化）； デフォルト: -1 |
| --device.stationfinder.repeat <TIME> | ステーションが見つからない場合の新たな検索開始間隔（秒）； デフォルト: 60 |
| --device.stationfinder.maxChargePower <FLOAT> | 車両バッテリーの最大充電速度; デフォルト: 100000 |
| --device.stationfinder.chargeType <STRING> | エネルギー転送方式; デフォルト: charging |
| --device.stationfinder.waitForCharge <TIME> | 待機時間経過後、最初の充電ステーションが使用不可の場合に新たなステーションを検索する; デフォルト: 600 |
| --device.stationfinder.minOpportunityDuration <TIME> | 予測継続時間が指定閾値以上である場合のみ、機会充電の対象として考慮する。; デフォルト: 3600 |
| --device.stationfinder.saturatedChargeLevel <FLOAT> | 充電を停止する目標充電状態; デフォルト: 0.8 |
| --device.stationfinder.needToChargeLevel <FLOAT> | 充電ステーションの検索を開始する充電状態; デフォルト: 0.4 |
| --device.stationfinder.opportunisticChargeLevel <FLOAT> | 計画された停車地点で充電機会を探す可能性のあるSOC値; デフォルト: 0 |
| --device.stationfinder.replacePlannedStop <FLOAT> | 次回の独立計画停車時間の充電に充てる割合; デフォルト: 0 |
| - -device.stationfinder.maxDistanceToReplacedStop <FLOAT> | 充電用停車に置き換える元の停車地点からの最大距離（メートル単位）； デフォルト: 300 |
| --device.stationfinder.chargingStrategy <STRING> | 充電戦略を設定し、設定された時間と充電負荷を変更します：[none, balanced, latest]； デフォルト: none |
| --device.stationfinder.checkEnergyForRoute <BOOL> | 現在のルートを完了するのに十分なバッテリー充電量が推定されない場合にのみ充電ステーションを検索する; デフォルト: true |
| --device.battery.probability { {DT_FLOAT}} | 車両が「バッテリー」デバイスを持つ確率; デフォルト: -1 |
| --device.battery.explicit {{ DT_STR_LIST }} | 名前付き車両に「バッテリー」デバイスを割り当てる |
| --device.battery.deterministic <BOOL> | 「バッテリー」デバイスは1000分の1の割合で確定的に設定されます; デフォルト: false |
| --device.battery.track-fuel <BOOL> | 非電気自動車の燃料消費量を追跡; デフォルト: false |
デバイス例¶
| オプション | 説明 |
|---|---|
| --device.example.probability <FLOAT> | 車両が「example」デバイスを持つ確率; デフォルト: -1 |
| --device.example.explicit {{ DT_STR_LIST }} | 名前付き車両に「example」デバイスを割り当てる |
| - -device.example.deterministic <BOOL> | "example" デバイスを 1000 分の確率で確定的に設定する; デフォルト: false |
| --device.example.parameter <FLOAT> | "example" デバイスの全インスタンスで使用可能な代表的なパラメータ; デフォルト: 0 |
Ssm デバイス¶
| オプション | 説明 |
|---|---|
| --device.ssm.probability <FLOAT> | 車両が "ssm" デバイスを持つ確率; デフォルト: -1 |
| --device.ssm.explicit {{ DT_STR_LIST }} | 名前付き車両に「ssm」デバイスを割り当てる |
| --device.ssm.deterministic <BOOL> | 「ssm」デバイスを1000分の割合で確定的に設定する； デフォルト: * false* |
| --device.ssm.measures <STRING> | 記録する計測項目を指定（"TTC"、"DRAC"、"PET"、"PPET"、"MDRAC" の ID をスペースまたはカンマ区切りで列挙） |
| --device.ssm.thresholds <STRING> | 指定された測定値に対応する閾値をスペースまたはカンマ区切りで指定します（ドキュメントを参照し、順序に注意！）。閾値を超えたイベントのみが記録されます。 |
| --device.ssm.trajectories <BOOL> | 軌跡を記録するかどうかを指定します（falseの場合、極端値と時刻のみが報告されます）。; デフォルト: false |
| --device.ssm.range <FLOAT> | 検出範囲をメートル単位で指定します。装備車両からこの距離以内の車両については、SSM値が追跡されます。; デフォルト: 50 |
| --device.ssm.extratime <FLOAT> | 衝突終了後に記録する時間を秒単位で指定します。交差衝突のPETを計算する場合、0より大きい値が必要です。; デフォルト: 5 |
| --device.ssm.mdrac.prt <FLOAT> | MDRAC計算用の知覚反応時間を指定します。; デフォルト: 1 |
| --device.ssm.file <STRING> | SSM出力用のグローバルデフォルトファイル名を指定します |
| --device.ssm.geo <BOOL> | 出力時に元の参照座標系を使用するか； デフォルト: false |
| --device.ssm.write-positions <BOOL> | 各タイムステップの位置（座標）を書き込むか； デフォルト: false |
| - -device.ssm.write-lane-positions <BOOL> | 各タイムステップのレーンとその位置を書き込むか； デフォルト: false |
| --device.ssm.write-na <BOOL> | データのない競合出力をNA値として書き込むか、スキップするか； デフォルト: true |
| --device.ssm.exclude-conflict-types <STRING> | 衝突タイプに基づいてログから除外する衝突を指定します（"ego"、"foe"、""、または有効な数値衝突タイプコードの組み合わせ）。空の値は全てをログに記録し、"ego"/"foe"は特定の衝突タイプサブセットを指します。 |
Tocデバイス¶
| オプション | 説明 |
|---|---|
| --device.toc.probability <FLOAT> | 車両が"toc"デバイスを持つ確率; デフォルト: -1 |
| --device.toc.explicit {{ DT_STR_LIST }} | 名前付き車両に「toc」デバイスを割り当てる |
| --device.toc.deterministic <BOOL> | 「toc」デバイスを1000分の確率で確定的に設定する； デフォルト: false |
| --device.toc.manualType <STRING> | 手動運転モードの車両タイプ。 |
| --device.toc.automatedType <STRING> | 自動運転モードの車両タイプ。 |
| --device.toc.responseTime <FLOAT> | ドライバーが制御を取り戻すのに必要な平均応答時間。; デフォルト: -1 |
| --device.toc.recoveryRate <FLOAT> | ToC後のドライバーの注意回復率。; デフォルト: 0.1 |
| --device.toc.lcAbstinence <FLOAT> | 車線変更を抑制する注意レベル（[0,1]の範囲）。; デフォルト: 0 |
| --device.toc.initialAwareness <FLOAT> | ToC後のドライバーの初期平均認知度（[0,1]の範囲）。; デフォルト: 0.5 |
| *--device.toc.mrmDecel * <FLOAT> | 「最小リスク操作」中に適用される減速率。; デフォルト: 1.5 |
| --device.toc.dynamicToCThreshold <FLOAT> | 自動運転モードを継続するために車両が前方で必要とする時間。デフォルト値0はToCの動的トリガーを無効化。; デフォルト: 0 |
| --device.toc.dynamicMRMProbability <FLOAT> | 動的にトリガーされたTORに時間内に応答しない確率。; デフォルト: 0.05 |
| --device.toc.mrmKeepRight <BOOL> | trueの場合、車両はMRM中に右側への車線変更を試みる。; デフォルト: false |
| --device.toc.mrmSafeSpot <STRING> | 設定時、車両はMRM中に指定された安全停止地点へ到達を試みる。 |
| --device.toc.mrmSafeSpotDuration <FLOAT> | MRM終了後、車両が安全地点に留まる時間。; デフォルト: 60 |
| --device.toc.maxPreparationAccel <FLOAT> | ToC準備フェーズ中に適用可能な最大加速度。; デフォルト: 0 |
| --device.toc.ogNewTimeHeadway <FLOAT> | ToC準備フェーズの時間間隔。; デフォルト: -1 |
| --device.toc.ogNewSpaceHeadway { {DT_FLOAT}} | ToC準備フェーズにおける追加間隔。; デフォルト: -1 |
| --device.toc.ogMaxDecel <FLOAT> | ToC準備フェーズで増加した間隔を確立するために適用される最大減速。; デフォルト: -1 |
| --device.toc.ogChangeRate <FLOAT> | ToC準備中の増加間隔への適応速度。; デフォルト: -1 |
| --device.toc.useColorScheme <BOOL> | 異なるToC段階を示すための配色スキームを適用するかどうか。; デフォルト: true |
| --device.toc.file <STRING> | 出力ファイル名を指定して出力を有効化する。 |
運転者状態デバイス¶
| オプション | 説明 |
|---|---|
| --device.driverstate.probability <FLOAT> | 車両が "driverstate" デバイスを持つ確率; デフォルト: -1 |
| --device.driverstate.explicit {{ DT_STR_LIST }} | 名前付き車両に "driverstate" デバイスを割り当てる |
| --device.driverstate.deterministic <BOOL> | "driverstate" デバイスを 1000 分の割合で決定論的に設定する； デフォルト: false |
| --device.driverstate.initialAwareness <FLOAT> | ドライバーの認識度への初期値； デフォルト: 1 |
| --device.driverstate.errorTimeScaleCoefficient <FLOAT> | エラープロセスの時間スケール。; デフォルト: 100 |
| --device.driverstate.errorNoiseIntensityCoefficient <FLOAT> | エラープロセスを駆動するノイズ強度。; デフォルト: 0.2 |
| --device.driverstate.speedDifferenceErrorCoefficient <FLOAT> | 知覚された速度差にエラーを適用するための一般的なスケーリング係数（エラーは距離にも比例して変化）。; デフォルト: 0.15 |
| --device.driverstate.headwayErrorCoefficient <FLOAT> | 知覚距離に誤差を適用するための一般的なスケーリング係数（誤差は距離に応じて拡大縮小されます）。; デフォルト: 0.75 |
| --device.driverstate.freeSpeedErrorCoefficient <FLOAT> | 先行車なし走行時の自車速度に誤差を適用するための一般的なスケーリング係数（誤差は自車速度にも比例して変化）。; デフォルト: 0 |
| --device.driverstate.speedDifferenceChangePerceptionThreshold <FLOAT> | 速度差の変化を認識するための基本閾値（閾値は距離に応じて変化）。; デフォルト: *0.1 * |
| --device.driverstate.headwayChangePerceptionThreshold <FLOAT> | 車間距離の変化を認識するための基本しきい値（しきい値は距離に応じてスケーリングされます）。; デフォルト: 0.1 |
| --device.driverstate.minAwareness <FLOAT> | 運転者の認知度における最小許容値。; デフォルト: 0.1 |
| --device.driverstate.maximalReactionTime <FLOAT> | 認識レベル低下（認識レベル=minAwareness時に到達）によって引き起こされる最大反応時間（～アクションステップ長）。; デフォルト: -1 |
ブルーライトデバイス¶
| オプション | 説明 |
|---|---|
| --device.bluelight.probability <FLOAT> | 車両が「ブルーライト」デバイスを装備する確率; デフォルト: -1 |
| --device.bluelight.deterministic {{ DT_STR_LIST }} | 名前付き車両に「ブルーライト」デバイスを割り当てる |
| --device.bluelight.deterministic <BOOL> | 「ブルーライト」デバイスを1000分の確率で確定的に設定する; デフォルト: false |
| - -device.bluelight.reactiondist <FLOAT> | 他のドライバーが青色灯とサイレン音に反応する距離を設定します; デフォルト: 25 |
| --device.bluelight.mingapfactor <FLOAT> | 反応する車両のminGapを指定された係数だけ減少させます; デフォルト: 1 |
Fcd デバイス¶
| オプション | 説明 |
|---|---|
| --device.fcd.probability <FLOAT> | 車両が "fcd" デバイスを持つ確率; デフォルト: -1 |
| - -device.fcd.explicit {{ DT_STR_LIST }} | 指定車両に「fcd」デバイスを割り当てる |
| --device.fcd.deterministic <BOOL> | 「fcd」デバイスを1000分の確率で確定的に設定する; デフォルト: false |
| --device.fcd.begin <STRING> | FCDデータの記録開始時刻; デフォルト: -1 |
| --device.fcd.period <STRING> | FCDデータの記録期間; デフォルト: 0 |
| --device.fcd.radius <FLOAT> | 装備車両周辺の半径内にあるオブジェクトを記録; デフォルト: 0 |
| --person-device.fcd.probability <FLOAT> | 人物が "fcd" デバイスを所持する確率; デフォルト: -1 |
| --person-device.fcd.explicit {{ DT_STR_LIST }} | 名前付き人物に "fcd" デバイスを割り当てる |
| --person-device.fcd.deterministic <BOOL> | "fcd"デバイスの設定を1000分の確率で確定的に行うか； デフォルト: false |
| --person-device.fcd.period <STRING> | FCDデータの記録期間； デフォルト: 0 |
エレキハイブリッドデバイス¶
| オプション | 説明 |
|---|---|
| --device.elechybrid.probability <FLOAT> | 車両が "elechybrid" デバイスを持つ確率; デフォルト: -1 |
| --device.elechybrid.explicit {{ DT_STR_LIST }} | 指定車両に "elechybrid" デバイスを割り当てる |
| ** --device.elechybrid.deterministic** <BOOL> | 「エレキハイブリッド」デバイスを1000分の確率で確定的に設定する； デフォルト: false |
タクシーデバイス¶
| オプション | 説明 |
|---|---|
| --device.taxi.probability <FLOAT> | 車両が「taxi」デバイスを持つ確率; デフォルト: -1 |
| --device.taxi.explicit {{ DT_STR_LIST }} | 名前付き車両に「タクシー」デバイスを割り当てる |
| --device.taxi.deterministic <BOOL> | 「タクシー」デバイスを1000分の確率で確定的に設定する; デフォルト: |
| --device.taxi.dispatch-algorithm <STRING> | 配車アルゴリズム [greedy,greedyClosest,greedyShared,routeExtension,traci]； デフォルト: greedy |
| --device.taxi.dispatch-algorithm.output <FILE> | ディスパッチアルゴリズムの情報を FILE に書き出す |
| --device.taxi.dispatch-algorithm.params <STRING> | ディスパッチアルゴリズムのパラメータを KEY1:VALUE1[,KEY2:VALUE] 形式で読み込む |
| - -device.taxi.dispatch-period <TIME> | ディスパッチャーへの連続した呼び出しの間隔; デフォルト: 60 |
| - -device.taxi.idle-algorithm <STRING> | 待機タクシーの動作 [停止,ランダム巡回,タクシー待機場]; デフォルト: 停止 |
| --device.taxi.idle-algorithm.output <FILE> | 待機アルゴリズムの情報をFILEに書き込む |
Glosa デバイス¶
| オプション | 説明 |
|---|---|
| --device.glosa.probability <FLOAT> | 車両が "glosa" デバイスを持つ確率; デフォルト: -1 |
| --device.glosa.explicit {{ DT_STR_LIST }} | 名前付き車両に「glosa」デバイスを割り当てる |
| --device.glosa.deterministic <BOOL> | 「glosa」デバイスを1000分の割合で確定的に設定する; デフォルト: false |
| - -device.glosa.range <FLOAT> | 信号機への通信範囲; デフォルト: 100 |
| --device.glosa.max-speedfactor <FLOAT> | 青信号接近時の最大速度係数; デフォルト: 1.1 |
| --device. glosa.min-speed <FLOAT> | 赤信号に向かって惰行する時の最低速度; デフォルト: 5 |
| --device.glosa.add-switchtime <FLOAT> | 信号が青に変わった後、車両が交差点に到達するまでに必要な追加時間; デフォルト: 0 |
| --device.glosa.use-queue <BOOL> | GLOSA計算にTLS前方の待ち行列を使用する； デフォルト: false |
| --device.glosa.override-safety <BOOL> | 安全機能をオーバーライド - 現在の信号状態を無視し、常にGLOSAの予測状態に従う； デフォルト: false |
| --device.glosa.ignore-cfmodel <BOOL> | 車両は完全な速度計算に従う - 安全上重要でない場合、CFモデルからの速度計算を無視する; デフォルト: false |
Tripinfoデバイス¶
| オプション | 説明 |
|---|---|
| --device.tripinfo.probability <FLOAT> | 車両が「tripinfo」デバイスを持つ確率; デフォルト: -1 |
| --device.tripinfo.explicit {{ DT_STR_LIST }} | 名前付き車両に「tripinfo」デバイスを割り当てる |
| --device.tripinfo.deterministic <BOOL> | 「tripinfo」デバイスは1000分の1の割合で決定論的に設定される; デフォルト: false |
Vehroutes デバイス¶
| オプション | 説明 |
|---|---|
| --device.vehroute.probability <FLOAT> | 車両が "vehroute" デバイスを持つ確率; デフォルト: -1 |
| --device.vehroute.explicit {{ DT_STR_LIST }} | 名前付き車両に "vehroute" デバイスを割り当てる |
| --device.vehroute.deterministic <BOOL> | "vehroute" デバイスを 1000 分の確率で確定的に設定する; デフォルト: false |
摩擦デバイス¶
| オプション | 説明 |
|---|---|
| --device.friction.probability <FLOAT> | 車両が「friction」デバイスを持つ確率; デフォルト: -1 |
| --device.friction.explicit {{ DT_STR_LIST }} | 名前付き車両に「friction」デバイスを割り当てる |
| --device.friction.deterministic <BOOL> | 「friction」デバイスを1000分の確率で確定的に設定する; デフォルト: false |
| - -device.friction.stdDev <FLOAT> | 摩擦デバイスに適用可能な測定ノイズパラメータ; デフォルト: 0.1 |
| --device.friction.offset <FLOAT> | 摩擦デバイスに適用可能な測定オフセットパラメータ -> 例: 誤った測定を強制する場合; デフォルト: 0 |
Fcd リプレイデバイス¶
| オプション | 説明 |
|---|---|
| --device.fcd-replay.probability <FLOAT> | 車両が "fcd-replay" デバイスを持つ確率; デフォルト: -1 |
| --device.fcd-replay.explicit { {DT_STR_LIST}} | 名前付き車両に「fcd-replay」デバイスを割り当てる |
| --device.fcd-replay.deterministic <BOOL> | 「fcd-replay」デバイスは1000分の1の確率で決定論的に設定される； デフォルト: * false* |
| --device.fcd-replay.file <FILE> | 読み込むFCDファイル |
Traciサーバー¶
| オプション | 説明 |
|---|---|
| --remote-port <INT> | 設定するとTraCIサーバーを有効化; デフォルト: 0 |
| --num-clients <INT> | 接続クライアントの想定数; デフォルト: 1 |
メゾスコピック¶
| オプション | 説明 |
|---|---|
| --mesosim <BOOL> | メゾスコピックシミュレーションを有効化; デフォルト: false |
| --meso-edgelength <FLOAT> | メゾスコピックシミュレーションにおけるエッジセグメントの長さ; デフォルト: 98 |
| --meso-tauff <TIME> | 純粋な自由走行間隔時間を計算するための係数; デフォルト: 1.13 |
| --meso-taufj <TIME> | 純粋な渋滞間隔時間を計算するための係数; デフォルト: 1.13 |
| --meso-taujf <TIME> | 渋滞なし車間時間の計算係数; デフォルト: 1.73 |
| --meso-taujj <TIME> | 渋滞-渋滞間隔時間を計算するための係数; デフォルト: 1.4 |
| --meso-jam-threshold <FLOAT> | セグメントを渋滞とみなすための占有スペースの最小割合。負の引数を指定すると、エッジ速度とタウフに基づいて閾値が計算される（デフォルト）。デフォルト: -1 |
| --meso-multi-queue <BOOL> | エッジ端点での複数キューを有効化。デフォルト: true |
| --meso-lane-queue <BOOL> | 全車線ごとに個別のキューを有効化； デフォルト: false |
| --meso-ignore-lanes-by-vclass {{ DT_STR_LIST }} | 指定されたvclassのみを許可する車線に対してキューを構築しない（または容量を削減しない）； デフォルト: pedestrian,bicycle |
| --meso-junction-control <BOOL> | メソスコピック信号機と優先交差点処理を有効化; デフォルト: false |
| --meso-junction-control.limited <BOOL> | 飽和リンクに対してメソスコピック信号機と優先交差点処理を有効化。これにより、交通量の少ない状況で故障した信号機が流れを妨げるのを防ぎます; デフォルト: false |
| --meso-tls-penalty <FLOAT> | 実際のフェーズを確認する代わりに、緑分割に基づいてTLS制御交差点を通過する際にスケーリングされた旅行時間ペナルティを適用します; デフォルト: 0 |
| - -meso-tls-flow-penalty <FLOAT> | 実際の信号フェーズを確認せず、青信号分割時間に基づいてTLS制御交差点を通過する際、スケーリングされたヘッドウェイペナルティを適用します； デフォルト: * 0* |
| --meso-minor-penalty <TIME> | 低優先度リンクを走行する際、固定時間ペナルティを適用。--meso-junction-control.limited使用時、制限制御が有効な場合はペナルティを適用しない。; デフォルト: 0 |
| --meso-overtaking <BOOL> | メゾスコピック追い越しを有効化； デフォルト: false |
| --meso-recheck <BOOL> | 挿入失敗後の次区間再チェック間隔； デフォルト: 0 |
乱数¶
| オプション | 説明 |
|---|---|
| --random <BOOL> | 乱数生成器を現在のシステム時刻で初期化します; デフォルト: false |
| --seed <INT> | 指定された値で乱数生成器を初期化します; デフォルト: 23423 |
| --thread-rngs <INT> | 繰り返し可能なマルチスレッドシミュレーションを保証するための事前割り当て乱数生成器の数（繰り返し可能なシミュレーションのためには少なくともスレッド数と同数であるべき）。; デフォルト: 64 |
GUI専用¶
| オプション | 説明 |
|---|---|
| -g <FILE> --gui-settings-file <FILE> |
FILE から視覚化設定を読み込み |
| -Q <BOOL> --quit-on-end <BOOL> |
シミュレーション終了時にGUIを終了する; デフォルト: false |
| -G <BOOL> --game <BOOL> |
ゲームモードでGUIを起動; デフォルト: false |
| --game.mode <STRING> | ゲームタイプを選択 ("tls", "drt"); デフォルト: tls |
| -S <BOOL> --start <BOOL> |
ロード後にシミュレーションを開始する; デフォルト: false |
| -d <FLOAT> --delay <FLOAT> |
シミュレーションステップ間の遅延としてミリ秒単位の浮動小数点数を使用; デフォルト: 0 |
| -B {{ DT_STR_LIST }} --breakpoints {{ DT_STR_LIST }} |
シミュレーションを停止すべき時刻として TIME[] を使用 |
| --edgedata-files <FILE> | 可視化用のエッジ/レーン重みを FILE から読み込み |
| -N <FILE> --alternative-net-file <FILE> |
抽象化可視化用の二次道路ネットワークをFILEから読み込み |
| --selection-file <FILE> | FILE から事前選択された要素を読み込む |
| -D <BOOL> --demo <BOOL> |
終了後にシミュレーションを再開する（デモモード）； デフォルト: false |
| -T <BOOL> --disable-textures <BOOL> |
背景画像をロードしない; デフォルト: false |
| --registry-viewport <BOOL> | レジストリから現在のビューポートをロード; デフォルト: false |
| --window-size {{ DT_STR_LIST }} | 指定されたx,yサイズで初期ウィンドウを作成 |
| --window-pos {{ DT_STR_LIST }} | 指定されたx,y位置で初期ウィンドウを作成 |
| --tracker-interval <TIME> | 値トラッカーウィンドウの集約期間; デフォルト: 1 |
| --osg-view <BOOL> | 通常の2DビューではなくOpenSceneGraphビューで開始; デフォルト: false |
| --gui-testing <BOOL> | 画面認識用オーバーレイを有効化; デフォルト: false |
| --gui-testing-debug <BOOL> | GUIテスト中の出力メッセージを有効化; デフォルト: false |
| --gui-testing.setting-output <FILE> | 指定された設定出力ファイルにGUI設定を保存 |
入力ファイルの読み込み順序¶
Sumoは入力ファイルを以下の順序で読み込みます
- netファイル
- 追加ファイル
- 重みファイル
- 状態ファイル
- 経路ファイル
入力ファイルで定義されたシミュレーションオブジェクト A (車両など) が別のシミュレーションオブジェクト B (車両タイプなど) を参照する場合、対応するオブジェクト B は、A より前に定義されている必要があります。 これは、B をより早く読み込まれるファイルに記述するか、同じファイル内でより早い行に記述することで実現できます。 これは特に、--route-files <FILE> および --additional-files <FILE> オプションで読み込まれるファイルに関して重要です。
これは特に、--route-files <FILE> および --additional-files <FILE> で読み込まれるファイルに関して重要です。
--route-files <FILE> の最も重要な特徴は、 ファイルを段階的に読み込むことでメモリを節約する点です。
ただし、これは車両と交通流が時刻 departure および begin ソートされている必要があることを意味します。
オプション--additional-files <FILE>は--route-files <FILE>より先に処理され、指定されたファイルはシミュレーション開始前に完全に 読み込まれます。
route-fileに記述可能な全ての項目は additional-fileにも記述可能です (車両のソートは不要) 。
一部のオブジェクト（出力オブジェクトなど）は シミュレーション開始時に利用可能である必要があり、このオプションでロードする必要があります。
また、<vType>要素、<route>要素、<routeDistribution>など経路ファイルから参照される要素のロードにも有用です。
複数のファイルをカンマ区切りリストで指定した場合、左から右にロードされます。
追加ファイルの形式¶
--additional-files <FILE> オプションで読み込まれるファイルには、ネットワーク 要素の幅広い種類を含めることができます。例：信号機プログラム、検知器定義、 可変速度標識、バス停などです。 可変速度標識、 バス停 など、様々なネットワーク要素を含みます。 これらのファイルは、エッジベースの交通量測定値 や 信号機切り替え情報 といったシミュレーション出力の設定にも使用されます。 さらに、vTypes や routes など、ルートファイルで許可されているあらゆる要素を含めることができます。 さらに、ルートファイルで許可されている要素（vTypes、 routes および vehicles を追加できます。 全ての要素は同一の追加ファイルに記述するか、必要に応じて複数のファイルに分割できます。
追加ファイルには常に任意の名称のトップレベルタグが必要です (additionalが慣例です)。以下に例を示します:
<additional>
<inductionLoop id="myLoop1" lane="foo_0" pos="42" period="900" file="out.xml"/>
<inductionLoop id="myLoop2" lane="foo_2" pos="42" period="900" file="out.xml"/>
<busStop id="station1" lane="foo_0" startPos="5" endPos="20"/>
<vType id="bus" maxSpeed="20" length="12"/>
</additional>