Holarch
فصول الدورة

التدريب · المسار 9. أساسيات SysML v2 · الفصل 9.1 من 8

9.1 التعريفات والسمات 4:33

اكتب أنواع القيم والمكوّنات بنص SysML v2، مع قيم بالوحدات.

يعرض Holarch 2.22.

كل الفصول · 9.2 المنافذ والواجهات ←

ما ستتعلمه

  • اكتب تعدادًا ونوع قيمة وتعريف جزء مجردًا في المحرر
  • خصّص تعريفًا باستخدام `:>` وأعطِ السمات الموروثة قيمًا بالوحدات باستخدام `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. للحصول على شرح موجّه مع فحص، شغّل البرنامج التعليمي Definitions and Attributes الخاص بـ SysML v2 (التعليمات ← البرامج التعليمية).

تكون قد انتهيت عندما تُبلغ الحالة تحت المحرر بعدم وجود مشكلات ويعرض المستعرض 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 الـ mass الموروثة في Battery بخاصية خاصة بها، مربوطة هنا بـ 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.