设置属性以用于分析

此示例显示了如何通过向模型元素添加构造型并设置属性值来启用分析。该模型为在机器人系统的简单架构模型中分析组件总成本与重量之间的权衡提供了基础。有关详细信息，请参阅使用具有属性的机器人系统进行简单的汇总分析。

创建用于分析的模型实例

创建可用于分析的架构模型的实例。实例是架构模型元素在给定时间点上的具体体现。实例会冻结实例模型中组件的活动变体或模型引用。

实例模型是实例的集合。您可以根据模型的更改更新实例模型，但实例模型不会根据活动变体或模型引用的更改而更新。您可以使用保存在 MAT 文件中的 System Composer 架构模型的实例模型进行分析。

导航至 建模 > 分析模型 以打开实例化架构模型工具。指定创建和查看分析模型所需的所有参数。

选择构造型树列出了当前会话中已加载的所有配置文件的构造型，并允许您选择其属性应在实例模型中可用的配置文件。此时，您可以浏览分析函数、创建新分析函数或跳过分析。如果分析函数需要模型中元素以外的其他输入（例如计算成本所需的汇率），请在函数参量中输入。选择一种迭代模型元素的模式，例如自下而上，从树的叶子移动到根。严格模式确保实例化模型中的元素只有在组合模型中的相应元素应用了构造型时才会获得属性。

点击实例化创建实例化的架构模型并启动分析查看器工具。

分析查看器显示第一列中的所有元素。其他列显示当前实例选择的所有构造型的属性。如果属性不属于应用于元素的构造型，则该字段将显示为灰色。您可以使用过滤器按钮隐藏某些构造型的属性。当您选择一个元素时，实例属性会显示该元素的构造型和属性值。您可以将实例保存到 MAT 文件中，然后在分析查看器中再次打开。

如果在实例打开时对模型进行了更改，则可以将实例与模型同步。更新将更改从实例推送到模型。刷新从模型中提取对实例的更改。未同步的更改将以不同颜色显示。选择单个元素可启用更新元素的选项。

编写分析函数

编写一个函数，使用实例分析架构模型。分析函数对架构的某些特征进行定量评估。分析函数是一个 MATLAB^® 函数，它使用模型实例中每个元素的属性以及组件和架构层级的实例特定参数计算评估架构所需的值。使用分析函数计算分析结果。

有关详细信息，请参阅分析函数构造。

在设置分析实例模型时，可以添加分析函数。选择所需的构造型后，点击分析函数字段旁边的 创建模板函数。生成的 M 文件包含从所有要分析的构造型中获取所有属性值的代码。分析函数对单个元素进行操作 - 当您使用分析查看器工具运行分析时，通过对模型中的所有元素迭代此函数来生成聚合值。

function CostAndWeightRollupAnalysis(instance,varargin)
% Analysis function for the RobotPhysicalArchitecture.slx example

% Calculate total price
if instance.isComponent() && ~isempty(instance.Components)...
 && instance.hasValue('SystemProfile.PhysicalElement.UnitCost')
    sysComponent_unitPrice = 0;
    for child = instance.Components
        if child.hasValue('SystemProfile.PhysicalElement.UnitCost')
           comp_price = child.getValue('SystemProfile.PhysicalElement.UnitCost');
           sysComponent_unitPrice = sysComponent_unitPrice + comp_price;
        end
    end
    instance.setValue('SystemProfile.PhysicalElement.UnitCost',sysComponent_unitPrice);
end

在生成的文件中，instance 是分析函数当前运行的元素的实例。您可以执行以下操作进行分析：

如果属性不存在，则 getValue 函数会生成一个错误。在获取值之前，您可以使用 hasValue 查询模型中的元素是否具有该属性。

例如，以下代码计算组件的重量，作为其子组件重量之和。

% Calculate total weight
if instance.isComponent() && ~isempty(instance.Components)...
 && instance.hasValue('SystemProfile.PhysicalElement.UnitWeight')
    weight = 0;
    for child = instance.Components
        if child.hasValue('SystemProfile.PhysicalElement.UnitWeight')
           subcomp_weight = child.getValue('SystemProfile.PhysicalElement.UnitWeight');
           weight = weight + subcomp_weight;
        end
    end
    instance.setValue('SystemProfile.PhysicalElement.UnitWeight',weight);
end

分析函数完成后，将其添加到分析函数框下的分析中。分析函数可以接受额外的输入参量，例如，如果权重在不同的构造型中使用不同的单位，则可以接受转换常量。当此代码从层次结构中最深的组件开始递归地运行到顶级组件时，系统的总权重将被分配给顶级组件的 weight 属性。

运行分析函数

使用分析查看器运行一个分析函数。

System Composer 对每个模型元素运行分析函数并计算结果。计算出的属性在分析查看器中以黄色突出显示。

这里，系统的总成本为 5100 dollars，总重量为 55 kg。