主要内容

getRootInportMap

创建自定义对象信号映射到根级港口

语法

地图= getRootInportMap(“空”);
地图= getRootInportMap(模型、mdl名称,值);
地图= getRootInportMap (inputmap、地图、名称、价值);

描述

地图= getRootInportMap ('”);创建一个空的地图对象,地图。使用这张地图对象建立一个空的自定义映射对象。负荷模型在使用这个函数。如果你不首先加载模型,函数加载模型进行映射,然后关闭。

地图= getRootInportMap (模型、mdl名称、值);创建一个映射对象模型,mdl块名称和信号名称指定。负荷模型在使用这个函数。如果你不首先加载模型,函数加载模型进行映射,然后关闭。创建一个以逗号分隔的变量映射从这个对象,使用getInputString函数。

地图= getRootInportMap (inputmap、地图、名称、价值);覆盖映射对象与指定的属性。你只可以覆盖的属性模型,blockName,signalName。负荷模型在使用这个函数。如果你不首先加载模型,函数加载模型进行映射,然后关闭。创建一个以逗号分隔的变量映射从这个对象,使用getInputString函数。

使用getRootInportMap当创建一个自定义函数映射模式将数据映射到根级港口。有关更多信息,请参见创建和使用自定义地图模式

输入参数

创建一个空对象地图。

默认值:没有一个

名称-值参数

指定可选的双参数作为Name1 = Value1,…,以=家,在那里的名字参数名称和吗价值相应的价值。名称-值参数必须出现在其他参数,但对的顺序无关紧要。

R2021a之前,用逗号来分隔每一个名称和值,并附上的名字在报价。

模型

模型名称与根尺寸地图。

默认值:没有一个

blockName

块的名字根级的输入端口。该工具将数据分配给港口根据root-inport块的名称。如果该工具发现一个数据元素的名称符合root-inport块的名字,它将数据映射到相应的端口。

这个参数的值可以是:

块名称的根级的输入端口。
单元阵列包含多个块根级输入端口的名称。

默认值:没有一个

blockPath

块路径的根级的输入端口。该工具将数据分配给港口根据root-inport块的块路径。如果该工具发现一个数据元素的名字匹配root-inport块的块路径,它将数据映射到相应的端口。

这个参数的值可以是:

块路径的根级的输入端口。
单元阵列包含多个块路径的根级的输入端口。

默认值:没有一个

signalName

信号名称映射。该工具将数据分配给港口根据信号端口的名称。如果工具发现的数据元素名称和名称相匹配的信号在一个港口,它将数据映射到相应的端口。

这个参数的值可以是:

信号名称映射。
单元阵列包含多个信号的信号名称映射。

默认值:没有一个

inputmap

映射对象覆盖。

默认值:没有一个

输出参数

地图

自定义对象,您可以使用数据映射到根级输入端口。创建一个以逗号分隔的变量映射从这个对象,使用getInputString函数。

例子

全部折叠

创建一个空对象的映射。

地图= getRootInportMap (“空”)
地图= 1 x0 InputMap数组属性:类型DataSourceName目的地地位BlockName BlockPath SignalName PortNumber

创建一个简单的映射对象使用MATLAB®时间序列对象。

创建一个时间序列对象,signalIn1

signalIn1 = timeseries ((1:10) ')
timeseries共同的属性:名称:“无名”时间:把TimeInfo设为x1双[10]:tsdata。timemetadata数据:x1双[10]DataInfo: tsdata.datametadata

时间序列对象创建一个映射对象的模型,

模型=“ex_three_inports”
模型= ' ex_three_inports '
open_system(模型);地图= getRootInportMap (“模型”,“ex_three_inports”,“blockName”,“三机”,“signalname”,“signalIn1”)
地图= InputMap属性:类型:“尺寸”DataSourceName: signalIn1的目的地:[1 x1 Simulink.iospecification。金宝app目的地)状态:1 BlockName:“三机”BlockPath:“ex_three_inports / In1”SignalName:‘signalGain5 PortNumber: 1

创建一个映射对象使用向量的块模型名称和信号名称

创建一个映射对象的向量。

模型=“ex_three_inports”;open_system(模型);地图= getRootInportMap (“模型”,“ex_three_inports”,“blockName”,{“三机”“In2”},“signalname”,{“signalIn1”“signalIn2”})
地图=1×2对象与属性:类型1 x2 InputMap数组DataSourceName目的地地位BlockName BlockPath SignalName PortNumber

创建一个映射对象包含信号var2,然后覆盖var2var1

加载模型,定义变量

模型=“ex_three_inports”;open_system(模型);blockNameValue =“三机”;signalNameValue =“var2”;portType =“尺寸”;

定义var1和覆盖var2var1

signalNameToOverload =“var1”;mapToOverload = getRootInportMap (“模型”、模型“blockName”blockNameValue,“signalName”signalNameToOverload)
mapToOverload = InputMap属性:类型:“尺寸”DataSourceName: var1的目的地:[1 x1 Simulink.iospecification。金宝app目的地)状态:1 BlockName:“三机”BlockPath:“ex_three_inports / In1”SignalName:‘signalGain5 PortNumber: 1

提示

  • 负荷模型在运行这个函数之前。

  • 如果您的自定义映射模式类似于现有的仿真软件金宝app®映射模式,考虑使用getSlRootInportMap函数来代替。

版本历史

介绍了R2012b