¶ Digital Twin Toolkit ガイド

Dynamita の Digital Twin Toolkit とは何でしょうか。

• SUMO 数値エンジンに対する一連の API
  • C/C++ API - 数値エンジンの特定の機能を呼び出すための低レベルな関数 API
  • Python API - C/C++ API と SUMO scheduler への Python ラッパー
    • sumon.py - C/C++ API を介した数値エンジンへの直接接続
    • scheduler.py - SUMO scheduler を介した数値エンジンへの接続
• 外部アプリケーション開発を容易にするために C/C++、C#、Python で書かれたツール群：
  • scli - SUMO のコマンドラインインターフェース（インタープリタ）。SUMO アプリケーションの外部で、指定したモデル（.sumo プロジェクトからコンパイルされたライブラリ）を単独で実行するために使用できます。また、プログラミング言語に依存しない数値エンジンへの接続の基盤でもあります。
  • SUMO scheduler - 並列シミュレーションの実行を担うモジュール
  • SUMO OPC UA interface - OPC Foundation が提供する OPC UA ライブラリのラッパー（Windows 専用）
  • OPC Dashboard - テストおよびマッピング（SUMO シンボルと OPC データタグの対応付け）のためのツール。SUMO アプリケーションの一部（Windows 専用）
  • Python tools - SUMO を使用する外部アプリケーションの開発を支援するさまざまな Python モジュール
    • tool.py - .sumo プロジェクトファイルから有用な情報を抽出するのに役立ちます
    • dmqclient.py、dtcontrol.py - SUMO OPC UA interface を使用した OPC 通信のヘルパー（Windows 専用）。

ツールキットを使用するには DTT ライセンスが必要です。

¶ Windows への DTT のインストール

Dynamita の ウェブサイト からダウンロードした DTT アドオンをインストールします。このアドオンは Digital Twin 製品として提供されています。ダウンロード後、SumoDTT24.dya ファイルをダブルクリックすると、必要なモジュールが SUMO のインストールフォルダにコピーされます。なお、SUMO のインストールフォルダ内に新しく PythonAPI フォルダが作成され、SUMO Python API とツールが格納されます。

¶ Linux への DTT のインストール

Linux で使用する SUMO DTT モジュールは、Dynamita の Docker Hub の ページ で提供される Docker コンテナイメージにまとめて同梱されています。このイメージには適切な SUMO24 ランタイム、C/C++ コンパイラ、Python 3.12 が含まれ、Ubuntu 24.04 をベースとしています（これらは、より新しい Ubuntu や SUMO のバージョンがリリースされるにつれて今後変更される可能性があります）。これが Linux で SUMO を使用する推奨方法です。

SUMO ランタイムは Docker を使わずに Linux コンピュータや VM にインストールすることもできますが、相応の専門知識が必要です。その場合は Dynamita のサポートにお問い合わせください。

¶ ライセンスの取り扱い

SUMO のライセンスには主要なタイプが複数あり、さらにサブタイプがあります：

• standalone - ソフトロックライセンス（Windows 専用）
• mobile - USB ハードウェアキーライセンス（Windows 専用）
• network - 柔軟なマルチユーザーライセンス（Windows 専用）。サーバーへの SUMO Network License Service のインストール、または Dynamita のライセンスサーバーの利用が必要です。SUMO Network License Service 自体は、現時点では Windows 専用です。
• container - Windows と Linux の両方に対応する柔軟なマルチユーザーライセンスで、Docker コンテナでも動作します。サーバーへの SUMO Container License Service のインストールが必要です。SUMO Container License Service 自体は、現時点では Windows 専用です。

ライセンスのサブタイプは次のとおりです：

• normal - Windows 上で SUMO アプリケーションを使用できます
• DTT - normal と同様で、加えて外部アプリケーション向けに SUMO API を開放します（Windows、および SUMO ユーザーインターフェースなしの Linux）
• JSON extractor - normal に加えてシンボル抽出機能を提供し、SUMO アプリケーションからアクセスできます。SUMO プロジェクトからのシンボル（パラメータおよび変数）の抽出が可能です。

DTT ライセンスと JSON ライセンスは、組み合わせても個別に使用してもかまいません。

¶ 重要

外部アプリケーション開発の場合は DTT サブタイプが必要です。主要タイプは開発プラットフォームに依存します。Docker コンテナでは、container 主要タイプと DTT サブタイプが必要になります。

¶ マシン識別コード（MIC）

SUMO ライセンスを取得するには MIC が必要です。Windows では SUMO アプリケーションを使用して MIC を取得できます。ランタイムのみをインストールしている場合は、scli（SUMO コマンドラインインタープリタ）を使用して MIC を取得できます。

Linux では、コンピュータの MIC を取得できるのは scli のみです。Docker コンテナでは MIC は不要で、アプリケーションは container ライセンスを使用します。

scli は、SUMO ランタイムのファイルが置かれているフォルダにあります。ターミナルウィンドウで次のコマンドを入力できます：

scli .

または Linux では：

./scli .

インタープリタが起動し、コマンドの入力を待ちます。scli-mic コマンドを入力して Enter キーを押します。次の形式で MIC が出力されます：

scli-result scli-mic HEGASFHDHDHWHGKARQKTUWWIZUDJXEUJKJATSZJERHEZZKZKDOUJFJUHWHTDTDGKFGHDHIRDJAKK

MIC の部分を選択してコピーし、Dynamita サポートに送信してライセンスを取得してください。

scli は scli-exit コマンドで終了します。

¶ OPC 接続

OPC UA（Open Platform Communications, Unified Architecture）は、ハードウェア機器（センサー、シーケンサー）とアプリケーションの間のデータ交換プラットフォームです。OPC Foundation によって開発されています。

SUMO は、OPC Foundation が提供する C# ライブラリを、Dynamita が開発した簡易なラッパーを介して使用します。

SUMO は OPC サーバーに接続するものであり、ハードウェアに直接接続するわけではありません。Dynamita は、OPC サーバーおよびハードウェア接続に関するサポートは提供していません。OPC 接続の詳細については、次の Wiki 記事 を参照してください。