Holarch

SysML v2

מטא-נתוני סימולציה בפרויקטים של SysML v2

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

אופן השימוש ←

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

סקירה כללית

בפרויקט 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, מופיעים בסקירות של הטקסט, ומנוהלים בגרסאות עם שאר המודל. משתמשים בהם בזמן ניתוח תרחיש תפעולי (צירי זמן, חלוקת ענפים, שימוש במשאבים) ולפני בדיקת דרישה מול ניתוח מונטה קרלו.

קביעת משך זמן, הסתברות או מספר חזרות

  1. יש לבחור את השלב, הרצף, ההחלטה, הלולאה או פעולת ה-if בתצוגת זרימת פעולות, בדפדפן או בעורך.
  2. בקטע סימולציה של חלונית המאפיינים, יש להגדיר משך (ערך קבוע או התפלגות), הסתברות (%), איטרציות או הסתברות של then (%).
  3. Holarch כותב את הסימון למודל: משך קובע את הערך של התכונה לממוצע ומוסיף את סימון ההתפלגות (או כותב attribute duration : ISQ::DurationValue כשלשלב אין כזו); הסתברות (%) כותב Probability; איטרציות כותב LoopCount. אפשר לבטל כל שינוי בביטול פעולה אחד, והוא מופיע בטקסט מיד.
  4. ניקוי שדה מסיר את הסימון שלו.

Holarch בודק כל שינוי עם בודק SysML לפני שהוא כותב אותו. שינוי שהיה מוסיף שגיאה אינו נכתב, והודעה מציינת את הבעיה.

כתיבת סימונים בטקסט

  1. יש לפתוח את העורך.
  2. יש להוסיף את הסימון בתוך הגוף של האלמנט, כ-@HolarchSimulation::Kind { field = value; }, או אחריו, כ-metadata HolarchSimulation::Kind about element { … }.
  3. עבור Consumes, Produces ו-Seizes, יש לציין קודם את השלב ואחר כך את המשאב: metadata HolarchSimulation::Consumes about DriveCycle::drive, DrivenCar::powertrain::battery { amount = 1.5; }.

העברת הגדרות ישנות יותר למודל

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

  1. יש ללחוץ על העברת הגדרות הסימולציה למודל….
  2. התצוגה המקדימה מציגה כל הגדרה ואת הסימון שמחליף אותה.
  3. יש ללחוץ על העברה למודל. כל ההגדרות עוברות, וביטול פעולה אחד מחזיר הכול לאחור; הריצות נותנות את אותן תוצאות.

סימולציה של מכונת מצבים

מכונות מצבים רצות עם מנוע SysML.

  1. יש לפתוח את התנהגות → סימולטור ולבחור הגדרת מצב, או חלק שמציג מצבים, כשורש.
  2. אופציונלי: תחת הרצה יחד עם, יש לבחור פעולת תרחיש ששולחת אותות לחלק, כמו TestDrive של ההדגמה.
  3. תחת גירויים, יש ללחוץ על + הוספת גירוי ולהגדיר ב (זמן ויחידה), אות ואל (מכונה, או כל מכונה שמקבלת אותו).
  4. יש ללחוץ על ▶ הפעלה, ⏭ צעד או ⏩ הרצה עד הסוף. מכונת המצבים בזמן הריצה מאיר את המצבים הפעילים ומסמן את המעבר שהופעל; הכרטיסייה מצבים מציגה מצבים לאורך זמן ומעברים שהופעלו.
  5. במונטה קרלו, הכרטיסייה מצבים מציגה זמן במצב וספירות מעברים. בדיקה מול דרישה… מציע כפלטים את הזמן בכל מצב ואת החלק שלו מהריצה.

ב-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%."
  • סימון משך זמן על השלב עצמו: התפלגויות שייכות לתכונת משך הזמן, לא לפעולה.

הקשר לשאר התכונות

סימונים

התפלגויות

יש לשים התפלגות על תכונת משך זמן. שדות מיקום וקנה מידה מקבלים גודל עם יחידה (45 [s], 2 [min]); שדות צורה מקבלים מספר.

סימוןשדותמשמעות
נורמליתmean, sdהתפלגות נורמלית.
משולשתlow, mode, highמשולשת, עם low ≤ mode ≤ high.
אחידהlow, highאחידה בין low ל-high.
Exponentialmeanמעריכית עם הממוצע הנתון.
Gammashape, scaleגמא; הממוצע הוא shape × scale.
LogNormalmedian, sigmaהלוגריתם מתפלג נורמלית סביב הלוגריתם של החציון.
Weibullscale, shapeויבול.
Betaalpha, beta, scaleבטא על 0..1, כפול scale.
Poissonmean, scaleספירה עם הממוצע הנתון, כפול scale.
Binomialtrials, p, scaleהצלחות במספר ניסויים, כפול scale.

משכי זמן שהוגרלו מתחת לאפס מוגרלים מחדש.

קלטים מתואמים

ללא מתאם, כל ערך שמוגרל מהתפלגות בלתי תלוי באחרים. Correlation גורם לשניים מהם לנוע יחד:

metadata HolarchSimulation::Correlation about findCharger::duration, charge::duration { coefficient = 0.6; }
סימוןעלמשמעות
Correlation coefficientabout 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 amountabout step, poolנלקח כשהשלב מתחיל.
Produces amountabout step, poolנוסף כשהשלב מסתיים.
Seizes amountabout 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. בארצות הברית ובמדינות אחרות.