getValue

从元素实例中获取属性值

全页折叠

语法

[value,unit] = getValue(instance,property)

说明

[value,unit] = getValue(instance,property) 获取 instance 实例的属性 property 并将其赋值给指定值 value。

注意

该函数是实例编程接口的一部分，可用于逐元素迭代分析模型。instance 指的是执行迭代的元素实例。

示例

全部折叠

获取质量属性值

打开实时脚本

加载小型无人驾驶飞行器 (UAV) 模型，创建架构实例，并获取嵌套组件的质量属性值。

openProject("scExampleSmallUAV");
model = systemcomposer.loadModel("scExampleSmallUAVModel");
instance = instantiate(model.Architecture,"UAVComponent","NewInstance");
[massValue,unit] = getValue(instance.Components(1).Components(1),...
"UAVComponent.OnboardElement.Mass")

massValue = 
1.7000

unit = 
'kg'

输入参数

全部折叠

`instance` — 元素实例
架构实例 | 组件实例 | 端口实例 | 连接器实例

元素实例，指定为 systemcomposer.analysis.ArchitectureInstance、systemcomposer.analysis.ComponentInstance、systemcomposer.analysis.PortInstance 或 systemcomposer.analysis.ConnectorInstance 对象。

`property` — 属性
字符向量 | 字符串

属性，以 "<profile>.<stereotype>.<property>" 的形式指定。

数据类型: char | string

输出参量

全部折叠

`value` — 属性值
`double`（默认）| `single` | `int64` | `int32` | `int16` | `int8` | `uint64` | `uint32` | `uint8` | `boolean` | `string` | 枚举类名称

属性值，以数据类型返回，数据类型取决于属性在配置文件中的定义方式。

`unit` — 属性单位
字符向量

属性单位，以字符向量的形式返回，描述配置文件中定义的属性单位。

示例: 'kg'

数据类型: char

详细信息

全部折叠

定义

术语	定义	应用	更多信息
分析	静态分析分析系统结构，针对某些特性对架构进行定量评估。静态分析使用分析函数以及系统模型中捕获的属性和参数的参数值。	使用分析计算系统的总体可靠性、质量卷积、性能或热特性，或执行大小、重量和功率 (SWaP) 分析以提高效率。	使用分析函数分析架构模型属性分析架构使用具有属性的机器人系统进行简单的汇总分析
分析函数	分析函数是一个 MATLAB^® 函数，它使用模型实例中每个元素的属性以及组件和架构层级的实例特定参数计算评估架构所需的值。	使用分析函数计算分析结果。	分析函数构造编写分析函数
实例模型	实例模型是实例的集合。	您可以根据模型的更改更新实例模型，但实例模型不会根据活动变体或模型引用的更改而更新。您可以使用保存在 `MAT` 文件中的 System Composer™ 架构模型的实例模型进行分析。	运行分析函数
实例	实例是架构模型元素在给定时间点上的具体体现。	实例会冻结实例模型中组件的活动变体或模型引用。	创建用于分析的模型实例

术语	定义	应用	更多信息
构造型	构造型提供了一种扩展核心语言元素和添加域特定元数据的机制。	将构造型应用于核心元素类型。一个元素可以有多个构造型。您可以利用构造型为不同的元素设置样式。构造型为元素提供了一组通用的属性，例如质量、成本和功率。	定义移动机器人的构造型并执行分析使用构造型扩展架构设计基于构造型层次结构改变可移植 Blender 架构中的构造型
属性	属性是构造型中的一个字段。您可以为应用了该构造型的每个元素指定属性值。	使用属性来存储与模型元素相关联的定量特征，例如重量或速度。属性也可以是描述性的，或者表示一种状态。您可以使用属性检查器查看和编辑架构模型中每个元素的属性。有关详细信息，请参阅在 System Composer 中使用属性检查器。	设置属性添加具有构造型的属性设置属性以用于分析
配置文件	配置文件是一系列构造型的集合。	您可以使用配置文件来创建专门的元素类型域。使用配置文件编辑器编写配置文件并将配置文件应用于模型。您可以将用于工程的构造型存储在一个或多个配置文件中。当您保存配置文件时，它们会存储在 XML 文件中。	使用配置文件扩展 System Composer 语言元素使用“管理配置文件”工具更改构造型顺序

版本历史记录

在 R2019a 中推出

getValue

语法

说明

示例

获取质量属性值

输入参数

`instance` — 元素实例
架构实例 | 组件实例 | 端口实例 | 连接器实例

`property` — 属性
字符向量 | 字符串

输出参量

`value` — 属性值
`double`（默认）| `single` | `int64` | `int32` | `int16` | `int8` | `uint64` | `uint32` | `uint8` | `boolean` | `string` | 枚举类名称

`unit` — 属性单位
字符向量

详细信息

定义

版本历史记录

另请参阅

工具

函数

对象

主题

getValue

语法

说明

示例

获取质量属性值

输入参数

instance — 元素实例 架构实例 | 组件实例 | 端口实例 | 连接器实例

property — 属性 字符向量 | 字符串

输出参量

value — 属性值 double（默认）| single | int64 | int32 | int16 | int8 | uint64 | uint32 | uint8 | boolean | string | 枚举类名称

unit — 属性单位 字符向量

详细信息

定义

版本历史记录

另请参阅

工具

函数

对象

主题

`instance` — 元素实例
架构实例 | 组件实例 | 端口实例 | 连接器实例

`property` — 属性
字符向量 | 字符串

`value` — 属性值
`double`（默认）| `single` | `int64` | `int32` | `int16` | `int8` | `uint64` | `uint32` | `uint8` | `boolean` | `string` | 枚举类名称

`unit` — 属性单位
字符向量