主要内容

addElement

将元素添加到Dataset对象的末尾

语法

数据集= addElement(数据元素)
数据集= addElement(数据集、元素名称)

描述

数据集= addElement (数据集元素为该元素添加到金宝appSimulink.SimulationData.Dataset数据集。

数据集= addElement (数据集元素的名字为该元素添加到金宝appSimulink.SimulationData.Dataset属性指定的元素名称的名字论点。如果对象已经有名称,则元素将使用您通过使用的名字论点。

输入参数

全部展开

要向其添加元素的数据集。

元素添加到数据集,指定为金宝appSimulink.SimulationData.Signal金宝appSimulink.SimulationData.DataStoreMemory,或matlab.io.datastore.SimulationDatastore对象。

元素的名称,指定为字符向量。

输出参数

全部展开

将元素添加到的数据集,作为字符向量返回。将新元素添加到数据集的末尾。

例子

全部展开

创建一个数据集并向其添加三个元素。

时间= 0.1 * (0:100)';ds = 金宝appSimulink.SimulationData.Dataset;element1 = 金宝appSimulink.SimulationData.Signal;element1。Name =“一个”;Element1.Values = TimeSeries(SIN(时间),时间);ds = addElement (ds, element1);element2 = 金宝appSimulink.SimulationData.Signal;Element2.name =.“B”;element2。值= timeseries (2 * sin(时间)、时间);ds = addElement (ds, element2);element3 = 金宝appSimulink.SimulationData.Signal;element3。Name =“C”;element3。值= timeseries (3 * sin(时间)、时间);ds = addElement (ds, element3);ds
ds = 金宝appSimulink.SimulationData.Dataset " with 3 elements Name BlockPath ____ _________ 1 [1x1 Signal] A " 2 [1x1 Signal] B " 3 [1x1 Signal] C " -使用大括号{}访问,修改,或使用索引添加元素。

通过从基本工作区或文件中的数据创建运行,您可以通过编程方式将数据导入Simulation data Inspector。此示例在工作区中创建数据,然后说明了创建包含数据的Simulation data Inspector运行的几种方法。

创建数据

在工作区中创建数据。仿真数据检查器支持多种格式的时间序列数据。金宝app属性创建数据timeseries金宝appSimulink.SimulationData.Dataset将数据格式化并保存到mat文件中。

创建一个正弦信号和一个余弦信号。将每个信号的数据存储在timeseries具有描述性名称的对象。

时间= 0:0.2:20;sine_vals =罪(2 * 5π/ *时间);sine_ts = timeseries (sine_vals、时间);sine_ts。Name =“sin, T = 5”;cos_vals = cos(π/ 2 * 8 *时间);cos_ts = timeseries (cos_vals、时间);cos_ts。Name =“余弦,T = 8”

你可以使用数据集格式将相关信号数据分组在一个单一对象中。的数据集Format是记录数据的默认格式,用于加载模拟输入数据。金宝app创建一个数据集包含正弦信号的对象timeseries数据。

sinusoids_ds = 金宝appSimulink.SimulationData.Dataset;sinusoids_ds = addElement (sinusoids_ds cos_ts);sinusoids_ds = addElement (sinusoids_ds sine_ts);

将每个信号按倍数缩放2并创建一个数据集对象以包含结果的信号数据。

doubSine = 2 * sine_ts;doubCos = 2 * cos_ts;doubSinusoids_ds = 金宝appSimulink.SimulationData.Dataset;doubSinusoids_ds = addElement (doubSinusoids_ds doubSine);doubSinusoids_ds = addElement (doubSinusoids_ds doubCos);

最后,保存该timeseries数据到mat文件。

保存sinusoids.matsine_tscos_ts

打开仿真数据检查器

要查看在每个部分中创建的运行,请输入以下命令打开Simulation Data Inspector金宝appSimulink.sdi.view在MATLAB™命令窗口。

创建一个运行使用金宝appSimulink.sdi.Run对象

您可以通过创建空运行,然后从工作区或文件添加到运行,将数据导入模拟数据检查器中的运行。根据您的任务,您可以使用金宝appSimulink.sdi.Run.create函数或金宝appSimulink.sdi.createRun函数创建空运行。的金宝appSimulink.sdi.Run.create函数的作用是:返回金宝appSimulink.sdi.Run对象的新运行,以及金宝appSimulink.sdi.createRun函数返回新的运行的运行ID。

属性创建一个空运行金宝appSimulink.sdi.Run.create函数,为运行提供有意义的名称和描述,然后添加正弦和余弦timeseries数据使用添加函数。

sinusoidsRun = 金宝appSimulink.sdi.Run.create;sinusoidsRun。Name =正弦曲线的;sinusoidsRun。描述=“不同频率的正弦和余弦信号”;添加(sinusoidsRun“var”、sine_ts cos_ts)

本示例使用金宝appSimulink.sdi.createRun函数在仿真数据检查器中创建一个新的运行,调用我的波然后使用金宝appSimulink.sdi.addToRun函数添加正弦和余弦timeseries数据到运行。

runID = 金宝appSimulink.sdi.createRun (“我的波”);signalID = 金宝appSimulink.sdi.addToRun (runID,“var”、sine_ts cos_ts);

创建从工作区变量运行

您可以从工作区中的单个变量创建一个运行。在创建运行之后,您可以添加额外的数据,或者您可以创建另一个运行来包含您的其他数据。用于创建运行的变量可以是timeseries对象的数据只对应于一个信号,也可以是数据集对象,该对象包含多个信号。

当您使用此语法从单个工作区变量创建一个运行时,该运行采用与用于创建它的对象相同的名称。

runID = 金宝appSimulink.sdi.createRun (sine_ts);

金宝appSimulink.sdi.createRun函数返回它创建的运行的运行ID。你可以使用金宝appSimulink.sdi.getRun函数访问运行对象来运行。

sineRun = 金宝appSimulink.sdi.getRun (runID);sineRun。的名字
ans = ' sin, T=5'

创建从多个工作区变量运行

当您的数据存在于工作区中的多个变量中时,您可以使用金宝appSimulink.sdi.createRun函数与var选项将多个变量中的数据导入到模拟数据检查器中的一次运行中。还可以使用此语法为使用指定名称的单个变量创建运行。

这个例子创建了一个名为我的正弦曲线它包含了sin和cos的数据timeseries对象。

runID = 金宝appSimulink.sdi.createRun (“我的血窦”“var”、sine_ts cos_ts);

创建运行和指定源名称

你可以使用namevalue选择的金宝appSimulink.sdi.createRun函数创建运行并为运行中的信号指定名称。当从分层数据导入单个叶信号时,此语法特别有用。

控件的数据创建了一个运行数据集对象。每一个数据集对象包含多个信号的数据,因此导入的运行数据具有层次结构。本例中的name-value语法为对应于每个节点的分层节点指定一个名称数据集对象。

runID = 金宝appSimulink.sdi.createRun (“波”“namevalue”,{正弦曲线的...“BigSinusoids”}, {sinusoids_ds doubSinusoids_ds});

创建从文件中的数据运行

你也可以用the金宝appSimulink.sdi.createRun函数将数据从文件导入仿真数据检查器。使用文件选项导入数据simusoids.mat文件。

runID = 金宝appSimulink.sdi.createRun (“波数据”“文件”“sinusoids.mat”);

替代

为了简化索引语法,可以使用花括号({})将元素添加到数据集,而不是使用addElement.对于索引,使用大于元素数1的标量。新元素成为数据集的最后一个元素。

时间= 0.1 * (0:100)';ds = 金宝appSimulink.SimulationData.Dataset;element1 = 金宝appSimulink.SimulationData.Signal;element1。Name =“一个”;Element1.Values = TimeSeries(SIN(时间),时间);DS {1} = ELEMENT1;element2 = 金宝appSimulink.SimulationData.Signal;Element2.name =.“B”;element2。值= timeseries (2 * sin(时间)、时间);ds {2} = element2;element3 = 金宝appSimulink.SimulationData.Signal;element3。Name =“C”;element3。值= timeseries (3 * sin(时间)、时间);ds {3} = element3;
介绍了R2011a