Holarch

ガイド · SysML v2

SysML v2 チュートリアル:テキスト表記で CubeSat の電源システムをモデル化する

このガイドを聴く(英語音声) 24 min

この 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 Discharge1 周回あたり 30% 以下ステップ 7
テストケース TC-07 Battery Capacity Test20 °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 は、定義 BatteryPack で型付けされた battery という名前の使用を宣言します。
  • 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.295 のセル 0.2 m² に、1361 W/m² の太陽光が入射角 0.35 rad(cos 0.35 = 0.939)で当たると、75.4 W になります。日照率は軌道から求まります。高度 500 km の軌道は 1 周に約 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 の内部ではなく、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 の中の四つのアクション使用は、1 周回のステップです。日照中はアレイが電力を集め、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:日照中のステップ、続いて日陰のステップと、その間を流れる電力。

エンジニアリング上の帰結:日陰でバスが使う電力はすべてバッテリーを経由します。バッテリーが日照中に蓄えたものが日陰の負荷をまかなわなければならず、それがまさにステップ 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 W に対して 28.05 W、77 Wh に対して 77 Wh、0.3 に対して放電深度 0.24 です。

最初のマージンはわずかです。電力経路の効率を 0.6 から 0.59 に下げると、変化は 2 パーセント未満ですが、軌道平均電力は 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 は、フィルターで要求と satisfy 関係だけを残す General View です。Holarch を含め、SysML v1 のダイアグラムの種類を知っているツールは、このようなビューを要求図として表示します。ビューはモデルの一部なので、バッテリーの名前を変更すると、それを表示するすべてのダイアグラムが変わり、レビュー担当者はダイアグラムが何を含むかをテキストで正確に読めます。

完全なモデル

三つのパッケージをまとめたものです。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::**;
  }
}

リストの確認方法

このページのすべてのリストは、Holarch の SysML v2 エディターを支えるエンジンである Holarch Language Engine で、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 デモです:プロジェクトファイル ▾ → 新しいデモプロジェクト。

次に読むもの