指南 · 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提供kg、V、W與h等 SI 單位。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)。
Interconnection View 根據這段文字繪製電力系統:每個零件的埠位於邊緣,共軛埠以 ~ 標示,繫結的 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 中的落腳處。
下方的 Action Flow 檢視是根據這段文字與步驟 6 中的分配一起繪製的,分配為每個步驟指定一條泳道。
powerCycleFlow 檢視:先是日照下的步驟,接著是蝕期間的步驟,以及它們之間流動的電力。工程上的結果:匯流排在蝕期間使用的每一瓦電力都經過電池。電池在日照下儲存的能量必須足以應付蝕期間的負載,這正是需求 3.2 與 3.3 在步驟 7 中所約束的。
步驟 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::**;
}
}
標準庫定義了常見的檢視種類:
| 檢視 | 顯示內容 | 在此模型中 |
|---|---|---|
| General View | 任何元素及其關係,以方塊與線條表示 | requirementTree |
| Interconnection View | 一個組件的零件及其埠與連接 | epsConnections |
| Action Flow 檢視 | 一個行為的步驟、其順序,以及步驟之間流動的內容 | powerCycleFlow |
| 狀態轉換檢視 | 狀態以及狀態之間的轉移 | 無 |
| 序列檢視 | 零件之間隨時間傳遞的訊息 | 無 |
| Grid View | 以表格或矩陣呈現的元素或關係 | 無 |
requirementTree 是一個 General View,其篩選只保留需求與 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?:工程師為何將系統保存在模型中。