SysML v2
מטא-נתוני סימולציה בפרויקטים של SysML v2
ספריית המטא-נתונים HolarchSimulation: כיצד מודל SysML v2 נושא משכי זמן, הסתברויות הסתעפות, מספרי חזרות של לולאות, משאבים, עלויות והגדרות של מכונות מצבים עבור הסימולטור, וכיצד לכתוב ולהעביר אותם.
סקירה כללית
בפרויקט SysML v2, ההגדרות של הסימולטור הן חלק מהמודל. הן סימוני מטא-נתונים מחבילת הספרייה HolarchSimulation, שכל פרויקט SysML v2 טוען. מודל שמשתמש בהם נשאר SysML v2 תקני: כלים אחרים קוראים את הסימונים כמטא-נתונים רגילים, ורק הסימולטור נותן להם משמעות.
סימון נמצא בתוך האלמנט שהוא מסמן, או מציין את האלמנט הזה עם about:
succession toCruise first shift if speed > 30 then cruise {
@HolarchSimulation::Probability { percent = 70; }
}
metadata HolarchSimulation::Cost about DriveCycle::drive { amount = 0.4; unit = "USD"; label = "Energy"; }
מושגים
ערך נומינלי והתפלגות
משך הזמן של שלב הוא התכונה duration שלו (או תכונה מטיפוס DurationValue או TimeValue). הערך שלה הוא משך הזמן הנומינלי שכלים אחרים והחישוב של Holarch רואים. סימון התפלגות על אותה תכונה גורם לסימולטור להגריל במקום זאת את משך הזמן:
action cruise {
attribute duration : ISQ::DurationValue = 1 [min] {
@HolarchSimulation::Triangular { low = 45 [s]; mode = 1 [min]; high = 2 [min]; }
}
}
אילו הגדרות גוברות
- סימון התפלגות גובר על הערך של התכונה עצמה.
- תנאי שמירה, תנאי
ifאו תנאי לולאה שהמודל יכול לחשב מחליטים בעצמם. Probability או LoopCount משמשים רק כשאי אפשר לחשב (LoopCount תמיד סופר את המעברים). - הגדרות שנקבעו לפני שהגדרות הסימולציה עברו למודל נשמרות כנתוני Holarch לצד המודל. הן עדיין גוברות, כך שהריצות נותנות את אותן תוצאות, עד שמעבירים אותן פנימה (ראו העברת הגדרות ישנות יותר למודל).
שני סימולטורים
דף הסימולטור מציג איזה סימולטור מריץ את המודל, משמאל להגדרות: מנוע SysML (הסימולטור של Holarch Language Engine) או סימולטור JavaScript. שניהם קוראים את אותם סימונים. מכונות מצבים, גירויים, משאבים מ-Resource, Consumes, Produces ו-Seizes, עלויות מ-Cost, ושאר הסימונים תחת סימונים שדורשים את מנוע SysML רצים רק עם מנוע SysML.
איך להשתמש בה
מתי ולמה
כדאי לכתוב הגדרות סימולציה למודל כשהמודל הוא התיעוד של התכן: המספרים עוברים עם קובצי ה-.sysml, מופיעים בסקירות של הטקסט, ומנוהלים בגרסאות עם שאר המודל. משתמשים בהם בזמן ניתוח תרחיש תפעולי (צירי זמן, חלוקת ענפים, שימוש במשאבים) ולפני בדיקת דרישה מול ניתוח מונטה קרלו.
קביעת משך זמן, הסתברות או מספר חזרות
- יש לבחור את השלב, הרצף, ההחלטה, הלולאה או פעולת ה-
ifבתצוגת זרימת פעולות, בדפדפן או בעורך. - בקטע סימולציה של חלונית המאפיינים, יש להגדיר משך (ערך קבוע או התפלגות), הסתברות (%), איטרציות או הסתברות של then (%).
- Holarch כותב את הסימון למודל: משך קובע את הערך של התכונה לממוצע ומוסיף את סימון ההתפלגות (או כותב
attribute duration : ISQ::DurationValueכשלשלב אין כזו); הסתברות (%) כותב Probability; איטרציות כותב LoopCount. אפשר לבטל כל שינוי בביטול פעולה אחד, והוא מופיע בטקסט מיד. - ניקוי שדה מסיר את הסימון שלו.
Holarch בודק כל שינוי עם בודק SysML לפני שהוא כותב אותו. שינוי שהיה מוסיף שגיאה אינו נכתב, והודעה מציינת את הבעיה.
כתיבת סימונים בטקסט
- יש לפתוח את העורך.
- יש להוסיף את הסימון בתוך הגוף של האלמנט, כ-
@HolarchSimulation::Kind { field = value; }, או אחריו, כ-metadata HolarchSimulation::Kind about element { … }. - עבור Consumes, Produces ו-Seizes, יש לציין קודם את השלב ואחר כך את המשאב:
metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.
העברת הגדרות ישנות יותר למודל
פרויקטים שהגדרות הסימולציה שלהם נקבעו לפני שעברו למודל מציגים חלק מהגדרות הסימולציה של הפרויקט הזה הן נתוני Holarch, לא חלק מהמודל. מעל ההגדרות של הסימולטור.
- יש ללחוץ על העברת הגדרות הסימולציה למודל….
- התצוגה המקדימה מציגה כל הגדרה ואת הסימון שמחליף אותה.
- יש ללחוץ על העברה למודל. כל ההגדרות עוברות, וביטול פעולה אחד מחזיר הכול לאחור; הריצות נותנות את אותן תוצאות.
סימולציה של מכונת מצבים
מכונות מצבים רצות עם מנוע SysML.
- יש לפתוח את התנהגות → סימולטור ולבחור הגדרת מצב, או חלק שמציג מצבים, כשורש.
- אופציונלי: תחת הרצה יחד עם, יש לבחור פעולת תרחיש ששולחת אותות לחלק, כמו TestDrive של ההדגמה.
- תחת גירויים, יש ללחוץ על + הוספת גירוי ולהגדיר ב (זמן ויחידה), אות ואל (מכונה, או כל מכונה שמקבלת אותו).
- יש ללחוץ על ▶ הפעלה, ⏭ צעד או ⏩ הרצה עד הסוף. מכונת המצבים בזמן הריצה מאיר את המצבים הפעילים ומסמן את המעבר שהופעל; הכרטיסייה מצבים מציגה מצבים לאורך זמן ומעברים שהופעלו.
- במונטה קרלו, הכרטיסייה מצבים מציגה זמן במצב וספירות מעברים. בדיקה מול דרישה… מציע כפלטים את הזמן בכל מצב ואת החלק שלו מהריצה.
ב-State Transition View, ▶ סימולציה פותח סרגל עם ▶ הפעלה, ⏭ צעד, ⏩ הרצה עד הסוף, איפוס ופתיחה בסימולטור. הריצה משתמשת בגירויים שנשמרו בסימולטור עבור אותה הגדרת מצב.
דוגמה מעשית: הדגמת Hybrid Car
הדגמת Hybrid Car (ניהול פרויקטים → קובצי פרויקט ▾ → פרויקט הדגמה חדש) משתמשת בספרייה:
- DriveCycle: לרצף
toCruiseאחריshiftיש Probability של 70; ענף ה-elseלוקח את 30% הנותרים.cruiseלוקח דקה אחת נומינלית, שמוגרלת מהתפלגות Triangular (45 שניות, דקה אחת, 2 דקות). - DrivenCar: הסוללה של מערכת ההנעה היא Resource של 62 Wh;
driveצורך (Consumes) ממנה 1.5 Wh ויש לו Cost של 0.4 USD לשימוש. - PowertrainStates: למעבר
startElectricיש Probability של 80 לתנאי השמירה שלו;accept when charge < 15עובר להיברידי כשהטעינה יורדת;accept after 30 [min]מסיים את הטעינה. - TestDrive: תרחיש ששולח
StartRequest, ממתין שעה, ואז שולחStopRequestו-PlugInל-demoCar. כדי לראות את מערכת ההנעה מחליפה מצבים, יש להריץ את Demo Car יחד עם Test Drive.
ההדגמה נבדקת עם 0 אבחונים.
עצות ושיטות עבודה טובות
- כדאי לשמור על ערך נומינלי בעל משמעות: לקבוע אותו לתוחלת של ההתפלגות, כמו שחלונית המאפיינים עושה.
- כדאי לתת שמות לרצפים שמסמנים (
succession toCruise first …), כך שקל למצוא את הסימון בטקסט. - עדיף להשתמש בתנאים שהמודל יכול לחשב מאשר בהסתברויות; Probability משמש למה שהמודל אינו מתאר.
טעויות נפוצות
- להסתברות אין השפעה: אפשר לחשב את תנאי השמירה, ולכן הוא מחליט. חלונית המאפיינים מציגה "מחושב כ-true: נלקח תמיד." או "מחושב כ-false: לא נלקח אף פעם."
- הסתברויות ההסתעפות אינן מסתכמות ב-100%: ענפים ללא Probability חולקים את מה שנותר; כשההסתברויות שניתנו חורגות מ-100%, האזהרה היא "הסתברויות ההסתעפות מסתכמות ב-N%. יש לשנות אותן כך שיסתכמו ב-100%."
- סימון משך זמן על השלב עצמו: התפלגויות שייכות לתכונת משך הזמן, לא לפעולה.
הקשר לשאר התכונות
- הערכה, יחידות וניתוח בפרויקטים של SysML v2: כיצד הסימולטור קורא שלבים, רצפים ומשכי זמן.
- סימולציה: דף הסימולטור, הלוחות שלו והסטטיסטיקה של מונטה קרלו.
- הסימון הטקסטואלי של SysML v2: מטא-נתונים ו-
aboutבטקסט.
סימונים
התפלגויות
יש לשים התפלגות על תכונת משך זמן. שדות מיקום וקנה מידה מקבלים גודל עם יחידה (45 [s], 2 [min]); שדות צורה מקבלים מספר.
| סימון | שדות | משמעות |
|---|---|---|
| נורמלית | mean, sd | התפלגות נורמלית. |
| משולשת | low, mode, high | משולשת, עם low ≤ mode ≤ high. |
| אחידה | low, high | אחידה בין low ל-high. |
| Exponential | mean | מעריכית עם הממוצע הנתון. |
| Gamma | shape, scale | גמא; הממוצע הוא shape × scale. |
| LogNormal | median, sigma | הלוגריתם מתפלג נורמלית סביב הלוגריתם של החציון. |
| Weibull | scale, shape | ויבול. |
| Beta | alpha, beta, scale | בטא על 0..1, כפול scale. |
| Poisson | mean, scale | ספירה עם הממוצע הנתון, כפול scale. |
| Binomial | trials, p, scale | הצלחות במספר ניסויים, כפול scale. |
משכי זמן שהוגרלו מתחת לאפס מוגרלים מחדש.
קלטים מתואמים
ללא מתאם, כל ערך שמוגרל מהתפלגות בלתי תלוי באחרים. Correlation גורם לשניים מהם לנוע יחד:
metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
| סימון | על | משמעות |
|---|---|---|
Correlation coefficient | about a, b: שתי תכונות, לכל אחת התפלגות | מתאם הדירוג (Spearman) של הערכים שלהן, מ--1 עד 1. 0 הוא אי-תלות, 1 מדרג אותן תמיד באותו סדר, ו--1 בסדר הפוך. |
- כל תכונה שומרת על ההתפלגות שלה. הסימולטור מאחד את כל הזוגות למטריצת מתאם אחת (קופולה גאוסית): הערך ה-n שמוגרל לתכונה בריצה הולך עם הערך ה-n של כל תכונה שהיא מתואמת איתה.
- המקדמים של קבוצת תכונות מתואמות חייבים להתאים זה לזה: a במתאם חזק עם b, b במתאם חזק עם c, אבל a הפוך ל-c הוא בלתי אפשרי. הבדיקה מדווחת על קבוצה כזו; יש להחליש אחד מהמקדמים.
- משכי זמן וכמויות (Consumes, Produces, Seizes) מתואמים באותו אופן. ריצה עם אותו זרע נותנת את אותם ערכים.
- בסימולטור, במצב מונטה קרלו עם מנוע SysML, קלטים מתואמים מציג את הזוגות של השורש. יש לבחור שתי תכונות ומקדם וללחוץ על + הוספת מתאם, לשנות מקדם, או ללחוץ על × כדי להסיר אחד; ביטול פעולה אחד מבטל כל שינוי. אחרי ניתוח, הושג מציג את מתאם הדירוג של הערכים שהריצות הגרילו.
- ה-
ChargeStopשל הדגמת Hybrid Car מתאם בין ההמתנה למטען פנוי לבין זמן הטעינה (0.6).
סיכויים וספירות
| סימון | על | משמעות |
|---|---|---|
Probability percent | רצף שיוצא מהחלטה | המשקל של הענף. ענפים בלעדיו חולקים את מה שנותר מ-100. |
פעולת if | הסיכוי של ענף ה-then כשאי אפשר לחשב את התנאי. | |
| פעולת לולאה | הסיכוי לחזור אחרי כל מעבר. | |
| מעבר | הסיכוי שתנאי השמירה שלו מתקיים כשאי אפשר לחשב את תנאי השמירה. | |
LoopCount count | פעולת לולאה | מספר המעברים; הוא גובר על התנאים של הלולאה. |
| LoopExit | רצף ל-done בגוף לולאה | מסיים את כל הלולאה, לא רק את המעבר. |
משאבים ועלויות
| סימון | על | משמעות |
|---|---|---|
Resource initial, minimum, maximum, unit | שימוש חלק או פריט | מאגר של כמות. אם השימוש מצהיר על attribute level : Real, הסימולטור שומר אותה שווה לכמות, כך שתנאי שמירה יכולים לקרוא אותה. |
Consumes amount | about step, pool | נלקח כשהשלב מתחיל. |
Produces amount | about step, pool | נוסף כשהשלב מסתיים. |
Seizes amount | about step, pool | נלקח כשהשלב מתחיל ומוחזר כשהוא מסתיים. |
Utilization amount | שימוש פעולת perform | כמה מהחלק המבצע השלב תופס. |
Cost amount, rate, unit, label | שלב או חלק מבצע | עלות לשימוש (CostRate::perUse) או לשעה (CostRate::perHour). |
סימונים שדורשים את מנוע SysML
| סימון | משמעות |
|---|---|
Transfer latency, capacity, per | על חיבור או ממשק: מעכב פריטים ואותות שנשלחים דרכו. |
Size size | על פריט: הגודל שלו לעיכובי העברה. |
Timeout limit | על איחוד: עוצר ענפים שלא הסתיימו כשהמגבלה פגה. |
NotBefore time | על שלב: הוא אינו מתחיל לפני זמן הריצה הזה. |
| ForkTargets, JoinSources | על מעבר אל מצב מקבילי או ממנו: תת-המצבים שנכנסים אליהם, או תת-המצבים שחייבים להיות פעילים. |
History deep | על מצב מורכב: כניסה חוזרת ממשיכה מתת-המצב שהיה פעיל ביציאה ממנו. |
HostHook key, points | שמור ל-Holarch: הריצה נעצרת לקלט בנקודות שברשימה. |
סימולטור JavaScript קורא את Probability, LoopCount ואת ההתפלגויות.
הודעות
| הודעה | משמעות |
|---|---|
| חלק מהגדרות הסימולציה של הפרויקט הזה הן נתוני Holarch, לא חלק מהמודל. | הגדרות ישנות יותר עדיין נשמרות לצד המודל. יש ללחוץ על העברת הגדרות הסימולציה למודל…. |
| נתוני Holarch מלפני שהגדרות הסימולציה עברו למודל; הם גוברים על המודל. | מוצג בקטע סימולציה של חלונית המאפיינים. שינוי השדה כותב אותו למודל; אפשר גם להעביר את כל ההגדרות בסימולטור. |
| אין משך זמן במודל. אפשר לקבוע אותו כאן (נכתב attribute duration : ISQ::DurationValue), או לכתוב אותו בטקסט. | לשלב אין תכונת משך זמן. |
| @Normal: sd must be greater than zero. Change sd. (sd חייב להיות גדול מאפס; וכך גם עבור התפלגויות ופרמטרים אחרים) | פרמטר של התפלגות חסר או מחוץ לטווח. עם מנוע SysML, בדיקת המודל מדווחת עליו בעורך והסימולטור מסרב לרוץ עד שהוא מתוקן. |
| @Normal: sd has another unit dimension than … (ל-sd יש ממד יחידות שונה) | לפרמטר מיקום או קנה מידה יש יחידות שונות משל התכונה, למשל מטרים על משך זמן. |
| @LoopCount does not apply to a part … (אינו חל על חלק) | הסימון נמצא על סוג אלמנט שהוא אינו חל עליו. יש להעביר או למחוק אותו. |
| metadata Consumes … about needs an action and a part or item annotated @Resource. (דורש פעולה וחלק או פריט מסומן) | האלמנטים אחרי about שגויים במספר או בסוג. |
| A probability of N % is outside 0 to 100. (הסתברות מחוץ לטווח 0 עד 100) | יש להזין אחוז מ-0 עד 100. |
| The branch probabilities of this decision add up to N %; the simulator scales them to 100 %. (הסימולטור מנרמל אותן ל-100%) | אזהרה: לכל ענף יש משקל והם אינם מסתכמים ב-100. |
| A correlation needs two different attributes …, … is not an attribute … או … has no distribution, so nothing is drawn to correlate … | Correlation מציין תכונה אחת פעמיים, משהו שאינו תכונה, או תכונה ללא התפלגות. |
| The coefficient N is outside -1 to 1. או The correlation has no coefficient. | יש להזין מקדם מ--1 עד 1. |
| “a” and “b” are already correlated; the first correlation is used. … (המתאם הראשון בשימוש) | אזהרה: Correlation שני של אותו זוג מתעלמים ממנו. יש להסיר אחד מהשניים. |
| The correlations of … contradict each other: no joint distribution has them … (המתאמים סותרים זה את זה) | המקדמים של קבוצה אינם יכולים להתקיים יחד (המטריצה אינה חיובית למחצה). יש להחליש אחד מהם. הסימולטור מסרב לרוץ עד שהבעיה מתוקנת. |
| קיפאון ב-<time>: N שלבים ממתינים למשהו שלעולם אינו מגיע. | מוצג מעל התוצאות עם מנוע SysML, עם כל שלב שממתין. accept ללא שולח, פריט שלעולם אינו מיוצר או משאב שלעולם אינו משוחרר עוצרים את הריצה. |
מגבלות
- משכי זמן נכתבים בשניות, דקות, שעות או ימים (
SI::s,SI::min,SI::h,SI::d). אלפיות שנייה נכתבות כשניות; שבועות, חודשים ושנים כימים. - מכונות מצבים, גירויים והרצה יחד עם דורשים את מנוע SysML.
- קלטים מתואמים דורשים את מנוע SysML; סימולטור JavaScript מגריל כל ערך באופן בלתי תלוי. אפשר לתאם לכל היותר 200 תכונות בקבוצה אחת.
- הבדיקה של מקדמים סותרים מכסה את המתאמים שנכתבו במרחב שמות אחד; הסימולטור בודק את כל המתאמים של הריצה.
קשור
SysML® ו-OMG® הם סימנים מסחריים רשומים של Object Management Group, Inc. בארצות הברית ובמדינות אחרות.