指南 · SysML v2
SysML v2 教程:用文本表示法为 CubeSat 电源系统建模
收听本指南(英文音频) 24 分钟
本 SysML v2 教程逐步构建一个小而完整的模型:EO-1 CubeSat 的电源系统,包括其部件、量和单位、端口和连接、光照与地影周期、工具可以检查的需求、一个验证用例以及视图。本页的每个代码清单都是经过语言引擎检查的 SysML v2 文本,每个关键步骤都会显示该文本生成的图。
本页内容
您将构建什么
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 步 |
| 质量:阵列、电池、PDU | 0.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-07 | 7 和 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 的其余部分(姿态控制、飞行计算机、结构)为保持模型简短而省略。
这些值不只是被存储;工具会对它们求值。用上面的数值:
| 属性 | 表达式 | 结果 |
|---|---|---|
orbitAveragePower | 75.4 W × 0.62 × 0.6 | 28.05 W |
depthOfDischarge | 18.5 Wh ÷ 77 Wh | 0.24 |
totalMass | 0.45 kg + 0.62 kg + 0.28 kg | 1.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 端口位于框架上。
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 中试用
- 下载
cubesat-eps.sysml,或将完整模型以该名称保存。 - 打开模型 → 导入和导出,选择导入到新的 SysML v2 项目,然后拖放该文件。参见将文件导入新项目。
- 打开模型 → 编辑器阅读和更改文本。每个包都是一个文档。参见编辑器。
- 打开图列表,点击
epsConnections、powerCycleFlow或requirementTree。参见打开视图。 - 在 CubeSatEPS 中,将
pathEfficiency = 0.6改为0.59并停顿。编辑器会在 CubeSatEPSRequirements 中的satisfy行上显示警告。用 ⌘Z / Ctrl+Z 撤销。
如果想手工输入模型,请创建一个 SysML v2 项目,在编辑器中点击+ 新建包,然后按顺序编写各个步骤;可解析的文本会在短暂停顿后应用。参见 SysML v2 项目入门。包含文档、测试和预算的整个 EO-1 航天器就是 CubeSat 演示项目:项目文件 ▾ → 新建演示项目。
后续阅读
- Holarch 中的 SysML v2 项目:基于同一个模型的文本、视图和工程页面。
- 文本表示法参考:Holarch 支持什么、各项检查以及标准库。
- 视图参考:每种视图以及如何在其中编辑模型。
- SysML v2 项目中的需求与验证:需求页面、测试中心和 RVTM。
- SysML v2 项目中的分析:参数分析、预算和权衡研究。
- 什么是 MBSE?:工程师为什么要把系统保存在模型中。