Holarch

SysML v2

המרה בין LML ל-SysML v2

יצירת עותק SysML v2 של פרויקט LML, או עותק LML של פרויקט SysML v2, עם דוח של מה שמומר ומה שלא.

אופן השימוש ←

בדף זה
  1. סקירה כללית
  2. מושגים
    1. עותק, לא שינוי סוג
    2. כיצד שתי השפות ממופות
    3. נתוני Holarch עוברים יחד
    4. מה לא מומר
  3. איך להשתמש בה
    1. מתי ולמה
    2. יצירת עותק מומר
    3. בדיקת העותק
    4. דוגמה מעובדת: הדגמת Hybrid Car כעותק LML
    5. עצות ושיטות עבודה טובות
    6. טעויות נפוצות
  4. מדריך הדוח
    1. מ-LML ל-SysML v2
    2. מ-SysML v2 ל-LML
    3. קובץ CSV של הדוח
  5. הודעות
  6. מגבלות
  7. דפים קשורים

סקירה כללית

סוג הפרויקט, LML או SysML v2, נקבע בעת יצירתו. כדי לעבוד על מודל LML ב-SysML v2, או על מודל SysML v2 עם דפי LML, יש ליצור עותק מומר:

  • יצירת עותק SysML v2… בפרויקט LML כותב את המודל שלו כטקסט SysML v2 בפרויקט SysML v2 חדש.
  • יצירת עותק LML… בפרויקט SysML v2 הופך את המודל שלו לישויות ולקשרים של LML בפרויקט LML חדש.

הפרויקט המקורי לעולם אינו משתנה. לפני יצירת העותק, דוח מפרט מה מומר, עם ספירות, ומה לא, עם הסיבה. אותו דוח נשמר בפרויקט החדש.

מושגים

עותק, לא שינוי סוג

המרה תמיד יוצרת פרויקט חדש. אפשר להמשיך לעבוד במקור ולהמיר שוב מאוחר יותר; כל המרה יוצרת פרויקט חדש נוסף. שום דבר אינו מקשר את העותק בחזרה למקור.

כיצד שתי השפות ממופות

LML ו-SysML v2 מתארות רבים מאותם דברים בדרכים שונות. ההמרה משתמשת במיפוי הזה בשני הכיוונים:

LMLSysML v2
Assetהגדרת חלק (part definition), עם שימוש בחלק (part usage) בכל מקום שבו הוא משמש
פירוק של Asset (decomposed by)שימוש בחלק בהגדרה של ההורה
Portשימוש ב-port (port usage)
Characteristic של Assetשימוש בתכונה (attribute usage)
Conduitשימוש בחיבור (connection usage), או שימוש בממשק (interface usage) כששני הקצוות הם ports
Input/Outputהגדרת פריט (item definition), עם פרמטרי פריט in ו-out וזרימות
Requirement (מספר, שם, תיאור)שימוש בדרישה (requirement usage) (שם מקוצר, שם, doc)
satisfied bysatisfy
Test Caseשימוש באימות (verification usage) עם מטרת verify
Test Suiteחבילה של מקרי אימות
Action, עם הזרימה שלושימוש בפעולה (action usage) עם successions
SYNC ובלוקים מקביליםFork ו-join
ORDecide ו-merge
LOOPפעולת לולאה (loop action)
performed byperform
מאפייני מצב ומעבריםהגדרת מצב (state definition) עם מעברים, שהחלק מציג (exhibits)
Equation והמשתנים שלההגדרת אילוץ (constraint definition) עם הפרמטרים שלה

נתוני Holarch עוברים יחד

לחלק מהנתונים אין מקום באף אחת מהשפות. אלה נתוני Holarch, והם מועתקים עם הקישורים שלהם:

  • סיכונים, החלטות, משימות, עלויות, לוחות זמנים, סוגיות, מסמכים ולוחות ציור מועתקים ונשארים מקושרים לאלמנטים המומרים.
  • סטטוס הדרישה ושיטות האימות נשארים עם כל דרישה; תוצאות הבדיקות נשארות עם כל מקרה בדיקה. גם מצבים מותאמים אישית של תהליכי עבודה של מחלקות נשמרים.
  • שינויים בסכמה עוברים בשני הכיוונים, כולל תהליכי עבודה של מחלקות עם המצבים, המצבים שהוצאו משימוש, המעברים והמאשרים שלהם.
  • תגובות דיון עוקבות אחר האלמנט שלהן.
  • הסתברויות ענפים של החלטות נשארות עם הענפים שלהן, עבור הסימולטור.
  • עותק LML שנוצר מעותק SysML v2 מקבל בחזרה את תכונות ה-LML והתוויות שההמרה הראשונה שמרה.

מה לא מומר

  • פריסות דיאגרמה. תצוגות ודיאגרמות משורטטות מחדש בעותק.
  • היסטוריה, קווי בסיס ובקשות שינוי. העותק מתחיל בלעדיהם.
  • אלמנטים שאין להם מקום באחת השפות, כמו Measures ו-Resources של LML, או enumerations, calculations ו-analysis cases של SysML v2.

הדוח מציין כל פריט כזה ונותן את הסיבה. ראו מדריך הדוח.

איך להשתמש בה

מתי ולמה

כדאי להמיר כששפת הפרויקט כבר אינה מתאימה לעבודה:

  • מ-LML ל-SysML v2: הצוות שלך או לקוח עובדים כעת ב-SysML v2, או שיש להחליף את המודל עם כלי SysML v2. יש להמיר, ואז לייצא .sysml או JSON (ראו החלפת מודלים של SysML v2).
  • מ-SysML v2 ל-LML: נדרש דף או דיאגרמה של LML שאין בפרויקטי SysML v2, או שרוצים את המודל בצורת מחזור החיים של Holarch לצורך סקירה.

כדאי להמיר כשהמודל יציב, ולקרוא את הדוח לפני שמסתמכים על העותק.

יצירת עותק מומר

  1. בניהול פרויקטים, יש ללחוץ על ⋯ בשורת הפרויקט.
  2. יש לבחור יצירת עותק SysML v2… (לפרויקט LML) או יצירת עותק LML… (לפרויקט SysML v2).

    Holarch בודק את ההמרה; בפרויקט גדול, סרגל התקדמות בתחתית החלון מציג "בודק את ההמרה…". אחר כך נפתחת תיבת הדו-שיח עם הדוח.

  3. יש לקרוא את הדוח:
    • הומר מפרט כל סוג פריט, כמה יש ממנו ולמה הוא הופך, למשל "דרישות 24 שימושי דרישה".
    • לא הומר מפרט כל סוג פריט שאינו מומר, כמה יש ממנו ולמה.
  4. יש ללחוץ על הורדת הדוח (CSV) כדי לשמור את הדוח עם שורה אחת לכל פריט, אם יש בו צורך מחוץ ל-Holarch.
  5. יש להזין את שם הפרויקט החדש. ברירת המחדל היא שם המקור ואחריו "(SysML v2)" או "(LML)".
  6. יש ללחוץ על יצירת עותק.

    ההודעה הקופצת מציגה "נוצר "<name>"". העותק נפתח בדף הבית שלו.

  7. יש לפתוח בעותק את המסמך דוח המרה. הוא מפרט כל פריט שלא הומר, לפי מספר ושם.

בדיקת העותק

  1. בעותק SysML v2, יש לפתוח את מודל → עורך.

    המודל הוא חבילה אחת ברמה העליונה הנקראת על שם הפרויקט. היא מכילה את החבילות Architecture, System, Items, Requirements, Verification, Behavior, Constraints ו-Views (רק אלה שיש בהן תוכן).

  2. יש לחפש סימוני בעיות בשוליים. אם בטקסט המומר יש בעיות, תיבת הדו-שיח ציינה זאת לפני יצירת העותק: "בטקסט המומר יש N בעיות. העותק מציג אותן בעורך שלו."
  3. יש לפתוח את התצוגות בתצוגות (Architecture Overview, System Connections) כדי לראות את המבנה משורטט מחדש.
  4. בעותק LML, יש לפתוח את מסד הנתונים ואת הדיאגרמות כדי לבדוק את ה-Assets, ה-Requirements וזרימות הפעולות.

דוגמה מעובדת: הדגמת Hybrid Car כעותק LML

קודם יש ליצור את ההדגמה: בניהול פרויקטים, יש ללחוץ על קובצי פרויקט ▾ → פרויקט הדגמה חדש → Hybrid Car (SysML v2).

  1. בניהול פרויקטים, יש ללחוץ על ⋯ ב-Hybrid Car (SysML v2 demo) ולבחור יצירת עותק LML…. שם העותק יהיה "Hybrid Car (SysML v2 demo) (LML)".
  2. יש לקרוא את הדוח.

    תחת הומר: part usages הופכים ל-Assets, port usages ל-Ports, attributes ל-Characteristics, connection usages ו-interface usages ל-Conduits, requirement usages ו-definitions ל-Requirements, verification usages ל-Test Cases, actions ל-Actions, ו-states ו-transitions למקבילים שלהם ב-LML.

    תחת לא הומר, בין השאר:

    • התמחויות (Specializations): ב-LML אין התמחות; לחלקים מועתקים התכונות של ההגדרות הכלליות שלהם. SportCar :> Car הוא אחד מהם.
    • הגדרות מחדש (Redefinitions): התכונה המגדירה מחדש מחליפה את התכונה שעברה בירושה בכל חלק מועתק. הסוללה של הסדאן מועתקת עם 48 kg.
    • מניות (Enumerations) (DriveMode, FuelKind): ערכי התכונות נשמרים כטקסט.
    • חישובים (Calculations) (PowerToWeight, ElectricRange) ומקרי ניתוח (Analysis cases) (PowerToWeightAnalysis).
    • מחברי קשירה (Binding connectors) (bind output = transmission.output;): ב-LML אין קשירה בין תכונות.
    • ערכי תכונות: נשמרים כטקסט ב-Value של כל Characteristic; יחידות וביטויים אינם מוערכים.
    • תצוגות: הדיאגרמות משורטטות מחדש בעותק LML.
  3. יש ללחוץ על יצירת עותק.

    עותק LML נפתח. fleet.sedan והחלקים שלו הם Assets; הדרישה Sedan Mass (VR-1.1) היא Requirement שה-Asset של הסדאן מספק. גם הסיכונים, ההחלטות והמשימות של ההדגמה מועתקים, מקושרים לאלמנטים המומרים.

כדי לנסות את הכיוון השני, יש ליצור את הדגמת CubeSat EO-1 (פרויקט LML) ולבחור בה יצירת עותק SysML v2….

עצות ושיטות עבודה טובות

  • כדאי לסדר פרויקט LML לפני ההמרה: לחבר כל Conduit לשני Assets או Ports בדיוק, לצרף כל Characteristic ל-Asset או ל-Equation, ולהסיר Test Suites ריקים. אחרת הם מדווחים כלא מומרים.
  • ב-LML, כדי שתוויות של ענפי OR יהפכו ל-guards, יש לכתוב אותן כביטויים בוליאניים על ערכי המודל (כמו speed > 3). תוויות אחרות הופכות להערות doc על ה-successions.
  • ב-SysML v2, יש לתת לשחקנים (actors) טיפוס של הגדרת חלק ולפרמטרי פריט טיפוס של הגדרת פריט. כאלה ללא טיפוס אינם מומרים.
  • כדאי לשמור על המקור. אחרי שינויים גדולים יותר, עדיף להמיר ממנו שוב ולא לערוך את שני הפרויקטים במקביל.

טעויות נפוצות

  • ציפייה שהמקור ישתנה. הוא אינו משתנה. העותק הוא פרויקט נפרד.
  • ציפייה שהדיאגרמות ישמרו על הפריסה שלהן. פריסות אינן מומרות; יש לסדר שוב את התצוגות או הדיאגרמות החדשות.
  • חלקים חסרים בעותק LML. להגדרת חלק שאף חלק אינו משתמש בה אין Asset ב-LML, כי ב-LML יש מופעים בלבד. יש להשתמש בהגדרה בחלק, ואז להמיר שוב.
  • פריט "does not resolve" בדוח. שם בטקסט SysML v2 אינו מצביע לשום מקום. יש לתקן את השם בעורך, ואז להמיר שוב.

מדריך הדוח

מ-LML ל-SysML v2

הפריטים המומרים כוללים Assets (הגדרות חלקים עם ה-part usages שלהן), Characteristics (attributes), Ports, Conduits (connections או interfaces), Input/Outputs (הגדרות פריטים), Requirements, Actions ו-use cases, זרימות פריטים בין פעולות, States, Transitions, Equations (הגדרות אילוצים), Performs, חבילות בדיקות, Test Cases, Verifies, Satisfies, ופריטי Holarch (מועתקים עם הקישורים שלהם): artifacts, statements, משימות, סיכונים, פריטי לוח זמנים, עלויות, סוגיות, החלטות, סיכוני בטיחות ואופני כשל. תהליכי עבודה של מחלקות (שינויי הסכמה של הפרויקט) עוברים עם המצבים, המעברים והמאשרים המותאמים אישית שלהם, כך שדרישות ומקרי בדיקה שומרים על ערכי ה-Status המותאמים אישית שלהם. העותק שומר על המתגים תוכנית רשמית ובטיחות ואמינות של הפרויקט.

לא הומרסיבה
Assets בלולאת פירוקל-Asset שמכיל את עצמו אין מקום בעץ חלקים. הגדרת החלק שלו מומרת; היא אינה משמשת כחלק.
Conduits ללא שני קצוות בדיוקחיבור SysML מחבר שני קצוות. יש לחבר את ה-Conduit לשני Assets או Ports, ואז להמיר שוב.
פריטים שה-Conduit מעבירחיבורים בהמרה הזו אינם נושאים פריטים. הפריטים מומרים כהגדרות פריטים וכזרימות בין פעולות.
Conduits שמפורקים ל-Conduits אחריםחיבורי SysML אינם מקוננים כאן; כל Conduit הופך לחיבור משלו.
ספירות לולאה וסקריפטים של לולאהלולאת SysML כאן חוזרת עד לתנאי; הספירה נשמרת כנתוני Holarch ומשוחזרת על ידי יצירת עותק LML.
תוויות ענפי החלטה והסתברויותכשכל תווית של החלטה היא ביטוי בוליאני על ערכי המודל, התוויות הופכות ל-guards שלה; אחרת הן הופכות להערות doc על ה-successions. ההסתברויות נשמרות כנתוני Holarch עבור הסימולטור, ושניהם משוחזרים על ידי יצירת עותק LML.
פריטי OR, SYNC ו-LOOPהמבנים מומרים כצומתי decide/merge, fork/join ולולאה; הפריטים שנתנו להם שם אינם נשמרים.
פעולות entry, do ו-exit של מצביםהפעולות מומרות כפעולות; גופי מצבים של SysML אינם מתמלאים בהמרה הזו.
Transitions ללא שני מצבים של אותה מכונהtransition של SysML מחבר שני מצבים של אותה הגדרת מצב.
Guards ו-triggers של מעבריםהם נכתבים ב-LML כטקסט חופשי; הם נשמרים כנתוני Holarch, לא כביטויי SysML, ומשוחזרים על ידי יצירת עותק LML.
מצבים שאינם מוגדרים על ידי Assetמצב זקוק ל-Asset שאת ההתנהגות שלו הוא מתאר.
ביטויי Equationהביטויים משתמשים בשמות שאינם תכונות SysML; כל אחד נשמר כהערה בהגדרת האילוץ שלו.
חבילות בדיקות ללא מקרי בדיקהחבילת בדיקות הופכת לחבילה של מקרי האימות שלה; לחבילה ריקה אין מה להכיל.
מקרי בדיקה שמאמתים משהו שאינו דרישהverification case של SysML מאמת דרישות בלבד.
מחזורי בדיקההרצות בדיקה שנרשמו על חבילת בדיקות אינן חלק מהמודל; התוצאה האחרונה של כל מקרה נשמרת.
דרישות שמסופקות על ידי סוגים אחרים של פריטיםלדוגמה, ב-SysML דרישה אינה מספקת דרישה אחרת; יש להשתמש בגזירה בטקסט.
קשרים אחריםלהמרה הזו אין קשר SysML עבורם; הדוח מציין כל אחד מהם.
Measuresלמדדי יעילות אין אלמנט SysML בהמרה הזו.
Resourcesכמויות משאבים (consumes, produces) שייכות לסימולטור של LML ואין להן אלמנט SysML כאן.
Characteristics שאינם מצורפים ל-Asset או ל-Equationתכונה זקוקה לבעלים: יש להגדיר אותה על ידי Asset או להפוך אותה למשתנה של Equation.
פריטים של מחלקות אחרותלמחלקה הזו אין אלמנט SysML או מקום של Holarch בפרויקט SysML v2.
תכונות (Features) ותצורותעדיין לא: התכונות והתצורות של קו מוצרים אינן הופכות לנקודות שונות, גרסאות מוצר ותצורות של SysML v2. הדוח מפרט אותן כפריטי Feature וכפריטי Configuration; יש למדל שוב את גרסאות המוצר בעותק (ראו גרסאות מוצר ותצורות ב-SysML v2).
קווי בסיסקווי הבסיס של פרויקט LML אינם חלים על המודל החדש; העותק מתחיל ללא קווי בסיס.
היסטוריההיסטוריית השינויים מתחילה מחדש בעותק.
בקשות שינויבקשות שינוי של LML מציעות שינויים לפריטי LML, שאינם קיימים בעותק.
פריסות דיאגרמההדיאגרמות משורטטות מחדש כתצוגות SysML v2; המיקומים אינם מועברים.
פריטים מומרים בתוכני עניינים של מסמכיםהמסמכים מועתקים; הדרישות ופריטי המודל האחרים בתוכני העניינים שלהם הם כעת אלמנטים של SysML ומופיעים במודל, לא בתוכן העניינים.

מ-SysML v2 ל-LML

כל part usage הופך ל-Asset, עם החלקים, ה-ports והתכונות של ההגדרה שלו (ושל ההגדרות שהיא מתמחה מהן) מועתקים אליו. הגדרות מחדש מחליפות את מה שהן מגדירות מחדש. Connections ו-interfaces הופכים ל-Conduits בין ה-Assets האלה. דרישות, verification cases, satisfy, verify, perform, פרמטרי פריט, מצבים ומעברים ממופים חזרה כמו בטבלה שלמעלה. Successions הופכים לזרימות פעולה; ה-guards של החלטה (או הערות ה-doc של ה-successions שלה) הופכים לתוויות ענפי OR, עם ההסתברויות שלהם. שינויי הסכמה של הפרויקט עוברים, כולל תהליכי עבודה של מחלקות עם המצבים, המעברים והמאשרים המותאמים אישית שלהם, כך שדרישות ומקרי בדיקה שומרים על ערכי ה-Status המותאמים אישית שלהם.

לא הומרסיבה
חיבורים עם קצוות שאינם נפתריםיש לתקן את שמות הקצוות בטקסט, ואז להמיר שוב.
חיבורים בתוך הגדרות שאף חלק אינו משתמש בהןכל חיבור הופך ל-Conduit בין החלקים של כל חלק שיש לו אותו; אף אחד אינו משתמש בהגדרה הזו.
מחברי קשירה (Binding connectors)ב-LML אין קשירה (שוויון) בין תכונות.
קשרי verify שאינם נפתריםיש לתקן את שם הדרישה ב-verification objective, ואז להמיר שוב.
פרמטרי פריט ללא הגדרת פריטיש לתת לפרמטר טיפוס item def כדי להמיר אותו.
שחקנים (actors) ללא הגדרת חלק במודליש לתת לשחקן טיפוס part def כדי להמיר אותו.
שימושי perform שאינם נפתרים לפעולה ולחלקיש לבצע perform לפעולה מהגדרת חלק או משימוש בחלק, ואז להמיר שוב.
קשרי satisfy שאינם נפתריםיש לתקן את השמות בהצהרת ה-satisfy, ואז להמיר שוב.
Successions שאינם זרימה מובניתזרימות פעולה של LML הן רצפים עם בלוקים מקבילים, בלוקי החלטה ובלוקי לולאה; גרפי succession אחרים הופכים ללינאריים.
הגדרות מצב שאף חלק אינו מציג (exhibits)המצבים מומרים ללא ה-Asset שאת ההתנהגות שלו הם מתארים.
מעברים שאינם נפתרים לשני מצביםיש לתקן את שמות המצבים, ואז להמיר שוב.
Triggers של מעברים (accept)מעברי LML שומרים את ה-trigger כטקסט חופשי בלבד; האות המתקבל אינו מקושר.
הגדרות port, interface ו-connectionהן מומרות כ-Ports וכ-Conduits במקומות שבהם חלקים משתמשים בהן; ב-LML אין טיפוסי port, interface או connection.
הגדרות תכונה (value types)ל-Characteristics של LML אין טיפוסים.
מניות וערכי מניהב-LML אין מניות; ערכי התכונות נשמרים כטקסט.
Calculations, analysis cases, concernsב-LML אין calculations, analysis cases או concerns של בעלי עניין.
Views ו-viewpointsהדיאגרמות משורטטות מחדש בעותק LML.
פעולות assignment, if, send ו-acceptלפעולות LML אין statements.
תלויותב-LML אין תלות כללית.
הקצאות (Allocations)לפעולות שחלקים מבצעים, יש להשתמש ב-perform בטקסט.
מטא-נתוניםב-LML אין מטא-נתונים.
Occurrencesב-LML אין occurrences.
Use cases כלוליםקשרי include בין use cases אינם מומרים.
כינויים (Aliases)לכל ישות LML יש שם אחד.
Reference usages (פרמטרים של calculations ו-cases)ב-LML אין פרמטרים מלבד משתני Equation.
התמחויות (Specializations)ב-LML אין התמחות; לחלקים מועתקים התכונות של ההגדרות הכלליות שלהם.
הגדרות מחדש (Redefinitions)התכונה המגדירה מחדש מחליפה את התכונה שעברה בירושה בכל חלק מועתק.
Subsettingsב-LML אין subsetting.
ייבואב-LML אין מרחבי שמות; כל ישות גלויה בפרויקט.
הגדרות בהבחנה משימושיםב-LML יש מופעים בלבד: הגדרת חלק הופכת ל-Assets של החלקים שמשתמשים בה, והטקסט שלה נכנס לתיאורים שלהם.
ריבויים (Multiplicities) שאינם של חלקיםרק לריבויים של חלקים יש מקום ב-LML (ה-Multiplicity של decomposed by).
ערכי מאפייניםהערכים נשמרים כטקסט ב-Value של כל Characteristic; יחידות וביטויים אינם מוערכים.
קווי בסיסקווי הבסיס של פרויקט SysML v2 אינם חלים על עותק LML; הוא מתחיל ללא קווי בסיס.
היסטוריההיסטוריית השינויים מתחילה מחדש בעותק.
בקשות שינויבקשות שינוי של SysML מציעות שינויי טקסט שאינם חלים על ישויות LML.

קובץ CSV של הדוח

הורדת הדוח (CSV) כותב שורה אחת לכל סוג פריט שהומר ושורה אחת לכל פריט שלא הומר. העמודות שלו הן תוצאה (הומר או לא הומר), מה, ספירה, הופך ל או סיבה, מספר ו-שם.

הודעות

הודעהמשמעות ותיקון
בודק את ההמרה… (סרגל התקדמות)הדוח בהכנה.
זה כבר פרויקט SysML v2. יש לבחור במקום זאת יצירת עותק LML….נבחר הכיוון הלא נכון.
זה כבר פרויקט LML. יש לבחור במקום זאת יצירת עותק SysML v2….נבחר הכיוון הלא נכון.
בטקסט המומר יש N בעיות. העותק מציג אותן בעורך שלו.אפשר ליצור את העותק; יש לתקן את הבעיות בעורך שלו.
הטקסט המומר אינו מנותח (…). הפרויקט לא הועתק; יש לדווח על כך עם קובץ הפרויקט.ההמרה נכשלה. יש לפנות לתמיכה עם קובץ הפרויקט.
בודק SysML לא התחיל. יש לטעון מחדש את הדף ולנסות שוב.יש לטעון מחדש ולנסות שוב.
לא ניתן היה לקרוא את הפרויקט. יש לטעון מחדש את הדף ולנסות שוב.יש לטעון מחדש ולנסות שוב.
העותק לא נוצר: … יש לטעון מחדש את הדף ולנסות שוב.יש לטעון מחדש ולנסות שוב.
נוצר "<name>"העותק נוצר ונפתח.

מגבלות

  • פריסות דיאגרמה, היסטוריה, קווי בסיס ובקשות שינוי אינם מומרים.
  • עדיין לא: המרת קו מוצרים של LML (תכונות ותצורות) לגרסאות מוצר של SysML v2.
  • מסמך הדוח מפרט עד 500 פריטים לכל סוג.

SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.