Main Content

创建 System object

编写一个用于创建和定义新 System object™ 的 MATLAB® 类

您可以通过自定义实现方法来定义自己的 System object。可以使用图形工具查看用于创建 System object 的全面 API。例如，您可以插入方法来初始化、运行、重置和终止 System object。有关定义 System object 的介绍，请参阅定义基本 System object。

方法

全部展开

输入设定

getNumInputsImplSystem object 的输入数目
isInputDataTypeMutableImpl设置 System object 输入的数据类型是否可以更改
isInputSizeMutableImpl设置 System object 输入的大小是否可以更改
isInputComplexityMutableImpl设置 System object 输入的复/实性是否可以更改
isInputDirectFeedthroughImpl输入的直接馈通状态
getInputDimensionConstraintImpl定义数据流子系统的输入维度约束

输出设定

getNumOutputsImplSystem object 的输出数目
getOutputDataTypeImpl输出端口的数据类型
getOutputSizeImpl输出端口的大小
isOutputComplexImpl输出端口的复/实性
isOutputFixedSizeImpl固定大小或可变大小输出端口
getOutputDimensionConstraintImpl定义数据流子系统的输出维度约束

状态设定

getDiscreteStateSpecificationImpl离散状态大小、数据类型和复/实性
isDiscreteStateSpecificationMutableImpl控制离散状态是否可以更改数据类型
getDiscreteStateImpl离散状态属性值

采样时间设定

getSampleTimeImpl指定采样时间类型、偏移时间和采样时间
allowModelReferenceDiscreteSampleTimeInheritanceImpl离散采样时间的模型引用采样时间继承状态

接口设定

getGlobalNamesImplMATLAB System 模块的全局变量名称
getInterfaceImpl (Simulink)Set System object as message or data
isTunablePropertyDataTypeMutableImpl设置可调属性是否可以更改数据类型
isDoneImpl数据结束标志
getSimulateUsingImpl指定 Simulate using 参数值
getSimulinkFunctionNamesImpl注册在 System object 中使用的 Simulink 函数的名称
showFiSettingsImplSystem object 的定点数据类型选项卡可见性
supportsMultipleInstanceImpl在 Simulink For Each 子系统中支持 System object
getImpulseResponseLengthImpl定义数据流子系统的输入影响的长度
supports1DVectorsImplEnable MATLAB System block to use 1-D signals for input and output

模块对话框和外观

getPropertyGroupsImplSystem object 显示的属性组
showSimulateUsingImpl仿真方式参数的可见性
getIconImpl要显示为模块图标的名称
getHeaderImplSystem object 显示的标头
getInputNamesImplMATLAB System 模块输入端口的名称
getOutputNamesImplMATLAB System 模块输出端口的名称
isInactivePropertyImpl非活动属性的状态

仿真方法

setupImpl初始化 System object
stepImpl系统输出和状态更新方程
resetImpl重置 System object 状态
releaseImpl释放资源
processTunedPropertiesImpl可调属性更改时的操作
validatePropertiesImpl验证 System object 的属性值
processInputSpecificationChangeImpl在输入大小、复/实性或数据类型更改时执行操作
validateInputsImpl验证 System object 的输入
updateImpl基于输入更新对象状态

克隆、保存和加载

loadObjectImpl从 MAT 文件加载 System object
saveObjectImpl将 System object 保存在 MAT 文件中
cloneImpl Create duplicate System object

帮助

infoImpl有关 System object 的信息

用于实现编写方法的函数

setProperties创建 System object 时使用名称-值对组设置属性值
propagatedInputComplexitySimulink 传播期间输入的复/实性
propagatedInputDataTypeSimulink 传播期间的输入数据类型
propagatedInputFixedSizeSimulink 传播期间输入的固定大小状态
propagatedInputSizeSimulink 传播期间的输入大小
createSampleTime创建采样时间设定对象
getSampleTime查询采样时间
getCurrentTimeMATLAB System 模块中的当前仿真时间
setNumTicksUntilNextHit (Simulink)Set the number of ticks in Simulink sample time
displayScalarObject显示标量对象的格式
getHeader构建自定义显示头部文本
getFooter构建自定义显示尾部文本

用于实现 System object 的方法

narginSystem object 的输入参量的数目
nargoutSystem object 的输出参量的数目
getNumInputs调用 System object 所需的输入数目
getNumOutputs调用 System object 而得到的输出数目
setup为 System object 一次性设置任务
reset重置 System object 的内部状态
step运行 System object 算法
release释放资源并允许更改 System object 属性值和输入特性
clone创建重复的 System object
isDone数据结束状态
isLocked确定 System object 是否正在使用中
delete删除 System object
output查询 System object 的当前输出
updateUpdate state of a System object based on inputs
supportsMultipleInstanceCheck support for Simulink For Each subsystem for System object
getDiscreteStateGet the discrete states of a System object
getDiscreteStateSpecificationGet the size, data type, and complexity of the discrete state of a System object

查询 System object 输出设定的方法

getOutputSizeGet the size of outputs of a System object
isOutputFixedSizeCheck if outputs of a System object are fixed size
getOutputDataTypeGet data types of the outputs of a System object
isOutputComplexCheck if outputs of a System object are complex

函数

sysobjupdate使用最新语法更新自定义 System object (自 R2020b 起)
getGet states and properties of a System object
set为 System object 的属性设置值

类

matlab.SystemSystem object 的基类
matlab.system.mixin.FiniteSource该类增加了检查 System object 使用的有限数据源的结尾的能力
matlab.system.display.Action在 MATLAB System 模块的“模块参数”对话框中创建自定义按钮
matlab.system.display.Icon将自定义图像指定为 MATLAB System 模块的图标
matlab.system.display.Header在 MATLAB System 模块的“模块参数”对话框中指定头部
matlab.system.display.SectionGroup在 MATLAB System 模块的“模块参数”对话框中创建嵌套的属性分组
matlab.system.display.Section在 MATLAB System 模块的“模块参数”对话框中创建属性组节

主题

学习如何编写 System object

属性特性

输入和输出

  • 更改输入数目
    此示例说明如何在使用和不使用 getNumInputsImpl 的情况下设置 System object™ 的输入数目。
  • 定义复合的 System object
    定义包含其他 System object 作为属性的 System object。
  • 处理输入设定更改
    可以实现一些方法来限制何时可以更改 System object 输入的复/实性、数据类型或大小，或实现某一方法以在输入设定更改时作出响应。

性能和效率

相关信息