Holarch

指南 · SysML v2

SysML v2 教程:用文本表示法为 CubeSat 电源系统建模

收听本指南(英文音频) 24 分钟

本 SysML v2 教程逐步构建一个小而完整的模型:EO-1 CubeSat 的电源系统,包括其部件、量和单位、端口和连接、光照与地影周期、工具可以检查的需求、一个验证用例以及视图。本页的每个代码清单都是经过语言引擎检查的 SysML v2 文本,每个关键步骤都会显示该文本生成的图。

本页内容
  1. 您将构建什么
  2. 第一个概念:定义与用法
  3. 第 1 步:包及其导入
  4. 第 2 步:部件定义和带单位的属性
  5. 第 3 步:带有值的装配
  6. 第 4 步:端口、接口和连接
  7. 第 5 步:带有动作和流的行为
  8. 第 6 步:将行为分配给结构
  9. 第 7 步:带约束的需求
  10. 第 8 步:验证用例
  11. 第 9 步:视图和图
  12. 完整模型
  13. 代码清单是如何检查的
  14. 在 Holarch 中试用
  15. 后续阅读

您将构建什么

EO-1 是一颗位于 500 km 太阳同步轨道上的 6U 对地观测 CubeSat。它是这些指南共用的示例;MBSE 示例项目从需要到验证跟踪了整个航天器。本教程选取一个子系统,即电源系统 (EPS),并用 SysML v2 文本编写它。

EPS 有三个部件。两块可展开太阳能阵列将阳光转换为电能。一个锂离子电池组为地影期储存能量。一个配电单元 (PDU) 跟踪阵列的最大功率点,为电池充电,并调节 12 V 母线。该母线上的两个负载也在模型中:有效载荷相机和 S 波段发射机。

数值来自 EO-1 模型:

项值使用位置
太阳能阵列:电池片面积、电池片效率、峰值功率0.2 m²、0.295、75.4 W第 3 步
电源路径效率;轨道光照比例0.6; 0.62第 3 步
电池组:容量;36 分钟地影期间消耗的能量77 Wh;18.5 Wh第 3 步
质量:阵列、电池、PDU0.45 kg、0.62 kg、0.28 kg第 3 步
轨道平均功耗:相机、S 波段发射机6.2 W、3.4 W第 3 步
需求 3.1 Orbit Average Power寿命末期至少 28 W第 7 步
需求 3.2 Battery Capacity寿命初期至少 77 Wh第 7 步和第 8 步
需求 3.3 Depth of Discharge每轨道最多 30%第 7 步
测试用例 TC-07 Battery Capacity Test在 20 °C 试验箱中以 C/2 放电第 8 步

模型有三个包:

包内容步骤
CubeSatEPS端口、部件、一个计算、带有值的装配以及行为1 到 6
CubeSatEPSRequirements需求 3.1 到 3.3 以及验证用例 TC-077 和 8
CubeSatEPSViews为图选择模型部分内容的视图9

跟着做不需要任何特定工具:文本是纯 SysML v2,可以加载到任何能读取文本表示法的工具中。完整模型位于页面末尾,也可以下载;最后一节介绍如何将其加载到 Holarch 中。

第一个概念:定义与用法

SysML v2 将定义与用法分开。定义说明某类事物是什么:part def BatteryPack 描述这种设计的每个电池组,包括其属性和端口。用法是处于某个上下文中的此类事物:电源系统中的 part battery : BatteryPack 是 EO-1 的 EPS 中那一个电池,连接到它的 PDU。

同样的配对贯穿整个语言:attribute def 和 attribute、port def 和 port、action def 和 action、requirement def 和 requirement。关键字后跟 def 声明一个种类;不带 def 的同一关键字则使用一个种类。具体的值通常属于用法,因为设计决策是在用法上做出的。

熟悉 SysML v1 的读者可以将定义比作块,将用法比作部件属性。在 SysML v2 中,这一概念适用于每种元素,而且用法可以任意深度地相互嵌套和细化。SysML v1 与 SysML v2 逐个构造地比较了两种语言。

第 1 步:包及其导入

包是一个命名空间:它对元素进行分组,并赋予它们限定名称,例如 CubeSatEPS::BatteryPack。从一个空包及其所需的库导入开始。

package CubeSatEPS {
  doc /* The electrical power system (EPS) of the EO-1 CubeSat: solar arrays, a battery pack and a power distribution unit that feed the payload camera and the S-band transmitter. */

  private import ScalarValues::*;
  private import ISQ::*;
  private import SI::*;
}
  • doc /* … */ 为包附加文档。与 // 注释不同,它是模型的一部分,工具会将其与元素一起显示。
  • ScalarValues 提供基本类型,例如 Real、Integer、Boolean 和 String。
  • ISQ 提供来自国际量制的量类型,例如 MassValue、PowerValue 和 EnergyValue。
  • SI 提供 SI 单位,例如 kg、V、W 和 h。
  • private 使导入的名称只保留在本包内,因此导入 CubeSatEPS 的包不会通过它获得这些名称。

如果没有这些导入,像 MassValue 这样的名称就无法解析,检查器会将其报告为未知。

第 2 步:部件定义和带单位的属性

每个组件都有一个带有类型化属性的部件定义。用量而不是 Real 作为属性的类型,可以记录它度量的是什么:质量、功率还是能量。这样,工具就能检查每个值和每个表达式的量纲是否一致。

  part def SolarArray {
    attribute mass : MassValue;
    attribute cellArea : AreaValue;
    attribute cellEfficiency : Real;
    attribute peakPower : PowerValue;
    attribute pathEfficiency : Real;
  }

  part def BatteryPack {
    attribute mass : MassValue;
    attribute capacity : EnergyValue;
  }

  part def PowerDistributionUnit {
    attribute mass : MassValue;
    attribute busVoltage : ElectricPotentialValue;
  }

  part def PayloadCamera {
    attribute powerDraw : PowerValue;
  }

  part def SBandTransmitter {
    attribute powerDraw : PowerValue;
  }

这些行放在包的花括号内。两个效率保持为普通的 Real,因为它们是没有单位的比值。

目前还没有值。定义描述的是这一类的每个电池组;数值将在下一步随 EO-1 自己的电池一起给出。

第 3 步:带有值的装配

电源系统也是一个部件定义,由部件用法组成:太阳能阵列、电池和 PDU。每个用法为其从定义继承的属性赋值。一个可复用的计算将阵列的峰值功率换算为需求 3.1 所针对的轨道平均功率。

  calc def OrbitAverage {
    doc /* Orbit-average array output (EQ-1.3): peak power times the sunlit fraction times the power path efficiency. */
    in peakPower : PowerValue;
    in sunlitFraction : Real;
    in pathEfficiency : Real;
    return : PowerValue = peakPower * sunlitFraction * pathEfficiency;
  }

  part def ElectricalPowerSystem {
    part solarArrays : SolarArray {
      attribute redefines mass = 0.45 [kg];
      attribute redefines cellArea = 0.2 [m^2];
      attribute redefines cellEfficiency = 0.295;
      attribute redefines peakPower = 75.4 [W];
      attribute redefines pathEfficiency = 0.6;
    }
    part battery : BatteryPack {
      attribute redefines mass = 0.62 [kg];
      attribute redefines capacity = 77 [W*h];
    }
    part pdu : PowerDistributionUnit {
      attribute redefines mass = 0.28 [kg];
      attribute redefines busVoltage = 12 [V];
    }

    attribute sunlitFraction : Real = 0.62;
    attribute eclipseEnergy : EnergyValue = 18.5 [W*h];
    attribute orbitAveragePower : PowerValue = OrbitAverage(solarArrays.peakPower, sunlitFraction, solarArrays.pathEfficiency);
    attribute depthOfDischarge : Real = eclipseEnergy / battery.capacity;
    attribute totalMass : MassValue = solarArrays.mass + battery.mass + pdu.mass;
  }

  part def Spacecraft {
    part eps : ElectricalPowerSystem;
    part camera : PayloadCamera {
      attribute redefines powerDraw = 6.2 [W];
    }
    part transmitter : SBandTransmitter {
      attribute redefines powerDraw = 3.4 [W];
    }
  }
  • part battery : BatteryPack 声明一个名为 battery 的用法,其类型为定义 BatteryPack。
  • attribute redefines capacity = 77 [W*h] 为继承的 capacity 赋值。简写形式 :>> capacity = 77 [W*h]; 含义相同。如果没有 redefines,这一行将声明第二个只是同名的属性,而继承的 capacity 仍然没有值。
  • 77 [W*h] 是一个量:一个数字和一个单位。单位可以用 *、/ 和 ^ 组合,因此瓦时写作 W*h,平方米写作 m^2。
  • calc def OrbitAverage 是一个带有输入和类型化结果的计算。OrbitAverage(…) 用阵列的值调用它,因此公式只写一次,每次使用都会随之更新。
  • depthOfDischarge 用一个能量除以另一个能量。单位相互抵消,结果是一个纯比值。
  • Spacecraft 将电源系统与本教程跟踪的两个负载放在一起。EO-1 的其余部分(姿态控制、飞行计算机、结构)为保持模型简短而省略。

这些值不只是被存储;工具会对它们求值。用上面的数值:

属性表达式结果
orbitAveragePower75.4 W × 0.62 × 0.628.05 W
depthOfDischarge18.5 Wh ÷ 77 Wh0.24
totalMass0.45 kg + 0.62 kg + 0.28 kg1.35 kg

峰值功率本身也有可核查的来源:0.2 m² 的电池片,效率 0.295,在 1361 W/m² 的阳光下、入射角 0.35 rad (cos 0.35 = 0.939) 时,得到 75.4 W。光照比例由轨道决定:500 km 轨道的周期约为 94.6 分钟,其中 36 分钟处于地影,因此轨道的 0.62 处于光照中。

由于每个值都带有单位,量纲错误在检查模型时就会立即显现。电源模型中一个常见的错误是把电池容量写成瓦而不是瓦时:

package UnitCheck {
  private import ISQ::*;
  private import SI::*;

  part def BatteryPack {
    attribute capacity : EnergyValue;
  }

  part battery : BatteryPack {
    attribute redefines capacity = 77 [W];
  }
}

能够计算单位的检查器会拒绝这个值:功率不是能量。在 Holarch 中,编辑器会用量纲错误标记这一行。在电子表格中,同样的疏忽会不知不觉地进入放电深度的计算。

第 4 步:端口、接口和连接

端口是部件与其周围环境相接的点。端口定义列出跨越边界的内容,每个特征都有方向:out 表示所有者发送的内容,in 表示它接收的内容。

  port def DCPowerPort {
    out attribute voltage : ElectricPotentialValue;
    out attribute current : ElectricCurrentValue;
  }

  port def BusPowerPort {
    out attribute voltage : ElectricPotentialValue;
    out attribute powerLimit : PowerValue;
  }

  interface def BusLink {
    end source : BusPowerPort;
    end load : ~BusPowerPort;
  }

接收方使用同一个端口定义,并用 ~ 共轭。~BusPowerPort 是 BusPowerPort 的镜像:每个 out 都变为 in。一个端口定义描述链路的两端,因此两端不会逐渐不一致。

接口定义描述一类具有类型化端的连接。BusLink 将发送电能的 12 V 母线连接到接收电能的负载。它扮演 EO-1 的 12 V Power Interface (IFB-1) 的角色。

现在将端口添加到部件上并连接它们。注释行代表前面步骤中的行。

  part def SolarArray {
    // attributes as in step 2
    port arrayOut : DCPowerPort;
  }

  part def BatteryPack {
    // attributes as in step 2
    port cellsOut : DCPowerPort;
  }

  part def PowerDistributionUnit {
    // attributes as in step 2
    port arrayIn : ~DCPowerPort;
    port batteryIn : ~DCPowerPort;
    port busOut : BusPowerPort;
  }

  part def PayloadCamera {
    // attributes as in step 2
    port powerIn : ~BusPowerPort;
  }

  part def SBandTransmitter {
    // attributes as in step 2
    port powerIn : ~BusPowerPort;
  }

  part def ElectricalPowerSystem {
    // parts as in step 3
    port bus : BusPowerPort;

    connect solarArrays.arrayOut to pdu.arrayIn;
    connect battery.cellsOut to pdu.batteryIn;
    bind bus = pdu.busOut;

    // computed attributes as in step 3
  }

  part def Spacecraft {
    // parts as in step 3
    interface payloadPower : BusLink connect eps.bus to camera.powerIn;
    interface radioPower : BusLink connect eps.bus to transmitter.powerIn;
  }
  • connect solarArrays.arrayOut to pdu.arrayIn 是一个普通连接:阵列线束(EO-1 的接口 IF-20)。从 battery.cellsOut 到 pdu.batteryIn 是电池线束 (IF-21)。
  • bind bus = pdu.busOut 声明电源系统自身的 bus 端口与 PDU 的输出是同一个东西。部件就是这样在其边界上暴露内部端口的:负载连接到 EPS,而不是连接到它的内部。
  • interface payloadPower : BusLink connect … to … 通过一个类型化接口连接两个端口,因此该连接承载 BusLink 的含义。这两个母线接口是 EO-1 的 Payload Power Line (IF-01) 和 Radio Power Line (IF-04)。

互连视图根据这段文本绘制电源系统:每个部件的端口位于其边缘,共轭端口用 ~ 标记,绑定的 bus 端口位于框架上。

第 9 步中的视图 epsConnections:根据文本绘制的 EPS 部件及其端口和连接。

工程上的结果:子系统的接口清单现在是一个查询,而不是一张单独的表格。每个连接都指明两端,并在类型化时指明跨越它的内容。这正是接口控制文档的原始素材,并且会随模型变化而变化。

一个常见的错误是给两端使用相同的、未共轭的端口。这样两端都在发送,没有一端接收:

package PortCheck {
  private import ISQ::*;

  port def BusPowerPort {
    out attribute voltage : ElectricPotentialValue;
  }

  part def PowerDistributionUnit { port busOut : BusPowerPort; }
  part def PayloadCamera { port powerIn : BusPowerPort; }

  part def Spacecraft {
    part pdu : PowerDistributionUnit;
    part camera : PayloadCamera;
    connect pdu.busOut to camera.powerIn;
  }
}

文本可以解析,但比较方向的检查器会警告连接的两端都在发送 voltage。将接收端共轭为 port powerIn : ~BusPowerPort; 即可修正。

第 5 步:带有动作和流的行为

结构说明系统是什么;行为说明系统做什么。动作定义描述一个带有输入参数和输出参数的行为。项定义描述流动的事物,这里是阳光以及不同形式的电能。

  item def Sunlight;
  item def ArrayPower;
  item def ChargePower;
  item def DischargePower;
  item def BusPower;

  action def ConvertSunlight {
    in item sun : Sunlight;
    out item power : ArrayPower;
  }

  action def ChargeBattery {
    in item power : ArrayPower;
    out item charge : ChargePower;
  }

  action def StoreEnergy {
    in item charge : ChargePower;
    out item discharge : DischargePower;
  }

  action def SupplyBus {
    in item discharge : DischargePower;
    out item bus : BusPower;
  }

  action def RunPowerCycle {
    doc /* One orbit: about 59 minutes of sunlight, then a 36 minute eclipse. */

    action collect : ConvertSunlight;
    action charge : ChargeBattery;
    action store : StoreEnergy;
    action supply : SupplyBus;

    flow collect.power to charge.power;
    flow charge.charge to store.charge;
    flow store.discharge to supply.discharge;

    first start then collect;
    first collect then charge;
    first charge then store;
    first store then supply;
    first supply then done;
  }
  • in 和 out 参数是动作的输入和输出。
  • 在 RunPowerCycle 内部,四个动作用法是一个轨道周期的各个步骤:在光照期,阵列收集电能,PDU 为电池充电;在地影期,电池释放能量,PDU 用它为母线供电。
  • flow collect.power to charge.power 表示一个步骤的输出是下一个步骤的输入。
  • first collect then charge 是一个后继:一个步骤完成后下一个步骤才开始。流说明传递什么;后继说明按什么顺序。start 和 done 是外层动作的开始和结束。

这些步骤与 EO-1 的电源功能相对应:F3.1 Convert Sunlight to Power、F3.2 Store Battery Energy 和 F3.3 Regulate Bus Power。从需求推导出这些功能并对其排序,是功能分析的主题;在 SysML v2 中,这项工作的成果就落在动作定义上。

下面的动作流视图根据这段文本以及第 6 步中的分配绘制,分配为每个步骤指定了一条泳道。

视图 powerCycleFlow:先是光照期的步骤,然后是地影期的步骤,以及在它们之间流动的电能。

工程上的结果:在地影期,母线使用的每一瓦电能都要经过电池。电池在光照期储存的能量必须能够满足地影期的负载,而这正是第 7 步中需求 3.2 和 3.3 所约束的。

第 6 步:将行为分配给结构

到目前为止,行为还不属于任何组件。perform 语句说明哪个部件执行哪个步骤:

  part eo1 : Spacecraft {
    part redefines eps {
      perform action powerCycle : RunPowerCycle;
      part redefines solarArrays { perform powerCycle.collect; }
      part redefines battery { perform powerCycle.store; }
      part redefines pdu {
        perform powerCycle.charge;
        perform powerCycle.supply;
      }
    }
  }

eo1 是包顶层的 Spacecraft 用法:这种设计的航天器。它的电源系统执行 RunPowerCycle,每个 EPS 部件执行各自的步骤。part redefines eps 细化从 Spacecraft 继承的电源系统,而不是再添加一个。PDU 执行两个步骤,即光照期充电和地影期为母线供电,因为同一个单元承担这两项工作。

这是功能分配的文本形式。据此,工具可以列出每个组件执行的功能,或像上面的视图那样以每个部件一条泳道绘制动作流。

第 7 步:带约束的需求

需求放在单独的包中,该包导入设计。在 SysML v2 中,需求是针对某个主体的约束:doc 文本用文字说明需要什么,require constraint 以工具可以求值的形式表达同样的内容。这三条需求是 EO-1 的需求 3.1、3.2 和 3.3,有各自的 id 和措辞。

package CubeSatEPSRequirements {
  doc /* Electrical power requirements of EO-1 (section 3) and how one of them is verified. */

  private import CubeSatEPS::*;
  private import ScalarValues::*;
  private import ISQ::*;
  private import SI::*;

  requirement def <'3.1'> OrbitAveragePower {
    doc /* The solar arrays shall generate at least 28 W orbit-average power at end of life. */
    subject eps : ElectricalPowerSystem;
    attribute required : PowerValue;
    require constraint { eps.orbitAveragePower >= required }
  }

  requirement def <'3.2'> BatteryCapacity {
    doc /* The battery shall store at least 77 Wh at beginning of life. */
    subject eps : ElectricalPowerSystem;
    attribute minimum : EnergyValue;
    require constraint { eps.battery.capacity >= minimum }
  }

  requirement def <'3.3'> DepthOfDischarge {
    doc /* The EPS shall limit battery depth of discharge to 30% per orbit. */
    subject eps : ElectricalPowerSystem;
    attribute limit : Real;
    require constraint { eps.depthOfDischarge <= limit }
  }

  requirement powerSpec {
    doc /* The electrical power requirements EO-1 is built to. */
    subject eps : ElectricalPowerSystem;
    requirement orbitAveragePower : OrbitAveragePower {
      attribute redefines required = 28 [W];
    }
    requirement batteryCapacity : BatteryCapacity {
      attribute redefines minimum = 77 [W*h];
    }
    requirement depthOfDischarge : DepthOfDischarge {
      attribute redefines limit = 0.3;
    }
  }

  satisfy powerSpec by eo1.eps;
}
  • <'3.1'> 是简称:工程师在评审中引用的标识符。其他模型元素引用完整名称 OrbitAveragePower。
  • subject eps : ElectricalPowerSystem 指明需求针对的对象。
  • require constraint { eps.orbitAveragePower >= required } 是必须成立的条件。限值是一个参数,因此同一个定义也适用于电源需要不同的航天器。
  • powerSpec 汇集 EO-1 的需求并设定限值:28 W、77 Wh 和 0.3。
  • satisfy powerSpec by eo1.eps 声称 EO-1 的电源系统满足该规格说明。

让 doc 文本和约束表达相同的内容。评审人员阅读文本;工具计算约束。从需求到设计和测试的关联,是需求可追溯性的基础。

需求视图以树的形式显示规格说明,以及满足它的部件和第 8 步中的验证用例:

视图 requirementTree:需求 3.1 到 3.3、满足它们的内容以及验证它们的内容。

由于约束可以求值,检查器所做的不只是绘制 satisfy 线:它会用第 3 步中的值检验这一声称。按目前所写的模型,三条需求都成立:28.05 W 对照 28 W,77 Wh 对照 77 Wh,放电深度 0.24 对照 0.3。

其中第一个裕度很小。将电源路径效率从 0.6 降低到 0.59,变化不到百分之二,轨道平均功率就降到 27.58 W。检查器随即报告需求 3.1 不再满足,并给出导致不满足的值:

一个设计值变化后的需求检查:警告指出了需求、部件、约束和值。

工程上的结果:需求 3.1 本身已经包含系统裕度(其 EO-1 依据是 24 W 的成像模式负载再加 15%),但阵列满足 3.1 时只富余 0.05 W。任何估算中未包括的损失,例如电池片更快的衰减,都需要更大的阵列面积或更小的负载。在每次变更时都检查需求的模型,会在数值变动时就显示这一点,而不是等到下一次评审。要了解在输入不确定而非固定时裕度保持住的可能性有多大,请参见系统工程中的蒙特卡罗分析。

第 8 步:验证用例

satisfy 关系是一种声称,第 7 步中的检查只用模型自己的数值来检验它。验证用例说明如何在真实硬件上通过测试、检查、分析或演示来检验这一声称。EO-1 用测试用例 TC-07 验证其电池容量。

  verification def <'TC-07'> BatteryCapacityTest {
    doc /* Discharge the pack at C/2 from full charge in a thermal chamber at 20 degrees C and measure the energy delivered. */
    subject eps : ElectricalPowerSystem;
    objective {
      verify powerSpec.batteryCapacity;
    }
    return verdict : Boolean = eps.battery.capacity >= powerSpec.batteryCapacity.minimum;
  }

  verification batteryTest : BatteryCapacityTest {
    subject eps = eo1.eps;
  }
  • objective { verify powerSpec.batteryCapacity; } 指明该用例所验证的需求。验证矩阵正是由这些关联构建的:每条需求对照验证它的用例。
  • return verdict 是结果:这里是实测容量是否达到需求 3.2 的 77 Wh。
  • batteryTest 是针对 EO-1 电源系统的该用例的用法:计划中的测试,其主体绑定到 eo1.eps。

满足和验证是有意分开的。满足说明哪个设计元素回应一条需求;验证说明您如何知道它确实做到了。在 EO-1 项目中,TC-07 已通过,实测为 78.3 Wh。需求 3.1 和 3.3 仍需要各自的用例,而需求验证矩阵正是显示这一缺口的地方。

第 9 步:视图和图

在 SysML v2 中,图不是单独的绘图。视图是模型的一个元素,声明要显示什么 (expose) 以及包含哪些种类的元素 (filter)。工具渲染视图并保存其布局;内容始终来自模型。上面的三张截图就是这三个视图。

package CubeSatEPSViews {
  doc /* Views of the EO-1 power system. Each view selects part of the model; the layout belongs to the tool. */

  private import CubeSatEPS::*;
  private import CubeSatEPSRequirements::*;
  private import StandardViewDefinitions::*;

  // The EPS parts, their ports and connections.
  view epsConnections : InterconnectionView {
    expose CubeSatEPS::ElectricalPowerSystem;
  }

  // One orbit: the sunlit steps, the eclipse steps and the power that flows between them.
  view powerCycleFlow : ActionFlowView {
    expose CubeSatEPS::RunPowerCycle;
  }

  // The requirements with what satisfies and verifies them.
  view requirementTree : GeneralView {
    filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage;
    expose CubeSatEPSRequirements::**;
  }
}

标准库定义了常见的视图种类:

视图显示内容在本模型中
一般视图任意元素及其关系,以框和线表示requirementTree
互连视图一个装配的各部件及其端口和连接epsConnections
动作流视图行为的各个步骤、它们的顺序以及它们之间流动的内容powerCycleFlow
状态转换视图状态以及状态之间的转换无
序列视图部件之间随时间传递的消息无
网格视图以表格或矩阵形式显示元素或关系无

requirementTree 是一个一般视图,其过滤器只保留需求和 satisfy 关系;了解 SysML v1 图种类的工具(包括 Holarch)会将这样的视图显示为需求图。由于视图是模型的一部分,重命名电池会改变显示它的每一张图,评审人员也可以在文本中准确读出一张图包含哪些内容。

完整模型

三个包合在一起。下载 EO-1 电源系统模型 (cubesat-eps.sysml),或复制下面的文本;两者内容相同。

package CubeSatEPS {
  doc /* The electrical power system (EPS) of the EO-1 CubeSat: solar arrays, a battery pack and a power distribution unit that feed the payload camera and the S-band transmitter. */

  private import ScalarValues::*;
  private import ISQ::*;
  private import SI::*;

  // ---- Ports and interfaces ----
  port def DCPowerPort {
    out attribute voltage : ElectricPotentialValue;
    out attribute current : ElectricCurrentValue;
  }

  port def BusPowerPort {
    out attribute voltage : ElectricPotentialValue;
    out attribute powerLimit : PowerValue;
  }

  interface def BusLink {
    end source : BusPowerPort;
    end load : ~BusPowerPort;
  }

  // ---- Components ----
  part def SolarArray {
    attribute mass : MassValue;
    attribute cellArea : AreaValue;
    attribute cellEfficiency : Real;
    attribute peakPower : PowerValue;
    attribute pathEfficiency : Real;
    port arrayOut : DCPowerPort;
  }

  part def BatteryPack {
    attribute mass : MassValue;
    attribute capacity : EnergyValue;
    port cellsOut : DCPowerPort;
  }

  part def PowerDistributionUnit {
    attribute mass : MassValue;
    attribute busVoltage : ElectricPotentialValue;
    port arrayIn : ~DCPowerPort;
    port batteryIn : ~DCPowerPort;
    port busOut : BusPowerPort;
  }

  part def PayloadCamera {
    attribute powerDraw : PowerValue;
    port powerIn : ~BusPowerPort;
  }

  part def SBandTransmitter {
    attribute powerDraw : PowerValue;
    port powerIn : ~BusPowerPort;
  }

  // ---- Calculations ----
  calc def OrbitAverage {
    doc /* Orbit-average array output (EQ-1.3): peak power times the sunlit fraction times the power path efficiency. */
    in peakPower : PowerValue;
    in sunlitFraction : Real;
    in pathEfficiency : Real;
    return : PowerValue = peakPower * sunlitFraction * pathEfficiency;
  }

  // ---- The assembly ----
  part def ElectricalPowerSystem {
    part solarArrays : SolarArray {
      attribute redefines mass = 0.45 [kg];
      attribute redefines cellArea = 0.2 [m^2];
      attribute redefines cellEfficiency = 0.295;
      attribute redefines peakPower = 75.4 [W];
      attribute redefines pathEfficiency = 0.6;
    }
    part battery : BatteryPack {
      attribute redefines mass = 0.62 [kg];
      attribute redefines capacity = 77 [W*h];
    }
    part pdu : PowerDistributionUnit {
      attribute redefines mass = 0.28 [kg];
      attribute redefines busVoltage = 12 [V];
    }
    port bus : BusPowerPort;

    connect solarArrays.arrayOut to pdu.arrayIn;
    connect battery.cellsOut to pdu.batteryIn;
    bind bus = pdu.busOut;

    attribute sunlitFraction : Real = 0.62;
    attribute eclipseEnergy : EnergyValue = 18.5 [W*h];
    attribute orbitAveragePower : PowerValue = OrbitAverage(solarArrays.peakPower, sunlitFraction, solarArrays.pathEfficiency);
    attribute depthOfDischarge : Real = eclipseEnergy / battery.capacity;
    attribute totalMass : MassValue = solarArrays.mass + battery.mass + pdu.mass;
  }

  part def Spacecraft {
    part eps : ElectricalPowerSystem;
    part camera : PayloadCamera {
      attribute redefines powerDraw = 6.2 [W];
    }
    part transmitter : SBandTransmitter {
      attribute redefines powerDraw = 3.4 [W];
    }

    interface payloadPower : BusLink connect eps.bus to camera.powerIn;
    interface radioPower : BusLink connect eps.bus to transmitter.powerIn;
  }

  // ---- Behavior ----
  item def Sunlight;
  item def ArrayPower;
  item def ChargePower;
  item def DischargePower;
  item def BusPower;

  action def ConvertSunlight {
    in item sun : Sunlight;
    out item power : ArrayPower;
  }

  action def ChargeBattery {
    in item power : ArrayPower;
    out item charge : ChargePower;
  }

  action def StoreEnergy {
    in item charge : ChargePower;
    out item discharge : DischargePower;
  }

  action def SupplyBus {
    in item discharge : DischargePower;
    out item bus : BusPower;
  }

  action def RunPowerCycle {
    doc /* One orbit: about 59 minutes of sunlight, then a 36 minute eclipse. */

    action collect : ConvertSunlight;
    action charge : ChargeBattery;
    action store : StoreEnergy;
    action supply : SupplyBus;

    flow collect.power to charge.power;
    flow charge.charge to store.charge;
    flow store.discharge to supply.discharge;

    first start then collect;
    first collect then charge;
    first charge then store;
    first store then supply;
    first supply then done;
  }

  part eo1 : Spacecraft {
    part redefines eps {
      perform action powerCycle : RunPowerCycle;
      part redefines solarArrays { perform powerCycle.collect; }
      part redefines battery { perform powerCycle.store; }
      part redefines pdu {
        perform powerCycle.charge;
        perform powerCycle.supply;
      }
    }
  }
}

package CubeSatEPSRequirements {
  doc /* Electrical power requirements of EO-1 (section 3) and how one of them is verified. */

  private import CubeSatEPS::*;
  private import ScalarValues::*;
  private import ISQ::*;
  private import SI::*;

  requirement def <'3.1'> OrbitAveragePower {
    doc /* The solar arrays shall generate at least 28 W orbit-average power at end of life. */
    subject eps : ElectricalPowerSystem;
    attribute required : PowerValue;
    require constraint { eps.orbitAveragePower >= required }
  }

  requirement def <'3.2'> BatteryCapacity {
    doc /* The battery shall store at least 77 Wh at beginning of life. */
    subject eps : ElectricalPowerSystem;
    attribute minimum : EnergyValue;
    require constraint { eps.battery.capacity >= minimum }
  }

  requirement def <'3.3'> DepthOfDischarge {
    doc /* The EPS shall limit battery depth of discharge to 30% per orbit. */
    subject eps : ElectricalPowerSystem;
    attribute limit : Real;
    require constraint { eps.depthOfDischarge <= limit }
  }

  requirement powerSpec {
    doc /* The electrical power requirements EO-1 is built to. */
    subject eps : ElectricalPowerSystem;
    requirement orbitAveragePower : OrbitAveragePower {
      attribute redefines required = 28 [W];
    }
    requirement batteryCapacity : BatteryCapacity {
      attribute redefines minimum = 77 [W*h];
    }
    requirement depthOfDischarge : DepthOfDischarge {
      attribute redefines limit = 0.3;
    }
  }

  satisfy powerSpec by eo1.eps;

  verification def <'TC-07'> BatteryCapacityTest {
    doc /* Discharge the pack at C/2 from full charge in a thermal chamber at 20 degrees C and measure the energy delivered. */
    subject eps : ElectricalPowerSystem;
    objective {
      verify powerSpec.batteryCapacity;
    }
    return verdict : Boolean = eps.battery.capacity >= powerSpec.batteryCapacity.minimum;
  }

  verification batteryTest : BatteryCapacityTest {
    subject eps = eo1.eps;
  }
}

package CubeSatEPSViews {
  doc /* Views of the EO-1 power system. Each view selects part of the model; the layout belongs to the tool. */

  private import CubeSatEPS::*;
  private import CubeSatEPSRequirements::*;
  private import StandardViewDefinitions::*;

  // The EPS parts, their ports and connections.
  view epsConnections : InterconnectionView {
    expose CubeSatEPS::ElectricalPowerSystem;
  }

  // One orbit: the sunlit steps, the eclipse steps and the power that flows between them.
  view powerCycleFlow : ActionFlowView {
    expose CubeSatEPS::RunPowerCycle;
  }

  // The requirements with what satisfies and verifies them.
  view requirementTree : GeneralView {
    filter @SysML::RequirementDefinition or @SysML::RequirementUsage or @SysML::SatisfyRequirementUsage;
    expose CubeSatEPSRequirements::**;
  }
}

代码清单是如何检查的

本页的每个代码清单都已在加载 SysML v2 标准库的情况下,用 Holarch Language Engine(Holarch 的 SysML v2 编辑器背后的引擎)进行了解析和检查。检查会解析每个名称,比较单位和量纲,比较连接两端的端口方向,并根据满足需求的值计算需求约束。

  • 完整模型和独立清单都没有错误,也没有警告。
  • 每个摘录都按顺序、逐行出现在完整模型中。
  • 两个展示错误的清单恰好产生其旁边所述的那个错误和那个警告。
  • 将电源路径效率设为 0.59 的完整模型恰好产生一个警告:需求 3.1 未满足。

关于该引擎支持哪些 SysML v2 构造及其已知差距,请参见 SysML v2 语言覆盖范围。要在相同的要点上比较工具,请参见 SysML v2 工具需要检查什么;这个模型足够小,可以用作测试文件。

在 Holarch 中试用

  1. 下载 cubesat-eps.sysml,或将完整模型以该名称保存。
  2. 打开模型 → 导入和导出,选择导入到新的 SysML v2 项目,然后拖放该文件。参见将文件导入新项目。
  3. 打开模型 → 编辑器阅读和更改文本。每个包都是一个文档。参见编辑器。
  4. 打开图列表,点击 epsConnections、powerCycleFlow 或 requirementTree。参见打开视图。
  5. 在 CubeSatEPS 中,将 pathEfficiency = 0.6 改为 0.59 并停顿。编辑器会在 CubeSatEPSRequirements 中的 satisfy 行上显示警告。用 ⌘Z / Ctrl+Z 撤销。

如果想手工输入模型,请创建一个 SysML v2 项目,在编辑器中点击+ 新建包,然后按顺序编写各个步骤;可解析的文本会在短暂停顿后应用。参见 SysML v2 项目入门。包含文档、测试和预算的整个 EO-1 航天器就是 CubeSat 演示项目:项目文件 ▾ → 新建演示项目。

后续阅读