Simulink データディクショナリを使用するモデルの移行

Simulink^® データディクショナリは、MATLAB^® 変数、データオブジェクト、データ型などのモデルデータを永続的に保存します。データディクショナリの基本的な情報は、データディクショナリとはを参照してください。

ディクショナリを使用する単一モデルの移行

単一のスタンドアロンモデルを単一のデータディクショナリにリンクするには、以下のようにします。

設計データをベースワークスペースに読み込むモデルを開きます。
モデルのコピーを現在のフォルダーに保存します。コピーを開きます。
Simulink エディターの [モデル化] タブにある [設計] の下で、[データディクショナリへのリンク] をクリックします。
[モデルプロパティ] ダイアログボックスで、[新規] をクリックしてデータディクショナリを作成します。
データディクショナリに名前を付けて保存し、[適用] をクリックします。
[データの移行] をクリックします。
参照された変数のコピーについてのメッセージに対して、[移行] をクリックします。
(オプション) [モデルからベースワークスペースへのアクセスを有効にする] をオフにします。
[OK] をクリックします。
ディクショナリを開くには、Simulink エディターで、左下隅にあるモデルデータバッジをクリックしてから、[外部データ] リンクをクリックします。ディクショナリのコンテンツを検査するには、モデルエクスプローラーの [モデルの階層構造] ペインで、[外部データ] ノードの下にあるディクショナリノードを展開します。

メモ

Simulink は、Timeseries オブジェクトなどのシミュレーションデータをデータディクショナリにインポートしません。

ディクショナリを使用するモデル参照階層の移行

この例では、親モデルとその参照モデルすべてを単一のデータディクショナリにリンクする方法を示します。

sldemo_mdlref_datamngt モデルを開きます。
```
openExample('sldemo_mdlref_datamngt')
```
sldemo_mdlref_datamngt モデルは sldemo_mdlref_counter_datamngt を参照します。
モデルのコピーを現在のフォルダーに保存します。
最上位モデル sldemo_mdlref_datamngt を開きます。
Simulink エディターの [モデル化] タブにある [設計] の下で、[データディクショナリへのリンク] をクリックします。
[モデルプロパティ] ダイアログボックスで、[新規] をクリックしてデータディクショナリを作成します。
データディクショナリに名前を付けて保存し、[適用] をクリックします。
まだディクショナリを使用していない参照モデルのリンクについてのメッセージに対して、[すべてのモデルを変更] をクリックします。
[データの移行] をクリックします。
参照された変数のコピーについてのメッセージに対して、[移行] をクリックします。
(オプション) [モデルからベースワークスペースへのアクセスを有効にする] をオフにします。
[OK] をクリックします。

データディクショナリに移行する前の考慮事項

モデルをデータディクショナリにリンクした後、ベースワークスペースからディクショナリにデータを移行することができます。データの移行を選択する場合、以下を考慮します。

データ読み込みコールバックのチェック

PreLoadFcn コールバックなどのモデルコールバックを使用して、モデルが読み込まれたときに設計データをファイルからベースワークスペースに読み込むことができます。たとえば、次のコールバックは、MAT ファイル myData.mat から設計データを読み込みます。

load myData

データディクショナリに移行した後、これらのコールバックは継続して設計データをベースワークスペースに読み込みます。モデルはその後、設計データをディクショナリから導出するため、これらのデータ読み込みコールバックを手動で削除するか、コメントアウトします。

依存関係アナライザーを使用して、データ読み込みコールバックを見つけることができます。モデル依存関係の解析を参照してください。

スクリプトのチェック

新しいモデルは既定でベースワークスペースへのアクセスがありますが、データディクショナリにリンクしてもアクセスは失われません。モデルがベースワークスペース、データディクショナリ、またはその両方にアクセスできるという前提で、スクリプトを記述しなければなりません。

スクリプトでハンドル base を使用して、ベースワークスペースへの明示的な参照を作成する場合は、これらの参照の変更を検討してください。

次の例を考えてみます。ここで、スクリプトはベースワークスペースで変数 sensor を検索し、sensor.noiseEnable の値に応じてパラメーター enable を設定します。

if evalin('base','sensor.noiseEnable')
	enable = 'Enabled';
else
	enable = 'Disabled';
end

データディクショナリに移行するときは、次のように、base への明示的な参照を置き換えます。

if Simulink.data.evalinGlobal(myExampleModel,...
'sensor.noiseEnable')
	enable = 'Enabled';
else
	enable = 'Disabled';
end

関数 Simulink.data.evalinGlobal は指定したモデルのグローバルスコープ内の式を評価します。ここで、モデルがディクショナリにリンクされていない場合、グローバルスコープはデータディクショナリまたはベースワークスペース内の範囲であると考えられます。

コード生成の調整可能なパラメーターのチェック

モデルがデータディクショナリにリンクされていて、モデルがベースワークスペースにアクセスできない場合 (ベースワークスペースでの共有データの継続使用を参照)、Simulink は、[モデルパラメーター設定] ダイアログボックスで指定されているストレージクラス情報を無視します。
Simulink インターフェイスを使用してデータディクショナリを使用するモデルを移行して、ベースワークスペースデータの移行を選択する場合、Simulink はモデルのストレージクラス情報も移行します。モデルにベースワークスペース内の変数のストレージクラス情報が含まれる場合、Simulink は移行時にこれらの変数を Simulink.Parameter オブジェクトに変換します。次に、Simulink はモデルのストレージクラス情報を使用して、これらの Simulink.Parameter オブジェクトのストレージクラスを設定します。
このモデルをベースワークスペースに再度移行する場合、Simulink はモデルのストレージクラス情報を復元しません。これらの変数のストレージクラスを保持するには、データディクショナリのパラメーターオブジェクトを使用します。モデルのストレージクラス情報を手動でリセットすることもできます。
コマンドラインからモデルの DataDictionary プロパティを設定する場合、関数 tunablevars2parameterobjects を使用して、調整可能な変数を Simulink.Parameter オブジェクトに変換できます。

有効な設計データクラス

boolean と int32 や Simulink データディクショナリの [データの設計] セクション内の構造など Simulink がサポートするデータ型を使用する MATLAB 変数をインポート、格納、または作成できます。また、これらのクラスのオブジェクトやこれらのクラスをサブクラス化するほとんどのクラスのオブジェクトを使用することもできます。

Simulink.AliasType
Simulink.Bus
Simulink.NumericType
Simulink.Parameter
Simulink.LookupTable
Simulink.Breakpoint
Simulink.Signal
Simulink.ValueType
Simulink.VariantExpression
Simulink.data.dictionary.EnumTypeDefinition
embedded.fi
embedded.fimath
numlti

さらに、Simulink データディクショナリの [コンフィギュレーション] セクションで、以下のクラスの構成オブジェクトをインポート、格納、作成できます。

無効なその他のデータクラス

以下を除いて、Simulink データディクショナリの [その他のデータ] セクションにある多くの組み込みクラスおよびカスタムクラスまたはデータ型のデータオブジェクトのインポート、格納、または作成を行うことができます。

組み込みクラスまたはカスタムクラスから作成されたオブジェクトの配列
以下のいずれかの名前のプロパティをもつカスタムクラス:
- LastModified
- LastModifiedBy
- DataSource
- Status
- Variant

From Workspace ブロックによる移行

ベースワークスペース内の変数を参照する From Workspace ブロックがモデルに含まれている場合、そのモデルをデータディクショナリに移行できます。ただし、ブロックが参照する変数の性質に応じて、移行プロセスは異なるアクションを実行します。

変数の値が timeseries オブジェクトではない場合、移行プロセスは変数をデータディクショナリの [Design Data] セクションにインポートします。ブロックは引き続き変数を参照できます。
変数の値が timeseries オブジェクト (データディクショナリでは格納できない)、または timeseries オブジェクトと同一のフィールドをもつ構造体の場合、移行プロセスは変数をインポートしません。その場合、ブロック線図を更新またはモデルをシミュレートしようとすると、From Workspace ブロックは変数を特定できず、エラーを発行します。このような場合は、関数 evalin を使用してベースワークスペース変数を参照するようにブロックを構成できます。詳細については、From Workspace を参照してください。

データディクショナリの制限

Simulink は、非アクティブなバリアントモデルのみが使用する変数をデータディクショナリに自動的に移行できません。
matlab.metadata.Class オブジェクトおよび timeseries オブジェクトなどの特定の種類の設計データをデータディクショナリの [Design Data] セクションにインポートできません。
Simulink では、データディクショナリにリンクされたモデルで暗黙的な信号の関連付けは使用できません。データディクショナリを使用するには、モデルコンフィギュレーションパラメーターの [信号の関連付け] を [明示的のみ] または [なし] に設定します。
モデル参照階層がデータディクショナリに既にリンクされている場合、その階層の一部である参照モデルを保護できます。ただし、保護モデルが含まれるモデル参照階層を移行する場合は、シミュレーションが失敗します。
つまり、モデルを保護する前に、データディクショナリを使用するモデルを移行します。
データディクショナリに保存される Simulink 変数またはデータ型を含む式の評価はサポートされない可能性があります。

ベースワークスペースでの共有データの継続使用

共有データを継続してベースワークスペースに格納して、以下を行うことにより、モデル固有のデータをディクショナリに格納します。

モデルに対してベースワークスペースへのアクセスを有効にする。
データディクショナリからベースワークスペースへのアクセスを有効にする。

モデルに対してベースワークスペースへのアクセスを有効にするには、[モデルプロパティ] ダイアログボックスの [外部データ] タブで [ベースワークスペースへのアクセスを有効にする] をオンにします。新規のモデルでは、このチェックボックスは既定でオンになっています。モデルがデータディクショナリにリンクされていない場合、このオプションをオンにしなければなりません。

データディクショナリからベースワークスペースへのアクセスを許可することもできます。既存のディクショナリの場合は、モデルエクスプローラーで [ディクショナリからベースワークスペースへのアクセスを有効にする] をオンにします。

データディクショナリからベースワークスペースのアクセスを許可する場合、次の制限および影響が考えられます。

一般的に、ディクショナリを介してベースワークスペースデータを操作することはできません。
- ディクショナリのコンテンツをモデルエクスプローラーで検査する場合、ベースワークスペースデータは表示できません。ベースワークスペースデータを操作するには、[モデルの階層構造] ペインで、[Base Workspace] ノードを選択します。
- データディクショナリのプログラムインターフェイスを使用して (プログラムによるディクショナリへのデータの格納を参照) ベースワークスペースデータを操作するために、Simulink.data.dictionary.Section オブジェクトでは以下の関数のみ使用できます。
  - assignin
  - exist
  - evalin
  代わりに Simulink.data.assigninGlobal などの関数を使用することを検討してください。データディクショナリの使用への移行を参照してください。
ディクショナリエントリへの変更を表示したり元に戻したりする機能といった変更追跡機能 (ディクショナリのエントリの変更表示と変更取り消しを参照) は、ベースワークスペースデータには適用されません。
ディクショナリからデータをエクスポートする場合 (ディクショナリデータのインポートとエクスポートを参照)、Simulink はベースワークスペースデータを無視します。
Simulink は、ベースワークスペースおよびディクショナリを単一のワークスペースとして扱います。ただし、2 つの変数 (1 つはベースワークスペース内でもう 1 つはディクショナリ内) に同じ名前を定義することはできます。この場合、変数は同一でなければならず、ディクショナリの変数が使用されます。