カスタムライブラリへのデータディクショナリのリンク

カスタムブロックライブラリを作成するときに、ブロックインターフェイスで使用するデータオブジェクト (バスや列挙型など) を定義できます。ライブラリに接続されている Simulink^® データディクショナリにこれらのデータ型を保存して、これらのデータ型をライブラリユーザーが利用できるようにすることができます。ライブラリユーザーは、ライブラリからモデルにブロックをドラッグすると、ディクショナリに含まれているデータ型に自動的にアクセスできます。

接続されているデータディクショナリで定義されているデータ型を使用したライブラリブロックの作成

データディクショナリ内のライブラリブロックのデータと型を定義するには、次のようにします。

新しいデータディクショナリを作成するか、既存のディクショナリを開きます。新しいディクショナリを作成するには、モデルエクスプローラーで、[ファイル] 、 [新規] 、 [データディクショナリ] を選択します。既存のディクショナリを開くには、[ファイル] 、 [開く] を選択し、ディクショナリを参照します。
データと型 (バスオブジェクトなど) をデータディクショナリに追加します。
データディクショナリを保存します。

UI を使用するか、プログラムにより関数 set_param を使用してデータディクショナリをライブラリに接続できます。

UI を使用してデータディクショナリを接続するには、次のようにします。

ライブラリのロックを解除します (ライブラリのロックとロック解除を参照)。
Simulink エディターの [モデル化] タブで、[ライブラリプロパティ] をクリックします。
[ライブラリプロパティ] ダイアログボックスの [外部データ] タブで、[参照] をクリックし、データディクショナリを選択して開きます。
[OK] をクリックしてディクショナリを接続します。

関数 set_param を使用してデータディクショナリを接続するには、次のコマンドを使用します。

set_param('myLib','DataDictionary','myLibData.sldd');

ディクショナリを接続し、ライブラリを保存すると、ディクショナリとその内容がモデルエクスプローラーにライブラリの外部データソースとして表示されます。

View of Model Explorer. On the left, the library node is expanded in the Model Hierarchy pane. Under the library node, the External Data node is expanded to show the attached data dictionary. On the right, the Contents pane displays the two bus objects contained in the Design Data section of the dictionary.

ライブラリのブロックを作成するときは、ライブラリディクショナリに含まれる型を [データ型] リストから選択できます。

On the left, the model canvas displays the contents of a subsystem library block. The Out block is selected. On the right, a block parameters dialog box displays the dictionary data types in the drop-down menu for Data type.

データディクショナリが接続されたライブラリからのブロックの使用

ブロックをライブラリからモデルにドラッグすると、モデルはそのライブラリに接続されているディクショナリに含まれるデータオブジェクトに自動的にアクセスします。モデルエクスプローラーでディクショナリを表示するには、Simulink エディターで、左下隅にあるモデルデータバッジをクリックしてから、[外部データ] をクリックします。ディクショナリは、[From Libraries] ノードの下にあるモデルへの外部データソースとして表示されます。

View of Model Explorer. On the left, a model node is expanded in the Model Hierarchy pane. Under the model node, the External Data node is expanded. Under the External Data node, the From Libraries node is expanded to show the attached data dictionary. On the right, the Contents pane displays the two bus objects contained in the Design Data section of the dictionary.

ライブラリで定義されたデータオブジェクトは、ベースワークスペースまたは別のデータディクショナリにそれらのデータオブジェクトを取り込まなくても、シミュレーションおよびコード生成用にモデルで利用できます。

On the left, the model canvas displays a library block used in a model. The Out block is selected. On the right, a block parameters dialog box displays the dictionary data types in the drop-down menu for Data type.

モデルを更新または保存するときに、モデルにライブラリからのブロックが含まれていない場合は、ライブラリディクショナリはモデルで使用できなくなり、ディクショナリは [From Libraries] ノードから削除されます。

ライブラリディクショナリを使用するときの考慮事項

データディクショナリがリンクされたライブラリを作成または使用するときには、以下の点を考慮します。

多くの場合、ライブラリディクショナリではバスまたは列挙型を定義しますが、ライブラリの作成者はオブジェクトをディクショナリに追加することで、どのタイプのオブジェクトでもライブラリユーザーと共有できます。
ライブラリディクショナリ内の項目はスコープがグローバルで、ライブラリディクショナリがモデルに直接接続されているかのように記号の関連付けが行われます。
ライブラリリンクが解除されると、ライブラリに関連付けられたデータは使用できなくなります。データへのアクセスを回復するには、モデルをライブラリディクショナリに手動でリンクしなければなりません。ライブラリディクショナリへのリンクが復元されると、データへのアクセスも復元されます。
ライブラリをライブラリディクショナリに再リンクできない場合、ライブラリディクショナリのリンクに関する情報を含むキャッシュが破損している可能性があります。キャッシュをリセットするには、関数 Simulink.LibraryDictionary.resetLibraryLinks を呼び出します。この関数を呼び出すと、ライブラリをライブラリディクショナリにリンクする機能が回復しますが、前にリンクしていたライブラリディクショナリの情報は失われます。
モデルの階層構造では、モデルはディクショナリに含まれるデータオブジェクトを使用するためにライブラリディクショナリを直接または間接的に参照しなければなりません。
Simulink はライブラリディクショナリの依存関係情報をユーザー基本設定フォルダーに格納します。この情報は複数の MATLAB^® セッション間で維持されます。ライブラリを別のフォルダーまたはマシンに移動した場合、またはライブラリ階層に変更を加えた場合は、関数 Simulink.LibraryDictionary.refresh を使用して依存関係の解析を実行し、格納されている依存関係を更新できます。この依存関係の解析は計算量が多くなる可能性があるため、見つからない依存関係がある場合にのみ関数 refresh を呼び出します。前の依存関係の解析を消去するには、関数 Simulink.LibraryDictionary.clear を使用します。
ブロックをライブラリからモデルにドラッグすると、モデルはそのライブラリに接続されているデータディクショナリに自動的にアクセスします。ただし、ブロックがサブライブラリからのものである場合、アクセスはそのサブライブラリに接続されているデータディクショナリに限定されます。この場合、モデルがブロックを使用するときにライブラリディクショナリとサブライブラリディクショナリの両方にアクセスできるようにするためには、ライブラリの作成者は新しいサブシステムにサブライブラリブロックを含めなければなりません。
ライブラリを MATLAB ルートフォルダーに保存すると、ディクショナリをライブラリに接続できますが、ライブラリからブロックを追加するときに、モデルは自動でディクショナリにアクセスできません。
Simulink は、ライブラリにリンクされたデータディクショナリでの使用されない変数の検索をサポートしていません。

参考

set_param | Simulink.LibraryDictionary.refresh | Simulink.LibraryDictionary.clear | Simulink.LibraryDictionary.resetLibraryLinks