主要内容

ssc_build

从集合构建自定义库Simscape文件

描述

例子

ssc_build (从指定的包生成自定义Simscape™库文件,.调用ssc_build从包的父目录,即从包含顶级包目录的目录。有关包目录结构的更多信息,请参见组织Simscape文件

当你打电话ssc_build通过一个参数,库文件被命名_lib并位于包的父目录中。该库包含从位于包及其子目录中的Simscape文件(源文件或受保护文件)生成的所有子库和块。在构建库时,Simscape保护文件的优先级高于源文件。如果受保护的文件和源文件都在包中,并且源文件比受保护的文件更新,ssc_build使用受保护的文件来构建库,但发出警告。

例子

ssc_build (“与产出”,outputlibrary从指定的包生成自定义Simscape库文件,,outputlibrary定义库文件名和位置。此语法使用名称-值参数对,其中与产出的可选参数的名称和outputlibrary为参数值。函数实现部分参数名匹配,因此指定“o”As参数名也可以。

例子

ssc_build是语法的命令形式。命令形式需要更少的特殊字符。您不需要键入圆括号或将输入括在单引号或双引号中。用空格而不是逗号分隔输入。

例如,要构建一个名为+ MyPackage,这些语句是等价的:

ssc_build MyPackage % command form ssc_build('MyPackage') % function form

只要输出库的路径和名称是字符向量,也可以使用前面语法中描述的名称-值参数对的命令形式。例如,要构建一个名为+ MyPackage并将输出库保存为“C: \ \ MyLibrary工作”,这些语句是等价的:

ssc_build('MyPackage','-output','C:\Work\MyLibrary') %函数形式

什么时候不使用命令形式outputlibrary使用变量或函数fullfile,以指定输出库名称和位置。有关命令-函数二元性的更多信息,请参见选择“命令格式”或“功能格式”

ssc_build是一种特殊的语法,没有参数,您可以使用它从包目录结构内部调用函数。它从当前包构建一个带有默认库名和位置的库。若要为输出库指定不同的名称或位置,调用ssc_build从包的父目录中使用命令或带有名称-值参数对的语法的函数形式。

例子

全部折叠

假设顶层包目录(用于存储Simscape文件)被命名+ SimscapeCustomBlocks位于C: \ \ mylibrary工作

要生成自定义块库,请将当前工作目录更改为C: \ \ mylibrary工作.然后,在MATLAB中®命令提示符下,键入:

ssc_build (“SimscapeCustomBlocks”);

你也可以使用这个语法的命令形式,它需要更少的特殊字符:

ssc_buildSimscapeCustomBlocks

这个命令生成Simulink万博1manbetx®模型文件名为SimscapeCustomBlocks_lib在包的父目录中,C: \ \ mylibrary工作(也就是说,在包含您的+ SimscapeCustomBlocks包)。

假设顶层包目录(用于存储Simscape文件)被命名+ CustomElectricalBlocks位于C: \工作.如果想从此包生成自定义块库,请将其放入C: \ \ mylibrary工作,给它取一个更短更有意义的名字,CustomDiodes.的名称-值参数对可以实现此目的ssc_build函数。

要生成自定义块库,请将当前工作目录更改为C: \工作.然后,在MATLAB命令提示符下,输入:

ssc_build (“CustomElectricalBlocks”与产出的“C: \ \ mylibrary \ CustomDiodes工作”
生成Simulink库万博1manbetx'CustomDiodes'在输出目录'C:\Work\MyLibraries'…

这个函数调用生成一个被调用的Simulink模型文件万博1manbetxCustomDiodes.slx在指定的目录中。添加C: \ \ mylibrary工作目录到MATLAB路径,以便在各种模型中使用这些自定义块。

假设带有源文件的包位于只读目录中。例如,+ BatteryPack包被用于锂离子电池组阵列故障的例子。有关此包的更多信息,请参见案例研究-使用阵列产生故障的电池组

控件生成自定义块库+ BatteryPack包时,必须指定输出库的位置,而不是包的只读父目录。的名称-值参数对可以实现此目的ssc_build函数。在本例中,输出目录名是一个字符向量,它允许您使用语法的命令形式。

将当前工作目录更改为包含+ BatteryPack包中。

cd (matlabroot) cd工具箱/ physmod simscape / simscapedemos

在MATLAB命令提示符下,输入:

ssc_buildBatteryPack与产出C: \ \ BatteryPack_lib工作
在输出目录'C:\Wo万博1manbetxrk'中生成Simulink库'BatteryPack_lib'…

这个命令生成一个名为的Simulink模型文件万博1manbetxBatteryPack_lib在指定的输出目录中,C: \工作

您还可以利用部分参数名称匹配,并进一步缩短命令语法:

ssc_buildBatteryPack- oC: \ \ BatteryPack_lib工作

该命令与前一个命令等效。

输入参数

全部折叠

包含Simscape文件的包的名称,指定为字符向量或字符串标量,并位于调用的目录中ssc_build函数。顶级包目录的名称是否没有前导+的性格。当你打电话ssc_build使用命令语法时,不要使用引号.有关命令-函数二元性的更多信息,请参见选择“命令格式”或“功能格式”

例子:ssc_build MyPackage命令语法是从包中构建库吗+ MyPackage.等价的函数语法是ssc_build(“MyPackage”)

由包生成的块库文件的名称和位置,指定为字符向量或字符串标量。当你打电话ssc_build使用函数语法,还可以使用MATLAB变量和函数等fullfilegenpath,以指定库文件的路径。

如果指定的文件名没有指定路径,则库将在当前工作目录中生成。指定文件名时,可以包含文件扩展名,.slx,或者省略它。

例子:fullfile (tempdir MyLibrary.slx)在函数语法中,可以使用MATLAB变量和函数来指定路径。

介绍了R2008b