Data Store Read

このブロックがデータを読み取るデータ ストアの名前を指定します。隣接するリストは、モデル内で Data Store Read ブロックと同じレベルか、それ以上のレベルにある Data Store Memory ブロックの名前を提供します。このリストには、ベース ワークスペースとモデル ワークスペースにあるすべての Simulink.Signal オブジェクトも含まれます。名前を変更するには、リストから名前を選択するか、編集フィールドに名前を直接入力します。

このブロックを含んでいるモデルのコンパイル時に、Simulink^® はこのブロックをもつモデルの上位レベルで、指定されたデータ ストア名をもつ Data Store Memory ブロックを検索します。Simulink がそのようなブロックを見つけられない場合、モデル ワークスペースと MATLAB^® ワークスペースで同じ名前をもつ Simulink.Signal オブジェクトを検索します。信号オブジェクトが見つかると、Simulink は、モデルのルート レベルで非表示の Data Store Memory ブロックを作成します。このブロックは、信号オブジェクトによって指定されたプロパティをもち、初期値がゼロの配列に設定されています。この配列の次元は、信号オブジェクトの Dimensions プロパティから継承されます。

Simulink は Data Store Memory ブロックも信号オブジェクトも検索できない場合、コンパイルを停止して、エラーを表示します。検索パスの詳細は、記号の解釈を参照してください。

プログラムでの使用

ブロック パラメーター: DataStoreName

型: 文字ベクトル

値: データ ストア名

既定の設定: 'A'

この パラメーター は読み取り専用です。

このフィールドには、このブロックが読み取るデータ ストアを初期化した Data Store Memory ブロックがリストされます。

この パラメーター は読み取り専用です。

このフィールドには、このブロックと同じデータ ストア名をもち、同じシステム (またはサブシステム) あるいはモデルの階層構造内でそれより下にあるサブシステム内のすべての Data Store Write ブロックへのパスがリストされます。このリスト内のエントリをクリックすると、モデル内の対応するブロックが強調表示されます。

ブロックがデータ ストアから読み取るタイミングを制御するサンプル時間。-1 という値は、サンプル時間が継承されることを示します。詳細については、サンプル時間の指定を参照してください。

プログラムでの使用

ブロック パラメーター: SampleTime

型: 文字ベクトル

値: スカラー | ベクトル

既定の設定: '-1'

関連付けられているデータ ストアの要素のリスト。配列を含むデータ ストアの場合、データ ストア全体を読み取ることも、データ ストアの 1 つ以上の要素を指定することもできます。バス データ型のデータ ストアの場合、ツリーを展開してバス要素を表示し、選択できます。このリストは、各要素の最大次元を小かっこ内に表示します。

[インデックスの有効化] が選択されていない場合、要素を 1 つ選択してから、次のいずれかの方法を使用します。

複数の要素を選択するには、要素ごとに上記の手順を繰り返します。

または、[インデックスの有効化] を選択してから単一の要素を選択し、[インデックス オプション] パラメーターを使用して動的にサブ要素を指定できます。

表示を更新して、変更をデータ ストアで使用される配列またはバスに反映させるには、[更新] をクリックします。

依存関係

このセクションのプロンプト ([配列内の要素] または [バス内信号]) は、データ ストア内のデータ型に依存します。

プログラムでの使用

ブロック パラメーター: DataStoreElements

型: 文字ベクトル

値: 要素の # 区切りリスト (コマンド ラインを使用した指定を参照)

既定の設定: ''

MATLAB 式を入力して、読み取る特定の要素を定義してから、[選択>>] をクリックして [選択された要素] テーブルにその要素を追加します。繰り返して、追加の要素を選択します。

たとえば、最大次元 [3,5] がある DSM という名前のデータ ストアに対して、エディット ボックス内で DSM(2,4) や DSM([1 3],2) などの式を入力できます。特定のバスおよび Matrix 要素へのアクセスを参照してください。

要素の選択を適用するには、[OK] または [適用] をクリックします。

依存関係

[選択する要素の指定] エディット ボックスは、[インデックスの有効化] が選択されていない場合にのみ表示されます。

プログラムでの使用

ブロック パラメーター: DataStoreElements

型: 文字ベクトル

値: 要素の # 区切りリスト (コマンド ラインを使用した指定を参照)

既定の設定: ''

データ ストアから選択した要素。Data Store Read ブロックのアイコンには、指定した各要素の出力端子が表示されます。

リスト内のバス要素または行列要素の順序を変更するには、リスト内の要素を選択して [上] または [下] をクリックします。リスト内の要素の順序を変更すると、端子の順序も変更されます。要素を削除するには、[削除] をクリックします。

依存関係

[選択された要素] テーブルは、[インデックスの有効化] が選択されていない場合にのみ表示されます。

プログラムでの使用

ブロック パラメーター: DataStoreElements

型: 文字ベクトル

値: 要素の # 区切りリスト (コマンド ラインを使用した指定を参照)

既定の設定: ''

このパラメーターを選択して、Selector ブロックで使用されるものと同様のインデックスを有効化します。それにより、1 つ以上のインデックスの入力端子を使用し、ブロック ダイアログを使用してインデックスを指定することにより、読み取るサブ要素のインデックスを動的に指定できます。このパラメーターが選択されている場合、Data Store Read ブロックはデータ ストアの単一の要素 (つまり、1 つのバス内の単一信号) からのみ読み取ることができます。動的インデックス付けを使用してデータ ストアの複数の要素から読み取るには、複数の Data Store Read ブロックを使用します。

Selector ブロックスタイルのインデックス付けを無効にするには、このパラメーターの選択を解除します。読み取る複数のデータ ストア要素を選択できますが、読み取るサブ要素はブロック ダイアログを使用した場合にのみ指定できます。

プログラムでの使用

ブロック パラメーター: EnableIndexing

型: 文字ベクトル

値: 'off' | 'on'

既定の設定: 'off'

選択したデータ ストア要素の次元数。この数は明示的に示さなければなりません。

依存関係

このパラメーターは、[インデックスの有効化] が選択されている場合にのみ有効になります。

プログラムでの使用

ブロック パラメーター: NumberOfDimensions

型: 文字ベクトル

値: positive integer

既定の設定: '1'

インデックス モードを選択します。[1 ベース] を選択した場合、インデックス 1 は入力ベクトルの最初の要素を指定します。[0 ベース] を選択した場合、インデックス 0 は入力ベクトルの最初の要素を指定します。

依存関係

このパラメーターは、[インデックスの有効化] が選択されている場合にのみ有効になります。

プログラムでの使用

パラメーター: IndexMode

型: 文字ベクトル

値: 'Zero-based' | 'One-based'

既定の設定: 'One-based'

次元単位で、選択したデータ ストア要素のサブ要素をインデックス付けする方法を定義します。リストから以下を選択します。

[インデックス] 列と [出力サイズ] 列は、関連付けられて表示されます。

依存関係

このパラメーターは、[インデックスの有効化] が選択されている場合にのみ有効になります。

プログラムでの使用

パラメーター: IndexOptionArray

型: 文字ベクトル

値: 'Select all' | 'Index vector (dialog)' | 'Index vector (port)' | 'Starting index (dialog)' | 'Starting index (port)'

既定の設定: 'Index vector (dialog)'

[インデックス オプション] が [インデックス ベクトル (ダイアログ)] の場合は、読み取る各サブ要素のインデックスを含むベクトルを入力します。

[インデックス オプション] が [開始インデックス (ダイアログ)] の場合は、読み取るサブ要素範囲の開始インデックスを入力します。

依存関係

このパラメーターは、[インデックスの有効化] が選択されていて、次元の [インデックス オプション] が [インデックス ベクトル (ダイアログ)] または [開始インデックス (ダイアログ)] である場合にのみ有効になります。

プログラムでの使用

パラメーター: IndexParamArray

型: 文字ベクトル

値: cell 配列

既定の設定: '{ }'

[インデックス オプション] が [開始インデックス (ダイアログ)] または [開始インデックス (端子)] の場合は、読み取るサブ要素範囲のサイズを入力します。

依存関係

このパラメーターは、[インデックスの有効化] が選択されていて、次元の [インデックス オプション] が [開始インデックス (ダイアログ)] または [開始インデックス (端子)] である場合にのみ有効になります。

プログラムでの使用

ブロック パラメーター: OutputSizeArray

型: 文字ベクトル

値: cell 配列

既定の設定: '{ }'