模型配置命令行接口
概述
一个应用程序编程接口(API)允许您创建和操作配置集在命令行或脚本。该API包括金宝appSimulink.ConfigSet和金宝appSimulink.ConfigSetRef类和下面的功能:
这些函数,的方法和属性金宝appSimulink.ConfigSet类,允许您创建一个脚本:
创建和修改配置集。
附加配置集模型。
设置活动配置为一个模型。
打开和关闭配置集。
从模型中分离配置集。
保存配置集。
加载配置集。
使用前面的例子和功能金宝appSimulink.ConfigSet类,函数和类引用页面。
加载和激活在命令行配置设置
从MATLAB加载配置设置®函数或脚本:
使用
getActiveConfigSet或getConfigSet函数处理配置设置您想要更新。调用MATLAB函数或执行MATLAB脚本加载已保存的配置设置。
可选地,使用
attachConfigSet功能连接的配置模型。为了避免配置设置命名冲突,集allowRename真正的。可选地,使用
setActiveConfigSet功能激活的配置设置。
另外,在命令行加载一套配置,使其主动配置设置:
打开模型。
使用
金宝appSimulink.BlockDiagram.loadActiveConfigSet函数加载配置设置,让它活跃。请注意
如果您加载配置具有相同名称的设置为:
激活配置设置,软件覆盖激活配置集。
不活跃的配置设置与该模型相关联,从模型中分离的软件激活配置。
保存在命令行配置设置
拯救一个活跃的或不活跃的配置设置为一个MATLAB函数或脚本:
使用
getActiveConfigSet或getConfigSet函数来处理配置集。使用
saveAs的方法金宝appSimulink.Configset类来保存配置设置为一个函数或脚本。
另外,保存活动配置设置:
打开模型。
使用
金宝appSimulink.BlockDiagram.saveActiveConfigSet函数保存活跃的配置设置。
在命令行创建一个独立的配置设置
复制一套配置存储在模型中
创建一个独立配置设置在几个配置引用的参考模型。你必须复制任何配置设置从现有的模型,否则,cset是指现有的配置设置存储在模型中,而不是一个新的独立配置中设置基本工作空间。例如,使用下列之一:
-
cset=复制(getActiveConfigSet (模型))
-
cset=复制(getConfigSet (模型,ConfigSetName))
模型任何开放模型,ConfigSetName是任何配置设置的名称附加到模型中。
从MAT-File读取一个配置组
使用一套独立配置多个MATLAB会话,您可以保存MAT-file。要创建MAT-file,首先复制配置设置一个基本工作空间变量,然后保存MAT-file变量:
保存(workfolder/ConfigSetName.mat,cset)
workfolder是一个工作目录,ConfigSetName.mat是MAT-file名字,cset是一个基本工作空间变量的值设置为保存的配置。以后当你重启你的模型,你可以重新加载配置设置的变量:
负载(workfolder/ConfigSetName.mat)
执行从mat文件读取配置集的代码,使用这些技术之一:
一个顶级的预加载功能模型
MATLAB启动脚本
互动的
负载语句
创建和附加在命令行配置参考
创建并填充一个配置参考,金宝appSimulink.ConfigSetRef使用API:
创建参考:
cref= 金宝appSimulink.ConfigSetRef
如果需要更改默认的名字:
cref. name = 'ConfigSetRefName”
指定引用配置设置:
cref.SourceName = 'cset”
提示
没有指定一个配置的名称引用。如果你窝一个配置参考,出现一个错误。
附加的参考模型:
attachConfigSet (模型,cref,真正的)
第三个参数是可选的,授权重命名,以避免名称冲突。
使用一个配置参考一个无效的配置设置,SourceName生成一个错误,被称为一个未解决的配置参考。GUI相当于SourceName是引用配置。您稍后可以使用API或GUI提供一套独立配置的名称。有关更多信息,明白了未配置引用。
请注意
一个金宝appSimulink.ConfigSetRef对象不能被保存到一个MATLAB文件。保存配置,调用金宝appSimulink.ConfigSetRef.getRefConfigSet方法。然后保存金宝appSimulink.ConfigSet方法返回的对象。有关更多信息,请参见保存在命令行配置设置。
附上在命令行配置引用多个模型
在您创建一个配置引用,并将它附加到一个模型,您可以附加的副本参考其他模型。每个模型都有自己的复制的任何配置参考附加到它,就像每个模型都有自己的拷贝任何附加的配置设置。
如果你使用GUI,将现有的配置参考附加到另一个模型自动高度不同的复制模型。如果有必要防止名称冲突,GUI添加或增量的名字的最后一个数字复制的参考。如果您使用该API,一定要复制配置参考明确在连接之前,这样的语句:
cref=复制(getConfigSet (模型,ConfigSetRefName)attachConfigSet (模型,cref,真正的)
如果您省略了复制操作,cref成为一个处理原始配置参考,而不是引用的一个副本。任何试图使用cref会导致一个错误。如果您省略的参数真正的来attachConfigSet如果存在名称冲突,操作失败。
下面的例子展示了代码获取一组独立配置和附加引用两个模型。代码执行后,其中一个模型包含一个内部配置设置和配置的引用指向一个独立副本集。如果内部复制是一个额外的副本,您可以删除它detachConfigSet的最后一行所示的例子。
open_system (model1) %让处理当地cset cset = getConfigSet (“model1”、“配置”)%创建独立的复制;原始模型仍在cset1 =复制(cset) %在原始模型中,创建一个配置cset %引用复制cref1 =仿真软件。金宝appConfigSetRef cref1。SourceName=”cset1' % Attach the configuration reference to the model attachConfigSet('model1', cref1, true) % In a second model, create a configuration % reference to the same cset open_system('model2') % Rename if name conflict occurs attachConfigSetCopy('model2', cref1, true) % Delete original cset from first model detachConfigSet('model1', 'Configuration')
把值从引用配置设置
您可以使用get_param配置引用上获得有关配置的参数值集,好像引用对象的配置。金宝app动态仿真模块®软件检索引用配置设置和执行get_param在上面。
例如,如果配置参考cref链接的配置设置cset,以下操作给相同的结果:
get_param (cset、“StopTime”) get_param (cref,' StopTime ')
改变值在一个引用配置设置
通过操作只配置参考,您不能改变引用配置设置参数值。如果你执行:
set_param (cset,‘StopTime’,‘300’) set_param (crefStopTime ', ' 300 ') %是非法的
使用API来获取一组引用配置:
按照说明在获得一个配置参考处理。
获取配置设置
cset从配置参考cref:cset=cref.getRefConfigSet
您现在可以使用
set_param在cset改变参数值。例如:set_param (csetStopTime ', ' 300 ')
提示
如果你想改变参数值通过GUI,执行:
配置参数对话框打开指定的配置设置。cset.openDialog
获得一个配置参考处理
大多数函数和方法操作配置引用句柄引用。当您创建一个配置参考:
cref= 金宝appSimulink.ConfigSetRef
的变量cref包含一个句柄引用。如果你不已经有一个句柄,可以获得一个通过执行:
cref= getConfigSet (模型”,ConfigSetRefName”)
ConfigSetRefName是配置的名称引用,因为它出现在Model Explorer,例如,参考。你指定这个名字通过设置的名字字段配置引用对话框或执行:
cref. name = 'ConfigSetRefName”
技术获取配置引用句柄使用相同的技术来获取一组配置处理。无论操作同样适用于配置设置和配置引用适用的函数和方法重载正确地执行与类。
