SysML v2
מדריכי SysML v2
תשעה מדריכים מודרכים לפרויקטים של SysML v2, מהחבילה הראשונה ועד יציאות, פעולות, מצבים, דרישות, אימות, אילוצים וגרסאות מוצר, עם חלונית שלבים שבודקת את העבודה.
בדף זה
ב-Holarch יש מסלול של מדריכים מודרכים לפרויקטים של SysML v2. כל אחד יוצר פרויקט SysML v2 התחלתי קטן ופותח חלונית שלבים לצד הדף. החלונית בודקת את המודל תוך כדי עבודה: שלב הופך לירוק כשבמודל יש את מה שהשלב מבקש. הדף הזה מציג כל שלב כטקסט, כך שאפשר לעקוב גם כאן.
המדריך הראשון משתמש בתחנת מזג האוויר WS-1, כמו המדריכים של LML. האחרים בונים חלקים של מכונית היברידית, המודל של הדגמת Hybrid Car: טיפוסי ערכים ורכיבים, היציאות והממשקים של מערכת ההנעה, מחזור נסיעה, המצבים של מערכת ההנעה, הדרישות של המכונית, האימות שלהן, הבדיקות על הערכים של הסדאן וקו המוצרים. לכל מדריך יש פרויקט התחלתי משלו, כך שאפשר לעבור עליהם בכל סדר. כל פרויקט התחלתי וכל מדריך שהושלם נבדקים עם 0 בעיות.
| מדריך | זמן | מה לומדים |
|---|---|---|
| צעדים ראשונים | 15 דקות | כתיבת טקסט SysML v2, הצגתו כעץ וכתצוגה, שרטוט בתצוגה והוספת דרישה |
| הגדרות ומאפיינים | 20 דקות | כתיבת מניות, טיפוסי ערכים והגדרות מופשטות, התמחות עם ערכים ויחידות, ושימוש בהשלמה, בהוספה ובשינוי שם |
| פתחות וממשקים | 20 דקות | הגדרת יציאות וממשקים, היפוך יציאות, חיבור חלקים ושרטוט ממשק ב-Interconnection View |
| פעולות וזרימות | 20 דקות | כתיבת הגדרות פעולה ומחזור נסיעה עם פיצול, זרימות ואיחוד, הוספת מסלולי שחייה ובניית שלבים ב-FFBD |
| מצבים ומעברים | 20 דקות | כתיבת אותות ומכונת מצבים עם טריגרים, תנאי שמירה ופעולות מצב, ושרטוט מעבר מתוזמן |
| דרישות | 20 דקות | כתיבת מגבלות, הגדרות ושימושים של דרישות, סיפוק שלהן והצגת דרישה שאינה מתקיימת |
| אימות ועקיבות | 15 דקות | כתיבת מקרה אימות, עקיבה של שלב במטריצת העקיבות וגזירת דרישה |
| אילוצים וחישובים | 20 דקות | כתיבת אילוצים וחישובים, קשירת ערכים בתצוגה פרמטרית, הרצת מקרה ניתוח וסימון ערכי TBD ו-TBR |
| וריאנטים ותצורות | 15 דקות | כתיבת וריאציות וגרסאות מוצר, קו מוצרים עם כלל, תצורות ומילת מפתח משלך |
איך להשתמש בה
התחלת מדריך SysML v2
- יש לפתוח את עזרה → מדריכים בסרגל הניווט, או ללחוץ על ⌘K / Ctrl+K ולהקליד
tutorial. מחוץ לפרויקט, הדף מדריכים מציג קודם את המדריכים של LML ואחריהם את מדריכים לפרויקטים של SysML v2. בתוך פרויקט SysML v2 הוא מציג רק את המדריכים של SysML v2. - יש ללחוץ על התחלה בכרטיס. Holarch יוצר את הפרויקט, למשל Tutorial: SysML v2 Ports and Interfaces (Hybrid Car), ופותח אותו עם חלונית השלבים משמאל.
חלונית השלבים פועלת כמו במדריכים של LML: הדגמה מסמן את הפקד שהשלב צריך, מעבר לשם פותח את הדף, קריאה נוספת פותח את נושא העזרה, ו-התחלה מחדש…, סימון כהושלם ו-× פועלים באותו אופן. ראו מדריכים.
הקלדת הטקסט של שלב
רוב השלבים נותנים טקסט SysML להקלדה ב-מודל → עורך. השלב אומר לאן השורות נכנסות, למשל "לפני הסוגר המסולסל האחרון של החבילה". הטקסט מוחל על המודל כשמפסיקים להקליד; שורת המצב מתחת לעורך מציינת זאת, והשלב הופך לירוק.
- יש להקליד את השורות כפי שהן מוצגות. ההזחה לא משנה למודל; העורך שומר את ההזחה שלך.
- קו תחתון אדום מסמן שגיאה: הצבעה עליו מציגה את ההודעה. טקסט עם שגיאת תחביר נשאר טיוטה ואינו מוחל עד שמתקנים אותו.
- ⌘Z / Ctrl+Z מבטל את השינוי האחרון שהוחל.
טיפים
- בפעם הראשונה מומלץ לעבור על המדריכים לפי הסדר: כל אחד מסביר את הטקסט שבו הוא משתמש, והמאוחרים מניחים את הרעיונות הקודמים (הגדרות ושימושים,
:>ו-:>>). - שלב שנשאר פתוח בדרך כלל מכיל שגיאת הקלדה בשם. יש להשוות את הטקסט שלך לשורות של השלב; ב-SysML v2 שמות רגישים לאותיות רישיות.
- המדריכים מלמדים את אותה שפה כמו יסודות SysML v2; בדף הסימון הטקסטואלי יש את הפרטים.
צעדים ראשונים
כתיבת מודל ראשון של תחנת מזג האוויר: פתיחת הטקסט, הוספת הגדרת חלק עם ערך ויחידה, שימוש בה בהגדרה אחרת, הצגת המודל בדפדפן וב-General View, שרטוט חלק בתצוגה וצפייה בו מופיע בטקסט, הוספת דרישה עם satisfy, וייצוא המודל כקובץ .sysml. השלבים מתוארים ב-תחילת העבודה עם פרויקטים של SysML v2.
הגדרות ומאפיינים
בפרויקט ההתחלתי יש את החבילה Vehicles עם הגדרת חלק אחת, Car.
- פתיחת החבילה. יש ללחוץ על מודל → עורך. כל הצהרה היא מילת מפתח ושם, ואחריהם גוף בסוגריים מסולסלים או נקודה-פסיק.
- כתיבת מנייה. מעל
part def Car {, יש להוסיףenum def DriveMode { enum economy; enum normal; enum sport; }(ערך אחד בכל שורה). - הגדרת טיפוס ערך. מתחת לה, יש להוסיף
attribute def TirePressure :> ScalarValue;.:>פירושו התמחות. - כתיבת הגדרה מופשטת. יש להוסיף
abstract part def Componentעם הערתdocוהתכונותmass : MassValue,partNumber : Stringו-power : PowerValue.//מתחיל הערה שנשארת רק בטקסט. - מתן אפשרות לבודק למצוא טעות. יש להוסיף
part def Battery :> Componentעםattribute redefines mass = 45 [kg];ובכוונה גםattribute redefines power = 60 [kg];. הבודק מסמן בקו תחתון את היחידה: קילוגרמים אינם הספק. - תיקון היחידה. יש לשנות אותה ל-
60 [W]. - השלמת שם. בסוללה, יש להקליד
attribute capacity : Ener, לקבל אתEnergyValueמרשימת ההשלמה עם Enter ולסיים ב-;. - חיפוש בספרייה הסטנדרטית. יש ללחוץ על הגדרות → ספרייה סטנדרטית בתחתית סרגל הניווט ולהקליד
EnergyValueבתיבת החיפוש. - הוספת הגדרה. בעורך, יש ללחוץ על ⌃⇧Space / Ctrl+Shift+Space (או על הוספה ▾) בשורה ריקה, לבחור הגדרת חלק ולהשלים
part def Engine :> Componentעםattribute redefines mass = 110 [kg];ו-attribute cylinders : Integer;. - שימוש בהגדרות. ב-
Car, יש להוסיףattribute mode : DriveMode;,part battery : Battery;ו-part engine : Engine;. - שינוי שם בכל מקום. יש למקם את הסמן על
cylinders, ללחוץ על F2 ולשנות את השם ל-cylinderCount.
פתחות וממשקים
בפרויקט ההתחלתי יש את הרכיבים של מערכת ההנעה עם יציאות המומנט וההספק שלהם, הגדרות היציאה TorquePort ו-PowerPort, והגדרות הממשק Shaft ו-HighVoltageBus.
- הגדרת יציאה. מעל
port def TorquePort, יש להוסיףport def FuelPortעםout attribute flowRate : Real;ו-attribute kind : FuelKind;.outפירושו שהערך יוצא מהחלק שהיציאה שייכת לו. - מתן יציאות לחלקים. יש להוסיף
port fuelOut : FuelPort;ל-FuelTankו-port fuelIn : ~FuelPort;ל-Engine.~הופך את היציאה: כניסה ויציאה מתחלפות. - הגדרת ממשק. יש להוסיף
interface def FuelLine { end supply : FuelPort; end consumer : ~FuelPort; }. - בניית מערכת ההנעה. בסוף החבילה, יש להוסיף
part def Powertrainעם החלקיםtank,engine,motor,batteryו-transmission, יציאהoutput : TorquePortו-bind output = transmission.output;. - חיבור שני חלקים. במערכת ההנעה, יש להוסיף
interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;. - הוספת הצירים. יש להוסיף
interface engineShaft : Shaft connect engine.output to transmission.engineIn;ו-interface motorShaft : Shaft connect motor.output to transmission.motorIn;. - יצירת Interconnection View. יש ללחוץ על ארכיטקטורה → Interconnection Views, ואז על + דיאגרמה חדשה. יש לבחור
Powertrainתחת מציג וללחוץ על יצירה. - שרטוט ממשק. יש לגרור מהידית של היציאה
powerOutשל הסוללה אל היציאהpowerInשל המנוע, ולשחרר על Interface : HighVoltageBus. - מתן שם לממשק. יש לבחור את הקו החדש ולהזין
hvBusכשם שלו בחלונית המאפיינים. - הצגה בטקסט. יש ללחוץ על מודל → עורך: הממשק נמצא במערכת ההנעה, עם השם, הטיפוס והקצוות שלו.
פעולות וזרימות
בפרויקט ההתחלתי יש את החבילה VehicleBehavior עם הפריטים Fuel ו-Torque, הפונקציות ProduceTorque (F.2) ו-DriveWheels (F.3), ושלוש הגדרות חלק.
- הגדרת פונקציה. יש להוסיף
action def <'F.1'> SupplyFuelעםin attribute fuelDemand : Real;ו-out item fuel : Fuel;. השם הקצר בסוגריים הזוויתיים הוא מספר הפונקציה. - כתיבת מחזור הנסיעה. יש להוסיף
action def <'F'> DriveCycleעםfirst start then split;,fork split;,then supply;,then produce;והשלביםaction supply : SupplyFuelו-action produce : ProduceTorque, כל אחד עםduration. - הוספת זרימה. במחזור הנסיעה, יש להוסיף
flow of Fuel from supply.fuel to produce.fuel;. - איחוד הענפים. יש להוסיף
first supply then ready;,first produce then ready;,join ready;,then action drive : DriveWheels { … },then done;ו-flow produce.torque to drive.torque;. - יצירת תצוגת זרימת פעולות. יש ללחוץ על התנהגות → זרימות פעולה, ואז על + דיאגרמה חדשה, ולבחור
DriveCycleתחת מציג. - ציון מי מבצע כל שלב. יש להוסיף
part def DrivenCarעםperform action trip : DriveCycle;והחלקיםtank,engineו-transmission, כל אחד עםperform trip.supply;,perform trip.produce;אוperform trip.drive;. התצוגה מקבלת מסלול שחייה לכל חלק. - פתיחת הניתוח הפונקציונלי. יש ללחוץ על התנהגות → ניתוח פונקציונלי, ללחוץ על בחירה… ולבחור
DriveCycle. - הצהרה על פעולה נוספת. יש להוסיף
action def EmergencyShutdown;. - בניית שלבים ב-FFBD. יש ללחוץ על התנהגות → FFBD, ואז על + דיאגרמה חדשה, ולבחור
EmergencyShutdown. בחלונית הוספה, יש להקלידOpen Contactorsוללחוץ על Enter, ואזCut Fuel. - הצגת השלבים בטקסט. יש ללחוץ על מודל → עורך: ה-FFBD כתב את השלבים ואת הרצפים ביניהם.
מצבים ומעברים
בפרויקט ההתחלתי יש את החבילה PowertrainBehavior עם part def Car ריק.
- הגדרת האותות. יש להוסיף
attribute def StartRequest;, ובאותו אופןStopRequest,PlugInו-Unplug. - כתיבת הגדרת מצב. יש להוסיף
state def PowertrainStatesעםin attribute charge : Real;,entry; then off;והמצביםoff,electricו-hybrid. - הוספת מעברים. אחרי
state off;, יש להוסיףaccept StartRequest if charge > 20 then electric;ו-accept StartRequest then hybrid;. - מתן פעולות למצב. יש להחליף את
state electric;בגוף שמכילentry action spinUpMotor;,do action driveElectric;ו-exit action holdMotor;. - יציאה מהמצב החשמלי. אחריו, יש להוסיף
if charge < 15 then hybrid;ו-accept StopRequest then off;; יש להוסיףaccept StopRequest then off;גם אחריstate hybrid;. - הוספת מצב עם מעברים בעלי שם. יש להוסיף
state charging { do action chargeBattery; },transition plugIn first off accept PlugIn then charging;ו-transition unplugged first charging accept Unplug then off;. - יצירת State Transition View. יש ללחוץ על התנהגות → מכונות מצבים, ואז על + דיאגרמה חדשה, ולבחור
PowertrainStatesתחת מציג. - שרטוט מעבר מתוזמן. יש לגרור מהידית של
chargingאלoffולשחרר על Transition. בחלונית המעבר, יש להזין את השםchargedואת הטריגרafter 30 [min]. - הצגה בטקסט. יש ללחוץ על מודל → עורך: המעבר כתוב כמעבר בעל שם.
- מתן אפשרות למכונית להציג את המצבים. ב-
Car, יש להוסיףexhibit state powertrainStates : PowertrainStates;.
דרישות
בפרויקט ההתחלתי יש את החבילה VehicleRequirements עם עותק קטן של התכן: Battery, Car וה-sedan של הצי, עם מסה עצמית של 1580 ק״ג.
- מתן שמות למגבלות. יש להוסיף
attribute maxCurbMass : MassValue = 1650 [kg];ו-attribute minBatteryCapacity : EnergyValue = 1.2 [kW*h];. - כתיבת הגדרת דרישה. יש להוסיף
requirement def <'VR-1'> CurbMassעם הצהרתdoc,subject car : Car;,attribute limit : MassValue;ו-require constraint { car.curbMass <= limit }. - הוספת דרישה. יש ללחוץ על ⌃⇧Space / Ctrl+Shift+Space בשורה ריקה, לבחור הגדרת דרישה ולכתוב
VR-3 BatteryCapacityעם הנושאbattery : Batteryו-require constraint { battery.capacity >= minBatteryCapacity }. - קינון דרישות במפרט. יש להוסיף
requirement carSpecעםsubject car : Car;ו-requirement <'VR-1.1'> sedanMass : CurbMass { attribute :>> limit = maxCurbMass; }. - ציון מה מספק אותן. יש להוסיף
satisfy carSpec by fleet.sedan;ו-satisfy requirement batterySpec : BatteryCapacity by fleet.sedan.battery;. - הפרת דרישה. יש לשנות את המסה העצמית של הסדאן ל-
1700 [kg]. העורך מסמן את ה-satisfy: הסדאן כבר אינו עומד ב-VR-1.1. - עמידה בה שוב. יש ללחוץ על ⌘Z / Ctrl+Z, או לשנות אותה בחזרה ל-
1580 [kg]. - הצגת טבלת הדרישות. יש ללחוץ על צרכים ודרישות → דרישות.
- יצירת תצוגת דרישות. בדף דיאגרמות, יש ללחוץ על + דיאגרמה חדשה, לבחור תצוגת דרישות ואת
carSpecתחת מציג. - בדיקת ההצהרות. יש ללחוץ על צרכים ודרישות → איכות וללחוץ על בדיקת איכות.
אימות ועקיבות
בפרויקט ההתחלתי יש את דרישת המסה העצמית ואת מפרט המכונית, מחזור נסיעה עם השלבים cruise ו-brake, את VR-6 batteryMassLimit ואת VR-7 stopFromCruise.
- כתיבת מקרה אימות. יש להוסיף
verification def <'VC-1'> CurbMassTestעםsubject car : Car;,objective massObjective { verify carSpec.sedanMass; }ו-return verdict : Boolean = car.curbMass <= maxCurbMass;. - החלה על הסדאן. יש להוסיף
verification <'VC-1.1'> sedanWeighing : CurbMassTest { subject car = fleet.sedan; }. - פתיחת מקרי האימות. יש ללחוץ על אימות → מקרי אימות. שלבים, תוצאות ומצב הם נתוני Holarch שלצד המודל. בשורה של Sedan Weighing, יש ללחוץ על + שלבים, ואז על + הוספת צעד, להקליד
Weigh the carתחת פעולה וללחוץ על החלה. לאחר מכן יש ללחוץ על עבר בלחצני המצב שלו. - קריאת ה-RVTM. יש ללחוץ על אימות → RVTM.
- עקיבה משלב לדרישה. יש ללחוץ על אימות → מטריצת עקיבות, להציג דרישות כשורות ופעולות כעמודות, ללחוץ על התא של
stopFromCruiseו-brake, ולבחור satisfied by. - גזירת דרישה. יש להוסיף
private import RequirementDerivation::*;ו-connection batteryMassDerivation : Derivation connect carSpec.sedanMass to batteryMassLimit;. - הרצת בדיקות המודל. יש ללחוץ על אימות → בדיקות מודל.
אילוצים וחישובים
בפרויקט ההתחלתי יש את החבילה VehicleAnalysis עם המנוע, הסוללה, המכונית והערכים של הסדאן, ואת היעדים maxCurbMass ו-minPowerToWeight.
- כתיבת הגדרת אילוץ. יש להוסיף
constraint def MassLimitעםin mass : MassValue;,in limit : MassValue;והביטויmass <= limit. - כתיבת חישוב. יש להוסיף
calc def PowerToWeightעם הפרמטריםpowerו-massו-return ratio = power / mass;. - קשירת הערכים של הסדאן. יש להוסיף
constraint sedanMassCheck : MassLimit { in mass = fleet.sedan.curbMass; in limit = maxCurbMass; }. - יצירת תצוגה פרמטרית. בדף דיאגרמות, יש ללחוץ על + דיאגרמה חדשה, לבחור תצוגה פרמטרית ואת
VehicleAnalysisתחת מציג. הבדיקה עוברת: 1580 ק״ג נמצא בתוך 1650 ק״ג. - גרימה לכישלון הבדיקה. יש לשנות את המסה העצמית של הסדאן ל-
1700 [kg]; התצוגה מראה שהבדיקה נכשלת. - החזרת הבדיקה למעבר. יש לבטל את הפעולה, או לשנות את המסה בחזרה ל-
1580 [kg]. פתרון הכול בודק שוב כל אילוץ. - הרצת מקרה ניתוח. יש להוסיף
analysis def PowerToWeightAnalysisעם מטרה שדורשתratio >= minPowerToWeight, ו-analysis sedanPowerToWeight : PowerToWeightAnalysis { subject car = fleet.sedan; }. - סימון ערכים פתוחים. יש להוסיף
private import HolarchMetadata::*;ואת הדרישה VR-5ChargeTimeעם#TBRעל מגבלת הזמן שלה ו-@TBDעם בעלים, תאריך יעד ונימוק על הספק המטען.TBDו-TBRמגיעים מהספרייהHolarchMetadataשל Holarch, לא מהספרייה הסטנדרטית של SysML v2; הם מתמחים במטא-נתונים הסטנדרטייםStatusInfo. - פתיחת מרשם TBD/TBR. יש ללחוץ על צרכים ודרישות → TBD/TBR. זמן הטעינה מופיע עם הבעלים ותאריך היעד מהמטא-נתונים
@TBDשלו. המרשם הוא לקריאה בלבד: את הבעלים או את התאריך משנים במטא-נתונים בעורך. - סיכום המסה. יש ללחוץ על ארכיטקטורה → תקציבים ו-TPMs ולבחור את חלק השורש
sedan.
וריאנטים ותצורות
בפרויקט ההתחלתי יש את Component, Battery, Controller, Car ו-Powertrain.
- ייבוא חבילת השונות. יש להוסיף
private import HolarchVariability::*;. - כתיבת וריאציה. בשורה ריקה, יש ללחוץ על ⌃⇧Space / Ctrl+Shift+Space (או על הוספה ▾), לבחור שונות ולהשלים
variation part def BatteryPack :> Batteryעם הגרסאותstandardPack(1.4 קוט״ש) ו-largePack(12 קוט״ש, 120 ק״ג). - כתיבת קו המוצרים. יש להוסיף
part def CarLine :> Carעםpart pack : BatteryPack;,variation part chargerעם הגרסאותnoChargerו-wallbox, ו-assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }. - התחלת תצורה. יש לבחור הוספה ▾ → תצורה ולמלא
part plugInHybrid : CarLine { @HolarchConfiguration; }. העורך מציין את נקודות השונות שעדיין פתוחות. - בחירת הגרסאות. ב-
plugInHybrid, יש לבחור הוספה ▾ → בחירת גרסה לכל נקודה ולמלאpart :>> pack = BatteryPack::largePack;ו-part :>> charger = charger::wallbox;. - הוספת תצורה שנייה. יש להוסיף את
selfChargingHybridבאותו אופן, עם המארז הסטנדרטי וללא מטען. - הגדרת מילת מפתח משלך. יש להוסיף
metadata def <safetyCritical> SafetyCritical. - שימוש במילת המפתח. ב-
Powertrain, יש לכתוב#safetyCritical part controller : Controller;. - הצגת קו המוצרים. יש ליצור General View של
Vehicles: מארז הסוללה מסומן כ-variation.
פרויקטי מדריך
פרויקטי מדריך של SysML v2 פועלים לפי אותם כללים כמו פרויקטי המדריך האחרים: הם אינם נספרים בפרויקטים הפעילים של התוכנית, מכילים עד 300 פריטים, ואפשר להחזיק אחד לכל מדריך. ראו מדריכים.
קשור
- מדריכים
- תחילת העבודה עם פרויקטים של SysML v2
- עורך הטקסט והדפדפן
- סימון טקסטואלי
- תצוגות
- דרישות בפרויקטים של SysML v2
SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.