SUMO SUMO Wiki

Wiki カテゴリ&ファイル

ホーム Home
SUMO スターターキット SUMO Starter kit
SUMO 技術リファレンス SUMO Technical Reference
上級ユーザー向けトピック Advanced User Topics
開発者向けトピック Developer Topics
デジタルツインツールキット Digital Twin Toolkit

目次

path

コマンド path <folder>
説明 現在の作業ディレクトリ（カレントワーキングディレクトリ）を設定します。
引数
folder現在の作業ディレクトリがこのフォルダーに変更されます
例 <span class="text-small">path c:/;</span> 応答 530007 Path set to: "\1".

reset

コマンド reset
説明 すべての変数を工場出荷時の初期値にリセットします。パラメータ、動的入力、状態変数の値はすべて失われます。
応答 530011 Reset

set

コマンド set <variable> <value>
説明 変数に指定した値を設定します。 次元（dimension）変数を変更すると、それに接続されているすべての配列が自動的にリサイズされます。シミュレーションの実行中にこれが発生した場合、シミュレーションは停止します。
引数
variable変数のフルネーム。役割（role）が SystemParameter、Parameter、Dimension、または Constant である変数のみ設定できます。
value値の型は変数の型と一致している必要があります。
例 <span class="text-small">set Sumo__Plant__Unit__param__Scalar 1;</span>
<span class="text-small">set Sumo__Plant__Unit__param__Array 1 2 3;</span>
<span class="text-small">set Sumo__Plant__Unit__param__Array(0) 1;</span>
応答 530021 Set: \1 to \2

mode

コマンド mode <mode>
説明 シミュレーションモードを設定します。algebraic（代数）モードは専用の Algebraic ブロック内での非常に単純な計算用です。dynamic（動的）モードは動的シミュレーションを実行します。steady（定常）モードは定常状態を計算します。
引数
modealgebraic、dynamic、または steady
例 <span class="text-small">mode dynamic;</span> 応答 530053 Mode: \1.

save

コマンド save <filename>
説明 すべての変数を xml 形式で保存します。保存したファイルは load コマンドで読み戻すことができます。
引数
filename作成するファイルの名前（またはフルパス）
例 <span class="text-small">save systemstate.xml;</span>
<span class="text-small">save "c:/Users/UserName with Spaces/systemstate.xml";</span> 応答 530045 Current systemstate saved to "\1".

load

コマンド load <filename> [-partial 1]
説明 すべての変数を xml 形式から読み込みます。同じモデルで save コマンドを使って作成した systemstate ファイルに対してのみ使用できます。
引数
filename開くファイルの名前（またはフルパス）
-partial 1オプション。モデルが一致しない場合でも、一致する変数のみを読み戻します。それ以外はすべて無視されます。
例 <span class="text-small">load systemstate.xml;</span>
<span class="text-small">load "c:/Users/UserName with Spaces/systemstate.xml" -partial 1;</span> 応答 530041 Systemstate loaded from "\1".

savestates

コマンド savestates <filename>
説明 すべての状態変数を xml 形式で保存します。保存したファイルは loadstates コマンドで読み戻すことができます。
引数
filename作成するファイルの名前（またはフルパス）
例 <span class="text-small">savestates state.ss;</span>
<span class="text-small">savestates "c:/Users/UserName with Spaces/state.ss";</span> 応答 530045 Current systemstate saved to "\1".

loadstates

コマンド loadstates <filename> [-partial 1] [-if-better-by <value>] [-maptoic]
説明 すべての状態変数を xml 形式から読み込みます。同じモデルで savestates コマンドを使って作成した systemstate ファイルに対してのみ使用できます。
引数
filename開くファイルの名前（またはフルパス）
-partial 1オプション。モデルが一致しない場合でも、一致する変数のみを読み戻します。それ以外はすべて無視されます。
-if-better-by <value>オプション。指定した場合、Sumo__MaxAbsDer が現在の値を指定値で割った値より大きいときは、コアは状態を読み戻しません。
-maptoicオプション。コマンドが成功した場合、続けて maptoic コマンドを実行します。
例 <span class="text-small">loadstates state.ss;</span>
<span class="text-small">loadstates "c:/Users/UserName with Spaces/systemstate.xml" -partial 1 -if-better-by 10 -maptoic;</span> 応答 530041 Systemstate loaded from "\1".

loadtsv

コマンド loadtsv <filename> [-cycletime <value>] [-interpolation <value>]
説明 tsv ファイルから動的入力テーブルを読み込みます。ファイルには対象変数のフルネームを記載し、数値はコード内単位（in-code units）で、先頭列は Sumo__Time を日単位で記載する必要があります。 ファイルを変更した場合は、そのファイルに対して unloadtsv を実行してから、再度 loadtsv を使用してコア内の値を更新する必要があります。
引数
filename開くファイルの名前（またはフルパス）
-cycletime <value>オプション。設定した場合、動的入力は <value> ミリ秒ごとに繰り返し開始されます。この時間を超える動的入力の値は、警告とともに無視されます。
-interpolation <value>オプション。none または linear を指定できます。このフラグを設定しない場合、デフォルトの補間は none です。
例 <span class="text-small">loadtsv input.tsv;</span>

ここで input.tsv は例えば次のようなものです。

Sumo__TimeSumo__Plant__Influent__param__Q
024000
112000
224000
応答 530029 TSV file "\1" loaded with \2 interpolation.
530030 TSV file "\1" loaded.
530042 TSV file "\1" loaded with \2 cyclestart and \3 cycletime.
530043 TSV file "\1" loaded with \2 interpolation, \3 cyclestart and \4 cycletime.

unloadtsv

コマンド unloadtsv <filename>
説明 以前に読み込んだ対象の動的入力ファイルをアンロードします。
引数
filenameアンロードするファイルの名前（またはフルパス）。loadtsv コマンドに与えた引数とまったく同じである必要があり、ファイルがすでに存在していなくても構いません。
例 <span class="text-small">unloadtsv input.tsv;</span> 応答 530050 TSV file "\1" unloaded.

writetsv

コマンド writetsv <filename> [<variableslist_filename>]
説明 すべての datacomm からのシミュレーションデータを含む tsv ファイルを作成します。書き込んだファイルを解放するには、引数なしで writetsv コマンドを実行する必要があります。
引数
filename書き込むファイルの名前（またはフルパス）。
variableslist_filenameオプション。変数のリスト（1 行に 1 変数）を含むファイルの名前（またはフルパス）。省略した場合は、すべての変数がファイルに保存されます。
例 <span class="text-small">writetsv output.tsv;</span> 応答 530037 TSV writer: "\1" all variables.
530038 TSV writer: "\1" variables from file "\2".
530047 TSV writer: writing disabled.

maptoic

コマンド maptoic
説明 状態変数を初期条件（initial condition）にマッピングします。
応答 530019 Mapping to initial conditions.

execute

コマンド execute <filename>
説明 対象の sumocore スクリプトを実行します。ファイルにはセミコロン（';'）で区切られた sumocore コマンドを記載する必要があります。
引数
filename実行するファイルの名前（またはフルパス）。
例 <span class="text-small">execute myscript.scs;</span> 応答 530036 Script file \1 loaded.

start

コマンド start
説明 事前に mode コマンドで選択したモードでシミュレーションを開始します。
応答 530002 Simulation started.

pause

コマンド pause
説明 シミュレーションを一時停止します。
応答 530003 Simulation paused.

continue

コマンド continue
説明 シミュレーションを再開します。
応答 530008 Simulation continues...

stop

コマンド stop
説明 シミュレーションを停止します。
応答 530004 Simulation ended.