Holarch

חבילת המרצה · v1.0

הוראה עם Holarch: חבילת המרצה

תוצרי למידה לקורס ושש מטלות עם מחוונים לקורס סמסטריאלי בהנדסת מערכות או MBSE, כולן מבוססות על EO-1 Open MBSE Reference Model v1.1, לוויין CubeSat בדיוני בגודל 6U לתצפית על כדור הארץ. חינם לפי CC BY 4.0.

הורדת חבילת המרצה v1.0

כל הקבצים (.zip, 17 KB)

קובצי Markdown שנפתחים בכל עורך. משתמשים ב-EO-1 Reference Model v1.1. רישיון: CC BY 4.0, קרדיט “Holarch”.

בדף זה
  1. מה היא מכילה
  2. איך להשתמש בה
  3. הערות פתרון
  4. תוצרי למידה
    1. מיפוי למטלות
  5. A1 · מעקב אחר צורך
  6. A2 · עיבוד מחדש וסקירה של דרישות
  7. A3 · איתור פערי הכיסוי
  8. A4 · הרחבת הארכיטקטורה
  9. A5 · טיפול בשינוי
  10. A6 · תוכנית תיקוף
  11. הוראת SysML v2 עם Holarch: מה הוא בודק ומה הוא רק שומר
  12. הורדות
  13. גרסאות
  14. איך לצטט
  15. רישיון

מה היא מכילה

קובץמיועד למה היא מכילה
learning-outcomes.mdמרצים, תיעוד הסמכהתוצרי הלמידה של הקורס, המטלות שמעריכות כל אחד, ותכונות Holarch שבשימוש.
assignments/A1-trace-a-need.md עד A6-validation-plan.mdסטודנטים (לחלוקה)שש מטלות על EO-1, לכל אחת רקע, משימה, מה להגיש ומחוון.
sysml-v2-teaching-boundaries.mdמרציםמה פרויקטי SysML v2 של Holarch בודקים, מה הם שומרים בלי לפרש, ומה עדיין לא זמין.

איך להשתמש בה

  1. יש לתת לכל קבוצה עותק משלה של EO-1 v1.1. ב-Holarch: Manage Projects ← Project Files ▾ ← New Demo Project ← CubeSat EO-1, או להוריד את eo-1-v1.1.holarch.json מ-holarch.app/reference-models/eo-1/ ולייבא אותו באמצעות Manage Projects ← Project Files ▾ ← Import Project…. כל מטלה מתחילה מהמודל כפי שהוא מסופק.
  2. את הקורס מנהלים בארגון כיתה. כל מטלה מוסיפים עם מועד ההגשה שלה תחת Organization Settings ← Class Review ← + New Assignment. Class Review שומר גרסה של כל פרויקט קבוצתי בכל מועד הגשה ומציג את העבודה של כל סטודנט.
  3. עבור A2 מצטרפים לכל פרויקט קבוצתי כ-מבקר: אפשר להגיב, לאשר, לדחות ולפתוח מחדש דרישות, ולא יותר.
  4. עבור A6, הסטודנטים מתחילים מהתבנית המובנית Verification and Validation Plan. כדי לתת להם גרסה מקוצרת עם הוראות משלך, יש לשמור אחת כתבנית ארגון (Write ▾ ← Templates ▸ Save as Template…, Save to: Organization) ולהגדיר אותה כברירת המחדל ל-Test Plan Document.
  5. יש לקבוע את המשקלים, גודלי הקבוצות ומועדי ההגשה לקורס שלך. המשקלים המופיעים הם הצעות.

המטלות מציינות דפים של Holarch, אבל על כל שאלה אפשר לענות גם מקובצי ה-CSV של EO-1, כך שגם סטודנטים שעובדים בכלי אחר יכולים להשתתף.

הערות פתרון

הערות פתרון עם ממצאים צפויים, תשובות לדוגמה וטעויות נפוצות עבור A1 עד A6 אינן מתפרסמות, כך שסטודנטים לא יכולים להוריד את התשובות. מרצים מורידים אותן ב-Holarch: Organization Settings ← Class Review ← Download Solution Notes. הכפתור מוצג למנהלי הארגון (מרצים ועוזרי הוראה) של ארגון עם סטטוס כיתה.

תוצרי למידה

קורס: Model-Based Systems Engineering, סמסטר אחד, תואר ראשון מתקדם או שנה ראשונה בתואר שני.

בסוף הקורס, הסטודנטים יודעים:

#תוצרמוערך באמצעותתכונות Holarch בשימוש
LO1להבחין בין צורכי בעלי עניין לדרישות מערכת, ולעקוב מכל צורך אל הדרישות שמנסחות אותו באופן פורמלי.A1, אמצע הסמסטרStatements, קשרי traced to, הקטע Trace של ה-Item View, Traceability Matrix
LO2לכתוב דרישות הכרחיות, יחידניות, חד-משמעיות וניתנות לאימות, עם שיטת אימות וקריטריוני הצלחה.A2, אמצע הסמסטרמאפייני דרישה, Quality, TBD/TBR
LO3לנהל מחזור סקירה ואישור של דרישות, ולהגיב להערות סקירה בשינויים במודל.A2, השתתפות בסקירההתפקיד Reviewer, Approvals (Approve, Reject…, Reopen), הערות עם אזכורים
LO4לנתח עקיבות וכיסוי אימות, ולהחליט לגבי כל פער אם המודל שגוי או הדרישה.A3מטריצת עקיבות, RVTM, Model Checks
LO5לפרק פונקציות, להגדיר ארכיטקטורה לוגית, להקצות פונקציות לרכיבים לוגיים ופיזיים, ולגזור את הממשקים הנובעים מכך.A4, בחינה סופיתדיאגרמות Action ו-FFBD, Assets, הקצאה, Interface Register
LO6להעריך את ההשפעה של שינוי בדרישה דרך המודל, ולתעד החלטה לכל פריט מושפע.A5, בחינה סופיתLinks to Review, ניתוח השפעה, Change Requests, Baselines & Versions
LO7לתכנן אימות ותיקוף: להבחין ביניהם, לבחור שיטות, לכתוב נהלי בדיקה ותיקוף במונחים הנכונים ולקרוא RVTM.A6, בחינה סופיתמקרי בדיקה וחבילות בדיקה, Test Center, RVTM ו-VCRM, תבניות מסמכים
LO8להפיק תוצרים הנדסיים מהמודל ולשמור על עקביותם איתו: מסמכים בקו בסיס ומטריצות שמיוצאים לסקירה.A2, A6, בחינה סופיתמסמכים, מטריצות חיות, קווי בסיס, ייצוא ל-Word ול-Excel
LO9 (רשות)לקרוא ולכתוב תחביר טקסטואלי של SysML v2 עבור תת-מערכת, ולציין אילו תכונות כלי בדק ואילו הוא רק שמר.חלק רשות של A6פרויקט SysML v2, הבדיקות של ה-Editor, הערת ההוראה של SysML v2

מיפוי למטלות

תוצרA1 מעקב אחר צורךA2 עיבוד מחדש של דרישותA3 פערי כיסויA4 ארכיטקטורהA5 השפעת שינויA6 תוכנית תיקוף
LO1●○○
LO2●○
LO3●
LO4○●○
LO5●
LO6●
LO7○○○●
LO8○●

● התוצר העיקרי המוערך, ○ תורם גם כן.

הערות למרצה

  • התוצרים מתארים יכולת בהנדסת מערכות, לא מיומנות בכלי. Holarch הוא המקום שבו הסטודנטים מתרגלים; קובצי ה-CSV של EO-1 מאפשרים לסטודנט להראות כל תוצר גם בלעדיו.
  • התוצרים עוקבים אחר הפרקטיקה המקובלת בהנדסת מערכות, למשל התהליכים הטכניים של ISO/IEC/IEEE 15288: הגדרת צורכי בעלי עניין ודרישותיהם, הגדרת דרישות מערכת, הגדרת ארכיטקטורה, אימות ותיקוף. יש למפות אותם לקריטריוני ההסמכה של התוכנית שלך כפי שהמוסד דורש.

A1 · מעקב אחר צורך

תוצרים: LO1 (עיקרי), LO4, LO7 · גודל קבוצה: יחידני · משקל מומלץ: 8 %

רקע

הלקוח של EO-1, חברת אנליטיקה חקלאית, הגדיר שלושה צרכים. N2 Twice-Weekly Revisit קובע: “לקוחות חקלאיים זקוקים לצילומים עדכניים של השדות שלהם לפחות פעמיים בשבוע בעונת הגידול.” צורך מתקיים רק כשהדרישות שמנסחות אותו מסופקות על ידי התכן ומאומתות, והצורך עצמו מתוקף מול הלקוח.

משימה

  1. יש לעקוב אחר N2 במודל: הדרישות שהוא מקושר אליהן, הדרישות הבנות שלהן, הפונקציות והרכיבים שמספקים כל אחת, ומקרי הבדיקה שמאמתים אותן, עם הסטטוס של כל בדיקה.
  2. יש לשרטט את השרשרת כטבלה או כדיאגרמה קטנה: שורה או תיבה לכל פריט, עם המספר, השם, הסטטוס והקשר שמחבר אותו.
  3. יש לאתר את פעילות התיקוף של N2 ואת הסטטוס שלה.
  4. יש לענות: אילו ראיות עדיין חסרות לפני ש-N2 נחשב מתוקף? יש לפרט כל חלק חסר, את הפריט שאליו הוא שייך ומה יסגור אותו.
  5. יש לחפש דרישות שתומכות ב-N2 אבל אינן מקושרות אליו. יש לבחור מועמדת אחת ולנמק בעד או נגד הוספת הקישור. אין להוסיף אותו למודל.

ב-Holarch: יש לפתוח את N2 ב-Item View ולקרוא את הקטע עקיבות שלו, ואז להשתמש ב-Verification ← Traceability Matrix, ב-Verification ← RVTM וב-Verification ← Test Center. בלי Holarch: eo-1-v1.1-traceability.csv ו-eo-1-v1.1-rvtm.csv.

הגשה

מסמך של עמוד עד שני עמודים (Word או PDF) עם השרשרת, הראיות החסרות והתשובה לשלב 5. אין לשנות את המודל במטלה זו.

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
שרשרת מלאה ונכונה (40 %)כל פריט מ-N2 ועד לבדיקות, עם הקשרים והסטטוסים הנכונים, כולל שתי הדרישות הבנות ופעילות התיקוף.פריט או סטטוס אחד חסר או שגוי.השרשרת נעצרת בדרישות או מחמיצה דרישה בת.פריטים מפורטים בלי קשרים.
ראיות חסרות (35 %)מציין כל פער (בדיקות שלא הורצו, דרישת אב בלי אימות משלה, דרישות שעדיין לא אושרו, תיקוף שלא בוצע, דרישה בת בלי פונקציה) ומה סוגר כל אחד.רוב הפערים, עם מה שסוגר אותם.מפרט פערים בלי לציין מה סוגר אותם.מציין רק “חסרות בדיקות”.
אימות לעומת תיקוף (15 %)מבחין ביניהם לכל אורך הדרך: דרישות מאומתות, הצורך מתוקף.טעות אחת.מתייחס לבדיקה שעברה כתיקוף של הצורך.אין הבחנה.
קישור מועמד (10 %)דרישה מסוימת עם נימוק מבוסס לכאן או לכאן.מועמדת עם נימוק דל.מועמדת בלי נימוק.חסר.

A2 · עיבוד מחדש וסקירה של דרישות

תוצרים: LO2 (עיקרי), LO3, LO8 · גודל קבוצה: קבוצה · משקל מומלץ: 10 %

רקע

שלוש דרישות של EO-1 עדיין בטיוטה ומקבלות 44 % בבדיקת האיכות של Holarch:

  • 2.5 Safe Mode Recovery: “The spacecraft should recover from safe mode quickly and resume imaging as appropriate”
  • 3.5 Battery Thermal Control: “The thermal design shall keep the battery warm enough (TBD).”
  • 6.4 Operator Interface: “The operator interface shall be user friendly and/or easy to use.”

ל-3.5 יש גם בעיה פתוחה, ISS-3 Battery heater set point not chosen, והערת סקירה מוועדת סקירת התכן, RID-1 No cold-case analysis for the battery heater.

משימה

  1. לכל אחת מהשלוש, יש לפרט מה הופך אותה לחלשה, מילה במילה היכן שזה חשוב.
  2. יש לנסח כל אחת מחדש בפרויקט הקבוצתי: “shall” אחד, תנאי מדיד אחד, ונקודת התחלה או תנאי מוצהרים כשמעורבים זמן או טווח. יש להחליף כל TBD בערך ולתעד את הנימוק שלו, או להשאיר TBR עם אחראי ותאריך. עבור 3.5 יש לציין איך הניסוח החדש עונה על ISS-3 ועל RID-1.
  3. יש למלא Verification Method, רמת אימות ו-קריטריוני הצלחה לכל אחת.
  4. יש לקשר כל אחת למקור שלה (צורך, דרישת אב או מקור) ולפונקציה שמספקת אותה. אם אין פונקציה כזו, יש לציין את הפונקציה החסרה.
  5. יש להעביר כל אחת למצב In Review. המרצה סוקר אותן בתפקיד Reviewer. יש להשיב לכל הערה במודל (לשנות את הדרישה, או להשיב עם נימוק), ואז לסגור את ההערה.
  6. יש לשמור קו בסיס של המסמך EO-1 System Requirements Specification (SRS-001) בשם “A2 handed in” ולייצא אותו ל-Word.

ב-Holarch: Needs & Requirements ← Quality, חלונית המאפיינים של הדרישה, Needs & Requirements ← Approvals, ובמסמך Version ▾ ← Save Baseline… ו-Deliver ▾ ← Specification (Word).

הגשה

ייצוא ה-Word, ועוד הערה של חצי עמוד על החולשות שמצאת בשלב 1. המודל כפי שהוא במועד ההגשה מקבל ציון יחד איתו.

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
דרישות מנוסחות מחדש (40 %)שלושתן יחידניות, מדידות וניתנות לאימות; התנאים ונקודות ההתחלה מוצהרים; הערכים מנומקים.בדרישה אחת עדיין יש מונח מעורפל או תנאי חסר.נוספו ערכים, אבל חסרים תנאים או נימוק.הניסוח שונה, ועדיין לא ניתן לאימות.
מאפייני אימות (20 %)השיטה, הרמה וקריטריוני ההצלחה מתאימים לכל דרישה ואפשר להריץ אותם כפי שנכתבו.אי-התאמה אחת, למשל Test היכן שאפשרי רק Analysis.השיטות נקבעו, קריטריוני ההצלחה מעורפלים.חסר.
עקיבות (15 %)כל אחת מקושרת למקור שלה ולפונקציה שמספקת אותה, או שהפונקציה החסרה צוינה.קישור אחד חסר.מקורות בלבד.אין.
מחזור סקירה (15 %)כל הערת סקירה נענתה במודל ונסגרה; דרישות שנדחו עובדו מחדש והוגשו שוב.הערה אחת נותרה פתוחה.ההערות נענו בלי שינויים במודל.ההערות לא טופלו.
ניתוח החולשות (10 %)מדויק: מציין כל מונח מעורפל ולמה אי אפשר לאמת אותו.כללי אך נכון.חוזר על ציון האיכות.חסר.

A3 · איתור פערי הכיסוי

תוצרים: LO4 (עיקרי), LO1, LO2, LO7 · גודל קבוצה: קבוצה · משקל מומלץ: 10 %

רקע

EO-1 נמצא בסקירת התכן הקריטית שלו. המודל לא מושלם בכוונה: לחלק מהדרישות אין פונקציה שמספקת אותן, לחלק אין בדיקה, חלק מהבדיקות נכשלו, ומשוואה אחת לא מקושרת לשום דבר.

משימה

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

  1. יש לפרט כל דרישה שאף פונקציה לא מספקת.
  2. יש לפרט כל דרישה שאף מקרה בדיקה לא מאמת, ואת אלה שהבדיקות שלהן נכשלו, עם הבעיה הפתוחה וכל חריגה שתועדה לגביהן.
  3. יש לפרט את הדרישות שאין להן רכיב שמספק אותן. יש להחליט אילו מהן צריכות רכיב ואילו מסופקות בצדק ברמת המשימה או המקטע.
  4. יש לאתר פריטי מודל ששום דבר לא מקושר אליהם. רמז: כדאי לבדוק את משוואות ההספק.
  5. לכל פער יש להחליט: האם חסר משהו במודל (פונקציה, רכיב, בדיקה, קישור), או שהדרישה אינה נחוצה או מנוסחת לא נכון? משפט נימוק אחד לכל פער.
  6. יש לסגור שלושה פערים לבחירתך בפרויקט הקבוצתי, כל אחד כשינוי אחד שאפשר להצביע עליו ב-Control & Reviews ← Activity.

ב-Holarch: Verification ← Traceability Matrix, Verification ← RVTM, Verification ← Model Checks ו-Risks, Issues & Decisions ← Issues & Actions. בלי Holarch: eo-1-v1.1-traceability.csv (העמודה כיסוי שלו), eo-1-v1.1-rvtm.csv, eo-1-v1.1-issues-actions.csv ו-eo-1-v1.1-deviations-waivers.csv.

הגשה

טבלת פערים (פער, פריט, החלטה, נימוק, נסגר כן או לא) כקובץ Excel או Word, ורשימה של שלושת השינויים שביצעת.

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
פערים שאותרו (35 %)כל הפערים של פונקציות, בדיקות, רכיבים ופריטים יתומים, כולל הבדיקות שנכשלו עם הבעיות והחריגה שלהן.פער אחד או שניים הוחמצו.אותרו רק הטיוטות הברורות.פחות ממחצית.
החלטות (35 %)לכל פער החלטה שאפשר להגן עליה; מבחין בין תכן חסר לבין דרישות לא נחוצות או בהיקף שגוי ולבין סיפוק ברמת המשימה.רוב ההחלטות מבוססות.כל פער טופל כ“הוספת קישור”.אין החלטות.
שינויים שבוצעו (20 %)שלושה שינויים שבאמת סוגרים פערים, כל אחד צעד נקי אחד ברשומה.שני שינויים טובים.שינויים שמסתירים פער, כמו קישור שנוסף בלי סיבה.אין.
הצגה (10 %)הטבלה ניתנת למיון ומלאה.השמטות קלות.קשה לעקוב.חסר.

A4 · הרחבת הארכיטקטורה

תוצרים: LO5 (עיקרי), LO4 · גודל קבוצה: קבוצה · משקל מומלץ: 12 %

רקע

הארכיטקטורה הלוגית של EO-1 (L0) מכסה רק את פרוסות ההספק וטיפול הנתונים: L1 Power Generation עד L6 Fault Management. כל רכיב לוגי מקבץ פונקציות (allocated to) וממומש על ידי חלק פיזי (related to); למשל F3.1 Convert Sunlight to Power מוקצית ל-L1, ו-1.3.1 Solar Arrays מממש את L1. לקביעת הכיוון ובקרתו יש הפונקציות F4.1 Estimate Attitude, F4.2 Compute Control Torques, F4.3 Drive Reaction Wheels ו-F4.4 Unload Wheel Momentum, וחלקים פיזיים תחת 1.2 ADCS, אבל אין שכבה לוגית.

משימה

  1. יש להוסיף רכיבים לוגיים לקביעת הכיוון ובקרתו תחת L0. כל רכיב מציין את ייעודו בלי לנקוב בחומרה.
  2. יש להקצות להם את F4.1 עד F4.4, ולקשר כל רכיב לוגי לחלקים הפיזיים תחת 1.2 ADCS שמממשים אותו, לפי הדפוס של L1 עד L6.
  3. יש לשרטט את דיאגרמת ה-Action של F4 עם הפריטים שזורמים בין תת-הפונקציות שלה, למשל אומדן הכיוון ופקודות המומנט, אם עדיין אין כזו בפרויקט הקבוצתי.
  4. יש לגזור את הממשקים מהזרימות שחוצות את גבולות הרכיבים, ולהשוות אותם לממשקים הקיימים IF-06, IF-16, IF-17 ו-IF-18: אילו תואמים, אילו חסרים, ואילו נושאים פריטים שאף פונקציה לא משתמשת בהם?
  5. יש לבדוק שכל אחת מהדרישות 2.1 עד 2.4 מסופקת על ידי הפונקציה שמבצעת את העבודה, ולציין איזה רכיב לוגי אחראי אז לכל דרישה.

ב-Holarch: Architecture ← Assets, Behavior ← Action Diagrams (F4), הקטע עקיבות בחלונית המאפיינים עבור ההקצאות, Interfaces ← Interface Register, וההגדרה המוכנה היררכיית הקצאה של דיאגרמת ההיררכיה. בלי Holarch: eo-1-v1.1-allocation-chain.csv ו-eo-1-v1.1-icd.csv.

הגשה

תיאור ארכיטקטורה קצר (שניים עד שלושה עמודים, Word או PDF): הרכיבים הלוגיים וייעודם, טבלת ההקצאה (פונקציה ← רכיב לוגי ← חלק פיזי), דיאגרמת ה-Action של F4 והשוואת הממשקים.

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
רכיבים לוגיים (25 %)בלתי תלויים בפתרון, מגובשים, לכל אחד ייעוד ברור; בלי שמות חומרה.רכיב אחד נוקב בחומרה או מערב ייעודים.הרכיבים מעתיקים את החלקים הפיזיים.חסרים או לא ברורים.
הקצאה (30 %)כל תת-פונקציה מוקצית פעם אחת לרכיב הנכון; הרכיבים ממומשים על ידי חלקים; עקבי במודל.הקצאה אחת מוטלת בספק.הקצאות לחלקים בלבד, תוך דילוג על השכבה הלוגית.לא שלם.
זרימות וממשקים (30 %)הממשקים נגזרים מזרימות שחוצות גבולות; השוואה מדויקת עם IF-06, IF-16, IF-17 ו-IF-18, כולל פערים בשני הכיוונים.ההשוואה נכונה ברובה.הממשקים מפורטים, לא נגזרים.חסר.
אחריות על דרישות (15 %)כל אחת מ-2.1 עד 2.4 מקושרת דרך הפונקציה שלה לרכיב לוגי, וחוסרי העקביות מצוינים.אחת חסרה.מפורט בלי בדיקה.חסר.

A5 · טיפול בשינוי

תוצרים: LO6 (עיקרי), LO7 · גודל קבוצה: קבוצה · משקל מומלץ: 10 %

רקע

אחרי סקירת התכן, הדרישה 3.1 Orbit Average Power שונתה מ-28 W ל-30 W הספק ממוצע למסלול בסוף החיים. מקרה הבדיקה TC-06 Solar Array Power Test עבר מול הערך הישן. Holarch סימן את הקישורים של 3.1 לסקירה.

משימה

  1. יש לפרט כל פריט שהשינוי מגיע אליו: קדימה דרך הקישורים מ-3.1, אחורה אל מה ש-3.1 נגזרת ממנו, ופריטים שמזכירים את הערך הישן בלי קישור ל-3.1. יש לציין איך נמצא כל אחד.
  2. לכל פריט יש לכתוב את השאלה שהשינוי מעלה, את הממצא (עם מספרים היכן שיש כאלה במודל) והחלטה: ללא שינוי (סימון הקישור כנסקר עם הערה), עדכון, או העברה לוועדת השינויים.
  3. יש להחליט מה לעשות עם TC-06: האם בדיקה שעברה ב-28 W עדיין מוכיחה 30 W? יש להציג את החישוב מהמשוואות של המודל.
  4. יש לאתר פריט אחד שהניתוח מבוסס הקישורים מחמיץ ולהסביר למה הוא חשוב.
  5. יש לתעד את ההחלטות בפרויקט הקבוצתי: הערה על כל קישור שמסומן כנסקר, בקשת שינוי למה שהוועדה צריכה להחליט, וקו בסיס לפני ואחרי.

ב-Holarch: Needs & Requirements ← Links to Review, ניתוח ההשפעה מ-3.1 (Open in ▾ ← Spider, ואז השפעה), הקטע עקיבות בחלונית המאפיינים, משוואות ההספק EQ-1.1 עד EQ-1.4 ו-TPM-2 (Architecture ← Budgets & TPMs), Control & Reviews ← Change Requests ו-Control & Reviews ← Baselines & Versions. בלי Holarch: eo-1-v1.1-traceability.csv ו-eo-1-v1.1-change-impact-3.1.csv, תיעוד ההשפעה שפורסם; יש לבצע קודם ניתוח משלך ואז להשוות.

הגשה

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

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
היקף ההגעה (30 %)נמצאו פריטים קדימה, אחורה ובחיפוש טקסט, כולל כאלה שאף קישור לא מגיע אליהם.קישורים בלבד, כולם.חלק מהקישורים קדימה.3.1 ו-TC-06 בלבד.
ממצאים עם מספרים (30 %)משתמש בערכים ובמשוואות של המודל; החוסר ב-TC-06 מחושב ומוסבר.המספרים נכונים ברובם.איכותני בלבד.מסקנות שגויות.
החלטות (25 %)לכל פריט החלטה שמתאימה לממצא; קישורים מסומנים כנסקרים רק עם סיבה; פריטי הוועדה נשמרים בנפרד.החלטה אחת חלשה.מסמן קישורים כנסקרים בלי סיבות.אין החלטות.
תיעוד במודל (15 %)ההערות, בקשת השינוי וקווי הבסיס קיימים ועקביים עם התיעוד.אחת חסרה.רק המסמך.אין דבר במודל.

A6 · תוכנית תיקוף

תוצרים: LO7 (עיקרי), LO8, LO1 · גודל קבוצה: קבוצה · משקל מומלץ: 10 %

רקע

אימות שואל אם EO-1 נבנה נכון מול הדרישות שלו; תיקוף שואל אם זו המערכת הנכונה ללקוחות החקלאים. חבילת התיקוף TS-3 Mission Validation של EO-1 כוללת את VAL-01 Customer Alert Pilot (עבור N1, לא הורץ), את VAL-02 Growing Season Revisit Simulation (עבור N2, לא הורץ) ואת VAL-03 Agronomist Map Review (עבור N3, עבר).

את התוכנית מתחילים ב-Needs & Requirements ← Documents ← + New Document. תחת תבנית יש להגדיר את תבניות עבור ל-Test Plan Document ולבחור את התבנית המובנית Verification and Validation Plan עם הכללת הנחיות כתיבה, או את תבנית הארגון שהמרצה פרסם למטלה זו.

משימה

  1. 5.1 Operational Scenarios: יש לכתוב את התרחיש של VAL-01 במונחי הלקוח: מי עושה מה, באיזה יום, ובאיזו תוצאה. יש לציין את הצורך שהוא מפעיל.
  2. 5.2 Users and Participants: יש לציין את המשתמשים המייצגים ומה כל אחד מהם מחליט.
  3. 5.3 Validation Environment: יש לתאר את הסביבה, במה היא שונה מהתפעול ומה המשמעות של ההבדל לגבי התוצאה.
  4. יש לכתוב את קריטריוני הקבלה של VAL-01 כך שלקוח יוכל לומר כן או לא בלי שיקול דעת הנדסי, ולתעד אותם ב-התוצאה הצפויה של מקרה הבדיקה.
  5. 8 Verification Status: יש לקרוא את המטריצה החיה. יש לבחור את הבדיקה שנכשלה TC-04 Pointing Accuracy Test ולהסביר מה תהיה משמעות התוצאה של VAL-01 אם TC-04 עדיין במצב נכשל בזמן הפיילוט.
  6. יש לייצא את התוכנית ל-Word.

רשות: בונוס SysML v2 (LO9, עד 10 % נוספים)

יש ליצור פרויקט SysML v2 מ-eo-1-v1.1-power-subsystem.sysml (Manage Projects ← Project Files ▾ ← Import SysML v2 Files…). הקובץ עדיין מכיל את הדרישה 3.1 עם 28 W. יש לשנות את ההספק הממוצע למסלול הנדרש ל-30 W, השינוי מ-A5, ולקרוא מה ה-Editor מדווח. האם זו שגיאת מידול או ממצא תכן? אחר כך יש לשנות את ערכי התכן, לא את הדרישה, עד ששורת הסטטוס של ה-Editor מציגה אין בעיות, ולציין אם הערכים החדשים סבירים מבחינה פיזיקלית. בחצי עמוד יש לציין אילו מהטענות שלך הכלי בדק ואילו הוא רק שמר; הערת ההוראה של SysML v2 שהמרצה משתף מפרטת את שניהם.

הגשה

  • ייצוא ה-Word של התוכנית.
  • לבונוס SysML v2: קובץ ה-.sysml וחצי העמוד.

מחוון

קריטריון4 מצטיין3 מיומן2 מתפתח1 מתחיל
תרחיש במונחי הלקוח (30 %)קונקרטי, מתאר יום בחיי המשתמש, בלי ז׳רגון הנדסי; מפעיל בבירור את N1.ברור, עם מעט ז׳רגון.נוהל בדיקה, לא תרחיש.חסר או כללי.
קריטריוני קבלה (25 %)ניתנים לצפייה, כן או לא, בבעלות הלקוח; קשורים ל“on the day of an overpass” של N1.ניתנים לצפייה ברובם.ספים הנדסיים בלבד.מעורפל.
משתתפים וסביבה (20 %)משתמשים מייצגים מצוינים עם ההחלטות שלהם; ההבדלים מהתפעול והשפעתם מוצהרים.אחת חסרה.מפורטים בלי השפעה.חסר.
הנמקת V&V (15 %)מסביר למה פיילוט תיקוף יכול להצליח או להיכשל ללא תלות ב-TC-04 ומה המשמעות של כל תוצאה.מבוסס ברובו.מבלבל בין אימות לתיקוף.חסר.
תוצר (10 %)ייצוא Word נקי, הנחיות התבנית הוחלפו בתוכן.נותר טקסט הנחיות.יוצא חלקית.חסר.
בונוס SysML v2 (עד +10 %)הממצא מוסבר; No problems, עם ערכים סבירים; הצהרה מדויקת על מה נבדק ומה נשמר.No problems; ההצהרה כללית.הדרישה הוחלשה במקום לשנות את התכן, או שנותרו בעיות.ללא ניקוד.

הוראת SysML v2 עם Holarch: מה הוא בודק ומה הוא רק שומר

פרויקטי SysML v2 של Holarch תומכים בתת-קבוצה של מפרט OMG SysML v2. המצב הנוכחי של כל תחום מופיע בדף כיסוי שפת SysML v2 (holarch.app/sysml-v2-coverage/); כדאי לבדוק אותו לפני כל סמסטר. כשמלמדים את השפה עם Holarch, יש להפריד בין שלושה סוגי הצהרות, כדי שסטודנטים לא ילמדו מגבלה של הכלי ככלל של השפה, ולא יתייחסו למבנה שהכלי רק שמר כאל מבנה שהוא בדק:

  • נבדק: ה-Editor מנתח את המבנה ובודק אותו תוך כדי הקלדה, והתצוגות והדפים משתמשים בו. כששורת הסטטוס של ה-Editor מציגה No problems, הבדיקות האלה עברו.
  • נשמר, לא מפורש: מנותח ונשמר בדיוק כפי שנכתב, בטקסט ובייצוא, אבל לא מקבל משמעות. No problems לא אומר דבר על נכונותו.
  • עדיין לא ב-Holarch: המבנה או התכונה אינם זמינים ב-Holarch. זה עדיין SysML v2 תקין.

נבדק: בטוח ללמד ולהעריך בעזרת הכלי

תחוםמה הסטודנטים יכולים לסמוך על ה-Editor שיתפוס
תחבירתווים, הערות, מחרוזות, סוגריים מסולסלים, ;, שמות ואסימונים צפויים.
שמות וייבואשמות לא פתורים, דו-משמעיים, כפולים ופרטיים; ייבוא של חברות, מרחב שמות, רקורסיבי ומסונן.
הגדרות, שימושים, התמחותpart, attribute, port, action, state, requirement ושאר הסוגים וההגדרות שלהם; טיפוס, subsetting, הגדרה מחדש וצימוד; מחזוריות וסוג הגדרה שגוי.
ריבויים, ערכים ויחידותגבולות תקינים; גדלים עם סוגי הגדלים של ISQ ויחידות SI ויחידות ארה״ב המקובלות; בדיקות ממדים: הספק היכן שצפויה מסה הוא שגיאה.
אילוצים וחישוביםטיפוסי אופרנדים, ארגומנטים של חישובים, תנאים בוליאניים, והערכה: מדווח על אילוצים, דרישות ויעדים שאינם מתקיימים עבור הערכים הנוכחיים.
מבנהקצוות חיבור; כיווני ports, זרימות והודעות; ממשקים ומחברי binding.
פעולות ומצביםיעדי רצף, צומתי בקרה, הערכים שלולאת for עוברת עליהם, מעברים התחלתיים, אזורים מקבילים, טריגרים של מעברים ואפקטים של do.
דרישות ומקרי שימושיעדים של subject, actor, stakeholder, require ו-assume constraint, satisfy, verify ו-frame במקומות הנכונים.
הקצאהallocate … to …, הגדרות הקצאה, תלויות.
שונותוריאציה מכילה רק וריאנטים מהסוג שלה, בחירה היא וריאנט של הנקודה שלה, והערכים של הבחירה מוערכים.
מופעים, תמונות מצב ופרוסות זמןלכל אחד יש התכונות של המופע שאליו הוא שייך; הערכים שלו עצמו נקראים קודם.

נבדק חלקית: ללמד תוך ציון המגבלה

תחוםנבדק או מורץמגבלה שיש לציין בפני הסטודנטים
פעולותה-Simulator מריץ זרימות פעולה, כולל הרצות Monte Carlo.משכי צעדים, הסתברויות הסתעפות ומספרי חזרות בלולאות הם הגדרות Simulator שנשמרות ב-Holarch, לא בטקסט, ולכן ייצוא .sysml אינו נושא אותן.
מצביםה-Simulator מריץ מכונות מצבים עם גירויים ומציג את המצבים הפעילים.אותו דבר: הגדרות ה-Simulator אינן חלק מהטקסט.
מקרי ניתוח ואימותSubject, יעד, תוצאה מוחזרת; verify ופסיקה.מקרה ניתוח מוערך רק כשלכל קלט יש ערך; אין פותר. ב-Parametric View, Solve מוצא נעלם אחד לכל אילוץ. ניתוחי חלופות מהספרייה הסטנדרטית אינם מוערכים.
תצוגותview, view def, expose, מסננים, נקודות מבט והגדרות התצוגה הסטנדרטיות; Sequence Views משרטטות קטעי alt, opt, loop ו-par.הפריסה שייכת ל-Holarch, לא למודל.
שונותוריאציות, וריאנטים ותצורות נבדקים ומוערכים.Holarch עדיין לא מחפש או מפרט כל צירוף תקין.
מטא-נתונים ומילות מפתח@Name, #Name, metadata … about, מילות מפתח מוגדרות משתמש ממטא-נתונים סמנטיים.למטא-נתונים אחרים מוגדרי משתמש אין משמעות מעבר לערכים שלהם; מטא-נתונים שנכתבו עם about אינם מוסיפים טיפוס בסיס.
ייצוגים טקסטואלייםגופי rep … language ב-SysML וב-KerML נבדקים, וגוף אילוץ ב-SysML מוערך.גופים בשפות אחרות, כמו Python, OCL או MATLAB, נשמרים כטקסט ולעולם אינם מורצים.
החלפת JSON של SysML v2ייבוא וייצוא של פורמט הרכיבים של Systems Modeling API, עם שמירת מזהי הרכיבים.סוגי רכיבים ש-Holarch לא מפרש נשמרים כפי שיובאו ונכתבים בחזרה ללא שינוי; אין להם טקסט ואי אפשר לערוך אותם.

נשמר, לא מפורש: No problems לא מוכיח כאן דבר

  • גופים של ייצוגים טקסטואליים בשפות שאינן SysML ו-KerML.
  • הערכים של מטא-נתונים מוגדרי משתמש מלבד מטא-נתונים סמנטיים.
  • טקסט doc והערות: לעולם אינם מושווים למודל. בתת-מערכת ההספק של EO-1, שינוי הדרישה 3.1 ל-30 W משאיר את ה-doc שלה עם 28 W, בלי שמדווחת בעיה. תרגיל טוב.
  • סוגי רכיבים ש-Holarch לא מפרש בקובץ JSON מיובא של SysML v2.

גם הכיוון ההפוך חשוב: סטטוס דרישה, תוצאות אימות ותוויות הם נתוני Holarch. הם אינם בטקסט ואינם בייצוא .sysml.

עדיין לא ב-Holarch

  • קובצי .kerml: אינם מיובאים, ומודלים שנכתבו ב-KerML אינם נבדקים. KerML נקרא עבור הספרייה הסטנדרטית בלבד.
  • הרחבות שפה מלבד מילות מפתח מוגדרות משתמש; אי אפשר לערוך את הספרייה הסטנדרטית.
  • פותר למקרי ניתוח, וחיפוש של צירופי וריאנטים תקינים בדפים של Holarch.
  • commits של Systems Modeling API ל-main, תגיות ומיזוגים: כלים אחרים מבצעים commit לענפים של בקשות שינוי, ומאשר מחיל אותם ב-Holarch.

איך להשתמש בזה בקורס

  • את הניסוח “הכלי בדק” יש לומר רק לגבי התחומים שנבדקים. למשל, No problems פירושו שהיחידות עקביות ושהדרישות מתקיימות עבור הערכים הנוכחיים. אין פירושו שטקסט ה-doc תואם לערכים או שגוף Python נכון.
  • את המבנים הנשמרים יש להעריך בקריאה. נותנים להם ציון לפי בחינה, לא לפי מספר הבעיות.
  • התנהגות רצה ב-Simulator הן לזרימות פעולה והן למכונות מצבים. המשכים וההסתברויות שה-Simulator משתמש בהם הם הגדרות Holarch: אם סטודנטים מגישים רק את קובץ ה-.sysml, יש לבקש גם את ההגדרות.
  • כללי השפה באים מהמפרט, לא מכלי כלשהו. היכן ש-Holarch לא מימש משהו, יש לומר “עדיין לא ב-Holarch”, לא “אסור”.
  • בונוס A6 נשען על הערה זו: הסטודנטים משנים את 3.1 ל-30 W בתת-מערכת ההספק של EO-1, רואים את בדיקת ההערכה מדווחת על כך, מתקנים את התכן וכותבים מה נבדק ומה רק נשמר.

הורדות

החבילה היא קובץ zip אחד. הגרסה מופיעה בשמו, כך שקורס יכול להפנות בדיוק לעותק שבו השתמש. קובצי ה-CSV והפרויקט של המטלות הם ההורדות של EO-1 Reference Model v1.1 בדף EO-1.

קובץמה היא מכילה
teaching-with-holarch-v1.0.zipכל הקבצים שלהלן בתיקייה אחת.
README.txtהתוכן, אופן השימוש בחבילה, הודעת הרישיון והיסטוריית השינויים.
LICENSE.txtהודעת הרישיון.
learning-outcomes.mdתוצרי הלמידה של הקורס והמיפוי שלהם למטלות.
assignments/A1-trace-a-need.mdA1 מעקב אחר צורך.
assignments/A2-requirements-rework.mdA2 עיבוד מחדש וסקירה של דרישות.
assignments/A3-coverage-gaps.mdA3 איתור פערי הכיסוי.
assignments/A4-extend-the-architecture.mdA4 הרחבת הארכיטקטורה.
assignments/A5-work-the-change.mdA5 טיפול בשינוי.
assignments/A6-validation-plan.mdA6 תוכנית תיקוף.
sysml-v2-teaching-boundaries.mdהוראת SysML v2 עם Holarch: מה הוא בודק ומה הוא רק שומר.

הערות הפתרון אינן בקובץ ה-zip; ראו הערות פתרון.

גרסאות

זוהי חבילת המרצה Teaching with Holarch בגרסה v1.0, שנכתבה עבור EO-1 Reference Model v1.1. גרסה חדשה מקבלת שמות קבצים חדשים; גרסאות קודמות נשארות זמינות בכתובות שלהן.

  • v1.0: מהדורה ראשונה: תוצרי הלמידה של הקורס והמטלות A1 עד A6 עם מחוונים, עבור EO-1 Reference Model v1.1.

איך לצטט

יש לצטט את הגרסה שבה השתמשת:

Holarch. Teaching with Holarch: instructor package, version 1.0. https://holarch.app/academic/instructor-package/. Licensed under CC BY 4.0.

רישיון

קובצי חבילת המרצה מוצעים ברישיון Creative Commons Attribution 4.0 International License (CC BY 4.0). מותר להעתיק, לשתף ולהתאים אותם לכל מטרה, כולל מסחרית, בתנאי שנותנים קרדיט הולם, מקשרים לרישיון ומציינים אם בוצעו שינויים. קרדיט: "Teaching with Holarch instructor package v1.0, Holarch, CC BY 4.0". כל הורדה נושאת הודעה זו.

למודל הייחוס EO-1 יש שורת קרדיט משלו: "EO-1 Reference Model v1.1, Holarch, CC BY 4.0". כל השמות, האנשים והתוצאות ב-EO-1 בדויים.

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

פורסם על ידי Holarch