将数据加载到根级输入端口

逗号分隔的列表

如果您指定 Dataset 数据，请为输入参数仅指定一个 Dataset 对象。不要将其包含在逗号分隔列表中。

每个变量或表达式都必须计算为与模型中特定根级输入端口对应的适当对象。列表中的每个变量或表达式的计算结果必须为与模型的一个根级输入端口对应的适当对象。第一项对应于第一个根级输入端口，第二项对应于第二个根级输入端口，以此类推。每个数据样本的维度必须与输入模块参数中指定的数据的维度相匹配。

对于 Enable 或 Trigger 模块，驱动使能或触发端口的信号必须是逗号分隔列表中的最后一项。如果同时具有使能和触发端口，则指定：

使用空矩阵来指定端口的接地值。例如，要为输入端口 in1 和 in3 加载数据，并对端口 in2 使用接地值，请在输入参数中输入以下内容：

in1, [], in3

数据集元素

一个 Dataset 对象可以包含具有不同数据类型的元素。

对于单个非总线信号数据，您可以为 Dataset 元素指定以下类型的数据：

对于总线，可以使用以下格式之一的结构体，其中的每个数据元素对应一个叶信号：

为 Inport 模块创建数据集对象

要从模型中的根级 Inport 模块生成 Simulink.SimulationData.Dataset 对象，可以使用 createInputDataset 函数。生成的数据集中的信号具有 Inport 模块的属性和模型始和停止时间的对应的接地值。对于要加载的信号的时间和值，您可以为其创建 timeseries 和 timetable 对象。其他信号使用接地值。每个 timetable 对象只能包含一个信号的数据。

您可以加载到在工作区中驻留的 MATLAB timeseries 对象指定的根级输入端口数据。

时间维度

在创建 MATLAB timeseries 对象以将数据导入 Simulink 时，时间维度（时间采样数）取决于信号数据的维度和类型。

t = (0:10)';
ts = timeseries(sin(t), t);

t = 0;
ts = timeseries([1 2; 3 4], t);

'InterpretSingleRowDataAs3D', true

t = 0;
ts = timeseries([1 2], t, 'InterpretSingleRowDataAs3D', true);

枚举数据

如果在 timetable 数据中指定 enum，请清除对应 Inport 模块的数据插值参数。

数据结构体

您可以以结构体形式从工作区加载到根级输入端口数据，结构体的名称在配置参数 > 数据导入/导出 > 输入参数中指定。有关定义 MATLAB 结构体的信息，请参阅结构体数组。

您可以整体指定模型的结构体或基于每个端口来指定结构体。有关为输入参数指定每个端口的结构体的信息，请参阅针对所有端口或每个端口的结构体。

该结构体始终包括信号子结构体，其中又包含值字段和维度字段。根据您要执行的建模任务，结构体还可以包含时间字段。您使用的结构体形式取决于您要导入数据的信号的类型：

有关导入离散和连续信号的数据的示例，请参阅Control How Models Load Input Data。

针对所有端口或每个端口的结构体

您可以指定一个结构体来为模型中的所有根级输入端口提供输入，也可以为每个端口指定一个单独的结构体。

在一个端口对应一个结构体的格式中，每个端口都对应一个带时间或不带时间的单独结构体。每个端口的输入数据结构体只有一个 signals 字段。要指定此选项，请在输入文本字段中以逗号分隔列表 in1, in2,..., inN 形式输入结构体的名称。值 in1 是模型中第一个输入端口的数据，in2 是第二个输入端口的数据，依此类推。

要针对所有端口指定一个结构体，请遵守下列规则：

指定时间数据

您可以将双精度时间向量指定为要导入的数据结构体的一部分。例如，在导入信号数据时指定时间向量以表示连续被控对象或创建测试用例。要测试离散算法，请使用具有空时间向量的结构体。下表根据要加载的信号数据类型提供了指定时间值的其他建议。

timeVector = startTime + sampleTime*(0:numSteps-1)'; 

T1 = 1 + 0.2*(0:100)' 

timeVector = [startTime:timeStep:endTime]' 

T2 = [0:0.2:10]' 

指定信号和时间数据的示例

第一个示例是具有单个输入端口的模型：

另一个示例是具有两个输入的模型。

假设您要将正弦波输入第一个端口，将余弦波输入第二个端口。在 MATLAB 工作区中定义结构体 a，如下所示：

a.time = 0.1*[0:1]';
a.signals(1).values = sin(a.time);
a.signals(1).dimensions = 1;
a.signals(2).values = cos(a.time);
a.signals(2).dimensions = 1;

在配置参数 > 数据导入/导出 > 输入参数编辑框中输入结构体名称 (a)。

指定输入表达式

模型的默认输入表达式为 [t,u]，默认输入格式为 Array。如果在 MATLAB 工作区中定义 t 和 u，只需选择配置参数 > 数据导入/导出 > 输入参数即可从模型工作区输入数据。

假设您有具有两个 Inport 模块的模型：

您可以在 MATLAB 工作区中定义 t 和 u：

numSteps = 9;
timeStep = 0.1;
t = (timeStep*(0:numSteps))';
u = [sin(t),cos(t),4*cos(t)];

在仿真运行时，信号数据 sin(t) 和 cos(t) 赋给 In1，信号数据 4*cos(t) 赋给 In2。信号数据是 100 个时间点的输入。

驱动函数调用子系统的输入端口的数组

您可以使用数组通过根级输入端口来驱动函数调用子系统。您可以直接使用数组或使用作为 Dataset 对象的元素的数组。该数组必须是 n×1 数组。对于根级 Inport 模块，请选择输出函数调用参数。

例如，以下 Dataset 对象具有数组元素 x：

ds = Simulink.SimulationData.Dataset;
x = [1 3 7 8]';
ds = ds.addElement(x,'theElementName');

此模型使用配置参数 > 数据导入/导出 > 输入参数中的 ds 数据集。

仿真模型时，函数调用子系统中记录的信号数据的时间值显示函数调用子系统仅在 ds 中存储的数组所指定的时间触发。

>> logsout{1}.Values.Time

ans =

     1
     3
     7
     8

指定输入表达式

您可以使用 MATLAB 时间表达式将数据从工作区加载到根级输入端口。要使用时间表达式，请在数据导入/导出窗格的输入字段中以字符串形式输入表达式（用单引号引起来）。时间表达式可以是任何 MATLAB 表达式，其计算结果为一个行向量，该向量的长度等于进入模型输入端口的信号的数量。假设模型有一个接受两个信号的向量输入端口。此外，假设 timefcn 是用户定义的函数，它返回长度为两个元素的行向量。以下是此类模型的有效输入时间表达式：

'[3*sin(t), cos(2*t)]' 

'4*timefcn(w*t)+7'

在仿真的每个时间步计算该表达式，将结果值应用于模型的输入端口。Simulink 在运行仿真时定义变量 t。此外，对于一个变量的函数，您可以在表达式中省略时间变量。例如，表达式 sin 会解释为 sin(t)。