¶dynamita.tool.py ドキュメンテーション

次のいずれかになっていることを確認してください：

• Dynamita の Python モジュールがお使いの Python にインストールされている または
• Dynamita の Python モジュールを含む dynamita フォルダがプロジェクトディレクトリ内にコピーされている

import dynamita.tool.py as dtool

def convert_to_data(s: str):

文字列を SUMO の標準に従って適切なデータ型に変換します。

変換されたデータを格納した整数、浮動小数点数、文字列または配列

print(dtool.convert_to_data("4.0;3.2;8.0"))
# [4.0, 3.2, 8.0] を出力します
print(dtool.convert_to_data("5.1"))
# 5.1 を出力します

def read_sumocore_xml(file_name: str) -> dict:

SumoCore の「save」コマンドによって生成された xml 状態を読み取ります。

string -> VariableEntry の辞書。キーは変数名です。

def write_sumocore_xml(file_name: str, data: dict):

SumoCore の「load」コマンドで読み込める xml 状態を書き込みます。この関数を使用する場合は、read_sumocore_xml で既存の状態を読み取り、それを修正してから書き戻すようにしてください。こうすることで、モデルに存在するすべての変数が確実に含まれるようになります。

なし

def write_sumocore_script(file_name: str, data: dict):

SumoCore で「execute」コマンドを使って実行できる SumoCore スクリプト（.*scs）を書き込みます。

なし

def create_array(begin, end = None, step = None, count = None, includeEnd = True)

指定された引数に基づいて配列を生成します。begin を指定し、他の 3 つの制御用引数（end、step、count）のうち 2 つを指定する必要があります。

生成された配列

dtool.create_array(begin = 1, end = 3, step = 1, includeEnd = True)

[1,2,3]

dtool.create_array(begin = 1, end = 3, count = 2, includeEnd = False)

[1,2]

dtool.create_array(begin = 1, end = 3, count = 2, includeEnd = True)

[1,3]

dtool.create_array(begin = 1, step = 2, count = 3, includeEnd = False)

[1,3,5]

def extract_dll_from_project(project : str, path_to : str):

.sumo プロジェクトから dll ファイルを抽出します。この dll は SumoCore に読み込んでシミュレーションを実行するために使用できます。

なし

def extract_misc_from_project(project : str, what : str, path_to : str):

.sumo プロジェクトから任意のファイルを抽出します。この関数を使用して、プロジェクトに保存された state.xml ファイルを抽出できます。

なし

def extract_parameters_from_project(project : str, tsvdir : str, script_to : str, scenario : str = "") -> bool:

プロジェクトから、SUMO GUI に表示されるとおりにパラメータを設定するスクリプトを抽出します。動的テーブルも含まれます。このスクリプトは SumoCore で「execute」コマンドを使って実行できます。

bool（関数の定義による。原文には説明がありません）

def create_temp_folder(base : str):

ランダムな 8 文字のフォルダを作成します。プロジェクトの dll や初期化スクリプトなど、抽出した SUMO プロジェクトのアーティファクトを保存するのに利用できます。これらのフォルダは、Python アプリケーションフォルダを整理するために安全に削除できます。

作成したフォルダ名。