Holarch

SysML v2

SysML v2 專案入門

在 LML 與 SysML v2 專案之間做選擇、建立 SysML v2 專案或示範專案、撰寫第一個模型並熟悉操作環境。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 兩種專案類型
    2. 模型與文字是一體的
    3. 模型資料與 Holarch 資料
    4. 定義與用法
  3. 使用方式
    1. 選擇專案類型
    2. 建立 SysML v2 專案
    3. 開啟 Hybrid Car 示範專案
    4. 開啟 Hybrid Car Battery Pack 示範專案
    5. 開啟地球觀測衛星示範專案
    6. 撰寫您的第一個模型
    7. 熟悉操作環境
  4. 實作範例:探索 Hybrid Car
  5. 提示與常見錯誤
  6. SysML v2 專案中的導覽列
  7. 簡易模式
    1. 開啟或關閉
    2. 顯示的內容
    3. 全部顯示
  8. 首頁
  9. 詢問 AI
  10. 尚未提供
  11. 訊息
  12. 限制
  13. 相關頁面

概觀

Holarch 支援 SysML v2 專案。SysML v2 專案包含一個模型,以 SysML v2 文字表示法撰寫,並以 OMG SysML v2 規格為基礎。

您在編輯器中以文字撰寫模型。Holarch 會以元素保存同一個模型:套件、定義、用法與關係。瀏覽器、各檢視與生命週期頁面(需求、驗證、介面、風險、計畫)都顯示這些相同的元素。

本頁說明兩種專案類型、如何開始 SysML v2 專案,以及各項內容的位置。語言本身請參閱 SysML v2 文字表示法。編輯器與瀏覽器請參閱文字編輯器與瀏覽器。

概念

兩種專案類型

每個 Holarch 專案都是 LML 專案或 SysML v2 專案。您在建立專案時選擇類型。類型是固定的:專案只能透過轉換後的副本變更類型(請參閱在 LML 與 SysML v2 之間轉換)。

LMLSysML v2
用途以生命週期建模語言建立系統模型:需求、功能、實體架構、介面、測試、風險與時程。Holarch 會在每個步驟檢查您的成果。以 SysML v2 語言、以文字並使用標準 SysML v2 概念建立模型:套件、定義與用法、埠、連接、動作、狀態與需求。
建立模型的方式資料庫、表單,以及 30 種以上的圖類型。編輯器中的文字,加上寫入同一份文字的檢視與生命週期頁面。
可以交換的內容Word、Excel、CSV、ReqIF 與 XMI 匯入;Word、Excel 與圖匯出;專案檔案。SysML v2 文字(.sysml)與 SysML v2 JSON(請參閱交換 SysML v2 模型);從 XMI 及 Cameo 或 MagicDraw .mdzip 檔案匯入 SysML v1(請參閱匯入 SysML v1 模型);專案檔案。

如果不確定,請選擇 LML。它具備所有 Holarch 頁面與圖,適合剛接觸 MBSE 的人。當您的團隊已經以 SysML v2 建模,或要與 SysML v2 工具交換模型時,請選擇 SysML v2。

模型與文字是一體的

SysML v2 專案內沒有檔案。模型是一組元素,編輯器會為每個最上層套件顯示一份文字文件。文字可以解析時,Holarch 會將其套用至模型。當您在其他地方(檢視、表格、屬性面板)變更模型時,文字也會隨之變更。請參閱文字與檢視保持同步。

模型資料與 Holarch 資料

有些資訊是 SysML 文字的一部分;有些則由 Holarch 保存在模型旁。

  • 在文字中:元素名稱、簡稱(需求編號)、文件說明、類型、多重性、值,以及 satisfy、verify、perform 與 connect 等關係。
  • 在模型旁(Holarch 資料):需求狀態與核准、驗證結果、標籤、指派對象、到期日、討論留言、檢視版面配置、模擬器設定、預算、風險、決策與任務。它們以識別碼關聯到模型元素,因此重新命名與移動後關聯仍會保留。

Holarch 資料不會寫入 SysML 文字,也不屬於 .sysml 匯出的一部分。

定義與用法

大多數 SysML v2 關鍵字都有兩種形式。定義(part def Wheel;)描述一種事物。用法(part frontWheel : Wheel;)是在另一個元素內對定義的一次使用。port def/port、action def/action 與 requirement def/requirement 也是相同的模式。SysML v2 文字表示法有完整的說明。

使用方式

選擇專案類型

建立專案之前請先決定類型。

  1. 若要使用完整的 Holarch 方法,請選擇 LML:資料庫、LML 圖,以及每個步驟的引導式檢查。
  2. 當模型必須是 SysML v2 文字時,例如要與另一個 SysML v2 工具交換,請選擇 SysML v2。
  3. 若要先試用 SysML v2,請開啟 Hybrid Car 示範專案(下下個工作流程),而不是空白專案。

建立 SysML v2 專案

  1. 開啟管理專案並按一下 + 新增專案。
  2. 在您要如何為此系統建模?下,選擇 SysML v2。
  3. 輸入名稱並按一下建立專案。

專案會在首頁開啟。頂端列與管理專案中的專案名稱旁會顯示 SysML v2 標籤。新模型是空的:首頁上的後續動作會顯示在編輯器中撰寫第一個套件。

開啟 Hybrid Car 示範專案

Hybrid Car 示範專案是一個完成的 SysML v2 模型,可供探索與編輯。

  1. 開啟管理專案。
  2. 按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。

Holarch 會建立專案 Hybrid Car (SysML v2 demo) 並在首頁開啟。按一下導覽列中的編輯器即可閱讀文字。模型有六個最上層套件:Vehicles、VehicleRequirements、VehicleBehavior、VehicleViews、HolarchFrameworks 與 HybridCarArchitecture。每一個都是編輯器套件清單中的一份文件。

示範專案是您自己的副本。可以自由變更,或重新建立以從頭開始。

若要從連結開啟示範專案,請使用 https://app.holarch.app/#/?demo=hybrid。它會建立並開啟示範專案;在託管的應用程式上,會在您登入後開啟。

開啟 Hybrid Car Battery Pack 示範專案

Hybrid Car Battery Pack 示範專案是由供應商建模的汽車牽引電池組,位於獨立的專案中。若您的專案中也有 Hybrid Car 示範專案(無論在其之前或之後建立),三項電池組需求會關聯到汽車的電池需求(BP-1 到 VR-3、BP-2 到 VR-6、BP-3 到 VR-5),因此管理專案 → 計畫群地圖會顯示兩個專案如何連接。這些示範關聯在每個方案上都能運作。

  1. 開啟管理專案。
  2. 按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car Battery Pack (SysML v2)。

可以嘗試的事:

  • 計算值:在編輯器中,Pack::mass 會加總各模組(每個模組 12 個電芯與一個外殼)、電池管理系統、接線盒、冷卻系統與機殼:43 kg,對照 48 kg 的限制,因此 massMargin 為 5 kg。Pack::capacity 會加總 120 個電芯:1.44 kWh,對照 1.4 kWh。選取屬性即可在屬性面板中查看其值。
  • 參數檢視:開啟 packParametrics。容量、質量、充電時間與電芯平衡檢查都各自繫結到電池組的值,且都通過。
  • RVTM:容量與質量為通過,充電接受度為未通過(高溫充電測試花了 34 分鐘,對照 30 分鐘),電芯平衡尚未執行。每個驗證案例都從模型計算其判定結果。
  • 模擬器:模擬器會在 pack 上開啟,並與 Hot Day Charge 一起執行。按一下執行到結束,然後按一下狀態:電芯過熱時充電會降為半功率,冷卻後恢復。在一起執行下選擇 Cell Over Voltage Fault,即可查看保護性關機與維修重設。

開啟地球觀測衛星示範專案

地球觀測衛星示範專案是一個較大的模型:EO-2 任務,一顆 12U 成像衛星及其地面段,約 3,000 行,分布在 14 個套件中。Holarch 自己的資料已填在模型之上,因此每個頁面都有內容可顯示。

  1. 開啟管理專案。
  2. 按一下專案檔案 ▾ → 新增示範專案 → 地球觀測衛星 (SysML v2)。

Holarch 會建立專案 Earth Observation Satellite (SysML v2 demo) 並開啟首頁。此示範專案有 1,549 個項目,超過 Free 方案每個專案 1,000 個項目的限制:在 Free 方案上,其選單項目為停用,並顯示需要 Individual 方案(1,549 個項目)。連結 https://app.holarch.app/#/?demo=eosat 也會建立它。可以嘗試的事:

  • 文件:開啟 EO-2 System Requirements Specification。其章節包含 EORequirements 的需求、即時值與驗證矩陣。
  • 預算:成像儀的質量超過其 4.0 kg 的分配;TPM Imager Mass 會顯示趨勢。
  • 待檢查的連結與 TBD/TBR:已變更的需求與待解決的未定值。
  • 模擬器:從 imagingPassFlow 檢視執行成像過境。
  • 基準線:將 PDR Data Freeze 基準線與目前的模型比較。
  • 檢視:太空船模式、互連檢視與任務指派序列。

撰寫您的第一個模型

此工作流程會以下列文字建立一個小型無人機模型:

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

    part def Battery {
        attribute mass : MassValue = 0.4 [kg];
    }
    part def Quadcopter {
        part battery : Battery;
    }
}
  1. 開啟模型 → 編輯器,按一下 + 新增套件,輸入 Drone 並確認。編輯器會開啟新套件的文字。
  2. 如上所示,在套件的大括號內輸入匯入與成員。
  3. 停止輸入。短暫停頓後,文字下方的狀態列會顯示已套用。模型現在包含該套件、兩個零件定義、屬性與零件,一次復原即可全部撤回。
  4. 開啟模型 → 瀏覽器並展開 Drone,即可以樹狀結構查看相同的元素。

若某一行有錯誤,狀態列會顯示未套用:請修正第 N 行。在文字再次可以解析之前,模型會保留其上一個正確狀態。請參閱錯誤與草稿。

熟悉操作環境

SysML v2 專案保留 Holarch 的生命週期導覽列。每個群組都在 SysML v2 模型上運作。

  1. 從首頁開始,查看需要處理的事項、生命週期群組與後續動作。
  2. 使用模型 → 編輯器撰寫文字,使用模型 → 瀏覽器查看樹狀結構。
  3. 使用需要與需求與驗證處理需求、驗證案例與可追溯性。
  4. 使用行為、架構與介面處理檢視與分析頁面。
  5. 開啟導覽列底部的圖工具,即可查看每個檢視。
  6. 按 ⌘K / Ctrl+K,可依名稱、簡稱、限定名稱(Vehicles::Car)或文件說明文字尋找任何元素。
  7. 剛接觸 SysML v2?開啟簡易模式,即可優先查看最常用的元素。

實作範例:探索 Hybrid Car

此逐步說明使用 Hybrid Car 示範專案。

  1. 建立示範專案(請參閱開啟 Hybrid Car 示範專案)。它會在首頁開啟。開啟模型 → 編輯器,然後在套件清單中選擇 Vehicles。
  2. 找到 part def Car。它有零件 body、powertrain、frontAxle、rearAxle 與 spare : Wheel [0..1]。
  3. 在 part powertrain : Powertrain; 中按住 ⌘ / Ctrl 並按一下 Powertrain。游標會跳到 part def Powertrain,其零件為 tank、engine、motor、battery、transmission 與 controller,並有 interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn; 等介面。
  4. 將指標移到 attribute mass : MassValue; 中的 MassValue 上。卡片會顯示其種類,以及來自標準庫的限定名稱。
  5. 開啟模型 → 瀏覽器。在依名稱篩選中輸入 sedan。樹狀結構會在 Vehicles 中的 fleet 下顯示 sedan。選取它:屬性面板會顯示 Kind part、Typed by Car,以及限定名稱 Vehicles::fleet::sedan。
  6. 開啟首頁。需要與需求的生命週期卡片會計算模型的需求數;需要處理會顯示模型的待審查關聯、逾期的 TBD 與高風險。
  7. 開啟需要與需求 → 需求。列中包含 VR-1.1 sedanMass,這是一個需求用法,其編號就是其簡稱 <'VR-1.1'>。
  8. 開啟圖工具並開啟 driveCycleFlow,這是 DriveCycle 的動作流程檢視。在該處重新命名一個動作,然後回到編輯器:VehicleBehavior 會顯示新名稱。

提示與常見錯誤

  • 從示範專案開始。從 Hybrid Car 文字中複製模式,是學習表示法最快的方式。
  • 匯入單位。5 [kg] 需要 SI(而 MassValue 需要 ISQ)為可見。請在套件中加入 private import ISQ::*; 與 private import SI::*;。
  • 每個專案保持一個模型。將大型模型拆分為數個最上層套件;每個套件在編輯器中都是一份獨立的文件。
  • 選錯類型。類型無法就地切換。請從管理專案製作轉換後的副本(⋯ → 建立 LML 副本…或建立 SysML v2 副本…)。
  • 期望在文字中看到狀態。需求狀態、驗證結果與標籤屬於 Holarch 資料。它們不會出現在文字中,也不會出現在 .sysml 匯出中。

SysML v2 專案中的導覽列

群組頁面
首頁需要處理、生命週期、後續動作與其他首頁面板
需要與需求文件、需求、品質、TBD/TBR、待檢查的連結、核准、符合性矩陣*
模型編輯器、瀏覽器、匯入和匯出
行為功能分析、動作流程、FFBD、狀態機、序列、模擬器
架構零件、General View、Interconnection View、階層、預算與 TPM
介面介面登錄表、ICD、N² 圖、項目與輸入/輸出
驗證RVTM、驗證案例、偏離與特採*、可追溯性矩陣、計畫群涵蓋範圍、模型檢查
安全性與可靠度†危害記錄、FMECA、故障樹、可靠度方塊圖
風險、問題與決策風險登錄表、Risk 圖、權衡研究、決策、問題與行動
方案我的工作、SE 流程、專案管理、圖表、白板、簡報
控制與審查變更請求、基準線和版本、庫、審查、活動
框架DoDAF、UAF

* 需開啟正式計畫群。† 需開啟安全性與可靠度計畫群。兩者都在專案偏好設定 → 計畫群功能中切換。

底部的側欄工具與 LML 專案相同:資料庫、圖、垃圾桶、設定與說明。在 SysML v2 專案中,設定也會列出標準庫。不適用於 SysML v2 專案的頁面不會顯示。

這些頁面的說明請參閱 SysML v2 檢視、SysML v2 專案中的需求與驗證、SysML v2 專案中的評估、單位與分析以及 SysML v2 專案中的 Holarch 功能。

簡易模式

簡單模式適合剛接觸 SysML v2 的人。它會顯示大多數模型一開始使用的元素,以一句話說明每個元素,並在您要求之前隱藏其餘元素。它只改變您看到的內容:模型、其文字與每種匯出都維持不變。

開啟或關閉

  • 偏好設定 → SysML v2 → 簡單模式。
  • 模型 → 瀏覽器頁首中的簡單模式(開啟時呈按下狀態)。
  • ⌘K / Ctrl+K → 開啟簡單模式或關閉簡單模式。

預設為關閉。此設定屬於您的帳戶:它會跟著您到任何您登入的電腦,並在您登入時套用帳戶的設定。重設偏好設定不會變更它。

第一次開啟 SysML v2 專案時,頂端列下方會出現一則提示:剛接觸 SysML v2?開啟簡單模式,先查看最常用的元素。按一下開啟即可開啟簡單模式,或按一下 × 關閉提示。無論選擇哪一個,答案都會保存在您的帳戶中,提示不會再出現。在您未回答之前,每次開啟 SysML v2 專案時都會顯示。簡單模式已開啟時不會顯示。

顯示的內容

十二個概念,也就是 Hybrid Car 示範專案與教學課程最常用的概念:套件、零件、屬性、埠、連接與介面、動作、流與接續、狀態、轉換、需求、satisfy 以及驗證。

位置在簡單模式中在「顯示全部」之前隱藏
General View,新增面板套件、零件定義、零件、埠定義、埠、屬性、介面定義、動作定義、動作、需求定義、需求、驗證案例屬性定義、項定義、列舉定義
Spider 圖,新增面板套件、零件定義、零件、埠定義、埠、屬性、動作定義、動作、狀態、需求定義、需求、驗證案例項定義、項、屬性定義、使用案例
Interconnection View,新增面板零件、埠項目
State Transition View,新增面板初始狀態、最終狀態、狀態、進入動作、執行動作、離開動作平行狀態、區域
Action Flow View,新增面板與 + Action ▾動作、分叉、匯合、決策、合併、泳道接受、傳送、迴圈、終止
編輯器,插入 ▾套件、零件定義、零件、屬性、埠定義、埠、介面、連接、動作定義、動作、接續、流、狀態定義、狀態、初始狀態、轉換、需求定義、需求、Satisfy、驗證定義、Verify所有其他適用於游標位置的程式碼片段
模型 → 瀏覽器套件、定義、用法、連接、流、轉換、需求、satisfy 與 verify匯入、別名、expose、註解、說明文件、中繼資料、庫套件、繫結連接器、KerML 層級元素,以及轉換的觸發條件與效果列

將指標指向新增面板中的項目,或瀏覽器中某列的種類,即可閱讀該元素的一句話說明。

Requirement、Use Case、Parametric、Sequence、Package 與 Geometry 檢視,以及 Hierarchy、Tree、IDEF0 與 FFBD 面板會保留所有項目:每一個都以其新增的種類為主題。+ 新增圖、表格、搜尋、屬性面板以及在編輯器中輸入(含自動完成)都不會篩選。

全部顯示

  • 新增面板:項目下方的顯示全部(另有 n 個);顯示較少會再次隱藏它們。
  • + Action ▾:結尾的顯示全部…會重新開啟包含所有種類的選單。
  • 插入 ▾:勾選其標題中的顯示全部。
  • 瀏覽器:勾選篩選列中的顯示全部。

「顯示全部」會持續到您重新載入頁面或切換簡單模式為止,期間簡單模式維持開啟。在瀏覽器中,從其他地方開啟的元素(例如屬性面板中的在瀏覽器中顯示)一律會連同其擁有者一起顯示,即使其種類已隱藏。

首頁

首頁與 LML 專案中的頁面相同(請參閱首頁):需要處理(待審查的關聯、逾期的 TBD、失敗的測試、TPM 超限、高風險、模型檢查、儲存狀態)、每個側欄群組一張生命週期卡片,以及後續動作、SE 流程關卡與里程碑等面板。計數來自 SysML v2 模型及其旁的 Holarch 資料。SysML v2 專案不提供 ✦ 撰寫專案摘要。

  • 側欄群組會顯示相同的問題徽章,每個群組的總覽頁面會列出需要處理的事項及其數量。
  • + 新增面板 → 模型內容會顯示套件(含頂層套件數量)、定義、用法、關係與需求(n 個未滿足 · n 個未驗證)、元素失去擁有者時的錯置的元素,以及最近的變更:最新的模型變更(建立、變更、移動、刪除或還原),附元素的種類與時間。

詢問 AI

詢問 AI 會根據說明與 Docs 回答有關 SysML v2 語言與 Holarch 使用方式的問題。在 Individual 與 Team 方案中,以及使用您自己或您組織的 AI 金鑰時,它也會回答有關開啟中模型的問題並提議變更,這些變更會在套用前開啟供審查。請參閱詢問 AI。

尚未提供

  • 透過 Systems Modeling API 提交至 main、標籤與合併:其他工具會提交到變更請求分支,再由核准者在 Holarch 中套用(請參閱 SysML v2 專案中的 API 與 MCP)。
  • 編輯語言本身:標準庫為唯讀。

SysML v2 文字表示法詳細列出所支援的語言。

訊息

訊息意義
模型是空的專案沒有任何元素。按一下 + 新增套件,然後在編輯器中撰寫其成員。
未套用:請修正第 N 行。文字在第 N 行有錯誤。在文字可以剖析之前,模型會維持最後一次正確的狀態。
僅供檢視:請向擁有者要求編輯權限。您對此專案只有檢視權限。文字與頁面為唯讀。
此專案需要較新版本的 Holarch。較新版本的 Holarch 儲存了此專案,而此頁面較舊。專案會以僅供檢視開啟,頂端的橫幅會說明原因。按一下橫幅中的重新載入即可取得新版本。

限制

  • 專案類型在建立時即固定。
  • 每個專案一個模型。
  • 大於 8 MB 的文字文件不會檢查;請將其分成數個套件。

SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。