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، وتظهر في مراجعات النص، وتُدار إصداراتها مع باقي النموذج. واستخدمها أثناء تحليل سيناريو تشغيلي (الخطوط الزمنية، وحصص الفروع، واستخدام الموارد) وقبل فحص متطلب مقابل دراسة Monte Carlo.

تعيين مدة أو احتمال أو عدد حلقات

  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. في Monte Carlo، تُظهر علامة التبويب الحالات الوقت في الحالة وأعداد الانتقالات. ويقدّم التحقق مقابل المتطلب… الوقت في كل حالة وحصتها من التشغيل كمخرجات.

في عرض انتقالات الحالة، يفتح ▶ محاكاة شريطًا مع ▶ تشغيل و⏭ خطوة و⏩ التشغيل حتى النهاية وإعادة التعيين وفتح في المحاكي. ويستخدم التشغيل المحفّزات المحفوظة في المحاكي لتعريف الحالة ذلك.

مثال تطبيقي: المشروع التوضيحي Hybrid Car

يستخدم المشروع التوضيحي Hybrid Car (إدارة المشاريع ← ملفات المشروع ▾ ← مشروع توضيحي جديد) المكتبة:

  • DriveCycle: للتعاقب toCruise بعد shift Probability قدره 70؛ ويأخذ فرع else الـ30 % المتبقية. ويستغرق cruise 1 min اسميًا، يُسحب من توزيع Triangular (45 s، 1 min، 2 min).
  • 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 بالعكس.
  • تحتفظ كل سمة بتوزيعها الخاص. ويجمع المحاكي كل الأزواج في مصفوفة ارتباط واحدة (Gaussian copula): القيمة رقم n المسحوبة لسمة في تشغيل تقترن بالقيمة رقم n لكل سمة ترتبط بها.
  • يجب أن تتوافق معاملات مجموعة من السمات المترابطة: فارتباط a بقوة بـb، وb بقوة بـc، مع ارتباط a عكسيًا بـc أمر مستحيل. ويُبلغ الفحص عن مثل هذه المجموعة؛ أضعف أحد المعاملات.
  • ترتبط المدد والكميات (Consumes وProduces وSeizes) بالطريقة نفسها. والتشغيل بالبذرة نفسها يعطي القيم نفسها.
  • في المحاكي، في وضع Monte Carlo مع محرك 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 … (أي: لا ينطبق @LoopCount على جزء ….)تقع التعليقة على نوع من العناصر لا تنطبق عليه. انقلها أو احذفها.
metadata Consumes … about needs an action and a part or item annotated @Resource. (أي: يحتاج إلى إجراء وجزء أو عنصر متدفق معلَّق عليه @Resource.)العناصر بعد about خاطئة في العدد أو النوع.
A probability of N % is outside 0 to 100. (أي: الاحتمال N % خارج النطاق من 0 إلى 100.)أدخل نسبة مئوية من 0 إلى 100.
The branch probabilities of this decision add up to N %; the simulator scales them to 100 %. (أي: مجموع احتمالات فروع هذا القرار N %؛ ويعيد المحاكي تحجيمها إلى 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. (أي: المعامل N خارج النطاق من -1 إلى 1 / ليس للارتباط معامل.)أدخل معاملًا من -1 إلى 1.
“a” and “b” are already correlated; the first correlation is used. … (أي: “a” و“b” مترابطتان بالفعل؛ ويُستخدم الارتباط الأول.)تحذير: يُتجاهل Correlation ثانٍ للزوج نفسه. أزل أحدهما.
The correlations of … contradict each other: no joint distribution has them … (أي: ارتباطات … تتناقض فيما بينها: لا يوجد توزيع مشترك يحققها.)لا يمكن أن تتوافق معاملات المجموعة (المصفوفة ليست موجبة شبه محددة). أضعف أحدها. ويرفض المحاكي التشغيل حتى يُصلح ذلك.
Deadlock at <time>: N steps wait for something that never comes. (أي: جمود عند <time>: N خطوات تنتظر شيئًا لا يأتي أبدًا.)تظهر فوق النتائج مع محرك SysML، مع كل خطوة منتظرة. ويوقف التشغيلَ accept بلا مرسل، أو عنصر متدفق لا يُنتج أبدًا، أو مورد لا يُحرَّر أبدًا.

الحدود

  • تُكتب المدد بالثواني أو الدقائق أو الساعات أو الأيام (SI::s، SI::min، SI::h، SI::d). وتُكتب الأجزاء من الألف من الثانية بالثواني؛ والأسابيع والأشهر والسنوات بالأيام.
  • تحتاج آلات الحالة والمحفّزات والتشغيل مع إلى محرك SysML.
  • تحتاج المدخلات المترابطة إلى محرك SysML؛ ويسحب محاكي JavaScript كل قيمة بشكل مستقل. ويمكن ربط 200 سمة على الأكثر في مجموعة واحدة.
  • يغطي فحص المعاملات المتناقضة الارتباطات المكتوبة في فضاء أسماء واحد؛ ويفحص المحاكي كل ارتباطات التشغيل.

SysML® وOMG® علامتان تجاريتان مسجلتان لشركة Object Management Group, Inc. في الولايات المتحدة ودول أخرى.