利用可能なウィジェットアクション

SCADA APIを使用すると、GUIを手動で操作する代わりに、ウィジェットのアクションをプログラムで実行できます。この便利な機能により、HIL SCADAでシミュレーションを実行する際のいくつかの手順を自動化できます。

execute_action() 関数には、widget_handle と action_name という 2 つの必須引数が必要です。

他のオプションのキーワード引数 (arg_name=arg_value) も受け取ることができます。これは各ウィジェットの実装によって異なります。

例:

# ウィジェット ID を保存w_id = "484d3a86ffcf11e9956de0d55e6b2045" # 変更する必要があるウィジェットを取得します (この場合は、Capture/Scope ウィジェット) wh = panel . get_widget_by_id ( w_id ) # "force_trigger" アクション (api_const.ACT_CS_FORCE_TRIGGER) を実行panel . execute_action ( widget_handle = wh , action_name = api_const . ACT_CS_FORCE_TRIGGER ) # 5 秒間待機します (これにより、以降のコード実行がブロックされ、C/S ウィジェットにデータをキャプチャする時間が与えられます) hil . wait_sec ( 5 ) # 「export_data」アクション (api_const.ACT_CS_EXPORT_DATA) を実行# キャプチャされたデータは hdf5 テーブル形式で「D:\\MyFolder\\capture_data.h5」ファイルにエクスポートされます。 # キャプチャされたすべての信号のうち、 「Signal1」、「Signal3」、「Signal7」という名前の 3 つの信号のみがエクスポートされますpanel . execute_action ( widget_handle = wh , action_name = api_const . ACT_CS_EXPORT_DATA , format = "hdf5 table" , signal = [ "Signal1" , "Signal3" , "Signal7" ], path = "D: \\ MyFolder \\ capture_data.h5" )

以下はウィジェットと現在サポートされているアクションのリストです。

キャプチャ/スコープウィジェット

アクション名

説明

議論

ACT_CS_FORCE_TRIGGER または「force_trigger」

これにより、ウィジェットの現在の設定(サンプルレートと周期、目的の信号、トリガー設定)でキャプチャトリガーが強制されます。

このアクションにはオプションの引数はありません

ACT_CS_ENABLE_TRIGGER または「enable_trigger」

これにより、ウィジェットの現在の設定(サンプルレートと周期、必要な信号、トリガー設定)でキャプチャトリガーが有効になり(トリガーを起動してデータ取得を開始します)、

このアクションにはオプションの引数はありません

ACT_CS_STOP_CAPTURE または「stop_capture」

これによりキャプチャプロセスが停止し、既存のデータが取得されます。

このアクションにはオプションの引数はありません

ACT_CS_エクスポート_データ または「export_data」

これにより、キャプチャされたデータ (存在する場合) がさまざまな形式でエクスポートされます。

オプションの引数は 形式, 信号 そして パス.

注記

その 形式 フォーマット タイプを持つ文字列です。

サポートされている形式:

「png」  「csv」  「mat」  「hdf5 固定」  「hdf5 テーブル」  「mdf4」  「cff」

もし 形式 指定されていない場合は、デフォルトの形式は「png」になります。

注記

その 信号 引数は文字列のリストであり、各文字列はキャプチャされた信号の名前と一致する必要があります。

もし 信号 指定されていない場合は、キャプチャされたすべての信号がエクスポートされます。

注記

もし、 パス 文字列引数が渡されると、キャプチャされたデータは指定されたファイルにエクスポートされます。

ただし、パス引数が渡されない場合は、デフォルトのエクスポートパス(%appdata% フォルダ内の Typhoon フォルダ)が使用されます。「\\」などの特殊文字はエスケープする必要があり、完全なファイルパスには拡張子も含める必要があります。

サポートされている拡張機能のマッピング:

「csv」 : 「.csv」 「mat」 : 「.mat」 「hdf5 テーブル」 : 「.h5」 「hdf5 固定」 : 「.h5」 「tdms」 : 「.tdms」 「mdf4」 : 「.mf4」 「cff」 : 「.cff」 「png」 : 「.png」