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 提供 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 的其餘部分(姿態控制、飛行電腦、結構)未納入,以保持模型精簡。

這些值不只是被儲存;工具會評估它們。以上述數值計算:

屬性運算式結果
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)。

Interconnection View 根據這段文字繪製電力系統:每個零件的埠位於邊緣,共軛埠以 ~ 標示,繫結的 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 中的落腳處。

下方的 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 中試試看

  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 示範:專案檔案 ▾ → 新增示範專案。

下一步