こんには，トレニングエンジニアの遠藤です。

このブログでは”MATLABと仿真金宝app软件を繋ぐ”をテーマとして,MATLABと仿真软件を連携させる機能に関して技術的な記事を書いております。今回もこのテーマに則り,MATLABと仿真金宝app软件を繋ぐ代表的な機能の一つである“模型API”について書いていきたいと思います。

金宝appSimulink APIにいては，以前投稿した”金宝appSimulink APIでMATLABからSimulinkを操るという記事でも紹介しました。その記事では,モデルのブロックパラメータやコンフィグレーションパラメータを取得・変更する方法を解説しましたが,今回の記事では,ブロックの追加や信号線の結線など,モデルの構造そのものをプログラムで編集する方法を紹介したいと思います。

プログラムでモデルを編集する方法は，

• 複数のモデルに共通するミスを修正する
• テスト用のモデルを自動で生成する
• モデルを規格に準拠した構造に修正する

といったように,決まった編集方法を何度も繰り返さなければならない場合や,ブロックの見落とし,修正忘れなどのヒューマンエラーを防ぎたい場合に有効です。その分少し複雑なコードを書く必要がありますが,プログラミング好きな模金宝app型使いの方は,新たなモデル編集方法に惹かれること間違いなし(?)です!

今回の目標

今回の記事では,MATLABにデフォルトで入っているvdpというモデルを題材とし,仿真软金宝app件APIを使って出力端子1の直前に死区ブロックを挿入してみたいと思います。

> > vdp% VDPモデルを起動

マウス操作では一瞬でできてしまう作業ですが，プログラムで行おうとすると結構手間がかかります。具体的には，以下の操作を順番に行っていく必要があります。

1. 死亡地带ブロックをモデルに追加する
2. モデル上の输出端口ブロックを検出する
3. 検出した输出端口ブロックに繋がっている信号線を取得する
4. 取得した信号線の接続元を保存し，信号線を削除する
5. 新しい信号線を死亡区ブロックに繋ぐ

これらの操作をS金宝appimulink APIでどうやって行うか，順番に確認してみましょう!

※こらのドキュメントも合わせてご確認いただくと，よりわかりやすいかと思います。

1.ブロックの追加

まずはS金宝appimulinkモデルにブロックを追加する方法にいて説明します。モデル上にブロックを追加したい場合，add_blockという関数を使います。

> > add_block (“追加したいブロック名”，“モデル名/けたい名前”）;1つ目の入力は追加したいブロック名,2つ目の入力はモデル名と追加するブロックにつけたい名前を指定します。一見簡単な関数に見えますが，これが意外と厄介です。例えば，以下のようなコ，ドはエラ，となります。

> > add_block (“死区”，“vdp /死区”）;

“死亡地带”という名前のブロックがありません。

実は,add_blockで追加したいブロック名を指定する場合,そのブロックが入っているライブラリの階層も明示的に指定する必要があるのです。今回追加したい死区ブロックは,仿真软件/不连续とい金宝appうライブラリファイルの中に入っています。そのため，死区を追加する場合は，

> > add_block (“金宝app仿真软件/不连续/死区”，“vdp /死区”）;%死区ブロックを死区という名前でvdpモデルに追加

のように，ラ。

死亡区ブロックが，死亡区という名前で追加されました!

提示

数学操作や信号属性など,仿真软件ライブラリブラウザー上で名前が改行されているよ金宝appうなライブラリは,ライブラリ名に改行文字が含まれています。

このようなラ电子邮箱ブラリ名を指定する場合は，换行符関数を使うなどの方法で改行コ，ドを文字列の中に挿入する必要があるので注意が必要です。例えば、数学操作ライブラリーに入っている获得ブロックを追加する際,ブロック名を以下のようにして作成します。

>> name = [“数学”换行符“操作/增益”］

name =
的数学
操作/增益”

2.モデル上のブロックの検出

次は，モデル上の输出端口ブロックを検出します。モデル上の特定のブロックを検出するには，find_system関数を使用します。こらの関数は前回の記事でも紹介しましたね。find_system関数は、モデル名、パラメータ名、パラメータ値を指定することで、モデル内の特定のパラメータ値を持つブロックを検出することができます。

>> blocks = find_system(“モデル名”，“パラメ，タ名1”，“パラメ，タ値1”，“パラメ，タ名2”，“パラメ，タ値2”,……);

よく使うパラメ，タはBlockTypeで，特定の種類のブロックを簡単に検出することができます。

>> outports = find_system(“vdp”，“BlockType”，“输出港”）% vdpモデル内の输出端口ブロックを検出

外港=
2×1のcell配列
{' vdp /着干活'}
{' vdp / Out2 '}

vdpモデル内の2の输出端口ブロックを検出できました。中身はセル配列になっているので,外港{1}とすれば1個目の外港ブロックにアクセスできます。

提示

検出の際に使用可能なブロックのプロパティにいては，共通のブロックプロパティやブロック固有のパラメ，タのペ，ジをご参考ください。

3.ブロックに繋がっている信号線の取得

次に，検出した输出端口ブロックの入力端子に繋がっている信号線を取得します。そのためには，まず前回の記事でも紹介したget_param関数を使い，OutportブロックのPortHandlesパラメ，タを指定を取得します。PortHandlesパラメ，タには，そのブロックが持，端子情報が格納されています。

>> ph_outport = get_param(outports{1}，“PortHandles”）% 1目の输出端口ブロックの端子情報を取得

ph值=
フィ:ルドをも:
尺寸:451.0006
外港:[]
启用:[]
触发:[]
状态:[]
LConn: []
RConn: []
Ifaction: []
重置:[]

导入フィ，ルドに“451.0006”という数値が格納されていますね。これはOurportブロックの入力端子の"ハンドル"を表しています。ハンドルとは,モデル上のブロックや信号,端子などのオブジェクトつ1つに割り振られたID番号のようなものです。

この入力端子のハンドルに対して再度get_param関数を使用することで,入力端子のプロパティにアクセスできます。例えば，线路プロパティを指定すれば，その端子に接続されている信号線を取得できます。

>> line = get_param(ph_outport。轮廓尺寸,“行”）%输出ブロックの入力端子に接続されている信号線を取得

行=
425.0007

またも数値が返ってきました。これが信号線のハンドルになります。なみに，このハンドルはモデルを開く度に値が変わるので注意が必要です。

提示

得られたオブジェクトのハンドルに対して得到関数を使用すると,そのオブジェクトが持つプロパティの一覧を表示することができます。

> > get(线)% lineオブジェクトのプロパティ一覧を表示

数据采集:0
DataLoggingNameMode: '使用信号名称'
DataLoggingName:“
DataLoggingDecimateData: 0
DataLoggingDecimation:‘2’
DataLoggingSampleTime: ' 1 '
．
．
．

4.信号線の接続元を保存し，信号線を削除する

次に，取得した信号線の接続元の情報を保存してから削除します。本当は既存の信号線を死区ブロックに繋ぎ変えられればよいのですが,残念ながら模型APIでは信号金宝app線の繋ぎ変えはできません。そのため，信号線の接続元の情報を保存し，その信号線を削除し，新しい信号線を接続する必要があります

さて，それではまず信号線の接続元の情報を取得します。入力端子と同様，信号線もget_param関数を使うことでプロパティにアクセスできます。今回は接続元の情報が欲しいので，SrcPortHandleプロパティを指定します。

>> SRC = get_param(line，“SrcPortHandle”）信号線の接続元を取得

src =
447.0006

信号線の接続元のハンドルを取得することができました。それではこの信号線を削除してしまいましょう。信号線の削除はdelete_line関数を使用します。

> > delete_line(线);信号線を削除

Ourpotに繋がっていた信号線が削除されました。

5.信号線を繋ぐ

あとは削除した信号線の接続元と,追加した死区ブロックの入力端子,死区ブロックの出力端子と外港ブロックの入力端子をそれぞれ接続するだけです。信号線を接続するときは，接続元と接続先の端子のハンドルが必要です。接続元と外港の入力端子のハンドルは既に取得していますので,死区の入出力端子をget_param関数で取得しましょう。

>> ph_deadzone = get_param(“vdp /死区”，“PortHandles”）% deadzoneブロックの端子情報を取得

ph_deadzone =
フィ:ルドをも:
尺寸:118.0002
外港:120.0001
启用:[]
触发:[]
状态:[]
LConn: []
RConn: []
Ifaction: []
重置:[]

输入が入力端子のハンドル，输出が出力端子のハンドルです。どらも問題なく取得できてそうですね。

それでは信号線を接続していきましょう。add_line関数を使うことで，端子間に信号線を繋ぐことができます。先ほど取得した,削除した信号の接続元ポートsrcと死区ブロックの入力端子を接続します。

> > add_line (“vdp”src, ph_deadzone.Inport);%接続元から死亡区ブロックに信号を接続

死区ブロックと出港ブロックの接続も同様です。

> > add_line (“vdp”、ph_deadzone.Outport ph_outport.Inport);%死区ブロックから出港ブロックに接続

死亡地带ブロックに信号が接続されました!

オプション:ブロックの移動

以上の操作でモデル内にブロックを挿入することができました。モデルとしてはこれで正常に実行可能なのですが,追加したブロックが変なところにあって,見栄えが悪いですね。追加した死亡区ブロックを適当な位置に配置してみましょう。

ブロックの位置は，职位パラメ，タによって定まっています。現在のdeadzoneブロックの位置を，get_paramで確認してみましょう。

>> pos = get_param(“vdp /死区”，“位置”）% deadzoneブロックの位置を取得

pos =
160 45 190 75

4要素のベクトルが返ってきました。これらは[左端上端右端下端]の位置を表しています。これを使うことで，所望の位置にブロックを配置することが可能です。

Pos_outport = get_param(outports{1}，“位置”）;
左= pos_outport(1)-50;%输出端口ブロックより50だけ左
中间= (pos_outport(2)+pos_outport(4))/2;%输出ブロックと同じ高さ
尺寸= 30;% 30の大きさ
set_param (“vdp /死区”，“位置”，[left middle-size/2 left+size middle+size/2]);

いい感じの位置に配置することができました。マウス操作でブロックを追加したときと遜色のないモデルが完成しましたね!

提示

金宝appSimulink.BlockDiagram.arrangeSystem関数や金宝appSimulink.BlockDiagram.routeLine関数を使うと，ブロックや信号線をいい感じに配置してくれます。具体的な位置を求める必要がない場合はこらの方が手軽に位置調整ができるのでオススメです。詳しい使い方にいては各関数のドキュメントをご確認ください。

おわりに

今回の記事では模金宝app型APIの関数を駆使してモデルの特定の場所にブロックを挿入する方法を紹介しました。もちろんマウス操作で編集したほうが楽な場合が多いですが,冒頭でも記載した通り,単純な編集作業の繰り返しや修正ミスを防ぎたい場合は重宝します。

また，gui的な操作を崔的に行うというのには何とも言えぬロマンがありますよね。プログラムが得意な人は,スクリプトから華麗にモデルを編集することで,周りの人をあっと驚かせることができるかもしれませんよ!