Data Store Read

指定此模块从中读取数据的数据存储的名称。旁边的列表列出了模型中与 Data Store Read 模块在同一级别或更高级别的 Data Store Memory 模块的名称。该列表中还包括基础工作区和模型工作区中的所有 Simulink.Signal 对象。要更改名称，请从该列表中选择名称，或者直接在编辑字段中输入名称。

当编译包含此模块的模型时，软件从该模块级别向上搜索模型，寻找具有指定数据存储名称的 Data Store Memory 模块。如果软件找不到这样的模块，它将在模型工作区和 MATLAB^® 工作区中搜索具有相同名称的 Simulink.Signal 对象。如果软件找到信号对象，它将在模型的根级创建一个隐藏的 Data Store Memory 模块，此模块的属性由 Signal 对象指定，初始值设置为全零数组。该数组的维度从 Signal 对象的 Dimensions 属性继承。

如果软件既找不到 Data Store Memory 模块也找不到 Signal 对象，它将停止编译并引发错误。有关搜索路径的详细信息，请参阅符号解析。

编程用法

模块参数：DataStoreName

类型：字符串 | 字符向量

值：数据存储名称

默认值：'A'

此 参数 为只读。

此字段列出 Data Store Memory 模块，该模块对它要从中读取数据的存储进行了初始化。

此 参数 为只读。

此字段列出符合以下条件的所有 Data Store Write 模块的路径：与此模块具有相同的数据存储名称，且在模型层次结构中位于同一子系统级别或其下的任何子系统中。点击此列表中的任何条目以在模型中突出显示对应的模块。

采样时间，控制模块何时从数据存储中读取数据。值为 -1 表示继承采样时间。有关详细信息，请参阅 指定采样时间。

编程用法

模块参数：SampleTime

类型：字符串 | 字符向量

值：标量 | 向量

默认值：'-1'

关联的数据存储中元素的列表。对于包含数组的数据存储，您可以读取整个数据存储，也可以指定数据存储的一个或多个元素。对于总线数据类型的数据存储，您可以展开树视图以查看并选择总线元素。此列表在括号中显示每个元素的最大维度。

如果未选择启用索引，请选择一个元素并使用以下方法之一：

要选择多个元素，请对每个元素重复上述过程。

您也可以选择启用索引，然后选择单个元素，并使用索引选项参数动态指定子元素。

要刷新显示并反映对数据存储中使用的数组或总线的修改，请点击刷新。

依存关系

对此部分（数组中的元素或总线中的信号）的提示取决于数据存储中数据的类型。

编程用法

模块参数：DataStoreElements

类型：字符串 | 字符向量

值：以井号分隔的元素列表（请参阅使用命令行指定。）

默认值：''

输入 MATLAB 表达式以定义要读取的特定元素，然后点击选择>> 将该元素添加到选定元素表中。重复以上操作以选择其他元素。

例如，对于名为 DSM、最大维度为 [3,5] 的数据存储，您可以在编辑框中输入表达式，如 DSM(2,4) 或 DSM([1 3],2)。请参阅访问特定的总线和矩阵元素。

要应用元素选择，请点击确定或应用。

依存关系

仅当未选择启用索引时，才会出现指定要选择的元素编辑框。

编程用法

模块参数：DataStoreElements

类型：字符串 | 字符向量

值：以井号分隔的元素列表（请参阅使用命令行指定。）

默认值：''

您从数据存储中选择的元素。Data Store Read 模块图标为您指定的每个元素显示一个输出端口。

要更改列表中的总线或矩阵元素的顺序，请在列表中选择元素，然后点击向上或向下。更改列表中的元素顺序会同时更改端口的顺序。要移除某个元素，请点击删除。

依存关系

仅当未选择启用索引时，才会出现选定元素表。

编程用法

模块参数：DataStoreElements

类型：字符串 | 字符向量

值：以井号分隔的元素列表（请参阅使用命令行指定。）

默认值：''

选中此参数可启用类似于 Selector 模块所使用的索引，由此您可以使用一个或多个索引输入端口动态指定要读取的子元素的索引，以及使用模块对话框指定索引。选中此参数时，Data Store Read 模块只能从数据存储的单个元素（即总线中的单个信号）中进行读取。要使用动态索引从数据存储的多个元素中进行读取，请使用多个 Data Store Read 模块。

清除此参数可禁用 Selector 模块样式索引。您可以选择多个要读取的数据存储元素，但只能使用模块对话框来指定要读取哪些子元素。

编程用法

模块参数：EnableIndexing

类型：字符串 | 字符向量

值："off" | "on"

默认值："off"

所选数据存储元素的维数。您必须显式指示此数目。

依存关系

仅当选中启用索引时，此参数才会启用。

编程用法

模块参数：NumberOfDimensions

类型：字符串 | 字符向量

值：正整数

默认值：'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

类型：字符向量

值：元胞数组

默认值：'{ }'

如果索引选项是起始索引(对话框) 或起始索引(端口)，请输入要读取的子元素范围的大小。

依存关系

要启用此参数，请选择启用索引，并将维度的索引选项设置为起始索引(对话框) 或起始索引(端口)。

编程用法

模块参数：OutputSizeArray

类型：字符向量

值：元胞数组

默认值：'{ }'