データディクショナリとは

データディクショナリは、モデルに関連するデータの永続リポジトリです。ベースワークスペースを使用して、シミュレーション中にモデルが使用する設計データを格納することもできます。ただし、データディクショナリにはさらに多くの機能があります。

データディクショナリは、パラメーターと信号を定義する設計データを格納します。また、モデルの動作を定義するデータを含みます。データディクショナリには、Inport ブロックと Outport ブロックを入出力するモデルシミュレーションの入力または出力であるシミュレーションデータは格納されません。

データディクショナリは、各キーを対応する値と関連付けたデータ構造体である MATLAB^® ディクショナリデータ型に関連付けられていません。MATLAB ディクショナリデータ型の詳細については、ディクショナリを参照してください。

ディクショナリの機能

ディクショナリの機能	利点
データソースとしてのディクショナリ	ディクショナリのエントリは永続的です。開発中にデータを再読み込みする必要はありません。
明示的なデータモデルリンク	データディクショナリをモデルのデータソースとして定義することができます。モデルシミュレーションおよびコード生成の際に、モデルはデータディクショナリからデータを取得します。
バージョンの処理	次のことが可能です。モデルを前バージョンの Simulink^® に保存されたモデルデータを含むデータディクショナリにリンクする。前バージョンの Simulink に保存されたモデルのデータディクショナリを、新しいバージョンの Simulink で保存されたモデルのバージョンで使い続ける。前バージョンの Simulink で作成されたモデルで使用するためにデータディクショナリをエクスポート (保存) する。
変更の追跡	エントリを変更すると、そのステータスがディクショナリで更新され、トラッキングできるメタデータとして格納されます。ディクショナリでは、誰がいつ変更を加えたかについてもトラッキングされます。変更を表示したり、元に戻したりすることもできます。
エントリの比較	2 つのディクショナリのエントリの値を比較します。
参照ディクショナリへのデータグループ化	参照ディクショナリにデータ項目を分割して整理します。
モデルデータ依存性	モデルでのエントリ使用方法を調べます。
欠損している変数を修正するオプション	コンパイル時に未定義として報告される変数の場合、次のようになります。変数が存在しない場合、新しい変数を作成するか、ファイルを読み込む。変数が削除されている場合、削除を元に戻すか、新しい変数を作成する。変数の名前が変更されている場合、変数への参照の名前を変更するか、名前が変更された変数をコピーして新しい変数を作成する。
参照データの格納および分割	機器の仕様などの、モデルに関連していてもシミュレーション中にモデルによって使用されないデータを格納および分割します。
データを定義するための統合インターフェイス	モデルエクスプローラーを使用して、ディクショナリの設計データを操作します。
メモリの増分更新	メモリ使用量を最小化することにより、パフォーマンスとスケーラビリティを改善します。
要件のトレーサビリティリンク	データディクショナリのエントリから要件ドキュメント内にアクセスします。

ディクショナリのセクション

Simulink データディクショナリは、次の 4 つのセクションで構成されます。

Design Data: モデルの動作を決定するパラメーター、信号および設計データを定義する変数およびデータ型が含まれます。ディクショナリで作成またはインポートされた設計データは、このセクションに格納されます。
このセクションに格納できるのは、特定のクラスおよびデータ型のみです。詳細については、有効な設計データクラスを参照してください。
Configurations:シミュレーション時にモデルを構成する方法を決定する、Simulink.ConfigSet クラスのオブジェクトであるコンフィギュレーションセットが含まれます。これらのオブジェクトは、サンプル時間やシミュレーション開始時間などの属性を制御します。
コンフィギュレーションセットをデータディクショナリに格納する場合、コンフィギュレーション参照を使用してコンフィギュレーションセットにアクセスします。ディクショナリにリンクしているモデルは、コンフィギュレーション参照をディクショナリ内のコンフィギュレーションセットに関連付けます。コンフィギュレーション参照の詳細については、コンフィギュレーションの複数のモデル間での共有を参照してください。
このセクションには Simulink.VariantConfigurationData クラスに属するバリアント構成オブジェクトも格納できます。これらのオブジェクトには、バリアントコンフィギュレーション、バリアントのアクティブな設定と既定の設定、各コンフィギュレーションに関連付けられている制御変数の定義に関する情報が格納されます。
メモ
システムで使用できないコンポーネントを含むコンフィギュレーションセットをデータディクショナリから読み込むと、欠落しているコンポーネントのパラメーターが既定値にリセットされます。
Embedded Coder ディクショナリ: Embedded Coder^® で使用するためのコード生成定義が含まれます。データディクショナリに格納されているコード定義を検査および変更するには、モデルエクスプローラーではなく Embedded Coder ディクショナリ (Embedded Coder)を使用します。
Other Data: モデルに関連していてもシミュレーション中にモデルによって使用されない情報が含まれます。このセクションを使用して、物理的な機器について説明するデータやモデルが表すプロセスなどの参照情報を格納します。
このセクションにはほぼすべての組み込みクラスまたはカスタムクラス、データ型を格納できます。詳細については、無効なその他のデータクラスを参照してください。

異なるバージョンの Simulink で作成されたモデルにおけるディクショナリの使用

Simulink は、データディクショナリのバージョン処理を提供しています。以下のイベントが発生したとき、Simulink はディクショナリのデータを同期して、モデルの作成に使用された Simulink バージョンにかかわらず、モデルでディクショナリを使用できるようにします。

前バージョンの Simulink で保存されたデータディクショナリにモデルをリンクする。たとえば、R2018a で保存されたディクショナリに、R2018b で開発するモデルをリンクする場合。
データディクショナリにリンクされていて、Simulink の前バージョンで保存されたモデルを開く。たとえば、R2018a で開発した、データディクショナリ使用のモデルを、R2018b で開いて開発を続ける場合。

データディクショナリが保存された Simulink バージョンを表示するには、現在のフォルダーブラウザーでデータディクショナリをクリックし、[詳細] ペインの [Simulink バージョンで保存] フィールドを特定します。また、異なるバージョンの Simulink を使用して作成したモデルで使用するために、データディクショナリをエクスポート (保存) することもできます。新しい Simulink のバージョンで保存されたデータディクショナリを Simulink の古いバージョンで使用するには、最初にエクスポートしなければなりません。

データディクショナリをエクスポートするには、次の手順を行います。

MATLAB コマンドウィンドウの [現在のフォルダー] ペインで、データディクショナリの場所に移動します。
ディクショナリの名前をダブルクリックします。
モデルエクスプローラーで、データディクショナリの名前を右クリックします。ディクショナリに変更を加えた場合、コンテキストメニューから [変更の保存] を選択します。
データディクショナリの名前を右クリックします。コンテキストメニューで、[前バージョンにエクスポート] を選択します。
[データディクショナリを前のバージョンにエクスポート] ダイアログボックスで、モデルを保存する Simulink の旧バージョンを指定します。Simulink が新しいバージョンのディクショナリを配置するためのフォルダーを指定します。ここで指定するフォルダーには、既存のディクショナリ階層の一部を構成するディクショナリを含めることはできません。次に、[OK] をクリックします。
指定したフォルダーに新しいバージョンのデータディクショナリが存在することを確認します。

ディクショナリのエントリの管理と編集

データディクショナリでエントリを作成、変更、表示するには、モデルエクスプローラーを使用します。詳細については、ワークスペース変数の作成、編集、管理およびディクショナリデータの変更表示と変更取り消しを参照してください。

ディクショナリのエントリをプログラムで管理する場合は、プログラムによるディクショナリへのデータの格納を参照してください。

ディクショナリの参照

親ディクショナリで 1 つ以上のディクショナリを参照できます。参照ディクショナリのデータは親ディクショナリに表示されます。特にモデル参照階層では、データを有意義に分割する際にこの手法を使用します。詳細については、参照ディクショナリを使用したディクショナリデータの分割とデータディクショナリを使用したモデル参照階層用のデータ分割を参照してください。

ファイル形式のインポートおよびエクスポート

ファイル形式	ディクショナリへのインポート	ディクショナリからのエクスポート
MAT ファイル	✓	✓
MATLAB スクリプト	✓	✓

Allow Access to Base Workspace

[モデルからベースワークスペースへのアクセスを有効にする] プロパティと [ディクショナリからベースワークスペースへのアクセスを有効にする] プロパティの詳細については、ベースワークスペースでの共有データの継続使用を参照してください。