Holarch
פרקי הקורס

הדרכה · מסלול 9. יסודות SysML v2 · פרק 9.1 מתוך 8

9.1 הגדרות ומאפיינים 4:33

כותבים סוגי ערכים ורכיבים בטקסט SysML v2, עם ערכים ביחידות.

מציג את Holarch 2.22.

כל הפרקים · 9.2 פתחות וממשקים ←

מה תלמדו

  • לכתוב בעורך ספירה (enumeration), סוג ערך והגדרת חלק מופשטת
  • להרחיב הגדרה עם `:>` ולתת למאפיינים שעוברים בירושה ערכים עם יחידות באמצעות `redefines`
  • למצוא ולתקן שגיאת יחידות שהבודק מסמן בקו
  • לכתוב הגדרה עם הוספה ▾ והשלמה, ולחפש סוג בספרייה הסטנדרטית
  • לשנות שם של רכיב בכל מקום עם F2 בצעד ביטול אחד

כותבים הגדרות ומאפיינים של SysML v2 בעורך של Holarch, לפי המדריך Definitions and Attributes של SysML v2 על פרויקט Hybrid Car קטן: ספירה, סוג ערך שמרחיב את ScalarValue, רכיב מופשט וההרחבות שלו עם ערכים ביחידות, שגיאת יחידות שהבודק מוצא, השלמה והספרייה הסטנדרטית, הוספה, ושינוי שם עם F2. SysML הוא סימן מסחרי רשום של Object Management Group, Inc.

קובצי פרויקט

  • פרויקט גמור (.holarch.json; ניהול פרויקטים ← קובצי פרויקט ▾ ← ייבוא פרויקט (.json)…)

הסרטון מוצג מ-holarch.app; ראו את מדיניות הפרטיות.

תרגול

עושים את זה בעצמכם ב-Holarch, על פרויקט ההדגמה Hybrid Car ‏(SysML v2).

  1. יוצרים את הדגמת Hybrid Car: ניהול פרויקטים ← קובצי פרויקט ▾ ← פרויקט הדגמה חדש ← Hybrid Car (SysML v2). פותחים את מודל ← עורך ואת החבילה Vehicles.
  2. מתחת ל-enum def FuelKind מוסיפים enum def CoolingMode { enum passive; enum active; }.
  3. מתחת ל-part def Body בוחרים הוספה ▾ ← הגדרת חלק ומשלימים את part def Radiator :> Component עם attribute redefines mass = 8 [kg];, ‏attribute coolantVolume : VolumeValue; (מקלידים Volu ומקבלים את VolumeValue מרשימת ההשלמה עם Enter) ו-attribute mode : CoolingMode;.
  4. משנים את המסה ל-8 [W], מצביעים על הקו התחתון כדי לקרוא את ההודעה, ואז מחזירים אותה ל-8 [kg].
  5. ב-part def Powertrain מוסיפים part radiator : Radiator;. אחר כך מציבים את הסמן על coolantVolume, לוחצים F2 ומשנים את השם ל-coolantCapacity.
  6. להדרכה מודרכת עם בדיקה, מריצים את מדריך SysML v2 ‏Definitions and Attributes (עזרה ← מדריכים).

סיימתם כשהסטטוס מתחת לעורך מדווח שאין בעיות והדפדפן מציג את Radiator תחת Vehicles עם coolantCapacity ו-mode.

בדיקה עצמית

  1. ב-part def Battery :> Component { attribute redefines mass = 45 [kg]; }, מה עושה כל אחד מ-:> ו-redefines?
  2. למה Component מוצהר כ-abstract part def?
  3. למה attribute redefines power = 60 [kg]; נותן שגיאה?
  4. מה ההבדל בין doc /* … */ לבין שורת //?
הצגת התשובות
  1. ב-part def Battery :> Component { attribute redefines mass = 45 [kg]; }, מה עושה כל אחד מ-:> ו-redefines?

    :> הופך את Battery להרחבה של Component, כך שהיא יורשת את mass,‏ partNumber ו-power. ‏redefines מחליף ב-Battery את ה-mass שעבר בירושה בתכונה משלה, שכאן קשורה ל-45 kg.

  2. למה Component מוצהר כ-abstract part def?

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

  3. למה attribute redefines power = 60 [kg]; נותן שגיאה?

    ל-power יש סוג PowerValue, וקילוגרמים הם יחידת מסה. הבודק מעריך יחידות, ולכן הוא מסמן את הערך בקו עד שהיחידה היא יחידת הספק כמו [W].

  4. מה ההבדל בין doc /* … */ לבין שורת //?

    הערת doc היא תיעוד ששייך לרכיב והוא חלק מהמודל. הערת // נשארת רק בטקסט ואינה חלק מהמודל.

קריאה נוספת

תמליל

הצגת התמליל (הקריינות ומה שמוצג על המסך)

Introduction

Welcome to SysML v2 Fundamentals. This track teaches the SysML v2 textual notation and views in Holarch, one task per chapter, on the starter projects of Holarch's SysML v2 tutorials, so you can follow along step by step.

In this chapter you write definitions and attributes: an enumeration, a value type, an abstract component and the components that specialize it, with values in units.

Start the tutorial

In Manage Projects, open Project Files and choose Start a Tutorial. Under the tutorials for SysML v2 projects, click Start on Definitions and Attributes. Holarch creates a small Hybrid Car project and opens the step panel, which checks each step as you go.

On screen: Project Files ▾ → Start a Tutorial… → SysML v2: Definitions and Attributes → Start; the step panel opens.

Enumerations and value types

Open Model, then Editor. The package Vehicles holds one part definition, Car, with two attributes. Every declaration is a keyword and a name, then a body in braces, or a semicolon when there is no body.

On screen: Model → Editor: Vehicles; outline part def Car.

An enumeration is a value type with a fixed set of values. Above the car, write the drive mode: economy, normal or sport.

On screen: Caret after the imports; type enum def DriveMode.

Next, a value type of your own. Tire pressure specializes Scalar Value from the standard library. The short symbol after the name means specializes.

On screen: Below DriveMode; type attribute def TirePressure :> ScalarValue;

Specialization and units

Now an abstract component. There is no component as such, only kinds of components, and every one has a mass, a part number and a power. The doc comment is part of the model. Two slashes start a note that stays in the text only.

On screen: Below TirePressure; type abstract part def Component.

The battery is a component, so it has a mass, a part number and a power of its own. Write it with a mistake on purpose: a power in kilograms.

On screen: Below Component; type part def Battery :> Component with power = 60 [kg].

The checker underlines the value, and the status under the editor counts the error. Point at the underline to read the message.

On screen: Problems count; the information card on 60 [kg].

Change kilograms to watts, and the error clears. Redefines gives each inherited attribute the battery's own value, with its unit in square brackets.

On screen: kg → W; No problems, Applied.

Completion and the Standard Library

Completion knows the model and the library. Inside the battery, type attribute capacity, a colon, and the start of Energy Value. Press Enter to take it from the list, and end the line with a semicolon.

On screen: Inside Battery: attribute capacity : Ener → completion → Enter → ;

Point at Energy Value. The card shows that it comes from the I S Q package of the standard library.

On screen: The information card on EnergyValue.

The Standard Library page lists every package and definition of that library. Open Settings, then Standard Library, and search for Energy Value.

On screen: Settings → Standard Library; Find EnergyValue.

Insert

Back in the Editor, Insert writes a construct for you. Place the cursor below the battery, open Insert, and choose Part Definition. Type Engine, and press Tab to move into its body.

On screen: Model → Editor; caret below Battery; Insert ▾ (open on camera) → Part Definition; Engine; Tab.

The engine is a component too. Give it its mass and a number of cylinders, and make it specialize Component.

On screen: Body: mass 110 kg, cylinders : Integer; then :> Component after the name.

Usages and rename

Now use the definitions. Inside the car, add a drive mode, a battery and an engine. Each usage is typed by a definition after the colon, the drive mode by the enumeration you wrote first.

On screen: In Car after curbMass: attribute mode : DriveMode; part battery : Battery; part engine : Engine;

To rename a name everywhere it is used, place the cursor on cylinders and press F2. Enter cylinder count and confirm. Every reference to it changes, in one undo step.

On screen: Caret in cylinders; F2; New name cylinderCount; OK.

Every step is ticked off. Click Mark as Done to finish the tutorial.

On screen: Step panel → Mark as Done.

Recap

Let's recap. You started a SysML v2 tutorial, wrote an enumeration and a value type, an abstract component with specializations and values in units, let the checker find a wrong unit, and used completion, the Standard Library, Insert and rename.

Next, ports and interfaces connect these components.